@wootsup/yt-builder-mcp 1.12.0 → 2.1.0

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

@@ -1,41 +1,4 @@
-/**
- * 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 5-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', 'multi-items', 'inspection'];
-/**
- * Prefix→domain routing table. Each domain accepts plural
- * (`pages_list`) + singular (`page_get_schema`, `element_unbind_source`,
- * `source_…`) stems via `stem.startsWith(prefix + '_')` or full-equality.
- * Anything outside the taxonomy falls through to 'misc'.
- *
- * The `multi-items` domain captures the YT-Pro Multi-Items binding
- * pattern tools (inspect / clean-implode). Stems used:
- *  - `inspect_multi_items_binding` → starts with `inspect_multi_items`
- *  - `clean_implode_directives`    → starts with `clean_implode`
- *
- * The `inspection` domain captures layout inspectors that surface a
- * YT-Pro footgun the raw layout tree hides. Stems used:
- *  - `inspect_sublayout` (F154) → full-equality `inspect_sublayout`
- *    (the YT5 `< SUBLAYOUT` fragment-subtree + inner-grid-gate inspector).
- */
 export const DOMAIN_PREFIX_MAP = {
     pages: ['pages', 'page'],
     elements: ['elements', 'element'],
@@ -44,7 +7,16 @@ export const DOMAIN_PREFIX_MAP = {
     inspection: ['inspection', 'inspect_sublayout'],
 };
 export const TOOL_PREFIX = 'yootheme_builder_';
-/** Maps a tool name to its display domain (the first underscore-segment after the prefix). */
+export function resolveShortToolName(name, isMember) {
+    if (isMember(name))
+        return name;
+    if (!name.startsWith(TOOL_PREFIX)) {
+        const prefixed = `${TOOL_PREFIX}${name}`;
+        if (isMember(prefixed))
+            return prefixed;
+    }
+    return name;
+}
 export function domainOf(toolName) {
     const stem = toolName.startsWith(TOOL_PREFIX) ? toolName.slice(TOOL_PREFIX.length) : toolName;
     for (const domain of DOMAIN_ORDER) {
@@ -55,19 +27,6 @@ export function domainOf(toolName) {
     }
     return 'misc';
 }
-/**
- * Groups tool names by domain, DOMAIN_ORDER first then any fall-through domain
- * (`misc`) at the end, for stable output.
- *
- * NEVER-DROP invariant (audit fix F8, 2026-07-16): a tool whose stem is outside
- * the DOMAIN_PREFIX_MAP taxonomy resolves to `misc`; the bucket is created
- * LAZILY so such a tool is still grouped and rendered. The former impl only
- * pre-created the DOMAIN_ORDER buckets and dropped anything mapping to `misc`,
- * so shipped advanced tools with unmapped stems (`layout_query`,
- * `library_save_as`) were silently absent from the gateway description, errors,
- * and discovery — undiscoverable. Pinned by
- * `tests/gateway/advanced-registry-coverage.test.ts`.
- */
 export function groupByDomain(toolNames) {
     const groups = new Map();
     for (const domain of DOMAIN_ORDER)
@@ -87,47 +46,44 @@ export function groupByDomain(toolNames) {
     }
     return groups;
 }
-/** Renders the grouped tool list as readable text (used in description + errors). */
-export function renderGroupedList(toolNames) {
+function requirementSuffix(required) {
+    if (required === undefined)
+        return '';
+    return required.length === 0 ? ' (none required)' : ` (needs ${required.join(', ')})`;
+}
+export function renderGroupedList(toolNames, required) {
     const groups = groupByDomain(toolNames);
     const lines = [];
     for (const [domain, names] of groups) {
-        lines.push(`  ${domain}: ${names.join(', ')}`);
+        const rendered = names.map((name) => `${name}${requirementSuffix(required?.get(name))}`);
+        lines.push(`  ${domain}: ${rendered.join(', ')}`);
     }
     return lines.join('\n');
 }
-/**
- * F176 (2026-06-12): the former "★ Bind a source" callout was removed. The
- * bind tool (`yootheme_builder_element_bind_source`) plus `page_save` /
- * `page_publish` were promoted to L1 by F116 and live in `tools/list` as
- * first-class entries; the DISJOINT-LANE invariant guarantees they are NEVER
- * in the advanced registry, so the gateway description must not advertise a
- * gateway wrap for them (it would steer agents into an `unknown_tool` dead
- * end on a current build). The binding workflow is now discoverable directly
- * in `tools/list`.
- */
-/** Builds the gateway tool's description, grouping every advanced tool by domain. */
-export function buildDescription(toolNames) {
+export function gatewayCallFor(toolName, readOnlyTool) {
+    const gateway = readOnlyTool ? 'yootheme_builder_advanced_read' : 'yootheme_builder_advanced';
+    return `${gateway}({ tool: "${toolName}", arguments: {...} })`;
+}
+export function gatewayOnlyNote(toolName, readOnlyTool) {
+    return (`Not in tools/list — searching for "${toolName}" there finds nothing. `
+        + `Call it as ${gatewayCallFor(toolName, readOnlyTool)}.`);
+}
+export const FIRST_CLASS_NOT_ABSENT_HINT = 'If your client does not show it, it is filtered or unloaded there — not absent.';
+export function buildDescription(toolNames, required) {
     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})` : ''}. ` +
-        // F214: stop the model habitually routing first-class tools through the
-        // gateway (a wasted invalid_arguments cycle each time). State the scope
-        // boundary up front, before the grouped-tool list.
+    return (`Routes to ${String(toolCount)} advanced tool${toolCount === 1 ? '' : 's'} across ` +
+        `${String(domainCount)} domain${domainCount === 1 ? '' : 's'}${domainCount > 0 ? ` (${domainList})` : ''}. ` +
         'ONLY for the advanced tools listed below — every tool that appears ' +
         'directly in tools/list is FIRST-CLASS: call it directly, never via this gateway. ' +
-        // CONTENT_RENDER_GATEWAYS-25: steer the read-only subset to the read
-        // gateway so pure inspection avoids a write-approval prompt.
-        'For the read-only ones (page_get_schema, pages_audit, inspect_sublayout, ' +
-        'layout_query, local_content_read, local_content_types) prefer ' +
-        'yootheme_builder_advanced_read (no write-approval gate). ' +
-        'Call { tool } for its schema, or { tool, arguments } to run it ' +
-        '(the target\'s own confirm guards stay in effect).' +
-        '\n\nAvailable advanced tools by domain:\n' +
-        `${renderGroupedList(toolNames)}\n\n` +
+        'Read-only ones: prefer yootheme_builder_advanced_read (no write-approval gate). ' +
+        'Omit `arguments` to see a tool\'s schema. ' +
+        '`site_id` and every other argument the target tool declares go INSIDE ' +
+        '`arguments`, never beside `tool`.' +
+        '\n\nAvailable advanced tools by domain (needs … = required arguments):\n' +
+        `${renderGroupedList(toolNames, required)}\n\n` +
         'Connectivity: yootheme_builder_health / yootheme_builder_diagnose.');
 }
 //# sourceMappingURL=domains.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"domains.js","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/domains.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"domains.js","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/domains.ts"],"names":[],"mappings":"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"}

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

@@ -1,35 +1,10 @@
-/**
- * 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.
- *
- * DISCOVERY_AUDIT-13: `gatewayName` names the gateway the call ARRIVED on
- * (`yootheme_builder_advanced` for the write gateway, `…_advanced_read` for the
- * read gateway) so the invalid_arguments suggestion points the caller back at
- * the SAME gateway they used — not always the write one. Defaults to the write
- * gateway for back-compat with any caller that predates the parameter.
- */
 export declare function executeAdvancedTool(toolName: string, entry: AdvancedToolEntry, rawArgs: Record<string, unknown>, extra: unknown, gatewayName?: string): Promise<CallToolResult>;
 //# sourceMappingURL=execute.d.ts.map

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

@@ -1 +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;AA8ChE,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;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACrC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,EAAE,OAAO,EACd,WAAW,GAAE,MAA6B,GAC3C,OAAO,CAAC,cAAc,CAAC,CA6BzB"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/execute.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAwFhE,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,wBAAsB,mBAAmB,CACrC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,EAAE,OAAO,EACd,WAAW,GAAE,MAA6B,GAC3C,OAAO,CAAC,cAAc,CAAC,CAmCzB"}

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

@@ -1,31 +1,6 @@
-/**
- * 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';
-/** The write gateway's own name — the default `gatewayName` for back-compat. */
 const DEFAULT_GATEWAY_NAME = 'yootheme_builder_advanced';
-/**
- * DISCOVERY_AUDIT-12 — reduce a full input JSON-schema to ONLY the top-level
- * property subtrees the failing Zod issues actually touch.
- *
- * A single-token typo (e.g. `checks:['accessibility']`) used to attach the
- * WHOLE nested `expected_schema` (measured 3737 bytes for one bad enum value).
- * The full schema is one discovery call away ({tool} with no arguments), so the
- * error only needs the offending subtree(s). We collect `issue.path[0]` (the
- * top-level property each issue lives under) and pick just those properties off
- * the full schema. Returns `null` when nothing can be narrowed (no property
- * paths, or the schema is not the expected object shape) so the caller can fall
- * back to the discovery pointer instead of a full dump.
- */
 function offendingSchemaSubtree(fullSchema, issues) {
     if (fullSchema === null || typeof fullSchema !== 'object' || Array.isArray(fullSchema)) {
         return null;
@@ -50,7 +25,16 @@ function offendingSchemaSubtree(fullSchema, issues) {
     }
     return { type: 'object', properties: picked };
 }
-/** Builds an error CallToolResult with structured payload (echoed into text + structuredContent). */
+function confirmInsteadOfDryRunHint(entry, issues) {
+    const rejectedDryRun = issues.some((issue) => issue.code === 'unrecognized_keys' && issue.path.length === 0 && (issue.keys ?? []).includes('dry_run'));
+    if (!rejectedDryRun)
+        return null;
+    const shape = shapeOf(entry);
+    if (!('confirm' in shape) || 'dry_run' in shape)
+        return null;
+    return ('This tool takes `confirm` (default false), not `dry_run` — deleting is a confirmed ' +
+        'action, not a preview, so the two guards are deliberately never aliased.');
+}
 export function errorResult(payload) {
     const body = {
         error: payload.message,
@@ -64,39 +48,19 @@ export function errorResult(payload) {
         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.
- *
- * DISCOVERY_AUDIT-13: `gatewayName` names the gateway the call ARRIVED on
- * (`yootheme_builder_advanced` for the write gateway, `…_advanced_read` for the
- * read gateway) so the invalid_arguments suggestion points the caller back at
- * the SAME gateway they used — not always the write one. Defaults to the write
- * gateway for back-compat with any caller that predates the parameter.
- */
 export async function executeAdvancedTool(toolName, entry, rawArgs, extra, gatewayName = DEFAULT_GATEWAY_NAME) {
-    // 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) {
-        // DISCOVERY_AUDIT-12: attach ONLY the offending property subtree(s), not
-        // the whole nested schema (a single typo dumped ~3.7 KB). The full schema
-        // is one discovery call away — named in the suggestion below.
         const offending = offendingSchemaSubtree(inputSchemaJson(entry), parsed.error.issues);
+        const confirmHint = confirmInsteadOfDryRunHint(entry, parsed.error.issues);
         return errorResult({
             message: `Invalid arguments for "${toolName}".`,
             code: 'invalid_arguments',
-            suggestion: `Call ${gatewayName} with { tool: "${toolName}" } to see ` +
+            suggestion: (confirmHint !== null ? `${confirmHint} ` : '') +
+                `Call ${gatewayName} with { tool: "${toolName}" } to see ` +
                 'the full expected schema, then retry with corrected arguments.',
             details: {
                 issues: parsed.error.issues,
-                // The narrowed subtree when we could isolate the offending
-                // properties; otherwise a pointer to the discovery call rather
-                // than the full dump.
                 ...(offending !== null
                     ? { offending_schema: offending }
                     : { schema_hint: `Omit \`arguments\` on ${gatewayName}({ tool: "${toolName}" }) for the full schema.` }),

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

@@ -1 +1 @@
-{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/execute.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/execute.ts"],"names":[],"mappings":"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"}

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

@@ -1,35 +1,4 @@
-/**
- * `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 { DOMAIN_ORDER, DOMAIN_PREFIX_MAP, TOOL_PREFIX, buildDescription, domainOf, groupByDomain, renderGroupedList, resolveShortToolName, } from './domains.js';
 export { discoveryResult, inputSchemaJson, shapeOf } from './discovery.js';
 export { errorResult, executeAdvancedTool } from './execute.js';
 export { registerAdvancedTool } from './register.js';

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/index.ts"],"names":[],"mappings":"AAoCA,OAAO,EACH,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,oBAAoB,GACvB,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

@@ -1,38 +1,4 @@
-/**
- * `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 { DOMAIN_ORDER, DOMAIN_PREFIX_MAP, TOOL_PREFIX, buildDescription, domainOf, groupByDomain, renderGroupedList, resolveShortToolName, } from './domains.js';
 export { discoveryResult, inputSchemaJson, shapeOf } from './discovery.js';
 export { errorResult, executeAdvancedTool } from './execute.js';
 export { registerAdvancedTool } from './register.js';

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

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/index.ts"],"names":[],"mappings":"AAoCA,OAAO,EACH,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,oBAAoB,GACvB,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

@@ -1,18 +1,4 @@
-/**
- * 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

@@ -1 +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;AA0ChE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,UAAU,EAAE,SAAS,EACrB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACjD,IAAI,CAyDN"}
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/register.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAiDhE,wBAAgB,oBAAoB,CAChC,UAAU,EAAE,SAAS,EACrB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACjD,IAAI,CAoFN"}

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

@@ -1,63 +1,28 @@
-/**
- * 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 { isEssential, isDirectTopLevel } from '../essentials.js';
-import { buildDescription, renderGroupedList } from './domains.js';
-import { discoveryResult } from './discovery.js';
+import { strictInputObject } from '../../tools/strict-input.js';
+import { buildDescription, FIRST_CLASS_NOT_ABSENT_HINT, renderGroupedList, resolveShortToolName } from './domains.js';
+import { discoveryResult, requiredArgsFromRegistry } from './discovery.js';
 import { errorResult, executeAdvancedTool } from './execute.js';
-/**
- * Builds the gateway tool's Zod inputSchema.
- *
- * F205 (P2): `tool` is a free z.string(), NOT a z.enum of the advanced names.
- * The MCP SDK validates the gateway inputSchema BEFORE our handler runs; an
- * enum rejected every first-class tool name (yootheme_builder_health,
- * yootheme_builder_template_summary, ...) with a raw McpError -32602, so the
- * handler's unknown_tool / first_class_tool steering never ran. A plain string
- * lets every name reach the handler. renderGroupedList in the description stays
- * the load-bearing discovery surface.
- */
 function gatewayInputSchema() {
     return {
-        tool: z.string().describe('Advanced tool to route to (e.g. "yootheme_builder_page_get_schema"). ' +
+        tool: z.string().describe('Advanced tool to route to (e.g. "yootheme_builder_pages_audit"). ' +
             'Must be one of the advanced tools listed in this description — ' +
             'first-class tools (yootheme_builder_health, ...) are called ' +
             'DIRECTLY, not through this gateway. ' +
             '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)."),
-        // `input` is a tolerated ALIAS for `arguments`. Some agents (and older
-        // skill docs) pass the target arguments under `input:`. Without this the
-        // key would be dropped by the SDK's zod validation, leaving `arguments`
-        // undefined → the gateway silently fell into discovery mode and never
-        // executed the write (F107). Accepting it keeps verbatim callers working;
-        // `arguments` still wins when both are present.
         input: z.record(z.string(), z.unknown()).optional().describe('Alias for `arguments` (tolerated for back-compat). Prefer `arguments`.'),
     };
 }
-/**
- * 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();
+    const requiredArgs = requiredArgsFromRegistry(advancedRegistry);
     realServer.registerTool('yootheme_builder_advanced', {
         title: 'Advanced Tool Gateway',
-        description: buildDescription(advancedNames),
-        inputSchema: gatewayInputSchema(),
-        // Stream D3 T3: gateway is the only L1 tool that retains
-        // `openWorldHint:true` — its effective behaviour is
-        // dynamic (target tool decided at call-time). Conservative
-        // spec-default marks it destructive because it can route
-        // into delete/unbind handlers; the destination tool's own
-        // confirm-guard still gates the actual mutation.
+        description: buildDescription(advancedNames, requiredArgs),
+        inputSchema: strictInputObject('yootheme_builder_advanced', gatewayInputSchema()),
         annotations: {
             title: 'Advanced Tool Gateway',
             readOnlyHint: false,
@@ -66,20 +31,20 @@ export function registerAdvancedTool(realServer, advancedRegistry) {
             openWorldHint: true,
         },
     }, async (args, extra) => {
-        const entry = advancedRegistry.get(args.tool);
+        const tool = resolveShortToolName(args.tool, (candidate) => advancedRegistry.has(candidate) || isEssential(candidate) || isDirectTopLevel(candidate));
+        const entry = advancedRegistry.get(tool);
         if (!entry) {
-            // F205: a name that is a first-class tool (L1 essential or L3
-            // direct top-level) is a different error than a typo — steer the
-            // caller to call it DIRECTLY instead of routing it through the
-            // gateway.
-            if (isEssential(args.tool) || isDirectTopLevel(args.tool)) {
+            if (isEssential(tool) || isDirectTopLevel(tool)) {
                 return errorResult({
-                    message: `"${args.tool}" is a FIRST-CLASS tool — it appears directly in tools/list.`,
+                    message: `"${tool}" is not routed through this gateway: it is registered as a ` +
+                        'standalone tool, so your client can grant or withhold it on its own.',
                     code: 'first_class_tool',
-                    suggestion: `Call "${args.tool}" directly instead of routing it through ` +
-                        'yootheme_builder_advanced. This gateway only routes the advanced ' +
-                        'tools listed in its description.',
-                    details: { tool: args.tool },
+                    suggestion: `If you can see "${tool}" in your tool list, call it directly. If you ` +
+                        'do not see it, your client has not granted it — this gateway cannot ' +
+                        "route around that; enable the tool in your client's settings. This " +
+                        'gateway only routes the advanced tools listed in its description. ' +
+                        FIRST_CLASS_NOT_ABSENT_HINT,
+                    details: { tool },
                 });
             }
             return errorResult({
@@ -87,15 +52,14 @@ export function registerAdvancedTool(realServer, advancedRegistry) {
                 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) },
+                    `Valid advanced tools by domain (needs \u2026 = required arguments):\n${renderGroupedList(advancedNames, requiredArgs)}`,
+                details: { valid_tools_by_domain: renderGroupedList(advancedNames, requiredArgs) },
             });
         }
-        // `arguments` is canonical; `input` is a tolerated alias (F107).
         const callArgs = args.arguments ?? args.input;
         if (callArgs === undefined)
-            return discoveryResult(args.tool, entry);
-        return executeAdvancedTool(args.tool, entry, callArgs, extra);
+            return discoveryResult(tool, entry);
+        return executeAdvancedTool(tool, entry, callArgs, extra);
     });
 }
 //# sourceMappingURL=register.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/register.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/register.ts"],"names":[],"mappings":"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"}

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

@@ -1,13 +1,2 @@
-/**
- * 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

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

package/dist/gateway/advanced-tool.js

@@ -1,13 +1,2 @@
-/**
- * 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

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