@wootsup/yt-builder-mcp 1.2.0 → 1.4.0

package/dist/tools/pages/handlers-write.d.ts

@@ -17,7 +17,17 @@ interface SavePublishInput {
     template_id: string;
     etag?: string;
 }
-export declare function handlePageSave(client: RestClient, { template_id, etag }: SavePublishInput, extra?: HandlerExtra): Promise<ToolResult>;
+interface SaveInput extends SavePublishInput {
+    /**
+     * F85 (2026-06-10): optional whole-layout atomic write. When supplied,
+     * the REST layer replaces the template tree (Layer-1 structural +
+     * Layer-2 element-type whitelist validated, under the same ETag lock)
+     * instead of only re-running save-transforms. Lets a wholesale
+     * dynamization land in one call rather than element-by-element surgery.
+     */
+    layout?: Record<string, unknown>;
+}
+export declare function handlePageSave(client: RestClient, { template_id, etag, layout }: SaveInput, extra?: HandlerExtra): Promise<ToolResult>;
 export declare function handlePagePublish(client: RestClient, { template_id, etag }: SavePublishInput, extra?: HandlerExtra): Promise<ToolResult>;
 /**
  * Input shape for the `pages_create` handler. Mirrors the Zod schema
@@ -31,7 +41,35 @@ interface PagesCreateInput {
     readonly status?: 'publish' | 'draft' | 'pending' | 'private' | 'future';
     readonly layout?: Record<string, unknown>;
     readonly dry_run?: boolean;
+    /**
+     * F12 (2026-06-09): one-boolean publish shortcut. Maps to `status`
+     * before the REST call (the host has no `published` field). See
+     * {@link resolveCreateStatus}.
+     */
+    readonly published?: boolean;
+    /**
+     * F64 (2026-06-10): Joomla-only — create a SEF menu-item route for
+     * the new article (true = hidden default menutype, string = explicit
+     * menutype). Passed through to the REST body verbatim.
+     */
+    readonly menu_item?: boolean | string;
 }
+/**
+ * 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 declare function resolveCreateStatus(status: PagesCreateInput['status'], published: boolean | undefined): PagesCreateInput['status'] | undefined;
 /**
  * `pages_create` — POST `/pages` with the provided body. On
  * `dry_run:true`, the REST handler runs validation Layers 1+2+4
@@ -40,6 +78,62 @@ interface PagesCreateInput {
  * `PAGES_CREATE_OUTPUT_SCHEMA`.
  */
 export declare function handlePagesCreate(client: RestClient, input: PagesCreateInput, extra?: HandlerExtra): Promise<ToolResult>;
+/**
+ * A single `leaf_map` value — string OR the F96 `{name, filters?}` shape.
+ * The handler forwards the whole `leaf_map` verbatim; the PHP
+ * LayoutDynamizer normalises + applies it.
+ */
+type DynamizeFieldMapping = string | {
+    name: string;
+    filters?: Record<string, unknown>;
+};
+/**
+ * Input shape for the `page_dynamize` handler. Mirrors the Zod
+ * `PAGE_DYNAMIZE_INPUT` in `./schemas.ts` — kept as a structural interface
+ * so the handler has no runtime Zod dependency and forwards whatever the
+ * MCP harness already validated.
+ */
+interface PageDynamizeInput {
+    readonly template_id: string;
+    readonly section_name?: string;
+    readonly element_path?: string;
+    readonly list_source_name?: string;
+    readonly source_map?: ReadonlyArray<{
+        readonly match: string;
+        readonly source_name: string;
+        readonly leaf_map?: Record<string, DynamizeFieldMapping>;
+    }>;
+    readonly leaf_map?: Record<string, DynamizeFieldMapping>;
+    readonly conditions?: Record<string, {
+        name: string;
+        filters: {
+            condition: '!' | '!!';
+        };
+    }>;
+    readonly remove_leaves?: readonly string[];
+    readonly page: {
+        readonly title: string;
+        readonly slug?: string;
+        readonly published?: boolean;
+        readonly status?: string;
+        readonly menu_item?: boolean | string;
+    };
+    readonly etag?: string;
+}
+/**
+ * `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 declare function handlePageDynamize(client: RestClient, input: PageDynamizeInput, extra?: HandlerExtra): Promise<ToolResult>;
 /**
  * Input shape for the `pages_delete` handler. Mirrors the Zod schema
  * `PAGES_DELETE_INPUT` in `./schemas.ts`. `confirm` is `true` literal —

package/dist/tools/pages/handlers-write.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers-write.d.ts","sourceRoot":"","sources":["../../../src/tools/pages/handlers-write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAKH,KAAK,YAAY,EACjB,KAAK,UAAU,EAClB,MAAM,oBAAoB,CAAC;AAE5B,UAAU,gBAAgB;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,wBAAsB,cAAc,CAChC,MAAM,EAAE,UAAU,EAClB,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,gBAAgB,EACvC,KAAK,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAoBrB;AAID,wBAAsB,iBAAiB,CACnC,MAAM,EAAE,UAAU,EAClB,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,gBAAgB,EACvC,KAAK,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAoBrB;AAID;;;;;GAKG;AACH,UAAU,gBAAgB;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACnC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,gBAAgB,EACvB,KAAK,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAuBrB;AAID;;;;;GAKG;AACH,UAAU,gBAAgB;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACnC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,gBAAgB,EACvB,KAAK,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAuCrB"}
+{"version":3,"file":"handlers-write.d.ts","sourceRoot":"","sources":["../../../src/tools/pages/handlers-write.ts"],"names":[],"mappings":"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"}

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

@@ -15,12 +15,14 @@ import { encodeTemplateId } from '../../client.js';
 import { PHASE_CONFIRM, PHASE_SEND, PHASE_SERVER } from '../progress-phases.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/${encodeTemplateId(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);
     }
@@ -29,11 +31,38 @@ 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);
@@ -41,7 +70,7 @@ export async function handlePagePublish(client, { template_id, etag }, extra) {
     try {
         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({
@@ -52,6 +81,28 @@ 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
@@ -63,8 +114,17 @@ 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: input });
+        const data = await client.post('/pages', { body });
         await progress?.report(2, 3, PHASE_CONFIRM);
         return jsonResult(data);
     }
@@ -77,9 +137,78 @@ export async function handlePagesCreate(client, input, extra) {
                 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 other ' +
-                'than "page" (403). For dry-run: re-submit without dry_run:true to ' +
-                'actually create.',
+                '(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.',
         });
     }
 }

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":"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"}
+{"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

@@ -10,21 +10,28 @@ import { z } from 'zod';
 export declare const PAGES_LIST_OUTPUT_SCHEMA: z.ZodObject<{
     items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     total: z.ZodNumber;
+    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>>;
     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<{
-        rel_path: z.ZodString;
+        rel_path: z.ZodOptional<z.ZodString>;
         path: z.ZodOptional<z.ZodString>;
-        element_type: z.ZodString;
-        label: z.ZodString;
-        has_binding: z.ZodBoolean;
-    }, z.core.$strip>>;
+        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>>;
+    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 ETAG_OUTPUT_SCHEMA: z.ZodObject<{
     etag: z.ZodString;
@@ -66,6 +73,8 @@ export declare const PAGES_CREATE_INPUT: {
         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>;
 };
@@ -91,6 +100,7 @@ export declare const PAGES_CREATE_OUTPUT_SCHEMA: z.ZodObject<{
     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>;
@@ -140,6 +150,56 @@ export declare const PAGES_DELETE_INPUT: {
     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.
  *
@@ -154,4 +214,13 @@ export declare const PAGES_DELETE_OUTPUT_SCHEMA: z.ZodObject<{
     force_deleted: z.ZodBoolean;
     etag: z.ZodString;
 }, z.core.$strip>;
+export declare const PAGES_RESOLVE_INPUT: {
+    readonly url: z.ZodString;
+};
+export declare const PAGES_RESOLVE_OUTPUT_SCHEMA: z.ZodObject<{
+    template_id: z.ZodString;
+    post_id: z.ZodNumber;
+    type: z.ZodString;
+    frontend_url: z.ZodNullable<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;AAWH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;CA6B9B,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;iBAqBlC,CAAC;AAEN;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;iBAe7C,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB;;;;CAiB9B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;;;;;;iBAYlC,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;;;;;;;;;;iBA6CnC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;iBA8B/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;AAIN,eAAO,MAAM,mBAAmB;;CAStB,CAAC;AAEX,eAAO,MAAM,2BAA2B;;;;;iBAUtC,CAAC"}