@wootsup/yt-builder-mcp 1.0.1 → 1.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 (401) hide show
  1. package/README.md +18 -6
  2. package/bin/yt-builder-mcp.js +6 -0
  3. package/dist/auth.d.ts +119 -0
  4. package/dist/auth.d.ts.map +1 -0
  5. package/dist/auth.js +226 -0
  6. package/dist/auth.js.map +1 -0
  7. package/dist/client.d.ts +84 -0
  8. package/dist/client.d.ts.map +1 -0
  9. package/dist/client.js +151 -0
  10. package/dist/client.js.map +1 -0
  11. package/dist/clients/claude-code.d.ts +18 -0
  12. package/dist/clients/claude-code.d.ts.map +1 -0
  13. package/dist/clients/claude-code.js +53 -0
  14. package/dist/clients/claude-code.js.map +1 -0
  15. package/dist/clients/claude-desktop.d.ts +19 -0
  16. package/dist/clients/claude-desktop.d.ts.map +1 -0
  17. package/dist/clients/claude-desktop.js +56 -0
  18. package/dist/clients/claude-desktop.js.map +1 -0
  19. package/dist/clients/cline.d.ts +26 -0
  20. package/dist/clients/cline.d.ts.map +1 -0
  21. package/dist/clients/cline.js +80 -0
  22. package/dist/clients/cline.js.map +1 -0
  23. package/dist/clients/codex-cli.d.ts +42 -0
  24. package/dist/clients/codex-cli.d.ts.map +1 -0
  25. package/dist/clients/codex-cli.js +194 -0
  26. package/dist/clients/codex-cli.js.map +1 -0
  27. package/dist/clients/continue.d.ts +13 -0
  28. package/dist/clients/continue.d.ts.map +1 -0
  29. package/dist/clients/continue.js +52 -0
  30. package/dist/clients/continue.js.map +1 -0
  31. package/dist/clients/cursor.d.ts +12 -0
  32. package/dist/clients/cursor.d.ts.map +1 -0
  33. package/dist/clients/cursor.js +38 -0
  34. package/dist/clients/cursor.js.map +1 -0
  35. package/dist/clients/gemini-cli.d.ts +18 -0
  36. package/dist/clients/gemini-cli.d.ts.map +1 -0
  37. package/dist/clients/gemini-cli.js +44 -0
  38. package/dist/clients/gemini-cli.js.map +1 -0
  39. package/dist/clients/home.d.ts +14 -0
  40. package/dist/clients/home.d.ts.map +1 -0
  41. package/dist/clients/home.js +20 -0
  42. package/dist/clients/home.js.map +1 -0
  43. package/dist/clients/index.d.ts +52 -0
  44. package/dist/clients/index.d.ts.map +1 -0
  45. package/dist/clients/index.js +72 -0
  46. package/dist/clients/index.js.map +1 -0
  47. package/dist/clients/roo-code.d.ts +23 -0
  48. package/dist/clients/roo-code.d.ts.map +1 -0
  49. package/dist/clients/roo-code.js +69 -0
  50. package/dist/clients/roo-code.js.map +1 -0
  51. package/dist/clients/zed.d.ts +12 -0
  52. package/dist/clients/zed.d.ts.map +1 -0
  53. package/dist/clients/zed.js +41 -0
  54. package/dist/clients/zed.js.map +1 -0
  55. package/dist/errors/hints.d.ts +51 -0
  56. package/dist/errors/hints.d.ts.map +1 -0
  57. package/dist/errors/hints.js +95 -0
  58. package/dist/errors/hints.js.map +1 -0
  59. package/dist/errors/mask.d.ts +35 -0
  60. package/dist/errors/mask.d.ts.map +1 -0
  61. package/dist/errors/mask.js +49 -0
  62. package/dist/errors/mask.js.map +1 -0
  63. package/dist/errors/sanitize.d.ts +31 -0
  64. package/dist/errors/sanitize.d.ts.map +1 -0
  65. package/dist/errors/sanitize.js +100 -0
  66. package/dist/errors/sanitize.js.map +1 -0
  67. package/dist/errors.d.ts +42 -0
  68. package/dist/errors.d.ts.map +1 -0
  69. package/dist/errors.js +61 -0
  70. package/dist/errors.js.map +1 -0
  71. package/dist/gateway/advanced-tool/discovery.d.ts +19 -0
  72. package/dist/gateway/advanced-tool/discovery.d.ts.map +1 -0
  73. package/dist/gateway/advanced-tool/discovery.js +53 -0
  74. package/dist/gateway/advanced-tool/discovery.js.map +1 -0
  75. package/dist/gateway/advanced-tool/domains.d.ts +47 -0
  76. package/dist/gateway/advanced-tool/domains.d.ts.map +1 -0
  77. package/dist/gateway/advanced-tool/domains.js +94 -0
  78. package/dist/gateway/advanced-tool/domains.js.map +1 -0
  79. package/dist/gateway/advanced-tool/execute.d.ts +29 -0
  80. package/dist/gateway/advanced-tool/execute.d.ts.map +1 -0
  81. package/dist/gateway/advanced-tool/execute.js +54 -0
  82. package/dist/gateway/advanced-tool/execute.js.map +1 -0
  83. package/dist/gateway/advanced-tool/index.d.ts +36 -0
  84. package/dist/gateway/advanced-tool/index.d.ts.map +1 -0
  85. package/dist/gateway/advanced-tool/index.js +39 -0
  86. package/dist/gateway/advanced-tool/index.js.map +1 -0
  87. package/dist/gateway/advanced-tool/register.d.ts +18 -0
  88. package/dist/gateway/advanced-tool/register.d.ts.map +1 -0
  89. package/dist/gateway/advanced-tool/register.js +69 -0
  90. package/dist/gateway/advanced-tool/register.js.map +1 -0
  91. package/dist/gateway/advanced-tool.d.ts +13 -0
  92. package/dist/gateway/advanced-tool.d.ts.map +1 -0
  93. package/dist/gateway/advanced-tool.js +13 -0
  94. package/dist/gateway/advanced-tool.js.map +1 -0
  95. package/dist/gateway/capturing-server.d.ts +117 -0
  96. package/dist/gateway/capturing-server.d.ts.map +1 -0
  97. package/dist/gateway/capturing-server.js +103 -0
  98. package/dist/gateway/capturing-server.js.map +1 -0
  99. package/dist/gateway/essentials.d.ts +49 -0
  100. package/dist/gateway/essentials.d.ts.map +1 -0
  101. package/dist/gateway/essentials.js +92 -0
  102. package/dist/gateway/essentials.js.map +1 -0
  103. package/dist/gateway/test-support.d.ts +41 -0
  104. package/dist/gateway/test-support.d.ts.map +1 -0
  105. package/dist/gateway/test-support.js +60 -0
  106. package/dist/gateway/test-support.js.map +1 -0
  107. package/dist/index.d.ts +29 -0
  108. package/dist/index.d.ts.map +1 -0
  109. package/dist/index.js +113 -0
  110. package/dist/index.js.map +1 -0
  111. package/dist/install-skill.d.ts +43 -0
  112. package/dist/install-skill.d.ts.map +1 -0
  113. package/dist/install-skill.js +118 -0
  114. package/dist/install-skill.js.map +1 -0
  115. package/dist/platform/detect.d.ts +64 -0
  116. package/dist/platform/detect.d.ts.map +1 -0
  117. package/dist/platform/detect.js +98 -0
  118. package/dist/platform/detect.js.map +1 -0
  119. package/dist/platform/index.d.ts +121 -0
  120. package/dist/platform/index.d.ts.map +1 -0
  121. package/dist/platform/index.js +176 -0
  122. package/dist/platform/index.js.map +1 -0
  123. package/dist/platform/joomla.d.ts +44 -0
  124. package/dist/platform/joomla.d.ts.map +1 -0
  125. package/dist/platform/joomla.js +46 -0
  126. package/dist/platform/joomla.js.map +1 -0
  127. package/dist/server.d.ts +109 -0
  128. package/dist/server.d.ts.map +1 -0
  129. package/dist/server.js +237 -0
  130. package/dist/server.js.map +1 -0
  131. package/dist/setup-cli-confirm.d.ts +36 -0
  132. package/dist/setup-cli-confirm.d.ts.map +1 -0
  133. package/dist/setup-cli-confirm.js +59 -0
  134. package/dist/setup-cli-confirm.js.map +1 -0
  135. package/dist/setup-cli.d.ts +152 -0
  136. package/dist/setup-cli.d.ts.map +1 -0
  137. package/dist/setup-cli.js +870 -0
  138. package/dist/setup-cli.js.map +1 -0
  139. package/dist/setup-prompts.d.ts +41 -0
  140. package/dist/setup-prompts.d.ts.map +1 -0
  141. package/dist/setup-prompts.js +146 -0
  142. package/dist/setup-prompts.js.map +1 -0
  143. package/dist/setup-token.d.ts +38 -0
  144. package/dist/setup-token.d.ts.map +1 -0
  145. package/dist/setup-token.js +106 -0
  146. package/dist/setup-token.js.map +1 -0
  147. package/dist/setup-wizard-defaults.d.ts +43 -0
  148. package/dist/setup-wizard-defaults.d.ts.map +1 -0
  149. package/dist/setup-wizard-defaults.js +160 -0
  150. package/dist/setup-wizard-defaults.js.map +1 -0
  151. package/dist/setup-wizard-handshake.d.ts +25 -0
  152. package/dist/setup-wizard-handshake.d.ts.map +1 -0
  153. package/dist/setup-wizard-handshake.js +103 -0
  154. package/dist/setup-wizard-handshake.js.map +1 -0
  155. package/dist/setup-wizard-types.d.ts +164 -0
  156. package/dist/setup-wizard-types.d.ts.map +1 -0
  157. package/dist/setup-wizard-types.js +11 -0
  158. package/dist/setup-wizard-types.js.map +1 -0
  159. package/dist/setup-wizard.d.ts +33 -0
  160. package/dist/setup-wizard.d.ts.map +1 -0
  161. package/dist/setup-wizard.js +199 -0
  162. package/dist/setup-wizard.js.map +1 -0
  163. package/dist/setup.d.ts +17 -0
  164. package/dist/setup.d.ts.map +1 -0
  165. package/dist/setup.js +33 -0
  166. package/dist/setup.js.map +1 -0
  167. package/dist/sites/cli/add-site.d.ts +106 -0
  168. package/dist/sites/cli/add-site.d.ts.map +1 -0
  169. package/dist/sites/cli/add-site.js +185 -0
  170. package/dist/sites/cli/add-site.js.map +1 -0
  171. package/dist/sites/cli/list-sites.d.ts +40 -0
  172. package/dist/sites/cli/list-sites.d.ts.map +1 -0
  173. package/dist/sites/cli/list-sites.js +117 -0
  174. package/dist/sites/cli/list-sites.js.map +1 -0
  175. package/dist/sites/cli/remove-site.d.ts +60 -0
  176. package/dist/sites/cli/remove-site.d.ts.map +1 -0
  177. package/dist/sites/cli/remove-site.js +120 -0
  178. package/dist/sites/cli/remove-site.js.map +1 -0
  179. package/dist/sites/cli/set-default.d.ts +47 -0
  180. package/dist/sites/cli/set-default.d.ts.map +1 -0
  181. package/dist/sites/cli/set-default.js +69 -0
  182. package/dist/sites/cli/set-default.js.map +1 -0
  183. package/dist/sites/cli/test-site.d.ts +77 -0
  184. package/dist/sites/cli/test-site.d.ts.map +1 -0
  185. package/dist/sites/cli/test-site.js +146 -0
  186. package/dist/sites/cli/test-site.js.map +1 -0
  187. package/dist/sites/client-pool.d.ts +124 -0
  188. package/dist/sites/client-pool.d.ts.map +1 -0
  189. package/dist/sites/client-pool.js +172 -0
  190. package/dist/sites/client-pool.js.map +1 -0
  191. package/dist/sites/env-bridge.d.ts +55 -0
  192. package/dist/sites/env-bridge.d.ts.map +1 -0
  193. package/dist/sites/env-bridge.js +94 -0
  194. package/dist/sites/env-bridge.js.map +1 -0
  195. package/dist/sites/paths.d.ts +21 -0
  196. package/dist/sites/paths.d.ts.map +1 -0
  197. package/dist/sites/paths.js +37 -0
  198. package/dist/sites/paths.js.map +1 -0
  199. package/dist/sites/probe.d.ts +60 -0
  200. package/dist/sites/probe.d.ts.map +1 -0
  201. package/dist/sites/probe.js +112 -0
  202. package/dist/sites/probe.js.map +1 -0
  203. package/dist/sites/registry.d.ts +142 -0
  204. package/dist/sites/registry.d.ts.map +1 -0
  205. package/dist/sites/registry.js +163 -0
  206. package/dist/sites/registry.js.map +1 -0
  207. package/dist/sites/schema.d.ts +90 -0
  208. package/dist/sites/schema.d.ts.map +1 -0
  209. package/dist/sites/schema.js +71 -0
  210. package/dist/sites/schema.js.map +1 -0
  211. package/dist/sites/secret-resolver.d.ts +109 -0
  212. package/dist/sites/secret-resolver.d.ts.map +1 -0
  213. package/dist/sites/secret-resolver.js +189 -0
  214. package/dist/sites/secret-resolver.js.map +1 -0
  215. package/dist/sites/store.d.ts +82 -0
  216. package/dist/sites/store.d.ts.map +1 -0
  217. package/dist/sites/store.js +198 -0
  218. package/dist/sites/store.js.map +1 -0
  219. package/dist/sites/tools/index.d.ts +28 -0
  220. package/dist/sites/tools/index.d.ts.map +1 -0
  221. package/dist/sites/tools/index.js +30 -0
  222. package/dist/sites/tools/index.js.map +1 -0
  223. package/dist/sites/tools/sites-list.d.ts +48 -0
  224. package/dist/sites/tools/sites-list.d.ts.map +1 -0
  225. package/dist/sites/tools/sites-list.js +135 -0
  226. package/dist/sites/tools/sites-list.js.map +1 -0
  227. package/dist/sites/tools/sites-test.d.ts +47 -0
  228. package/dist/sites/tools/sites-test.d.ts.map +1 -0
  229. package/dist/sites/tools/sites-test.js +148 -0
  230. package/dist/sites/tools/sites-test.js.map +1 -0
  231. package/dist/skill-loader.d.ts +111 -0
  232. package/dist/skill-loader.d.ts.map +1 -0
  233. package/dist/skill-loader.js +191 -0
  234. package/dist/skill-loader.js.map +1 -0
  235. package/dist/tools/elements/builders.d.ts +24 -0
  236. package/dist/tools/elements/builders.d.ts.map +1 -0
  237. package/dist/tools/elements/builders.js +199 -0
  238. package/dist/tools/elements/builders.js.map +1 -0
  239. package/dist/tools/elements/handlers-write.d.ts +49 -0
  240. package/dist/tools/elements/handlers-write.d.ts.map +1 -0
  241. package/dist/tools/elements/handlers-write.js +148 -0
  242. package/dist/tools/elements/handlers-write.js.map +1 -0
  243. package/dist/tools/elements/handlers.d.ts +68 -0
  244. package/dist/tools/elements/handlers.d.ts.map +1 -0
  245. package/dist/tools/elements/handlers.js +206 -0
  246. package/dist/tools/elements/handlers.js.map +1 -0
  247. package/dist/tools/elements/index.d.ts +28 -0
  248. package/dist/tools/elements/index.d.ts.map +1 -0
  249. package/dist/tools/elements/index.js +27 -0
  250. package/dist/tools/elements/index.js.map +1 -0
  251. package/dist/tools/elements.d.ts +13 -0
  252. package/dist/tools/elements.d.ts.map +1 -0
  253. package/dist/tools/elements.js +13 -0
  254. package/dist/tools/elements.js.map +1 -0
  255. package/dist/tools/elicitation.d.ts +87 -0
  256. package/dist/tools/elicitation.d.ts.map +1 -0
  257. package/dist/tools/elicitation.js +100 -0
  258. package/dist/tools/elicitation.js.map +1 -0
  259. package/dist/tools/format/elements-format.d.ts +40 -0
  260. package/dist/tools/format/elements-format.d.ts.map +1 -0
  261. package/dist/tools/format/elements-format.js +194 -0
  262. package/dist/tools/format/elements-format.js.map +1 -0
  263. package/dist/tools/format/health-format.d.ts +79 -0
  264. package/dist/tools/format/health-format.d.ts.map +1 -0
  265. package/dist/tools/format/health-format.js +181 -0
  266. package/dist/tools/format/health-format.js.map +1 -0
  267. package/dist/tools/format/inspection-format.d.ts +58 -0
  268. package/dist/tools/format/inspection-format.d.ts.map +1 -0
  269. package/dist/tools/format/inspection-format.js +164 -0
  270. package/dist/tools/format/inspection-format.js.map +1 -0
  271. package/dist/tools/format/pages-format.d.ts +48 -0
  272. package/dist/tools/format/pages-format.d.ts.map +1 -0
  273. package/dist/tools/format/pages-format.js +137 -0
  274. package/dist/tools/format/pages-format.js.map +1 -0
  275. package/dist/tools/format/sources-format.d.ts +25 -0
  276. package/dist/tools/format/sources-format.d.ts.map +1 -0
  277. package/dist/tools/format/sources-format.js +208 -0
  278. package/dist/tools/format/sources-format.js.map +1 -0
  279. package/dist/tools/health.d.ts +22 -0
  280. package/dist/tools/health.d.ts.map +1 -0
  281. package/dist/tools/health.js +220 -0
  282. package/dist/tools/health.js.map +1 -0
  283. package/dist/tools/index.d.ts +30 -0
  284. package/dist/tools/index.d.ts.map +1 -0
  285. package/dist/tools/index.js +39 -0
  286. package/dist/tools/index.js.map +1 -0
  287. package/dist/tools/inspection.d.ts +14 -0
  288. package/dist/tools/inspection.d.ts.map +1 -0
  289. package/dist/tools/inspection.js +170 -0
  290. package/dist/tools/inspection.js.map +1 -0
  291. package/dist/tools/layout-flatten.d.ts +75 -0
  292. package/dist/tools/layout-flatten.d.ts.map +1 -0
  293. package/dist/tools/layout-flatten.js +107 -0
  294. package/dist/tools/layout-flatten.js.map +1 -0
  295. package/dist/tools/multi-items/builders.d.ts +23 -0
  296. package/dist/tools/multi-items/builders.d.ts.map +1 -0
  297. package/dist/tools/multi-items/builders.js +69 -0
  298. package/dist/tools/multi-items/builders.js.map +1 -0
  299. package/dist/tools/multi-items/clean-implode-handler.d.ts +28 -0
  300. package/dist/tools/multi-items/clean-implode-handler.d.ts.map +1 -0
  301. package/dist/tools/multi-items/clean-implode-handler.js +40 -0
  302. package/dist/tools/multi-items/clean-implode-handler.js.map +1 -0
  303. package/dist/tools/multi-items/index.d.ts +18 -0
  304. package/dist/tools/multi-items/index.d.ts.map +1 -0
  305. package/dist/tools/multi-items/index.js +18 -0
  306. package/dist/tools/multi-items/index.js.map +1 -0
  307. package/dist/tools/multi-items/inspect-handler.d.ts +41 -0
  308. package/dist/tools/multi-items/inspect-handler.d.ts.map +1 -0
  309. package/dist/tools/multi-items/inspect-handler.js +50 -0
  310. package/dist/tools/multi-items/inspect-handler.js.map +1 -0
  311. package/dist/tools/multi-items/item-container-map.d.ts +41 -0
  312. package/dist/tools/multi-items/item-container-map.d.ts.map +1 -0
  313. package/dist/tools/multi-items/item-container-map.js +73 -0
  314. package/dist/tools/multi-items/item-container-map.js.map +1 -0
  315. package/dist/tools/pages/builders.d.ts +14 -0
  316. package/dist/tools/pages/builders.d.ts.map +1 -0
  317. package/dist/tools/pages/builders.js +127 -0
  318. package/dist/tools/pages/builders.js.map +1 -0
  319. package/dist/tools/pages/handlers-read.d.ts +33 -0
  320. package/dist/tools/pages/handlers-read.d.ts.map +1 -0
  321. package/dist/tools/pages/handlers-read.js +171 -0
  322. package/dist/tools/pages/handlers-read.js.map +1 -0
  323. package/dist/tools/pages/handlers-write.d.ts +21 -0
  324. package/dist/tools/pages/handlers-write.d.ts.map +1 -0
  325. package/dist/tools/pages/handlers-write.js +52 -0
  326. package/dist/tools/pages/handlers-write.js.map +1 -0
  327. package/dist/tools/pages/index.d.ts +17 -0
  328. package/dist/tools/pages/index.d.ts.map +1 -0
  329. package/dist/tools/pages/index.js +17 -0
  330. package/dist/tools/pages/index.js.map +1 -0
  331. package/dist/tools/pages/schemas.d.ts +30 -0
  332. package/dist/tools/pages/schemas.d.ts.map +1 -0
  333. package/dist/tools/pages/schemas.js +48 -0
  334. package/dist/tools/pages/schemas.js.map +1 -0
  335. package/dist/tools/pages.d.ts +13 -0
  336. package/dist/tools/pages.d.ts.map +1 -0
  337. package/dist/tools/pages.js +13 -0
  338. package/dist/tools/pages.js.map +1 -0
  339. package/dist/tools/pool-resolve-helper.d.ts +83 -0
  340. package/dist/tools/pool-resolve-helper.d.ts.map +1 -0
  341. package/dist/tools/pool-resolve-helper.js +148 -0
  342. package/dist/tools/pool-resolve-helper.js.map +1 -0
  343. package/dist/tools/progress-phases.d.ts +46 -0
  344. package/dist/tools/progress-phases.d.ts.map +1 -0
  345. package/dist/tools/progress-phases.js +48 -0
  346. package/dist/tools/progress-phases.js.map +1 -0
  347. package/dist/tools/shared-schemas.d.ts +25 -0
  348. package/dist/tools/shared-schemas.d.ts.map +1 -0
  349. package/dist/tools/shared-schemas.js +48 -0
  350. package/dist/tools/shared-schemas.js.map +1 -0
  351. package/dist/tools/sources/builders.d.ts +13 -0
  352. package/dist/tools/sources/builders.d.ts.map +1 -0
  353. package/dist/tools/sources/builders.js +115 -0
  354. package/dist/tools/sources/builders.js.map +1 -0
  355. package/dist/tools/sources/handlers-bind.d.ts +28 -0
  356. package/dist/tools/sources/handlers-bind.d.ts.map +1 -0
  357. package/dist/tools/sources/handlers-bind.js +129 -0
  358. package/dist/tools/sources/handlers-bind.js.map +1 -0
  359. package/dist/tools/sources/handlers.d.ts +45 -0
  360. package/dist/tools/sources/handlers.d.ts.map +1 -0
  361. package/dist/tools/sources/handlers.js +91 -0
  362. package/dist/tools/sources/handlers.js.map +1 -0
  363. package/dist/tools/sources/index.d.ts +19 -0
  364. package/dist/tools/sources/index.d.ts.map +1 -0
  365. package/dist/tools/sources/index.js +18 -0
  366. package/dist/tools/sources/index.js.map +1 -0
  367. package/dist/tools/sources.d.ts +14 -0
  368. package/dist/tools/sources.d.ts.map +1 -0
  369. package/dist/tools/sources.js +14 -0
  370. package/dist/tools/sources.js.map +1 -0
  371. package/dist/tools/sparse-fields.d.ts +80 -0
  372. package/dist/tools/sparse-fields.d.ts.map +1 -0
  373. package/dist/tools/sparse-fields.js +144 -0
  374. package/dist/tools/sparse-fields.js.map +1 -0
  375. package/dist/tools/tool-builder/annotations.d.ts +55 -0
  376. package/dist/tools/tool-builder/annotations.d.ts.map +1 -0
  377. package/dist/tools/tool-builder/annotations.js +86 -0
  378. package/dist/tools/tool-builder/annotations.js.map +1 -0
  379. package/dist/tools/tool-builder/define.d.ts +31 -0
  380. package/dist/tools/tool-builder/define.d.ts.map +1 -0
  381. package/dist/tools/tool-builder/define.js +31 -0
  382. package/dist/tools/tool-builder/define.js.map +1 -0
  383. package/dist/tools/tool-builder/index.d.ts +28 -0
  384. package/dist/tools/tool-builder/index.d.ts.map +1 -0
  385. package/dist/tools/tool-builder/index.js +27 -0
  386. package/dist/tools/tool-builder/index.js.map +1 -0
  387. package/dist/tools/tool-builder/results.d.ts +93 -0
  388. package/dist/tools/tool-builder/results.d.ts.map +1 -0
  389. package/dist/tools/tool-builder/results.js +211 -0
  390. package/dist/tools/tool-builder/results.js.map +1 -0
  391. package/dist/tools/tool-builder/types.d.ts +82 -0
  392. package/dist/tools/tool-builder/types.d.ts.map +1 -0
  393. package/dist/tools/tool-builder/types.js +9 -0
  394. package/dist/tools/tool-builder/types.js.map +1 -0
  395. package/dist/tools/tool-builder.d.ts +16 -0
  396. package/dist/tools/tool-builder.d.ts.map +1 -0
  397. package/dist/tools/tool-builder.js +16 -0
  398. package/dist/tools/tool-builder.js.map +1 -0
  399. package/manifest.json +27 -10
  400. package/package.json +3 -1
  401. package/skills/yt-builder-mcp/SKILL.md +397 -138
@@ -0,0 +1,117 @@
1
+ /**
2
+ * CapturingServer — registration interceptor wrapping a real McpServer.
3
+ *
4
+ * Tool routing (Wave G.1 / Design-Doc §3.1.1):
5
+ * - L3 direct (yootheme_builder_health, yootheme_builder_diagnose):
6
+ * skipped — no forward, no capture. These tools must already be
7
+ * registered directly on the real server BEFORE the CapturingServer
8
+ * wraps it, so the SDK never sees a duplicate name.
9
+ * - L1 essential (ESSENTIAL_TOOLS): forwarded to the real server as a
10
+ * first-class MCP tool reachable from `tools/list`.
11
+ * - L2 advanced (everything else): captured into the in-process
12
+ * advanced registry, reachable through the single
13
+ * `yootheme_builder_advanced` gateway tool.
14
+ *
15
+ * This is a typed wrapper, NOT a JS Proxy — TypeScript stays strict.
16
+ *
17
+ * Typing approach (mirrors the reference apimapper-mcp implementation):
18
+ * `ToolRegistrar` is the McpServer subsurface modules consume:
19
+ * `registerTool` + `registerResource`. `registerTool` is a hand-written
20
+ * generic mirroring the SDK signature EXCEPT its return type is `void`
21
+ * — captured tools have no live `RegisteredTool`, and no module reads
22
+ * the return value. A real `McpServer` is still assignable to
23
+ * `ToolRegistrar` (return-type bivariance for `void`), so every
24
+ * call-site accepts both shapes cast-free.
25
+ *
26
+ * Casts in this file (each documented + justified inline):
27
+ * 1. forwarded-essential — erases the handler's `InputArgs` generic to
28
+ * the SDK default when `config` is the erased `CapturedToolConfig`.
29
+ * 2. registry storage — erases the generic handler to the homogeneous
30
+ * `CapturedToolHandler` shape so one Map type fits all entries.
31
+ * 3. `registerResource` field — the SDK declares two overloads; a
32
+ * single spread-arg arrow cannot re-express the pair.
33
+ *
34
+ * @license MIT
35
+ */
36
+ import type { McpServer, ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
37
+ import type { AnySchema, ZodRawShapeCompat } from '@modelcontextprotocol/sdk/server/zod-compat.js';
38
+ import type { CallToolResult, ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
39
+ /**
40
+ * The input-schema constraint the SDK's `registerTool` accepts — a raw Zod
41
+ * shape, a Zod schema, or `undefined` (zero-arg tools). Reused so the
42
+ * `ToolRegistrar.registerTool` generic stays in lockstep with `ToolCallback`.
43
+ */
44
+ type ToolInputArgs = undefined | ZodRawShapeCompat | AnySchema;
45
+ /**
46
+ * The config object accepted by `registerTool` — mirrors the SDK's 2nd arg.
47
+ * `inputSchema` is generic so per-tool handler args stay strongly inferred.
48
+ */
49
+ interface RegisterToolConfig<InputArgs extends ToolInputArgs> {
50
+ title?: string;
51
+ description?: string;
52
+ inputSchema?: InputArgs;
53
+ outputSchema?: ZodRawShapeCompat | AnySchema;
54
+ annotations?: ToolAnnotations;
55
+ _meta?: Record<string, unknown>;
56
+ }
57
+ /**
58
+ * The McpServer subsurface our `registerXTools` builders consume.
59
+ *
60
+ * `registerTool` is a hand-written generic mirroring the SDK signature with a
61
+ * `void` return type. A real `McpServer` (whose method returns
62
+ * `RegisteredTool`) is still assignable here because a value-returning method
63
+ * satisfies a `void`-returning member. The `InputArgs` generic preserves
64
+ * per-tool `ToolCallback` argument inference at every call-site.
65
+ */
66
+ export interface ToolRegistrar {
67
+ registerTool<InputArgs extends ToolInputArgs = undefined>(name: string, config: RegisterToolConfig<InputArgs>, cb: ToolCallback<InputArgs>): void;
68
+ registerResource: McpServer['registerResource'];
69
+ }
70
+ /** Config object passed to `registerTool` (the SDK's 2nd arg). */
71
+ export type CapturedToolConfig = Parameters<McpServer['registerTool']>[1];
72
+ /**
73
+ * Captured-handler shape. The SDK's `registerTool` is generic over the input
74
+ * shape, so a captured handler is stored with its args erased to
75
+ * `Record<string, unknown>`. The gateway validates `arguments` against the
76
+ * tool's Zod schema before calling the handler, so the runtime contract holds.
77
+ */
78
+ export type CapturedToolHandler = (args: Record<string, unknown>, extra: unknown) => CallToolResult | Promise<CallToolResult>;
79
+ /** A captured advanced tool: its registration config and its handler. */
80
+ export interface AdvancedToolEntry {
81
+ config: CapturedToolConfig;
82
+ handler: CapturedToolHandler;
83
+ }
84
+ /**
85
+ * Wraps a real McpServer. Forwards L1 essentials (and all resources) to it,
86
+ * captures L2 non-essentials into an in-process registry, and silently
87
+ * skips L3 direct top-level names that must already be on the real server.
88
+ */
89
+ export declare class CapturingServer implements ToolRegistrar {
90
+ private readonly realServer;
91
+ private readonly advancedRegistry;
92
+ constructor(realServer: McpServer);
93
+ /**
94
+ * Routes a tool registration by name. Returns `void`: captured tools
95
+ * have no `RegisteredTool` and no `registerXTools` module reads the
96
+ * return value.
97
+ *
98
+ * Routing order matters: the L3-direct check is FIRST so a caller
99
+ * cannot accidentally re-route a direct-registered name through the
100
+ * gateway just by re-naming a future tool builder.
101
+ */
102
+ registerTool<InputArgs extends ToolInputArgs = undefined>(name: string, config: CapturedToolConfig, handler: ToolCallback<InputArgs>): void;
103
+ /**
104
+ * Resources are always forwarded — they are not part of the tool cap.
105
+ *
106
+ * Cast: the SDK declares `registerResource` as two overloads; a single
107
+ * spread `(...args: RegisterResourceArgs)` arrow cannot re-express that
108
+ * overload pair, so the field is asserted to the SDK's exact member
109
+ * type. The spread forwards every argument verbatim, so the runtime
110
+ * contract is unchanged.
111
+ */
112
+ registerResource: McpServer['registerResource'];
113
+ /** The captured non-essential tools, keyed by tool name. */
114
+ getAdvancedRegistry(): Map<string, AdvancedToolEntry>;
115
+ }
116
+ export {};
117
+ //# sourceMappingURL=capturing-server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capturing-server.d.ts","sourceRoot":"","sources":["../../src/gateway/capturing-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnG,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAI1F;;;;GAIG;AACH,KAAK,aAAa,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAE/D;;;GAGG;AACH,UAAU,kBAAkB,CAAC,SAAS,SAAS,aAAa;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,YAAY,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC7C,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC1B,YAAY,CAAC,SAAS,SAAS,aAAa,GAAG,SAAS,EACpD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,kBAAkB,CAAC,SAAS,CAAC,EACrC,EAAE,EAAE,YAAY,CAAC,SAAS,CAAC,GAC5B,IAAI,CAAC;IACR,gBAAgB,EAAE,SAAS,CAAC,kBAAkB,CAAC,CAAC;CACnD;AAED,kEAAkE;AAClE,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAI1E;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,OAAO,KACb,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAE9C,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,mBAAmB,CAAC;CAChC;AAED;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,aAAa;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAwC;gBAE7D,UAAU,EAAE,SAAS;IAIjC;;;;;;;;OAQG;IACH,YAAY,CAAC,SAAS,SAAS,aAAa,GAAG,SAAS,EACpD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,GACjC,IAAI;IAkCP;;;;;;;;OAQG;IACH,gBAAgB,EAAE,SAAS,CAAC,kBAAkB,CAAC,CACiC;IAEhF,4DAA4D;IAC5D,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC;CAGxD"}
@@ -0,0 +1,103 @@
1
+ /**
2
+ * CapturingServer — registration interceptor wrapping a real McpServer.
3
+ *
4
+ * Tool routing (Wave G.1 / Design-Doc §3.1.1):
5
+ * - L3 direct (yootheme_builder_health, yootheme_builder_diagnose):
6
+ * skipped — no forward, no capture. These tools must already be
7
+ * registered directly on the real server BEFORE the CapturingServer
8
+ * wraps it, so the SDK never sees a duplicate name.
9
+ * - L1 essential (ESSENTIAL_TOOLS): forwarded to the real server as a
10
+ * first-class MCP tool reachable from `tools/list`.
11
+ * - L2 advanced (everything else): captured into the in-process
12
+ * advanced registry, reachable through the single
13
+ * `yootheme_builder_advanced` gateway tool.
14
+ *
15
+ * This is a typed wrapper, NOT a JS Proxy — TypeScript stays strict.
16
+ *
17
+ * Typing approach (mirrors the reference apimapper-mcp implementation):
18
+ * `ToolRegistrar` is the McpServer subsurface modules consume:
19
+ * `registerTool` + `registerResource`. `registerTool` is a hand-written
20
+ * generic mirroring the SDK signature EXCEPT its return type is `void`
21
+ * — captured tools have no live `RegisteredTool`, and no module reads
22
+ * the return value. A real `McpServer` is still assignable to
23
+ * `ToolRegistrar` (return-type bivariance for `void`), so every
24
+ * call-site accepts both shapes cast-free.
25
+ *
26
+ * Casts in this file (each documented + justified inline):
27
+ * 1. forwarded-essential — erases the handler's `InputArgs` generic to
28
+ * the SDK default when `config` is the erased `CapturedToolConfig`.
29
+ * 2. registry storage — erases the generic handler to the homogeneous
30
+ * `CapturedToolHandler` shape so one Map type fits all entries.
31
+ * 3. `registerResource` field — the SDK declares two overloads; a
32
+ * single spread-arg arrow cannot re-express the pair.
33
+ *
34
+ * @license MIT
35
+ */
36
+ import { isDirectTopLevel, isEssential } from './essentials.js';
37
+ /**
38
+ * Wraps a real McpServer. Forwards L1 essentials (and all resources) to it,
39
+ * captures L2 non-essentials into an in-process registry, and silently
40
+ * skips L3 direct top-level names that must already be on the real server.
41
+ */
42
+ export class CapturingServer {
43
+ realServer;
44
+ advancedRegistry = new Map();
45
+ constructor(realServer) {
46
+ this.realServer = realServer;
47
+ }
48
+ /**
49
+ * Routes a tool registration by name. Returns `void`: captured tools
50
+ * have no `RegisteredTool` and no `registerXTools` module reads the
51
+ * return value.
52
+ *
53
+ * Routing order matters: the L3-direct check is FIRST so a caller
54
+ * cannot accidentally re-route a direct-registered name through the
55
+ * gateway just by re-naming a future tool builder.
56
+ */
57
+ registerTool(name, config, handler) {
58
+ // L3 — direct top-level: already on the real server, do nothing.
59
+ // Returning early here prevents the SDK from raising a duplicate-name
60
+ // error when an L3 tool's builder is accidentally re-included in the
61
+ // forwarded tool list.
62
+ if (isDirectTopLevel(name)) {
63
+ return;
64
+ }
65
+ if (isEssential(name)) {
66
+ // L1 — forward to the real server.
67
+ //
68
+ // Cast: the SDK pairs `config.inputSchema` and the handler through
69
+ // one `InputArgs` generic. Here `config` is the erased
70
+ // `CapturedToolConfig`, so the SDK cannot re-infer that link; the
71
+ // handler is asserted to the SDK's default `ToolCallback` to satisfy
72
+ // the call. The runtime values are exactly what the SDK expects —
73
+ // only the static generic linkage is erased.
74
+ this.realServer.registerTool(name, config, handler);
75
+ return;
76
+ }
77
+ // L2 — capture into the advanced registry.
78
+ //
79
+ // Erase the generic handler to the captured-handler shape for
80
+ // homogeneous Map storage. The gateway validates `arguments` against
81
+ // the tool's Zod schema before invoking it, so the (args, extra)
82
+ // runtime contract holds.
83
+ this.advancedRegistry.set(name, {
84
+ config,
85
+ handler: handler,
86
+ });
87
+ }
88
+ /**
89
+ * Resources are always forwarded — they are not part of the tool cap.
90
+ *
91
+ * Cast: the SDK declares `registerResource` as two overloads; a single
92
+ * spread `(...args: RegisterResourceArgs)` arrow cannot re-express that
93
+ * overload pair, so the field is asserted to the SDK's exact member
94
+ * type. The spread forwards every argument verbatim, so the runtime
95
+ * contract is unchanged.
96
+ */
97
+ registerResource = ((...args) => this.realServer.registerResource(...args));
98
+ /** The captured non-essential tools, keyed by tool name. */
99
+ getAdvancedRegistry() {
100
+ return this.advancedRegistry;
101
+ }
102
+ }
103
+ //# sourceMappingURL=capturing-server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capturing-server.js","sourceRoot":"","sources":["../../src/gateway/capturing-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAMH,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA8DhE;;;;GAIG;AACH,MAAM,OAAO,eAAe;IACP,UAAU,CAAY;IACtB,gBAAgB,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEzE,YAAY,UAAqB;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY,CACR,IAAY,EACZ,MAA0B,EAC1B,OAAgC;QAEhC,iEAAiE;QACjE,sEAAsE;QACtE,qEAAqE;QACrE,uBAAuB;QACvB,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO;QACX,CAAC;QAED,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,mCAAmC;YACnC,EAAE;YACF,mEAAmE;YACnE,uDAAuD;YACvD,kEAAkE;YAClE,qEAAqE;YACrE,kEAAkE;YAClE,6CAA6C;YAC7C,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAuB,CAAC,CAAC;YACpE,OAAO;QACX,CAAC;QAED,2CAA2C;QAC3C,EAAE;QACF,8DAA8D;QAC9D,qEAAqE;QACrE,iEAAiE;QACjE,0BAA0B;QAC1B,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE;YAC5B,MAAM;YACN,OAAO,EAAE,OAAyC;SACrD,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;OAQG;IACH,gBAAgB,GAAkC,CAAC,CAAC,GAAG,IAA0B,EAAE,EAAE,CACjF,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC,CAAkC,CAAC;IAEhF,4DAA4D;IAC5D,mBAAmB;QACf,OAAO,IAAI,CAAC,gBAAgB,CAAC;IACjC,CAAC;CACJ"}
@@ -0,0 +1,49 @@
1
+ /**
2
+ * Gateway-Hub — single source of truth for the YT Builder MCP
3
+ * 3-lane registration surface.
4
+ *
5
+ * Lanes (Wave G.1 / Design-Doc §3.1.1):
6
+ * L1 — ESSENTIAL_TOOLS forwarded by the CapturingServer as
7
+ * first-class MCP tools in `tools/list`.
8
+ * L2 — (advanced) every NON-essential, NON-direct tool is
9
+ * captured by the CapturingServer and
10
+ * reachable through the single
11
+ * `yootheme_builder_advanced` gateway tool.
12
+ * L3 — DIRECT_TOP_LEVEL_TOOLS registered directly on the real McpServer
13
+ * BEFORE the CapturingServer wraps it.
14
+ * The CapturingServer skips these names
15
+ * entirely (no forward, no capture) so the
16
+ * SDK never sees a duplicate registration.
17
+ *
18
+ * Why this split: Cursor caps MCP servers at ~40 tools. This adapter
19
+ * declares 22 tools (21 domain + 1 gateway). The 3-lane shape keeps
20
+ * `tools/list` at 7 (L1) + 2 (L3) + 1 (gateway) = 10 entries, well under
21
+ * the cap, while every tool stays fully reachable.
22
+ *
23
+ * Health + diagnose live in L3 because they MUST be the first thing an
24
+ * LLM-host calls when something is broken; routing them through a gateway
25
+ * would create a chicken-and-egg loop (the LLM would have to discover
26
+ * the gateway before it can diagnose why the gateway is unreachable).
27
+ *
28
+ * @license MIT
29
+ */
30
+ /**
31
+ * L1 — Tools kept as first-class entries in `tools/list`.
32
+ * Forwarded by the CapturingServer to the real McpServer.
33
+ */
34
+ export declare const ESSENTIAL_TOOLS: readonly ["yootheme_builder_pages_list", "yootheme_builder_get_etag", "yootheme_builder_element_list", "yootheme_builder_element_add", "yootheme_builder_element_update_settings", "yootheme_builder_sources_list", "yootheme_builder_element_types_list", "yootheme_builder_inspect_multi_items_binding", "yootheme_builder_element_get", "yootheme_builder_element_delete", "yootheme_builder_element_clone", "yootheme_builder_element_move", "yootheme_builder_page_get_layout", "yootheme_builder_template_summary", "yootheme_builder_element_type_get_schema", "yootheme_builder_sites_list", "yootheme_builder_sites_test"];
35
+ /**
36
+ * L3 — Tools registered DIRECTLY on the real McpServer, BEFORE the
37
+ * CapturingServer wraps it. The CapturingServer treats these names as a
38
+ * no-op (no forward, no capture) so the SDK never sees a duplicate
39
+ * registration. Use this lane only for tools that must be reachable
40
+ * even if the gateway itself fails — currently health + diagnose.
41
+ */
42
+ export declare const DIRECT_TOP_LEVEL_TOOLS: readonly ["yootheme_builder_health", "yootheme_builder_diagnose"];
43
+ export type EssentialTool = (typeof ESSENTIAL_TOOLS)[number];
44
+ export type DirectTopLevelTool = (typeof DIRECT_TOP_LEVEL_TOOLS)[number];
45
+ /** True if `name` is in the L1 forwarded essentials surface. */
46
+ export declare function isEssential(name: string): boolean;
47
+ /** True if `name` is in the L3 direct top-level surface. */
48
+ export declare function isDirectTopLevel(name: string): boolean;
49
+ //# sourceMappingURL=essentials.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"essentials.d.ts","sourceRoot":"","sources":["../../src/gateway/essentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,qmBAsClB,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,mEAGzB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD"}
@@ -0,0 +1,92 @@
1
+ /**
2
+ * Gateway-Hub — single source of truth for the YT Builder MCP
3
+ * 3-lane registration surface.
4
+ *
5
+ * Lanes (Wave G.1 / Design-Doc §3.1.1):
6
+ * L1 — ESSENTIAL_TOOLS forwarded by the CapturingServer as
7
+ * first-class MCP tools in `tools/list`.
8
+ * L2 — (advanced) every NON-essential, NON-direct tool is
9
+ * captured by the CapturingServer and
10
+ * reachable through the single
11
+ * `yootheme_builder_advanced` gateway tool.
12
+ * L3 — DIRECT_TOP_LEVEL_TOOLS registered directly on the real McpServer
13
+ * BEFORE the CapturingServer wraps it.
14
+ * The CapturingServer skips these names
15
+ * entirely (no forward, no capture) so the
16
+ * SDK never sees a duplicate registration.
17
+ *
18
+ * Why this split: Cursor caps MCP servers at ~40 tools. This adapter
19
+ * declares 22 tools (21 domain + 1 gateway). The 3-lane shape keeps
20
+ * `tools/list` at 7 (L1) + 2 (L3) + 1 (gateway) = 10 entries, well under
21
+ * the cap, while every tool stays fully reachable.
22
+ *
23
+ * Health + diagnose live in L3 because they MUST be the first thing an
24
+ * LLM-host calls when something is broken; routing them through a gateway
25
+ * would create a chicken-and-egg loop (the LLM would have to discover
26
+ * the gateway before it can diagnose why the gateway is unreachable).
27
+ *
28
+ * @license MIT
29
+ */
30
+ /**
31
+ * L1 — Tools kept as first-class entries in `tools/list`.
32
+ * Forwarded by the CapturingServer to the real McpServer.
33
+ */
34
+ export const ESSENTIAL_TOOLS = [
35
+ 'yootheme_builder_pages_list',
36
+ 'yootheme_builder_get_etag',
37
+ 'yootheme_builder_element_list',
38
+ 'yootheme_builder_element_add',
39
+ 'yootheme_builder_element_update_settings',
40
+ 'yootheme_builder_sources_list',
41
+ 'yootheme_builder_element_types_list',
42
+ // Multi-Items inspector — L1 discovery tool. Surfaces when a
43
+ // binding lives on the wrong (container) level and which `*_item`
44
+ // child should carry it. Frequent first-call when diagnosing
45
+ // Grid/Slider/Switcher rendering issues.
46
+ 'yootheme_builder_inspect_multi_items_binding',
47
+ // F-16 hot-path promotions (Maria-Audit v2 re-confirmed) — the 5
48
+ // most-used read/mutate operations skip the advanced-router
49
+ // discovery roundtrip. Cursor cap is ~40; we sit at 15 L1 + 2 L3 +
50
+ // 1 gateway = 18, comfortable below the limit.
51
+ 'yootheme_builder_element_get',
52
+ 'yootheme_builder_element_delete',
53
+ 'yootheme_builder_element_clone',
54
+ 'yootheme_builder_element_move',
55
+ 'yootheme_builder_page_get_layout',
56
+ // T9 (Audit-v3 B.5) — token-efficient template overview. L1 because
57
+ // it's the recommended first call when orienting in a large template.
58
+ 'yootheme_builder_template_summary',
59
+ // 1.0.1 — element_type_get_schema promoted L2 → L1. Live-testing
60
+ // 1.0.0 in Claude Desktop showed tool_search couldn't surface it
61
+ // through the advanced gateway, yet it is the canonical prop-key
62
+ // discovery tool an agent needs BEFORE every element_add or
63
+ // element_update_settings. Hot-path for any write workflow.
64
+ 'yootheme_builder_element_type_get_schema',
65
+ // W7 (Multi-Site) — sites_list + sites_test must be L1 so an agent
66
+ // that just connected to a fresh MCP server can answer "which sites
67
+ // am I configured against?" without first discovering the gateway.
68
+ // Both are platform-agnostic (sites_list reads the registry only,
69
+ // sites_test probes /health + /etag for ONE site). L1 surface 15 → 17.
70
+ 'yootheme_builder_sites_list',
71
+ 'yootheme_builder_sites_test',
72
+ ];
73
+ /**
74
+ * L3 — Tools registered DIRECTLY on the real McpServer, BEFORE the
75
+ * CapturingServer wraps it. The CapturingServer treats these names as a
76
+ * no-op (no forward, no capture) so the SDK never sees a duplicate
77
+ * registration. Use this lane only for tools that must be reachable
78
+ * even if the gateway itself fails — currently health + diagnose.
79
+ */
80
+ export const DIRECT_TOP_LEVEL_TOOLS = [
81
+ 'yootheme_builder_health',
82
+ 'yootheme_builder_diagnose',
83
+ ];
84
+ /** True if `name` is in the L1 forwarded essentials surface. */
85
+ export function isEssential(name) {
86
+ return ESSENTIAL_TOOLS.includes(name);
87
+ }
88
+ /** True if `name` is in the L3 direct top-level surface. */
89
+ export function isDirectTopLevel(name) {
90
+ return DIRECT_TOP_LEVEL_TOOLS.includes(name);
91
+ }
92
+ //# sourceMappingURL=essentials.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"essentials.js","sourceRoot":"","sources":["../../src/gateway/essentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,6BAA6B;IAC7B,2BAA2B;IAC3B,+BAA+B;IAC/B,8BAA8B;IAC9B,0CAA0C;IAC1C,+BAA+B;IAC/B,qCAAqC;IACrC,6DAA6D;IAC7D,kEAAkE;IAClE,6DAA6D;IAC7D,yCAAyC;IACzC,8CAA8C;IAC9C,iEAAiE;IACjE,4DAA4D;IAC5D,mEAAmE;IACnE,+CAA+C;IAC/C,8BAA8B;IAC9B,iCAAiC;IACjC,gCAAgC;IAChC,+BAA+B;IAC/B,kCAAkC;IAClC,oEAAoE;IACpE,sEAAsE;IACtE,mCAAmC;IACnC,iEAAiE;IACjE,iEAAiE;IACjE,iEAAiE;IACjE,4DAA4D;IAC5D,4DAA4D;IAC5D,0CAA0C;IAC1C,mEAAmE;IACnE,oEAAoE;IACpE,mEAAmE;IACnE,kEAAkE;IAClE,uEAAuE;IACvE,6BAA6B;IAC7B,6BAA6B;CACvB,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,yBAAyB;IACzB,2BAA2B;CACrB,CAAC;AAKX,gEAAgE;AAChE,MAAM,UAAU,WAAW,CAAC,IAAY;IACpC,OAAQ,eAAqC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,gBAAgB,CAAC,IAAY;IACzC,OAAQ,sBAA4C,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxE,CAAC"}
@@ -0,0 +1,41 @@
1
+ /**
2
+ * Gateway test helpers — Wave G.1.
3
+ *
4
+ * After the gateway lands, tests that previously looked tools up from
5
+ * `McpServer._registeredTools` no longer find advanced tools (they're
6
+ * captured in the advanced registry, not on the real server). These
7
+ * helpers expose a unified view across all three lanes:
8
+ *
9
+ * - L1 essentials → real server's `_registeredTools`
10
+ * - L2 advanced → CapturingServer's `getAdvancedRegistry()`
11
+ * - L3 + gateway → real server's `_registeredTools`
12
+ *
13
+ * Test-only: never imported by any runtime path.
14
+ *
15
+ * @license MIT
16
+ */
17
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
18
+ import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
19
+ import type { CapturingServer } from './capturing-server.js';
20
+ /** A tool entry as seen by tests: handler + the registered config. */
21
+ export interface CollectedTool {
22
+ handler: (args: Record<string, unknown>, extra?: unknown) => CallToolResult | Promise<CallToolResult>;
23
+ title?: string;
24
+ description?: string;
25
+ inputSchema?: unknown;
26
+ annotations?: Record<string, unknown>;
27
+ }
28
+ /**
29
+ * Returns every tool — essentials + gateway on the real McpServer plus
30
+ * the advanced tools captured by the CapturingServer — keyed by tool
31
+ * name. The CapturingServer must have been used to register the L1/L2
32
+ * tools, and `registerAdvancedTool` must have run, before this is called.
33
+ *
34
+ * Production size = 22:
35
+ * 7 L1 essentials (real server) + 12 L2 advanced (registry)
36
+ * + 2 L3 direct (real server) + 1 gateway (real server) = 22.
37
+ */
38
+ export declare function collectAllRegisteredTools(server: McpServer, capturing: CapturingServer): Record<string, CollectedTool>;
39
+ /** By-name lookup over a `collectAllRegisteredTools` map. */
40
+ export declare function findTool(tools: Record<string, CollectedTool>, name: string): CollectedTool | undefined;
41
+ //# sourceMappingURL=test-support.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-support.d.ts","sourceRoot":"","sources":["../../src/gateway/test-support.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,CACL,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,CAAC,EAAE,OAAO,KACd,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACrC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,eAAe,GAC3B,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAuC/B;AAED,6DAA6D;AAC7D,wBAAgB,QAAQ,CACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACpC,IAAI,EAAE,MAAM,GACb,aAAa,GAAG,SAAS,CAE3B"}
@@ -0,0 +1,60 @@
1
+ /**
2
+ * Gateway test helpers — Wave G.1.
3
+ *
4
+ * After the gateway lands, tests that previously looked tools up from
5
+ * `McpServer._registeredTools` no longer find advanced tools (they're
6
+ * captured in the advanced registry, not on the real server). These
7
+ * helpers expose a unified view across all three lanes:
8
+ *
9
+ * - L1 essentials → real server's `_registeredTools`
10
+ * - L2 advanced → CapturingServer's `getAdvancedRegistry()`
11
+ * - L3 + gateway → real server's `_registeredTools`
12
+ *
13
+ * Test-only: never imported by any runtime path.
14
+ *
15
+ * @license MIT
16
+ */
17
+ /**
18
+ * Returns every tool — essentials + gateway on the real McpServer plus
19
+ * the advanced tools captured by the CapturingServer — keyed by tool
20
+ * name. The CapturingServer must have been used to register the L1/L2
21
+ * tools, and `registerAdvancedTool` must have run, before this is called.
22
+ *
23
+ * Production size = 22:
24
+ * 7 L1 essentials (real server) + 12 L2 advanced (registry)
25
+ * + 2 L3 direct (real server) + 1 gateway (real server) = 22.
26
+ */
27
+ export function collectAllRegisteredTools(server, capturing) {
28
+ const result = {};
29
+ // The SDK changed the internal field name from `handler` to `callback`
30
+ // over its 1.x lifetime; accept either to keep the helper resilient.
31
+ const real = server;
32
+ for (const [name, tool] of Object.entries(real._registeredTools)) {
33
+ const callback = 'callback' in tool && typeof tool.callback === 'function'
34
+ ? tool.callback
35
+ : tool.handler;
36
+ result[name] = {
37
+ handler: callback,
38
+ title: tool.title,
39
+ description: tool.description,
40
+ inputSchema: tool.inputSchema,
41
+ annotations: tool.annotations,
42
+ };
43
+ }
44
+ for (const [name, entry] of capturing.getAdvancedRegistry()) {
45
+ const cfg = entry.config;
46
+ result[name] = {
47
+ handler: entry.handler,
48
+ title: cfg.title,
49
+ description: cfg.description,
50
+ inputSchema: cfg.inputSchema,
51
+ annotations: cfg.annotations,
52
+ };
53
+ }
54
+ return result;
55
+ }
56
+ /** By-name lookup over a `collectAllRegisteredTools` map. */
57
+ export function findTool(tools, name) {
58
+ return tools[name];
59
+ }
60
+ //# sourceMappingURL=test-support.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-support.js","sourceRoot":"","sources":["../../src/gateway/test-support.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAmCH;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACrC,MAAiB,EACjB,SAA0B;IAE1B,MAAM,MAAM,GAAkC,EAAE,CAAC;IAEjD,uEAAuE;IACvE,qEAAqE;IACrE,MAAM,IAAI,GAAG,MAEZ,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC/D,MAAM,QAAQ,GACV,UAAU,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU;YACrD,CAAC,CAAC,IAAI,CAAC,QAAQ;YACf,CAAC,CAAE,IAAiC,CAAC,OAAO,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,GAAG;YACX,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;SAChC,CAAC;IACN,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,mBAAmB,EAAE,EAAE,CAAC;QAC1D,MAAM,GAAG,GAAG,KAAK,CAAC,MAKjB,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,GAAG;YACX,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,WAAW,EAAE,GAAG,CAAC,WAAW;SAC/B,CAAC;IACN,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,QAAQ,CACpB,KAAoC,EACpC,IAAY;IAEZ,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC"}
@@ -0,0 +1,29 @@
1
+ /**
2
+ * MCP server entrypoint (stdio transport).
3
+ *
4
+ * Reads config from environment variables (see `auth.ts`), spins up a
5
+ * `McpServer` with all tools registered, connects to stdio, and lets
6
+ * the host (Claude Desktop / Cursor / Zed / …) drive.
7
+ *
8
+ * `YTB_MCP_TEST_MODE=1` short-circuits: prints the tool registry and
9
+ * exits 0. Used by the smoke test and by `release.php` to validate
10
+ * that the bundled `dist/` is loadable on the target Node version.
11
+ *
12
+ * @license MIT
13
+ */
14
+ export { createServer, SERVER_NAME, SERVER_VERSION } from './server.js';
15
+ export { RestClient, REST_NAMESPACE_PATH, encodeElementPath } from './client.js';
16
+ export { loadConfig, loadRegistry, isTestMode, ENV_SITE_URL, ENV_WP_URL, ENV_BEARER, ENV_SITES_FILE, ENV_TEST_MODE, } from './auth.js';
17
+ export { ConfigError, RestError, NetworkError } from './errors.js';
18
+ export { buildAllTools } from './tools/index.js';
19
+ export { ClientPool, NoDefaultSiteError, UnknownSiteError } from './sites/client-pool.js';
20
+ export { SiteRegistry } from './sites/registry.js';
21
+ export { synthesiseFromEnv } from './sites/env-bridge.js';
22
+ export { defaultSecretResolver, PlainSecretResolver } from './sites/secret-resolver.js';
23
+ export { ESSENTIAL_TOOLS, DIRECT_TOP_LEVEL_TOOLS, isEssential, isDirectTopLevel, } from './gateway/essentials.js';
24
+ export { CapturingServer, type AdvancedToolEntry, type CapturedToolHandler, type ToolRegistrar, } from './gateway/capturing-server.js';
25
+ export { registerAdvancedTool } from './gateway/advanced-tool.js';
26
+ export { collectAllRegisteredTools, findTool, type CollectedTool, } from './gateway/test-support.js';
27
+ declare function main(): Promise<void>;
28
+ export { main };
29
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EACH,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EACV,cAAc,EACd,aAAa,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACxF,OAAO,EACH,eAAe,EACf,sBAAsB,EACtB,WAAW,EACX,gBAAgB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACH,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EACH,yBAAyB,EACzB,QAAQ,EACR,KAAK,aAAa,GACrB,MAAM,2BAA2B,CAAC;AAEnC,iBAAe,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAkEnC;AAkBD,OAAO,EAAE,IAAI,EAAE,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,113 @@
1
+ /**
2
+ * MCP server entrypoint (stdio transport).
3
+ *
4
+ * Reads config from environment variables (see `auth.ts`), spins up a
5
+ * `McpServer` with all tools registered, connects to stdio, and lets
6
+ * the host (Claude Desktop / Cursor / Zed / …) drive.
7
+ *
8
+ * `YTB_MCP_TEST_MODE=1` short-circuits: prints the tool registry and
9
+ * exits 0. Used by the smoke test and by `release.php` to validate
10
+ * that the bundled `dist/` is loadable on the target Node version.
11
+ *
12
+ * @license MIT
13
+ */
14
+ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
15
+ import { isTestMode, loadConfig, loadRegistry } from './auth.js';
16
+ import { ConfigError } from './errors.js';
17
+ import { ClientPool } from './sites/client-pool.js';
18
+ import { SiteRegistry } from './sites/registry.js';
19
+ import { defaultSecretResolver } from './sites/secret-resolver.js';
20
+ import { createServer } from './server.js';
21
+ export { createServer, SERVER_NAME, SERVER_VERSION } from './server.js';
22
+ export { RestClient, REST_NAMESPACE_PATH, encodeElementPath } from './client.js';
23
+ export { loadConfig, loadRegistry, isTestMode, ENV_SITE_URL, ENV_WP_URL, ENV_BEARER, ENV_SITES_FILE, ENV_TEST_MODE, } from './auth.js';
24
+ export { ConfigError, RestError, NetworkError } from './errors.js';
25
+ export { buildAllTools } from './tools/index.js';
26
+ // W6 — multi-site primitives exported for dist consumers (scripts,
27
+ // embedded uses). The `ClientPool` is the new wiring contract.
28
+ export { ClientPool, NoDefaultSiteError, UnknownSiteError } from './sites/client-pool.js';
29
+ export { SiteRegistry } from './sites/registry.js';
30
+ export { synthesiseFromEnv } from './sites/env-bridge.js';
31
+ export { defaultSecretResolver, PlainSecretResolver } from './sites/secret-resolver.js';
32
+ export { ESSENTIAL_TOOLS, DIRECT_TOP_LEVEL_TOOLS, isEssential, isDirectTopLevel, } from './gateway/essentials.js';
33
+ export { CapturingServer, } from './gateway/capturing-server.js';
34
+ export { registerAdvancedTool } from './gateway/advanced-tool.js';
35
+ export { collectAllRegisteredTools, findTool, } from './gateway/test-support.js';
36
+ async function main() {
37
+ const testMode = isTestMode();
38
+ // W10 — multi-site bootstrap is now centralised in
39
+ // `auth.loadRegistry()`. The canonical resolution order is:
40
+ // 1. YTB_MCP_SITES_FILE → loadSitesFile + SiteRegistry
41
+ // 2. env-bridge (YTB_MCP_SITE_URL + YTB_MCP_BEARER_TOKEN)
42
+ // 3. ConfigError("No sites configured.")
43
+ //
44
+ // The single exception lives here: `--test-mode` smoke probes
45
+ // (release.php, CI tool-list dumps) must boot even when neither
46
+ // path is configured. We honor loadRegistry first, then trap the
47
+ // ConfigError in test-mode and synthesise an empty registry so the
48
+ // tool list still prints. Tools will refuse to run, which is
49
+ // expected — `--test-mode` never invokes them.
50
+ let registry;
51
+ try {
52
+ registry = await loadRegistry();
53
+ }
54
+ catch (e) {
55
+ if (testMode && e instanceof ConfigError) {
56
+ // Mirror legacy test-mode behaviour: try loadConfig with
57
+ // the back-compat permissive flag so the print-tools probe
58
+ // still boots even with no sites at all. If loadConfig
59
+ // *also* throws, surface the more specific message.
60
+ try {
61
+ loadConfig({ allowMissingToken: true });
62
+ }
63
+ catch (cfgErr) {
64
+ if (cfgErr instanceof ConfigError) {
65
+ process.stderr.write(`[yt-builder-mcp] ${cfgErr.message}\n`);
66
+ process.exit(1);
67
+ }
68
+ throw cfgErr;
69
+ }
70
+ registry = new SiteRegistry({
71
+ schema_version: 1,
72
+ default_site_id: null,
73
+ sites: [],
74
+ });
75
+ }
76
+ else {
77
+ const msg = e instanceof Error ? e.message : String(e);
78
+ process.stderr.write(`[yt-builder-mcp] ${msg}\n`);
79
+ process.exit(1);
80
+ }
81
+ }
82
+ const secretResolver = defaultSecretResolver();
83
+ const pool = new ClientPool(registry, secretResolver);
84
+ const { mcp, tools } = createServer({ pool });
85
+ if (testMode) {
86
+ // Print a one-line per tool summary to stderr (stdout is reserved
87
+ // for the JSON-RPC frame in real runs) and exit cleanly.
88
+ process.stderr.write(`[yt-builder-mcp] test mode — ${String(tools.length)} tools registered:\n`);
89
+ for (const tool of tools) {
90
+ process.stderr.write(` - ${tool.name}\n`);
91
+ }
92
+ process.exit(0);
93
+ }
94
+ const transport = new StdioServerTransport();
95
+ await mcp.connect(transport);
96
+ }
97
+ /**
98
+ * Auto-run unless explicitly disabled. Tests set `YTB_MCP_NO_AUTORUN=1`
99
+ * to import the module without firing up the stdio server.
100
+ *
101
+ * The bin dispatcher (`bin/yt-builder-mcp.js`) imports
102
+ * `dist/index.js` dynamically and expects `main()` to take over — so by
103
+ * default we run on import.
104
+ */
105
+ if (process.env.YTB_MCP_NO_AUTORUN !== '1') {
106
+ main().catch((e) => {
107
+ const message = e instanceof Error ? e.message : String(e);
108
+ process.stderr.write(`[yt-builder-mcp] fatal: ${message}\n`);
109
+ process.exit(1);
110
+ });
111
+ }
112
+ export { main };
113
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EACH,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EACV,cAAc,EACd,aAAa,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,mEAAmE;AACnE,+DAA+D;AAC/D,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACxF,OAAO,EACH,eAAe,EACf,sBAAsB,EACtB,WAAW,EACX,gBAAgB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACH,eAAe,GAIlB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EACH,yBAAyB,EACzB,QAAQ,GAEX,MAAM,2BAA2B,CAAC;AAEnC,KAAK,UAAU,IAAI;IACf,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC;IAE9B,mDAAmD;IACnD,4DAA4D;IAC5D,yDAAyD;IACzD,4DAA4D;IAC5D,2CAA2C;IAC3C,EAAE;IACF,8DAA8D;IAC9D,gEAAgE;IAChE,iEAAiE;IACjE,mEAAmE;IACnE,6DAA6D;IAC7D,+CAA+C;IAC/C,IAAI,QAAsB,CAAC;IAC3B,IAAI,CAAC;QACD,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACpC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,IAAI,QAAQ,IAAI,CAAC,YAAY,WAAW,EAAE,CAAC;YACvC,yDAAyD;YACzD,2DAA2D;YAC3D,uDAAuD;YACvD,oDAAoD;YACpD,IAAI,CAAC;gBACD,UAAU,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,MAAM,EAAE,CAAC;gBACd,IAAI,MAAM,YAAY,WAAW,EAAE,CAAC;oBAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAChB,oBAAoB,MAAM,CAAC,OAAO,IAAI,CACzC,CAAC;oBACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACpB,CAAC;gBACD,MAAM,MAAM,CAAC;YACjB,CAAC;YACD,QAAQ,GAAG,IAAI,YAAY,CAAC;gBACxB,cAAc,EAAE,CAAC;gBACjB,eAAe,EAAE,IAAI;gBACrB,KAAK,EAAE,EAAE;aACZ,CAAC,CAAC;QACP,CAAC;aAAM,CAAC;YACJ,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC;IAED,MAAM,cAAc,GAAG,qBAAqB,EAAE,CAAC;IAC/C,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAEtD,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9C,IAAI,QAAQ,EAAE,CAAC;QACX,kEAAkE;QAClE,yDAAyD;QACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAChB,gCAAgC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,sBAAsB,CAC7E,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;GAOG;AACH,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,GAAG,EAAE,CAAC;IACzC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;QACxB,MAAM,OAAO,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC3D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,OAAO,IAAI,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;AACP,CAAC;AAED,OAAO,EAAE,IAAI,EAAE,CAAC"}