@wootsup/yt-builder-mcp 1.12.0 → 2.1.0

package/dist/gateway/capturing-server.d.ts

@@ -1,52 +1,8 @@
-/**
- * CapturingServer — registration interceptor wrapping a real McpServer.
- *
- * Tool routing (Wave G.1 / Design-Doc §3.1.1):
- *   - L3 direct (yootheme_builder_health, yootheme_builder_diagnose):
- *     skipped — no forward, no capture. These tools must already be
- *     registered directly on the real server BEFORE the CapturingServer
- *     wraps it, so the SDK never sees a duplicate name.
- *   - L1 essential (ESSENTIAL_TOOLS): forwarded to the real server as a
- *     first-class MCP tool reachable from `tools/list`.
- *   - L2 advanced (everything else): captured into the in-process
- *     advanced registry, reachable through the single
- *     `yootheme_builder_advanced` gateway tool.
- *
- * This is a typed wrapper, NOT a JS Proxy — TypeScript stays strict.
- *
- * Typing approach (mirrors the reference apimapper-mcp implementation):
- *   `ToolRegistrar` is the McpServer subsurface modules consume:
- *   `registerTool` + `registerResource`. `registerTool` is a hand-written
- *   generic mirroring the SDK signature EXCEPT its return type is `void`
- *   — captured tools have no live `RegisteredTool`, and no module reads
- *   the return value. A real `McpServer` is still assignable to
- *   `ToolRegistrar` (return-type bivariance for `void`), so every
- *   call-site accepts both shapes cast-free.
- *
- * Casts in this file (each documented + justified inline):
- *   1. forwarded-essential — erases the handler's `InputArgs` generic to
- *      the SDK default when `config` is the erased `CapturedToolConfig`.
- *   2. registry storage — erases the generic handler to the homogeneous
- *      `CapturedToolHandler` shape so one Map type fits all entries.
- *   3. `registerResource` field — the SDK declares two overloads; a
- *      single spread-arg arrow cannot re-express the pair.
- *
- * @license MIT
- */
 import type { McpServer, ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { AnySchema, ZodRawShapeCompat } from '@modelcontextprotocol/sdk/server/zod-compat.js';
 import type { CallToolResult, ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
-/**
- * The input-schema constraint the SDK's `registerTool` accepts — a raw Zod
- * shape, a Zod schema, or `undefined` (zero-arg tools). Reused so the
- * `ToolRegistrar.registerTool` generic stays in lockstep with `ToolCallback`.
- */
 type ToolInputArgs = undefined | ZodRawShapeCompat | AnySchema;
-/**
- * The config object accepted by `registerTool` — mirrors the SDK's 2nd arg.
- * `inputSchema` is generic so per-tool handler args stay strongly inferred.
- */
-interface RegisterToolConfig<InputArgs extends ToolInputArgs> {
+export interface RegisterToolConfig<InputArgs extends ToolInputArgs> {
     title?: string;
     description?: string;
     inputSchema?: InputArgs;
@@ -54,63 +10,22 @@ interface RegisterToolConfig<InputArgs extends ToolInputArgs> {
     annotations?: ToolAnnotations;
     _meta?: Record<string, unknown>;
 }
-/**
- * The McpServer subsurface our `registerXTools` builders consume.
- *
- * `registerTool` is a hand-written generic mirroring the SDK signature with a
- * `void` return type. A real `McpServer` (whose method returns
- * `RegisteredTool`) is still assignable here because a value-returning method
- * satisfies a `void`-returning member. The `InputArgs` generic preserves
- * per-tool `ToolCallback` argument inference at every call-site.
- */
 export interface ToolRegistrar {
     registerTool<InputArgs extends ToolInputArgs = undefined>(name: string, config: RegisterToolConfig<InputArgs>, cb: ToolCallback<InputArgs>): void;
     registerResource: McpServer['registerResource'];
 }
-/** Config object passed to `registerTool` (the SDK's 2nd arg). */
-export type CapturedToolConfig = Parameters<McpServer['registerTool']>[1];
-/**
- * Captured-handler shape. The SDK's `registerTool` is generic over the input
- * shape, so a captured handler is stored with its args erased to
- * `Record<string, unknown>`. The gateway validates `arguments` against the
- * tool's Zod schema before calling the handler, so the runtime contract holds.
- */
+export type CapturedToolConfig = RegisterToolConfig<ToolInputArgs>;
 export type CapturedToolHandler = (args: Record<string, unknown>, extra: unknown) => CallToolResult | Promise<CallToolResult>;
-/** A captured advanced tool: its registration config and its handler. */
 export interface AdvancedToolEntry {
     config: CapturedToolConfig;
     handler: CapturedToolHandler;
 }
-/**
- * Wraps a real McpServer. Forwards L1 essentials (and all resources) to it,
- * captures L2 non-essentials into an in-process registry, and silently
- * skips L3 direct top-level names that must already be on the real server.
- */
 export declare class CapturingServer implements ToolRegistrar {
     private readonly realServer;
     private readonly advancedRegistry;
     constructor(realServer: McpServer);
-    /**
-     * Routes a tool registration by name. Returns `void`: captured tools
-     * have no `RegisteredTool` and no `registerXTools` module reads the
-     * return value.
-     *
-     * Routing order matters: the L3-direct check is FIRST so a caller
-     * cannot accidentally re-route a direct-registered name through the
-     * gateway just by re-naming a future tool builder.
-     */
-    registerTool<InputArgs extends ToolInputArgs = undefined>(name: string, config: CapturedToolConfig, handler: ToolCallback<InputArgs>): void;
-    /**
-     * Resources are always forwarded — they are not part of the tool cap.
-     *
-     * Cast: the SDK declares `registerResource` as two overloads; a single
-     * spread `(...args: RegisterResourceArgs)` arrow cannot re-express that
-     * overload pair, so the field is asserted to the SDK's exact member
-     * type. The spread forwards every argument verbatim, so the runtime
-     * contract is unchanged.
-     */
+    registerTool<InputArgs extends ToolInputArgs = undefined>(name: string, config: RegisterToolConfig<InputArgs>, handler: ToolCallback<InputArgs>): void;
     registerResource: McpServer['registerResource'];
-    /** The captured non-essential tools, keyed by tool name. */
     getAdvancedRegistry(): Map<string, AdvancedToolEntry>;
 }
 export {};

package/dist/gateway/capturing-server.d.ts.map

@@ -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"}
+{"version":3,"file":"capturing-server.d.ts","sourceRoot":"","sources":["../../src/gateway/capturing-server.ts"],"names":[],"mappings":"AAqCA,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;AAS1F,KAAK,aAAa,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAM/D,MAAM,WAAW,kBAAkB,CAAC,SAAS,SAAS,aAAa;IAC/D,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;AAWD,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;AAkBD,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;AAUnE,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;AAG9C,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,mBAAmB,CAAC;CAChC;AAOD,qBAAa,eAAgB,YAAW,aAAa;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAwC;gBAE7D,UAAU,EAAE,SAAS;IAuBjC,YAAY,CAAC,SAAS,SAAS,aAAa,GAAG,SAAS,EACpD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,kBAAkB,CAAC,SAAS,CAAC,EACrC,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,GACjC,IAAI;IAgDP,gBAAgB,EAAE,SAAS,CAAC,kBAAkB,CAAC,CACiC;IAGhF,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC;CAGxD"}

package/dist/gateway/capturing-server.js

@@ -1,101 +1,24 @@
-/**
- * CapturingServer — registration interceptor wrapping a real McpServer.
- *
- * Tool routing (Wave G.1 / Design-Doc §3.1.1):
- *   - L3 direct (yootheme_builder_health, yootheme_builder_diagnose):
- *     skipped — no forward, no capture. These tools must already be
- *     registered directly on the real server BEFORE the CapturingServer
- *     wraps it, so the SDK never sees a duplicate name.
- *   - L1 essential (ESSENTIAL_TOOLS): forwarded to the real server as a
- *     first-class MCP tool reachable from `tools/list`.
- *   - L2 advanced (everything else): captured into the in-process
- *     advanced registry, reachable through the single
- *     `yootheme_builder_advanced` gateway tool.
- *
- * This is a typed wrapper, NOT a JS Proxy — TypeScript stays strict.
- *
- * Typing approach (mirrors the reference apimapper-mcp implementation):
- *   `ToolRegistrar` is the McpServer subsurface modules consume:
- *   `registerTool` + `registerResource`. `registerTool` is a hand-written
- *   generic mirroring the SDK signature EXCEPT its return type is `void`
- *   — captured tools have no live `RegisteredTool`, and no module reads
- *   the return value. A real `McpServer` is still assignable to
- *   `ToolRegistrar` (return-type bivariance for `void`), so every
- *   call-site accepts both shapes cast-free.
- *
- * Casts in this file (each documented + justified inline):
- *   1. forwarded-essential — erases the handler's `InputArgs` generic to
- *      the SDK default when `config` is the erased `CapturedToolConfig`.
- *   2. registry storage — erases the generic handler to the homogeneous
- *      `CapturedToolHandler` shape so one Map type fits all entries.
- *   3. `registerResource` field — the SDK declares two overloads; a
- *      single spread-arg arrow cannot re-express the pair.
- *
- * @license MIT
- */
 import { isDirectTopLevel, isEssential } from './essentials.js';
-/**
- * Wraps a real McpServer. Forwards L1 essentials (and all resources) to it,
- * captures L2 non-essentials into an in-process registry, and silently
- * skips L3 direct top-level names that must already be on the real server.
- */
 export class CapturingServer {
     realServer;
     advancedRegistry = new Map();
     constructor(realServer) {
         this.realServer = realServer;
     }
-    /**
-     * Routes a tool registration by name. Returns `void`: captured tools
-     * have no `RegisteredTool` and no `registerXTools` module reads the
-     * return value.
-     *
-     * Routing order matters: the L3-direct check is FIRST so a caller
-     * cannot accidentally re-route a direct-registered name through the
-     * gateway just by re-naming a future tool builder.
-     */
     registerTool(name, config, handler) {
-        // L3 — direct top-level: already on the real server, do nothing.
-        // Returning early here prevents the SDK from raising a duplicate-name
-        // error when an L3 tool's builder is accidentally re-included in the
-        // forwarded tool list.
         if (isDirectTopLevel(name)) {
             return;
         }
         if (isEssential(name)) {
-            // L1 — forward to the real server.
-            //
-            // Cast: the SDK pairs `config.inputSchema` and the handler through
-            // one `InputArgs` generic. Here `config` is the erased
-            // `CapturedToolConfig`, so the SDK cannot re-infer that link; the
-            // handler is asserted to the SDK's default `ToolCallback` to satisfy
-            // the call. The runtime values are exactly what the SDK expects —
-            // only the static generic linkage is erased.
             this.realServer.registerTool(name, config, handler);
             return;
         }
-        // L2 — capture into the advanced registry.
-        //
-        // Erase the generic handler to the captured-handler shape for
-        // homogeneous Map storage. The gateway validates `arguments` against
-        // the tool's Zod schema before invoking it, so the (args, extra)
-        // runtime contract holds.
         this.advancedRegistry.set(name, {
             config,
             handler: handler,
         });
     }
-    /**
-     * Resources are always forwarded — they are not part of the tool cap.
-     *
-     * Cast: the SDK declares `registerResource` as two overloads; a single
-     * spread `(...args: RegisterResourceArgs)` arrow cannot re-express that
-     * overload pair, so the field is asserted to the SDK's exact member
-     * type. The spread forwards every argument verbatim, so the runtime
-     * contract is unchanged.
-     */
     registerResource = ((...args) => this.realServer.registerResource(...args));
-    /** The captured non-essential tools, keyed by tool name. */
     getAdvancedRegistry() {
         return this.advancedRegistry;
     }

package/dist/gateway/capturing-server.js.map

@@ -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"}
+{"version":3,"file":"capturing-server.js","sourceRoot":"","sources":["../../src/gateway/capturing-server.ts"],"names":[],"mappings":"AAyCA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAkFhE,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;IAqBD,YAAY,CACR,IAAY,EACZ,MAAqC,EACrC,OAAgC;QAMhC,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO;QACX,CAAC;QAED,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YAUpB,IAAI,CAAC,UAAU,CAAC,YAAY,CACxB,IAAI,EACJ,MAA2C,EAC3C,OAAkC,CACrC,CAAC;YACF,OAAO;QACX,CAAC;QAQD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE;YAC5B,MAAM;YACN,OAAO,EAAE,OAAyC;SACrD,CAAC,CAAC;IACP,CAAC;IAWD,gBAAgB,GAAkC,CAAC,CAAC,GAAG,IAA0B,EAAE,EAAE,CACjF,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC,CAAkC,CAAC;IAGhF,mBAAmB;QACf,OAAO,IAAI,CAAC,gBAAgB,CAAC;IACjC,CAAC;CACJ"}

package/dist/gateway/essentials.d.ts

@@ -1,69 +1,7 @@
-/**
- * Gateway-Hub — single source of truth for the YT Builder MCP
- * 3-lane registration surface.
- *
- * Lanes (Wave G.1 / Design-Doc §3.1.1):
- *   L1 — ESSENTIAL_TOOLS         forwarded by the CapturingServer as
- *                                 first-class MCP tools in `tools/list`.
- *   L2 — (advanced)              every NON-essential, NON-direct tool is
- *                                 captured by the CapturingServer and
- *                                 reachable through the single
- *                                 `yootheme_builder_advanced` gateway tool.
- *   L3 — DIRECT_TOP_LEVEL_TOOLS  registered directly on the real McpServer
- *                                 BEFORE the CapturingServer wraps it.
- *                                 The CapturingServer skips these names
- *                                 entirely (no forward, no capture) so the
- *                                 SDK never sees a duplicate registration.
- *
- * Why this split: Cursor caps MCP servers at ~40 tools. The 3-lane shape
- * keeps `tools/list` at 32 (L1) + 2 (L3) + 2 (gateways) = 36 entries, well
- * under the cap, while every tool stays fully reachable (advanced tools
- * through `yootheme_builder_advanced` / `yootheme_builder_advanced_read`).
- * B4 (2026-06-27): element_get_binding promoted L2 → L1 (binding-read made
- * first-class, mirroring the already-L1 element_bind_source write). L1 26 → 27.
- * U4-L1 (customer onboarding, 2026-06-27): source_get_schema promoted L2 → L1
- * (the archive/category binding entry-point made first-class, mirroring how the
- * bind→verify tools are already L1). L1 27 → 28.
- * HANDOFF-4/5 L1 (customer onboarding, 2026-06-28): render_preview,
- * element_set_source, rename_source, template_set_type promoted L2 → L1 — the
- * core write/refactor + render-verify tools the customer HANDOFF-4/5 ask for,
- * made first-class so a cold agent can discover them in tools/list (L2 was a
- * discoverability workaround). L1 28 → 32, advanced 9 → 5.
- *
- * F116 (2026-06-11): the bind→save→publish chain (element_bind_source,
- * page_save, page_publish) was promoted from the advanced lane to L1. It is
- * the #1 dynamic-content workflow; hiding it behind the gateway made an agent
- * listing tools see element_add but neither bind nor publish — a likely
- * "can't publish" deadend. L1 20→23, advanced 7→4.
- *
- * P-G (Goldstandard wave 3): page_dynamize was added as a new registered tool
- * and promoted to L1 (the one-call dynamize-existing-section path). With the
- * F116 trio it brings L1 to 24, advanced stays 4, surface to 27.
- *
- * Health + diagnose live in L3 because they MUST be the first thing an
- * LLM-host calls when something is broken; routing them through a gateway
- * would create a chicken-and-egg loop (the LLM would have to discover
- * the gateway before it can diagnose why the gateway is unreachable).
- *
- * @license MIT
- */
-/**
- * L1 — Tools kept as first-class entries in `tools/list`.
- * Forwarded by the CapturingServer to the real McpServer.
- */
-export declare const ESSENTIAL_TOOLS: readonly ["yootheme_builder_pages_list", "yootheme_builder_pages_resolve", "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", "yootheme_builder_use_site", "yootheme_builder_pages_create", "yootheme_builder_pages_delete", "yootheme_builder_element_bind_source", "yootheme_builder_page_save", "yootheme_builder_page_publish", "yootheme_builder_element_get_binding", "yootheme_builder_page_dynamize", "yootheme_builder_scaffold_section", "yootheme_builder_source_get_schema", "yootheme_builder_render_preview", "yootheme_builder_element_set_source", "yootheme_builder_rename_source", "yootheme_builder_template_set_type", "yootheme_builder_library_browse", "yootheme_builder_library_get", "yootheme_builder_library_insert", "yootheme_builder_image_search", "yootheme_builder_image_import", "yootheme_builder_element_set_status"];
-/**
- * L3 — Tools registered DIRECTLY on the real McpServer, BEFORE the
- * CapturingServer wraps it. The CapturingServer treats these names as a
- * no-op (no forward, no capture) so the SDK never sees a duplicate
- * registration. Use this lane only for tools that must be reachable
- * even if the gateway itself fails — currently health + diagnose.
- */
+export declare const ESSENTIAL_TOOLS: readonly ["yootheme_builder_pages_list", "yootheme_builder_pages_resolve", "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", "yootheme_builder_use_site", "yootheme_builder_pages_create", "yootheme_builder_pages_delete", "yootheme_builder_pages_set_status", "yootheme_builder_element_bind_source", "yootheme_builder_page_save", "yootheme_builder_page_publish", "yootheme_builder_element_get_binding", "yootheme_builder_page_generate_dynamic", "yootheme_builder_scaffold_section", "yootheme_builder_source_get_schema", "yootheme_builder_render_preview", "yootheme_builder_element_set_source", "yootheme_builder_repair_source_references", "yootheme_builder_template_set_type", "yootheme_builder_library_browse", "yootheme_builder_library_get", "yootheme_builder_library_insert", "yootheme_builder_image_search", "yootheme_builder_image_import", "yootheme_builder_element_set_status", "yootheme_builder_get_skill", "yootheme_builder_modules_delete", "yootheme_builder_sites_overview", "yootheme_builder_element_unbind_source", "yootheme_builder_fetch_public_url", "yootheme_builder_pages_restore"];
 export declare const DIRECT_TOP_LEVEL_TOOLS: readonly ["yootheme_builder_health", "yootheme_builder_diagnose"];
 export type EssentialTool = (typeof ESSENTIAL_TOOLS)[number];
 export type DirectTopLevelTool = (typeof DIRECT_TOP_LEVEL_TOOLS)[number];
-/** True if `name` is in the L1 forwarded essentials surface. */
 export declare function isEssential(name: string): boolean;
-/** True if `name` is in the L3 direct top-level surface. */
 export declare function isDirectTopLevel(name: string): boolean;
 //# sourceMappingURL=essentials.d.ts.map

package/dist/gateway/essentials.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"essentials.d.ts","sourceRoot":"","sources":["../../src/gateway/essentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,m0CAyJlB,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"}
+{"version":3,"file":"essentials.d.ts","sourceRoot":"","sources":["../../src/gateway/essentials.ts"],"names":[],"mappings":"AA6DA,eAAO,MAAM,eAAe,glDAuNlB,CAAC;AASX,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;AAGzE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAGD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/gateway/essentials.js

@@ -1,62 +1,5 @@
-/**
- * Gateway-Hub — single source of truth for the YT Builder MCP
- * 3-lane registration surface.
- *
- * Lanes (Wave G.1 / Design-Doc §3.1.1):
- *   L1 — ESSENTIAL_TOOLS         forwarded by the CapturingServer as
- *                                 first-class MCP tools in `tools/list`.
- *   L2 — (advanced)              every NON-essential, NON-direct tool is
- *                                 captured by the CapturingServer and
- *                                 reachable through the single
- *                                 `yootheme_builder_advanced` gateway tool.
- *   L3 — DIRECT_TOP_LEVEL_TOOLS  registered directly on the real McpServer
- *                                 BEFORE the CapturingServer wraps it.
- *                                 The CapturingServer skips these names
- *                                 entirely (no forward, no capture) so the
- *                                 SDK never sees a duplicate registration.
- *
- * Why this split: Cursor caps MCP servers at ~40 tools. The 3-lane shape
- * keeps `tools/list` at 32 (L1) + 2 (L3) + 2 (gateways) = 36 entries, well
- * under the cap, while every tool stays fully reachable (advanced tools
- * through `yootheme_builder_advanced` / `yootheme_builder_advanced_read`).
- * B4 (2026-06-27): element_get_binding promoted L2 → L1 (binding-read made
- * first-class, mirroring the already-L1 element_bind_source write). L1 26 → 27.
- * U4-L1 (customer onboarding, 2026-06-27): source_get_schema promoted L2 → L1
- * (the archive/category binding entry-point made first-class, mirroring how the
- * bind→verify tools are already L1). L1 27 → 28.
- * HANDOFF-4/5 L1 (customer onboarding, 2026-06-28): render_preview,
- * element_set_source, rename_source, template_set_type promoted L2 → L1 — the
- * core write/refactor + render-verify tools the customer HANDOFF-4/5 ask for,
- * made first-class so a cold agent can discover them in tools/list (L2 was a
- * discoverability workaround). L1 28 → 32, advanced 9 → 5.
- *
- * F116 (2026-06-11): the bind→save→publish chain (element_bind_source,
- * page_save, page_publish) was promoted from the advanced lane to L1. It is
- * the #1 dynamic-content workflow; hiding it behind the gateway made an agent
- * listing tools see element_add but neither bind nor publish — a likely
- * "can't publish" deadend. L1 20→23, advanced 7→4.
- *
- * P-G (Goldstandard wave 3): page_dynamize was added as a new registered tool
- * and promoted to L1 (the one-call dynamize-existing-section path). With the
- * F116 trio it brings L1 to 24, advanced stays 4, surface to 27.
- *
- * Health + diagnose live in L3 because they MUST be the first thing an
- * LLM-host calls when something is broken; routing them through a gateway
- * would create a chicken-and-egg loop (the LLM would have to discover
- * the gateway before it can diagnose why the gateway is unreachable).
- *
- * @license MIT
- */
-/**
- * L1 — Tools kept as first-class entries in `tools/list`.
- * Forwarded by the CapturingServer to the real McpServer.
- */
 export const ESSENTIAL_TOOLS = [
     'yootheme_builder_pages_list',
-    // G-A (Track-C URL→layout): pages_resolve is THE core "paste a URL →
-    // reach a layout in ≤1 MCP call" tool. It MUST be L1 so a cold agent
-    // handed only a frontend URL reaches it directly (the gap fix would be
-    // moot if it were hidden behind the advanced gateway). L1 25 → 26.
     'yootheme_builder_pages_resolve',
     'yootheme_builder_get_etag',
     'yootheme_builder_element_list',
@@ -64,163 +7,51 @@ export const ESSENTIAL_TOOLS = [
     'yootheme_builder_element_update_settings',
     'yootheme_builder_sources_list',
     'yootheme_builder_element_types_list',
-    // Multi-Items inspector — L1 discovery tool. Surfaces when a
-    // binding lives on the wrong (container) level and which `*_item`
-    // child should carry it. Frequent first-call when diagnosing
-    // Grid/Slider/Switcher rendering issues.
     'yootheme_builder_inspect_multi_items_binding',
-    // F-16 hot-path promotions (Maria-Audit v2 re-confirmed) — the 5
-    // most-used read/mutate operations skip the advanced-router
-    // discovery roundtrip. Cursor cap is ~40; with the W7 sites_list +
-    // sites_test additions (plus later C4, config-harmonization, the
-    // F116 bind→save→publish promotion and the P-G page_dynamize tool) we
-    // sit at 24 L1 + 2 L3 + 1 gateway = 27, comfortable below the limit.
     'yootheme_builder_element_get',
     'yootheme_builder_element_delete',
     'yootheme_builder_element_clone',
     'yootheme_builder_element_move',
     'yootheme_builder_page_get_layout',
-    // T9 (Audit-v3 B.5) — token-efficient template overview. L1 because
-    // it's the recommended first call when orienting in a large template.
     'yootheme_builder_template_summary',
-    // 1.0.1 — element_type_get_schema promoted L2 → L1. Live-testing
-    // 1.0.0 in Claude Desktop showed tool_search couldn't surface it
-    // through the advanced gateway, yet it is the canonical prop-key
-    // discovery tool an agent needs BEFORE every element_add or
-    // element_update_settings. Hot-path for any write workflow.
     'yootheme_builder_element_type_get_schema',
-    // W7 (Multi-Site) — sites_list + sites_test must be L1 so an agent
-    // that just connected to a fresh MCP server can answer "which sites
-    // am I configured against?" without first discovering the gateway.
-    // Both are platform-agnostic (sites_list reads the registry only,
-    // sites_test probes /health + /etag for ONE site). L1 surface 15 → 17.
     'yootheme_builder_sites_list',
     'yootheme_builder_sites_test',
-    // Phase 3 (config harmonization) — use_site is the runtime active-
-    // site SWITCH (mirrors api-mapper's apimapper_use_profile). It must
-    // be L1 so an agent can discover + call it directly the same way it
-    // reaches sites_list, instead of routing through the advanced
-    // gateway. L1 surface 19 → 20.
     'yootheme_builder_use_site',
-    // C4 (v1.2) — pages_create + pages_delete are first-class customer-
-    // facing page-level mutations (POST /pages, DELETE /pages/{id}).
-    // Both must be discoverable directly in tools/list, not behind the
-    // advanced-gateway router — they're high-frequency mutations agents
-    // reach for whenever the user says "create a new page" or "delete
-    // this page". L1 surface 17 → 19.
     'yootheme_builder_pages_create',
     'yootheme_builder_pages_delete',
-    // F116 (2026-06-11) — the bind→save→publish chain. element_bind_source is the
-    // #1 dynamic-content operation (wire a published source field onto an
-    // element); page_save + page_publish persist + go live. All three were
-    // advanced-lane only, so an agent listing tools saw element_add but
-    // neither bind nor publish — a likely "can't publish" deadend and a
-    // 2-call discovery tax (find the gateway, then route). Promoting them to
-    // L1 makes the canonical dynamic-content workflow first-class and
-    // directly callable. L1 surface 20 → 23.
+    'yootheme_builder_pages_set_status',
     'yootheme_builder_element_bind_source',
     'yootheme_builder_page_save',
     'yootheme_builder_page_publish',
-    // B4 (customer onboarding, 2026-06-27) — promote the binding READ to L1,
-    // mirroring its already-L1 WRITE sibling element_bind_source (F116). The
-    // READ stayed behind the advanced(-read) gateway: an agent that had just
-    // bound a relation traversal could not directly confirm query.field /
-    // arguments without first discovering the gateway — a 2-call discovery tax
-    // on the verify half of the bind→verify loop. Making binding-read
-    // first-class closes the asymmetry. This is a tier-LIST move (the catalog
-    // tool already exists); sync-catalog re-run flips its tier to essential.
-    // L1 surface 26 → 27.
     'yootheme_builder_element_get_binding',
-    // P-G (Goldstandard wave 3) — page_dynamize is THE canonical one-call
-    // path to dynamize an existing designed section (copy byte-identically,
-    // swap only mapped queries + leaf names). It MUST be L1 so an agent
-    // reaches it directly INSTEAD of discovering it through the advanced
-    // gateway and then hand-editing layout JSON (the failure mode the
-    // recipe-as-code exists to prevent). With the F116 trio L1 23 → 24.
-    'yootheme_builder_page_dynamize',
-    // WF2 Option C (2026-06-13) — scaffold_section is the positive-steering
-    // counterpart to the structural-hierarchy guard: it creates a VALID
-    // section → row → column hull in ONE atomic call and returns the column
-    // pointer(s) to drop content into. It MUST be L1 so an agent reaches it
-    // directly INSTEAD of hand-building (and tripping the guard on) an
-    // invalid root/section/row placement. With the prior set L1 24 → 25.
+    'yootheme_builder_page_generate_dynamic',
     'yootheme_builder_scaffold_section',
-    // U4-L1 (customer onboarding, 2026-06-27) — promote source_get_schema to L1.
-    // It is THE one-call entry-point for binding on an archive/category template
-    // (introspect a source's query methods + RELATIONS + the archive-context
-    // flag — turning a ~25-call code-dive into one). It stayed behind the
-    // advanced(-read) gateway, so a cold agent orienting toward a Term→Posts
-    // bind had to discover the gateway first — a 2-call discovery tax on the
-    // very first call of the canonical archive-binding workflow, whose write
-    // sibling element_bind_source is already L1 (F116). Making source-schema
-    // discovery first-class closes that asymmetry. This is a tier-LIST move
-    // (the catalog tool already exists); sync-catalog re-run flips its tier to
-    // essential. L1 surface 27 → 28.
     'yootheme_builder_source_get_schema',
-    // HANDOFF-4/5 L1 (customer onboarding, 2026-06-28) — promote the four core
-    // write/refactor + render-verify tools the customer HANDOFF-4/5 explicitly
-    // ask for to L1. They were registered + reachable only via the advanced
-    // (-read) gateway, so a cold agent could not DISCOVER them in tools/list —
-    // L2 was a discoverability workaround, not a design choice. These ARE the
-    // canonical archive-rebind/refactor surface (set a precomposed source at a
-    // pointer; render-verify the saved page is not silently blank; rename a
-    // source/field template-wide after a taxonomy/CPT rename; re-type an
-    // orphaned archive/single template). Each is a tier-LIST move (the catalog
-    // tools already exist); sync-catalog re-run flips their tier to essential.
-    // L1 surface 28 → 32.
     'yootheme_builder_render_preview',
     'yootheme_builder_element_set_source',
-    'yootheme_builder_rename_source',
+    'yootheme_builder_repair_source_references',
     'yootheme_builder_template_set_type',
-    // Task 2 (Layout Library, Spec #2, 2026-07-12) — library_browse is the
-    // discovery entry-point for the Layout Library feature (browse
-    // pre-designed layouts / element presets before hand-building a
-    // section). Made L1 immediately (not staged through L2 first) so a
-    // cold agent can discover it in tools/list, mirroring how
-    // sources_list / element_types_list — the other catalogue-discovery
-    // tools — are L1. L1 32 → 33.
     'yootheme_builder_library_browse',
-    // Task 3 (Layout Library, Spec #3, 2026-07-12) — library_get fetches a
-    // single layout/preset's tree + section list, the natural next call
-    // after library_browse. Made L1 immediately for the same
-    // cold-agent-discoverability reason as library_browse. L1 33 → 34.
     'yootheme_builder_library_get',
-    // Task 6 (Layout Library, Spec #6, 2026-07-12) — library_insert composes +
-    // persists a browsed/fetched item (layout/section/preset) onto a page or
-    // existing template via the REAL hardened write chain — the natural next
-    // call after library_browse/library_get. Made L1 immediately for the same
-    // cold-agent-discoverability reason. L1 34 → 35.
     'yootheme_builder_library_insert',
-    // Task D1 (Image Sourcing, 2026-07-13) — image_search + image_import let
-    // a cold agent fill layout image slots with REAL, on-topic photography
-    // (Unsplash/Pexels) or YOOtheme Pro curated decorative assets instead of
-    // bare placeholders — the "nackt → rich" gap. Made L1 immediately,
-    // mirroring library_browse/get/insert's cold-agent-discoverability
-    // rationale (not staged through L2 first). L1 35 → 37.
     'yootheme_builder_image_search',
     'yootheme_builder_image_import',
-    // T-D1 (mega-push plan 2026-07-24-02) — element_set_status is a NEW write
-    // tool (node-level enable/disable), made L1 immediately, mirroring the
-    // other four element write tools (add/update_settings/delete/clone/move),
-    // all of which are already essential. L1 37 → 38.
     'yootheme_builder_element_set_status',
+    'yootheme_builder_get_skill',
+    'yootheme_builder_modules_delete',
+    'yootheme_builder_sites_overview',
+    'yootheme_builder_element_unbind_source',
+    'yootheme_builder_fetch_public_url',
+    'yootheme_builder_pages_restore',
 ];
-/**
- * L3 — Tools registered DIRECTLY on the real McpServer, BEFORE the
- * CapturingServer wraps it. The CapturingServer treats these names as a
- * no-op (no forward, no capture) so the SDK never sees a duplicate
- * registration. Use this lane only for tools that must be reachable
- * even if the gateway itself fails — currently health + diagnose.
- */
 export const DIRECT_TOP_LEVEL_TOOLS = [
     'yootheme_builder_health',
     'yootheme_builder_diagnose',
 ];
-/** True if `name` is in the L1 forwarded essentials surface. */
 export function isEssential(name) {
     return ESSENTIAL_TOOLS.includes(name);
 }
-/** True if `name` is in the L3 direct top-level surface. */
 export function isDirectTopLevel(name) {
     return DIRECT_TOP_LEVEL_TOOLS.includes(name);
 }

package/dist/gateway/essentials.js.map

@@ -1 +1 @@
-{"version":3,"file":"essentials.js","sourceRoot":"","sources":["../../src/gateway/essentials.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"essentials.js","sourceRoot":"","sources":["../../src/gateway/essentials.ts"],"names":[],"mappings":"AA6DA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,6BAA6B;IAK7B,gCAAgC;IAChC,2BAA2B;IAC3B,+BAA+B;IAC/B,8BAA8B;IAC9B,0CAA0C;IAC1C,+BAA+B;IAC/B,qCAAqC;IAKrC,8CAA8C;IAO9C,8BAA8B;IAC9B,iCAAiC;IACjC,gCAAgC;IAChC,+BAA+B;IAC/B,kCAAkC;IAGlC,mCAAmC;IAMnC,0CAA0C;IAM1C,6BAA6B;IAC7B,6BAA6B;IAM7B,2BAA2B;IAO3B,+BAA+B;IAC/B,+BAA+B;IAU/B,mCAAmC;IASnC,sCAAsC;IACtC,4BAA4B;IAC5B,+BAA+B;IAU/B,sCAAsC;IAOtC,wCAAwC;IAOxC,mCAAmC;IAYnC,oCAAoC;IAYpC,iCAAiC;IACjC,qCAAqC;IACrC,2CAA2C;IAC3C,oCAAoC;IAQpC,iCAAiC;IAKjC,8BAA8B;IAM9B,iCAAiC;IAOjC,+BAA+B;IAC/B,+BAA+B;IAK/B,qCAAqC;IAOrC,4BAA4B;IAS5B,iCAAiC;IAMjC,iCAAiC;IAUjC,wCAAwC;IAWxC,mCAAmC;IASnC,gCAAgC;CAC1B,CAAC;AASX,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,yBAAyB;IACzB,2BAA2B;CACrB,CAAC;AAMX,MAAM,UAAU,WAAW,CAAC,IAAY;IACpC,OAAQ,eAAqC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC;AAGD,MAAM,UAAU,gBAAgB,CAAC,IAAY;IACzC,OAAQ,sBAA4C,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxE,CAAC"}

package/dist/gateway/test-support.d.ts

@@ -1,23 +1,6 @@
-/**
- * Gateway test helpers — Wave G.1.
- *
- * After the gateway lands, tests that previously looked tools up from
- * `McpServer._registeredTools` no longer find advanced tools (they're
- * captured in the advanced registry, not on the real server). These
- * helpers expose a unified view across all three lanes:
- *
- *   - L1 essentials   → real server's `_registeredTools`
- *   - L2 advanced     → CapturingServer's `getAdvancedRegistry()`
- *   - L3 + gateway    → real server's `_registeredTools`
- *
- * Test-only: never imported by any runtime path.
- *
- * @license MIT
- */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import type { CapturingServer } from './capturing-server.js';
-/** A tool entry as seen by tests: handler + the registered config. */
 export interface CollectedTool {
     handler: (args: Record<string, unknown>, extra?: unknown) => CallToolResult | Promise<CallToolResult>;
     title?: string;
@@ -25,17 +8,6 @@ export interface CollectedTool {
     inputSchema?: unknown;
     annotations?: Record<string, unknown>;
 }
-/**
- * Returns every tool — essentials + gateway on the real McpServer plus
- * the advanced tools captured by the CapturingServer — keyed by tool
- * name. The CapturingServer must have been used to register the L1/L2
- * tools, and `registerAdvancedTool` must have run, before this is called.
- *
- * Production size = 30 (post-F116):
- *   23 L1 essentials (real server) + 4 L2 advanced (registry)
- *   + 2 L3 direct (real server) + 1 gateway (real server) = 30.
- */
 export declare function collectAllRegisteredTools(server: McpServer, capturing: CapturingServer): Record<string, CollectedTool>;
-/** By-name lookup over a `collectAllRegisteredTools` map. */
 export declare function findTool(tools: Record<string, CollectedTool>, name: string): CollectedTool | undefined;
 //# sourceMappingURL=test-support.d.ts.map

package/dist/gateway/test-support.d.ts.map

@@ -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"}
+{"version":3,"file":"test-support.d.ts","sourceRoot":"","sources":["../../src/gateway/test-support.ts"],"names":[],"mappings":"AAiBA,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;AAG7D,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;AA4BD,wBAAgB,yBAAyB,CACrC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,eAAe,GAC3B,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAuC/B;AAGD,wBAAgB,QAAQ,CACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACpC,IAAI,EAAE,MAAM,GACb,aAAa,GAAG,SAAS,CAE3B"}