@wootsup/yt-builder-mcp 1.12.0 → 2.0.0

package/dist/tools/multi-items/item-container-map.d.ts

@@ -1,41 +1,6 @@
-/**
- * Multi-Items pattern — TypeScript mirror of the PHP
- * `WootsUp\BuilderMcp\Elements\ItemContainerMap` constant.
- *
- * YT-Pro 4.5.33+ implements `SourceTransform::repeatSource` which
- * clones the *source-bearing element* N-times as siblings inside its
- * parent. For "1 container with N children" the binding MUST live on
- * the `*_item` child element, NEVER on the container.
- *
- * The PHP and TS maps MUST stay in lock-step — both files carry a
- * pin-test that fails if the canonical pairings drift.
- *
- * @license MIT
- */
-/**
- * Live-verified against `themes/yootheme/packages/builder/elements/
- * *_item/` on YT-Pro 4.5.33 (dev server, 2026-05-22). 16 pairs total.
- *
- * NB: There is NO `slider` / `slider_item` pair on YT-Pro 4.5.33 — the
- * YT slider/carousel widgets render via `slideshow`, `overlay-slider`,
- * and `panel-slider`.
- */
 export declare const ITEM_CHILDREN_OF_CONTAINER: Readonly<Record<string, string>>;
-/**
- * Surface the `*_item` child type for a known container, or null when
- * the input is not a known multi-item container.
- */
 export declare function itemOf(containerType: string): string | null;
-/**
- * Surface the container type for a known `*_item`, or null otherwise.
- */
 export declare function containerOf(itemType: string): string | null;
-/**
- * `true` when $type is one of the multi-item-capable containers.
- */
 export declare function isContainer(type: string): boolean;
-/**
- * `true` when $type is a `*_item` child of a multi-item container.
- */
 export declare function isItem(type: string): boolean;
 //# sourceMappingURL=item-container-map.d.ts.map

package/dist/tools/multi-items/item-container-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"item-container-map.d.ts","sourceRoot":"","sources":["../../../src/tools/multi-items/item-container-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBtE,CAAC;AAEH;;;GAGG;AACH,wBAAgB,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5C"}
+{"version":3,"file":"item-container-map.d.ts","sourceRoot":"","sources":["../../../src/tools/multi-items/item-container-map.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBtE,CAAC;AAMH,wBAAgB,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI3D;AAKD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO3D;AAKD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAKD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5C"}

package/dist/tools/multi-items/item-container-map.js

@@ -1,25 +1,3 @@
-/**
- * Multi-Items pattern — TypeScript mirror of the PHP
- * `WootsUp\BuilderMcp\Elements\ItemContainerMap` constant.
- *
- * YT-Pro 4.5.33+ implements `SourceTransform::repeatSource` which
- * clones the *source-bearing element* N-times as siblings inside its
- * parent. For "1 container with N children" the binding MUST live on
- * the `*_item` child element, NEVER on the container.
- *
- * The PHP and TS maps MUST stay in lock-step — both files carry a
- * pin-test that fails if the canonical pairings drift.
- *
- * @license MIT
- */
-/**
- * Live-verified against `themes/yootheme/packages/builder/elements/
- * *_item/` on YT-Pro 4.5.33 (dev server, 2026-05-22). 16 pairs total.
- *
- * NB: There is NO `slider` / `slider_item` pair on YT-Pro 4.5.33 — the
- * YT slider/carousel widgets render via `slideshow`, `overlay-slider`,
- * and `panel-slider`.
- */
 export const ITEM_CHILDREN_OF_CONTAINER = Object.freeze({
     accordion: 'accordion_item',
     button: 'button_item',
@@ -38,18 +16,11 @@ export const ITEM_CHILDREN_OF_CONTAINER = Object.freeze({
     switcher: 'switcher_item',
     table: 'table_item',
 });
-/**
- * Surface the `*_item` child type for a known container, or null when
- * the input is not a known multi-item container.
- */
 export function itemOf(containerType) {
     return Object.prototype.hasOwnProperty.call(ITEM_CHILDREN_OF_CONTAINER, containerType)
         ? ITEM_CHILDREN_OF_CONTAINER[containerType]
         : null;
 }
-/**
- * Surface the container type for a known `*_item`, or null otherwise.
- */
 export function containerOf(itemType) {
     for (const [container, item] of Object.entries(ITEM_CHILDREN_OF_CONTAINER)) {
         if (item === itemType) {
@@ -58,15 +29,9 @@ export function containerOf(itemType) {
     }
     return null;
 }
-/**
- * `true` when $type is one of the multi-item-capable containers.
- */
 export function isContainer(type) {
     return Object.prototype.hasOwnProperty.call(ITEM_CHILDREN_OF_CONTAINER, type);
 }
-/**
- * `true` when $type is a `*_item` child of a multi-item container.
- */
 export function isItem(type) {
     return Object.values(ITEM_CHILDREN_OF_CONTAINER).includes(type);
 }

package/dist/tools/multi-items/item-container-map.js.map

@@ -1 +1 @@
-{"version":3,"file":"item-container-map.js","sourceRoot":"","sources":["../../../src/tools/multi-items/item-container-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAqC,MAAM,CAAC,MAAM,CAAC;IACtF,SAAS,EAAE,gBAAgB;IAC3B,MAAM,EAAE,aAAa;IACrB,gBAAgB,EAAE,uBAAuB;IACzC,OAAO,EAAE,cAAc;IACvB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,UAAU;IACf,gBAAgB,EAAE,qBAAqB;IACvC,cAAc,EAAE,mBAAmB;IACnC,OAAO,EAAE,cAAc;IACvB,SAAS,EAAE,gBAAgB;IAC3B,MAAM,EAAE,aAAa;IACrB,MAAM,EAAE,aAAa;IACrB,QAAQ,EAAE,eAAe;IACzB,KAAK,EAAE,YAAY;CACtB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,aAAqB;IACxC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,0BAA0B,EAAE,aAAa,CAAC;QAClF,CAAC,CAAE,0BAA0B,CAAC,aAAa,CAAY;QACvD,CAAC,CAAC,IAAI,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IACxC,KAAK,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,0BAA0B,CAAC,EAAE,CAAC;QACzE,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpB,OAAO,SAAS,CAAC;QACrB,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACpC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,0BAA0B,EAAE,IAAI,CAAC,CAAC;AAClF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY;IAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC"}
+{"version":3,"file":"item-container-map.js","sourceRoot":"","sources":["../../../src/tools/multi-items/item-container-map.ts"],"names":[],"mappings":"AAuBA,MAAM,CAAC,MAAM,0BAA0B,GAAqC,MAAM,CAAC,MAAM,CAAC;IACtF,SAAS,EAAE,gBAAgB;IAC3B,MAAM,EAAE,aAAa;IACrB,gBAAgB,EAAE,uBAAuB;IACzC,OAAO,EAAE,cAAc;IACvB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,UAAU;IACf,gBAAgB,EAAE,qBAAqB;IACvC,cAAc,EAAE,mBAAmB;IACnC,OAAO,EAAE,cAAc;IACvB,SAAS,EAAE,gBAAgB;IAC3B,MAAM,EAAE,aAAa;IACrB,MAAM,EAAE,aAAa;IACrB,QAAQ,EAAE,eAAe;IACzB,KAAK,EAAE,YAAY;CACtB,CAAC,CAAC;AAMH,MAAM,UAAU,MAAM,CAAC,aAAqB;IACxC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,0BAA0B,EAAE,aAAa,CAAC;QAClF,CAAC,CAAE,0BAA0B,CAAC,aAAa,CAAY;QACvD,CAAC,CAAC,IAAI,CAAC;AACf,CAAC;AAKD,MAAM,UAAU,WAAW,CAAC,QAAgB;IACxC,KAAK,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,0BAA0B,CAAC,EAAE,CAAC;QACzE,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpB,OAAO,SAAS,CAAC;QACrB,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAKD,MAAM,UAAU,WAAW,CAAC,IAAY;IACpC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,0BAA0B,EAAE,IAAI,CAAC,CAAC;AAClF,CAAC;AAKD,MAAM,UAAU,MAAM,CAAC,IAAY;IAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC"}

package/dist/tools/multi-items/output-schemas.d.ts

@@ -0,0 +1,101 @@
+import { z } from 'zod';
+export declare const CLEAN_IMPLODE_OUTPUT_SCHEMA: z.ZodObject<{
+    preview: z.ZodOptional<z.ZodBoolean>;
+    applied: z.ZodOptional<z.ZodBoolean>;
+    step_reversible: z.ZodOptional<z.ZodBoolean>;
+    requires_confirmation: z.ZodOptional<z.ZodLiteral<true>>;
+    requires_confirm: z.ZodOptional<z.ZodLiteral<true>>;
+    operation: z.ZodOptional<z.ZodString>;
+    hint: z.ZodOptional<z.ZodString>;
+    warning: z.ZodOptional<z.ZodString>;
+    instruction: z.ZodOptional<z.ZodString>;
+    received_confirm: z.ZodOptional<z.ZodUnknown>;
+    received_confirm_type: z.ZodOptional<z.ZodString>;
+    expected_confirm: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    host_prompt: z.ZodOptional<z.ZodEnum<{
+        preview_only_host_said_yes: "preview_only_host_said_yes";
+        preview_only_host_said_no: "preview_only_host_said_no";
+        preview_only_host_not_asked: "preview_only_host_not_asked";
+    }>>;
+    layout_id: z.ZodString;
+    element_path: z.ZodString;
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    cleaned_count: z.ZodOptional<z.ZodNumber>;
+    removed_directives: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        prop_name: z.ZodString;
+        directive: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>>;
+    would_clean_count: z.ZodOptional<z.ZodNumber>;
+    would_remove: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        prop_name: z.ZodString;
+        directive: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>>;
+    new_etag: z.ZodOptional<z.ZodString>;
+    changed_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    etag: z.ZodOptional<z.ZodString>;
+    resolved_layout_id: z.ZodOptional<z.ZodString>;
+    resolved_via: z.ZodOptional<z.ZodEnum<{
+        prefixed: "prefixed";
+        theme_template: "theme_template";
+        content_id: "content_id";
+    }>>;
+}, z.core.$strip>;
+export declare const INSPECT_MULTI_ITEMS_OUTPUT_SCHEMA: z.ZodObject<{
+    layout_id: z.ZodString;
+    report: z.ZodObject<{
+        element_path: z.ZodString;
+        element_type: z.ZodString;
+        is_container: z.ZodBoolean;
+        is_item: z.ZodBoolean;
+        container_type: z.ZodNullable<z.ZodString>;
+        item_type: z.ZodNullable<z.ZodString>;
+        current_binding_level: z.ZodEnum<{
+            container: "container";
+            item: "item";
+            none: "none";
+        }>;
+        item_child_binding_level: z.ZodOptional<z.ZodEnum<{
+            item: "item";
+            none: "none";
+        }>>;
+        is_bound: z.ZodOptional<z.ZodBoolean>;
+        has_implode_directives: z.ZodBoolean;
+        bound_source_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        bound_source_exists: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        source_missing_warning: z.ZodOptional<z.ZodString>;
+        map_location_missing: z.ZodOptional<z.ZodBoolean>;
+        field_mapping_count: z.ZodOptional<z.ZodNumber>;
+        zero_field_mappings: z.ZodOptional<z.ZodBoolean>;
+        iterator_is_leaf_renderer: z.ZodOptional<z.ZodBoolean>;
+        relation_native_binding: z.ZodOptional<z.ZodBoolean>;
+        archive_context: z.ZodOptional<z.ZodObject<{
+            query_name: z.ZodString;
+            relation: z.ZodString;
+            relation_field: z.ZodString;
+            current_term_arg: z.ZodString;
+            current_term: z.ZodNumber;
+        }, z.core.$strip>>;
+        map_location_warning: z.ZodOptional<z.ZodString>;
+        unknown_source_field_values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        unknown_source_field_values_available: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        unknown_source_field_values_hint: z.ZodOptional<z.ZodString>;
+        warning: z.ZodOptional<z.ZodString>;
+        recommended_fix: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    etag: z.ZodString;
+    hint: z.ZodOptional<z.ZodObject<{
+        severity: z.ZodEnum<{
+            advisory: "advisory";
+            blocking: "blocking";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+    resolved_layout_id: z.ZodOptional<z.ZodString>;
+    resolved_via: z.ZodOptional<z.ZodEnum<{
+        prefixed: "prefixed";
+        theme_template: "theme_template";
+        content_id: "content_id";
+    }>>;
+}, z.core.$strip>;
+//# sourceMappingURL=output-schemas.d.ts.map

package/dist/tools/multi-items/output-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/multi-items/output-schemas.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuBxB,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8C2D,CAAC;AAEpG,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkF5C,CAAC"}

package/dist/tools/multi-items/output-schemas.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import { RESOLVED_LAYOUT_ID_OUTPUT } from '../shared-schemas.js';
+import { CONFIRM_PREVIEW_FIELDS, requireOnExecutedWrite } from '../tool-builder/confirm-preview.js';
+export const CLEAN_IMPLODE_OUTPUT_SCHEMA = z.object({
+    ...RESOLVED_LAYOUT_ID_OUTPUT,
+    layout_id: z.string(),
+    element_path: z.string(),
+    dry_run: z.boolean().optional(),
+    cleaned_count: z.number().optional(),
+    removed_directives: z
+        .array(z.object({
+        prop_name: z.string(),
+        directive: z.record(z.string(), z.unknown()),
+    }))
+        .optional(),
+    would_clean_count: z.number().optional(),
+    would_remove: z
+        .array(z.object({
+        prop_name: z.string(),
+        directive: z.record(z.string(), z.unknown()),
+    }))
+        .optional(),
+    new_etag: z.string().optional(),
+    changed_paths: z.array(z.string()).optional(),
+    etag: z.string().optional(),
+    ...CONFIRM_PREVIEW_FIELDS,
+}).superRefine((v, ctx) => requireOnExecutedWrite(v, ctx, ['cleaned_count', 'removed_directives']));
+export const INSPECT_MULTI_ITEMS_OUTPUT_SCHEMA = z.object({
+    ...RESOLVED_LAYOUT_ID_OUTPUT,
+    layout_id: z.string(),
+    report: z.object({
+        element_path: z.string(),
+        element_type: z.string(),
+        is_container: z.boolean(),
+        is_item: z.boolean(),
+        container_type: z.string().nullable(),
+        item_type: z.string().nullable(),
+        current_binding_level: z.enum(['none', 'container', 'item']),
+        item_child_binding_level: z.enum(['none', 'item']).optional(),
+        is_bound: z.boolean().optional(),
+        has_implode_directives: z.boolean(),
+        bound_source_name: z.string().nullable().optional(),
+        bound_source_exists: z.boolean().nullable().optional(),
+        source_missing_warning: z.string().optional(),
+        map_location_missing: z.boolean().optional(),
+        field_mapping_count: z.number().int().nonnegative().optional(),
+        zero_field_mappings: z.boolean().optional(),
+        iterator_is_leaf_renderer: z.boolean().optional(),
+        relation_native_binding: z.boolean().optional(),
+        archive_context: z
+            .object({
+            query_name: z.string(),
+            relation: z.string(),
+            relation_field: z.string(),
+            current_term_arg: z.string(),
+            current_term: z.number().int(),
+        })
+            .optional(),
+        map_location_warning: z.string().optional(),
+        unknown_source_field_values: z.array(z.string()).optional(),
+        unknown_source_field_values_available: z.array(z.string()).optional(),
+        unknown_source_field_values_hint: z.string().optional(),
+        warning: z.string().optional(),
+        recommended_fix: z.string().optional(),
+    }),
+    etag: z.string(),
+    hint: z
+        .object({
+        severity: z.enum(['advisory', 'blocking']),
+        message: z.string(),
+    })
+        .optional(),
+});
+//# sourceMappingURL=output-schemas.js.map

package/dist/tools/multi-items/output-schemas.js.map

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

package/dist/tools/navigation/builders.d.ts

@@ -1,18 +1,3 @@
-/**
- * Navigation — the READ-ONLY `defineTool` factory (proxy-mode arm).
- *
- * T-C4 (mega-push plan 2026-07-24-02, customer P1.4). Mirrors
- * `buildLocalContentTools` (local-content/builders.ts): resolve the site via
- * the pool with `withSiteRetry`, run the handler, stamp `withSiteMeta`.
- * `readOnly()` routes it through the READ-ONLY `yootheme_builder_advanced_read`
- * gateway automatically (the gateway derives its whitelist from
- * `annotations.readOnlyHint === true`, no name allowlist to maintain). NOT
- * added to `ESSENTIAL_TOOLS` — same tiering choice as
- * `local_content_read`/`heading_outline` (L2 advanced).
- *
- * @license MIT
- */
-import type { ClientPool } from '../../sites/client-pool.js';
 import { type AnyToolDefinition } from '../tool-builder.js';
-export declare function buildNavigationTools(pool: ClientPool): readonly AnyToolDefinition[];
+export declare function buildNavigationTools(): readonly AnyToolDefinition[];
 //# sourceMappingURL=builders.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/navigation/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAG7D,OAAO,EAAsC,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAIhG,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,iBAAiB,EAAE,CA+BnF"}
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/navigation/builders.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGlF,wBAAgB,oBAAoB,IAAI,SAAS,iBAAiB,EAAE,CAsBnE"}

package/dist/tools/navigation/builders.js

@@ -1,35 +1,14 @@
-/**
- * Navigation — the READ-ONLY `defineTool` factory (proxy-mode arm).
- *
- * T-C4 (mega-push plan 2026-07-24-02, customer P1.4). Mirrors
- * `buildLocalContentTools` (local-content/builders.ts): resolve the site via
- * the pool with `withSiteRetry`, run the handler, stamp `withSiteMeta`.
- * `readOnly()` routes it through the READ-ONLY `yootheme_builder_advanced_read`
- * gateway automatically (the gateway derives its whitelist from
- * `annotations.readOnlyHint === true`, no name allowlist to maintain). NOT
- * added to `ESSENTIAL_TOOLS` — same tiering choice as
- * `local_content_read`/`heading_outline` (L2 advanced).
- *
- * @license MIT
- */
 import { z } from 'zod';
-import { withSiteRetry } from '../pool-resolve-helper.js';
 import { SITE_ID_SCHEMA } from '../shared-schemas.js';
-import { defineTool, readOnly, withSiteMeta } from '../tool-builder.js';
-import { handleNavigation } from './handlers.js';
+import { defineTool, readOnly } from '../tool-builder.js';
 import { NAVIGATION_OUTPUT_SCHEMA } from './schemas.js';
-export function buildNavigationTools(pool) {
-    const makeDeps = (client) => ({ client });
+export function buildNavigationTools() {
     return [
         defineTool({
             name: 'yootheme_builder_navigation',
-            description: 'The site\'s navigation menus (WP nav menus / Joomla menus) as a parent -> children ' +
-                'TREE, not a flat list, for "which page is under which menu item" (product pages ' +
-                'usually live in the main menu). Each item carries a `page_role` facet (home|landing|' +
-                'product|legal|thankyou|blog|mockup|template|generic, same vocabulary as pages_list) ' +
-                'and, when derivable at zero extra cost, a `target_page` (page:<id> / article:<id>) ' +
-                'ready for yootheme_builder_page_get_layout. Read-only. Narrow to one menu with ' +
-                '`menu`.',
+            description: 'The site\'s navigation menus as a parent→children TREE, not a flat list — ' +
+                '"which page is under which menu item". Each item carries a `page_role` facet ' +
+                'and, when derivable, a `target_page` ready for page_get_layout.',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
                 menu: z
@@ -40,7 +19,6 @@ export function buildNavigationTools(pool) {
             },
             outputSchema: NAVIGATION_OUTPUT_SCHEMA,
             annotations: readOnly('Navigation'),
-            handler: async ({ site_id, ...rest }) => withSiteRetry(pool, site_id, async (client, site) => withSiteMeta(await handleNavigation(makeDeps(client), rest), site)),
         }),
     ];
 }

package/dist/tools/navigation/builders.js.map

@@ -1 +1 @@
-{"version":3,"file":"builders.js","sourceRoot":"","sources":["../../../src/tools/navigation/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAA0B,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAA8B,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,UAAU,oBAAoB,CAAC,IAAgB;IACjD,MAAM,QAAQ,GAAG,CAAC,MAAuC,EAAyB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAElG,OAAO;QACH,UAAU,CAAC;YACP,IAAI,EAAE,6BAA6B;YACnC,WAAW,EACP,qFAAqF;gBACrF,kFAAkF;gBAClF,sFAAsF;gBACtF,sFAAsF;gBACtF,qFAAqF;gBACrF,iFAAiF;gBACjF,SAAS;YACb,WAAW,EAAE;gBACT,OAAO,EAAE,cAAc;gBACvB,IAAI,EAAE,CAAC;qBACF,MAAM,EAAE;qBACR,GAAG,CAAC,CAAC,CAAC;qBACN,QAAQ,EAAE;qBACV,QAAQ,CACL,iFAAiF,CACpF;aACR;YACD,YAAY,EAAE,wBAAwB;YACtC,WAAW,EAAE,QAAQ,CAAC,YAAY,CAAC;YACnC,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CACpC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAChD,YAAY,CAAC,MAAM,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;SAC9E,CAAC;KACL,CAAC;AACN,CAAC"}
+{"version":3,"file":"builders.js","sourceRoot":"","sources":["../../../src/tools/navigation/builders.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAA0B,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,UAAU,oBAAoB;IAChC,OAAO;QACH,UAAU,CAAC;YACP,IAAI,EAAE,6BAA6B;YACnC,WAAW,EACP,4EAA4E;gBAC5E,+EAA+E;gBAC/E,iEAAiE;YACrE,WAAW,EAAE;gBACT,OAAO,EAAE,cAAc;gBACvB,IAAI,EAAE,CAAC;qBACF,MAAM,EAAE;qBACR,GAAG,CAAC,CAAC,CAAC;qBACN,QAAQ,EAAE;qBACV,QAAQ,CACL,iFAAiF,CACpF;aACR;YACD,YAAY,EAAE,wBAAwB;YACtC,WAAW,EAAE,QAAQ,CAAC,YAAY,CAAC;SACtC,CAAC;KACL,CAAC;AACN,CAAC"}

package/dist/tools/navigation/index.d.ts

@@ -1,15 +1,2 @@
-/**
- * Navigation — tool barrel (proxy-mode arm).
- *
- *   yootheme_builder_navigation
- *      → GET /navigation — the site's menus as a parent -> children tree,
- *        each item carrying `page_role` + (when derivable for free)
- *        `target_page`. Optional `menu` narrows to one menu by name.
- *
- * READ-ONLY; routed via the read-only advanced gateway, NOT first-class.
- *
- * @license MIT
- */
 export { buildNavigationTools } from './builders.js';
-export type { NavigationHandlerDeps } from './handlers.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/navigation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/navigation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/navigation/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/navigation/index.js

@@ -1,14 +1,2 @@
-/**
- * Navigation — tool barrel (proxy-mode arm).
- *
- *   yootheme_builder_navigation
- *      → GET /navigation — the site's menus as a parent -> children tree,
- *        each item carrying `page_role` + (when derivable for free)
- *        `target_page`. Optional `menu` narrows to one menu by name.
- *
- * READ-ONLY; routed via the read-only advanced gateway, NOT first-class.
- *
- * @license MIT
- */
 export { buildNavigationTools } from './builders.js';
 //# sourceMappingURL=index.js.map

package/dist/tools/navigation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/navigation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/navigation/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/navigation/schemas.d.ts

@@ -1,34 +1,4 @@
-/**
- * Navigation — zod input/output schema for `yootheme_builder_navigation`.
- *
- * T-C4 (mega-push plan 2026-07-24-02, customer P1.4). The proxy-mode arm of
- * the Navigation Tree feature — the site's menus (WP nav menus / Joomla
- * menus) as a parent -> children TREE, mirroring the WordPress REST
- * controller ({@see \WootsUp\BuilderMcp\LocalContent\NavigationController})
- * 1:1:
- *
- *   yootheme_builder_navigation → GET /navigation
- *
- * Each menu item node is a RECURSIVE tree ({id, title, url, parent_id, type,
- * target_page, page_role, children}) — modelled as a free
- * `z.record(z.string(), z.unknown())` (mirrors
- * `LOCAL_CONTENT_READ_OUTPUT_SCHEMA.items`'s heterogeneous rows) rather than
- * a `z.lazy()` self-referential schema: there is no precedent in this
- * codebase's zod4 `z.toJSONSchema()` catalog pipeline for a recursive shape,
- * and a menu's nesting depth is unbounded by design. The concrete per-node
- * shape is documented here + in the shared PHP
- * {@see \WootsUp\BuilderMcp\LocalContent\MenuTreeBuilder} /
- * {@see \WootsUp\BuilderMcp\LocalContent\LocalContentProjection::menuItem()}.
- *
- * @license MIT
- */
 import { z } from 'zod';
-/**
- * One MENU's already-nested tree. `items` is a list of recursive tree nodes:
- * `{id: number, title: string, url: string|null, parent_id: number|null,
- * type: string|null, target_page: string|null, page_role: string,
- * children: <same shape>[]}`.
- */
 export declare const NAVIGATION_MENU_SCHEMA: z.ZodObject<{
     menu_id: z.ZodNullable<z.ZodNumber>;
     menu_name: z.ZodString;

package/dist/tools/navigation/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/navigation/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;iBAEnC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/navigation/schemas.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;iBAEnC,CAAC"}

package/dist/tools/navigation/schemas.js

@@ -1,34 +1,4 @@
-/**
- * Navigation — zod input/output schema for `yootheme_builder_navigation`.
- *
- * T-C4 (mega-push plan 2026-07-24-02, customer P1.4). The proxy-mode arm of
- * the Navigation Tree feature — the site's menus (WP nav menus / Joomla
- * menus) as a parent -> children TREE, mirroring the WordPress REST
- * controller ({@see \WootsUp\BuilderMcp\LocalContent\NavigationController})
- * 1:1:
- *
- *   yootheme_builder_navigation → GET /navigation
- *
- * Each menu item node is a RECURSIVE tree ({id, title, url, parent_id, type,
- * target_page, page_role, children}) — modelled as a free
- * `z.record(z.string(), z.unknown())` (mirrors
- * `LOCAL_CONTENT_READ_OUTPUT_SCHEMA.items`'s heterogeneous rows) rather than
- * a `z.lazy()` self-referential schema: there is no precedent in this
- * codebase's zod4 `z.toJSONSchema()` catalog pipeline for a recursive shape,
- * and a menu's nesting depth is unbounded by design. The concrete per-node
- * shape is documented here + in the shared PHP
- * {@see \WootsUp\BuilderMcp\LocalContent\MenuTreeBuilder} /
- * {@see \WootsUp\BuilderMcp\LocalContent\LocalContentProjection::menuItem()}.
- *
- * @license MIT
- */
 import { z } from 'zod';
-/**
- * One MENU's already-nested tree. `items` is a list of recursive tree nodes:
- * `{id: number, title: string, url: string|null, parent_id: number|null,
- * type: string|null, target_page: string|null, page_role: string,
- * children: <same shape>[]}`.
- */
 export const NAVIGATION_MENU_SCHEMA = z.object({
     menu_id: z.number().nullable(),
     menu_name: z.string(),

package/dist/tools/navigation/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/tools/navigation/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;CACpD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC;CACzC,CAAC,CAAC"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/tools/navigation/schemas.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;CACpD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC;CACzC,CAAC,CAAC"}

package/dist/tools/output-schema-metadata.d.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export declare function shouldStripOutputSchemaMetadata(toolName: string): boolean;
+export declare function stripOutputSchemaMetadata<T extends z.ZodTypeAny | undefined>(schema: T): T;
+export declare function protectOutputSchemaMetadata(schema: z.ZodTypeAny | undefined): void;
+//# sourceMappingURL=output-schema-metadata.d.ts.map

package/dist/tools/output-schema-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-schema-metadata.d.ts","sourceRoot":"","sources":["../../src/tools/output-schema-metadata.ts"],"names":[],"mappings":"AAyKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzE;AAyHD,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,GAAG,SAAS,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAI1F;AAWD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,GAAG,IAAI,CAKlF"}

package/dist/tools/output-schema-metadata.js

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+const OUTPUT_SCHEMA_METADATA_EXEMPT = new Set([
+    'yootheme_builder_element_type_get_schema',
+]);
+export function shouldStripOutputSchemaMetadata(toolName) {
+    return !OUTPUT_SCHEMA_METADATA_EXEMPT.has(toolName);
+}
+const MAX_WALK_DEPTH = 16;
+const STRIPPED_META_KEYS = ['description', 'title', 'examples'];
+function defOf(node) {
+    const holder = node;
+    return holder._zod?.def ?? holder._def;
+}
+const PROTECTED_NODES = new WeakSet();
+function stripOwnMeta(node) {
+    if (PROTECTED_NODES.has(node))
+        return;
+    const zodNode = node;
+    const meta = z.globalRegistry.get(zodNode);
+    if (!meta)
+        return;
+    const rest = { ...meta };
+    let changed = false;
+    for (const key of STRIPPED_META_KEYS) {
+        if (key in rest) {
+            delete rest[key];
+            changed = true;
+        }
+    }
+    if (!changed)
+        return;
+    if (Object.keys(rest).length > 0) {
+        z.globalRegistry.add(zodNode, rest);
+    }
+    else {
+        z.globalRegistry.remove(zodNode);
+    }
+}
+function walk(node, seen, depth, visit) {
+    if (depth > MAX_WALK_DEPTH || node === null || typeof node !== 'object')
+        return;
+    if (seen.has(node))
+        return;
+    seen.add(node);
+    const def = defOf(node);
+    if (!def)
+        return;
+    visit(node);
+    const shape = def.shape;
+    if (shape !== null && typeof shape === 'object') {
+        for (const value of Object.values(shape)) {
+            walk(value, seen, depth + 1, visit);
+        }
+    }
+    for (const key of ['innerType', 'element', 'valueType', 'keyType', 'left', 'right', 'in', 'out', 'schema']) {
+        if (def[key])
+            walk(def[key], seen, depth + 1, visit);
+    }
+    if (Array.isArray(def.options)) {
+        for (const option of def.options)
+            walk(option, seen, depth + 1, visit);
+    }
+    if (Array.isArray(def.items)) {
+        for (const item of def.items)
+            walk(item, seen, depth + 1, visit);
+    }
+    if (def.rest)
+        walk(def.rest, seen, depth + 1, visit);
+}
+export function stripOutputSchemaMetadata(schema) {
+    if (schema === undefined)
+        return schema;
+    walk(schema, new WeakSet(), 0, stripOwnMeta);
+    return schema;
+}
+export function protectOutputSchemaMetadata(schema) {
+    if (schema === undefined)
+        return;
+    walk(schema, new WeakSet(), 0, (node) => {
+        PROTECTED_NODES.add(node);
+    });
+}
+//# sourceMappingURL=output-schema-metadata.js.map

package/dist/tools/output-schema-metadata.js.map

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