@wootsup/yt-builder-mcp 1.10.0 → 1.11.0

package/README.md

@@ -63,7 +63,7 @@ The wizard auto-detects and configures the following clients:
 
 ## Tool surface (gateway model)
 
-The server catalogues **48 tools + 2 gateways = 50 reachable** end-to-end,
+The server catalogues **49 tools + 2 gateways = 51 reachable** end-to-end,
 of which **41 are advertised in `tools/list`** (well under Cursor's ~40-tool
 cap — the 3-lane split keeps the advertised surface small while every
 catalogued tool stays callable):
@@ -78,10 +78,11 @@ catalogued tool stays callable):
   `inspect_multi_items_binding`, the multi-site `sites_list` / `sites_test` /
   `use_site`, and the bind→save→publish chain `element_bind_source` /
   `page_save` / `page_publish`, among others).
-- **2 gateway tools** exposing the remaining **9 advanced tools**:
-  - `yootheme_builder_advanced` (write-capable) routes **all 9**
-    (`page_get_schema`, `element_get_binding`, `element_unbind_source`,
+- **2 gateway tools** exposing the remaining **10 advanced tools**:
+  - `yootheme_builder_advanced` (write-capable) routes **all 10**
+    (`page_get_schema`, `element_unbind_source`,
     `clean_implode_directives`, `inspect_sublayout`, `layout_query`,
+    `library_save_as`, `library_delete`,
     `local_content_types`, `local_content_read`, `pages_audit`).
   - `yootheme_builder_advanced_read` (read-only-annotated) routes only the
     **6 read-only** advanced tools (`page_get_schema`, `inspect_sublayout`,
@@ -105,7 +106,7 @@ workflows, and `docs/TOOL-CATALOG.md` for an auto-generated reference.
 | Sources     |     5 | `sources_list`, `element_get_binding`, `element_bind_source`, `element_unbind_source`, `inspect_multi_items_binding`                                                |
 | Inspection  |     3 | `element_types_list`, `element_type_get_schema`, `clean_implode_directives`                                                                                         |
 | Sublayout   |     1 | `inspect_sublayout` (F154 — fragment subtree + render-time inner-grid gate; advanced/gateway-routed)                                                                |
-| Gateway     |     2 | `advanced` (write, routes all 9 advanced tools), `advanced_read` (read-only, routes the 6 read-only advanced tools)                                                  |
+| Gateway     |     2 | `advanced` (write, routes all 10 advanced tools), `advanced_read` (read-only, routes the 6 read-only advanced tools)                                                  |
 
 All tool names are prefixed with `yootheme_builder_` at the MCP server boundary.
 

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

@@ -1 +1 @@
-{"version":3,"file":"advanced-read-tool.d.ts","sourceRoot":"","sources":["../../src/gateway/advanced-read-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAM/D,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,mCAAmC,CAAC;AAgExE;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACpC,UAAU,EAAE,SAAS,EACrB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACjD,IAAI,CAwEN"}
+{"version":3,"file":"advanced-read-tool.d.ts","sourceRoot":"","sources":["../../src/gateway/advanced-read-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAM/D,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,mCAAmC,CAAC;AA0ExE;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACpC,UAAU,EAAE,SAAS,EACrB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACjD,IAAI,CA0EN"}

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

@@ -75,7 +75,17 @@ function buildReadDescription(readOnlyNames) {
         'ONLY for the read-only advanced tools listed below — every tool that ' +
         'appears directly in tools/list is FIRST-CLASS: call it directly, never via this gateway. ' +
         'Itself read-only (no write-approval gate) — prefer it over ' +
-        'yootheme_builder_advanced for inspection. Call { tool } for its ' +
+        'yootheme_builder_advanced for inspection. ' +
+        // B-1 (SEO-routing fix, 2026-07-21): intent keywords in the gateway
+        // lead so a COLD agent's generic "SEO audit" request matches this
+        // gateway semantically and finds pages_audit behind it (pages_audit is
+        // L2 — only reachable through this gateway, never first-class). Without
+        // this the agent loops page_get_layout page-by-page (glöckle 2026-07-21).
+        'Includes the one-call site-wide SEO / structure / content / links AUDIT ' +
+        '(yootheme_builder_pages_audit — missing/multiple h1, image alt, thin ' +
+        'content, duplicate layouts, dead links): route a whole-site SEO / audit ' +
+        'request here instead of looping page-by-page reads. ' +
+        'Call { tool } for its ' +
         'schema, or { tool, arguments } to run it.' +
         '\n\nAvailable read-only advanced tools by domain:\n' +
         `${renderGroupedList(readOnlyNames)}\n\n` +
@@ -150,7 +160,9 @@ export function registerAdvancedReadTool(realServer, advancedRegistry) {
         const callArgs = args.arguments ?? args.input;
         if (callArgs === undefined)
             return discoveryResult(args.tool, entry);
-        return executeAdvancedTool(args.tool, entry, callArgs, extra);
+        // DISCOVERY_AUDIT-13: pass THIS gateway's name so an invalid_arguments
+        // failure steers back to advanced_read, not the write gateway.
+        return executeAdvancedTool(args.tool, entry, callArgs, extra, ADVANCED_READ_TOOL_NAME);
     });
 }
 //# sourceMappingURL=advanced-read-tool.js.map

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

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

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

@@ -1 +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,wEAAyE,CAAC;AAEnG;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAMtF,CAAC;AAEF,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAE/C,8FAA8F;AAC9F,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAgBxE;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAO7D;AAED;;;;;;;;;GASG;AAEH,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAmB5D;AAED,yFAAyF;AACzF,YAAY,EAAE,iBAAiB,EAAE,CAAC"}
+{"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,wEAAyE,CAAC;AAEnG;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAMtF,CAAC;AAEF,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAE/C,8FAA8F;AAC9F,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAgBxE;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAO7D;AAED;;;;;;;;;GASG;AAEH,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAwB5D;AAED,yFAAyF;AACzF,YAAY,EAAE,iBAAiB,EAAE,CAAC"}

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

@@ -119,6 +119,11 @@ export function buildDescription(toolNames) {
         // boundary up front, before the grouped-tool list.
         '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' +

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":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,CAAU,CAAC;AAEnG;;;;;;;;;;;;;;;GAeG;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,aAAa,EAAE,CAAC,qBAAqB,EAAE,eAAe,CAAC;IACvD,UAAU,EAAE,CAAC,YAAY,EAAE,mBAAmB,CAAC;CAClD,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;;;;;;;;;;;;GAYG;AACH,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,IAAI,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,MAAM,GAAG,EAAE,CAAC;YACZ,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,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;;;;;;;;;GASG;AAEH,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,wEAAwE;QACxE,wEAAwE;QACxE,mDAAmD;QACnD,qEAAqE;QACrE,mFAAmF;QACnF,qEAAqE;QACrE,6DAA6D;QAC7D,2EAA2E;QAC3E,gEAAgE;QAChE,2DAA2D;QAC3D,iEAAiE;QACjE,oDAAoD;QACpD,2CAA2C;QAC3C,GAAG,iBAAiB,CAAC,SAAS,CAAC,MAAM;QACrC,oEAAoE,CACvE,CAAC;AACN,CAAC"}

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

@@ -24,6 +24,12 @@ export declare function errorResult(payload: {
  * 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): Promise<CallToolResult>;
+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;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"}
+{"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"}

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

@@ -11,6 +11,45 @@
  */
 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;
+    }
+    const props = fullSchema.properties;
+    if (props === null || typeof props !== 'object' || Array.isArray(props)) {
+        return null;
+    }
+    const propMap = props;
+    const offendingKeys = new Set();
+    for (const issue of issues) {
+        const first = issue.path[0];
+        if (typeof first === 'string' && first in propMap) {
+            offendingKeys.add(first);
+        }
+    }
+    if (offendingKeys.size === 0)
+        return null;
+    const picked = {};
+    for (const key of offendingKeys) {
+        picked[key] = propMap[key];
+    }
+    return { type: 'object', properties: picked };
+}
 /** Builds an error CallToolResult with structured payload (echoed into text + structuredContent). */
 export function errorResult(payload) {
     const body = {
@@ -31,21 +70,36 @@ export function errorResult(payload) {
  * 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) {
+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);
         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.',
+            suggestion: `Call ${gatewayName} with { tool: "${toolName}" } to see ` +
+                'the full expected schema, then retry with corrected arguments.',
             details: {
                 issues: parsed.error.issues,
-                expected_schema: inputSchemaJson(entry),
+                // 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":"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"}
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/execute.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -14,7 +14,7 @@
  *        Routed through the CapturingServer to the real server. Appear in
  *        `tools/list` as first-class entries (Cursor-cap-safe).
  *
- *   L2 — advanced captured (9 tools)
+ *   L2 — advanced captured (10 tools)
  *        Routed through the CapturingServer into its in-process advanced
  *        registry; reachable via the two `yootheme_builder_advanced*` gateway
  *        tools below. Hidden from `tools/list`.
@@ -22,13 +22,13 @@
  *   Gateways — `yootheme_builder_advanced` + `yootheme_builder_advanced_read`
  *        Registered LAST on the real server, after every L1/L2 tool is
  *        placed and the advanced registry is final. `advanced` (write-capable)
- *        routes all 9 advanced tools; `advanced_read` (F200a — itself
+ *        routes all 10 advanced tools; `advanced_read` (F200a — itself
  *        readOnly-annotated) routes only the 6 read-only advanced tools so MCP
  *        hosts can auto-allow pure inspection without a per-call write prompt.
  *        Both share the same advanced registry (read-filtered for the sibling).
  *
  * Result: `tools/list.length === 41` (37 L1 + 2 L3 + 2 gateways), and the full
- * callable tool surface is 50 (41 advertised + 9 advanced reachable through the
+ * callable tool surface is 51 (41 advertised + 10 advanced reachable through the
  * gateways). The `tool-catalog-markdown` generator derives these same counts
  * from the compiled `buildAllTools()` registry — see `scripts/extract-tools.mjs`.
  *

package/dist/server.js

@@ -14,7 +14,7 @@
  *        Routed through the CapturingServer to the real server. Appear in
  *        `tools/list` as first-class entries (Cursor-cap-safe).
  *
- *   L2 — advanced captured (9 tools)
+ *   L2 — advanced captured (10 tools)
  *        Routed through the CapturingServer into its in-process advanced
  *        registry; reachable via the two `yootheme_builder_advanced*` gateway
  *        tools below. Hidden from `tools/list`.
@@ -22,13 +22,13 @@
  *   Gateways — `yootheme_builder_advanced` + `yootheme_builder_advanced_read`
  *        Registered LAST on the real server, after every L1/L2 tool is
  *        placed and the advanced registry is final. `advanced` (write-capable)
- *        routes all 9 advanced tools; `advanced_read` (F200a — itself
+ *        routes all 10 advanced tools; `advanced_read` (F200a — itself
  *        readOnly-annotated) routes only the 6 read-only advanced tools so MCP
  *        hosts can auto-allow pure inspection without a per-call write prompt.
  *        Both share the same advanced registry (read-filtered for the sibling).
  *
  * Result: `tools/list.length === 41` (37 L1 + 2 L3 + 2 gateways), and the full
- * callable tool surface is 50 (41 advertised + 9 advanced reachable through the
+ * callable tool surface is 51 (41 advertised + 10 advanced reachable through the
  * gateways). The `tool-catalog-markdown` generator derives these same counts
  * from the compiled `buildAllTools()` registry — see `scripts/extract-tools.mjs`.
  *

package/dist/sites/tools/sites-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sites-list.d.ts","sourceRoot":"","sources":["../../../src/sites/tools/sites-list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAIH,KAAK,iBAAiB,EACzB,MAAM,6BAA6B,CAAC;AA+BrC;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,iBAAiB,CAqE5E"}
+{"version":3,"file":"sites-list.d.ts","sourceRoot":"","sources":["../../../src/sites/tools/sites-list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAIH,KAAK,iBAAiB,EACzB,MAAM,6BAA6B,CAAC;AAsDrC;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,iBAAiB,CAsE5E"}

package/dist/sites/tools/sites-list.js

@@ -43,12 +43,31 @@ const SITES_LIST_OUTPUT_SCHEMA = z.object({
         site_id: z.string(),
         url: z.string(),
         platform_hint: z.enum(['wordpress', 'joomla', 'auto']),
-        platform_resolved: z.enum(['wordpress', 'joomla']).optional(),
+        // ELEMENT_WRITE-24: platform_resolved is the platform CONFIRMED by a
+        // successful resolve — ABSENT until the site has resolved at least
+        // once (until then only platform_hint, the pre-resolve guess, exists).
+        platform_resolved: z
+            .enum(['wordpress', 'joomla'])
+            .optional()
+            .describe('Platform CONFIRMED by a successful resolve. Absent until the site ' +
+            'resolves at least once — "not yet probed", not "unknown". Before ' +
+            'that only `platform_hint` (the pre-resolve guess) is present.'),
         is_default: z.boolean(),
         label: z.string().optional(),
     })),
     total: z.number(),
-    default_site_id: z.string().nullable(),
+    // ELEMENT_WRITE-24 + SOURCES_BINDING-30: the CONFIGURED default site — the
+    // write target when a tool call OMITS site_id. Distinct from diagnose's
+    // `process_default_site_id` (the resolved active default for the running
+    // process): THIS is the statically-configured default; that is what a call
+    // actually resolved to. null when no default is configured.
+    default_site_id: z
+        .string()
+        .nullable()
+        .describe('The CONFIGURED default site — the write target used when a tool call ' +
+        'omits site_id. Distinct from diagnose\'s `process_default_site_id` ' +
+        '(the resolved active default): this is the configured default, that ' +
+        'is what a call resolved to. null when none is configured.'),
     _meta: z
         .object({
         tool_kind: z.string(),
@@ -80,6 +99,7 @@ export function buildSitesListTool(registry) {
             'site_ids before targeting one with any other tool. Read-only, no REST calls. ' +
             'Keywords: list sites, list connections, list installations, discover site_id, ' +
             'available sites, configured sites, what sites exist, multi-site index. ' +
+            'The `default_site_id` is the write target when a call omits site_id. ' +
             '(site_id is accepted for schema-uniformity but ignored by this tool.)',
         inputSchema: {
             site_id: SITE_ID_SCHEMA,

package/dist/sites/tools/sites-list.js.map

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

package/dist/tools/elements/builders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/elements/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAI7D,OAAO,EAOH,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAIH,KAAK,mBAAmB,EAU3B,MAAM,eAAe,CAAC;AAEvB;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAC9B,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACpC,SAAS,iBAAiB,EAAE,CAkX9B"}
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/elements/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAI7D,OAAO,EAOH,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAIH,KAAK,mBAAmB,EAU3B,MAAM,eAAe,CAAC;AAEvB;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAC9B,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACpC,SAAS,iBAAiB,EAAE,CAga9B"}

package/dist/tools/elements/builders.js

@@ -34,10 +34,11 @@ export function buildElementsTools(pool, deps) {
     return [
         defineTool({
             name: 'yootheme_builder_element_list',
-            description: 'List elements in a template as a flat array with JSON-Pointer paths + ' +
-                'types. Scope with `root_path`/`depth` for a subtree, paginate with ' +
-                '`limit`/`cursor` for large templates. `fields[]` narrows each row; ' +
-                '`max_chars` bounds the text output. ' +
+            description: 'List elements in a template as a flat array with JSON-Pointer paths + types + ' +
+                '`label` (the builder-assigned name; "" when unset — not that the type lacks one). ' +
+                'Scope with `root_path`/`depth` for a subtree, paginate with `limit`/`cursor` for ' +
+                'large templates. `fields[]` narrows each row; `max_chars` bounds the text output. ' +
+                'template_id only — resolve a URL/post first via pages_resolve. ' +
                 'Operates on the default site unless site_id is provided.',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
@@ -73,13 +74,18 @@ export function buildElementsTools(pool, deps) {
         }),
         defineTool({
             name: 'yootheme_builder_element_get',
-            description: 'Get the full element object at a specific JSON-Pointer path, including props ' +
-                'and children. Use yootheme_builder_element_list to discover paths. ' +
+            description: 'Get the full element object at a specific JSON-Pointer path, including props and a ' +
+                '`children_count` (NOT the children themselves — use yootheme_builder_element_list ' +
+                'with root_path to enumerate children). `fields[]` narrows the returned object; ' +
+                '`max_chars` bounds the text output. Address by template_id only — resolve a ' +
+                'URL/post first via pages_resolve. ' +
                 'Operates on the default site unless site_id is provided.',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
                 template_id: TEMPLATE_ID,
                 element_path: ELEMENT_PATH,
+                fields: FIELDS,
+                max_chars: MAX_CHARS,
             },
             outputSchema: ELEMENT_GET_OUTPUT_SCHEMA,
             annotations: readOnly('Get Element'),
@@ -87,14 +93,14 @@ export function buildElementsTools(pool, deps) {
         }),
         defineTool({
             name: 'yootheme_builder_layout_query',
-            description: 'Find elements in a template by a structured filter — no syntax, no ' +
-                'expression language. AND-combine any of: `type` (one type or a list), ' +
-                '`name_matches` (case-insensitive substring of the element name), ' +
-                '`has_binding` (bound vs unbound), `max_depth` (cap descent — 0 = ' +
-                'top-level), `under_section` (only nodes inside a named section). ' +
-                'Returns matching rows {path, element_type, label, has_binding}; ' +
-                'paginate with `limit`/`cursor`, narrow rows with `fields[]`, bound ' +
-                'text with `max_chars`. Operates on the default site unless site_id is provided.',
+            description: 'Find elements in a template by a structured filter (no expression language). ' +
+                'AND-combine any of: `type` (one type or a list), `name_matches` (case-insensitive ' +
+                'substring of the element name), `has_binding` (bound vs unbound), `max_depth` ' +
+                '(cap descent — 0 = top-level), `under_section` (only nodes inside a named ' +
+                'section). template_id only — resolve a URL/post first via pages_resolve. Returns ' +
+                'matching rows {path, element_type, label, has_binding}; paginate with ' +
+                '`limit`/`cursor`, narrow rows with `fields[]`, bound text with `max_chars`. ' +
+                'Operates on the default site unless site_id is provided.',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
                 template_id: TEMPLATE_ID,
@@ -146,8 +152,11 @@ export function buildElementsTools(pool, deps) {
             name: 'yootheme_builder_element_add',
             description: 'Add a new element to a template. Provide `parent_path` (or "" for root), ' +
                 '`element_type` (e.g. "headline", "text", "grid"), and optional `props` / ' +
-                '`children`. Appends by default; pass `index` (0 = first) to insert before ' +
-                'siblings. Returns the new element\'s JSON-Pointer path. Requires ETag. ' +
+                '`children`. Content/leaf elements may only be added inside a `column`; only ' +
+                '`section` is valid at the root — call yootheme_builder_scaffold_section first ' +
+                'for a valid column path. Appends by default; pass `index` (0 = first) to insert. ' +
+                'Inserting renumbers later siblings — re-read paths via element_list after any ' +
+                'structural write. Returns the new element\'s JSON-Pointer path. Requires ETag. ' +
                 'Operates on the default site unless site_id is provided.',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
@@ -174,11 +183,26 @@ export function buildElementsTools(pool, deps) {
                     .optional()
                     .describe('Alias of `element_type` — use `element_type`. Accepted so a ' +
                     'verbatim call with the wrong key still lands.'),
+                // ELEMENT_WRITE-4 (part 2): the human-visible builder name is a
+                // FIRST-CLASS arg — it is node-level metadata (OUTSIDE `props`,
+                // surfaced as element_list `label`), the primary handle a
+                // customer finds an element by. Threaded to the node's top-level
+                // `name`, never buried inside props.
+                name: z
+                    .string()
+                    .optional()
+                    .describe('Optional human-visible builder name for the new element — the label ' +
+                    'shown in the builder tree and element_list `label`. Stored as the ' +
+                    'node-level `name` (OUTSIDE `props`), not a prop.'),
                 props: PROPS.optional(),
                 children: z
                     .array(z.record(z.string(), z.unknown()))
                     .optional()
-                    .describe('Optional initial children — array of element objects.'),
+                    .describe('Optional initial children — array of element objects. Each child object ' +
+                    'names its type with the `type` key (NOT `element_type`), plus optional ' +
+                    '`props` and nested `children` that recurse. Inline children ARE ' +
+                    'validated (reserved-key + prop-typo + live-schema guards), the same as ' +
+                    'top-level props.'),
                 // F70 (2026-06-10): optional insertion index. Default (absent)
                 // appends. 0 = first child; an over-shot index is clamped to
                 // the end server-side. `position` is accepted as an alias.
@@ -212,6 +236,15 @@ export function buildElementsTools(pool, deps) {
                 template_id: TEMPLATE_ID,
                 element_path: ELEMENT_PATH,
                 props: PROPS,
+                // ELEMENT_WRITE-4 (part 2): rename the element via its
+                // first-class node-level `name` (OUTSIDE `props`) — the builder
+                // tree label / element_list `label`. Omit to leave it unchanged.
+                name: z
+                    .string()
+                    .optional()
+                    .describe('Optional new human-visible builder name for the element — the ' +
+                    'label in the builder tree / element_list `label`. Stored as the ' +
+                    'node-level `name` (OUTSIDE `props`). Omit to leave it unchanged.'),
                 merge: z
                     .boolean()
                     .optional()
@@ -233,8 +266,9 @@ export function buildElementsTools(pool, deps) {
         defineTool({
             name: 'yootheme_builder_element_move',
             description: 'Move an element to a new parent + index in the tree. Useful for reordering or ' +
-                'reparenting (e.g. moving a card from one grid column to another). Requires ETag. ' +
-                'Operates on the default site unless site_id is provided.',
+                'reparenting (e.g. moving a card from one grid column to another). Moving renumbers ' +
+                'later siblings — re-read paths via element_list after any structural write. ' +
+                'Requires ETag. Operates on the default site unless site_id is provided.',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
                 template_id: TEMPLATE_ID,
@@ -246,7 +280,9 @@ export function buildElementsTools(pool, deps) {
                     .number()
                     .int()
                     .min(0)
-                    .describe('Zero-based index within the destination parent.'),
+                    .describe('Zero-based index within the destination parent, applied AFTER the element ' +
+                    'is removed from its current position — so a same-parent move uses ' +
+                    'post-removal indexing (with 4 items, move-to-last is to_index:3, not 4).'),
                 etag: ETAG,
             },
             annotations: mutating('Move Element'),
@@ -255,7 +291,8 @@ export function buildElementsTools(pool, deps) {
         defineTool({
             name: 'yootheme_builder_element_clone',
             description: 'Clone an element as a sibling (same parent, immediately after the source). ' +
-                'Returns the new element\'s path. Requires ETag. ' +
+                'Returns the new element\'s path. Cloning renumbers later siblings — re-read paths ' +
+                'via element_list after any structural write. Requires ETag. ' +
                 'Operates on the default site unless site_id is provided.',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
@@ -268,13 +305,13 @@ export function buildElementsTools(pool, deps) {
         }),
         defineTool({
             name: 'yootheme_builder_scaffold_section',
-            description: 'Create a VALID section → row → column hull in ONE atomic call and return the ' +
-                'column JSON-Pointer path(s) to drop content into. This is the EASIEST correct ' +
-                'way to start a new layout block: YOOtheme content must live in ' +
-                'section → row → column, and adding content anywhere else (root, bare section, ' +
-                'bare row) is rejected. Pass `columns` (1-12, default 1) for a multi-column row; ' +
-                'columns are auto-distributed equal-width so they render side-by-side, or pass ' +
-                '`column_widths` (one token per column) for an asymmetric row. Requires ETag. ' +
+            description: 'Create a VALID section → row → column hull in ONE call; returns the column ' +
+                'JSON-Pointer path(s) for content. The correct way to start a layout block: only ' +
+                '`section` may sit at the layout root; a bare section accepts `row`, a bare row ' +
+                'accepts `column`; leaf/content elements are rejected anywhere except inside a ' +
+                '`column`. Pass `columns` (1-12, default 1); columns get width tokens so they ' +
+                'render side-by-side (hand-built columns default to full width), or `column_widths` ' +
+                '(one token per column) for an asymmetric row. Requires ETag. ' +
                 'Operates on the default site unless site_id is provided.',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
@@ -303,9 +340,10 @@ export function buildElementsTools(pool, deps) {
         defineTool({
             name: 'yootheme_builder_element_delete',
             description: 'PERMANENTLY delete an element + children. Cannot be undone. Pass `confirm: ' +
-                'true` (boolean) AND a fresh ETag. If `preview:true` returns despite confirm, ' +
-                'check `details.received_confirm` — strings/numbers accepted, but boolean is ' +
-                'canonical. Operates on the default site unless site_id is provided.',
+                'true` (boolean) AND a fresh ETag. Deleting renumbers later siblings — re-read ' +
+                'paths via element_list after any structural write. If `preview:true` returns ' +
+                'despite confirm, check `details.received_confirm` — strings/numbers accepted, ' +
+                'but boolean is canonical. Operates on the default site unless site_id is provided.',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
                 template_id: TEMPLATE_ID,