@wootsup/yt-builder-mcp 0.2.0-alpha.2

package/dist/gateway/advanced-tool/discovery.js

@@ -0,0 +1,53 @@
+/**
+ * Gateway discovery-mode dispatch — handles `{ tool }`-only invocations
+ * by returning the target tool's description, JSON-schema, and
+ * annotations. Never invokes the target handler.
+ *
+ * Round-2 (R2-A2-CRIT2) extracted from `gateway/advanced-tool.ts`.
+ *
+ * @license MIT
+ */
+import { z } from 'zod';
+/** Reads the captured config's inputSchema as a Zod raw-shape (or empty). */
+export function shapeOf(entry) {
+    const schema = entry.config.inputSchema;
+    if (schema && typeof schema === 'object')
+        return schema;
+    return {};
+}
+/** Builds a JSON-schema for a captured tool's inputs, with a defensive fallback. */
+export function inputSchemaJson(entry) {
+    try {
+        return z.toJSONSchema(z.object(shapeOf(entry)));
+    }
+    catch {
+        // A schema that cannot be JSON-projected still yields a usable
+        // discovery payload — description + annotations carry the rest.
+        return { note: 'input schema could not be derived' };
+    }
+}
+/** Builds the discovery-mode result for a target tool. */
+export function discoveryResult(toolName, entry) {
+    const cfg = entry.config;
+    const schema = inputSchemaJson(entry);
+    const payload = {
+        tool: toolName,
+        description: cfg.description ?? '',
+        inputSchema: schema,
+        annotations: cfg.annotations ?? {},
+    };
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Discovery for ${toolName}\n\n` +
+                    `${cfg.description ?? ''}\n\n` +
+                    `Annotations: ${JSON.stringify(cfg.annotations ?? {})}\n\n` +
+                    `Input schema:\n${JSON.stringify(schema, null, 2)}\n\n` +
+                    `Call yootheme_builder_advanced again with { tool: "${toolName}", arguments: {...} } to run it.`,
+            },
+        ],
+        structuredContent: payload,
+    };
+}
+//# sourceMappingURL=discovery.js.map

package/dist/gateway/advanced-tool/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,CAAC,EAAoB,MAAM,KAAK,CAAC;AAI1C,6EAA6E;AAC7E,MAAM,UAAU,OAAO,CAAC,KAAwB;IAC5C,MAAM,MAAM,GAAI,KAAK,CAAC,MAAoC,CAAC,WAAW,CAAC;IACvE,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAqB,CAAC;IACvE,OAAO,EAAE,CAAC;AACd,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,eAAe,CAAC,KAAwB;IACpD,IAAI,CAAC;QACD,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACL,+DAA+D;QAC/D,gEAAgE;QAChE,OAAO,EAAE,IAAI,EAAE,mCAAmC,EAAE,CAAC;IACzD,CAAC;AACL,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,KAAwB;IACtE,MAAM,GAAG,GAAG,KAAK,CAAC,MAGjB,CAAC;IACF,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG;QACZ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;QAClC,WAAW,EAAE,MAAM;QACnB,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;KACrC,CAAC;IACF,OAAO;QACH,OAAO,EAAE;YACL;gBACI,IAAI,EAAE,MAAM;gBACZ,IAAI,EACA,iBAAiB,QAAQ,MAAM;oBAC/B,GAAG,GAAG,CAAC,WAAW,IAAI,EAAE,MAAM;oBAC9B,gBAAgB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,MAAM;oBAC3D,kBAAkB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM;oBACvD,sDAAsD,QAAQ,kCAAkC;aACvG;SACJ;QACD,iBAAiB,EAAE,OAAO;KAC7B,CAAC;AACN,CAAC"}

package/dist/gateway/advanced-tool/domains.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Gateway domain taxonomy — single source of truth for grouping
+ * advanced tools by domain in description, errors, and discovery
+ * payloads.
+ *
+ * Round-2 (R2-A2-CRIT2) extracted from `gateway/advanced-tool.ts`
+ * to keep that file ≤ 200 LoC per Architecture §11.
+ *
+ * The 4-entry `DOMAIN_ORDER` contract is pinned by
+ * `tests/gateway/domain-order.test.ts` — any change here MUST update
+ * that pin-test (Round-2 audit follow-up R2-A1-N1).
+ *
+ * @license MIT
+ */
+import type { AdvancedToolEntry } from '../capturing-server.js';
+/**
+ * Domains used to group advanced tool names. Order = display order in
+ * gateway description, errors, and discovery responses. Aligned with
+ * YOOtheme builder concepts (Design-Doc §3.1.1). Round-1 I4 trimmed
+ * from 8→4 (singular forms now route via DOMAIN_PREFIX_MAP, not
+ * duplicate entries). Pinned by `tests/gateway/domain-order.test.ts`.
+ */
+export declare const DOMAIN_ORDER: readonly ["pages", "elements", "sources", "inspection"];
+/**
+ * Prefix→domain routing table. Each domain accepts plural
+ * (`pages_list`) + singular (`page_save`, `element_add`, `source_…`)
+ * stems via `stem.startsWith(prefix + '_')` or full-equality. Anything
+ * outside the taxonomy falls through to 'misc'.
+ */
+export declare const DOMAIN_PREFIX_MAP: Record<(typeof DOMAIN_ORDER)[number], readonly string[]>;
+export declare const TOOL_PREFIX = "yootheme_builder_";
+/** Maps a tool name to its display domain (the first underscore-segment after the prefix). */
+export declare function domainOf(toolName: string): string;
+/** Groups tool names by domain, in DOMAIN_ORDER, for stable output. */
+export declare function groupByDomain(toolNames: string[]): Map<string, string[]>;
+/** Renders the grouped tool list as readable text (used in description + errors). */
+export declare function renderGroupedList(toolNames: string[]): string;
+/** Builds the gateway tool's description, grouping every advanced tool by domain. */
+export declare function buildDescription(toolNames: string[]): string;
+/** Re-export the AdvancedToolEntry type so consumers don't need a second import path. */
+export type { AdvancedToolEntry };
+//# sourceMappingURL=domains.d.ts.map

package/dist/gateway/advanced-tool/domains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/domains.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,yDAA0D,CAAC;AAEpF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAKtF,CAAC;AAEF,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAE/C,8FAA8F;AAC9F,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAYxE;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAO7D;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAe5D;AAED,yFAAyF;AACzF,YAAY,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/gateway/advanced-tool/domains.js

@@ -0,0 +1,88 @@
+/**
+ * Gateway domain taxonomy — single source of truth for grouping
+ * advanced tools by domain in description, errors, and discovery
+ * payloads.
+ *
+ * Round-2 (R2-A2-CRIT2) extracted from `gateway/advanced-tool.ts`
+ * to keep that file ≤ 200 LoC per Architecture §11.
+ *
+ * The 4-entry `DOMAIN_ORDER` contract is pinned by
+ * `tests/gateway/domain-order.test.ts` — any change here MUST update
+ * that pin-test (Round-2 audit follow-up R2-A1-N1).
+ *
+ * @license MIT
+ */
+/**
+ * Domains used to group advanced tool names. Order = display order in
+ * gateway description, errors, and discovery responses. Aligned with
+ * YOOtheme builder concepts (Design-Doc §3.1.1). Round-1 I4 trimmed
+ * from 8→4 (singular forms now route via DOMAIN_PREFIX_MAP, not
+ * duplicate entries). Pinned by `tests/gateway/domain-order.test.ts`.
+ */
+export const DOMAIN_ORDER = ['pages', 'elements', 'sources', 'inspection'];
+/**
+ * Prefix→domain routing table. Each domain accepts plural
+ * (`pages_list`) + singular (`page_save`, `element_add`, `source_…`)
+ * stems via `stem.startsWith(prefix + '_')` or full-equality. Anything
+ * outside the taxonomy falls through to 'misc'.
+ */
+export const DOMAIN_PREFIX_MAP = {
+    pages: ['pages', 'page'],
+    elements: ['elements', 'element'],
+    sources: ['sources', 'source'],
+    inspection: ['inspection'],
+};
+export const TOOL_PREFIX = 'yootheme_builder_';
+/** Maps a tool name to its display domain (the first underscore-segment after the prefix). */
+export function domainOf(toolName) {
+    const stem = toolName.startsWith(TOOL_PREFIX) ? toolName.slice(TOOL_PREFIX.length) : toolName;
+    for (const domain of DOMAIN_ORDER) {
+        for (const prefix of DOMAIN_PREFIX_MAP[domain]) {
+            if (stem === prefix || stem.startsWith(`${prefix}_`))
+                return domain;
+        }
+    }
+    return 'misc';
+}
+/** Groups tool names by domain, in DOMAIN_ORDER, for stable output. */
+export function groupByDomain(toolNames) {
+    const groups = new Map();
+    for (const domain of DOMAIN_ORDER)
+        groups.set(domain, []);
+    for (const name of [...toolNames].sort()) {
+        const domain = domainOf(name);
+        const bucket = groups.get(domain);
+        if (bucket)
+            bucket.push(name);
+    }
+    for (const [domain, names] of groups) {
+        if (names.length === 0)
+            groups.delete(domain);
+    }
+    return groups;
+}
+/** Renders the grouped tool list as readable text (used in description + errors). */
+export function renderGroupedList(toolNames) {
+    const groups = groupByDomain(toolNames);
+    const lines = [];
+    for (const [domain, names] of groups) {
+        lines.push(`  ${domain}: ${names.join(', ')}`);
+    }
+    return lines.join('\n');
+}
+/** Builds the gateway tool's description, grouping every advanced tool by domain. */
+export function buildDescription(toolNames) {
+    const toolCount = toolNames.length;
+    const domains = [...groupByDomain(toolNames).keys()];
+    const domainCount = domains.length;
+    const domainList = domains.join(', ');
+    return (`Routes to ${String(toolCount)} advanced YOOtheme Builder tools across ${String(domainCount)} ` +
+        `domain${domainCount === 1 ? '' : 's'}${domainCount > 0 ? ` (${domainList})` : ''}. ` +
+        'Call with { tool } for a target\'s schema + annotations, or ' +
+        '{ tool, arguments } to run it. The target tool\'s own confirmation ' +
+        'guards and behavior stay in effect.\n\n' +
+        'Available advanced tools by domain:\n' +
+        `${renderGroupedList(toolNames)}\n\n` +
+        'For connectivity diagnostics use yootheme_builder_health or yootheme_builder_diagnose (top-level).');
+}
+//# sourceMappingURL=domains.js.map

package/dist/gateway/advanced-tool/domains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.js","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/domains.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,CAAU,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA6D;IACvF,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;IACjC,OAAO,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC9B,UAAU,EAAE,CAAC,YAAY,CAAC;CAC7B,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAE/C,8FAA8F;AAC9F,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC9F,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAChC,KAAK,MAAM,MAAM,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7C,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC;gBAAE,OAAO,MAAM,CAAC;QACxE,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,SAAmB;IAC7C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,KAAK,MAAM,MAAM,IAAI,YAAY;QAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC1D,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,iBAAiB,CAAC,SAAmB;IACjD,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,gBAAgB,CAAC,SAAmB;IAChD,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC;IACnC,MAAM,OAAO,GAAG,CAAC,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IACnC,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,CACH,aAAa,MAAM,CAAC,SAAS,CAAC,2CAA2C,MAAM,CAAC,WAAW,CAAC,GAAG;QAC/F,SAAS,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI;QACrF,8DAA8D;QAC9D,qEAAqE;QACrE,yCAAyC;QACzC,uCAAuC;QACvC,GAAG,iBAAiB,CAAC,SAAS,CAAC,MAAM;QACrC,oGAAoG,CACvG,CAAC;AACN,CAAC"}

package/dist/gateway/advanced-tool/execute.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Gateway execute-mode dispatch — handles `{ tool, arguments }`
+ * invocations by validating `arguments` against the target tool's Zod
+ * schema in `.strict()` mode, then invoking the captured handler with
+ * the parsed args and the original SDK `extra` (so progress/elicitation/
+ * AbortSignal of the target tool keep working).
+ *
+ * Round-2 (R2-A2-CRIT2) extracted from `gateway/advanced-tool.ts`.
+ *
+ * @license MIT
+ */
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { AdvancedToolEntry } from '../capturing-server.js';
+/** Builds an error CallToolResult with structured payload (echoed into text + structuredContent). */
+export declare function errorResult(payload: {
+    message: string;
+    code: string;
+    suggestion: string;
+    details?: Record<string, unknown>;
+}): CallToolResult;
+/**
+ * Executes a captured advanced tool with strict-validated arguments.
+ *
+ * Returns a structured `invalid_arguments` error on Zod-validation
+ * failure; otherwise invokes `entry.handler` with `(parsedArgs, extra)`
+ * and returns its CallToolResult verbatim.
+ */
+export declare function executeAdvancedTool(toolName: string, entry: AdvancedToolEntry, rawArgs: Record<string, unknown>, extra: unknown): Promise<CallToolResult>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/gateway/advanced-tool/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/execute.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,qGAAqG;AACrG,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,GAAG,cAAc,CAYjB;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACrC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,EAAE,OAAO,GACf,OAAO,CAAC,cAAc,CAAC,CAoBzB"}

package/dist/gateway/advanced-tool/execute.js

@@ -0,0 +1,54 @@
+/**
+ * Gateway execute-mode dispatch — handles `{ tool, arguments }`
+ * invocations by validating `arguments` against the target tool's Zod
+ * schema in `.strict()` mode, then invoking the captured handler with
+ * the parsed args and the original SDK `extra` (so progress/elicitation/
+ * AbortSignal of the target tool keep working).
+ *
+ * Round-2 (R2-A2-CRIT2) extracted from `gateway/advanced-tool.ts`.
+ *
+ * @license MIT
+ */
+import { z } from 'zod';
+import { inputSchemaJson, shapeOf } from './discovery.js';
+/** Builds an error CallToolResult with structured payload (echoed into text + structuredContent). */
+export function errorResult(payload) {
+    const body = {
+        error: payload.message,
+        code: payload.code,
+        suggestion: payload.suggestion,
+        ...(payload.details !== undefined ? { details: payload.details } : {}),
+    };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(body, null, 2) }],
+        structuredContent: body,
+        isError: true,
+    };
+}
+/**
+ * Executes a captured advanced tool with strict-validated arguments.
+ *
+ * Returns a structured `invalid_arguments` error on Zod-validation
+ * failure; otherwise invokes `entry.handler` with `(parsedArgs, extra)`
+ * and returns its CallToolResult verbatim.
+ */
+export async function executeAdvancedTool(toolName, entry, rawArgs, extra) {
+    // strict() surfaces unknown keys as Zod issues rather than silently
+    // dropping them, so callers can self-correct when they pass schema-
+    // extra keys.
+    const parsed = z.object(shapeOf(entry)).strict().safeParse(rawArgs);
+    if (!parsed.success) {
+        return errorResult({
+            message: `Invalid arguments for "${toolName}".`,
+            code: 'invalid_arguments',
+            suggestion: `Call yootheme_builder_advanced with { tool: "${toolName}" } to see ` +
+                'the expected schema, then retry with corrected arguments.',
+            details: {
+                issues: parsed.error.issues,
+                expected_schema: inputSchemaJson(entry),
+            },
+        });
+    }
+    return entry.handler(parsed.data, extra);
+}
+//# sourceMappingURL=execute.js.map

package/dist/gateway/advanced-tool/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/execute.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE1D,qGAAqG;AACrG,MAAM,UAAU,WAAW,CAAC,OAK3B;IACG,MAAM,IAAI,GAAG;QACT,KAAK,EAAE,OAAO,CAAC,OAAO;QACtB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzE,CAAC;IACF,OAAO;QACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAChE,iBAAiB,EAAE,IAAI;QACvB,OAAO,EAAE,IAAI;KAChB,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACrC,QAAgB,EAChB,KAAwB,EACxB,OAAgC,EAChC,KAAc;IAEd,oEAAoE;IACpE,oEAAoE;IACpE,cAAc;IACd,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACpE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,WAAW,CAAC;YACf,OAAO,EAAE,0BAA0B,QAAQ,IAAI;YAC/C,IAAI,EAAE,mBAAmB;YACzB,UAAU,EACN,gDAAgD,QAAQ,aAAa;gBACrE,2DAA2D;YAC/D,OAAO,EAAE;gBACL,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;gBAC3B,eAAe,EAAE,eAAe,CAAC,KAAK,CAAC;aAC1C;SACJ,CAAC,CAAC;IACP,CAAC;IAED,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC"}

package/dist/gateway/advanced-tool/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `yootheme_builder_advanced` gateway tool — Wave G.1 / Design-Doc §3.1.1.
+ *
+ * Single entry-point to every L2 (non-essential, non-direct) tool. Cursor
+ * caps MCP servers at ~40 tools; routing 12 advanced tools through one
+ * gateway keeps `tools/list` at 10 (7 L1 + 2 L3 + 1 gateway).
+ *
+ * Two modes:
+ *   { tool }              → discovery: returns the target's description,
+ *                           a JSON-schema derived from its Zod inputSchema,
+ *                           and its annotation flags. The target handler
+ *                           is NOT invoked.
+ *   { tool, arguments }   → execution: `arguments` is validated against
+ *                           the target's Zod inputSchema in `.strict()`
+ *                           mode (unknown keys surface as Zod issues), then
+ *                           the target handler is invoked with the parsed
+ *                           args and the same `extra` object — so the
+ *                           target tool's progress, elicitation and
+ *                           AbortSignal keep working.
+ *
+ * Errors are structured ({ error, code, suggestion, details }). The gateway
+ * cannot route to itself: `yootheme_builder_advanced` is never in the
+ * advanced registry (the CapturingServer never sees its name — it's
+ * registered after the CapturingServer hands off).
+ *
+ * Round-2 (R2-A2-CRIT2): split into 5 files under `advanced-tool/`
+ * (this barrel + `domains.ts` + `discovery.ts` + `execute.ts` +
+ * `register.ts`) to keep each file ≤ 100 LoC per Architecture §11.
+ *
+ * @license MIT
+ */
+export { DOMAIN_ORDER, DOMAIN_PREFIX_MAP, TOOL_PREFIX, buildDescription, domainOf, groupByDomain, renderGroupedList, } from './domains.js';
+export { discoveryResult, inputSchemaJson, shapeOf } from './discovery.js';
+export { errorResult, executeAdvancedTool } from './execute.js';
+export { registerAdvancedTool } from './register.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/gateway/advanced-tool/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAKH,OAAO,EACH,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,iBAAiB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/gateway/advanced-tool/index.js

@@ -0,0 +1,39 @@
+/**
+ * `yootheme_builder_advanced` gateway tool — Wave G.1 / Design-Doc §3.1.1.
+ *
+ * Single entry-point to every L2 (non-essential, non-direct) tool. Cursor
+ * caps MCP servers at ~40 tools; routing 12 advanced tools through one
+ * gateway keeps `tools/list` at 10 (7 L1 + 2 L3 + 1 gateway).
+ *
+ * Two modes:
+ *   { tool }              → discovery: returns the target's description,
+ *                           a JSON-schema derived from its Zod inputSchema,
+ *                           and its annotation flags. The target handler
+ *                           is NOT invoked.
+ *   { tool, arguments }   → execution: `arguments` is validated against
+ *                           the target's Zod inputSchema in `.strict()`
+ *                           mode (unknown keys surface as Zod issues), then
+ *                           the target handler is invoked with the parsed
+ *                           args and the same `extra` object — so the
+ *                           target tool's progress, elicitation and
+ *                           AbortSignal keep working.
+ *
+ * Errors are structured ({ error, code, suggestion, details }). The gateway
+ * cannot route to itself: `yootheme_builder_advanced` is never in the
+ * advanced registry (the CapturingServer never sees its name — it's
+ * registered after the CapturingServer hands off).
+ *
+ * Round-2 (R2-A2-CRIT2): split into 5 files under `advanced-tool/`
+ * (this barrel + `domains.ts` + `discovery.ts` + `execute.ts` +
+ * `register.ts`) to keep each file ≤ 100 LoC per Architecture §11.
+ *
+ * @license MIT
+ */
+// Re-exports — keep the public surface that `advanced-tool.ts` exposed
+// before the split, so downstream importers keep working through the
+// `./advanced-tool.js` backward-compat shim.
+export { DOMAIN_ORDER, DOMAIN_PREFIX_MAP, TOOL_PREFIX, buildDescription, domainOf, groupByDomain, renderGroupedList, } from './domains.js';
+export { discoveryResult, inputSchemaJson, shapeOf } from './discovery.js';
+export { errorResult, executeAdvancedTool } from './execute.js';
+export { registerAdvancedTool } from './register.js';
+//# sourceMappingURL=index.js.map

package/dist/gateway/advanced-tool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,uEAAuE;AACvE,qEAAqE;AACrE,6CAA6C;AAC7C,OAAO,EACH,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,iBAAiB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/gateway/advanced-tool/register.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Gateway tool registration — wires `yootheme_builder_advanced` onto the
+ * real McpServer, with discovery-mode + execute-mode dispatch.
+ *
+ * Round-2 (R2-A2-CRIT2) extracted from `gateway/advanced-tool.ts`.
+ *
+ * @license MIT
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AdvancedToolEntry } from '../capturing-server.js';
+/**
+ * Registers `yootheme_builder_advanced` on the real McpServer.
+ *
+ * @param realServer       the McpServer that exposes the gateway tool
+ * @param advancedRegistry the captured non-essential tools (from CapturingServer)
+ */
+export declare function registerAdvancedTool(realServer: McpServer, advancedRegistry: Map<string, AdvancedToolEntry>): void;
+//# sourceMappingURL=register.d.ts.map

package/dist/gateway/advanced-tool/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/register.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAmBhE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,UAAU,EAAE,SAAS,EACrB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACjD,IAAI,CAwCN"}

package/dist/gateway/advanced-tool/register.js

@@ -0,0 +1,62 @@
+/**
+ * Gateway tool registration — wires `yootheme_builder_advanced` onto the
+ * real McpServer, with discovery-mode + execute-mode dispatch.
+ *
+ * Round-2 (R2-A2-CRIT2) extracted from `gateway/advanced-tool.ts`.
+ *
+ * @license MIT
+ */
+import { z } from 'zod';
+import { buildDescription, renderGroupedList } from './domains.js';
+import { discoveryResult } from './discovery.js';
+import { errorResult, executeAdvancedTool } from './execute.js';
+/** Builds the gateway tool's Zod inputSchema for a given non-empty enum of advanced names. */
+function gatewayInputSchema(enumValues) {
+    return {
+        tool: z.enum(enumValues).describe('Advanced tool to route to (e.g. "yootheme_builder_page_save"). ' +
+            'Omit `arguments` to discover its schema first.'),
+        arguments: z.record(z.string(), z.unknown()).optional().describe('Arguments for the target tool. Omit for discovery mode ' +
+            "(returns the tool's schema + annotations)."),
+    };
+}
+/**
+ * Registers `yootheme_builder_advanced` on the real McpServer.
+ *
+ * @param realServer       the McpServer that exposes the gateway tool
+ * @param advancedRegistry the captured non-essential tools (from CapturingServer)
+ */
+export function registerAdvancedTool(realServer, advancedRegistry) {
+    const advancedNames = [...advancedRegistry.keys()].sort();
+    // z.enum needs a non-empty tuple. The empty-registry arm is exercised
+    // only by defensive test wiring; production always populates the
+    // registry. Keeping the guard means a zero-tool wiring still yields a
+    // valid (if inert) gateway schema rather than a z.enum crash.
+    const enumValues = advancedNames.length > 0 ? advancedNames : ['__none__'];
+    realServer.registerTool('yootheme_builder_advanced', {
+        title: 'Advanced Tool Gateway',
+        description: buildDescription(advancedNames),
+        inputSchema: gatewayInputSchema(enumValues),
+        annotations: {
+            title: 'Advanced Tool Gateway',
+            readOnlyHint: false,
+            openWorldHint: true,
+            idempotentHint: false,
+        },
+    }, async (args, extra) => {
+        const entry = advancedRegistry.get(args.tool);
+        if (!entry) {
+            return errorResult({
+                message: `Unknown advanced tool: "${args.tool}".`,
+                code: 'unknown_tool',
+                suggestion: 'Pick one of the valid advanced tool names below, or call ' +
+                    'yootheme_builder_health to verify connectivity.\n\n' +
+                    `Valid advanced tools by domain:\n${renderGroupedList(advancedNames)}`,
+                details: { valid_tools_by_domain: renderGroupedList(advancedNames) },
+            });
+        }
+        if (args.arguments === undefined)
+            return discoveryResult(args.tool, entry);
+        return executeAdvancedTool(args.tool, entry, args.arguments, extra);
+    });
+}
+//# sourceMappingURL=register.js.map

package/dist/gateway/advanced-tool/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/register.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEhE,8FAA8F;AAC9F,SAAS,kBAAkB,CAAC,UAAiC;IACzD,OAAO;QACH,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,CAC7B,iEAAiE;YAC7D,gDAAgD,CACvD;QACD,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC5D,yDAAyD;YACrD,4CAA4C,CACnD;KACJ,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAChC,UAAqB,EACrB,gBAAgD;IAEhD,MAAM,aAAa,GAAG,CAAC,GAAG,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAE1D,sEAAsE;IACtE,iEAAiE;IACjE,sEAAsE;IACtE,8DAA8D;IAC9D,MAAM,UAAU,GACZ,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAE,aAAuC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAEvF,UAAU,CAAC,YAAY,CACnB,2BAA2B,EAC3B;QACI,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE,gBAAgB,CAAC,aAAa,CAAC;QAC5C,WAAW,EAAE,kBAAkB,CAAC,UAAU,CAAC;QAC3C,WAAW,EAAE;YACT,KAAK,EAAE,uBAAuB;YAC9B,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,IAAI;YACnB,cAAc,EAAE,KAAK;SACxB;KACJ,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAA2B,EAAE;QAC3C,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,WAAW,CAAC;gBACf,OAAO,EAAE,2BAA2B,IAAI,CAAC,IAAI,IAAI;gBACjD,IAAI,EAAE,cAAc;gBACpB,UAAU,EACN,2DAA2D;oBAC3D,qDAAqD;oBACrD,oCAAoC,iBAAiB,CAAC,aAAa,CAAC,EAAE;gBAC1E,OAAO,EAAE,EAAE,qBAAqB,EAAE,iBAAiB,CAAC,aAAa,CAAC,EAAE;aACvE,CAAC,CAAC;QACP,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3E,OAAO,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACxE,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/gateway/advanced-tool.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Backward-compat shim for `gateway/advanced-tool.ts`.
+ *
+ * The original 283-LoC module was split into `gateway/advanced-tool/`
+ * (4 files, each ≤ 100 LoC) per Architecture §11 cap (Round-2
+ * R2-A2-CRIT2 audit fix). This shim preserves the public import path
+ * (`from '../gateway/advanced-tool.js'`) so server.ts, src/index.ts,
+ * and the test suite keep working unchanged.
+ *
+ * @license MIT
+ */
+export * from './advanced-tool/index.js';
+//# sourceMappingURL=advanced-tool.d.ts.map

package/dist/gateway/advanced-tool.d.ts.map

@@ -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"}

package/dist/gateway/advanced-tool.js

@@ -0,0 +1,13 @@
+/**
+ * Backward-compat shim for `gateway/advanced-tool.ts`.
+ *
+ * The original 283-LoC module was split into `gateway/advanced-tool/`
+ * (4 files, each ≤ 100 LoC) per Architecture §11 cap (Round-2
+ * R2-A2-CRIT2 audit fix). This shim preserves the public import path
+ * (`from '../gateway/advanced-tool.js'`) so server.ts, src/index.ts,
+ * and the test suite keep working unchanged.
+ *
+ * @license MIT
+ */
+export * from './advanced-tool/index.js';
+//# sourceMappingURL=advanced-tool.js.map

package/dist/gateway/advanced-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-tool.js","sourceRoot":"","sources":["../../src/gateway/advanced-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,0BAA0B,CAAC"}

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

@@ -0,0 +1,117 @@
+/**
+ * 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> {
+    title?: string;
+    description?: string;
+    inputSchema?: InputArgs;
+    outputSchema?: ZodRawShapeCompat | AnySchema;
+    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 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.
+     */
+    registerResource: McpServer['registerResource'];
+    /** The captured non-essential tools, keyed by tool name. */
+    getAdvancedRegistry(): Map<string, AdvancedToolEntry>;
+}
+export {};
+//# sourceMappingURL=capturing-server.d.ts.map

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

@@ -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"}