@wootsup/yt-builder-mcp 1.12.0 → 2.0.0

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

@@ -1,106 +1,42 @@
-/**
- * `yootheme_builder_advanced_read` — a READ-ONLY sibling of the
- * `yootheme_builder_advanced` gateway (F200a, 2026-06-12).
- *
- * The Desktop-E2E #2 forensic showed approval-gates firing on EVERY advanced
- * call. Root cause: the single `yootheme_builder_advanced` gateway is annotated
- * `readOnlyHint:false` + `destructiveHint:true` (correctly — it can route into
- * delete / unbind handlers), so spec-compliant MCP hosts gate it
- * conservatively. The read-only L2 subtools (page_get_schema,
- * element_get_binding, inspect_sublayout) inherited that gate even though they
- * mutate nothing — a per-call approval tax on pure inspection.
- *
- * This second gateway WHITELISTS only read-only advanced entries (annotation
- * `readOnlyHint:true`) and is itself annotated `readOnly()`, so hosts can
- * auto-allow it. Writing subtools (unbind, clean-implode) stay reachable ONLY
- * through the existing (gated) `yootheme_builder_advanced` — defense-in-depth:
- * the read gateway physically cannot route to them (they are not in its
- * registry view).
- *
- * Two modes mirror the write gateway:
- *   { tool }            → discovery (target schema + annotations; no invoke).
- *   { tool, arguments } → execution (strict-validated, then handler called).
- *
- * @license MIT
- */
 import { z } from 'zod';
+import { strictInputObject } from '../tools/strict-input.js';
 import { readOnly } from '../tools/tool-builder.js';
 import { isEssential, isDirectTopLevel } from './essentials.js';
-import { discoveryResult } from './advanced-tool/discovery.js';
-import { renderGroupedList } from './advanced-tool/domains.js';
+import { discoveryResult, requiredArgsFromRegistry } from './advanced-tool/discovery.js';
+import { FIRST_CLASS_NOT_ABSENT_HINT, renderGroupedList, resolveShortToolName, } from './advanced-tool/domains.js';
 import { errorResult, executeAdvancedTool } from './advanced-tool/execute.js';
-/** The pinned name — never rename (host configs + skill docs reference it). */
 export const ADVANCED_READ_TOOL_NAME = 'yootheme_builder_advanced_read';
-/**
- * True iff a captured advanced entry advertises `readOnlyHint:true`. The
- * single source of truth for "is this subtool safe to auto-allow" — the same
- * annotation the host reads. No name allowlist to drift: adding a new
- * read-only advanced tool surfaces here automatically.
- */
 function isReadOnlyEntry(entry) {
     const annotations = entry.config.annotations;
     return annotations?.readOnlyHint === true;
 }
-/**
- * Builds the read-gateway's input schema.
- *
- * F205 (P2): `tool` is a free z.string(), NOT a z.enum — same trap as the write
- * gateway. The MCP SDK validates the inputSchema before the handler runs; an
- * enum rejected first-class names with a raw McpError -32602 so the handler's
- * not_read_only / first_class_tool / unknown steering never ran. A plain string
- * lets every name reach the handler.
- */
 function readGatewayInputSchema() {
     return {
-        tool: z.string().describe('Read-only advanced tool to route to (e.g. "yootheme_builder_page_get_schema"). ' +
+        tool: z.string().describe('Read-only advanced tool to route to (e.g. "yootheme_builder_pages_audit"). ' +
             'Must be one of the read-only advanced tools listed in this description. ' +
             'First-class tools (yootheme_builder_health, ...) are called DIRECTLY; ' +
             'writing tools use yootheme_builder_advanced. ' +
             '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` (same back-compat carve
-        // the write gateway makes — see register.ts F107).
         input: z.record(z.string(), z.unknown()).optional().describe('Alias for `arguments` (tolerated for back-compat). Prefer `arguments`.'),
     };
 }
-/** Builds the read-gateway's description, listing only the whitelisted read-only tools. */
-function buildReadDescription(readOnlyNames) {
+function buildReadDescription(readOnlyNames, required) {
     const count = readOnlyNames.length;
-    return (`Routes to ${String(count)} READ-ONLY advanced YOOtheme Builder tool` +
-        `${count === 1 ? '' : 's'}. ` +
-        // 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.
-        '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. ' +
-        // 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 (customer 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` +
-        'Writing tools (unbind, clean-implode): use yootheme_builder_advanced. ' +
+    return (`Routes to ${String(count)} READ-ONLY advanced tool${count === 1 ? '' : 's'}. ` +
+        'Every tool in tools/list is FIRST-CLASS: call it directly, never via this gateway. ' +
+        'Itself read-only — prefer it over yootheme_builder_advanced for inspection. ' +
+        'One-call site-wide SEO/structure/content/links audit: yootheme_builder_pages_audit — ' +
+        'route a whole-site audit request here instead of looping page-by-page reads. ' +
+        '`site_id` and every other argument the target tool declares go INSIDE ' +
+        '`arguments`, never beside `tool`.' +
+        '\n\nAvailable read-only advanced tools by domain (needs \u2026 = required arguments):\n' +
+        `${renderGroupedList(readOnlyNames, required)}\n\n` +
+        'Writing tools (clean-implode, modules_update): use yootheme_builder_advanced. ' +
         'Connectivity: yootheme_builder_health / yootheme_builder_diagnose.');
 }
-/**
- * Registers `yootheme_builder_advanced_read` on the real McpServer.
- *
- * @param realServer       the McpServer that exposes the read gateway tool
- * @param advancedRegistry the captured non-essential tools (from CapturingServer)
- */
 export function registerAdvancedReadTool(realServer, advancedRegistry) {
-    // Build the read-only view of the registry — the gateway literally cannot
-    // see (let alone route to) writing tools.
     const readOnlyRegistry = new Map();
     for (const [name, entry] of advancedRegistry) {
         if (isReadOnlyEntry(entry)) {
@@ -108,61 +44,57 @@ export function registerAdvancedReadTool(realServer, advancedRegistry) {
         }
     }
     const readOnlyNames = [...readOnlyRegistry.keys()].sort();
+    const requiredArgs = requiredArgsFromRegistry(readOnlyRegistry);
     realServer.registerTool(ADVANCED_READ_TOOL_NAME, {
         title: 'Advanced Read-Only Gateway',
-        description: buildReadDescription(readOnlyNames),
-        inputSchema: readGatewayInputSchema(),
-        // F200a: read-only annotation so hosts auto-allow. Unlike the write
-        // gateway, this one can never reach a mutating handler.
-        annotations: readOnly('Advanced Read-Only Gateway'),
+        description: buildReadDescription(readOnlyNames, requiredArgs),
+        inputSchema: strictInputObject(ADVANCED_READ_TOOL_NAME, readGatewayInputSchema()),
+        annotations: { ...readOnly('Advanced Read-Only Gateway'), openWorldHint: true },
     }, async (args, extra) => {
-        const entry = readOnlyRegistry.get(args.tool);
+        const tool = resolveShortToolName(args.tool, (candidate) => readOnlyRegistry.has(candidate) ||
+            advancedRegistry.has(candidate) ||
+            isEssential(candidate) ||
+            isDirectTopLevel(candidate));
+        const entry = readOnlyRegistry.get(tool);
         if (!entry) {
-            // F205: a WRITE subtool name that exists in the FULL advanced
-            // registry but not the read whitelist gets a targeted steer to
-            // the write gateway. This branch MUST stay ahead of the
-            // first_class_tool check (an advanced write subtool is not a
-            // first-class tool).
-            if (advancedRegistry.has(args.tool)) {
+            if (advancedRegistry.has(tool)) {
                 return errorResult({
-                    message: `"${args.tool}" is not a read-only tool — it mutates state and is not ` +
+                    message: `"${tool}" is not a read-only tool — it mutates state and is not ` +
                         'reachable through yootheme_builder_advanced_read.',
                     code: 'not_read_only',
                     suggestion: `Call it through the full gateway instead: ` +
-                        `yootheme_builder_advanced({ tool: "${args.tool}", arguments: {...} }).`,
-                    details: { tool: args.tool },
+                        `yootheme_builder_advanced({ tool: "${tool}", arguments: {...} }).`,
+                    details: { tool },
                 });
             }
-            // F205: a first-class tool (L1 essential or L3 direct
-            // top-level) is steered to a direct call rather than treated
-            // as a typo.
-            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_read. This gateway only routes the read-only ' +
-                        '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 read-only advanced tools listed in its ' +
+                        'description. ' +
+                        FIRST_CLASS_NOT_ABSENT_HINT,
+                    details: { tool },
                 });
             }
             return errorResult({
                 message: `Unknown read-only advanced tool: "${args.tool}".`,
                 code: 'unknown_read_tool',
                 suggestion: 'This gateway routes ONLY read-only advanced tools. If you meant a ' +
-                    'WRITING tool (unbind, clean-implode), use yootheme_builder_advanced ' +
+                    'WRITING tool (clean-implode, modules_update), use yootheme_builder_advanced ' +
                     'instead. Otherwise pick one of the valid read-only tools below.\n\n' +
-                    `Valid read-only advanced tools by domain:\n${renderGroupedList(readOnlyNames)}`,
-                details: { valid_read_tools_by_domain: renderGroupedList(readOnlyNames) },
+                    `Valid read-only advanced tools by domain (needs \u2026 = required arguments):\n${renderGroupedList(readOnlyNames, requiredArgs)}`,
+                details: { valid_read_tools_by_domain: renderGroupedList(readOnlyNames, requiredArgs) },
             });
         }
-        // `arguments` is canonical; `input` is a tolerated alias (F107).
         const callArgs = args.arguments ?? args.input;
         if (callArgs === undefined)
-            return discoveryResult(args.tool, entry);
-        // 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);
+            return discoveryResult(tool, entry);
+        return executeAdvancedTool(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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAE9E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,uBAAuB,GAAG,gCAAgC,CAAC;AAExE;;;;;GAKG;AACH,SAAS,eAAe,CAAC,KAAwB;IAC7C,MAAM,WAAW,GAAI,KAAK,CAAC,MAAuD,CAAC,WAAW,CAAC;IAC/F,OAAO,WAAW,EAAE,YAAY,KAAK,IAAI,CAAC;AAC9C,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,sBAAsB;IAC3B,OAAO;QACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACrB,iFAAiF;YAC7E,0EAA0E;YAC1E,wEAAwE;YACxE,+CAA+C;YAC/C,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;QACD,uEAAuE;QACvE,mDAAmD;QACnD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACxD,wEAAwE,CAC3E;KACJ,CAAC;AACN,CAAC;AAED,2FAA2F;AAC3F,SAAS,oBAAoB,CAAC,aAAuB;IACjD,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC;IACnC,OAAO,CACH,aAAa,MAAM,CAAC,KAAK,CAAC,2CAA2C;QACrE,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI;QAC7B,wEAAwE;QACxE,wEAAwE;QACxE,mDAAmD;QACnD,uEAAuE;QACvE,2FAA2F;QAC3F,6DAA6D;QAC7D,4CAA4C;QAC5C,oEAAoE;QACpE,kEAAkE;QAClE,uEAAuE;QACvE,wEAAwE;QACxE,2EAA2E;QAC3E,0EAA0E;QAC1E,uEAAuE;QACvE,0EAA0E;QAC1E,sDAAsD;QACtD,wBAAwB;QACxB,2CAA2C;QAC3C,qDAAqD;QACrD,GAAG,iBAAiB,CAAC,aAAa,CAAC,MAAM;QACzC,wEAAwE;QACxE,oEAAoE,CACvE,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACpC,UAAqB,EACrB,gBAAgD;IAEhD,0EAA0E;IAC1E,0CAA0C;IAC1C,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA6B,CAAC;IAC9D,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,gBAAgB,EAAE,CAAC;QAC3C,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACtC,CAAC;IACL,CAAC;IACD,MAAM,aAAa,GAAG,CAAC,GAAG,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAE1D,UAAU,CAAC,YAAY,CACnB,uBAAuB,EACvB;QACI,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE,oBAAoB,CAAC,aAAa,CAAC;QAChD,WAAW,EAAE,sBAAsB,EAAE;QACrC,oEAAoE;QACpE,wDAAwD;QACxD,WAAW,EAAE,QAAQ,CAAC,4BAA4B,CAAC;KACtD,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,8DAA8D;YAC9D,+DAA+D;YAC/D,wDAAwD;YACxD,6DAA6D;YAC7D,qBAAqB;YACrB,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,OAAO,WAAW,CAAC;oBACf,OAAO,EACH,IAAI,IAAI,CAAC,IAAI,0DAA0D;wBACvE,mDAAmD;oBACvD,IAAI,EAAE,eAAe;oBACrB,UAAU,EACN,4CAA4C;wBAC5C,sCAAsC,IAAI,CAAC,IAAI,yBAAyB;oBAC5E,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;iBAC/B,CAAC,CAAC;YACP,CAAC;YACD,sDAAsD;YACtD,6DAA6D;YAC7D,aAAa;YACb,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxD,OAAO,WAAW,CAAC;oBACf,OAAO,EAAE,IAAI,IAAI,CAAC,IAAI,8DAA8D;oBACpF,IAAI,EAAE,kBAAkB;oBACxB,UAAU,EACN,SAAS,IAAI,CAAC,IAAI,2CAA2C;wBAC7D,yEAAyE;wBACzE,2CAA2C;oBAC/C,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;iBAC/B,CAAC,CAAC;YACP,CAAC;YACD,OAAO,WAAW,CAAC;gBACf,OAAO,EAAE,qCAAqC,IAAI,CAAC,IAAI,IAAI;gBAC3D,IAAI,EAAE,mBAAmB;gBACzB,UAAU,EACN,oEAAoE;oBACpE,sEAAsE;oBACtE,qEAAqE;oBACrE,8CAA8C,iBAAiB,CAAC,aAAa,CAAC,EAAE;gBACpF,OAAO,EAAE,EAAE,0BAA0B,EAAE,iBAAiB,CAAC,aAAa,CAAC,EAAE;aAC5E,CAAC,CAAC;QACP,CAAC;QACD,iEAAiE;QACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC;QAC9C,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACrE,uEAAuE;QACvE,+DAA+D;QAC/D,OAAO,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,uBAAuB,CAAC,CAAC;IAC3F,CAAC,CACJ,CAAC;AACN,CAAC"}
+{"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/discovery.d.ts

@@ -1,19 +1,8 @@
-/**
- * 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 type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import { type ZodRawShape } from 'zod';
 import type { AdvancedToolEntry } from '../capturing-server.js';
-/** Reads the captured config's inputSchema as a Zod raw-shape (or empty). */
 export declare function shapeOf(entry: AdvancedToolEntry): ZodRawShape;
-/** Builds a JSON-schema for a captured tool's inputs, with a defensive fallback. */
 export declare function inputSchemaJson(entry: AdvancedToolEntry): unknown;
-/** Builds the discovery-mode result for a target tool. */
+export declare function requiredArgsFromRegistry(registry: ReadonlyMap<string, AdvancedToolEntry>): Map<string, readonly string[]>;
 export declare function discoveryResult(toolName: string, entry: AdvancedToolEntry): CallToolResult;
 //# sourceMappingURL=discovery.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAK,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAE1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,6EAA6E;AAC7E,wBAAgB,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,WAAW,CAI7D;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAQjE;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,cAAc,CAsC1F"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/discovery.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAK,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAG1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,wBAAgB,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,WAAW,CAI7D;AAiBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAUjE;AAoBD,wBAAgB,wBAAwB,CACpC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACjD,GAAG,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAchC;AAGD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,cAAc,CAsC1F"}

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

@@ -1,45 +1,36 @@
-/**
- * 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). */
+import { normalizeJsonSchema } from '../../catalog/json-schema.js';
 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)));
+        const json = z.toJSONSchema(z.object(shapeOf(entry)));
+        normalizeJsonSchema(json);
+        return json;
     }
     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 requiredArgsFromRegistry(registry) {
+    const out = new Map();
+    for (const [name, entry] of registry) {
+        const schema = inputSchemaJson(entry);
+        const required = schema !== null && typeof schema === 'object'
+            ? schema.required
+            : undefined;
+        out.set(name, Array.isArray(required) ? required.filter((k) => typeof k === 'string') : []);
+    }
+    return out;
+}
 export function discoveryResult(toolName, entry) {
     const cfg = entry.config;
     const schema = inputSchemaJson(entry);
     const next = `Call yootheme_builder_advanced again with { tool: "${toolName}", arguments: {...} } to run it.`;
-    // `next` mirrors the closing instruction of the text block below. It was the
-    // one fact the text leg carried and this payload did not — and on the PHP
-    // WordPress transport the structured payload is the ONLY leg a caller gets
-    // (the mcp-adapter re-derives the text from the value the ability returns), so
-    // an unmirrored sentence disappears there. Kept in lockstep with the PHP
-    // payload in `src/modules/core-mcp/src/McpAdvancedGatewayHandler.php` — pinned
-    // on BOTH sides (`tests/contracts/gateway-discovery-next.test.ts` here,
-    // `tests/php/unit/Mcp/GatewayDiscoveryNextPinTest.php` there), because a
-    // comment is not a mechanism.
     const payload = {
         tool: toolName,
         description: cfg.description ?? '',

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

@@ -1 +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,IAAI,GACN,sDAAsD,QAAQ,kCAAkC,CAAC;IACrG,6EAA6E;IAC7E,0EAA0E;IAC1E,2EAA2E;IAC3E,+EAA+E;IAC/E,yEAAyE;IACzE,+EAA+E;IAC/E,wEAAwE;IACxE,yEAAyE;IACzE,8BAA8B;IAC9B,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;QAClC,IAAI;KACP,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,IAAI;aACX;SACJ;QACD,iBAAiB,EAAE,OAAO;KAC7B,CAAC;AACN,CAAC"}
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/discovery.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,CAAC,EAAoB,MAAM,KAAK,CAAC;AAE1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAInE,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;AAiBD,MAAM,UAAU,eAAe,CAAC,KAAwB;IACpD,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAW,CAAC;QAChE,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QAGL,OAAO,EAAE,IAAI,EAAE,mCAAmC,EAAE,CAAC;IACzD,CAAC;AACL,CAAC;AAoBD,MAAM,UAAU,wBAAwB,CACpC,QAAgD;IAEhD,MAAM,GAAG,GAAG,IAAI,GAAG,EAA6B,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,QAAQ,GACV,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ;YACzC,CAAC,CAAE,MAAiC,CAAC,QAAQ;YAC7C,CAAC,CAAC,SAAS,CAAC;QACpB,GAAG,CAAC,GAAG,CACH,IAAI,EACJ,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAC5F,CAAC;IACN,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAGD,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,IAAI,GACN,sDAAsD,QAAQ,kCAAkC,CAAC;IAUrG,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;QAClC,IAAI;KACP,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,IAAI;aACX;SACJ;QACD,iBAAiB,EAAE,OAAO;KAC7B,CAAC;AACN,CAAC"}

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

@@ -1,74 +1,15 @@
-/**
- * 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
- */
 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", "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 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 resolveShortToolName(name: string, isMember: (candidate: string) => boolean): string;
 export declare function domainOf(toolName: string): string;
-/**
- * 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 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;
-/**
- * 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 declare function buildDescription(toolNames: string[]): string;
-/** Re-export the AdvancedToolEntry type so consumers don't need a second import path. */
+export type RequiredArgsByTool = ReadonlyMap<string, readonly string[]>;
+export declare function renderGroupedList(toolNames: string[], required?: RequiredArgsByTool): string;
+export declare function gatewayCallFor(toolName: string, readOnlyTool: boolean): string;
+export declare function gatewayOnlyNote(toolName: string, readOnlyTool: boolean): string;
+export declare const FIRST_CLASS_NOT_ABSENT_HINT = "If your client does not show it, it is filtered or unloaded there \u2014 not absent.";
+export declare function buildDescription(toolNames: string[], required?: RequiredArgsByTool): string;
 export type { AdvancedToolEntry };
 //# sourceMappingURL=domains.d.ts.map

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,CAwB5D;AAED,yFAAyF;AACzF,YAAY,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/domains.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAShE,eAAO,MAAM,YAAY,wEAAyE,CAAC;AAkBnG,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;AA8B/C,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CAOnG;AAGD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQjD;AAeD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAgBxE;AASD,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;AAyBxE,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAQ5F;AAeD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,CAG9E;AAOD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,CAK/E;AAuBD,eAAO,MAAM,2BAA2B,yFAC6C,CAAC;AAGtF,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,MAAM,CA8B3F;AAGD,YAAY,EAAE,iBAAiB,EAAE,CAAC"}

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