@wootsup/yt-builder-mcp 1.1.7 → 1.3.0

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

@@ -22,21 +22,26 @@
 export const DOMAIN_ORDER = ['pages', 'elements', 'sources', 'multi-items', 'inspection'];
 /**
  * Prefix→domain routing table. Each domain accepts plural
- * (`pages_list`) + singular (`page_save`, `element_add`, `source_…`)
- * stems via `stem.startsWith(prefix + '_')` or full-equality. Anything
- * outside the taxonomy falls through to 'misc'.
+ * (`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'],
     sources: ['sources', 'source'],
     'multi-items': ['inspect_multi_items', 'clean_implode'],
-    inspection: ['inspection'],
+    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). */
@@ -76,6 +81,16 @@ export function renderGroupedList(toolNames) {
     }
     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) {
     const toolCount = toolNames.length;
@@ -84,11 +99,15 @@ export function buildDescription(toolNames) {
     const domainList = domains.join(', ');
     return (`Routes to ${String(toolCount)} advanced YOOtheme Builder tools across ${String(domainCount)} ` +
         `domain${domainCount === 1 ? '' : 's'}${domainCount > 0 ? ` (${domainList})` : ''}. ` +
-        'Call with { tool } for a target\'s schema + annotations, or ' +
-        '{ tool, arguments } to run it. The target tool\'s own confirmation ' +
-        'guards and behavior stay in effect.\n\n' +
-        'Available advanced tools by domain:\n' +
+        // 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 advanced tools listed below — every tool that appears ' +
+        'directly in tools/list is FIRST-CLASS: call it directly, never via this gateway. ' +
+        '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` +
-        'For connectivity diagnostics use yootheme_builder_health or yootheme_builder_diagnose (top-level).');
+        '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":"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,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,SAAmB;IAC7C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,KAAK,MAAM,MAAM,IAAI,YAAY;QAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC1D,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,iBAAiB,CAAC,SAAmB;IACjD,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;;;;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,iEAAiE;QACjE,oDAAoD;QACpD,2CAA2C;QAC3C,GAAG,iBAAiB,CAAC,SAAS,CAAC,MAAM;QACrC,oEAAoE,CACvE,CAAC;AACN,CAAC"}

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;AAmBhE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,UAAU,EAAE,SAAS,EACrB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACjD,IAAI,CA+CN"}
+{"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"}

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

@@ -7,16 +7,37 @@
  * @license MIT
  */
 import { z } from 'zod';
+import { isEssential, isDirectTopLevel } from '../essentials.js';
 import { buildDescription, renderGroupedList } from './domains.js';
 import { discoveryResult } from './discovery.js';
 import { errorResult, executeAdvancedTool } from './execute.js';
-/** Builds the gateway tool's Zod inputSchema for a given non-empty enum of advanced names. */
-function gatewayInputSchema(enumValues) {
+/**
+ * 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.enum(enumValues).describe('Advanced tool to route to (e.g. "yootheme_builder_page_save"). ' +
+        tool: z.string().describe('Advanced tool to route to (e.g. "yootheme_builder_page_get_schema"). ' +
+            '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`.'),
     };
 }
 /**
@@ -27,15 +48,10 @@ function gatewayInputSchema(enumValues) {
  */
 export function registerAdvancedTool(realServer, advancedRegistry) {
     const advancedNames = [...advancedRegistry.keys()].sort();
-    // z.enum needs a non-empty tuple. The empty-registry arm is exercised
-    // only by defensive test wiring; production always populates the
-    // registry. Keeping the guard means a zero-tool wiring still yields a
-    // valid (if inert) gateway schema rather than a z.enum crash.
-    const enumValues = advancedNames.length > 0 ? advancedNames : ['__none__'];
     realServer.registerTool('yootheme_builder_advanced', {
         title: 'Advanced Tool Gateway',
         description: buildDescription(advancedNames),
-        inputSchema: gatewayInputSchema(enumValues),
+        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
@@ -52,6 +68,20 @@ export function registerAdvancedTool(realServer, advancedRegistry) {
     }, async (args, extra) => {
         const entry = advancedRegistry.get(args.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)) {
+                return errorResult({
+                    message: `"${args.tool}" is a FIRST-CLASS tool — it appears directly in tools/list.`,
+                    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 },
+                });
+            }
             return errorResult({
                 message: `Unknown advanced tool: "${args.tool}".`,
                 code: 'unknown_tool',
@@ -61,9 +91,11 @@ export function registerAdvancedTool(realServer, advancedRegistry) {
                 details: { valid_tools_by_domain: renderGroupedList(advancedNames) },
             });
         }
-        if (args.arguments === undefined)
+        // `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, args.arguments, extra);
+        return executeAdvancedTool(args.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":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEhE,8FAA8F;AAC9F,SAAS,kBAAkB,CAAC,UAAiC;IACzD,OAAO;QACH,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,CAC7B,iEAAiE;YAC7D,gDAAgD,CACvD;QACD,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC5D,yDAAyD;YACrD,4CAA4C,CACnD;KACJ,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAChC,UAAqB,EACrB,gBAAgD;IAEhD,MAAM,aAAa,GAAG,CAAC,GAAG,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAE1D,sEAAsE;IACtE,iEAAiE;IACjE,sEAAsE;IACtE,8DAA8D;IAC9D,MAAM,UAAU,GACZ,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAE,aAAuC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAEvF,UAAU,CAAC,YAAY,CACnB,2BAA2B,EAC3B;QACI,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE,gBAAgB,CAAC,aAAa,CAAC;QAC5C,WAAW,EAAE,kBAAkB,CAAC,UAAU,CAAC;QAC3C,yDAAyD;QACzD,oDAAoD;QACpD,2DAA2D;QAC3D,yDAAyD;QACzD,0DAA0D;QAC1D,iDAAiD;QACjD,WAAW,EAAE;YACT,KAAK,EAAE,uBAAuB;YAC9B,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACtB;KACJ,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAA2B,EAAE;QAC3C,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,WAAW,CAAC;gBACf,OAAO,EAAE,2BAA2B,IAAI,CAAC,IAAI,IAAI;gBACjD,IAAI,EAAE,cAAc;gBACpB,UAAU,EACN,2DAA2D;oBAC3D,qDAAqD;oBACrD,oCAAoC,iBAAiB,CAAC,aAAa,CAAC,EAAE;gBAC1E,OAAO,EAAE,EAAE,qBAAqB,EAAE,iBAAiB,CAAC,aAAa,CAAC,EAAE;aACvE,CAAC,CAAC;QACP,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3E,OAAO,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACxE,CAAC,CACJ,CAAC;AACN,CAAC"}
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/gateway/advanced-tool/register.ts"],"names":[],"mappings":"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"}

package/dist/gateway/essentials.d.ts

@@ -16,11 +16,21 @@
  *                                 SDK never sees a duplicate registration.
  *
  * Why this split: Cursor caps MCP servers at ~40 tools. This adapter
- * declares 27 callable tools (19 domain L1/L3 + 7 advanced L2 + 1 gateway).
- * The 3-lane shape keeps `tools/list` at 17 (L1) + 2 (L3) + 1 (gateway) =
- * 20 entries, well under the cap, while every tool stays fully reachable
+ * declares 31 callable tools (26 domain L1/L3 + 4 advanced L2 + 1 gateway).
+ * The 3-lane shape keeps `tools/list` at 24 (L1) + 2 (L3) + 1 (gateway) =
+ * 27 entries, well under the cap, while every tool stays fully reachable
  * (advanced tools through `yootheme_builder_advanced`).
  *
+ * F116 (2026-06-11): the bind→save→publish chain (element_bind_source,
+ * page_save, page_publish) was promoted from the advanced lane to L1. It is
+ * the #1 dynamic-content workflow; hiding it behind the gateway made an agent
+ * listing tools see element_add but neither bind nor publish — a likely
+ * "can't publish" deadend. L1 20→23, advanced 7→4.
+ *
+ * P-G (Goldstandard wave 3): page_dynamize was added as a new registered tool
+ * and promoted to L1 (the one-call dynamize-existing-section path). With the
+ * F116 trio it brings L1 to 24, advanced stays 4, surface to 27.
+ *
  * Health + diagnose live in L3 because they MUST be the first thing an
  * LLM-host calls when something is broken; routing them through a gateway
  * would create a chicken-and-egg loop (the LLM would have to discover
@@ -32,7 +42,7 @@
  * L1 — Tools kept as first-class entries in `tools/list`.
  * Forwarded by the CapturingServer to the real McpServer.
  */
-export declare const ESSENTIAL_TOOLS: readonly ["yootheme_builder_pages_list", "yootheme_builder_get_etag", "yootheme_builder_element_list", "yootheme_builder_element_add", "yootheme_builder_element_update_settings", "yootheme_builder_sources_list", "yootheme_builder_element_types_list", "yootheme_builder_inspect_multi_items_binding", "yootheme_builder_element_get", "yootheme_builder_element_delete", "yootheme_builder_element_clone", "yootheme_builder_element_move", "yootheme_builder_page_get_layout", "yootheme_builder_template_summary", "yootheme_builder_element_type_get_schema", "yootheme_builder_sites_list", "yootheme_builder_sites_test"];
+export declare const ESSENTIAL_TOOLS: readonly ["yootheme_builder_pages_list", "yootheme_builder_get_etag", "yootheme_builder_element_list", "yootheme_builder_element_add", "yootheme_builder_element_update_settings", "yootheme_builder_sources_list", "yootheme_builder_element_types_list", "yootheme_builder_inspect_multi_items_binding", "yootheme_builder_element_get", "yootheme_builder_element_delete", "yootheme_builder_element_clone", "yootheme_builder_element_move", "yootheme_builder_page_get_layout", "yootheme_builder_template_summary", "yootheme_builder_element_type_get_schema", "yootheme_builder_sites_list", "yootheme_builder_sites_test", "yootheme_builder_use_site", "yootheme_builder_pages_create", "yootheme_builder_pages_delete", "yootheme_builder_element_bind_source", "yootheme_builder_page_save", "yootheme_builder_page_publish", "yootheme_builder_page_dynamize", "yootheme_builder_scaffold_section"];
 /**
  * L3 — Tools registered DIRECTLY on the real McpServer, BEFORE the
  * CapturingServer wraps it. The CapturingServer treats these names as a

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

@@ -1 +1 @@
-{"version":3,"file":"essentials.d.ts","sourceRoot":"","sources":["../../src/gateway/essentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,qmBAuClB,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,mEAGzB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD"}
+{"version":3,"file":"essentials.d.ts","sourceRoot":"","sources":["../../src/gateway/essentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,k3BA+ElB,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,mEAGzB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/gateway/essentials.js

@@ -16,11 +16,21 @@
  *                                 SDK never sees a duplicate registration.
  *
  * Why this split: Cursor caps MCP servers at ~40 tools. This adapter
- * declares 27 callable tools (19 domain L1/L3 + 7 advanced L2 + 1 gateway).
- * The 3-lane shape keeps `tools/list` at 17 (L1) + 2 (L3) + 1 (gateway) =
- * 20 entries, well under the cap, while every tool stays fully reachable
+ * declares 31 callable tools (26 domain L1/L3 + 4 advanced L2 + 1 gateway).
+ * The 3-lane shape keeps `tools/list` at 24 (L1) + 2 (L3) + 1 (gateway) =
+ * 27 entries, well under the cap, while every tool stays fully reachable
  * (advanced tools through `yootheme_builder_advanced`).
  *
+ * F116 (2026-06-11): the bind→save→publish chain (element_bind_source,
+ * page_save, page_publish) was promoted from the advanced lane to L1. It is
+ * the #1 dynamic-content workflow; hiding it behind the gateway made an agent
+ * listing tools see element_add but neither bind nor publish — a likely
+ * "can't publish" deadend. L1 20→23, advanced 7→4.
+ *
+ * P-G (Goldstandard wave 3): page_dynamize was added as a new registered tool
+ * and promoted to L1 (the one-call dynamize-existing-section path). With the
+ * F116 trio it brings L1 to 24, advanced stays 4, surface to 27.
+ *
  * Health + diagnose live in L3 because they MUST be the first thing an
  * LLM-host calls when something is broken; routing them through a gateway
  * would create a chicken-and-egg loop (the LLM would have to discover
@@ -48,8 +58,9 @@ export const ESSENTIAL_TOOLS = [
     // F-16 hot-path promotions (Maria-Audit v2 re-confirmed) — the 5
     // most-used read/mutate operations skip the advanced-router
     // discovery roundtrip. Cursor cap is ~40; with the W7 sites_list +
-    // sites_test additions we sit at 17 L1 + 2 L3 + 1 gateway = 20,
-    // comfortable below the limit.
+    // sites_test additions (plus later C4, config-harmonization, the
+    // F116 bind→save→publish promotion and the P-G page_dynamize tool) we
+    // sit at 24 L1 + 2 L3 + 1 gateway = 27, comfortable below the limit.
     'yootheme_builder_element_get',
     'yootheme_builder_element_delete',
     'yootheme_builder_element_clone',
@@ -71,6 +82,45 @@ export const ESSENTIAL_TOOLS = [
     // sites_test probes /health + /etag for ONE site). L1 surface 15 → 17.
     'yootheme_builder_sites_list',
     'yootheme_builder_sites_test',
+    // Phase 3 (config harmonization) — use_site is the runtime active-
+    // site SWITCH (mirrors api-mapper's apimapper_use_profile). It must
+    // be L1 so an agent can discover + call it directly the same way it
+    // reaches sites_list, instead of routing through the advanced
+    // gateway. L1 surface 19 → 20.
+    'yootheme_builder_use_site',
+    // C4 (v1.2) — pages_create + pages_delete are first-class customer-
+    // facing page-level mutations (POST /pages, DELETE /pages/{id}).
+    // Both must be discoverable directly in tools/list, not behind the
+    // advanced-gateway router — they're high-frequency mutations agents
+    // reach for whenever the user says "create a new page" or "delete
+    // this page". L1 surface 17 → 19.
+    'yootheme_builder_pages_create',
+    'yootheme_builder_pages_delete',
+    // F116 (2026-06-11) — the bind→save→publish chain. element_bind_source is the
+    // #1 dynamic-content operation (wire a published source field onto an
+    // element); page_save + page_publish persist + go live. All three were
+    // advanced-lane only, so an agent listing tools saw element_add but
+    // neither bind nor publish — a likely "can't publish" deadend and a
+    // 2-call discovery tax (find the gateway, then route). Promoting them to
+    // L1 makes the canonical dynamic-content workflow first-class and
+    // directly callable. L1 surface 20 → 23.
+    'yootheme_builder_element_bind_source',
+    'yootheme_builder_page_save',
+    'yootheme_builder_page_publish',
+    // P-G (Goldstandard wave 3) — page_dynamize is THE canonical one-call
+    // path to dynamize an existing designed section (copy byte-identically,
+    // swap only mapped queries + leaf names). It MUST be L1 so an agent
+    // reaches it directly INSTEAD of discovering it through the advanced
+    // gateway and then hand-editing layout JSON (the failure mode the
+    // recipe-as-code exists to prevent). With the F116 trio L1 23 → 24.
+    'yootheme_builder_page_dynamize',
+    // WF2 Option C (2026-06-13) — scaffold_section is the positive-steering
+    // counterpart to the structural-hierarchy guard: it creates a VALID
+    // section → row → column hull in ONE atomic call and returns the column
+    // pointer(s) to drop content into. It MUST be L1 so an agent reaches it
+    // directly INSTEAD of hand-building (and tripping the guard on) an
+    // invalid root/section/row placement. With the prior set L1 24 → 25.
+    'yootheme_builder_scaffold_section',
 ];
 /**
  * L3 — Tools registered DIRECTLY on the real McpServer, BEFORE the

package/dist/gateway/essentials.js.map

@@ -1 +1 @@
-{"version":3,"file":"essentials.js","sourceRoot":"","sources":["../../src/gateway/essentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,6BAA6B;IAC7B,2BAA2B;IAC3B,+BAA+B;IAC/B,8BAA8B;IAC9B,0CAA0C;IAC1C,+BAA+B;IAC/B,qCAAqC;IACrC,6DAA6D;IAC7D,kEAAkE;IAClE,6DAA6D;IAC7D,yCAAyC;IACzC,8CAA8C;IAC9C,iEAAiE;IACjE,4DAA4D;IAC5D,mEAAmE;IACnE,gEAAgE;IAChE,+BAA+B;IAC/B,8BAA8B;IAC9B,iCAAiC;IACjC,gCAAgC;IAChC,+BAA+B;IAC/B,kCAAkC;IAClC,oEAAoE;IACpE,sEAAsE;IACtE,mCAAmC;IACnC,iEAAiE;IACjE,iEAAiE;IACjE,iEAAiE;IACjE,4DAA4D;IAC5D,4DAA4D;IAC5D,0CAA0C;IAC1C,mEAAmE;IACnE,oEAAoE;IACpE,mEAAmE;IACnE,kEAAkE;IAClE,uEAAuE;IACvE,6BAA6B;IAC7B,6BAA6B;CACvB,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,yBAAyB;IACzB,2BAA2B;CACrB,CAAC;AAKX,gEAAgE;AAChE,MAAM,UAAU,WAAW,CAAC,IAAY;IACpC,OAAQ,eAAqC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,gBAAgB,CAAC,IAAY;IACzC,OAAQ,sBAA4C,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxE,CAAC"}
+{"version":3,"file":"essentials.js","sourceRoot":"","sources":["../../src/gateway/essentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,6BAA6B;IAC7B,2BAA2B;IAC3B,+BAA+B;IAC/B,8BAA8B;IAC9B,0CAA0C;IAC1C,+BAA+B;IAC/B,qCAAqC;IACrC,6DAA6D;IAC7D,kEAAkE;IAClE,6DAA6D;IAC7D,yCAAyC;IACzC,8CAA8C;IAC9C,iEAAiE;IACjE,4DAA4D;IAC5D,mEAAmE;IACnE,iEAAiE;IACjE,sEAAsE;IACtE,qEAAqE;IACrE,8BAA8B;IAC9B,iCAAiC;IACjC,gCAAgC;IAChC,+BAA+B;IAC/B,kCAAkC;IAClC,oEAAoE;IACpE,sEAAsE;IACtE,mCAAmC;IACnC,iEAAiE;IACjE,iEAAiE;IACjE,iEAAiE;IACjE,4DAA4D;IAC5D,4DAA4D;IAC5D,0CAA0C;IAC1C,mEAAmE;IACnE,oEAAoE;IACpE,mEAAmE;IACnE,kEAAkE;IAClE,uEAAuE;IACvE,6BAA6B;IAC7B,6BAA6B;IAC7B,mEAAmE;IACnE,oEAAoE;IACpE,oEAAoE;IACpE,8DAA8D;IAC9D,+BAA+B;IAC/B,2BAA2B;IAC3B,oEAAoE;IACpE,iEAAiE;IACjE,mEAAmE;IACnE,oEAAoE;IACpE,kEAAkE;IAClE,kCAAkC;IAClC,+BAA+B;IAC/B,+BAA+B;IAC/B,8EAA8E;IAC9E,sEAAsE;IACtE,uEAAuE;IACvE,oEAAoE;IACpE,oEAAoE;IACpE,yEAAyE;IACzE,kEAAkE;IAClE,yCAAyC;IACzC,sCAAsC;IACtC,4BAA4B;IAC5B,+BAA+B;IAC/B,sEAAsE;IACtE,wEAAwE;IACxE,oEAAoE;IACpE,qEAAqE;IACrE,kEAAkE;IAClE,oEAAoE;IACpE,gCAAgC;IAChC,wEAAwE;IACxE,oEAAoE;IACpE,wEAAwE;IACxE,wEAAwE;IACxE,mEAAmE;IACnE,qEAAqE;IACrE,mCAAmC;CAC7B,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,yBAAyB;IACzB,2BAA2B;CACrB,CAAC;AAKX,gEAAgE;AAChE,MAAM,UAAU,WAAW,CAAC,IAAY;IACpC,OAAQ,eAAqC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,gBAAgB,CAAC,IAAY;IACzC,OAAQ,sBAA4C,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxE,CAAC"}

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

@@ -31,9 +31,9 @@ export interface CollectedTool {
  * name. The CapturingServer must have been used to register the L1/L2
  * tools, and `registerAdvancedTool` must have run, before this is called.
  *
- * Production size = 22:
- *   7 L1 essentials (real server) + 12 L2 advanced (registry)
- *   + 2 L3 direct (real server) + 1 gateway (real server) = 22.
+ * Production size = 30 (post-F116):
+ *   23 L1 essentials (real server) + 4 L2 advanced (registry)
+ *   + 2 L3 direct (real server) + 1 gateway (real server) = 30.
  */
 export declare function collectAllRegisteredTools(server: McpServer, capturing: CapturingServer): Record<string, CollectedTool>;
 /** By-name lookup over a `collectAllRegisteredTools` map. */

package/dist/gateway/test-support.js

@@ -20,9 +20,9 @@
  * name. The CapturingServer must have been used to register the L1/L2
  * tools, and `registerAdvancedTool` must have run, before this is called.
  *
- * Production size = 22:
- *   7 L1 essentials (real server) + 12 L2 advanced (registry)
- *   + 2 L3 direct (real server) + 1 gateway (real server) = 22.
+ * Production size = 30 (post-F116):
+ *   23 L1 essentials (real server) + 4 L2 advanced (registry)
+ *   + 2 L3 direct (real server) + 1 gateway (real server) = 30.
  */
 export function collectAllRegisteredTools(server, capturing) {
     const result = {};

package/dist/index.d.ts

@@ -13,7 +13,8 @@
  */
 export { createServer, SERVER_NAME, SERVER_VERSION } from './server.js';
 export { RestClient, REST_NAMESPACE_PATH, encodeElementPath } from './client.js';
-export { loadConfig, loadRegistry, isTestMode, ENV_SITE_URL, ENV_WP_URL, ENV_BEARER, ENV_SITES_FILE, ENV_TEST_MODE, } from './auth.js';
+export { loadConfig, loadRegistry, isTestMode, ENV_SITE_URL, ENV_WP_URL, ENV_BEARER, ENV_SITES_FILE, ENV_PLATFORM, ENV_PROFILE, ENV_TEST_MODE, } from './auth.js';
+export { bootstrapActiveSite } from './sites/bootstrap.js';
 export { ConfigError, RestError, NetworkError } from './errors.js';
 export { buildAllTools } from './tools/index.js';
 export { ClientPool, NoDefaultSiteError, UnknownSiteError } from './sites/client-pool.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EACH,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EACV,cAAc,EACd,aAAa,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACxF,OAAO,EACH,eAAe,EACf,sBAAsB,EACtB,WAAW,EACX,gBAAgB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACH,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EACH,yBAAyB,EACzB,QAAQ,EACR,KAAK,aAAa,GACrB,MAAM,2BAA2B,CAAC;AAEnC,iBAAe,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAgEnC;AAkBD,OAAO,EAAE,IAAI,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAYH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EACH,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,WAAW,EACX,aAAa,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACxF,OAAO,EACH,eAAe,EACf,sBAAsB,EACtB,WAAW,EACX,gBAAgB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACH,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EACH,yBAAyB,EACzB,QAAQ,EACR,KAAK,aAAa,GACrB,MAAM,2BAA2B,CAAC;AAEnC,iBAAe,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAiFnC;AAkBD,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dist/index.js

@@ -14,13 +14,15 @@
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { isTestMode, loadRegistry } from './auth.js';
 import { ConfigError } from './errors.js';
+import { bootstrapActiveSite } from './sites/bootstrap.js';
 import { ClientPool } from './sites/client-pool.js';
 import { SiteRegistry } from './sites/registry.js';
 import { defaultSecretResolver } from './sites/secret-resolver.js';
 import { createServer } from './server.js';
 export { createServer, SERVER_NAME, SERVER_VERSION } from './server.js';
 export { RestClient, REST_NAMESPACE_PATH, encodeElementPath } from './client.js';
-export { loadConfig, loadRegistry, isTestMode, ENV_SITE_URL, ENV_WP_URL, ENV_BEARER, ENV_SITES_FILE, ENV_TEST_MODE, } from './auth.js';
+export { loadConfig, loadRegistry, isTestMode, ENV_SITE_URL, ENV_WP_URL, ENV_BEARER, ENV_SITES_FILE, ENV_PLATFORM, ENV_PROFILE, ENV_TEST_MODE, } from './auth.js';
+export { bootstrapActiveSite } from './sites/bootstrap.js';
 export { ConfigError, RestError, NetworkError } from './errors.js';
 export { buildAllTools } from './tools/index.js';
 // W6 — multi-site primitives exported for dist consumers (scripts,
@@ -34,6 +36,16 @@ export { CapturingServer, } from './gateway/capturing-server.js';
 export { registerAdvancedTool } from './gateway/advanced-tool.js';
 export { collectAllRegisteredTools, findTool, } from './gateway/test-support.js';
 async function main() {
+    // Proxy mode: forward stdio 1:1 to the plugin-served PHP MCP endpoint and
+    // stop here — the fat catalog below is bypassed entirely. Default (fat) is
+    // unchanged. The dynamic import is gated on the env so the fat path never
+    // loads the proxy module (and the SDK client transport it pulls in) — keeps
+    // fat-mode startup lean and avoids loading proxy code when it can't apply.
+    if (process.env.YTB_MCP_MODE === 'proxy') {
+        const { maybeRunProxy } = await import('./proxy/bridge.js');
+        if (await maybeRunProxy(process.env))
+            return;
+    }
     const testMode = isTestMode();
     // W10 — multi-site bootstrap is now centralised in
     // `auth.loadRegistry()`. The canonical resolution order is:
@@ -79,6 +91,12 @@ async function main() {
     }
     const secretResolver = defaultSecretResolver();
     const pool = new ClientPool(registry, secretResolver);
+    // Phase 3 — honour YTB_MCP_PROFILE: seed the pool's active-site
+    // override so a multi-client config (one MCP entry per site, each
+    // with its own profile) boots on the right site without a first
+    // tool call. No-op when unset / "default" / unknown — mirrors
+    // api-mapper's bootstrapActiveProfile. Pure in-memory pointer move.
+    bootstrapActiveSite(pool);
     const { mcp, tools } = createServer({ pool });
     if (testMode) {
         // Print a one-line per tool summary to stderr (stdout is reserved

package/dist/index.js.map

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

package/dist/install-skill.js

@@ -27,7 +27,7 @@ The YT Builder MCP skill is installed at \`~/.claude/skills/yt-builder-mcp/\`
 — the universal-marker path recognised by Claude Desktop and other AI
 clients that follow the \`~/AGENTS.md\` discovery protocol.
 
-It documents the 24 MCP tools (23 domain + 1 gateway, 11 entries in
+It documents the 30 MCP tools (29 domain + 1 gateway, 26 entries in
 \`tools/list\`), the 5 canonical workflows (build hero, bind dynamic
 source, clone section, diagnose 401, add custom element), and the
 gateway routing model. Source: https://github.com/wootsup/yt-builder-mcp.

package/dist/proxy/bridge.d.ts

@@ -0,0 +1,36 @@
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+/**
+ * Wire two MCP transports into a transparent pipe: every message from one side
+ * is relayed verbatim to the other, and a close/error on either side tears down
+ * the other. No transformation — the PHP server owns the protocol semantics.
+ * The caller is responsible for start()ing both transports.
+ *
+ * `StreamableHTTPClientTransport.send()` re-throws on any upstream failure
+ * (401/5xx/connection refused / missing PHP endpoint). The forwarders MUST NOT
+ * fire-and-forget that rejection: an unhandled rejection crashes the Node
+ * process, so a wrong key / unreachable site would kill the proxy on the first
+ * `initialize` instead of surfacing an actionable error. Each direction
+ * therefore `.catch()`es its `send()`.
+ */
+export declare function bridgeTransports(local: Transport, remote: Transport): void;
+/** Build the real transports + bridge them; resolves when EITHER side closes. */
+export declare function runProxy(config: {
+    endpointUrl: URL;
+    token: string;
+}, deps?: {
+    makeTransports?: (c: {
+        endpointUrl: URL;
+        token: string;
+    }) => {
+        local: Transport;
+        remote: Transport;
+    };
+}): Promise<void>;
+/** Returns true if proxy mode handled the run; false → caller continues with fat. */
+export declare function maybeRunProxy(env: NodeJS.ProcessEnv, deps?: {
+    runProxy?: (c: {
+        endpointUrl: URL;
+        token: string;
+    }) => Promise<void>;
+}): Promise<boolean>;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/proxy/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/proxy/bridge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AA6B/E;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA2C1E;AAcD,iFAAiF;AACjF,wBAAsB,QAAQ,CAC5B,MAAM,EAAE;IAAE,WAAW,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAC3C,IAAI,GAAE;IACJ,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE;QAAE,WAAW,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK;QAC3D,KAAK,EAAE,SAAS,CAAC;QACjB,MAAM,EAAE,SAAS,CAAC;KACnB,CAAC;CACE,GACL,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED,qFAAqF;AACrF,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE;QAAE,WAAW,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAAO,GAClF,OAAO,CAAC,OAAO,CAAC,CAMlB"}

package/dist/proxy/bridge.js

@@ -0,0 +1,129 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { resolveMode } from './mode.js';
+/** Narrow an unknown caught value to a human-readable message (no `any`). */
+function errorMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    if (typeof err === 'string')
+        return err;
+    try {
+        return String(err);
+    }
+    catch {
+        return 'unknown error';
+    }
+}
+/**
+ * A forwarded message is request-shaped (and therefore answerable with a
+ * JSON-RPC error) iff it carries a non-null `id`. Notifications have no `id`.
+ */
+function requestId(msg) {
+    if (msg !== null && typeof msg === 'object' && 'id' in msg) {
+        const id = msg.id;
+        if (typeof id === 'string' || typeof id === 'number')
+            return id;
+    }
+    return null;
+}
+/**
+ * Wire two MCP transports into a transparent pipe: every message from one side
+ * is relayed verbatim to the other, and a close/error on either side tears down
+ * the other. No transformation — the PHP server owns the protocol semantics.
+ * The caller is responsible for start()ing both transports.
+ *
+ * `StreamableHTTPClientTransport.send()` re-throws on any upstream failure
+ * (401/5xx/connection refused / missing PHP endpoint). The forwarders MUST NOT
+ * fire-and-forget that rejection: an unhandled rejection crashes the Node
+ * process, so a wrong key / unreachable site would kill the proxy on the first
+ * `initialize` instead of surfacing an actionable error. Each direction
+ * therefore `.catch()`es its `send()`.
+ */
+export function bridgeTransports(local, remote) {
+    local.onmessage = (msg) => {
+        remote.send(msg).catch((err) => {
+            const message = errorMessage(err);
+            // stderr only — stdout is the JSON-RPC channel.
+            console.error('[yt-builder-proxy] upstream send failed:', message);
+            const id = requestId(msg);
+            if (id !== null) {
+                // Hand the client an actionable error instead of a dead pipe.
+                const frame = {
+                    jsonrpc: '2.0',
+                    id,
+                    error: {
+                        code: -32000,
+                        message: `Proxy upstream error: ${message}. Check YTB_MCP_SITE_URL / YTB_MCP_BEARER_TOKEN.`,
+                    },
+                };
+                local.send(frame).catch((sendErr) => {
+                    console.error('[yt-builder-proxy] failed to deliver error frame:', errorMessage(sendErr));
+                });
+            }
+            else {
+                // A notification has no id to answer — tear the pipe down instead.
+                void remote.close();
+            }
+        });
+    };
+    remote.onmessage = (msg) => {
+        local.send(msg).catch((err) => {
+            console.error('[yt-builder-proxy] downstream send failed:', errorMessage(err));
+        });
+    };
+    local.onclose = () => {
+        void remote.close();
+    };
+    remote.onclose = () => {
+        void local.close();
+    };
+    local.onerror = (err) => {
+        console.error('[yt-builder-proxy] local transport error:', err.message);
+    };
+    remote.onerror = (err) => {
+        console.error('[yt-builder-proxy] remote transport error:', err.message);
+    };
+}
+/** Injection seam for tests — production builds the real SDK transports. */
+function defaultTransports(config) {
+    const remote = new StreamableHTTPClientTransport(config.endpointUrl, {
+        requestInit: { headers: { Authorization: `Bearer ${config.token}` } },
+    });
+    const local = new StdioServerTransport();
+    return { local, remote };
+}
+/** Build the real transports + bridge them; resolves when EITHER side closes. */
+export async function runProxy(config, deps = {}) {
+    const { local, remote } = (deps.makeTransports ?? defaultTransports)(config);
+    // Resolve the moment EITHER transport closes — never hang if the remote
+    // (upstream) drops first. Capture the bridge's own onclose handlers so the
+    // cross-teardown wiring still runs.
+    const closed = new Promise((resolve) => {
+        bridgeTransports(local, remote);
+        const prevLocalClose = local.onclose;
+        const prevRemoteClose = remote.onclose;
+        local.onclose = () => {
+            prevLocalClose?.();
+            resolve();
+        };
+        remote.onclose = () => {
+            prevRemoteClose?.();
+            resolve();
+        };
+    });
+    // Start LOCAL (stdio) first so the listener is installed before any client
+    // message can race in; only then open the upstream connection.
+    await local.start();
+    await remote.start();
+    await closed;
+}
+/** Returns true if proxy mode handled the run; false → caller continues with fat. */
+export async function maybeRunProxy(env, deps = {}) {
+    const resolved = resolveMode(env);
+    if (resolved.mode !== 'proxy')
+        return false;
+    const run = deps.runProxy ?? runProxy;
+    await run({ endpointUrl: resolved.endpointUrl, token: resolved.token });
+    return true;
+}
+//# sourceMappingURL=bridge.js.map