@wootsup/yt-builder-mcp 1.1.7 → 1.3.0

package/dist/tools/pages/handlers-write.js

@@ -1,23 +1,28 @@
 /**
- * Page-tool WRITE handlers — `page_save`, `page_publish`. Both implement
- * the 3-phase progress contract (PHASE_SEND → PHASE_SERVER → PHASE_CONFIRM).
- * PHASE_SERVER is emitted BEFORE the await so the synthetic intermediate
- * fires even when the REST call ultimately errors — the dispatch IS the
- * boundary, not the response.
+ * Page-tool WRITE handlers — `page_save`, `page_publish`, `pages_create`,
+ * `pages_delete`. All implement the 3-phase progress contract
+ * (PHASE_SEND → PHASE_SERVER → PHASE_CONFIRM). PHASE_SERVER is emitted
+ * BEFORE the await so the synthetic intermediate fires even when the
+ * REST call ultimately errors — the dispatch IS the boundary, not the
+ * response.
  *
  * Split out of `src/tools/pages.ts` (Round-2 R2-A2-CRIT1).
+ * Extended with pages_create / pages_delete (v1.2 — C2 + C3).
  *
  * @license MIT
  */
+import { encodeTemplateId } from '../../client.js';
 import { PHASE_CONFIRM, PHASE_SEND, PHASE_SERVER } from '../progress-phases.js';
-import { createProgressReporter, errorResult, jsonResult, } from '../tool-builder.js';
+import { createProgressReporter, errorResult, jsonResult, structuredResult, } from '../tool-builder.js';
 // ─── page_save ──────────────────────────────────────────────────────
-export async function handlePageSave(client, { template_id, etag }, extra) {
+export async function handlePageSave(client, { template_id, etag, layout }, extra) {
     const progress = extra ? createProgressReporter(extra) : null;
     await progress?.report(0, 3, PHASE_SEND);
     await progress?.report(1, 3, PHASE_SERVER);
     try {
-        const data = await client.post(`/pages/${encodeURIComponent(template_id)}/save`, { etag });
+        // F85: forward `layout` only when supplied so the historical save
+        // body (`{}`) is byte-unchanged for the re-run-transforms path.
+        const data = await client.post(`/pages/${encodeTemplateId(template_id)}/save`, layout !== undefined ? { body: { layout }, etag } : { etag });
         await progress?.report(2, 3, PHASE_CONFIRM);
         return jsonResult(data);
     }
@@ -26,19 +31,46 @@ export async function handlePageSave(client, { template_id, etag }, extra) {
             error: e,
             context: { template_id, etag },
             hint: 'On 412 (precondition failed) refresh via yootheme_builder_get_etag ' +
-                'and retry — someone else edited the page.',
+                'and retry — someone else edited the page. On 422 the supplied ' +
+                '`layout` failed validation (unknown element type or bad structure) — ' +
+                'the error `path` + `element_type` pinpoint the offending node.',
         });
     }
 }
 // ─── page_publish ───────────────────────────────────────────────────
+/**
+ * F202 (P1): when the publish/dynamize response carries a `cms_warning` (the
+ * YT-layout is published but the backing CMS object — WP post / Joomla article
+ * — is NOT publicly visible: draft/future status, future publish_up, or no
+ * route), append it as a SALIENT trailing text block. The JSON leg already
+ * carries `cms_visibility` + `cms_warning`; the extra block makes the warning
+ * survive a long, context-rotted session where the agent skips parsing the
+ * payload and declares success on a page that 404s anonymously.
+ *
+ * No-op (returns the result unchanged) when there is no `cms_warning` — the
+ * publicly-visible happy path keeps its single-leg shape.
+ */
+function withCmsWarningText(result, data) {
+    if (typeof data !== 'object' || data === null) {
+        return result;
+    }
+    const warning = data.cms_warning;
+    if (typeof warning !== 'string' || warning === '') {
+        return result;
+    }
+    return {
+        ...result,
+        content: [...result.content, { type: 'text', text: warning }],
+    };
+}
 export async function handlePagePublish(client, { template_id, etag }, extra) {
     const progress = extra ? createProgressReporter(extra) : null;
     await progress?.report(0, 3, PHASE_SEND);
     await progress?.report(1, 3, PHASE_SERVER);
     try {
-        const data = await client.post(`/pages/${encodeURIComponent(template_id)}/publish`, { etag });
+        const data = await client.post(`/pages/${encodeTemplateId(template_id)}/publish`, { etag });
         await progress?.report(2, 3, PHASE_CONFIRM);
-        return jsonResult(data);
+        return withCmsWarningText(jsonResult(data), data);
     }
     catch (e) {
         return errorResult({
@@ -49,4 +81,176 @@ export async function handlePagePublish(client, { template_id, etag }, extra) {
         });
     }
 }
+/**
+ * F12 (2026-06-09): collapse the friendly `published` boolean into the
+ * canonical `status` the PHP host understands.
+ *
+ * Precedence: an EXPLICIT `status` always wins — `published` is the
+ * ergonomic shortcut, not an override. So:
+ *   - status given           → use it verbatim (published ignored).
+ *   - status absent + true    → 'publish' (WP post_status=publish, Joomla state=1).
+ *   - status absent + false/∅ → undefined (server applies its draft default).
+ *
+ * Returning `undefined` (rather than an explicit `'draft'`) for the
+ * default case preserves the existing wire shape — the server's Q6
+ * default-to-draft logic stays authoritative and the body byte-shape is
+ * unchanged for legacy callers that never sent `published`.
+ */
+export function resolveCreateStatus(status, published) {
+    if (status !== undefined)
+        return status;
+    if (published === true)
+        return 'publish';
+    return undefined;
+}
+/**
+ * `pages_create` — POST `/pages` with the provided body. On
+ * `dry_run:true`, the REST handler runs validation Layers 1+2+4
+ * without persisting and returns a dry-run report. On non-dry-run
+ * success, the REST handler returns 201 with the wire shape of
+ * `PAGES_CREATE_OUTPUT_SCHEMA`.
+ */
+export async function handlePagesCreate(client, input, extra) {
+    const progress = extra ? createProgressReporter(extra) : null;
+    await progress?.report(0, 3, PHASE_SEND);
+    await progress?.report(1, 3, PHASE_SERVER);
+    // F12: translate the `published` shortcut into the host-native
+    // `status` and DROP `published` from the wire body (the REST host has
+    // no such field). `status` is omitted entirely when neither an
+    // explicit status nor published:true was given, so the server's
+    // draft-default stays authoritative and the body shape is unchanged
+    // for legacy callers.
+    const { published: _published, status: _status, ...rest } = input;
+    const resolvedStatus = resolveCreateStatus(input.status, input.published);
+    const body = resolvedStatus !== undefined ? { ...rest, status: resolvedStatus } : rest;
+    try {
+        const data = await client.post('/pages', { body });
+        await progress?.report(2, 3, PHASE_CONFIRM);
+        return jsonResult(data);
+    }
+    catch (e) {
+        return errorResult({
+            error: e,
+            context: {
+                title: input.title,
+                slug: input.slug,
+                dry_run: input.dry_run ?? false,
+            },
+            hint: 'Common issues: missing title (400), unknown element type in layout ' +
+                '(422), Builder pre-check failed (422 dry-run or wet), post_type/content_type ' +
+                'other than page/article (403). For dry-run: re-submit without dry_run:true ' +
+                'to actually create. ' +
+                // F95 (2026-06-10): a `body_parse_failed` 400 means the AI host
+                // TRUNCATED the arguments JSON in transit (a known failure mode
+                // for large inline `layout` payloads ~10KB+). Do NOT retry the
+                // same giant all-in-one create — create the page with a
+                // small/empty layout first, then build it up element-by-element.
+                'On a `body_parse_failed` 400 the tool-call arguments were truncated in ' +
+                'transit (large inline `layout`): create the page with an empty/small ' +
+                'layout, then add elements one at a time via element_add / ' +
+                'element_bind_source instead of one giant inline `layout`.',
+        });
+    }
+}
+/**
+ * The recency reminder appended to every successful dynamize (research:
+ * checklist echo — keeps the "verify visually" step salient even in a
+ * long, context-rotted session). One line, by design (F98 rank-3:
+ * attention-dilution on a longer echo).
+ */
+const DYNAMIZE_SUCCESS_REMINDER = 'Verify one row visually against the original at the customer viewport before declaring success.';
+/**
+ * `page_dynamize` — POST `/pages/dynamize`. THE one-call canonical path to
+ * dynamize an existing designed section: the server copies the reference
+ * subtree byte-identically and swaps only the mapped queries + leaf
+ * field-names (the recipe of `dynamize-existing-layout.md` as CODE), then
+ * creates the page through the same hardened create path. The 201 carries
+ * a `summary` self-check ({queries_swapped, leaves_remapped, leaves_kept,
+ * leaves_removed, unmatched_map_keys, kept_unresolvable}). A non-empty
+ * `unmatched_map_keys` means the agent mapped a field the reference subtree
+ * never bound; a non-zero `kept_unresolvable.count` means a sub-query panel
+ * had no flow field (its leaves render empty) — extend leaf_map with the
+ * qualified "<subquery>.<leaf>" keys and retry.
+ */
+export async function handlePageDynamize(client, input, extra) {
+    const progress = extra ? createProgressReporter(extra) : null;
+    await progress?.report(0, 3, PHASE_SEND);
+    await progress?.report(1, 3, PHASE_SERVER);
+    try {
+        const data = await client.post('/pages/dynamize', { body: input, etag: input.etag });
+        await progress?.report(2, 3, PHASE_CONFIRM);
+        // Append the one-line recency reminder as a trailing text block so
+        // the JSON leg stays byte-pure (parsers read content[0]) while the
+        // human + model see the verify-visually nudge.
+        const base = jsonResult(data);
+        const withReminder = {
+            ...base,
+            content: [...base.content, { type: 'text', text: DYNAMIZE_SUCCESS_REMINDER }],
+        };
+        // F202: when a dynamize PUBLISHED to a draft/scheduled/unrouted CMS
+        // object, surface the cms_warning as a salient trailing block too.
+        return withCmsWarningText(withReminder, data);
+    }
+    catch (e) {
+        return errorResult({
+            error: e,
+            context: {
+                template_id: input.template_id,
+                section_name: input.section_name,
+                element_path: input.element_path,
+                list_source_name: input.list_source_name,
+            },
+            hint: 'On 404 section_not_found the error data lists `available_named_sections` — ' +
+                'pick one and retry. Provide EXACTLY ONE of section_name / element_path. ' +
+                'On 422 the dynamized layout failed validation (the `path` + `element_type` ' +
+                'pinpoint the node). On 412 refresh via yootheme_builder_get_etag and retry. ' +
+                'Check the response `summary.unmatched_map_keys` — a non-empty list means a ' +
+                'leaf_map key did not match any leaf in the reference subtree (typo, or wrong ' +
+                'reference section). Check `summary.kept_unresolvable` — a non-zero count means a ' +
+                'sub-query panel had no flow field; add the qualified "<subquery>.<leaf>" keys to ' +
+                'leaf_map and retry.',
+        });
+    }
+}
+/**
+ * `pages_delete` — DELETE `/pages/{post_id}` with confirm + force in the
+ * body. `force:false` (default) trashes via `wp_delete_post(false)`
+ * (recoverable via wp-admin). `force:true` hard-deletes the post
+ * (irrecoverable). The REST handler returns 200 with the wire shape of
+ * `PAGES_DELETE_OUTPUT_SCHEMA` on success.
+ */
+export async function handlePagesDelete(client, input, extra) {
+    const progress = extra ? createProgressReporter(extra) : null;
+    await progress?.report(0, 3, PHASE_SEND);
+    await progress?.report(1, 3, PHASE_SERVER);
+    try {
+        const data = await client.delete(`/pages/${encodeURIComponent(String(input.post_id))}`, {
+            body: {
+                confirm: input.confirm,
+                force: input.force ?? false,
+            },
+        });
+        await progress?.report(2, 3, PHASE_CONFIRM);
+        // Task #38 (2026-05-29): pages_delete declares
+        // `outputSchema: PAGES_DELETE_OUTPUT_SCHEMA` in builders.ts. The
+        // host therefore validates `structuredContent` and rejects with
+        // `-32602 Output validation error` when it is missing. Use
+        // `structuredResult` (mirrors handlePagesList et al.) so the
+        // text leg stays LLM-readable AND the structured leg validates.
+        const toolkitResult = jsonResult(data);
+        return structuredResult({ content: toolkitResult.content }, data);
+    }
+    catch (e) {
+        return errorResult({
+            error: e,
+            context: {
+                post_id: input.post_id,
+                force: input.force ?? false,
+            },
+            hint: 'Common issues: missing confirm:true (400), unknown post id (404), ' +
+                'post_type other than "page" (403). For permanent delete pass ' +
+                'force:true; default is trash (recoverable via wp-admin).',
+        });
+    }
+}
 //# sourceMappingURL=handlers-write.js.map

package/dist/tools/pages/handlers-write.js.map

@@ -1 +1 @@
-{"version":3,"file":"handlers-write.js","sourceRoot":"","sources":["../../../src/tools/pages/handlers-write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EACH,sBAAsB,EACtB,WAAW,EACX,UAAU,GAGb,MAAM,oBAAoB,CAAC;AAO5B,uEAAuE;AAEvE,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,MAAkB,EAClB,EAAE,WAAW,EAAE,IAAI,EAAoB,EACvC,KAAoB;IAEpB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;IACzC,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC;IAC3C,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAC1B,UAAU,kBAAkB,CAAC,WAAW,CAAC,OAAO,EAChD,EAAE,IAAI,EAAE,CACX,CAAC;QACF,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC;QAC5C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,WAAW,CAAC;YACf,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;YAC9B,IAAI,EACA,qEAAqE;gBACrE,2CAA2C;SAClD,CAAC,CAAC;IACP,CAAC;AACL,CAAC;AAED,uEAAuE;AAEvE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACnC,MAAkB,EAClB,EAAE,WAAW,EAAE,IAAI,EAAoB,EACvC,KAAoB;IAEpB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;IACzC,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC;IAC3C,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAC1B,UAAU,kBAAkB,CAAC,WAAW,CAAC,UAAU,EACnD,EAAE,IAAI,EAAE,CACX,CAAC;QACF,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC;QAC5C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,WAAW,CAAC;YACf,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;YAC9B,IAAI,EACA,qEAAqE;gBACrE,YAAY;SACnB,CAAC,CAAC;IACP,CAAC;AACL,CAAC"}
+{"version":3,"file":"handlers-write.js","sourceRoot":"","sources":["../../../src/tools/pages/handlers-write.ts"],"names":[],"mappings":"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"}

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

@@ -13,5 +13,5 @@
  * @license MIT
  */
 export { buildPagesTools } from './builders.js';
-export { ETAG_OUTPUT_SCHEMA, PAGES_LIST_OUTPUT_SCHEMA, SCHEMA_OUTPUT_SCHEMA, TEMPLATE_SUMMARY_OUTPUT_SCHEMA, } from './schemas.js';
+export { ETAG_OUTPUT_SCHEMA, PAGE_DYNAMIZE_INPUT, PAGES_LIST_OUTPUT_SCHEMA, SCHEMA_OUTPUT_SCHEMA, TEMPLATE_SUMMARY_OUTPUT_SCHEMA, } from './schemas.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/pages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACH,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,8BAA8B,GACjC,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/pages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACH,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,8BAA8B,GACjC,MAAM,cAAc,CAAC"}

package/dist/tools/pages/index.js

@@ -13,5 +13,5 @@
  * @license MIT
  */
 export { buildPagesTools } from './builders.js';
-export { ETAG_OUTPUT_SCHEMA, PAGES_LIST_OUTPUT_SCHEMA, SCHEMA_OUTPUT_SCHEMA, TEMPLATE_SUMMARY_OUTPUT_SCHEMA, } from './schemas.js';
+export { ETAG_OUTPUT_SCHEMA, PAGE_DYNAMIZE_INPUT, PAGES_LIST_OUTPUT_SCHEMA, SCHEMA_OUTPUT_SCHEMA, TEMPLATE_SUMMARY_OUTPUT_SCHEMA, } from './schemas.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/pages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACH,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,8BAA8B,GACjC,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/pages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACH,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,8BAA8B,GACjC,MAAM,cAAc,CAAC"}

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

@@ -14,6 +14,7 @@ export declare const PAGES_LIST_OUTPUT_SCHEMA: z.ZodObject<{
     projected_fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     available_fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     unknown_fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    projection_warning: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const SCHEMA_OUTPUT_SCHEMA: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
@@ -42,4 +43,169 @@ export declare const TEMPLATE_SUMMARY_OUTPUT_SCHEMA: z.ZodObject<{
     }, z.core.$strip>>;
     etag: z.ZodString;
 }, 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<{
+        publish: "publish";
+        draft: "draft";
+        pending: "pending";
+        private: "private";
+        future: "future";
+    }>>;
+    published: z.ZodDefault<z.ZodBoolean>;
+    menu_item: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    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>;
+    title: z.ZodString;
+    slug: z.ZodString;
+    status: z.ZodString;
+    frontend_url: z.ZodNullable<z.ZodString>;
+    builder_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    template_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<{
+            "page:{post_id}": "page:{post_id}";
+            "article:{article_id}": "article:{article_id}";
+        }>;
+    }, z.core.$strip>;
+    validation_report: z.ZodObject<{
+        layer_1_structural: z.ZodLiteral<"passed">;
+        layer_2_element_types: z.ZodLiteral<"passed">;
+        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>;
+};
+/**
+ * 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;
+    section_name: z.ZodOptional<z.ZodString>;
+    element_path: z.ZodOptional<z.ZodString>;
+    list_source_name: z.ZodOptional<z.ZodString>;
+    source_map: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        match: z.ZodString;
+        source_name: z.ZodString;
+        leaf_map: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            name: z.ZodString;
+            filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>]>>>;
+    }, z.core.$strict>>>;
+    leaf_map: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>]>>>;
+    conditions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        filters: z.ZodObject<{
+            condition: z.ZodEnum<{
+                "!": "!";
+                "!!": "!!";
+            }>;
+        }, z.core.$strip>;
+    }, z.core.$strict>>>;
+    remove_leaves: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    page: z.ZodObject<{
+        title: z.ZodString;
+        slug: z.ZodOptional<z.ZodString>;
+        published: z.ZodOptional<z.ZodBoolean>;
+        status: z.ZodOptional<z.ZodEnum<{
+            publish: "publish";
+            draft: "draft";
+            pending: "pending";
+            private: "private";
+            future: "future";
+        }>>;
+        menu_item: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    }, z.core.$strip>;
+    etag: z.ZodOptional<z.ZodString>;
+};
+/**
+ * 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>;
+    page_id: z.ZodOptional<z.ZodNumber>;
+    article_id: z.ZodOptional<z.ZodNumber>;
+    force_deleted: z.ZodBoolean;
+    etag: z.ZodString;
+}, z.core.$strip>;
 //# sourceMappingURL=schemas.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/pages/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,wBAAwB;;;;;;;iBA8BnC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAiB/B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAWH,eAAO,MAAM,8BAA8B;;;;;;;;;;;iBAazC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/pages/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,wBAAwB;;;;;;;;iBAwCnC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAiB/B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAWH,eAAO,MAAM,8BAA8B;;;;;;;;;;;iBAazC,CAAC;AAWH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;CAiE9B,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;iBA2BlC,CAAC;AAEN;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;iBAe7C,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB;;;;CAoB9B,CAAC;AAmCF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqI/B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;;;;;;iBAYlC,CAAC"}