@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,36 @@
1
+ import { afterEach, describe, expect, it } from 'vitest';
2
+ import { materializeHeaders } from '../src/runtime-header-utils.js';
3
+
4
+ describe('materializeHeaders', () => {
5
+ const envKey = 'HEADER_TOKEN';
6
+ let previousValue: string | undefined;
7
+
8
+ afterEach(() => {
9
+ if (previousValue === undefined) {
10
+ delete process.env[envKey];
11
+ } else {
12
+ process.env[envKey] = previousValue;
13
+ }
14
+ previousValue = undefined;
15
+ });
16
+
17
+ it('resolves environment placeholders in headers', () => {
18
+ previousValue = process.env[envKey];
19
+ process.env[envKey] = 'test-secret';
20
+ const headers = materializeHeaders({ Authorization: `Bearer \${HEADER_TOKEN}` }, 'inline');
21
+ expect(headers).toEqual({ Authorization: 'Bearer test-secret' });
22
+ });
23
+
24
+ it('propagates a helpful error when placeholder resolution fails', () => {
25
+ previousValue = process.env[envKey];
26
+ delete process.env[envKey];
27
+ expect(() => materializeHeaders({ Authorization: `Bearer \${HEADER_TOKEN}` }, 'broken')).toThrow(
28
+ /Failed to resolve header 'Authorization'/
29
+ );
30
+ });
31
+
32
+ it('returns undefined when no headers are provided', () => {
33
+ const headers = materializeHeaders(undefined, 'noop');
34
+ expect(headers).toBeUndefined();
35
+ });
36
+ });
@@ -0,0 +1,113 @@
1
+ import type { Server as HttpServer } from 'node:http';
2
+ import type { AddressInfo } from 'node:net';
3
+ import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
4
+ import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
5
+ import express from 'express';
6
+ import { afterAll, beforeAll, describe, expect, it } from 'vitest';
7
+ import { z } from 'zod';
8
+ import { createRuntime } from '../src/runtime.js';
9
+
10
+ const app = express();
11
+ app.use(express.json());
12
+ app.get('/mcp', (_req, res) => {
13
+ res.sendStatus(405);
14
+ });
15
+
16
+ const server = new McpServer({
17
+ name: 'integration-demo',
18
+ version: '1.0.0',
19
+ });
20
+
21
+ server.registerTool(
22
+ 'add',
23
+ {
24
+ title: 'Addition Tool',
25
+ description: 'Add two numbers',
26
+ inputSchema: { a: z.number(), b: z.number() },
27
+ outputSchema: { result: z.number() },
28
+ },
29
+ async ({ a, b }) => {
30
+ const result = { result: a + b };
31
+ return {
32
+ content: [{ type: 'text', text: JSON.stringify(result) }],
33
+ structuredContent: result,
34
+ };
35
+ }
36
+ );
37
+
38
+ server.registerResource(
39
+ 'greeting',
40
+ new ResourceTemplate('greeting://{name}', { list: undefined }),
41
+ {
42
+ title: 'Greeting',
43
+ description: 'Dynamic greeting resource',
44
+ },
45
+ async (uri, { name }) => {
46
+ const normalizedName = typeof name === 'string' ? name : Array.isArray(name) ? name.join(', ') : 'friend';
47
+
48
+ return {
49
+ contents: [
50
+ {
51
+ uri: uri.href,
52
+ text: `Hello, ${normalizedName}!`,
53
+ },
54
+ ],
55
+ };
56
+ }
57
+ );
58
+
59
+ app.post('/mcp', async (req, res) => {
60
+ const transport = new StreamableHTTPServerTransport({
61
+ sessionIdGenerator: undefined,
62
+ enableJsonResponse: true,
63
+ });
64
+
65
+ res.on('close', () => {
66
+ transport.close().catch(() => {});
67
+ });
68
+
69
+ await server.connect(transport);
70
+ await transport.handleRequest(req, res, req.body);
71
+ });
72
+
73
+ let httpServer: HttpServer;
74
+ let baseUrl: URL;
75
+
76
+ describe('runtime integration', () => {
77
+ beforeAll(async () => {
78
+ httpServer = app.listen(0, '127.0.0.1');
79
+ await new Promise<void>((resolve, reject) => {
80
+ httpServer.once('listening', resolve);
81
+ httpServer.once('error', reject);
82
+ });
83
+ const address = httpServer.address() as AddressInfo;
84
+ baseUrl = new URL(`http://127.0.0.1:${address.port}/mcp`);
85
+ });
86
+
87
+ afterAll(async () => {
88
+ await new Promise<void>((resolve) => httpServer.close(() => resolve()));
89
+ });
90
+
91
+ it('lists tools and calls a tool over HTTP', async () => {
92
+ const runtime = await createRuntime({
93
+ servers: [
94
+ {
95
+ name: 'integration',
96
+ description: 'Integration test server',
97
+ command: { kind: 'http', url: baseUrl },
98
+ },
99
+ ],
100
+ });
101
+
102
+ const tools = await runtime.listTools('integration');
103
+ expect(tools.some((tool) => tool.name === 'add')).toBe(true);
104
+
105
+ const result = (await runtime.callTool('integration', 'add', {
106
+ args: { a: 3, b: 4 },
107
+ })) as { structuredContent?: { result: number } };
108
+
109
+ expect(result.structuredContent?.result).toBe(7);
110
+
111
+ await runtime.close('integration');
112
+ });
113
+ });
@@ -0,0 +1,72 @@
1
+ import type { Client } from '@modelcontextprotocol/sdk/client';
2
+ import { UnauthorizedError } from '@modelcontextprotocol/sdk/client/auth.js';
3
+ import type { Transport, TransportSendOptions } from '@modelcontextprotocol/sdk/shared/transport.js';
4
+ import type { JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
5
+ import { describe, expect, it, vi } from 'vitest';
6
+ import type { Logger } from '../src/logging.js';
7
+ import type { OAuthSession } from '../src/oauth.js';
8
+ import { connectWithAuth } from '../src/runtime/oauth.js';
9
+
10
+ // Minimal mock transport that records finishAuth calls.
11
+ class MockTransport implements Transport {
12
+ public readonly calls: string[] = [];
13
+ constructor(private readonly finishAuthImpl?: (code: string) => Promise<void>) {}
14
+ async start(): Promise<void> {}
15
+ async send(_message: JSONRPCMessage, _options?: TransportSendOptions): Promise<void> {}
16
+ async close(): Promise<void> {}
17
+ async finishAuth(code: string): Promise<void> {
18
+ this.calls.push(code);
19
+ if (this.finishAuthImpl) {
20
+ await this.finishAuthImpl(code);
21
+ }
22
+ }
23
+ }
24
+
25
+ describe('connectWithAuth', () => {
26
+ it('waits for authorization code and retries connection', async () => {
27
+ // First connect throws Unauthorized, second succeeds after finishAuth.
28
+ const connect = vi
29
+ .fn()
30
+ .mockRejectedValueOnce(new UnauthorizedError('auth needed'))
31
+ .mockResolvedValueOnce(undefined);
32
+ const client = { connect } as unknown as Client;
33
+
34
+ let resolveCode: (code: string) => void = () => {};
35
+ const waitForAuthorizationCode = vi.fn(
36
+ () =>
37
+ new Promise<string>((resolve) => {
38
+ resolveCode = resolve;
39
+ })
40
+ );
41
+ const close = vi.fn(async () => {});
42
+ const session: OAuthSession = {
43
+ provider: { waitForAuthorizationCode } as unknown as OAuthSession['provider'],
44
+ waitForAuthorizationCode,
45
+ close,
46
+ };
47
+
48
+ const transport = new MockTransport();
49
+ const logger: Logger = {
50
+ info: vi.fn(),
51
+ warn: vi.fn(),
52
+ error: vi.fn(),
53
+ };
54
+
55
+ const promise = connectWithAuth(client, transport, session, logger, {
56
+ serverName: 'test-server',
57
+ maxAttempts: 1,
58
+ oauthTimeoutMs: 5000,
59
+ });
60
+
61
+ await new Promise((resolve) => setImmediate(resolve));
62
+
63
+ // Simulate browser callback arrival.
64
+ resolveCode('oauth-code-123');
65
+
66
+ await promise;
67
+
68
+ expect(waitForAuthorizationCode).toHaveBeenCalledTimes(1);
69
+ expect(transport.calls).toEqual(['oauth-code-123']);
70
+ expect(connect).toHaveBeenCalledTimes(2);
71
+ });
72
+ });
@@ -0,0 +1,72 @@
1
+ import { UnauthorizedError } from '@modelcontextprotocol/sdk/client/auth.js';
2
+ import { describe, expect, it, vi } from 'vitest';
3
+
4
+ import type { ServerDefinition } from '../src/config.js';
5
+ import { isUnauthorizedError, maybeEnableOAuth } from '../src/runtime-oauth-support.js';
6
+
7
+ const logger = {
8
+ info: vi.fn(),
9
+ warn: vi.fn(),
10
+ error: vi.fn(),
11
+ };
12
+
13
+ describe('maybeEnableOAuth', () => {
14
+ const baseDefinition: ServerDefinition = {
15
+ name: 'adhoc-server',
16
+ command: { kind: 'http', url: new URL('https://example.com/mcp') },
17
+ source: { kind: 'local', path: '<adhoc>' },
18
+ };
19
+
20
+ it('returns an updated definition for ad-hoc HTTP servers', () => {
21
+ const updated = maybeEnableOAuth(baseDefinition, logger as never);
22
+ expect(updated).toBeDefined();
23
+ expect(updated?.auth).toBe('oauth');
24
+ expect(updated?.tokenCacheDir).toBeUndefined();
25
+ expect(logger.info).toHaveBeenCalled();
26
+ });
27
+
28
+ it('enables OAuth for non-ad-hoc HTTP servers (issue #38)', () => {
29
+ const def: ServerDefinition = {
30
+ name: 'local-server',
31
+ command: { kind: 'http', url: new URL('https://example.com') },
32
+ source: { kind: 'local', path: '/tmp/config.json' },
33
+ };
34
+ const updated = maybeEnableOAuth(def, logger as never);
35
+ expect(updated).toBeDefined();
36
+ expect(updated?.auth).toBe('oauth');
37
+ });
38
+
39
+ it('does not mutate stdio servers', () => {
40
+ const def: ServerDefinition = {
41
+ name: 'stdio-server',
42
+ command: { kind: 'stdio', command: 'echo', args: [], cwd: process.cwd() },
43
+ };
44
+ const updated = maybeEnableOAuth(def, logger as never);
45
+ expect(updated).toBeUndefined();
46
+ });
47
+
48
+ it('does not re-promote servers already configured for oauth', () => {
49
+ const def: ServerDefinition = {
50
+ name: 'oauth-server',
51
+ auth: 'oauth',
52
+ command: { kind: 'http', url: new URL('https://example.com') },
53
+ };
54
+ const updated = maybeEnableOAuth(def, logger as never);
55
+ expect(updated).toBeUndefined();
56
+ });
57
+ });
58
+
59
+ describe('isUnauthorizedError helper', () => {
60
+ it('matches UnauthorizedError instances', () => {
61
+ const err = new UnauthorizedError('Unauthorized');
62
+ expect(isUnauthorizedError(err)).toBe(true);
63
+ });
64
+
65
+ it('matches generic errors with 401 codes', () => {
66
+ expect(isUnauthorizedError(new Error('SSE error: Non-200 status code (401)'))).toBe(true);
67
+ });
68
+
69
+ it('ignores unrelated errors', () => {
70
+ expect(isUnauthorizedError(new Error('network timeout'))).toBe(false);
71
+ });
72
+ });
@@ -0,0 +1,60 @@
1
+ import { afterEach, describe, expect, it, vi } from 'vitest';
2
+ import type { OAuthSession } from '../src/oauth.js';
3
+ import { OAuthTimeoutError, waitForAuthorizationCodeWithTimeout } from '../src/runtime/oauth.js';
4
+
5
+ describe('waitForAuthorizationCodeWithTimeout', () => {
6
+ afterEach(() => {
7
+ vi.useRealTimers();
8
+ });
9
+
10
+ it('rejects when the authorization code is not received before the timeout', async () => {
11
+ vi.useFakeTimers();
12
+ const session: OAuthSession = {
13
+ provider: {
14
+ waitForAuthorizationCode: vi.fn(),
15
+ } as unknown as OAuthSession['provider'],
16
+ waitForAuthorizationCode: vi.fn(() => new Promise<string>(() => {})),
17
+ close: vi.fn(async () => {}),
18
+ };
19
+ const logger = {
20
+ info: vi.fn(),
21
+ warn: vi.fn(),
22
+ error: vi.fn(),
23
+ };
24
+
25
+ const promise = waitForAuthorizationCodeWithTimeout(session, logger, 'fake', 1_000);
26
+ const expectation = expect(promise).rejects.toBeInstanceOf(OAuthTimeoutError);
27
+ await vi.advanceTimersByTimeAsync(1_000);
28
+ await expectation;
29
+ expect(logger.warn).toHaveBeenCalledWith(expect.stringContaining('timed out after 1s'));
30
+ });
31
+
32
+ it('resolves when the authorization code arrives before the timeout', async () => {
33
+ vi.useFakeTimers();
34
+ let resolveCode: ((value: string) => void) | undefined;
35
+ const session: OAuthSession = {
36
+ provider: {
37
+ waitForAuthorizationCode: vi.fn(),
38
+ } as unknown as OAuthSession['provider'],
39
+ waitForAuthorizationCode: vi.fn(
40
+ () =>
41
+ new Promise<string>((resolve) => {
42
+ resolveCode = resolve;
43
+ })
44
+ ),
45
+ close: vi.fn(async () => {}),
46
+ };
47
+ const logger = {
48
+ info: vi.fn(),
49
+ warn: vi.fn(),
50
+ error: vi.fn(),
51
+ };
52
+
53
+ const promise = waitForAuthorizationCodeWithTimeout(session, logger, 'fake', 1_000);
54
+ const expectation = expect(promise).resolves.toBe('abc123');
55
+ resolveCode?.('abc123');
56
+ await vi.advanceTimersByTimeAsync(0);
57
+ await expectation;
58
+ expect(logger.warn).not.toHaveBeenCalled();
59
+ });
60
+ });
@@ -0,0 +1,14 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { parseOAuthTimeout } from '../src/runtime/oauth.js';
3
+
4
+ describe('parseOAuthTimeout', () => {
5
+ it('falls back to default on missing or invalid values', () => {
6
+ expect(parseOAuthTimeout(undefined)).toBe(60_000);
7
+ expect(parseOAuthTimeout('not-a-number')).toBe(60_000);
8
+ expect(parseOAuthTimeout('-500')).toBe(60_000);
9
+ });
10
+
11
+ it('parses valid integer inputs', () => {
12
+ expect(parseOAuthTimeout('45000')).toBe(45_000);
13
+ });
14
+ });
@@ -0,0 +1,53 @@
1
+ import type { ChildProcess } from 'node:child_process';
2
+ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
3
+
4
+ const execFileMock = vi.fn();
5
+
6
+ vi.mock('node:child_process', async () => {
7
+ const actual = await vi.importActual<typeof import('node:child_process')>('node:child_process');
8
+ return {
9
+ ...actual,
10
+ execFile: execFileMock,
11
+ };
12
+ });
13
+
14
+ describe('runtime-process-utils Windows process tree', () => {
15
+ beforeEach(() => {
16
+ vi.resetModules();
17
+ execFileMock.mockReset();
18
+ vi.spyOn(process, 'platform', 'get').mockReturnValue('win32');
19
+ });
20
+
21
+ afterEach(() => {
22
+ vi.restoreAllMocks();
23
+ });
24
+
25
+ it('parses PowerShell output to enumerate descendants', async () => {
26
+ const { __testHooks } = await import('../src/runtime-process-utils.js');
27
+ const rootPid = process.pid;
28
+ const powershellOutput = JSON.stringify([
29
+ { ProcessId: rootPid + 1, ParentProcessId: rootPid },
30
+ { ProcessId: rootPid + 2, ParentProcessId: rootPid + 1 },
31
+ { ProcessId: rootPid + 3, ParentProcessId: 42 },
32
+ ]);
33
+
34
+ execFileMock.mockImplementation((command, _args, options, callback) => {
35
+ const cb = typeof options === 'function' ? options : callback;
36
+ if (command === 'powershell.exe') {
37
+ cb?.(null, powershellOutput, '');
38
+ } else {
39
+ cb?.(new Error('unexpected command'));
40
+ }
41
+ return { pid: 1 } as ChildProcess;
42
+ });
43
+
44
+ const descendants = await __testHooks.listDescendantPids(rootPid);
45
+ expect(descendants).toEqual([rootPid + 1, rootPid + 2]);
46
+ expect(execFileMock).toHaveBeenCalledWith(
47
+ 'powershell.exe',
48
+ expect.arrayContaining(['-NoProfile', '-Command', expect.stringContaining('Get-CimInstance')]),
49
+ expect.any(Object),
50
+ expect.any(Function)
51
+ );
52
+ });
53
+ });
@@ -0,0 +1,69 @@
1
+ import { afterEach, describe, expect, it, vi } from 'vitest';
2
+
3
+ import type { ServerDefinition } from '../src/config.js';
4
+ import { createClientContext } from '../src/runtime/transport.js';
5
+
6
+ const logger = {
7
+ info: vi.fn(),
8
+ warn: vi.fn(),
9
+ error: vi.fn(),
10
+ };
11
+
12
+ const clientInfo = { name: 'mcporter', version: '0.0.0-test' };
13
+
14
+ afterEach(() => {
15
+ vi.restoreAllMocks();
16
+ });
17
+
18
+ function stubHttpDefinition(url: string): ServerDefinition {
19
+ return {
20
+ name: 'http-server',
21
+ command: { kind: 'http', url: new URL(url) },
22
+ source: { kind: 'local', path: '<adhoc>' },
23
+ };
24
+ }
25
+
26
+ describe('createClientContext (HTTP)', () => {
27
+ it('falls back to SSE when primary connect fails', async () => {
28
+ const definition = stubHttpDefinition('https://example.com/mcp');
29
+ const { Client } = await import('@modelcontextprotocol/sdk/client/index.js');
30
+ const { SSEClientTransport } = await import('@modelcontextprotocol/sdk/client/sse.js');
31
+ const { StreamableHTTPClientTransport } = await import('@modelcontextprotocol/sdk/client/streamableHttp.js');
32
+
33
+ const clientConnect = vi
34
+ .spyOn(Client.prototype, 'connect')
35
+ .mockImplementationOnce(async (transport) => {
36
+ expect(transport).toBeInstanceOf(StreamableHTTPClientTransport);
37
+ throw new Error('network down');
38
+ })
39
+ .mockImplementationOnce(async (transport) => {
40
+ expect(transport).toBeInstanceOf(SSEClientTransport);
41
+ });
42
+
43
+ const context = await createClientContext(definition, logger, clientInfo, { maxOAuthAttempts: 0 });
44
+
45
+ expect(context.transport).toBeInstanceOf(SSEClientTransport);
46
+ expect(clientConnect).toHaveBeenCalledTimes(2);
47
+ });
48
+
49
+ it.skip('promotes ad-hoc HTTP servers to OAuth after unauthorized, then retries', async () => {
50
+ const fetchSpy = vi.spyOn(globalThis, 'fetch').mockImplementation(async () => {
51
+ return new Response(null, { status: 401, statusText: 'Unauthorized' });
52
+ });
53
+ const definition = stubHttpDefinition('https://example.com/secure');
54
+ const { Client } = await import('@modelcontextprotocol/sdk/client/index.js');
55
+
56
+ const clientConnect = vi
57
+ .spyOn(Client.prototype, 'connect')
58
+ .mockImplementationOnce(async () => {
59
+ throw new Error('SSE error: Non-200 status code (401)');
60
+ })
61
+ .mockImplementationOnce(async () => {});
62
+
63
+ const context = await createClientContext(definition, logger, clientInfo, { maxOAuthAttempts: 1 });
64
+
65
+ expect(context.definition.auth).toBe('oauth');
66
+ expect(clientConnect).toHaveBeenCalledTimes(2);
67
+ fetchSpy.mockRestore();
68
+ });
69
+ });
@@ -0,0 +1,31 @@
1
+ import { describe, expect, it, vi } from 'vitest';
2
+ import { normalizeTimeout, raceWithTimeout } from '../src/runtime/utils.js';
3
+
4
+ describe('normalizeTimeout', () => {
5
+ it('returns undefined for invalid inputs', () => {
6
+ expect(normalizeTimeout(undefined)).toBeUndefined();
7
+ expect(normalizeTimeout(Number.NaN)).toBeUndefined();
8
+ expect(normalizeTimeout(-10)).toBeUndefined();
9
+ expect(normalizeTimeout(0)).toBeUndefined();
10
+ });
11
+
12
+ it('returns a truncated positive integer', () => {
13
+ expect(normalizeTimeout(1500.9)).toBe(1500);
14
+ });
15
+ });
16
+
17
+ describe('raceWithTimeout', () => {
18
+ it('resolves when the promise settles before the timeout', async () => {
19
+ const promise = raceWithTimeout(Promise.resolve('ok'), 1_000);
20
+ await expect(promise).resolves.toBe('ok');
21
+ });
22
+
23
+ it('rejects with a timeout error when exceeding the deadline', async () => {
24
+ vi.useFakeTimers();
25
+ const promise = raceWithTimeout(new Promise<void>(() => {}), 500);
26
+ const expectation = expect(promise).rejects.toThrowError('Timeout');
27
+ vi.advanceTimersByTime(500);
28
+ await expectation;
29
+ vi.useRealTimers();
30
+ });
31
+ });
@@ -0,0 +1,94 @@
1
+ import os from 'node:os';
2
+ import path from 'node:path';
3
+ import { afterEach, beforeEach, describe, expect, it } from 'vitest';
4
+ import { loadServerDefinitions } from '../src/config.js';
5
+ import { resolveEnvPlaceholders, resolveEnvValue, withEnvOverrides } from '../src/env.js';
6
+ import { resolveCommandArgument } from '../src/runtime/utils.js';
7
+
8
+ const FIXTURE_PATH = path.resolve(__dirname, 'fixtures', 'mcporter.json');
9
+
10
+ describe('loadServerDefinitions', () => {
11
+ it('parses all Sweetistics servers', async () => {
12
+ const servers = await loadServerDefinitions({
13
+ configPath: FIXTURE_PATH,
14
+ rootDir: '/repo',
15
+ });
16
+ expect(servers).toHaveLength(9);
17
+ const names = servers.map((server) => server.name);
18
+ expect(names).toContain('vercel');
19
+ const signoz = servers.find((server) => server.name === 'signoz');
20
+ expect(signoz).toBeDefined();
21
+ expect(signoz?.command.kind).toBe('stdio');
22
+ expect(signoz?.env?.SIGNOZ_URL).toBe(`\${SIGNOZ_URL:-http://localhost:3301}`);
23
+ const vercel = servers.find((server) => server.name === 'vercel');
24
+ const normalizedCacheDir = vercel?.tokenCacheDir ? path.normalize(vercel.tokenCacheDir) : undefined;
25
+ expect(normalizedCacheDir).toBe(path.join(os.homedir(), '.mcporter', 'vercel'));
26
+ });
27
+
28
+ it('resolves HTTP headers with environment placeholders', async () => {
29
+ process.env.LINEAR_API_KEY = 'linear-secret';
30
+ const servers = await loadServerDefinitions({ configPath: FIXTURE_PATH });
31
+ const linear = servers.find((server) => server.name === 'linear');
32
+ expect(linear?.command.kind).toBe('http');
33
+ expect(linear?.command.kind === 'http' ? linear.command.headers?.Authorization : undefined).toBe(
34
+ `Bearer \${LINEAR_API_KEY}`
35
+ );
36
+ });
37
+ });
38
+
39
+ describe('environment utilities', () => {
40
+ const originalEnv = { ...process.env };
41
+
42
+ beforeEach(() => {
43
+ process.env = { ...originalEnv };
44
+ });
45
+
46
+ afterEach(() => {
47
+ process.env = { ...originalEnv };
48
+ });
49
+
50
+ it('resolveEnvValue respects default syntax', () => {
51
+ expect(resolveEnvValue(`\${MISSING_VAR:-fallback}`)).toBe('fallback');
52
+ process.env.MISSING_VAR = 'present';
53
+ expect(resolveEnvValue(`\${MISSING_VAR:-fallback}`)).toBe('present');
54
+ });
55
+
56
+ it('resolveEnvPlaceholders enforces presence', () => {
57
+ process.env.TEST_TOKEN = 'abc';
58
+ expect(resolveEnvPlaceholders(`Bearer \${TEST_TOKEN}`)).toBe('Bearer abc');
59
+ expect(() => resolveEnvPlaceholders(`Bearer \${NOT_SET}`)).toThrow();
60
+ });
61
+
62
+ it('withEnvOverrides applies temporary overrides', async () => {
63
+ delete process.env.SIGNOZ_URL;
64
+ await withEnvOverrides({ SIGNOZ_URL: `\${SIGNOZ_URL:-http://localhost:3301}` }, async () => {
65
+ expect(process.env.SIGNOZ_URL).toBe('http://localhost:3301');
66
+ });
67
+ expect(process.env.SIGNOZ_URL).toBeUndefined();
68
+ });
69
+ });
70
+
71
+ describe('command argument interpolation', () => {
72
+ const originalEnv = { ...process.env };
73
+
74
+ beforeEach(() => {
75
+ process.env = { ...originalEnv };
76
+ });
77
+
78
+ afterEach(() => {
79
+ process.env = { ...originalEnv };
80
+ });
81
+
82
+ it('resolves placeholder tokens', () => {
83
+ process.env.CHROME_DEVTOOLS_URL = 'http://127.0.0.1:5555';
84
+ const placeholder = String.raw`\${CHROME_DEVTOOLS_URL}`;
85
+ const result = resolveCommandArgument(`--browserUrl ${placeholder}`);
86
+ expect(result).toBe('--browserUrl http://127.0.0.1:5555');
87
+ });
88
+
89
+ it('passes through tokens without placeholders', () => {
90
+ const value = '--browserUrl';
91
+ const result = resolveCommandArgument(value);
92
+ expect(result).toBe(value);
93
+ });
94
+ });
@@ -0,0 +1,24 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { evaluateStdioLogPolicy, type StdioLogMode } from '../src/sdk-patches.js';
3
+
4
+ function evaluate(mode: StdioLogMode, hasStderr: boolean, exitCode: number | null) {
5
+ return evaluateStdioLogPolicy(mode, hasStderr, exitCode);
6
+ }
7
+
8
+ describe('sdk-patches STDIO log policy', () => {
9
+ it('prints logs in auto mode only when stderr exists and exit code is non-zero', () => {
10
+ expect(evaluate('auto', true, 1)).toBe(true);
11
+ expect(evaluate('auto', true, 0)).toBe(false);
12
+ expect(evaluate('auto', false, 1)).toBe(false);
13
+ });
14
+
15
+ it('always prints when mode is forced to always', () => {
16
+ expect(evaluate('always', true, 0)).toBe(true);
17
+ expect(evaluate('always', true, null)).toBe(true);
18
+ });
19
+
20
+ it('never prints when mode is silent', () => {
21
+ expect(evaluate('silent', true, 2)).toBe(false);
22
+ expect(evaluate('silent', true, null)).toBe(false);
23
+ });
24
+ });