@wootsup/yt-builder-mcp 1.12.0 → 2.0.0

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

@@ -1,44 +1,105 @@
-/**
- * Page-tool output-schemas (Wave G.2 §4 structuredContent contracts).
- *
- * Split out of `src/tools/pages.ts` (Round-2 R2-A2-CRIT1) so the
- * handler files stay focused on logic.
- *
- * @license MIT
- */
 import { z } from 'zod';
 export declare const PAGES_LIST_OUTPUT_SCHEMA: z.ZodObject<{
-    items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        elements_count: z.ZodOptional<z.ZodNumber>;
+        modified_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        frontend_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        frontend_url_template: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        frontend_url_description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        builder_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        serves_context_kind: z.ZodOptional<z.ZodString>;
+        serves_context_ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        page_role: z.ZodOptional<z.ZodString>;
+        is_theme_template: z.ZodOptional<z.ZodBoolean>;
+        is_public_homepage: z.ZodOptional<z.ZodBoolean>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            content: "content";
+            theme_template: "theme_template";
+        }>>;
+        cms_status: z.ZodOptional<z.ZodString>;
+        visibility: z.ZodOptional<z.ZodEnum<{
+            public: "public";
+            hidden: "hidden";
+            undetermined: "undetermined";
+        }>>;
+        visibility_reason: z.ZodOptional<z.ZodString>;
+        visibility_note: z.ZodOptional<z.ZodString>;
+        frontend_url_provisional: z.ZodOptional<z.ZodBoolean>;
+        frontend_url_note: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
     total: z.ZodNumber;
+    totals: z.ZodOptional<z.ZodObject<{
+        content: z.ZodNumber;
+        theme_template: z.ZodNumber;
+        all: z.ZodNumber;
+        visibility: z.ZodOptional<z.ZodObject<{
+            public: z.ZodOptional<z.ZodNumber>;
+            hidden: z.ZodOptional<z.ZodNumber>;
+            undetermined: z.ZodOptional<z.ZodNumber>;
+            no_cms_status: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    counting_note: z.ZodOptional<z.ZodString>;
+    trashed_note: z.ZodOptional<z.ZodString>;
+    hidden_count: z.ZodOptional<z.ZodNumber>;
+    hidden_reason: z.ZodOptional<z.ZodString>;
     returned: z.ZodOptional<z.ZodNumber>;
     next_cursor: z.ZodOptional<z.ZodString>;
     etag: z.ZodOptional<z.ZodString>;
     projected_fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     available_fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    available_fields_by_kind: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
     unknown_fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    field_coverage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     projection_warning: z.ZodOptional<z.ZodString>;
+    sorted_over: z.ZodOptional<z.ZodString>;
+    sort_note: z.ZodOptional<z.ZodString>;
+    visibility_note: z.ZodOptional<z.ZodString>;
+    visibility_filter_note: z.ZodOptional<z.ZodString>;
+    default_row_note: z.ZodOptional<z.ZodString>;
+    text_leg_note: z.ZodOptional<z.ZodString>;
+    fields_hint: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export declare const SCHEMA_OUTPUT_SCHEMA: z.ZodObject<{
-    items: z.ZodArray<z.ZodObject<{
-        rel_path: z.ZodOptional<z.ZodString>;
-        path: z.ZodOptional<z.ZodString>;
-        element_type: z.ZodOptional<z.ZodString>;
-        label: z.ZodOptional<z.ZodString>;
-        has_binding: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$loose>>;
-    total: z.ZodNumber;
-    template_id: z.ZodString;
-    projected_fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+export declare const PAGE_GET_LAYOUT_OUTPUT_SCHEMA: z.ZodObject<{
+    layout_id: z.ZodOptional<z.ZodString>;
+    etag: z.ZodOptional<z.ZodString>;
+    layout_root_pointer: z.ZodOptional<z.ZodString>;
+    pointer_hint: z.ZodOptional<z.ZodString>;
+    layout: z.ZodOptional<z.ZodUnknown>;
+    elements: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    named_sections: z.ZodOptional<z.ZodUnknown>;
+    outline_text: z.ZodOptional<z.ZodString>;
+    mode: z.ZodOptional<z.ZodString>;
+    unchanged: z.ZodOptional<z.ZodBoolean>;
+    note: z.ZodOptional<z.ZodString>;
+    total_elements: z.ZodOptional<z.ZodNumber>;
+    warning: z.ZodOptional<z.ZodString>;
     available_fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    available_fields_by_kind: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
     unknown_fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    field_coverage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     projection_warning: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
+    projected_fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    label_note: z.ZodOptional<z.ZodString>;
+    modules_on_page: z.ZodOptional<z.ZodUnknown>;
+    modules_on_page_unavailable: z.ZodOptional<z.ZodUnknown>;
+    fields_not_applied: z.ZodOptional<z.ZodUnknown>;
+    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.$catchall<z.ZodUnknown>>;
 export declare const ETAG_OUTPUT_SCHEMA: z.ZodObject<{
     etag: z.ZodString;
     generated_at: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const TEMPLATE_SUMMARY_OUTPUT_SCHEMA: z.ZodObject<{
-    template_id: z.ZodOptional<z.ZodString>;
+    layout_id: z.ZodOptional<z.ZodString>;
     counts_by_type: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
     bound_count: z.ZodOptional<z.ZodNumber>;
     max_depth: z.ZodOptional<z.ZodNumber>;
@@ -66,29 +127,22 @@ export declare const TEMPLATE_SUMMARY_OUTPUT_SCHEMA: z.ZodObject<{
     next_cursor: z.ZodOptional<z.ZodString>;
     summaries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     not_found: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    forbidden: z.ZodOptional<z.ZodArray<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>;
-/**
- * Input shape for `yootheme_builder_pages_create`.
- *
- * Mirrors the args of `POST /pages` (Phase B).
- *
- * Design pins:
- *   - `post_type` is intentionally NOT exposed. Layer 9 defensive guard
- *     on the REST side rejects it server-side; surfacing it at the MCP
- *     boundary would invite a footgun where an agent tries to set it
- *     and fails confusingly.
- *   - `status` defaults to `draft` on the server (Q6 design — no public
- *     empty page).
- *   - `dry_run` triggers validation Layers 1+2+4 without persisting.
- */
 export declare const PAGES_CREATE_INPUT: {
     title: z.ZodString;
     slug: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodEnum<{
+        private: "private";
         publish: "publish";
         draft: "draft";
         pending: "pending";
-        private: "private";
         future: "future";
     }>>;
     published: z.ZodDefault<z.ZodBoolean>;
@@ -96,21 +150,6 @@ export declare const PAGES_CREATE_INPUT: {
     layout: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     dry_run: z.ZodOptional<z.ZodBoolean>;
 };
-/**
- * Wire shape for `yootheme_builder_pages_create` on success (non-dry-run).
- *
- * Mirrors the REST 201 response shape.
- *
- * Design pins:
- *   - `frontend_url` is nullable: REST returns null for fresh drafts
- *     before publish.
- *   - `template_id` is a plain string. The "page:{post_id}" prefix is
- *     enforced server-side; adding a `.startsWith()` here would buy no
- *     MCP-client value while adding Zod complexity.
- *   - `warnings` is a lean string array (e.g. "slug_collision_resolved"
- *     when WP auto-appends `-2`). The REST surface may expand this to
- *     richer objects in v1.3; strings keep the v1.2 surface minimal.
- */
 export declare const PAGES_CREATE_OUTPUT_SCHEMA: z.ZodObject<{
     page_id: z.ZodOptional<z.ZodNumber>;
     article_id: z.ZodOptional<z.ZodNumber>;
@@ -119,28 +158,17 @@ export declare const PAGES_CREATE_OUTPUT_SCHEMA: z.ZodObject<{
     status: z.ZodString;
     frontend_url: z.ZodNullable<z.ZodString>;
     builder_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    template_id: z.ZodString;
+    layout_id: z.ZodString;
     etag: z.ZodString;
     warnings: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
-/**
- * Wire shape for `yootheme_builder_pages_create` when `dry_run:true`.
- *
- * Design pin: NO `etag` field. The B6 fix-cycle decision was that
- * surfacing a "live" ETag with a dry-run response invites a stale-
- * If-Match footgun (caller pins the ETag, then non-dry-run mutates,
- * stale ETag rejected with 412). Dry-run is validation-only.
- *
- * `template_id_pattern` is a literal — the actual `template_id` cannot
- * be materialised before WP allocates the post_id.
- */
 export declare const PAGES_CREATE_DRY_RUN_OUTPUT_SCHEMA: z.ZodObject<{
     dry_run: z.ZodLiteral<true>;
     would_create: z.ZodObject<{
         title: z.ZodString;
         slug: z.ZodString;
         status: z.ZodString;
-        template_id_pattern: z.ZodEnum<{
+        layout_id_pattern: z.ZodEnum<{
             "page:{post_id}": "page:{post_id}";
             "article:{article_id}": "article:{article_id}";
         }>;
@@ -151,33 +179,16 @@ export declare const PAGES_CREATE_DRY_RUN_OUTPUT_SCHEMA: z.ZodObject<{
         layer_4_renderer: z.ZodLiteral<"passed">;
     }, z.core.$strip>;
 }, z.core.$strip>;
-/**
- * Input shape for `yootheme_builder_pages_delete`.
- *
- * Mirrors the args of `DELETE /pages/{post_id}` (Phase B).
- *
- * Design pin: `confirm` is `z.literal(true)`. This is the Zod-side
- * enforcement of the confirm gate — the MCP boundary rejects requests
- * without `confirm:true` before they ever hit the REST layer.
- *
- * `force` defaults to false server-side → wp_delete_post(trash). When
- * true → hard delete (irrecoverable).
- */
 export declare const PAGES_DELETE_INPUT: {
-    post_id: z.ZodNumber;
-    confirm: z.ZodLiteral<true>;
-    force: z.ZodOptional<z.ZodBoolean>;
+    layout_id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    confirm: z.ZodOptional<z.ZodBoolean>;
+    intent: z.ZodOptional<z.ZodString>;
 };
-/**
- * Input shape for `yootheme_builder_page_dynamize`. Wraps
- * `POST /pages/dynamize`. Narrowest-schema rule: `template_id` +
- * `list_source_name` + `page.title` are required non-empty; `page` carries
- * the create-machinery passthrough; the reference selector is `section_name`
- * OR `element_path` (exactly-one is enforced server-side so a miss can list
- * the available named sections as remediation).
- */
-export declare const PAGE_DYNAMIZE_INPUT: {
-    template_id: z.ZodString;
+export declare const PAGE_GENERATE_DYNAMIC_INPUT: {
+    layout_id: z.ZodString;
+    output: z.ZodEnum<{
+        new_page: "new_page";
+    }>;
     section_name: z.ZodOptional<z.ZodString>;
     element_path: z.ZodOptional<z.ZodString>;
     list_source_name: z.ZodOptional<z.ZodString>;
@@ -208,10 +219,10 @@ export declare const PAGE_DYNAMIZE_INPUT: {
         slug: z.ZodOptional<z.ZodString>;
         published: z.ZodOptional<z.ZodBoolean>;
         status: z.ZodOptional<z.ZodEnum<{
+            private: "private";
             publish: "publish";
             draft: "draft";
             pending: "pending";
-            private: "private";
             future: "future";
         }>>;
         menu_item: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
@@ -219,34 +230,135 @@ export declare const PAGE_DYNAMIZE_INPUT: {
     etag: z.ZodOptional<z.ZodString>;
     dry_run: z.ZodOptional<z.ZodBoolean>;
 };
-/**
- * Wire shape for `yootheme_builder_pages_delete` on success.
- *
- * `deleted` is `z.literal(true)` — the success-response invariant. A
- * failed delete surfaces as `isError:true` with a structured-error
- * envelope, not as `deleted:false`.
- */
 export declare const PAGES_DELETE_OUTPUT_SCHEMA: z.ZodObject<{
-    deleted: z.ZodLiteral<true>;
+    deleted: z.ZodBoolean;
+    dry_run: z.ZodOptional<z.ZodLiteral<true>>;
+    already_trashed: z.ZodOptional<z.ZodLiteral<true>>;
+    note: z.ZodOptional<z.ZodString>;
+    article_state: z.ZodOptional<z.ZodNumber>;
     page_id: z.ZodOptional<z.ZodNumber>;
     article_id: z.ZodOptional<z.ZodNumber>;
-    force_deleted: z.ZodBoolean;
-    etag: z.ZodString;
+    post_id: z.ZodOptional<z.ZodNumber>;
+    post_type: z.ZodOptional<z.ZodString>;
+    force_deleted: z.ZodOptional<z.ZodBoolean>;
+    etag: z.ZodOptional<z.ZodString>;
     new_etag: z.ZodOptional<z.ZodString>;
     changed_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    element_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    has_dynamic_binding: z.ZodOptional<z.ZodBoolean>;
+    impact_note: z.ZodOptional<z.ZodString>;
+    binding_note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    next_step: z.ZodOptional<z.ZodString>;
+    preview: z.ZodOptional<z.ZodLiteral<true>>;
+    step_reversible: z.ZodOptional<z.ZodBoolean>;
+    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";
+    }>>;
+    requires_confirm: z.ZodOptional<z.ZodLiteral<true>>;
+    requires_confirmation: z.ZodOptional<z.ZodLiteral<true>>;
+    operation: z.ZodOptional<z.ZodString>;
+    warning: z.ZodOptional<z.ZodString>;
+    hint: z.ZodOptional<z.ZodString>;
+    received_confirm: z.ZodOptional<z.ZodUnknown>;
+    received_confirm_type: z.ZodOptional<z.ZodString>;
+    expected_confirm: z.ZodOptional<z.ZodString>;
+    layout_id: z.ZodOptional<z.ZodString>;
+    elements_count: z.ZodOptional<z.ZodNumber>;
+    elements_count_note: z.ZodOptional<z.ZodString>;
+    media_note: z.ZodOptional<z.ZodString>;
+    menu_item_ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    menu_items_note: z.ZodOptional<z.ZodString>;
+    applied: z.ZodOptional<z.ZodLiteral<false>>;
+    requires_intent: z.ZodOptional<z.ZodLiteral<true>>;
+    given_intent: z.ZodOptional<z.ZodString>;
+    current_state: z.ZodOptional<z.ZodString>;
+    intents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        intent: z.ZodString;
+        effect: z.ZodString;
+        reversible: z.ZodBoolean;
+        native_name: z.ZodString;
+        restore_call: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        restore_state_note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        undo: z.ZodString;
+    }, z.core.$strip>>>;
+    notes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    instruction: z.ZodOptional<z.ZodString>;
+    reads_degraded: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        label: "label";
+        elements: "elements";
+    }>>>;
+    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 PAGES_SET_STATUS_INPUT: {
+    layout_id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    status: z.ZodEnum<{
+        private: "private";
+        publish: "publish";
+        draft: "draft";
+        pending: "pending";
+        future: "future";
+        published: "published";
+        unpublished: "unpublished";
+        archived: "archived";
+    }>;
+};
+export declare const PAGES_SET_STATUS_OUTPUT_SCHEMA: z.ZodObject<{
+    post_id: z.ZodNumber;
+    article_id: z.ZodOptional<z.ZodNumber>;
+    layout_id: z.ZodString;
+    post_type: z.ZodOptional<z.ZodString>;
+    status: z.ZodString;
+    previous_status: z.ZodString;
+    changed: z.ZodBoolean;
+    requested_status: z.ZodString;
+    warnings: z.ZodArray<z.ZodString>;
+    changed_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    etag: z.ZodString;
+    new_etag: z.ZodString;
+    findable_by_visitor: z.ZodNullable<z.ZodBoolean>;
+    cms_visibility: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    cms_warning: z.ZodOptional<z.ZodString>;
+    frontend_url: z.ZodOptional<z.ZodString>;
+    frontend_url_provisional: z.ZodOptional<z.ZodBoolean>;
+    frontend_url_note: 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 PAGES_RESTORE_INPUT: {
+    layout_id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+};
+export declare const PAGES_RESTORE_OUTPUT_SCHEMA: z.ZodObject<{
+    restored: z.ZodBoolean;
+    post_id: z.ZodNumber;
+    article_id: z.ZodOptional<z.ZodNumber>;
+    post_type: z.ZodOptional<z.ZodString>;
+    status: z.ZodString;
+    restored_from: z.ZodUnion<[z.ZodLiteral<"trash">, z.ZodLiteral<"trashed">]>;
+    changed_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    etag: z.ZodString;
+    new_etag: z.ZodString;
+    note: z.ZodString;
+    frontend_url: 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>;
-/**
- * The five addressing keys, in the order they are documented + put on the
- * wire. SSOT for both the `matched_by` echo enum and the runtime iteration in
- * `./target.ts`.
- */
 export declare const TARGET_KEYS: readonly ["template_id", "post_id", "url", "special", "title"];
-/**
- * The semantic-special vocabulary, byte-identical to PHP `SpecialTargetMap`'s
- * key set. `date` is IN the vocabulary but unsupported on both platforms — it
- * resolves to a clean `special_not_supported` error rather than "unknown
- * special", which is why it is listed here.
- */
 export declare const SPECIAL_TARGET_TOKENS: readonly ["home", "front-page", "blog", "search", "404", "category", "tag", "author", "archive", "date"];
 export declare const PAGES_TARGET: z.ZodObject<{
     template_id: z.ZodOptional<z.ZodString>;
@@ -288,15 +400,15 @@ export declare const PAGES_RESOLVE_INPUT: {
     }, z.core.$strip>>;
 };
 export declare const PAGES_RESOLVE_OUTPUT_SCHEMA: z.ZodObject<{
-    template_id: z.ZodString;
+    layout_id: z.ZodString;
     post_id: z.ZodNullable<z.ZodNumber>;
     type: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
     frontend_url: z.ZodNullable<z.ZodString>;
     context: z.ZodNullable<z.ZodString>;
     resolved_via: z.ZodEnum<{
-        per_page: "per_page";
         theme_template: "theme_template";
+        per_page: "per_page";
     }>;
     matched_by: z.ZodOptional<z.ZodEnum<{
         url: "url";
@@ -306,58 +418,42 @@ export declare const PAGES_RESOLVE_OUTPUT_SCHEMA: z.ZodObject<{
         special: "special";
     }>>;
 }, z.core.$strip>;
-/**
- * Wire shape for `yootheme_builder_render_preview` on success.
- *
- * STRICT (additionalProperties:false default ZodObject) — every field the
- * handler puts in structuredContent MUST be declared here, or a strict MCP
- * host -32602-rejects the SUCCESS (the structured-content-shape-pin guard
- * enforces this).
- *
- *   - rendered:   the in-process Builder render did NOT throw.
- *   - item_count: count of rendered repeat-source items (`el-item` rows).
- *   - empty:      the rendered HTML is empty / whitespace-only.
- *   - error:      OPTIONAL — present ONLY when the render threw; the otherwise-
- *                 swallowed YOOtheme render message.
- *   - cache_purge_hint: the constant operator steer (purge Rocket/CDN after save).
- *   - template_id: echoed back (the resolved id the render ran on).
- *   - matched:    OPTIONAL — present ONLY when the caller passed `expect`; did the
- *                 rendered HTML contain that substring (customer HANDOFF-6 #4).
- *   - snippet:    OPTIONAL — present ONLY when the caller passed `expect`; a
- *                 ~200-char window around the first match (or null when not
- *                 matched / the render threw). NULLABLE so the no-match case
- *                 validates under the strict schema.
- */
 export declare const RENDER_PREVIEW_OUTPUT_SCHEMA: z.ZodObject<{
     rendered: z.ZodBoolean;
-    item_count: z.ZodNumber;
+    rendered_item_wrapper_count: z.ZodNumber;
+    rendered_item_wrapper_count_note: z.ZodOptional<z.ZodString>;
     empty: z.ZodBoolean;
+    fallback_used: z.ZodBoolean;
+    dropped_count: z.ZodNumber;
+    dropped_count_note: z.ZodOptional<z.ZodString>;
     error: z.ZodOptional<z.ZodString>;
     cache_purge_hint: z.ZodString;
-    template_id: z.ZodString;
+    layout_id: z.ZodString;
+    source_item_counts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    unresolved_sources: z.ZodOptional<z.ZodArray<z.ZodString>>;
     matched: z.ZodOptional<z.ZodBoolean>;
     snippet: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    match_conclusive: z.ZodOptional<z.ZodBoolean>;
+    match_note: z.ZodOptional<z.ZodString>;
+    mismatch_hints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    stored_but_not_rendered: z.ZodOptional<z.ZodObject<{
+        elements: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            source_name: z.ZodString;
+        }, z.core.$strip>>;
+        note: z.ZodString;
+    }, z.core.$strip>>;
+    cms_status: z.ZodOptional<z.ZodString>;
+    cms_status_note: 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>;
-/**
- * Wire shape for `yootheme_builder_heading_outline` on success.
- *
- * STRICT (additionalProperties:false default ZodObject) — every field the
- * handler puts in structuredContent MUST be declared here, or a strict MCP
- * host -32602-rejects the SUCCESS.
- *
- *   - outline: every H1-H6 heading, in TRUE document order, each carrying its
- *     TEXT and the source element that carries it (`element_type`/`path`).
- *   - images: every image this pass sees (populated OR empty alt) — `alt` is
- *     null for a missing/empty alt, the raw string otherwise; `is_generic_alt`
- *     flags an exact match against the same generic-phrase list pages_audit's
- *     `generic-alt-text` check uses ("logo", "image", "photo", ...).
- *   - h1_count / has_level_skip / images_missing_alt: derived flags —
- *     has_level_skip mirrors pages_audit's `heading-skip` check EXACTLY (a
- *     level more than one above the highest seen so far, including a
- *     document that OPENS below h1).
- */
 export declare const HEADING_OUTLINE_OUTPUT_SCHEMA: z.ZodObject<{
-    template_id: z.ZodString;
+    layout_id: z.ZodString;
     mode: z.ZodEnum<{
         rendered: "rendered";
         builder: "builder";
@@ -378,28 +474,15 @@ export declare const HEADING_OUTLINE_OUTPUT_SCHEMA: z.ZodObject<{
     h1_count: z.ZodNumber;
     has_level_skip: z.ZodBoolean;
     images_missing_alt: z.ZodNumber;
+    render_fallback_used: z.ZodOptional<z.ZodBoolean>;
+    render_dropped_count: z.ZodOptional<z.ZodNumber>;
+    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>;
-/**
- * The human-locatable address of ONE audit hit (B-3/B-5) — mirrors the PHP
- * `FindingLocator::toArray()` wire shape. `path` stays the machine write
- * address; `breadcrumb`/`element_type`/`element_name` are what a HUMAN needs
- * to find the element in the customizer. Per the PHP null-key policy the
- * optional members are OMITTED rather than sent as null.
- *
- * FAIL-SOFT BY CONSTRUCTION. `pages[]` rows used to ride through
- * `.catchall(z.unknown())` untyped; now that `locators` is a typed array, a
- * mismatch is no longer stripped — the MCP SDK THROWS `McpError`
- * (InvalidParams) on an outputSchema violation, which fails the WHOLE audit
- * call. So the optional members are `.nullish()` (an explicit `null` from a
- * host that does not honour the omit-nulls policy must not be fatal) and the
- * object carries a `.catchall`, so a field a future host version adds can
- * never hard-fail an otherwise perfectly good audit.
- *
- * `repeat` is the one deliberately STRICT member: PHP emits it clamped to
- * `>= 1` (`repeat: 0` is meaningless — a hit that renders zero times is not a
- * hit), so `min(1)` states the real contract rather than tolerating a value
- * that could only mean a producer bug.
- */
 export declare const FINDING_LOCATOR: z.ZodObject<{
     path: z.ZodString;
     breadcrumb: z.ZodString;
@@ -411,37 +494,6 @@ export declare const FINDING_LOCATOR: z.ZodObject<{
     prop: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$catchall<z.ZodUnknown>>;
-/**
- * One audit finding. `pages` carries per-page mini-evidence whose KEYS vary
- * by check code (`first_headline_path`, `alt_paths`, `cluster_id`,
- * `iterated`, `disabled_elements`, `elements_content`, ...) — `.catchall`
- * keeps every row's base `{id, label}` typed while tolerating the
- * check-specific extras without a per-code union.
- *
- * The ADDITIVE B-3/B-5 keys (`locators`, `hits_truncated`,
- * `locators_stripped`, `builder_url`) are declared EXPLICITLY for
- * self-documentation — the `.catchall` already tolerated them, but a named
- * member states the contract. All stay `.optional()`: a host plugin predating
- * B-3 emits none of them.
- *
- * `frontend_url` (T-B1, 2026-07-24) rides alongside `builder_url` on EVERY
- * page entry now, not just the nine element-located "hit" checks — a
- * theme/archive template with no public route legitimately omits it (never
- * emitted as `null`), same convention as `builder_url`.
- *
- * `hits_truncated` and `locators_stripped` mean DIFFERENT things and are never
- * interchangeable: the former says the upstream `hit_cap` dropped hits (so the
- * raw `paths`/`alt_paths`/`skips`/`dead_anchors` arrays are incomplete), the
- * latter says the transport's shrink-to-fit shed locator PROSE while leaving
- * those arrays complete.
- *
- * FORWARD-COMPAT `.catchall`, for the same reason `FINDING_LOCATOR` carries one:
- * the handler forwards each finding VERBATIM, and a strict object generates
- * `additionalProperties:false`, so ONE additive field on the PHP side (an
- * explicit hit total, a new evidence key) would make a strict host -32602-reject
- * an otherwise perfect audit. Every declared member is still validated; only
- * UNDECLARED ones ride through untyped.
- */
 export declare const FINDING: z.ZodObject<{
     code: z.ZodString;
     category: z.ZodEnum<{
@@ -452,12 +504,12 @@ export declare const FINDING: z.ZodObject<{
         design: "design";
     }>;
     severity: z.ZodEnum<{
+        info: "info";
         warning: "warning";
         critical: "critical";
-        info: "info";
     }>;
     title: z.ZodString;
-    count: z.ZodNumber;
+    affected_pages: z.ZodNumber;
     pages: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         label: z.ZodString;
@@ -472,25 +524,20 @@ export declare const FINDING: z.ZodObject<{
             prop: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$catchall<z.ZodUnknown>>>>;
-        hits: z.ZodOptional<z.ZodNumber>;
+        occurrences_here: z.ZodOptional<z.ZodNumber>;
+        bound_gaps_not_counted: z.ZodOptional<z.ZodNumber>;
         hits_truncated: z.ZodOptional<z.ZodBoolean>;
         locators_stripped: z.ZodOptional<z.ZodBoolean>;
         builder_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         frontend_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$catchall<z.ZodUnknown>>>;
-    pages_truncated: z.ZodBoolean;
+    finding_pages_truncated: z.ZodBoolean;
     fix_hint: z.ZodOptional<z.ZodObject<{
         tool: z.ZodString;
         args_template: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         note: z.ZodString;
     }, z.core.$strip>>;
 }, z.core.$catchall<z.ZodUnknown>>;
-/**
- * The advisory block `page_publish` (default on) / `page_save`
- * (opt-in via `quick_check:true`) attach (Task 8). Design §7: `{clean:true}`
- * on zero findings, else `{findings, note}` pointing at `pages_audit` for
- * the site-wide (scope==='site') checks this per-page pass does not run.
- */
 export declare const QUICK_CHECK: z.ZodObject<{
     clean: z.ZodOptional<z.ZodBoolean>;
     findings: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -503,12 +550,12 @@ export declare const QUICK_CHECK: z.ZodObject<{
             design: "design";
         }>;
         severity: z.ZodEnum<{
+            info: "info";
             warning: "warning";
             critical: "critical";
-            info: "info";
         }>;
         title: z.ZodString;
-        count: z.ZodNumber;
+        affected_pages: z.ZodNumber;
         pages: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             label: z.ZodString;
@@ -523,13 +570,14 @@ export declare const QUICK_CHECK: z.ZodObject<{
                 prop: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             }, z.core.$catchall<z.ZodUnknown>>>>;
-            hits: z.ZodOptional<z.ZodNumber>;
+            occurrences_here: z.ZodOptional<z.ZodNumber>;
+            bound_gaps_not_counted: z.ZodOptional<z.ZodNumber>;
             hits_truncated: z.ZodOptional<z.ZodBoolean>;
             locators_stripped: z.ZodOptional<z.ZodBoolean>;
             builder_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             frontend_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$catchall<z.ZodUnknown>>>;
-        pages_truncated: z.ZodBoolean;
+        finding_pages_truncated: z.ZodBoolean;
         fix_hint: z.ZodOptional<z.ZodObject<{
             tool: z.ZodString;
             args_template: z.ZodRecord<z.ZodString, z.ZodUnknown>;
@@ -538,10 +586,6 @@ export declare const QUICK_CHECK: z.ZodObject<{
     }, z.core.$catchall<z.ZodUnknown>>>>;
     note: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-/**
- * Input shape for `yootheme_builder_pages_audit` (design §5). `site_id` is
- * spread in separately by `builders.ts` (mirrors PAGES_RESOLVE_INPUT).
- */
 export declare const PAGES_AUDIT_INPUT: {
     mode: z.ZodOptional<z.ZodEnum<{
         rendered: "rendered";
@@ -577,19 +621,14 @@ export declare const PAGES_AUDIT_INPUT: {
     stale_after_months: z.ZodOptional<z.ZodNumber>;
     max_chars: z.ZodOptional<z.ZodNumber>;
     include_meta: z.ZodDefault<z.ZodBoolean>;
+    include_modules: z.ZodOptional<z.ZodBoolean>;
 };
-/**
- * Wire shape for `yootheme_builder_pages_audit` (design §5). `scanned.by_type`
- * is a `Record<string, number>` — the PHP side already normalizes an empty
- * sweep to `(object) []` (`{}` over the wire), matching this schema without
- * the array-vs-object workaround `template_summary` needed (Task #46).
- */
 export declare const PAGES_AUDIT_OUTPUT_SCHEMA: z.ZodObject<{
     etag: z.ZodString;
     scope: z.ZodOptional<z.ZodString>;
     note: z.ZodOptional<z.ZodString>;
     resolved_target: z.ZodOptional<z.ZodObject<{
-        template_id: z.ZodOptional<z.ZodString>;
+        layout_id: z.ZodOptional<z.ZodString>;
         post_id: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
         type: z.ZodOptional<z.ZodString>;
         label: z.ZodOptional<z.ZodString>;
@@ -603,9 +642,11 @@ export declare const PAGES_AUDIT_OUTPUT_SCHEMA: z.ZodObject<{
         by_type: z.ZodRecord<z.ZodString, z.ZodNumber>;
     }, z.core.$strip>;
     summary: z.ZodObject<{
-        critical: z.ZodNumber;
-        warning: z.ZodNumber;
-        info: z.ZodNumber;
+        critical_finding_kinds: z.ZodNumber;
+        warning_finding_kinds: z.ZodNumber;
+        info_finding_kinds: z.ZodNumber;
+        finding_kinds: z.ZodOptional<z.ZodNumber>;
+        affected_pages_summed_across_findings: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     findings: z.ZodArray<z.ZodObject<{
         code: z.ZodString;
@@ -617,12 +658,12 @@ export declare const PAGES_AUDIT_OUTPUT_SCHEMA: z.ZodObject<{
             design: "design";
         }>;
         severity: z.ZodEnum<{
+            info: "info";
             warning: "warning";
             critical: "critical";
-            info: "info";
         }>;
         title: z.ZodString;
-        count: z.ZodNumber;
+        affected_pages: z.ZodNumber;
         pages: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             label: z.ZodString;
@@ -637,13 +678,14 @@ export declare const PAGES_AUDIT_OUTPUT_SCHEMA: z.ZodObject<{
                 prop: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             }, z.core.$catchall<z.ZodUnknown>>>>;
-            hits: z.ZodOptional<z.ZodNumber>;
+            occurrences_here: z.ZodOptional<z.ZodNumber>;
+            bound_gaps_not_counted: z.ZodOptional<z.ZodNumber>;
             hits_truncated: z.ZodOptional<z.ZodBoolean>;
             locators_stripped: z.ZodOptional<z.ZodBoolean>;
             builder_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             frontend_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$catchall<z.ZodUnknown>>>;
-        pages_truncated: z.ZodBoolean;
+        finding_pages_truncated: z.ZodBoolean;
         fix_hint: z.ZodOptional<z.ZodObject<{
             tool: z.ZodString;
             args_template: z.ZodRecord<z.ZodString, z.ZodUnknown>;
@@ -651,7 +693,13 @@ export declare const PAGES_AUDIT_OUTPUT_SCHEMA: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$catchall<z.ZodUnknown>>>;
     disclaimer: z.ZodString;
+    occurrences_unit: z.ZodOptional<z.ZodString>;
     structured_truncated: z.ZodOptional<z.ZodBoolean>;
+    truncated_by: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        response_budget: "response_budget";
+        per_page_hit_cap: "per_page_hit_cap";
+    }>>>;
+    truncation_remedy: z.ZodOptional<z.ZodString>;
     mode: z.ZodOptional<z.ZodEnum<{
         rendered: "rendered";
     }>>;
@@ -659,11 +707,45 @@ export declare const PAGES_AUDIT_OUTPUT_SCHEMA: z.ZodObject<{
         attempted: z.ZodNumber;
         rendered: z.ZodNumber;
         capped: z.ZodBoolean;
+        skipped_by_cap: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>>;
+        skipped_by_cap_not_listed: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    checks_not_run: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    checks_limited_to_saved_layout: z.ZodOptional<z.ZodObject<{
+        codes: z.ZodArray<z.ZodString>;
+        note: z.ZodString;
     }, z.core.$strip>>;
     render_errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         label: z.ZodString;
         error: z.ZodString;
+        error_class: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    render_fallback: z.ZodOptional<z.ZodObject<{
+        pages: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            dropped_count: z.ZodNumber;
+        }, z.core.$strip>>;
+        suppressed_checks: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    modules_by_page: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        from_elements: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        from_positions: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        from_positions_undecidable: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        unresolved_positions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            position: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strip>>>;
+        unresolved_module_universe: z.ZodOptional<z.ZodObject<{
+            reason: z.ZodString;
+        }, z.core.$strip>>;
     }, z.core.$strip>>>;
+    modules_by_page_omitted: z.ZodOptional<z.ZodBoolean>;
+    retry_hint: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 //# sourceMappingURL=schemas.d.ts.map