@wootsup/yt-builder-mcp 1.1.7 → 1.3.0

package/dist/tools/pages/schemas.js

@@ -26,6 +26,12 @@ export const PAGES_LIST_OUTPUT_SCHEMA = z.object({
     // this template.") so the agent can render an instruction to the
     // end-user. All three keys are kept on the row-record (not an extra
     // schema object) so per-item sparse-field projection works.
+    //
+    // F33 (2026-06-10): each row also carries `builder_url` — a version-
+    // aware (WP YT4/YT5) + platform-aware (Joomla com_ajax) "open in the
+    // YOOtheme Pro builder" deep-link (or null when the host could not
+    // resolve the admin base). Kept on the row-record so per-item sparse-
+    // field projection + available_fields discovery surface it.
     items: z.array(z.record(z.string(), z.unknown())),
     total: z.number(),
     etag: z.string().optional(),
@@ -37,6 +43,10 @@ export const PAGES_LIST_OUTPUT_SCHEMA = z.object({
     // (previously: items came back as `[{}, {}, …]` silently).
     available_fields: z.array(z.string()).optional(),
     unknown_fields: z.array(z.string()).optional(),
+    // F23 (2026-06-10): the LOUD unknown-projection warning also rides in
+    // structuredContent — hosts that surface structuredContent (not the
+    // text leg) to the model would otherwise never see it.
+    projection_warning: z.string().optional(),
 });
 export const SCHEMA_OUTPUT_SCHEMA = z.object({
     // F-006 (2026-05-26): `rel_path` is the agent-preferred path form
@@ -79,4 +89,341 @@ export const TEMPLATE_SUMMARY_OUTPUT_SCHEMA = z.object({
     })),
     etag: z.string(),
 });
+// ─── C1 — pages_create + pages_delete (v1.2) ──────────────────────────
+//
+// MCP tool schemas wrapping the Phase B REST endpoints:
+//   POST   /pages           → yootheme_builder_pages_create
+//   DELETE /pages/{post_id} → yootheme_builder_pages_delete
+//
+// These schemas drive (a) input validation at the MCP boundary and (b)
+// the structured-content outputSchema for client introspection.
+/**
+ * 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 const PAGES_CREATE_INPUT = {
+    title: z
+        .string()
+        .min(1)
+        .describe('Page title (required, byte-equal stored in post_title).'),
+    slug: z
+        .string()
+        .optional()
+        .describe('Optional explicit slug; defaults to sanitize_title($title).'),
+    status: z
+        .enum(['publish', 'draft', 'pending', 'private', 'future'])
+        .optional()
+        .describe('Initial post status. Default: draft (Q6 design — no public empty page). ' +
+        'WordPress accepts all five; Joomla maps draft→state 0 / publish→state 1 ' +
+        '(the other three are WP-only). For the common make-it-live case prefer ' +
+        'the `published` boolean below.'),
+    // F12 (2026-06-09): friendly one-boolean publish shortcut. A fresh
+    // draft on Joomla returns 404 to anonymous front-end visitors (state
+    // 0); there was no ergonomic MCP path to flip it live. `published`
+    // maps to the existing `status` field the PHP host already honours
+    // (WP post_status=publish, Joomla state=1) — see the handler. Default
+    // false keeps the safe "no public empty page" behaviour. When the
+    // caller sets an explicit `status`, that wins (published is the
+    // shortcut, not an override).
+    published: z
+        .boolean()
+        .default(false)
+        .describe('When true, the page/article is created LIVE (WP post_status=publish, ' +
+        'Joomla state=1) so anonymous visitors can render it immediately. ' +
+        'Default false: created as a draft, visible only in the builder until ' +
+        'you publish. Ignored when an explicit `status` is provided.'),
+    // F64 (2026-06-10): Joomla-only routing helper. A published Joomla
+    // article without a menu item has NO SEF route (anonymous 404). When
+    // truthy AND the article is published, the host creates a
+    // com_content single-article menu item via the Joomla Menu-Table API
+    // under a dedicated HIDDEN menutype (string value picks the
+    // menutype; `mainmenu` is rejected server-side so customer
+    // navigation is never polluted). Ignored on WordPress.
+    menu_item: z
+        .union([z.boolean(), z.string().min(1).max(64)])
+        .optional()
+        .describe('Joomla only: create a SEF route for the new article. true = ' +
+        'hidden default menutype; a string picks the menutype ' +
+        '("mainmenu" is rejected). Requires published/status=publish. ' +
+        'Without a route a published Joomla article 404s for visitors.'),
+    layout: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe('Optional initial YT layout. Default: {type:"layout",children:[]}.'),
+    dry_run: z
+        .boolean()
+        .optional()
+        .describe('When true, runs validation Layers 1+2+4 without persisting.'),
+    // post_type intentionally NOT exposed — Layer 9 defensive guard rejects
+    // it server-side. Exposing it would invite footgun attempts.
+};
+/**
+ * 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 const PAGES_CREATE_OUTPUT_SCHEMA = z
+    .object({
+    // E1 cross-platform divergence: WP returns `page_id`, Joomla returns
+    // `article_id`. Both are positive ints; at least one is always present.
+    page_id: z.number().int().positive().optional(),
+    article_id: z.number().int().positive().optional(),
+    title: z.string(),
+    slug: z.string(),
+    status: z.string(),
+    frontend_url: z.string().nullable(),
+    // F33 (2026-06-10): "open in the YOOtheme Pro builder" deep-link for
+    // the freshly-created page/article. Version-aware (WP YT4/YT5) +
+    // platform-aware (Joomla com_ajax). Nullable: null when the host
+    // could not resolve the admin base. `.optional()` keeps the schema
+    // back-compatible with an older host that predates the field.
+    builder_url: z.string().nullable().optional(),
+    template_id: z
+        .string()
+        .describe('Synthetic per-page template id, e.g. "page:3275" (WP) or "article:42" (Joomla).'),
+    etag: z.string(),
+    warnings: z
+        .array(z.string())
+        .describe('e.g. "slug_collision_resolved" when slug collision was resolved.'),
+})
+    .refine((v) => typeof v.page_id === 'number' || typeof v.article_id === 'number', { message: 'response must contain either page_id (WP) or article_id (Joomla)' });
+/**
+ * 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 const PAGES_CREATE_DRY_RUN_OUTPUT_SCHEMA = z.object({
+    dry_run: z.literal(true),
+    would_create: z.object({
+        title: z.string(),
+        slug: z.string(),
+        status: z.string(),
+        // E1 cross-platform divergence: WP returns 'page:{post_id}', Joomla returns 'article:{article_id}'.
+        template_id_pattern: z.enum(['page:{post_id}', 'article:{article_id}']),
+    }),
+    validation_report: z.object({
+        layer_1_structural: z.literal('passed'),
+        layer_2_element_types: z.literal('passed'),
+        layer_4_renderer: z.literal('passed'),
+    }),
+    // No `etag` field — by design (see B6 fix-cycle: stale-If-Match footgun).
+});
+/**
+ * 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 const PAGES_DELETE_INPUT = {
+    post_id: z
+        .number()
+        .int()
+        .positive()
+        .describe('ID of the page/article to delete — WordPress post_id or Joomla article_id ' +
+        '(the numeric part of the template_id, e.g. 42 for "article:42").'),
+    confirm: z
+        .literal(true)
+        .describe('Must be true. Confirm gate prevents accidental deletes.'),
+    force: z
+        .boolean()
+        .optional()
+        .describe('If true, hard-deletes (wp_delete_post force=true). Default: trash (recoverable).'),
+};
+// ─── P-G (Goldstandard wave 3) — page_dynamize ────────────────────────
+//
+// The composite "dynamize an existing designed layout" write. The recipe
+// of `dynamize-existing-layout.md` encoded server-side — the agent supplies
+// ONLY the language-level inputs (which list source, which leaf maps to
+// which flow field). F98 HYBRID EXECUTION: server runs the deterministic
+// steps (copy byte-identically, swap queries + leaf names, keep everything
+// else), reaching 85-95% compliance vs 60-70% for instruction-only.
+/**
+ * A single `leaf_map` / `conditions` value — the F96 FieldMappingValue
+ * shape reused verbatim (mirrors `field_mappings` in `sources/builders.ts`):
+ * EITHER a plain string (the new flat field name) OR a structured
+ * `{name, filters?}` carrying an explicit YT5 filters operator (e.g. a
+ * `_condition` `{condition:'!!'}` or a date format `{date:'D, d.m.y'}`).
+ */
+const FIELD_MAPPING_VALUE = z.union([
+    z.string(),
+    z
+        .object({
+        name: z.string().min(1).describe('Source-field name (e.g. "home_crest").'),
+        filters: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe('YT5 filters operator object. Examples: {condition:"!!"} ' +
+            '(render only when non-empty), {condition:"!"} (only when empty), ' +
+            '{date:"D, d.m.y"} (format an ISO date).'),
+    })
+        .strict(),
+]);
+/**
+ * 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 const PAGE_DYNAMIZE_INPUT = {
+    template_id: z
+        .string()
+        .min(1)
+        .describe('Template holding the REFERENCE section (e.g. "default"). ' +
+        'Use yootheme_builder_pages_list / yootheme_builder_template_summary to discover.'),
+    section_name: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Named landmark section to copy (as listed in ' +
+        'yootheme_builder_template_summary.named_sections). Provide THIS or ' +
+        '`element_path` — exactly one. On a miss the error lists the available sections.'),
+    element_path: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('JSON-Pointer / rel-path to the reference subtree (e.g. "/children/2"). ' +
+        'Provide THIS or `section_name` — exactly one.'),
+    list_source_name: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('SINGLE-block path: the published flow LIST source the one iterating column ' +
+        'query is rewritten to (e.g. "apiMapperFlowAbcList"). Provide THIS or ' +
+        '`source_map` — exactly one. Use yootheme_builder_sources_list to discover.'),
+    // F201 (multi-block): a section with SEVERAL source blocks (Played / Next /
+    // Later) dynamizes in ONE call. Each entry keys the EXISTING iterating
+    // column query (`match`) to its flow list source (`source_name`) + its own
+    // leaf_map. Provide THIS or `list_source_name` — exactly one.
+    source_map: z
+        .array(z
+        .object({
+        match: z
+            .string()
+            .min(1)
+            .describe('The EXISTING iterating column query name to swap (e.g. "theme.played").'),
+        source_name: z
+            .string()
+            .min(1)
+            .describe('The flow LIST source this block is rewritten to (e.g. "apiMapperFlowPlayedList").'),
+        leaf_map: z
+            .record(z.string(), FIELD_MAPPING_VALUE)
+            .optional()
+            .describe('Per-block leaf remap — same shape + rules as the single-block `leaf_map`.'),
+    })
+        .strict())
+        .optional()
+        .describe('MULTI-block path: a section with several source blocks (Played / Next / Later) ' +
+        'dynamizes in ONE call. Array of {match, source_name, leaf_map?}. Unmatched ' +
+        'blocks stay verbatim and surface in summary.unmatched_sources.'),
+    leaf_map: z
+        .record(z.string(), FIELD_MAPPING_VALUE)
+        .optional()
+        .describe('Maps ORIGINAL leaf field-names (the source.props.*.name values in the ' +
+        'copied subtree, INCLUDING nested originals like ' +
+        '"field.match.home_team.crest.imagefile") → your flow\'s flat field names. ' +
+        'Each value is a plain string OR {name, filters?} (F96 shape). The #parent ' +
+        'query form is preserved — only the leaf NAME changes. Unmapped leaves are ' +
+        'KEPT verbatim (default-KEEP). For a SUB-QUERY panel (its own source.query, ' +
+        'leaves bound RELATIVE), key by the QUALIFIED "<subquery>.<leaf>" form (e.g. ' +
+        '"field.match_home_team.name") so the panel converts to #parent. Map an IMAGE ' +
+        'leaf to an image/path field — binding a text field to an image prop renders a ' +
+        'broken 0x0 image.'),
+    conditions: z
+        .record(z.string(), z
+        .object({
+        name: z.string().min(1).describe('Source-field name driving the condition.'),
+        filters: z
+            .object({
+            condition: z
+                .enum(['!', '!!'])
+                .describe('"!!" = render only when the field is non-empty; "!" = only when empty.'),
+        })
+            .describe('YT5 _condition operator.'),
+    })
+        .strict())
+        .optional()
+        .describe('Optional per-prop `_condition` overrides, keyed by ELEMENT-PROP name ' +
+        '(e.g. "content"). Use for per-row visibility (played vs upcoming).'),
+    remove_leaves: z
+        .array(z.string().min(1))
+        .optional()
+        .describe('EXPLICIT prop-path removals (rel-path pointers, e.g. "/children/0/children/1"). ' +
+        'Default is KEEP — only remove a leaf whose TARGET cannot exist for the new ' +
+        'data (e.g. a detail-link whose article doesn\'t exist for API rows).'),
+    page: z
+        .object({
+        title: z.string().min(1).describe('New page title (required).'),
+        slug: z.string().min(1).optional().describe('Optional explicit slug.'),
+        published: z
+            .boolean()
+            .optional()
+            .describe('When true, the page is created LIVE (anonymous visitors can render it).'),
+        status: z
+            .enum(['publish', 'draft', 'pending', 'private', 'future'])
+            .optional()
+            .describe('Fine-grained WordPress status (wins over `published`).'),
+        menu_item: z
+            .union([z.boolean(), z.string().min(1).max(64)])
+            .optional()
+            .describe('Joomla only: create a SEF route. true = hidden menutype; a string picks it.'),
+    })
+        .describe('Passthrough to the existing create machinery (slug-collision, menu_item routing).'),
+    etag: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Optimistic-lock ETag from yootheme_builder_get_etag. Optional; when provided, ' +
+        '412 on conflict. Recommended for collaborative edits.'),
+};
+/**
+ * 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 const PAGES_DELETE_OUTPUT_SCHEMA = z
+    .object({
+    deleted: z.literal(true),
+    // E1 cross-platform divergence: WP returns page_id, Joomla returns article_id.
+    page_id: z.number().int().positive().optional(),
+    article_id: z.number().int().positive().optional(),
+    force_deleted: z.boolean(),
+    etag: z.string(),
+})
+    .refine((v) => typeof v.page_id === 'number' || typeof v.article_id === 'number', { message: 'response must contain either page_id (WP) or article_id (Joomla)' });
 //# sourceMappingURL=schemas.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/tools/pages/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,gEAAgE;IAChE,sEAAsE;IACtE,gEAAgE;IAChE,+DAA+D;IAC/D,wEAAwE;IACxE,sEAAsE;IACtE,yBAAyB;IACzB,kEAAkE;IAClE,uEAAuE;IACvE,4BAA4B;IAC5B,qEAAqE;IACrE,sEAAsE;IACtE,sDAAsD;IACtD,qEAAqE;IACrE,mEAAmE;IACnE,iEAAiE;IACjE,oEAAoE;IACpE,4DAA4D;IAC5D,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACjD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAChD,iEAAiE;IACjE,qEAAqE;IACrE,oEAAoE;IACpE,iEAAiE;IACjE,2DAA2D;IAC3D,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAChD,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,kEAAkE;IAClE,iEAAiE;IACjE,qEAAqE;IACrE,oEAAoE;IACpE,sDAAsD;IACtD,KAAK,EAAE,CAAC,CAAC,KAAK,CACV,CAAC,CAAC,MAAM,CAAC;QACL,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE;KAC3B,CAAC,CACL;IACD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAEH,qEAAqE;AACrE,kEAAkE;AAClE,oEAAoE;AACpE,sEAAsE;AACtE,wEAAwE;AACxE,qEAAqE;AACrE,qEAAqE;AACrE,uEAAuE;AACvE,yCAAyC;AACzC,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IACpE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACrC,cAAc,EAAE,CAAC,CAAC,KAAK,CACnB,CAAC,CAAC,MAAM,CAAC;QACL,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC,CACL;IACD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/tools/pages/schemas.ts"],"names":[],"mappings":"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"}

package/dist/tools/shared-schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared-schemas.d.ts","sourceRoot":"","sources":["../../src/tools/shared-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,WAAW,aAKnB,CAAC;AASN,eAAO,MAAM,YAAY,aAapB,CAAC;AAEN,eAAO,MAAM,IAAI,aAOZ,CAAC;AAEN,eAAO,MAAM,KAAK,wCAKb,CAAC;AAEN;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,4BAOtB,CAAC"}
+{"version":3,"file":"shared-schemas.d.ts","sourceRoot":"","sources":["../../src/tools/shared-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,WAAW,aAUnB,CAAC;AASN,eAAO,MAAM,YAAY,aAgBpB,CAAC;AAEN,eAAO,MAAM,IAAI,aAYZ,CAAC;AAEN,eAAO,MAAM,KAAK,wCAKb,CAAC;AAEN;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,4BAOtB,CAAC"}

package/dist/tools/shared-schemas.js

@@ -11,7 +11,13 @@ import { z } from 'zod';
 export const TEMPLATE_ID = z
     .string()
     .min(1)
-    .describe('Template ID (e.g. "default"). Use yootheme_builder_pages_list to discover.');
+    .describe(
+// F206 (P3): name the argument key explicitly and rule out the
+// look-alikes. The Desktop client guessed `page_id` / `id` for tools
+// that take this schema; the arg key is `template_id` (NOT `page_id`,
+// NOT `id`). Use yootheme_builder_pages_list to discover valid values.
+'Template ID (e.g. "default"). The argument key is `template_id` ' +
+    '(NOT `page_id`, NOT `id`). Use yootheme_builder_pages_list to discover.');
 // F-102 (2026-05-26): the input-arg name is **`element_path`** (NOT
 // `element_rel_path`). `rel_path` is a PROJECTION COLUMN name on the
 // output of `element_list` / `page_get_schema` — copy its VALUE back
@@ -22,21 +28,30 @@ export const TEMPLATE_ID = z
 export const ELEMENT_PATH = z
     .string()
     .min(1)
-    .describe('JSON-Pointer to an element. Field name is `element_path` (NOT ' +
-    '`element_rel_path` — that is the projection column name on ' +
-    '`element_list` / `page_get_schema` output, not an input arg). ' +
-    '**`rel_path` VALUE from `element_list` is the preferred form** ' +
-    '— copy it straight back here as `element_path` (e.g. `/children/0` ' +
-    'or `/children/0/children/1`); the server resolves it within this ' +
-    'template. Fully-qualified pointers (`/templates/<id>/layout/' +
-    'children/0/...`) are also accepted. Both forms work everywhere ' +
-    '`element_path` appears.');
+    .describe(
+// Wave-16 #34 (6.3): lead with the standard JSON-Pointer (RFC-6901)
+// docstring so every element_path param across all tools opens with
+// the canonical form + the enumerate-paths pointer. F165 (2026-06-11)
+// tightened the trailing essay; the F-102 disambiguation
+// (element_path is the INPUT arg, element_rel_path is only the
+// element_list projection COLUMN) stays load-bearing.
+'JSON-Pointer (RFC-6901) style: /0/children/1. ' +
+    'Use yootheme_builder_element_list to enumerate valid paths. ' +
+    'Preferred: copy a `rel_path` VALUE from element_list (e.g. ' +
+    '`/children/0`); fully-qualified pointers also work. The arg is ' +
+    '`element_path`; `element_rel_path` is only the list projection ' +
+    'column, not an input arg.');
 export const ETAG = z
     .string()
     .min(1)
     .describe('Optimistic-lock ETag from yootheme_builder_get_etag. Required to ' +
     'detect concurrent edits — call get_etag first, pass the value here. ' +
-    'On 412 Precondition Failed, re-fetch the ETag and retry.');
+    'On 412 Precondition Failed, re-fetch the ETag and retry. ' +
+    'Note (Wave-8 C2 2026-05-29): every successful write returns a NEW ' +
+    'ETag in the response body — use that next-ETag for the following ' +
+    'call, do NOT reuse the same value across multiple writes (the server ' +
+    'bumps a monotonic revision per persist, so byte-identical state ' +
+    'still surfaces as a distinct ETag).');
 export const PROPS = z
     .record(z.string(), z.unknown())
     .describe('Element props object (e.g. `{title: "Hello", margin: "default"}`). ' +

package/dist/tools/shared-schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared-schemas.js","sourceRoot":"","sources":["../../src/tools/shared-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACvB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CACL,4EAA4E,CAC/E,CAAC;AAEN,oEAAoE;AACpE,qEAAqE;AACrE,qEAAqE;AACrE,+DAA+D;AAC/D,kEAAkE;AAClE,mEAAmE;AACnE,qBAAqB;AACrB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KACxB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CACL,gEAAgE;IAC5D,6DAA6D;IAC7D,gEAAgE;IAChE,iEAAiE;IACjE,qEAAqE;IACrE,mEAAmE;IACnE,8DAA8D;IAC9D,iEAAiE;IACjE,yBAAyB,CAChC,CAAC;AAEN,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC;KAChB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CACL,mEAAmE;IAC/D,sEAAsE;IACtE,0DAA0D,CACjE,CAAC;AAEN,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC;KACjB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;KAC/B,QAAQ,CACL,qEAAqE;IACjE,0EAA0E,CACjF,CAAC;AAEN;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE;KACnC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;KACd,KAAK,CAAC,kBAAkB,EAAE,kDAAkD,CAAC;KAC7E,QAAQ,EAAE;KACV,QAAQ,CACL,+DAA+D;IAC/D,4DAA4D,CAC/D,CAAC"}
+{"version":3,"file":"shared-schemas.js","sourceRoot":"","sources":["../../src/tools/shared-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACvB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ;AACL,+DAA+D;AAC/D,qEAAqE;AACrE,sEAAsE;AACtE,uEAAuE;AACvE,kEAAkE;IAC9D,yEAAyE,CAChF,CAAC;AAEN,oEAAoE;AACpE,qEAAqE;AACrE,qEAAqE;AACrE,+DAA+D;AAC/D,kEAAkE;AAClE,mEAAmE;AACnE,qBAAqB;AACrB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KACxB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ;AACL,oEAAoE;AACpE,oEAAoE;AACpE,sEAAsE;AACtE,yDAAyD;AACzD,+DAA+D;AAC/D,sDAAsD;AACtD,gDAAgD;IAC5C,8DAA8D;IAC9D,6DAA6D;IAC7D,iEAAiE;IACjE,iEAAiE;IACjE,2BAA2B,CAClC,CAAC;AAEN,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC;KAChB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CACL,mEAAmE;IAC/D,sEAAsE;IACtE,2DAA2D;IAC3D,oEAAoE;IACpE,mEAAmE;IACnE,uEAAuE;IACvE,kEAAkE;IAClE,qCAAqC,CAC5C,CAAC;AAEN,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC;KACjB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;KAC/B,QAAQ,CACL,qEAAqE;IACjE,0EAA0E,CACjF,CAAC;AAEN;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE;KACnC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;KACd,KAAK,CAAC,kBAAkB,EAAE,kDAAkD,CAAC;KAC7E,QAAQ,EAAE;KACV,QAAQ,CACL,+DAA+D;IAC/D,4DAA4D,CAC/D,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/sources/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAI7D,OAAO,EAMH,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGH,KAAK,kBAAkB,EAK1B,MAAM,eAAe,CAAC;AAEvB,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,SAAS,iBAAiB,EAAE,CAiI9B"}
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/sources/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAI7D,OAAO,EAMH,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGH,KAAK,kBAAkB,EAK1B,MAAM,eAAe,CAAC;AAEvB,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,SAAS,iBAAiB,EAAE,CA+L9B"}

package/dist/tools/sources/builders.js

@@ -26,7 +26,7 @@ export function buildSourcesTools(pool, deps) {
             description: 'List all data sources, feeds, and dynamic content sources available in the ' +
                 'YOOtheme Pro builder. Returns name + label + origin (apimapper / wordpress / ' +
                 'joomla / essentials) per source. CALL THIS BEFORE binding any element to a data source. ' +
-                'Pick a source name from the list and pass it to `element_bind_source`. ' +
+                'Then bind directly with yootheme_builder_element_bind_source (a first-class tool in tools/list). ' +
                 'Keywords: list sources, list data sources, list feeds, list bindings, ' +
                 'dynamic content, available data, what sources exist. ' +
                 'Pass `fields[]` to narrow each row. Operates on the default site unless site_id is provided.',
@@ -55,9 +55,22 @@ export function buildSourcesTools(pool, deps) {
         }),
         defineTool({
             name: 'yootheme_builder_element_bind_source',
-            description: 'Binds a Builder source to an element (sets `props.source`). Use bindingLevel ' +
-                '"item" on Multi-Items containers (grid/slideshow/switcher/…) to bind on the ' +
-                'first *_item child instead of the container itself. Requires ETag. ' +
+            description: 'Binds a Builder source to an element (canonical shape: `source` top-level). ' +
+                'Pass `field_mappings` in the SAME call; bindingLevel "item" binds a ' +
+                'container\'s first *_item child. ' +
+                // F71/C3 (2026-06-10) + F188/F189 (2026-06-12): a leaf DIRECTLY
+                // under an iterating *_item auto-CONSOLIDATES onto the item's own
+                // slots (409 slot_collision when the slot is taken / not a slot);
+                // a leaf under a `#parent` fragment keeps the INHERIT form; a
+                // standalone query renders empty on YT5. A `…List` on a grid_item
+                // with nested children is render-dead (iterator_is_leaf_renderer).
+                'Leaf under an iterating *_item → CONSOLIDATE onto item slots (409 ' +
+                'slot_collision if taken/not a slot); leaf under a #parent fragment → INHERIT ' +
+                '(`__node_item__`); standalone renders empty. List on a grid_item with ' +
+                'children → iterator_is_leaf_renderer. ' +
+                // F39 (2026-06-10): map_item location contract.
+                'Map: bind `map_item`, map `location` to a "lat,lng" field or no markers. ' +
+                'Requires ETag. Call directly. ' +
                 'Operates on the default site unless site_id is provided.',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
@@ -74,9 +87,54 @@ export function buildSourcesTools(pool, deps) {
                     .describe('Optional explicit "<origin>:<name>" id; skips ambiguity ' +
                     'resolution when ≥2 sources share `source_name`.'),
                 field_mappings: z
-                    .record(z.string(), z.string())
+                    .record(z.string(), 
+                // F96/F82 (2026-06-10): a value may be EITHER a plain
+                // string source-field name OR a structured object
+                // `{name, filters?}`. The object form carries an
+                // explicit YT5 filters operator so the theme-canonical
+                // leaf (e.g. a `_condition` prop with
+                // `{condition: '!!'}`, or a date-format
+                // `{date: 'D, d.m.y'}`) is authorable in ONE bind call.
+                z.union([
+                    z.string(),
+                    z
+                        .object({
+                        name: z
+                            .string()
+                            .min(1)
+                            .describe('Source-field name (e.g. "match_date").'),
+                        filters: z
+                            .record(z.string(), z.unknown())
+                            .optional()
+                            .describe('YT5 filters operator object. Examples: ' +
+                            '{condition:"!!"} (render only when the field is ' +
+                            'non-empty — used on a `_condition` prop), ' +
+                            '{condition:"!"} (only when empty), ' +
+                            '{date:"D, d.m.y"} (format an ISO date).'),
+                    })
+                        .strict(),
+                ]))
                     .optional()
-                    .describe('Optional {prop_name: source_field_name} map written to `source.props`. ' +
+                    .describe('Optional {prop_name: mapping} written to `source.props`. Each mapping ' +
+                    'is EITHER a plain source-field name string, OR an object ' +
+                    '{name, filters?} where `filters` is a YT5 operator object. ' +
+                    // F96/F82 (2026-06-10): the object form unlocks the theme-canonical
+                    // leaf. A `_condition` prop needs `filters:{condition:"!!"}` (render
+                    // only when filled) / `{condition:"!"}` (only when empty) — a bare
+                    // `_condition` with no filters operator is INERT (renders always).
+                    'Use the object form for the theme-canonical YT5 leaf: a `_condition` ' +
+                    'prop REQUIRES filters {condition:"!!"} (render only when the field is ' +
+                    'non-empty) or {condition:"!"} (only when empty) — a bare _condition ' +
+                    'with no filters operator renders ALWAYS. Date-format leaves use ' +
+                    '{name:"<field>", filters:{date:"D, d.m.y"}}. ' +
+                    // F43 (2026-06-10): this is a FULL REPLACE, not a merge — each
+                    // bind call rebuilds props from ONLY these mappings; anything
+                    // omitted is dropped. Re-send ALL mappings you want to keep on
+                    // every call (do not pass a partial patch to refine one field).
+                    'FULL REPLACE (not a merge): each call rebuilds `source.props` from ' +
+                    'only these mappings — omitted props are dropped (dropped keys are ' +
+                    'surfaced as `dropped_field_mappings` + a warning), so re-send ALL ' +
+                    'mappings you want to keep every call. ' +
                     'Pass "__node_item__" (or "__node_item__:<field>") as the value to ' +
                     'emit YT-Pro INHERIT bindings ("Node - Item (Source/Items)" picker ' +
                     'entry) on child *_item elements.'),

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

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

package/dist/tools/sources/handlers-bind.d.ts

@@ -10,6 +10,18 @@
  */
 import { type ToolResult } from '../tool-builder.js';
 import type { SourcesHandlerDeps } from './handlers.js';
+/**
+ * A single `field_mappings` value. F96/F82 (2026-06-10): EITHER a plain
+ * source-field name string, OR a structured `{name, filters?}` object that
+ * carries an explicit YT5 filters operator (e.g. `{condition: '!!'}` on a
+ * `_condition` prop, or `{date: 'D, d.m.y'}` for a date format). Mirrors the
+ * `field_mappings` union in `./builders.ts`. The handler forwards the value
+ * verbatim — the PHP SourcesController normalises + persists it.
+ */
+export type FieldMappingValue = string | {
+    name: string;
+    filters?: Record<string, unknown>;
+};
 export declare function handleElementBindSource({ client, elicitation }: SourcesHandlerDeps, input: {
     template_id: string;
     element_path: string;
@@ -17,7 +29,7 @@ export declare function handleElementBindSource({ client, elicitation }: Sources
     source_id?: string;
     etag: string;
     bindingLevel?: 'auto' | 'container' | 'item';
-    field_mappings?: Record<string, string>;
+    field_mappings?: Record<string, FieldMappingValue>;
 }): Promise<ToolResult>;
 export declare function handleElementUnbindSource({ client, elicitation }: SourcesHandlerDeps, input: {
     template_id: string;

package/dist/tools/sources/handlers-bind.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers-bind.d.ts","sourceRoot":"","sources":["../../../src/tools/sources/handlers-bind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,OAAO,EAIH,KAAK,UAAU,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAwBxD,wBAAsB,uBAAuB,CACzC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,kBAAkB,EAC3C,KAAK,EAAE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C,GACF,OAAO,CAAC,UAAU,CAAC,CA6ErB;AAID,wBAAsB,yBAAyB,CAC3C,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,kBAAkB,EAC3C,KAAK,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACtF,OAAO,CAAC,UAAU,CAAC,CAoCrB"}
+{"version":3,"file":"handlers-bind.d.ts","sourceRoot":"","sources":["../../../src/tools/sources/handlers-bind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,OAAO,EAIH,KAAK,UAAU,EAClB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAyMxD;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GACvB,MAAM,GACN;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAE1D,wBAAsB,uBAAuB,CACzC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,kBAAkB,EAC3C,KAAK,EAAE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACtD,GACF,OAAO,CAAC,UAAU,CAAC,CAgIrB;AAID,wBAAsB,yBAAyB,CAC3C,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,kBAAkB,EAC3C,KAAK,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACtF,OAAO,CAAC,UAAU,CAAC,CAoCrB"}