@nimrobo/mcporter-remote 0.1.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 (741) hide show
  1. package/.claude/settings.local.json +7 -0
  2. package/.gitattributes +2 -0
  3. package/.github/workflows/ci.yml +26 -0
  4. package/AGENTS.md +109 -0
  5. package/CHANGELOG.md +361 -0
  6. package/LICENSE +21 -0
  7. package/README.md +449 -0
  8. package/bin/git +180 -0
  9. package/biome.json +43 -0
  10. package/config/mcporter.json +134 -0
  11. package/dist/cli/adhoc-server.d.ts +21 -0
  12. package/dist/cli/adhoc-server.d.ts.map +1 -0
  13. package/dist/cli/adhoc-server.js +228 -0
  14. package/dist/cli/adhoc-server.js.map +1 -0
  15. package/dist/cli/auth-command.d.ts +6 -0
  16. package/dist/cli/auth-command.d.ts.map +1 -0
  17. package/dist/cli/auth-command.js +257 -0
  18. package/dist/cli/auth-command.js.map +1 -0
  19. package/dist/cli/call-argument-expression.d.ts +5 -0
  20. package/dist/cli/call-argument-expression.d.ts.map +1 -0
  21. package/dist/cli/call-argument-expression.js +57 -0
  22. package/dist/cli/call-argument-expression.js.map +1 -0
  23. package/dist/cli/call-argument-values.d.ts +10 -0
  24. package/dist/cli/call-argument-values.d.ts.map +1 -0
  25. package/dist/cli/call-argument-values.js +83 -0
  26. package/dist/cli/call-argument-values.js.map +1 -0
  27. package/dist/cli/call-arguments.d.ts +17 -0
  28. package/dist/cli/call-arguments.d.ts.map +1 -0
  29. package/dist/cli/call-arguments.js +183 -0
  30. package/dist/cli/call-arguments.js.map +1 -0
  31. package/dist/cli/call-command.d.ts +5 -0
  32. package/dist/cli/call-command.d.ts.map +1 -0
  33. package/dist/cli/call-command.js +371 -0
  34. package/dist/cli/call-command.js.map +1 -0
  35. package/dist/cli/call-expression-parser.d.ts +9 -0
  36. package/dist/cli/call-expression-parser.d.ts.map +1 -0
  37. package/dist/cli/call-expression-parser.js +177 -0
  38. package/dist/cli/call-expression-parser.js.map +1 -0
  39. package/dist/cli/cli-factory.d.ts +16 -0
  40. package/dist/cli/cli-factory.d.ts.map +1 -0
  41. package/dist/cli/cli-factory.js +37 -0
  42. package/dist/cli/cli-factory.js.map +1 -0
  43. package/dist/cli/command-inference.d.ts +12 -0
  44. package/dist/cli/command-inference.d.ts.map +1 -0
  45. package/dist/cli/command-inference.js +75 -0
  46. package/dist/cli/command-inference.js.map +1 -0
  47. package/dist/cli/config/add.d.ts +23 -0
  48. package/dist/cli/config/add.d.ts.map +1 -0
  49. package/dist/cli/config/add.js +267 -0
  50. package/dist/cli/config/add.js.map +1 -0
  51. package/dist/cli/config/auth.d.ts +4 -0
  52. package/dist/cli/config/auth.d.ts.map +1 -0
  53. package/dist/cli/config/auth.js +21 -0
  54. package/dist/cli/config/auth.js.map +1 -0
  55. package/dist/cli/config/doctor.d.ts +3 -0
  56. package/dist/cli/config/doctor.d.ts.map +1 -0
  57. package/dist/cli/config/doctor.js +26 -0
  58. package/dist/cli/config/doctor.js.map +1 -0
  59. package/dist/cli/config/get.d.ts +3 -0
  60. package/dist/cli/config/get.d.ts.map +1 -0
  61. package/dist/cli/config/get.js +45 -0
  62. package/dist/cli/config/get.js.map +1 -0
  63. package/dist/cli/config/help.d.ts +18 -0
  64. package/dist/cli/config/help.d.ts.map +1 -0
  65. package/dist/cli/config/help.js +193 -0
  66. package/dist/cli/config/help.js.map +1 -0
  67. package/dist/cli/config/import.d.ts +9 -0
  68. package/dist/cli/config/import.d.ts.map +1 -0
  69. package/dist/cli/config/import.js +88 -0
  70. package/dist/cli/config/import.js.map +1 -0
  71. package/dist/cli/config/index.d.ts +2 -0
  72. package/dist/cli/config/index.d.ts.map +1 -0
  73. package/dist/cli/config/index.js +2 -0
  74. package/dist/cli/config/index.js.map +1 -0
  75. package/dist/cli/config/list.d.ts +7 -0
  76. package/dist/cli/config/list.d.ts.map +1 -0
  77. package/dist/cli/config/list.js +71 -0
  78. package/dist/cli/config/list.js.map +1 -0
  79. package/dist/cli/config/remove.d.ts +3 -0
  80. package/dist/cli/config/remove.d.ts.map +1 -0
  81. package/dist/cli/config/remove.js +19 -0
  82. package/dist/cli/config/remove.js.map +1 -0
  83. package/dist/cli/config/render.d.ts +26 -0
  84. package/dist/cli/config/render.d.ts.map +1 -0
  85. package/dist/cli/config/render.js +99 -0
  86. package/dist/cli/config/render.js.map +1 -0
  87. package/dist/cli/config/shared.d.ts +21 -0
  88. package/dist/cli/config/shared.d.ts.map +1 -0
  89. package/dist/cli/config/shared.js +130 -0
  90. package/dist/cli/config/shared.js.map +1 -0
  91. package/dist/cli/config/types.d.ts +7 -0
  92. package/dist/cli/config/types.d.ts.map +1 -0
  93. package/dist/cli/config/types.js +2 -0
  94. package/dist/cli/config/types.js.map +1 -0
  95. package/dist/cli/config-command.d.ts +7 -0
  96. package/dist/cli/config-command.d.ts.map +1 -0
  97. package/dist/cli/config-command.js +67 -0
  98. package/dist/cli/config-command.js.map +1 -0
  99. package/dist/cli/daemon-command.d.ts +8 -0
  100. package/dist/cli/daemon-command.d.ts.map +1 -0
  101. package/dist/cli/daemon-command.js +219 -0
  102. package/dist/cli/daemon-command.js.map +1 -0
  103. package/dist/cli/emit-ts-command.d.ts +31 -0
  104. package/dist/cli/emit-ts-command.d.ts.map +1 -0
  105. package/dist/cli/emit-ts-command.js +217 -0
  106. package/dist/cli/emit-ts-command.js.map +1 -0
  107. package/dist/cli/emit-ts-templates.d.ts +23 -0
  108. package/dist/cli/emit-ts-templates.d.ts.map +1 -0
  109. package/dist/cli/emit-ts-templates.js +130 -0
  110. package/dist/cli/emit-ts-templates.js.map +1 -0
  111. package/dist/cli/ephemeral-flags.d.ts +7 -0
  112. package/dist/cli/ephemeral-flags.d.ts.map +1 -0
  113. package/dist/cli/ephemeral-flags.js +108 -0
  114. package/dist/cli/ephemeral-flags.js.map +1 -0
  115. package/dist/cli/ephemeral-target.d.ts +16 -0
  116. package/dist/cli/ephemeral-target.d.ts.map +1 -0
  117. package/dist/cli/ephemeral-target.js +105 -0
  118. package/dist/cli/ephemeral-target.js.map +1 -0
  119. package/dist/cli/errors.d.ts +4 -0
  120. package/dist/cli/errors.d.ts.map +1 -0
  121. package/dist/cli/errors.js +7 -0
  122. package/dist/cli/errors.js.map +1 -0
  123. package/dist/cli/flag-utils.d.ts +4 -0
  124. package/dist/cli/flag-utils.d.ts.map +1 -0
  125. package/dist/cli/flag-utils.js +27 -0
  126. package/dist/cli/flag-utils.js.map +1 -0
  127. package/dist/cli/generate/artifacts.d.ts +15 -0
  128. package/dist/cli/generate/artifacts.d.ts.map +1 -0
  129. package/dist/cli/generate/artifacts.js +247 -0
  130. package/dist/cli/generate/artifacts.js.map +1 -0
  131. package/dist/cli/generate/definition.d.ts +22 -0
  132. package/dist/cli/generate/definition.d.ts.map +1 -0
  133. package/dist/cli/generate/definition.js +265 -0
  134. package/dist/cli/generate/definition.js.map +1 -0
  135. package/dist/cli/generate/flag-parser.d.ts +11 -0
  136. package/dist/cli/generate/flag-parser.d.ts.map +1 -0
  137. package/dist/cli/generate/flag-parser.js +41 -0
  138. package/dist/cli/generate/flag-parser.js.map +1 -0
  139. package/dist/cli/generate/flags.d.ts +20 -0
  140. package/dist/cli/generate/flags.d.ts.map +1 -0
  141. package/dist/cli/generate/flags.js +220 -0
  142. package/dist/cli/generate/flags.js.map +1 -0
  143. package/dist/cli/generate/fs-helpers.d.ts +3 -0
  144. package/dist/cli/generate/fs-helpers.d.ts.map +1 -0
  145. package/dist/cli/generate/fs-helpers.js +34 -0
  146. package/dist/cli/generate/fs-helpers.js.map +1 -0
  147. package/dist/cli/generate/name-utils.d.ts +5 -0
  148. package/dist/cli/generate/name-utils.d.ts.map +1 -0
  149. package/dist/cli/generate/name-utils.js +170 -0
  150. package/dist/cli/generate/name-utils.js.map +1 -0
  151. package/dist/cli/generate/output.d.ts +5 -0
  152. package/dist/cli/generate/output.d.ts.map +1 -0
  153. package/dist/cli/generate/output.js +24 -0
  154. package/dist/cli/generate/output.js.map +1 -0
  155. package/dist/cli/generate/runtime.d.ts +3 -0
  156. package/dist/cli/generate/runtime.d.ts.map +1 -0
  157. package/dist/cli/generate/runtime.js +34 -0
  158. package/dist/cli/generate/runtime.js.map +1 -0
  159. package/dist/cli/generate/server-utils.d.ts +3 -0
  160. package/dist/cli/generate/server-utils.d.ts.map +1 -0
  161. package/dist/cli/generate/server-utils.js +33 -0
  162. package/dist/cli/generate/server-utils.js.map +1 -0
  163. package/dist/cli/generate/template-data.d.ts +25 -0
  164. package/dist/cli/generate/template-data.d.ts.map +1 -0
  165. package/dist/cli/generate/template-data.js +90 -0
  166. package/dist/cli/generate/template-data.js.map +1 -0
  167. package/dist/cli/generate/template-help.d.ts +2 -0
  168. package/dist/cli/generate/template-help.d.ts.map +1 -0
  169. package/dist/cli/generate/template-help.js +113 -0
  170. package/dist/cli/generate/template-help.js.map +1 -0
  171. package/dist/cli/generate/template.d.ts +30 -0
  172. package/dist/cli/generate/template.d.ts.map +1 -0
  173. package/dist/cli/generate/template.js +366 -0
  174. package/dist/cli/generate/template.js.map +1 -0
  175. package/dist/cli/generate/tools.d.ts +46 -0
  176. package/dist/cli/generate/tools.d.ts.map +1 -0
  177. package/dist/cli/generate/tools.js +304 -0
  178. package/dist/cli/generate/tools.js.map +1 -0
  179. package/dist/cli/generate/types.d.ts +5 -0
  180. package/dist/cli/generate/types.d.ts.map +1 -0
  181. package/dist/cli/generate/types.js +2 -0
  182. package/dist/cli/generate/types.js.map +1 -0
  183. package/dist/cli/generate-cli-runner.d.ts +3 -0
  184. package/dist/cli/generate-cli-runner.d.ts.map +1 -0
  185. package/dist/cli/generate-cli-runner.js +72 -0
  186. package/dist/cli/generate-cli-runner.js.map +1 -0
  187. package/dist/cli/help-output.d.ts +6 -0
  188. package/dist/cli/help-output.d.ts.map +1 -0
  189. package/dist/cli/help-output.js +186 -0
  190. package/dist/cli/help-output.js.map +1 -0
  191. package/dist/cli/http-utils.d.ts +9 -0
  192. package/dist/cli/http-utils.d.ts.map +1 -0
  193. package/dist/cli/http-utils.js +88 -0
  194. package/dist/cli/http-utils.js.map +1 -0
  195. package/dist/cli/identifier-helpers.d.ts +20 -0
  196. package/dist/cli/identifier-helpers.d.ts.map +1 -0
  197. package/dist/cli/identifier-helpers.js +84 -0
  198. package/dist/cli/identifier-helpers.js.map +1 -0
  199. package/dist/cli/image-output.d.ts +3 -0
  200. package/dist/cli/image-output.d.ts.map +1 -0
  201. package/dist/cli/image-output.js +57 -0
  202. package/dist/cli/image-output.js.map +1 -0
  203. package/dist/cli/inspect-cli-command.d.ts +11 -0
  204. package/dist/cli/inspect-cli-command.d.ts.map +1 -0
  205. package/dist/cli/inspect-cli-command.js +78 -0
  206. package/dist/cli/inspect-cli-command.js.map +1 -0
  207. package/dist/cli/json-output.d.ts +23 -0
  208. package/dist/cli/json-output.d.ts.map +1 -0
  209. package/dist/cli/json-output.js +38 -0
  210. package/dist/cli/json-output.js.map +1 -0
  211. package/dist/cli/list-command.d.ts +15 -0
  212. package/dist/cli/list-command.d.ts.map +1 -0
  213. package/dist/cli/list-command.js +372 -0
  214. package/dist/cli/list-command.js.map +1 -0
  215. package/dist/cli/list-detail-helpers.d.ts +41 -0
  216. package/dist/cli/list-detail-helpers.d.ts.map +1 -0
  217. package/dist/cli/list-detail-helpers.js +99 -0
  218. package/dist/cli/list-detail-helpers.js.map +1 -0
  219. package/dist/cli/list-doc-comments.d.ts +6 -0
  220. package/dist/cli/list-doc-comments.d.ts.map +1 -0
  221. package/dist/cli/list-doc-comments.js +114 -0
  222. package/dist/cli/list-doc-comments.js.map +1 -0
  223. package/dist/cli/list-format.d.ts +38 -0
  224. package/dist/cli/list-format.d.ts.map +1 -0
  225. package/dist/cli/list-format.js +98 -0
  226. package/dist/cli/list-format.js.map +1 -0
  227. package/dist/cli/list-output.d.ts +39 -0
  228. package/dist/cli/list-output.d.ts.map +1 -0
  229. package/dist/cli/list-output.js +159 -0
  230. package/dist/cli/list-output.js.map +1 -0
  231. package/dist/cli/list-signature.d.ts +26 -0
  232. package/dist/cli/list-signature.d.ts.map +1 -0
  233. package/dist/cli/list-signature.js +176 -0
  234. package/dist/cli/list-signature.js.map +1 -0
  235. package/dist/cli/logger-context.d.ts +9 -0
  236. package/dist/cli/logger-context.d.ts.map +1 -0
  237. package/dist/cli/logger-context.js +29 -0
  238. package/dist/cli/logger-context.js.map +1 -0
  239. package/dist/cli/output-format.d.ts +11 -0
  240. package/dist/cli/output-format.d.ts.map +1 -0
  241. package/dist/cli/output-format.js +51 -0
  242. package/dist/cli/output-format.js.map +1 -0
  243. package/dist/cli/output-utils.d.ts +5 -0
  244. package/dist/cli/output-utils.d.ts.map +1 -0
  245. package/dist/cli/output-utils.js +143 -0
  246. package/dist/cli/output-utils.js.map +1 -0
  247. package/dist/cli/path-utils.d.ts +2 -0
  248. package/dist/cli/path-utils.d.ts.map +1 -0
  249. package/dist/cli/path-utils.js +12 -0
  250. package/dist/cli/path-utils.js.map +1 -0
  251. package/dist/cli/runtime-debug.d.ts +4 -0
  252. package/dist/cli/runtime-debug.d.ts.map +1 -0
  253. package/dist/cli/runtime-debug.js +134 -0
  254. package/dist/cli/runtime-debug.js.map +1 -0
  255. package/dist/cli/server-lookup.d.ts +3 -0
  256. package/dist/cli/server-lookup.d.ts.map +1 -0
  257. package/dist/cli/server-lookup.js +21 -0
  258. package/dist/cli/server-lookup.js.map +1 -0
  259. package/dist/cli/terminal.d.ts +10 -0
  260. package/dist/cli/terminal.d.ts.map +1 -0
  261. package/dist/cli/terminal.js +33 -0
  262. package/dist/cli/terminal.js.map +1 -0
  263. package/dist/cli/timeouts.d.ts +9 -0
  264. package/dist/cli/timeouts.d.ts.map +1 -0
  265. package/dist/cli/timeouts.js +55 -0
  266. package/dist/cli/timeouts.js.map +1 -0
  267. package/dist/cli/tool-cache.d.ts +9 -0
  268. package/dist/cli/tool-cache.d.ts.map +1 -0
  269. package/dist/cli/tool-cache.js +31 -0
  270. package/dist/cli/tool-cache.js.map +1 -0
  271. package/dist/cli/transport-utils.d.ts +3 -0
  272. package/dist/cli/transport-utils.d.ts.map +1 -0
  273. package/dist/cli/transport-utils.js +9 -0
  274. package/dist/cli/transport-utils.js.map +1 -0
  275. package/dist/cli-metadata.d.ts +57 -0
  276. package/dist/cli-metadata.d.ts.map +1 -0
  277. package/dist/cli-metadata.js +92 -0
  278. package/dist/cli-metadata.js.map +1 -0
  279. package/dist/cli.d.ts +10 -0
  280. package/dist/cli.d.ts.map +1 -0
  281. package/dist/cli.js +217 -0
  282. package/dist/cli.js.map +1 -0
  283. package/dist/config/imports/external.d.ts +8 -0
  284. package/dist/config/imports/external.d.ts.map +1 -0
  285. package/dist/config/imports/external.js +231 -0
  286. package/dist/config/imports/external.js.map +1 -0
  287. package/dist/config/imports/paths-utils.d.ts +3 -0
  288. package/dist/config/imports/paths-utils.d.ts.map +1 -0
  289. package/dist/config/imports/paths-utils.js +27 -0
  290. package/dist/config/imports/paths-utils.js.map +1 -0
  291. package/dist/config/imports/paths.d.ts +3 -0
  292. package/dist/config/imports/paths.d.ts.map +1 -0
  293. package/dist/config/imports/paths.js +135 -0
  294. package/dist/config/imports/paths.js.map +1 -0
  295. package/dist/config/imports/shared.d.ts +4 -0
  296. package/dist/config/imports/shared.d.ts.map +1 -0
  297. package/dist/config/imports/shared.js +25 -0
  298. package/dist/config/imports/shared.js.map +1 -0
  299. package/dist/config/path-discovery.d.ts +11 -0
  300. package/dist/config/path-discovery.d.ts.map +1 -0
  301. package/dist/config/path-discovery.js +65 -0
  302. package/dist/config/path-discovery.js.map +1 -0
  303. package/dist/config/read-config.d.ts +9 -0
  304. package/dist/config/read-config.d.ts.map +1 -0
  305. package/dist/config/read-config.js +74 -0
  306. package/dist/config/read-config.js.map +1 -0
  307. package/dist/config-imports.d.ts +7 -0
  308. package/dist/config-imports.d.ts.map +1 -0
  309. package/dist/config-imports.js +8 -0
  310. package/dist/config-imports.js.map +1 -0
  311. package/dist/config-normalize.d.ts +8 -0
  312. package/dist/config-normalize.d.ts.map +1 -0
  313. package/dist/config-normalize.js +184 -0
  314. package/dist/config-normalize.js.map +1 -0
  315. package/dist/config-schema.d.ts +164 -0
  316. package/dist/config-schema.d.ts.map +1 -0
  317. package/dist/config-schema.js +103 -0
  318. package/dist/config-schema.js.map +1 -0
  319. package/dist/config.d.ts +17 -0
  320. package/dist/config.d.ts.map +1 -0
  321. package/dist/config.js +91 -0
  322. package/dist/config.js.map +1 -0
  323. package/dist/daemon/client.d.ts +34 -0
  324. package/dist/daemon/client.d.ts.map +1 -0
  325. package/dist/daemon/client.js +291 -0
  326. package/dist/daemon/client.js.map +1 -0
  327. package/dist/daemon/config-layers.d.ts +7 -0
  328. package/dist/daemon/config-layers.d.ts.map +1 -0
  329. package/dist/daemon/config-layers.js +20 -0
  330. package/dist/daemon/config-layers.js.map +1 -0
  331. package/dist/daemon/host.d.ts +32 -0
  332. package/dist/daemon/host.d.ts.map +1 -0
  333. package/dist/daemon/host.js +345 -0
  334. package/dist/daemon/host.js.map +1 -0
  335. package/dist/daemon/launch.d.ts +10 -0
  336. package/dist/daemon/launch.d.ts.map +1 -0
  337. package/dist/daemon/launch.js +35 -0
  338. package/dist/daemon/launch.js.map +1 -0
  339. package/dist/daemon/log-context.d.ts +18 -0
  340. package/dist/daemon/log-context.d.ts.map +1 -0
  341. package/dist/daemon/log-context.js +64 -0
  342. package/dist/daemon/log-context.js.map +1 -0
  343. package/dist/daemon/paths.d.ts +5 -0
  344. package/dist/daemon/paths.d.ts.map +1 -0
  345. package/dist/daemon/paths.js +30 -0
  346. package/dist/daemon/paths.js.map +1 -0
  347. package/dist/daemon/protocol.d.ts +51 -0
  348. package/dist/daemon/protocol.d.ts.map +1 -0
  349. package/dist/daemon/protocol.js +2 -0
  350. package/dist/daemon/protocol.js.map +1 -0
  351. package/dist/daemon/request-utils.d.ts +12 -0
  352. package/dist/daemon/request-utils.d.ts.map +1 -0
  353. package/dist/daemon/request-utils.js +52 -0
  354. package/dist/daemon/request-utils.js.map +1 -0
  355. package/dist/daemon/runtime-wrapper.d.ts +9 -0
  356. package/dist/daemon/runtime-wrapper.d.ts.map +1 -0
  357. package/dist/daemon/runtime-wrapper.js +110 -0
  358. package/dist/daemon/runtime-wrapper.js.map +1 -0
  359. package/dist/env.d.ts +5 -0
  360. package/dist/env.d.ts.map +1 -0
  361. package/dist/env.js +93 -0
  362. package/dist/env.js.map +1 -0
  363. package/dist/error-classifier.d.ts +11 -0
  364. package/dist/error-classifier.d.ts.map +1 -0
  365. package/dist/error-classifier.js +141 -0
  366. package/dist/error-classifier.js.map +1 -0
  367. package/dist/fs-json.d.ts +3 -0
  368. package/dist/fs-json.d.ts.map +1 -0
  369. package/dist/fs-json.js +21 -0
  370. package/dist/fs-json.js.map +1 -0
  371. package/dist/generate-cli.d.ts +32 -0
  372. package/dist/generate-cli.d.ts.map +1 -0
  373. package/dist/generate-cli.js +155 -0
  374. package/dist/generate-cli.js.map +1 -0
  375. package/dist/index.d.ts +9 -0
  376. package/dist/index.d.ts.map +1 -0
  377. package/dist/index.js +5 -0
  378. package/dist/index.js.map +1 -0
  379. package/dist/lifecycle.d.ts +8 -0
  380. package/dist/lifecycle.d.ts.map +1 -0
  381. package/dist/lifecycle.js +106 -0
  382. package/dist/lifecycle.js.map +1 -0
  383. package/dist/logging.d.ts +19 -0
  384. package/dist/logging.d.ts.map +1 -0
  385. package/dist/logging.js +76 -0
  386. package/dist/logging.js.map +1 -0
  387. package/dist/oauth-manual.d.ts +9 -0
  388. package/dist/oauth-manual.d.ts.map +1 -0
  389. package/dist/oauth-manual.js +84 -0
  390. package/dist/oauth-manual.js.map +1 -0
  391. package/dist/oauth-persistence.d.ts +20 -0
  392. package/dist/oauth-persistence.d.ts.map +1 -0
  393. package/dist/oauth-persistence.js +254 -0
  394. package/dist/oauth-persistence.js.map +1 -0
  395. package/dist/oauth-vault.d.ts +19 -0
  396. package/dist/oauth-vault.d.ts.map +1 -0
  397. package/dist/oauth-vault.js +100 -0
  398. package/dist/oauth-vault.js.map +1 -0
  399. package/dist/oauth.d.ts +31 -0
  400. package/dist/oauth.d.ts.map +1 -0
  401. package/dist/oauth.js +414 -0
  402. package/dist/oauth.js.map +1 -0
  403. package/dist/result-utils.d.ts +22 -0
  404. package/dist/result-utils.d.ts.map +1 -0
  405. package/dist/result-utils.js +229 -0
  406. package/dist/result-utils.js.map +1 -0
  407. package/dist/runtime/errors.d.ts +2 -0
  408. package/dist/runtime/errors.d.ts.map +1 -0
  409. package/dist/runtime/errors.js +16 -0
  410. package/dist/runtime/errors.js.map +1 -0
  411. package/dist/runtime/http-transport.d.ts +15 -0
  412. package/dist/runtime/http-transport.d.ts.map +1 -0
  413. package/dist/runtime/http-transport.js +91 -0
  414. package/dist/runtime/http-transport.js.map +1 -0
  415. package/dist/runtime/manual-oauth.d.ts +8 -0
  416. package/dist/runtime/manual-oauth.d.ts.map +1 -0
  417. package/dist/runtime/manual-oauth.js +81 -0
  418. package/dist/runtime/manual-oauth.js.map +1 -0
  419. package/dist/runtime/oauth.d.ts +22 -0
  420. package/dist/runtime/oauth.d.ts.map +1 -0
  421. package/dist/runtime/oauth.js +83 -0
  422. package/dist/runtime/oauth.js.map +1 -0
  423. package/dist/runtime/transport.d.ts +24 -0
  424. package/dist/runtime/transport.d.ts.map +1 -0
  425. package/dist/runtime/transport.js +165 -0
  426. package/dist/runtime/transport.js.map +1 -0
  427. package/dist/runtime/utils.d.ts +5 -0
  428. package/dist/runtime/utils.d.ts.map +1 -0
  429. package/dist/runtime/utils.js +47 -0
  430. package/dist/runtime/utils.js.map +1 -0
  431. package/dist/runtime-header-utils.d.ts +2 -0
  432. package/dist/runtime-header-utils.d.ts.map +1 -0
  433. package/dist/runtime-header-utils.js +19 -0
  434. package/dist/runtime-header-utils.js.map +1 -0
  435. package/dist/runtime-oauth-support.d.ts +5 -0
  436. package/dist/runtime-oauth-support.d.ts.map +1 -0
  437. package/dist/runtime-oauth-support.js +21 -0
  438. package/dist/runtime-oauth-support.js.map +1 -0
  439. package/dist/runtime-process-utils.d.ts +11 -0
  440. package/dist/runtime-process-utils.d.ts.map +1 -0
  441. package/dist/runtime-process-utils.js +299 -0
  442. package/dist/runtime-process-utils.js.map +1 -0
  443. package/dist/runtime.d.ts +55 -0
  444. package/dist/runtime.d.ts.map +1 -0
  445. package/dist/runtime.js +245 -0
  446. package/dist/runtime.js.map +1 -0
  447. package/dist/schema-cache.d.ts +10 -0
  448. package/dist/schema-cache.d.ts.map +1 -0
  449. package/dist/schema-cache.js +40 -0
  450. package/dist/schema-cache.js.map +1 -0
  451. package/dist/sdk-patches.d.ts +5 -0
  452. package/dist/sdk-patches.d.ts.map +1 -0
  453. package/dist/sdk-patches.js +399 -0
  454. package/dist/sdk-patches.js.map +1 -0
  455. package/dist/server-proxy.d.ts +17 -0
  456. package/dist/server-proxy.d.ts.map +1 -0
  457. package/dist/server-proxy.js +342 -0
  458. package/dist/server-proxy.js.map +1 -0
  459. package/docs/RELEASE.md +96 -0
  460. package/docs/adhoc.md +76 -0
  461. package/docs/call-heuristic.md +31 -0
  462. package/docs/call-syntax.md +75 -0
  463. package/docs/cli-generator.md +116 -0
  464. package/docs/cli-reference.md +76 -0
  465. package/docs/config.md +208 -0
  466. package/docs/daemon.md +95 -0
  467. package/docs/emit-ts.md +98 -0
  468. package/docs/hang-debug.md +88 -0
  469. package/docs/import.md +59 -0
  470. package/docs/known-issues.md +33 -0
  471. package/docs/livetests.md +31 -0
  472. package/docs/local.md +73 -0
  473. package/docs/logging.md +67 -0
  474. package/docs/manual-testing.md +78 -0
  475. package/docs/mcp.md +44 -0
  476. package/docs/migration.md +77 -0
  477. package/docs/pnpm-mcp-migration.md +15 -0
  478. package/docs/refactor.md +76 -0
  479. package/docs/shortcuts.md +31 -0
  480. package/docs/spec.md +86 -0
  481. package/docs/subagent.md +39 -0
  482. package/docs/supabase-auth-issue.md +53 -0
  483. package/docs/tmux.md +30 -0
  484. package/docs/tool-calling.md +73 -0
  485. package/docs/windows.md +25 -0
  486. package/examples/context7-headlines.ts +72 -0
  487. package/git +3 -0
  488. package/mcporter.png +0 -0
  489. package/mcporter.schema.json +263 -0
  490. package/package.json +105 -0
  491. package/pnpm-workspace.yaml +2 -0
  492. package/runner +13 -0
  493. package/scripts/agent-send.ts +179 -0
  494. package/scripts/build-bun.ts +125 -0
  495. package/scripts/committer +53 -0
  496. package/scripts/docs-list.ts +132 -0
  497. package/scripts/generate-json-schema.ts +50 -0
  498. package/scripts/git-policy.ts +165 -0
  499. package/scripts/mcp_signoz_retry_patch.cjs +9 -0
  500. package/scripts/release.sh +86 -0
  501. package/scripts/runner.ts +1556 -0
  502. package/scripts/test-runner.js +39 -0
  503. package/src/cli/adhoc-server.ts +263 -0
  504. package/src/cli/auth-command.ts +290 -0
  505. package/src/cli/call-argument-expression.ts +61 -0
  506. package/src/cli/call-argument-values.ts +95 -0
  507. package/src/cli/call-arguments.ts +246 -0
  508. package/src/cli/call-command.ts +478 -0
  509. package/src/cli/call-expression-parser.ts +210 -0
  510. package/src/cli/cli-factory.ts +51 -0
  511. package/src/cli/command-inference.ts +99 -0
  512. package/src/cli/config/add.ts +308 -0
  513. package/src/cli/config/auth.ts +23 -0
  514. package/src/cli/config/doctor.ts +27 -0
  515. package/src/cli/config/get.ts +47 -0
  516. package/src/cli/config/help.ts +213 -0
  517. package/src/cli/config/import.ts +97 -0
  518. package/src/cli/config/index.ts +1 -0
  519. package/src/cli/config/list.ts +81 -0
  520. package/src/cli/config/remove.ts +20 -0
  521. package/src/cli/config/render.ts +119 -0
  522. package/src/cli/config/shared.ts +159 -0
  523. package/src/cli/config/types.ts +8 -0
  524. package/src/cli/config-command.ts +72 -0
  525. package/src/cli/daemon-command.ts +260 -0
  526. package/src/cli/emit-ts-command.ts +260 -0
  527. package/src/cli/emit-ts-templates.ts +161 -0
  528. package/src/cli/ephemeral-flags.ts +128 -0
  529. package/src/cli/ephemeral-target.ts +134 -0
  530. package/src/cli/errors.ts +6 -0
  531. package/src/cli/flag-utils.ts +29 -0
  532. package/src/cli/generate/artifacts.ts +308 -0
  533. package/src/cli/generate/definition.ts +325 -0
  534. package/src/cli/generate/flag-parser.ts +50 -0
  535. package/src/cli/generate/flags.ts +248 -0
  536. package/src/cli/generate/fs-helpers.ts +34 -0
  537. package/src/cli/generate/name-utils.ts +176 -0
  538. package/src/cli/generate/output.ts +27 -0
  539. package/src/cli/generate/runtime.ts +38 -0
  540. package/src/cli/generate/server-utils.ts +38 -0
  541. package/src/cli/generate/template-data.ts +126 -0
  542. package/src/cli/generate/template-help.ts +112 -0
  543. package/src/cli/generate/template.ts +407 -0
  544. package/src/cli/generate/tools.ts +354 -0
  545. package/src/cli/generate/types.ts +1 -0
  546. package/src/cli/generate-cli-runner.ts +82 -0
  547. package/src/cli/help-output.ts +207 -0
  548. package/src/cli/http-utils.ts +89 -0
  549. package/src/cli/identifier-helpers.ts +107 -0
  550. package/src/cli/image-output.ts +62 -0
  551. package/src/cli/inspect-cli-command.ts +89 -0
  552. package/src/cli/json-output.ts +60 -0
  553. package/src/cli/list-command.ts +432 -0
  554. package/src/cli/list-detail-helpers.ts +179 -0
  555. package/src/cli/list-doc-comments.ts +129 -0
  556. package/src/cli/list-format.ts +150 -0
  557. package/src/cli/list-output.ts +224 -0
  558. package/src/cli/list-signature.ts +217 -0
  559. package/src/cli/logger-context.ts +36 -0
  560. package/src/cli/output-format.ts +63 -0
  561. package/src/cli/output-utils.ts +161 -0
  562. package/src/cli/path-utils.ts +13 -0
  563. package/src/cli/runtime-debug.ts +141 -0
  564. package/src/cli/server-lookup.ts +22 -0
  565. package/src/cli/terminal.ts +41 -0
  566. package/src/cli/timeouts.ts +67 -0
  567. package/src/cli/tool-cache.ts +43 -0
  568. package/src/cli/transport-utils.ts +10 -0
  569. package/src/cli-metadata.ts +164 -0
  570. package/src/cli.ts +234 -0
  571. package/src/config/imports/external.ts +284 -0
  572. package/src/config/imports/paths-utils.ts +29 -0
  573. package/src/config/imports/paths.ts +145 -0
  574. package/src/config/imports/shared.ts +27 -0
  575. package/src/config/path-discovery.ts +79 -0
  576. package/src/config/read-config.ts +91 -0
  577. package/src/config-imports.ts +12 -0
  578. package/src/config-normalize.ts +220 -0
  579. package/src/config-schema.ts +175 -0
  580. package/src/config.ts +136 -0
  581. package/src/daemon/client.ts +350 -0
  582. package/src/daemon/config-layers.ts +23 -0
  583. package/src/daemon/host.ts +455 -0
  584. package/src/daemon/launch.ts +45 -0
  585. package/src/daemon/log-context.ts +78 -0
  586. package/src/daemon/paths.ts +35 -0
  587. package/src/daemon/protocol.ts +57 -0
  588. package/src/daemon/request-utils.ts +67 -0
  589. package/src/daemon/runtime-wrapper.ts +135 -0
  590. package/src/env.ts +107 -0
  591. package/src/error-classifier.ts +158 -0
  592. package/src/fs-json.ts +21 -0
  593. package/src/generate-cli.ts +211 -0
  594. package/src/index.ts +14 -0
  595. package/src/lifecycle.ts +138 -0
  596. package/src/logging.ts +93 -0
  597. package/src/oauth-manual.ts +103 -0
  598. package/src/oauth-persistence.ts +316 -0
  599. package/src/oauth-vault.ts +128 -0
  600. package/src/oauth.ts +494 -0
  601. package/src/result-utils.ts +278 -0
  602. package/src/runtime/errors.ts +17 -0
  603. package/src/runtime/oauth.ts +112 -0
  604. package/src/runtime/transport.ts +198 -0
  605. package/src/runtime/utils.ts +54 -0
  606. package/src/runtime-header-utils.ts +23 -0
  607. package/src/runtime-oauth-support.ts +24 -0
  608. package/src/runtime-process-utils.ts +324 -0
  609. package/src/runtime.ts +321 -0
  610. package/src/schema-cache.ts +49 -0
  611. package/src/sdk-patches.ts +498 -0
  612. package/src/server-proxy.ts +407 -0
  613. package/tests/adhoc-server.test.ts +49 -0
  614. package/tests/call-arguments.test.ts +111 -0
  615. package/tests/cli-auth-help.test.ts +43 -0
  616. package/tests/cli-auth-retry.test.ts +41 -0
  617. package/tests/cli-auth.test.ts +96 -0
  618. package/tests/cli-call-args.test.ts +69 -0
  619. package/tests/cli-call-errors.test.ts +27 -0
  620. package/tests/cli-call-execution.test.ts +279 -0
  621. package/tests/cli-call-help.test.ts +43 -0
  622. package/tests/cli-command-inference.test.ts +73 -0
  623. package/tests/cli-config-command.test.ts +371 -0
  624. package/tests/cli-config-fallback.test.ts +259 -0
  625. package/tests/cli-config-routing.test.ts +20 -0
  626. package/tests/cli-ephemeral-flags.test.ts +54 -0
  627. package/tests/cli-flag-utils.test.ts +17 -0
  628. package/tests/cli-generate-artifacts.test.ts +52 -0
  629. package/tests/cli-generate-cli.integration.test.ts +675 -0
  630. package/tests/cli-generate-runner.test.ts +156 -0
  631. package/tests/cli-global-flags.test.ts +61 -0
  632. package/tests/cli-help-shortcuts.test.ts +42 -0
  633. package/tests/cli-image-output.test.ts +65 -0
  634. package/tests/cli-inspect-command.test.ts +15 -0
  635. package/tests/cli-list-classification.test.ts +291 -0
  636. package/tests/cli-list-flags.test.ts +83 -0
  637. package/tests/cli-list-formatting.test.ts +358 -0
  638. package/tests/cli-list-help.test.ts +43 -0
  639. package/tests/cli-list-json.test.ts +55 -0
  640. package/tests/cli-list-stdio-logs.test.ts +108 -0
  641. package/tests/cli-list-verbose-e2e.test.ts +83 -0
  642. package/tests/cli-oauth-timeout-flag.test.ts +94 -0
  643. package/tests/cli-output-utils.test.ts +129 -0
  644. package/tests/cli-regenerate.test.ts +261 -0
  645. package/tests/cli-version.test.ts +24 -0
  646. package/tests/config-add-dry-run.test.ts +45 -0
  647. package/tests/config-add-flags.test.ts +61 -0
  648. package/tests/config-add-imports.test.ts +28 -0
  649. package/tests/config-add-persist.test.ts +27 -0
  650. package/tests/config-add-scope-behavior.test.ts +46 -0
  651. package/tests/config-add-scope.test.ts +101 -0
  652. package/tests/config-add-sse.test.ts +23 -0
  653. package/tests/config-command-string.test.ts +96 -0
  654. package/tests/config-doctor.test.ts +45 -0
  655. package/tests/config-get-json.test.ts +24 -0
  656. package/tests/config-import-dedupe.test.ts +27 -0
  657. package/tests/config-import-paths.test.ts +49 -0
  658. package/tests/config-import.test.ts +64 -0
  659. package/tests/config-imports-unit.test.ts +337 -0
  660. package/tests/config-imports.test.ts +417 -0
  661. package/tests/config-layered.test.ts +178 -0
  662. package/tests/config-list-text-footer.test.ts +33 -0
  663. package/tests/config-list.test.ts +62 -0
  664. package/tests/config-missing.test.ts +140 -0
  665. package/tests/config-normalize.test.ts +71 -0
  666. package/tests/config-remove.test.ts +44 -0
  667. package/tests/config-render.test.ts +61 -0
  668. package/tests/config-resolution.test.ts +94 -0
  669. package/tests/config-schema-file.test.ts +29 -0
  670. package/tests/config-shared.test.ts +41 -0
  671. package/tests/config-sources.test.ts +58 -0
  672. package/tests/daemon-cli-command.test.ts +112 -0
  673. package/tests/daemon-client-config-stale.test.ts +222 -0
  674. package/tests/daemon-client-timeout.test.ts +114 -0
  675. package/tests/daemon-client.test.ts +61 -0
  676. package/tests/daemon-host.test.ts +33 -0
  677. package/tests/daemon.integration.test.ts +175 -0
  678. package/tests/emit-ts.test.ts +125 -0
  679. package/tests/ephemeral-target.test.ts +26 -0
  680. package/tests/error-classifier.test.ts +46 -0
  681. package/tests/fixtures/ansi.ts +18 -0
  682. package/tests/fixtures/cli-list-fixtures.ts +43 -0
  683. package/tests/fixtures/config-fixture.ts +29 -0
  684. package/tests/fixtures/imports/.claude/mcp.json +8 -0
  685. package/tests/fixtures/imports/.claude/settings.json +10 -0
  686. package/tests/fixtures/imports/.claude/settings.local.json +10 -0
  687. package/tests/fixtures/imports/.codeium/windsurf/mcp_config.json +14 -0
  688. package/tests/fixtures/imports/.codex/config.toml +7 -0
  689. package/tests/fixtures/imports/.config/opencode/opencode.jsonc +10 -0
  690. package/tests/fixtures/imports/.cursor/mcp.json +14 -0
  691. package/tests/fixtures/imports/Library/Application Support/Code/User/mcp.json +11 -0
  692. package/tests/fixtures/imports/config/mcporter.json +11 -0
  693. package/tests/fixtures/imports/home/.claude/settings.json +7 -0
  694. package/tests/fixtures/imports/home/.codeium/windsurf/mcp_config.json +14 -0
  695. package/tests/fixtures/imports/home/.codex/config.toml +7 -0
  696. package/tests/fixtures/imports/home/Library/Application Support/Code/User/mcp.json +11 -0
  697. package/tests/fixtures/imports/opencode.jsonc +11 -0
  698. package/tests/fixtures/mcporter.json +64 -0
  699. package/tests/fixtures/stdio-filesystem-server.mjs +63 -0
  700. package/tests/fixtures/stdio-memory-server.mjs +58 -0
  701. package/tests/fixtures/test-helpers.ts +24 -0
  702. package/tests/fixtures/tool-fixtures.ts +35 -0
  703. package/tests/fs-json.test.ts +35 -0
  704. package/tests/generate-cli-helpers.test.ts +162 -0
  705. package/tests/generate-cli.test.ts +595 -0
  706. package/tests/generate-definition.test.ts +25 -0
  707. package/tests/generator-flag-parser.test.ts +19 -0
  708. package/tests/index-api.test.ts +136 -0
  709. package/tests/keep-alive-runtime.test.ts +152 -0
  710. package/tests/lifecycle.test.ts +29 -0
  711. package/tests/list-detail-helpers.test.ts +204 -0
  712. package/tests/list-format.test.ts +40 -0
  713. package/tests/list-inline-stdio.test.ts +71 -0
  714. package/tests/list-output.test.ts +138 -0
  715. package/tests/live/deepwiki-live.test.ts +53 -0
  716. package/tests/oauth-callback.test.ts +108 -0
  717. package/tests/oauth-open-external.test.ts +29 -0
  718. package/tests/oauth-persistence.test.ts +146 -0
  719. package/tests/oauth-session.test.ts +216 -0
  720. package/tests/result-utils.test.ts +254 -0
  721. package/tests/runtime-call-timeout.test.ts +75 -0
  722. package/tests/runtime-compose.test.ts +298 -0
  723. package/tests/runtime-error-reset.test.ts +65 -0
  724. package/tests/runtime-header-utils.test.ts +36 -0
  725. package/tests/runtime-integration.test.ts +113 -0
  726. package/tests/runtime-oauth-connect.test.ts +72 -0
  727. package/tests/runtime-oauth-detection.test.ts +72 -0
  728. package/tests/runtime-oauth-timeout.test.ts +60 -0
  729. package/tests/runtime-oauth-utils.test.ts +14 -0
  730. package/tests/runtime-process-utils.test.ts +53 -0
  731. package/tests/runtime-transport.test.ts +69 -0
  732. package/tests/runtime-utils.test.ts +31 -0
  733. package/tests/runtime.test.ts +94 -0
  734. package/tests/sdk-patches.test.ts +24 -0
  735. package/tests/server-proxy.test.ts +336 -0
  736. package/tests/stdio-servers.integration.test.ts +139 -0
  737. package/tests/tool-cache.test.ts +42 -0
  738. package/tests/version-consistency.test.ts +11 -0
  739. package/tsconfig.build.json +11 -0
  740. package/tsconfig.json +17 -0
  741. package/vitest.config.ts +18 -0
@@ -0,0 +1,134 @@
1
+ {
2
+ "mcpServers": {
3
+ "chrome-devtools": {
4
+ "description": "Chrome DevTools protocol bridge for driving local tabs during debugging or automation.",
5
+ "command": "npx",
6
+ "args": [
7
+ "-y",
8
+ "chrome-devtools-mcp@latest"
9
+ ],
10
+ "env": {
11
+ "npm_config_loglevel": "error"
12
+ }
13
+ },
14
+ "mobile-mcp": {
15
+ "description": "Mobile Next MCP server for automating iOS/Android simulators and devices.",
16
+ "command": "npx",
17
+ "args": [
18
+ "-y",
19
+ "@mobilenext/mobile-mcp@latest"
20
+ ],
21
+ "env": {
22
+ "npm_config_loglevel": "error"
23
+ }
24
+ },
25
+ "context7": {
26
+ "description": "Context7 MCP for React documentation lookup.",
27
+ "baseUrl": "https://mcp.context7.com/mcp"
28
+ },
29
+ "deepwiki": {
30
+ "description": "DeepWiki MCP server for querying public code/docs without local checkout.",
31
+ "baseUrl": "https://mcp.deepwiki.com/mcp"
32
+ },
33
+ "linear": {
34
+ "description": "Hosted Linear MCP; exposes issue search, create, and workflow tooling.",
35
+ "baseUrl": "https://mcp.linear.app/sse",
36
+ "auth": "oauth"
37
+ },
38
+ "notion": {
39
+ "description": "Notion MCP; search, read, create, and update Notion pages and databases.",
40
+ "baseUrl": "https://mcp.notion.com/mcp",
41
+ "auth": "oauth"
42
+ },
43
+ "next-devtools": {
44
+ "description": "Next.js dev server introspection (project metadata, logs, page insights).",
45
+ "baseUrl": "http://localhost:3000/_next/mcp"
46
+ },
47
+ "obsidian": {
48
+ "description": "Local Obsidian vault access via obsidian-mcp-server.",
49
+ "command": "npx",
50
+ "args": [
51
+ "-y",
52
+ "obsidian-mcp-server@latest"
53
+ ],
54
+ "env": {
55
+ "OBSIDIAN_API_KEY": "${OBSIDIAN_API_KEY}",
56
+ "OBSIDIAN_BASE_URL": "${OBSIDIAN_BASE_URL:-https://127.0.0.1:27124}",
57
+ "OBSIDIAN_VERIFY_SSL": "${OBSIDIAN_VERIFY_SSL:-false}",
58
+ "OBSIDIAN_ENABLE_CACHE": "${OBSIDIAN_ENABLE_CACHE:-true}",
59
+ "npm_config_loglevel": "error"
60
+ }
61
+ },
62
+ "playwright": {
63
+ "command": "npx @playwright/mcp --browser chrome"
64
+ },
65
+ "vercel": {
66
+ "description": "Vercel MCP (requires OAuth).",
67
+ "baseUrl": "https://mcp.vercel.com",
68
+ "auth": "oauth",
69
+ "tokenCacheDir": "~/.mcporter/vercel",
70
+ "oauthRedirectUrl": "http://localhost:58653/callback"
71
+ },
72
+ "firecrawl": {
73
+ "description": "Firecrawl hosted MCP for authenticated scraping and extraction.",
74
+ "baseUrl": "https://mcp.firecrawl.dev/v2/mcp",
75
+ "headers": {
76
+ "Authorization": "Bearer ${FIRECRAWL_API_KEY}"
77
+ }
78
+ },
79
+ "github": {
80
+ "description": "GitHub MCP server (requires PAT in GITHUB_TOKEN).",
81
+ "baseUrl": "https://api.githubcopilot.com/mcp/",
82
+ "bearerTokenEnv": "GITHUB_TOKEN"
83
+ },
84
+ "signoz": {
85
+ "description": "SigNoz Query MCP server (logs, traces, metrics).",
86
+ "command": "npx",
87
+ "args": [
88
+ "-y",
89
+ "signoz-mcp-server@latest"
90
+ ],
91
+ "env": {
92
+ "SIGNOZ_URL": "${SIGNOZ_URL:-http://localhost:3301}",
93
+ "SIGNOZ_TOKEN": "${SIGNOZ_TOKEN:-}",
94
+ "npm_config_loglevel": "error",
95
+ "NODE_OPTIONS": "--require=./scripts/mcp_signoz_retry_patch.cjs"
96
+ }
97
+ },
98
+ "shadcn": {
99
+ "description": "shadcn/ui registry MCP for browsing component recipes.",
100
+ "baseUrl": "https://www.shadcn.io/api/mcp"
101
+ },
102
+ "iterm": {
103
+ "description": "iTerm2 terminal bridge via local iterm-mcp",
104
+ "command": "pnpm",
105
+ "args": [
106
+ "--dir",
107
+ "/Users/steipete/Projects/iterm-mcp",
108
+ "exec",
109
+ "node",
110
+ "build/index.js"
111
+ ],
112
+ "env": {
113
+ "npm_config_loglevel": "error"
114
+ }
115
+ },
116
+ "XcodeBuildMCP": {
117
+ "description": "XcodeBuild MCP server for building, testing, and inspecting Xcode projects and simulators.",
118
+ "command": "npx",
119
+ "args": [
120
+ "-y",
121
+ "xcodebuildmcp@latest"
122
+ ],
123
+ "env": {
124
+ "npm_config_loglevel": "error"
125
+ }
126
+ }
127
+ },
128
+ "imports": [
129
+ "cursor",
130
+ "claude-code",
131
+ "claude-desktop",
132
+ "codex"
133
+ ]
134
+ }
@@ -0,0 +1,21 @@
1
+ import type { ServerDefinition } from '../config.js';
2
+ export interface EphemeralServerSpec {
3
+ name?: string;
4
+ httpUrl?: string;
5
+ allowInsecureHttp?: boolean;
6
+ stdioCommand?: string;
7
+ stdioArgs?: string[];
8
+ cwd?: string;
9
+ env?: Record<string, string>;
10
+ description?: string;
11
+ persistPath?: string;
12
+ }
13
+ export interface EphemeralServerResolution {
14
+ definition: ServerDefinition;
15
+ name: string;
16
+ persistedEntry: Record<string, unknown>;
17
+ }
18
+ export declare function resolveEphemeralServer(spec: EphemeralServerSpec): EphemeralServerResolution;
19
+ export declare function persistEphemeralServer(resolution: EphemeralServerResolution, rawPath: string): Promise<void>;
20
+ export declare function splitCommandLine(input: string): string[];
21
+ //# sourceMappingURL=adhoc-server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adhoc-server.d.ts","sourceRoot":"","sources":["../../src/cli/adhoc-server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAe,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAKlE,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAID,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,yBAAyB,CA6E3F;AAED,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBlH;AA4ED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA2CxD"}
@@ -0,0 +1,228 @@
1
+ import fs from 'node:fs/promises';
2
+ import path from 'node:path';
3
+ import { __configInternals } from '../config.js';
4
+ import { expandHome } from '../env.js';
5
+ import { canonicalKeepAliveName, resolveLifecycle } from '../lifecycle.js';
6
+ const TEMP_SOURCE = { kind: 'local', path: '<adhoc>' };
7
+ export function resolveEphemeralServer(spec) {
8
+ if (!spec.httpUrl && !spec.stdioCommand) {
9
+ throw new Error('Ad-hoc servers require either --http-url or --stdio.');
10
+ }
11
+ if (spec.httpUrl && spec.stdioCommand) {
12
+ throw new Error('Cannot combine --http-url and --stdio in the same ad-hoc server.');
13
+ }
14
+ if (spec.httpUrl) {
15
+ const url = new URL(spec.httpUrl);
16
+ if (url.protocol !== 'https:' && url.protocol !== 'http:') {
17
+ throw new Error(`Unsupported protocol '${url.protocol}' for --http-url.`);
18
+ }
19
+ if (url.protocol === 'http:' && !spec.allowInsecureHttp) {
20
+ throw new Error('HTTP endpoints require --allow-http to confirm insecure usage.');
21
+ }
22
+ const command = {
23
+ kind: 'http',
24
+ url,
25
+ headers: __configInternals.ensureHttpAcceptHeader(undefined),
26
+ };
27
+ const canonical = spec.name ? undefined : canonicalKeepAliveName(command);
28
+ const name = slugify(spec.name ?? canonical ?? inferNameFromUrl(url));
29
+ const lifecycle = resolveLifecycle(name, undefined, command);
30
+ const definition = {
31
+ name,
32
+ description: spec.description,
33
+ command,
34
+ env: spec.env && Object.keys(spec.env).length > 0 ? spec.env : undefined,
35
+ source: TEMP_SOURCE,
36
+ lifecycle,
37
+ };
38
+ const persistedEntry = {
39
+ baseUrl: url.href,
40
+ ...(spec.description ? { description: spec.description } : {}),
41
+ ...(spec.env && Object.keys(spec.env).length > 0 ? { env: spec.env } : {}),
42
+ ...(lifecycle ? { lifecycle: serializeLifecycle(lifecycle) } : {}),
43
+ };
44
+ return { definition, name, persistedEntry };
45
+ }
46
+ const stdioCommand = spec.stdioCommand;
47
+ const parts = splitCommandLine(stdioCommand);
48
+ if (parts.length === 0) {
49
+ throw new Error('--stdio requires a non-empty command.');
50
+ }
51
+ const [commandBinary, ...commandRest] = parts;
52
+ const commandArgs = commandRest.concat(spec.stdioArgs ?? []);
53
+ const cwd = spec.cwd ? path.resolve(spec.cwd) : process.cwd();
54
+ const command = {
55
+ kind: 'stdio',
56
+ command: commandBinary,
57
+ args: commandArgs,
58
+ cwd,
59
+ };
60
+ const canonical = spec.name ? undefined : canonicalKeepAliveName(command);
61
+ const name = slugify(spec.name ?? canonical ?? inferNameFromCommand(parts));
62
+ const lifecycle = resolveLifecycle(name, undefined, command);
63
+ const definition = {
64
+ name,
65
+ description: spec.description,
66
+ command,
67
+ env: spec.env && Object.keys(spec.env).length > 0 ? spec.env : undefined,
68
+ source: TEMP_SOURCE,
69
+ lifecycle,
70
+ };
71
+ const persistedEntry = {
72
+ command: commandBinary,
73
+ ...(commandArgs.length > 0 ? { args: commandArgs } : {}),
74
+ ...(spec.description ? { description: spec.description } : {}),
75
+ ...(spec.env && Object.keys(spec.env).length > 0 ? { env: spec.env } : {}),
76
+ ...(lifecycle ? { lifecycle: serializeLifecycle(lifecycle) } : {}),
77
+ };
78
+ if (spec.cwd) {
79
+ persistedEntry.cwd = spec.cwd;
80
+ }
81
+ return { definition, name, persistedEntry };
82
+ }
83
+ export async function persistEphemeralServer(resolution, rawPath) {
84
+ const resolvedPath = path.resolve(expandHome(rawPath));
85
+ let existing;
86
+ try {
87
+ const buffer = await fs.readFile(resolvedPath, 'utf8');
88
+ existing = JSON.parse(buffer);
89
+ }
90
+ catch (error) {
91
+ if (error.code !== 'ENOENT') {
92
+ throw error;
93
+ }
94
+ existing = { mcpServers: {} };
95
+ }
96
+ if (typeof existing.mcpServers !== 'object' || existing.mcpServers === null) {
97
+ existing.mcpServers = {};
98
+ }
99
+ const servers = existing.mcpServers;
100
+ servers[resolution.name] = resolution.persistedEntry;
101
+ await fs.mkdir(path.dirname(resolvedPath), { recursive: true });
102
+ const serialized = `${JSON.stringify(existing, null, 2)}\n`;
103
+ await fs.writeFile(resolvedPath, serialized, 'utf8');
104
+ }
105
+ function inferNameFromUrl(url) {
106
+ const host = url.hostname.replace(/^www\./, '');
107
+ const pathSegments = url.pathname.split('/').filter(Boolean);
108
+ if (pathSegments.length === 0) {
109
+ return host;
110
+ }
111
+ return `${host}-${pathSegments[pathSegments.length - 1]}`;
112
+ }
113
+ function inferNameFromCommand(parts) {
114
+ const wrapperPackage = inferPackageFromWrapper(parts);
115
+ if (wrapperPackage) {
116
+ return wrapperPackage;
117
+ }
118
+ const executable = path.basename(parts[0] ?? 'command');
119
+ if (parts.length === 1) {
120
+ return executable;
121
+ }
122
+ const script = parts.find((segment) => segment.endsWith('.ts') || segment.endsWith('.js'));
123
+ if (script) {
124
+ return `${executable}-${path.basename(script, path.extname(script))}`;
125
+ }
126
+ const fallback = parts[1] ?? 'tool';
127
+ return `${executable}-${fallback}`;
128
+ }
129
+ function inferPackageFromWrapper(parts) {
130
+ if (parts.length < 2) {
131
+ return undefined;
132
+ }
133
+ const executable = path.basename(parts[0] ?? '');
134
+ if (executable !== 'npx') {
135
+ return undefined;
136
+ }
137
+ for (let index = 1; index < parts.length; index += 1) {
138
+ const token = parts[index];
139
+ if (!token) {
140
+ continue;
141
+ }
142
+ if (token === '--') {
143
+ break;
144
+ }
145
+ if (token.startsWith('-')) {
146
+ continue;
147
+ }
148
+ return stripPackageVersion(token);
149
+ }
150
+ return undefined;
151
+ }
152
+ function stripPackageVersion(token) {
153
+ if (token.startsWith('@')) {
154
+ const secondAt = token.indexOf('@', 1);
155
+ if (secondAt !== -1) {
156
+ return token.slice(0, secondAt);
157
+ }
158
+ return token;
159
+ }
160
+ const versionAt = token.indexOf('@');
161
+ if (versionAt > 0) {
162
+ return token.slice(0, versionAt);
163
+ }
164
+ return token;
165
+ }
166
+ function slugify(value) {
167
+ return value
168
+ .trim()
169
+ .toLowerCase()
170
+ .replace(/[^a-z0-9]+/g, '-')
171
+ .replace(/^-+|-+$/g, '')
172
+ .replace(/-{2,}/g, '-');
173
+ }
174
+ export function splitCommandLine(input) {
175
+ const result = [];
176
+ let current = '';
177
+ let inSingle = false;
178
+ let inDouble = false;
179
+ for (let i = 0; i < input.length; i += 1) {
180
+ const char = input.charAt(i);
181
+ if (char === "'" && !inDouble) {
182
+ inSingle = !inSingle;
183
+ continue;
184
+ }
185
+ if (char === '"' && !inSingle) {
186
+ inDouble = !inDouble;
187
+ continue;
188
+ }
189
+ if (!inSingle && !inDouble && /\s/.test(char)) {
190
+ if (current !== '') {
191
+ result.push(current);
192
+ current = '';
193
+ }
194
+ continue;
195
+ }
196
+ if (char === '\\' && !inSingle && i + 1 < input.length) {
197
+ const next = input.charAt(i + 1);
198
+ if (inDouble && next !== '"' && next !== '\\' && next !== '$') {
199
+ current += char;
200
+ continue;
201
+ }
202
+ current += next;
203
+ i += 1;
204
+ continue;
205
+ }
206
+ current += char;
207
+ }
208
+ if (inSingle || inDouble) {
209
+ throw new Error('Unterminated quote in --stdio command.');
210
+ }
211
+ if (current !== '') {
212
+ result.push(current);
213
+ }
214
+ return result;
215
+ }
216
+ function serializeLifecycle(lifecycle) {
217
+ if (!lifecycle) {
218
+ return undefined;
219
+ }
220
+ if (lifecycle.mode === 'keep-alive' && lifecycle.idleTimeoutMs === undefined) {
221
+ return 'keep-alive';
222
+ }
223
+ if (lifecycle.mode === 'keep-alive') {
224
+ return { mode: 'keep-alive', idleTimeoutMs: lifecycle.idleTimeoutMs };
225
+ }
226
+ return 'ephemeral';
227
+ }
228
+ //# sourceMappingURL=adhoc-server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adhoc-server.js","sourceRoot":"","sources":["../../src/cli/adhoc-server.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import type { createRuntime } from '../runtime.js';
2
+ type Runtime = Awaited<ReturnType<typeof createRuntime>>;
3
+ export declare function handleAuth(runtime: Runtime, args: string[]): Promise<void>;
4
+ export declare function printAuthHelp(): void;
5
+ export {};
6
+ //# sourceMappingURL=auth-command.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auth-command.d.ts","sourceRoot":"","sources":["../../src/cli/auth-command.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AASnD,KAAK,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC;AAEzD,wBAAsB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgGhF;AA0ID,wBAAgB,aAAa,IAAI,IAAI,CAkCpC"}
@@ -0,0 +1,257 @@
1
+ import { spawn } from 'node:child_process';
2
+ import { auth as mcpAuth } from '@modelcontextprotocol/sdk/client/auth.js';
3
+ import { analyzeConnectionError } from '../error-classifier.js';
4
+ import { createCodeExchangeProvider, createManualOAuthSession } from '../oauth.js';
5
+ import { parseManualOAuthCallback } from '../oauth-manual.js';
6
+ import { buildOAuthPersistence, clearOAuthCaches } from '../oauth-persistence.js';
7
+ import { findServerNameByState } from '../oauth-vault.js';
8
+ import { extractEphemeralServerFlags } from './ephemeral-flags.js';
9
+ import { prepareEphemeralServerTarget } from './ephemeral-target.js';
10
+ import { looksLikeHttpUrl } from './http-utils.js';
11
+ import { buildConnectionIssueEnvelope } from './json-output.js';
12
+ import { logInfo, logWarn } from './logger-context.js';
13
+ import { consumeOutputFormat } from './output-format.js';
14
+ export async function handleAuth(runtime, args) {
15
+ // Route `auth complete` before any other flag parsing.
16
+ if (args[0] === 'complete') {
17
+ args.shift();
18
+ return handleAuthComplete(runtime, args);
19
+ }
20
+ const resetIndex = args.indexOf('--reset');
21
+ const shouldReset = resetIndex !== -1;
22
+ if (shouldReset) {
23
+ args.splice(resetIndex, 1);
24
+ }
25
+ // Parse --browser <mode>
26
+ const browserIndex = args.indexOf('--browser');
27
+ let browserMode = 'open';
28
+ if (browserIndex !== -1) {
29
+ const value = args[browserIndex + 1];
30
+ if (value === 'none') {
31
+ browserMode = 'none';
32
+ args.splice(browserIndex, 2);
33
+ }
34
+ else if (value === 'open') {
35
+ args.splice(browserIndex, 2);
36
+ }
37
+ else {
38
+ throw new Error(`Unknown --browser mode: ${String(value)}. Valid values: open, none`);
39
+ }
40
+ }
41
+ const format = consumeOutputFormat(args, {
42
+ defaultFormat: 'text',
43
+ allowed: ['text', 'json'],
44
+ enableRawShortcut: false,
45
+ jsonShortcutFlag: '--json',
46
+ });
47
+ const ephemeralSpec = extractEphemeralServerFlags(args);
48
+ let target = args.shift();
49
+ const nameHints = [];
50
+ if (ephemeralSpec && target && !looksLikeHttpUrl(target)) {
51
+ nameHints.push(target);
52
+ }
53
+ const prepared = await prepareEphemeralServerTarget({
54
+ runtime,
55
+ target,
56
+ ephemeral: ephemeralSpec,
57
+ nameHints,
58
+ reuseFromSpec: true,
59
+ });
60
+ target = prepared.target;
61
+ if (!target) {
62
+ throw new Error('Usage: mcporter auth <server | url> [--http-url <url> | --stdio <command>]');
63
+ }
64
+ const definition = runtime.getDefinition(target);
65
+ if (shouldReset) {
66
+ await clearOAuthCaches(definition);
67
+ logInfo(`Cleared cached credentials for '${target}'.`);
68
+ }
69
+ if (definition.command.kind === 'stdio' && definition.oauthCommand) {
70
+ logInfo(`Starting auth helper for '${target}' (stdio). Leave this running until the browser flow completes.`);
71
+ await runStdioAuth(definition);
72
+ logInfo(`Auth helper for '${target}' finished. You can now call tools.`);
73
+ return;
74
+ }
75
+ if (browserMode === 'none') {
76
+ return runManualBrowserFlow(target, definition);
77
+ }
78
+ for (let attempt = 0; attempt < 2; attempt += 1) {
79
+ try {
80
+ logInfo(`Initiating OAuth flow for '${target}'...`);
81
+ const tools = await runtime.listTools(target, { autoAuthorize: true });
82
+ logInfo(`Authorization complete. ${tools.length} tool${tools.length === 1 ? '' : 's'} available.`);
83
+ return;
84
+ }
85
+ catch (error) {
86
+ if (attempt === 0 && shouldRetryAuthError(error)) {
87
+ logWarn('Server signaled OAuth after the initial attempt. Retrying with browser flow...');
88
+ continue;
89
+ }
90
+ const message = error instanceof Error ? error.message : String(error);
91
+ if (format === 'json') {
92
+ const payload = buildConnectionIssueEnvelope({
93
+ server: target,
94
+ error,
95
+ issue: analyzeConnectionError(error),
96
+ });
97
+ console.log(JSON.stringify(payload, null, 2));
98
+ process.exitCode = 1;
99
+ return;
100
+ }
101
+ throw new Error(`Failed to authorize '${target}': ${message}`);
102
+ }
103
+ }
104
+ }
105
+ // runManualBrowserFlow drives the OAuth initiation without opening a browser.
106
+ // It prints the authorization URL and exits; the user completes the flow via `auth complete`.
107
+ async function runManualBrowserFlow(target, definition) {
108
+ if (definition.command.kind !== 'http') {
109
+ throw new Error(`--browser none requires an HTTP server; '${target}' uses ${definition.command.kind} transport.`);
110
+ }
111
+ const logger = makeLogger();
112
+ logInfo(`Starting manual OAuth flow for '${target}'...`);
113
+ const { provider, close } = await createManualOAuthSession(definition, logger);
114
+ try {
115
+ await mcpAuth(provider, { serverUrl: definition.command.url });
116
+ // auth() calls provider.redirectToAuthorization() which prints the URL, then returns 'REDIRECT'.
117
+ console.log(`Open the URL above in your local browser. When the redirect fails, paste it into:`);
118
+ console.log(` mcporter auth complete '<pasted-redirect-url>'`);
119
+ }
120
+ finally {
121
+ await close();
122
+ }
123
+ }
124
+ // handleAuthComplete exchanges an authorization code captured from a failed browser redirect.
125
+ async function handleAuthComplete(runtime, args) {
126
+ const pastedInput = args.shift();
127
+ if (!pastedInput) {
128
+ throw new Error('Usage: mcporter auth complete <pasted-redirect-url>');
129
+ }
130
+ const parsed = parseManualOAuthCallback(pastedInput);
131
+ if (parsed.error) {
132
+ const detail = parsed.errorDescription ? ` — ${parsed.errorDescription}` : '';
133
+ throw new Error(`OAuth error in callback: ${parsed.error}${detail}`);
134
+ }
135
+ if (!parsed.code) {
136
+ throw new Error('No authorization code found in the pasted URL.');
137
+ }
138
+ if (!parsed.state) {
139
+ throw new Error('No OAuth state found in the pasted URL. Cannot identify the pending auth session.');
140
+ }
141
+ const vaultEntry = await findServerNameByState(parsed.state);
142
+ if (!vaultEntry) {
143
+ throw new Error(`No pending auth session found matching that state. Did you run 'mcporter auth <server> --browser none' first?`);
144
+ }
145
+ const definition = resolveDefinitionForComplete(runtime, vaultEntry);
146
+ if (definition.command.kind !== 'http') {
147
+ throw new Error(`Server '${vaultEntry.serverName}' does not use HTTP transport; cannot complete OAuth manually.`);
148
+ }
149
+ const logger = makeLogger();
150
+ const persistence = await buildOAuthPersistence(definition, logger);
151
+ const clientInfo = await persistence.readClientInfo();
152
+ const redirectUri = clientInfo?.redirect_uris;
153
+ const redirectUriStr = Array.isArray(redirectUri) ? redirectUri[0] : undefined;
154
+ if (!redirectUriStr) {
155
+ throw new Error(`No saved client registration for '${definition.name}'. Run 'mcporter auth ${definition.name} --browser none' again to restart the flow.`);
156
+ }
157
+ console.log(`Completing authorization for '${definition.name}'...`);
158
+ const provider = await createCodeExchangeProvider(definition, new URL(redirectUriStr), logger);
159
+ await mcpAuth(provider, { serverUrl: definition.command.url, authorizationCode: parsed.code });
160
+ // Clear the state so it can't be replayed.
161
+ await persistence.clear('state');
162
+ console.log(`Authorization complete for '${definition.name}'. You can now use mcporter commands.`);
163
+ }
164
+ // resolveDefinitionForComplete tries to get the definition from the runtime config; falls back to
165
+ // constructing a minimal ad-hoc HTTP definition from the vault entry's serverUrl for transient
166
+ // servers (e.g. bare URLs passed directly to `auth --browser none`).
167
+ function resolveDefinitionForComplete(runtime, entry) {
168
+ try {
169
+ return runtime.getDefinition(entry.serverName);
170
+ }
171
+ catch {
172
+ if (!entry.serverUrl) {
173
+ throw new Error(`Server '${entry.serverName}' is not in the current config and has no saved URL. Cannot complete OAuth.`);
174
+ }
175
+ return {
176
+ name: entry.serverName,
177
+ command: { kind: 'http', url: new URL(entry.serverUrl) },
178
+ auth: 'oauth',
179
+ };
180
+ }
181
+ }
182
+ async function runStdioAuth(definition) {
183
+ const authArgs = [...(definition.command.kind === 'stdio' ? (definition.command.args ?? []) : [])];
184
+ if (definition.oauthCommand) {
185
+ authArgs.push(...definition.oauthCommand.args);
186
+ }
187
+ return new Promise((resolve, reject) => {
188
+ const child = spawn(definition.command.kind === 'stdio' ? definition.command.command : '', authArgs, {
189
+ stdio: 'inherit',
190
+ cwd: definition.command.kind === 'stdio' ? definition.command.cwd : process.cwd(),
191
+ env: process.env,
192
+ });
193
+ child.on('error', reject);
194
+ child.on('exit', (code) => {
195
+ if (code === 0) {
196
+ resolve();
197
+ }
198
+ else {
199
+ reject(new Error(`Auth helper exited with code ${code ?? 'null'}`));
200
+ }
201
+ });
202
+ });
203
+ }
204
+ function shouldRetryAuthError(error) {
205
+ return analyzeConnectionError(error).kind === 'auth';
206
+ }
207
+ // makeLogger returns a minimal OAuthLogger that delegates to the CLI logger context.
208
+ function makeLogger() {
209
+ return {
210
+ info: (msg) => logInfo(msg),
211
+ warn: (msg) => logWarn(msg),
212
+ error: (msg, err) => {
213
+ const detail = err instanceof Error
214
+ ? `: ${err.message}`
215
+ : err != null
216
+ ? `: ${typeof err === 'object' ? JSON.stringify(err) : String(err)}`
217
+ : '';
218
+ logWarn(`${msg}${detail}`);
219
+ },
220
+ };
221
+ }
222
+ export function printAuthHelp() {
223
+ const lines = [
224
+ 'Usage: mcporter auth <server | url> [flags]',
225
+ ' mcporter auth complete <pasted-url-or-query>',
226
+ '',
227
+ 'Purpose:',
228
+ ' Run the authentication flow for a server without listing tools.',
229
+ '',
230
+ 'Common flags:',
231
+ ' --reset Clear cached credentials before re-authorizing.',
232
+ ' --browser <mode> Browser behavior: open (default) or none.',
233
+ ' --json Emit a JSON envelope on failure.',
234
+ '',
235
+ 'Ad-hoc targets:',
236
+ ' --http-url <url> Register an HTTP server for this run.',
237
+ ' --allow-http Permit plain http:// URLs with --http-url.',
238
+ ' --stdio <command> Run a stdio MCP server (repeat --stdio-arg for args).',
239
+ ' --stdio-arg <value> Append args to the stdio command (repeatable).',
240
+ ' --env KEY=value Inject env vars for stdio servers (repeatable).',
241
+ ' --cwd <path> Working directory for stdio servers.',
242
+ ' --name <value> Override the display name for ad-hoc servers.',
243
+ ' --description <text> Override the description for ad-hoc servers.',
244
+ ' --persist <path> Write the ad-hoc definition to config/mcporter.json.',
245
+ ' --yes Skip confirmation prompts when persisting.',
246
+ '',
247
+ 'Examples:',
248
+ ' mcporter auth linear',
249
+ ' mcporter auth linear --browser none',
250
+ ' mcporter auth complete "http://127.0.0.1/callback?code=abc&state=xyz"',
251
+ ' mcporter auth https://mcp.example.com/mcp',
252
+ ' mcporter auth --stdio "npx -y chrome-devtools-mcp@latest"',
253
+ ' mcporter auth --http-url http://localhost:3000/mcp --allow-http',
254
+ ];
255
+ console.error(lines.join('\n'));
256
+ }
257
+ //# sourceMappingURL=auth-command.js.map