@wootsup/yt-builder-mcp 1.0.0 → 1.0.1

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 (319) hide show
  1. package/manifest.json +1 -1
  2. package/package.json +1 -1
  3. package/skills/{yootheme-builder → yt-builder-mcp}/SKILL.md +1 -1
  4. package/dist/auth.d.ts +0 -39
  5. package/dist/auth.d.ts.map +0 -1
  6. package/dist/auth.js +0 -93
  7. package/dist/auth.js.map +0 -1
  8. package/dist/client.d.ts +0 -84
  9. package/dist/client.d.ts.map +0 -1
  10. package/dist/client.js +0 -151
  11. package/dist/client.js.map +0 -1
  12. package/dist/clients/claude-code.d.ts +0 -18
  13. package/dist/clients/claude-code.d.ts.map +0 -1
  14. package/dist/clients/claude-code.js +0 -53
  15. package/dist/clients/claude-code.js.map +0 -1
  16. package/dist/clients/claude-desktop.d.ts +0 -19
  17. package/dist/clients/claude-desktop.d.ts.map +0 -1
  18. package/dist/clients/claude-desktop.js +0 -56
  19. package/dist/clients/claude-desktop.js.map +0 -1
  20. package/dist/clients/cline.d.ts +0 -26
  21. package/dist/clients/cline.d.ts.map +0 -1
  22. package/dist/clients/cline.js +0 -80
  23. package/dist/clients/cline.js.map +0 -1
  24. package/dist/clients/codex-cli.d.ts +0 -42
  25. package/dist/clients/codex-cli.d.ts.map +0 -1
  26. package/dist/clients/codex-cli.js +0 -194
  27. package/dist/clients/codex-cli.js.map +0 -1
  28. package/dist/clients/continue.d.ts +0 -13
  29. package/dist/clients/continue.d.ts.map +0 -1
  30. package/dist/clients/continue.js +0 -52
  31. package/dist/clients/continue.js.map +0 -1
  32. package/dist/clients/cursor.d.ts +0 -12
  33. package/dist/clients/cursor.d.ts.map +0 -1
  34. package/dist/clients/cursor.js +0 -38
  35. package/dist/clients/cursor.js.map +0 -1
  36. package/dist/clients/gemini-cli.d.ts +0 -18
  37. package/dist/clients/gemini-cli.d.ts.map +0 -1
  38. package/dist/clients/gemini-cli.js +0 -44
  39. package/dist/clients/gemini-cli.js.map +0 -1
  40. package/dist/clients/home.d.ts +0 -14
  41. package/dist/clients/home.d.ts.map +0 -1
  42. package/dist/clients/home.js +0 -20
  43. package/dist/clients/home.js.map +0 -1
  44. package/dist/clients/index.d.ts +0 -52
  45. package/dist/clients/index.d.ts.map +0 -1
  46. package/dist/clients/index.js +0 -72
  47. package/dist/clients/index.js.map +0 -1
  48. package/dist/clients/roo-code.d.ts +0 -23
  49. package/dist/clients/roo-code.d.ts.map +0 -1
  50. package/dist/clients/roo-code.js +0 -69
  51. package/dist/clients/roo-code.js.map +0 -1
  52. package/dist/clients/zed.d.ts +0 -12
  53. package/dist/clients/zed.d.ts.map +0 -1
  54. package/dist/clients/zed.js +0 -41
  55. package/dist/clients/zed.js.map +0 -1
  56. package/dist/errors/hints.d.ts +0 -51
  57. package/dist/errors/hints.d.ts.map +0 -1
  58. package/dist/errors/hints.js +0 -95
  59. package/dist/errors/hints.js.map +0 -1
  60. package/dist/errors/mask.d.ts +0 -35
  61. package/dist/errors/mask.d.ts.map +0 -1
  62. package/dist/errors/mask.js +0 -49
  63. package/dist/errors/mask.js.map +0 -1
  64. package/dist/errors/sanitize.d.ts +0 -31
  65. package/dist/errors/sanitize.d.ts.map +0 -1
  66. package/dist/errors/sanitize.js +0 -90
  67. package/dist/errors/sanitize.js.map +0 -1
  68. package/dist/errors.d.ts +0 -42
  69. package/dist/errors.d.ts.map +0 -1
  70. package/dist/errors.js +0 -61
  71. package/dist/errors.js.map +0 -1
  72. package/dist/gateway/advanced-tool/discovery.d.ts +0 -19
  73. package/dist/gateway/advanced-tool/discovery.d.ts.map +0 -1
  74. package/dist/gateway/advanced-tool/discovery.js +0 -53
  75. package/dist/gateway/advanced-tool/discovery.js.map +0 -1
  76. package/dist/gateway/advanced-tool/domains.d.ts +0 -47
  77. package/dist/gateway/advanced-tool/domains.d.ts.map +0 -1
  78. package/dist/gateway/advanced-tool/domains.js +0 -94
  79. package/dist/gateway/advanced-tool/domains.js.map +0 -1
  80. package/dist/gateway/advanced-tool/execute.d.ts +0 -29
  81. package/dist/gateway/advanced-tool/execute.d.ts.map +0 -1
  82. package/dist/gateway/advanced-tool/execute.js +0 -54
  83. package/dist/gateway/advanced-tool/execute.js.map +0 -1
  84. package/dist/gateway/advanced-tool/index.d.ts +0 -36
  85. package/dist/gateway/advanced-tool/index.d.ts.map +0 -1
  86. package/dist/gateway/advanced-tool/index.js +0 -39
  87. package/dist/gateway/advanced-tool/index.js.map +0 -1
  88. package/dist/gateway/advanced-tool/register.d.ts +0 -18
  89. package/dist/gateway/advanced-tool/register.d.ts.map +0 -1
  90. package/dist/gateway/advanced-tool/register.js +0 -69
  91. package/dist/gateway/advanced-tool/register.js.map +0 -1
  92. package/dist/gateway/advanced-tool.d.ts +0 -13
  93. package/dist/gateway/advanced-tool.d.ts.map +0 -1
  94. package/dist/gateway/advanced-tool.js +0 -13
  95. package/dist/gateway/advanced-tool.js.map +0 -1
  96. package/dist/gateway/capturing-server.d.ts +0 -117
  97. package/dist/gateway/capturing-server.d.ts.map +0 -1
  98. package/dist/gateway/capturing-server.js +0 -103
  99. package/dist/gateway/capturing-server.js.map +0 -1
  100. package/dist/gateway/essentials.d.ts +0 -49
  101. package/dist/gateway/essentials.d.ts.map +0 -1
  102. package/dist/gateway/essentials.js +0 -79
  103. package/dist/gateway/essentials.js.map +0 -1
  104. package/dist/gateway/test-support.d.ts +0 -41
  105. package/dist/gateway/test-support.d.ts.map +0 -1
  106. package/dist/gateway/test-support.js +0 -60
  107. package/dist/gateway/test-support.js.map +0 -1
  108. package/dist/index.d.ts +0 -25
  109. package/dist/index.d.ts.map +0 -1
  110. package/dist/index.js +0 -77
  111. package/dist/index.js.map +0 -1
  112. package/dist/install-skill.d.ts +0 -35
  113. package/dist/install-skill.d.ts.map +0 -1
  114. package/dist/install-skill.js +0 -107
  115. package/dist/install-skill.js.map +0 -1
  116. package/dist/platform/index.d.ts +0 -49
  117. package/dist/platform/index.d.ts.map +0 -1
  118. package/dist/platform/index.js +0 -38
  119. package/dist/platform/index.js.map +0 -1
  120. package/dist/server.d.ts +0 -50
  121. package/dist/server.d.ts.map +0 -1
  122. package/dist/server.js +0 -153
  123. package/dist/server.js.map +0 -1
  124. package/dist/setup-cli.d.ts +0 -100
  125. package/dist/setup-cli.d.ts.map +0 -1
  126. package/dist/setup-cli.js +0 -355
  127. package/dist/setup-cli.js.map +0 -1
  128. package/dist/setup-prompts.d.ts +0 -41
  129. package/dist/setup-prompts.d.ts.map +0 -1
  130. package/dist/setup-prompts.js +0 -142
  131. package/dist/setup-prompts.js.map +0 -1
  132. package/dist/setup-token.d.ts +0 -38
  133. package/dist/setup-token.d.ts.map +0 -1
  134. package/dist/setup-token.js +0 -106
  135. package/dist/setup-token.js.map +0 -1
  136. package/dist/setup-wizard-defaults.d.ts +0 -43
  137. package/dist/setup-wizard-defaults.d.ts.map +0 -1
  138. package/dist/setup-wizard-defaults.js +0 -160
  139. package/dist/setup-wizard-defaults.js.map +0 -1
  140. package/dist/setup-wizard-handshake.d.ts +0 -25
  141. package/dist/setup-wizard-handshake.d.ts.map +0 -1
  142. package/dist/setup-wizard-handshake.js +0 -103
  143. package/dist/setup-wizard-handshake.js.map +0 -1
  144. package/dist/setup-wizard-types.d.ts +0 -148
  145. package/dist/setup-wizard-types.d.ts.map +0 -1
  146. package/dist/setup-wizard-types.js +0 -11
  147. package/dist/setup-wizard-types.js.map +0 -1
  148. package/dist/setup-wizard.d.ts +0 -33
  149. package/dist/setup-wizard.d.ts.map +0 -1
  150. package/dist/setup-wizard.js +0 -166
  151. package/dist/setup-wizard.js.map +0 -1
  152. package/dist/setup.d.ts +0 -17
  153. package/dist/setup.d.ts.map +0 -1
  154. package/dist/setup.js +0 -33
  155. package/dist/setup.js.map +0 -1
  156. package/dist/skill-loader.d.ts +0 -51
  157. package/dist/skill-loader.d.ts.map +0 -1
  158. package/dist/skill-loader.js +0 -78
  159. package/dist/skill-loader.js.map +0 -1
  160. package/dist/tools/elements/builders.d.ts +0 -24
  161. package/dist/tools/elements/builders.d.ts.map +0 -1
  162. package/dist/tools/elements/builders.js +0 -177
  163. package/dist/tools/elements/builders.js.map +0 -1
  164. package/dist/tools/elements/handlers-write.d.ts +0 -49
  165. package/dist/tools/elements/handlers-write.d.ts.map +0 -1
  166. package/dist/tools/elements/handlers-write.js +0 -148
  167. package/dist/tools/elements/handlers-write.js.map +0 -1
  168. package/dist/tools/elements/handlers.d.ts +0 -61
  169. package/dist/tools/elements/handlers.d.ts.map +0 -1
  170. package/dist/tools/elements/handlers.js +0 -170
  171. package/dist/tools/elements/handlers.js.map +0 -1
  172. package/dist/tools/elements/index.d.ts +0 -28
  173. package/dist/tools/elements/index.d.ts.map +0 -1
  174. package/dist/tools/elements/index.js +0 -27
  175. package/dist/tools/elements/index.js.map +0 -1
  176. package/dist/tools/elements.d.ts +0 -13
  177. package/dist/tools/elements.d.ts.map +0 -1
  178. package/dist/tools/elements.js +0 -13
  179. package/dist/tools/elements.js.map +0 -1
  180. package/dist/tools/elicitation.d.ts +0 -87
  181. package/dist/tools/elicitation.d.ts.map +0 -1
  182. package/dist/tools/elicitation.js +0 -100
  183. package/dist/tools/elicitation.js.map +0 -1
  184. package/dist/tools/format/elements-format.d.ts +0 -40
  185. package/dist/tools/format/elements-format.d.ts.map +0 -1
  186. package/dist/tools/format/elements-format.js +0 -194
  187. package/dist/tools/format/elements-format.js.map +0 -1
  188. package/dist/tools/format/health-format.d.ts +0 -73
  189. package/dist/tools/format/health-format.d.ts.map +0 -1
  190. package/dist/tools/format/health-format.js +0 -178
  191. package/dist/tools/format/health-format.js.map +0 -1
  192. package/dist/tools/format/inspection-format.d.ts +0 -58
  193. package/dist/tools/format/inspection-format.d.ts.map +0 -1
  194. package/dist/tools/format/inspection-format.js +0 -164
  195. package/dist/tools/format/inspection-format.js.map +0 -1
  196. package/dist/tools/format/pages-format.d.ts +0 -42
  197. package/dist/tools/format/pages-format.d.ts.map +0 -1
  198. package/dist/tools/format/pages-format.js +0 -113
  199. package/dist/tools/format/pages-format.js.map +0 -1
  200. package/dist/tools/format/sources-format.d.ts +0 -25
  201. package/dist/tools/format/sources-format.d.ts.map +0 -1
  202. package/dist/tools/format/sources-format.js +0 -208
  203. package/dist/tools/format/sources-format.js.map +0 -1
  204. package/dist/tools/health.d.ts +0 -22
  205. package/dist/tools/health.d.ts.map +0 -1
  206. package/dist/tools/health.js +0 -147
  207. package/dist/tools/health.js.map +0 -1
  208. package/dist/tools/index.d.ts +0 -23
  209. package/dist/tools/index.d.ts.map +0 -1
  210. package/dist/tools/index.js +0 -25
  211. package/dist/tools/index.js.map +0 -1
  212. package/dist/tools/inspection.d.ts +0 -14
  213. package/dist/tools/inspection.d.ts.map +0 -1
  214. package/dist/tools/inspection.js +0 -125
  215. package/dist/tools/inspection.js.map +0 -1
  216. package/dist/tools/layout-flatten.d.ts +0 -75
  217. package/dist/tools/layout-flatten.d.ts.map +0 -1
  218. package/dist/tools/layout-flatten.js +0 -107
  219. package/dist/tools/layout-flatten.js.map +0 -1
  220. package/dist/tools/multi-items/builders.d.ts +0 -23
  221. package/dist/tools/multi-items/builders.d.ts.map +0 -1
  222. package/dist/tools/multi-items/builders.js +0 -56
  223. package/dist/tools/multi-items/builders.js.map +0 -1
  224. package/dist/tools/multi-items/clean-implode-handler.d.ts +0 -28
  225. package/dist/tools/multi-items/clean-implode-handler.d.ts.map +0 -1
  226. package/dist/tools/multi-items/clean-implode-handler.js +0 -40
  227. package/dist/tools/multi-items/clean-implode-handler.js.map +0 -1
  228. package/dist/tools/multi-items/index.d.ts +0 -18
  229. package/dist/tools/multi-items/index.d.ts.map +0 -1
  230. package/dist/tools/multi-items/index.js +0 -18
  231. package/dist/tools/multi-items/index.js.map +0 -1
  232. package/dist/tools/multi-items/inspect-handler.d.ts +0 -41
  233. package/dist/tools/multi-items/inspect-handler.d.ts.map +0 -1
  234. package/dist/tools/multi-items/inspect-handler.js +0 -50
  235. package/dist/tools/multi-items/inspect-handler.js.map +0 -1
  236. package/dist/tools/multi-items/item-container-map.d.ts +0 -41
  237. package/dist/tools/multi-items/item-container-map.d.ts.map +0 -1
  238. package/dist/tools/multi-items/item-container-map.js +0 -73
  239. package/dist/tools/multi-items/item-container-map.js.map +0 -1
  240. package/dist/tools/pages/builders.d.ts +0 -14
  241. package/dist/tools/pages/builders.d.ts.map +0 -1
  242. package/dist/tools/pages/builders.js +0 -115
  243. package/dist/tools/pages/builders.js.map +0 -1
  244. package/dist/tools/pages/handlers-read.d.ts +0 -33
  245. package/dist/tools/pages/handlers-read.d.ts.map +0 -1
  246. package/dist/tools/pages/handlers-read.js +0 -161
  247. package/dist/tools/pages/handlers-read.js.map +0 -1
  248. package/dist/tools/pages/handlers-write.d.ts +0 -21
  249. package/dist/tools/pages/handlers-write.d.ts.map +0 -1
  250. package/dist/tools/pages/handlers-write.js +0 -52
  251. package/dist/tools/pages/handlers-write.js.map +0 -1
  252. package/dist/tools/pages/index.d.ts +0 -17
  253. package/dist/tools/pages/index.d.ts.map +0 -1
  254. package/dist/tools/pages/index.js +0 -17
  255. package/dist/tools/pages/index.js.map +0 -1
  256. package/dist/tools/pages/schemas.d.ts +0 -30
  257. package/dist/tools/pages/schemas.d.ts.map +0 -1
  258. package/dist/tools/pages/schemas.js +0 -30
  259. package/dist/tools/pages/schemas.js.map +0 -1
  260. package/dist/tools/pages.d.ts +0 -13
  261. package/dist/tools/pages.d.ts.map +0 -1
  262. package/dist/tools/pages.js +0 -13
  263. package/dist/tools/pages.js.map +0 -1
  264. package/dist/tools/progress-phases.d.ts +0 -46
  265. package/dist/tools/progress-phases.d.ts.map +0 -1
  266. package/dist/tools/progress-phases.js +0 -48
  267. package/dist/tools/progress-phases.js.map +0 -1
  268. package/dist/tools/shared-schemas.d.ts +0 -15
  269. package/dist/tools/shared-schemas.d.ts.map +0 -1
  270. package/dist/tools/shared-schemas.js +0 -30
  271. package/dist/tools/shared-schemas.js.map +0 -1
  272. package/dist/tools/sources/builders.d.ts +0 -13
  273. package/dist/tools/sources/builders.d.ts.map +0 -1
  274. package/dist/tools/sources/builders.js +0 -103
  275. package/dist/tools/sources/builders.js.map +0 -1
  276. package/dist/tools/sources/handlers-bind.d.ts +0 -28
  277. package/dist/tools/sources/handlers-bind.d.ts.map +0 -1
  278. package/dist/tools/sources/handlers-bind.js +0 -129
  279. package/dist/tools/sources/handlers-bind.js.map +0 -1
  280. package/dist/tools/sources/handlers.d.ts +0 -45
  281. package/dist/tools/sources/handlers.d.ts.map +0 -1
  282. package/dist/tools/sources/handlers.js +0 -91
  283. package/dist/tools/sources/handlers.js.map +0 -1
  284. package/dist/tools/sources/index.d.ts +0 -19
  285. package/dist/tools/sources/index.d.ts.map +0 -1
  286. package/dist/tools/sources/index.js +0 -18
  287. package/dist/tools/sources/index.js.map +0 -1
  288. package/dist/tools/sources.d.ts +0 -14
  289. package/dist/tools/sources.d.ts.map +0 -1
  290. package/dist/tools/sources.js +0 -14
  291. package/dist/tools/sources.js.map +0 -1
  292. package/dist/tools/sparse-fields.d.ts +0 -80
  293. package/dist/tools/sparse-fields.d.ts.map +0 -1
  294. package/dist/tools/sparse-fields.js +0 -144
  295. package/dist/tools/sparse-fields.js.map +0 -1
  296. package/dist/tools/tool-builder/annotations.d.ts +0 -55
  297. package/dist/tools/tool-builder/annotations.d.ts.map +0 -1
  298. package/dist/tools/tool-builder/annotations.js +0 -86
  299. package/dist/tools/tool-builder/annotations.js.map +0 -1
  300. package/dist/tools/tool-builder/define.d.ts +0 -31
  301. package/dist/tools/tool-builder/define.d.ts.map +0 -1
  302. package/dist/tools/tool-builder/define.js +0 -31
  303. package/dist/tools/tool-builder/define.js.map +0 -1
  304. package/dist/tools/tool-builder/index.d.ts +0 -28
  305. package/dist/tools/tool-builder/index.d.ts.map +0 -1
  306. package/dist/tools/tool-builder/index.js +0 -27
  307. package/dist/tools/tool-builder/index.js.map +0 -1
  308. package/dist/tools/tool-builder/results.d.ts +0 -59
  309. package/dist/tools/tool-builder/results.d.ts.map +0 -1
  310. package/dist/tools/tool-builder/results.js +0 -125
  311. package/dist/tools/tool-builder/results.js.map +0 -1
  312. package/dist/tools/tool-builder/types.d.ts +0 -82
  313. package/dist/tools/tool-builder/types.d.ts.map +0 -1
  314. package/dist/tools/tool-builder/types.js +0 -9
  315. package/dist/tools/tool-builder/types.js.map +0 -1
  316. package/dist/tools/tool-builder.d.ts +0 -16
  317. package/dist/tools/tool-builder.d.ts.map +0 -1
  318. package/dist/tools/tool-builder.js +0 -16
  319. package/dist/tools/tool-builder.js.map +0 -1
@@ -1 +0,0 @@
1
- {"version":3,"file":"advanced-tool.d.ts","sourceRoot":"","sources":["../../src/gateway/advanced-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,0BAA0B,CAAC"}
@@ -1,13 +0,0 @@
1
- /**
2
- * Backward-compat shim for `gateway/advanced-tool.ts`.
3
- *
4
- * The original 283-LoC module was split into `gateway/advanced-tool/`
5
- * (4 files, each ≤ 100 LoC) per Architecture §11 cap (Round-2
6
- * R2-A2-CRIT2 audit fix). This shim preserves the public import path
7
- * (`from '../gateway/advanced-tool.js'`) so server.ts, src/index.ts,
8
- * and the test suite keep working unchanged.
9
- *
10
- * @license MIT
11
- */
12
- export * from './advanced-tool/index.js';
13
- //# sourceMappingURL=advanced-tool.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"advanced-tool.js","sourceRoot":"","sources":["../../src/gateway/advanced-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,0BAA0B,CAAC"}
@@ -1,117 +0,0 @@
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
@@ -1 +0,0 @@
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"}
@@ -1,103 +0,0 @@
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
@@ -1 +0,0 @@
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"}
@@ -1,49 +0,0 @@
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"];
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
@@ -1 +0,0 @@
1
- {"version":3,"file":"essentials.d.ts","sourceRoot":"","sources":["../../src/gateway/essentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,2fAyBlB,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"}
@@ -1,79 +0,0 @@
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 13 L1 + 2 L3 +
50
- // 1 gateway = 16, 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
- ];
60
- /**
61
- * L3 — Tools registered DIRECTLY on the real McpServer, BEFORE the
62
- * CapturingServer wraps it. The CapturingServer treats these names as a
63
- * no-op (no forward, no capture) so the SDK never sees a duplicate
64
- * registration. Use this lane only for tools that must be reachable
65
- * even if the gateway itself fails — currently health + diagnose.
66
- */
67
- export const DIRECT_TOP_LEVEL_TOOLS = [
68
- 'yootheme_builder_health',
69
- 'yootheme_builder_diagnose',
70
- ];
71
- /** True if `name` is in the L1 forwarded essentials surface. */
72
- export function isEssential(name) {
73
- return ESSENTIAL_TOOLS.includes(name);
74
- }
75
- /** True if `name` is in the L3 direct top-level surface. */
76
- export function isDirectTopLevel(name) {
77
- return DIRECT_TOP_LEVEL_TOOLS.includes(name);
78
- }
79
- //# sourceMappingURL=essentials.js.map
@@ -1 +0,0 @@
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;CAC7B,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"}
@@ -1,41 +0,0 @@
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
@@ -1 +0,0 @@
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"}
@@ -1,60 +0,0 @@
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
@@ -1 +0,0 @@
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"}
package/dist/index.d.ts DELETED
@@ -1,25 +0,0 @@
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, isTestMode, ENV_WP_URL, ENV_BEARER, ENV_TEST_MODE } from './auth.js';
17
- export { ConfigError, RestError, NetworkError } from './errors.js';
18
- export { buildAllTools } from './tools/index.js';
19
- export { ESSENTIAL_TOOLS, DIRECT_TOP_LEVEL_TOOLS, isEssential, isDirectTopLevel, } from './gateway/essentials.js';
20
- export { CapturingServer, type AdvancedToolEntry, type CapturedToolHandler, type ToolRegistrar, } from './gateway/capturing-server.js';
21
- export { registerAdvancedTool } from './gateway/advanced-tool.js';
22
- export { collectAllRegisteredTools, findTool, type CollectedTool, } from './gateway/test-support.js';
23
- declare function main(): Promise<void>;
24
- export { main };
25
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,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,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1F,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,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,CAsCnC;AAkBD,OAAO,EAAE,IAAI,EAAE,CAAC"}
package/dist/index.js DELETED
@@ -1,77 +0,0 @@
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 } from './auth.js';
16
- import { RestClient } from './client.js';
17
- import { ConfigError } from './errors.js';
18
- import { createServer } from './server.js';
19
- export { createServer, SERVER_NAME, SERVER_VERSION } from './server.js';
20
- export { RestClient, REST_NAMESPACE_PATH, encodeElementPath } from './client.js';
21
- export { loadConfig, isTestMode, ENV_WP_URL, ENV_BEARER, ENV_TEST_MODE } from './auth.js';
22
- export { ConfigError, RestError, NetworkError } from './errors.js';
23
- export { buildAllTools } from './tools/index.js';
24
- export { ESSENTIAL_TOOLS, DIRECT_TOP_LEVEL_TOOLS, isEssential, isDirectTopLevel, } from './gateway/essentials.js';
25
- export { CapturingServer, } from './gateway/capturing-server.js';
26
- export { registerAdvancedTool } from './gateway/advanced-tool.js';
27
- export { collectAllRegisteredTools, findTool, } from './gateway/test-support.js';
28
- async function main() {
29
- const testMode = isTestMode();
30
- let config;
31
- try {
32
- // In test mode, allow the bearer token to be missing — we exit before
33
- // anyone calls a tool.
34
- config = loadConfig({ allowMissingToken: testMode });
35
- }
36
- catch (e) {
37
- if (e instanceof ConfigError) {
38
- process.stderr.write(`[yt-builder-mcp] ${e.message}\n`);
39
- process.exit(1);
40
- }
41
- throw e;
42
- }
43
- const client = new RestClient({
44
- baseUrl: config.baseUrl,
45
- bearerToken: config.bearerToken,
46
- timeoutMs: config.timeoutMs,
47
- });
48
- const { mcp, tools } = createServer({ client });
49
- if (testMode) {
50
- // Print a one-line per tool summary to stderr (stdout is reserved
51
- // for the JSON-RPC frame in real runs) and exit cleanly.
52
- process.stderr.write(`[yt-builder-mcp] test mode — ${String(tools.length)} tools registered:\n`);
53
- for (const tool of tools) {
54
- process.stderr.write(` - ${tool.name}\n`);
55
- }
56
- process.exit(0);
57
- }
58
- const transport = new StdioServerTransport();
59
- await mcp.connect(transport);
60
- }
61
- /**
62
- * Auto-run unless explicitly disabled. Tests set `YTB_MCP_NO_AUTORUN=1`
63
- * to import the module without firing up the stdio server.
64
- *
65
- * The bin dispatcher (`bin/yt-builder-mcp.js`) imports
66
- * `dist/index.js` dynamically and expects `main()` to take over — so by
67
- * default we run on import.
68
- */
69
- if (process.env.YTB_MCP_NO_AUTORUN !== '1') {
70
- main().catch((e) => {
71
- const message = e instanceof Error ? e.message : String(e);
72
- process.stderr.write(`[yt-builder-mcp] fatal: ${message}\n`);
73
- process.exit(1);
74
- });
75
- }
76
- export { main };
77
- //# sourceMappingURL=index.js.map
package/dist/index.js.map DELETED
@@ -1 +0,0 @@
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,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,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,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1F,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,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,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACD,sEAAsE;QACtE,uBAAuB;QACvB,MAAM,GAAG,UAAU,CAAC,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,IAAI,CAAC,YAAY,WAAW,EAAE,CAAC;YAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;QACD,MAAM,CAAC,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;KAC9B,CAAC,CAAC;IAEH,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAEhD,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"}