@wootsup/yt-builder-mcp 1.11.0 → 2.0.0

package/dist/tools/elements/builders.js

@@ -1,48 +1,23 @@
-/**
- * Element-tool builders — pure `defineTool` factory list.
- *
- * Split out of the original `src/tools/elements.ts` (Wave G.4.0). Each
- * entry pairs a Zod input-schema with the matching handler in
- * `./handlers.ts`. Keeping builders + handlers in separate files lets
- * each file stay under the 200-LoC budget.
- *
- * The exported `buildElementsTools(client, [opts])` is the single public
- * entry-point — see `./index.ts` for the consumer-facing re-export.
- *
- * @license MIT
- */
 import { z } from 'zod';
-import { withSiteRetry, withWriteSiteRetry } from '../pool-resolve-helper.js';
-import { ELEMENT_PATH, ETAG, PROPS, SITE_ID_SCHEMA, TEMPLATE_ID } from '../shared-schemas.js';
+import { ELEMENT_PATH, ETAG, ETAG_PREVIEW_OPTIONAL, INCLUDE_META_SCHEMA, PROPS, SITE_ID_SCHEMA, LAYOUT_ID } from '../shared-schemas.js';
 import { FIELDS, MAX_CHARS } from '../sparse-fields.js';
-import { creating, defineTool, destructive, mutating, readOnly, withSiteMeta, } from '../tool-builder.js';
-import { ELEMENT_GET_OUTPUT_SCHEMA, ELEMENT_LIST_OUTPUT_SCHEMA, LAYOUT_QUERY_OUTPUT_SCHEMA, handleElementAdd, handleElementClone, handleElementDelete, handleElementGet, handleElementList, handleElementMove, handleElementUpdateSettings, handleLayoutQuery, handleScaffoldSection, } from './handlers.js';
-/**
- * Build the 7 element tools. The optional `deps` carries the
- * elicitation capability used by `element_delete` (Wave G.4.1). When
- * omitted, the destructive tool falls back to the explicit
- * `confirm: true` parameter.
- */
-export function buildElementsTools(pool, deps) {
-    // W6.3 — each handler resolves the pool inline (per `site_id`) so
-    // the per-handler `siteClient` reaches the right CMS install. The
-    // elicitation capability is the only non-client dep we propagate.
-    const elicitation = deps?.elicitation;
-    const makeDeps = (siteClient) => (elicitation !== undefined
-        ? { client: siteClient, elicitation }
-        : { client: siteClient });
+import { HOST_PROMPT_PROMISE } from '../tool-builder/confirm-preview.js';
+import { creating, defineTool, destructive, mutating, readOnly, } from '../tool-builder.js';
+import { ELEMENT_GET_OUTPUT_SCHEMA, ELEMENT_LIST_OUTPUT_SCHEMA, LAYOUT_QUERY_OUTPUT_SCHEMA, MAX_PATHS_CAP, } from './read-output-schemas.js';
+import { ELEMENT_ADD_OUTPUT_SCHEMA, ELEMENT_CLONE_OUTPUT_SCHEMA, ELEMENT_DELETE_OUTPUT_SCHEMA, ELEMENT_MOVE_OUTPUT_SCHEMA, ELEMENT_SET_STATUS_OUTPUT_SCHEMA, ELEMENT_UPDATE_SETTINGS_OUTPUT_SCHEMA, SCAFFOLD_SECTION_OUTPUT_SCHEMA, } from './write-output-schemas.js';
+export function buildElementsTools() {
     return [
         defineTool({
             name: 'yootheme_builder_element_list',
             description: 'List elements in a template as a flat array with JSON-Pointer paths + types + ' +
-                '`label` (the builder-assigned name; "" when unset — not that the type lacks one). ' +
-                'Scope with `root_path`/`depth` for a subtree, paginate with `limit`/`cursor` for ' +
-                'large templates. `fields[]` narrows each row; `max_chars` bounds the text output. ' +
-                'template_id only — resolve a URL/post first via pages_resolve. ' +
-                'Operates on the default site unless site_id is provided.',
+                '`label`. Scope with `root_path`/`depth`, paginate with `limit`/`cursor`. ' +
+                'Rows carry BOTH addresses: `path` (absolute) and `rel_path` — `rel_path` is the ' +
+                'one write calls take as `element_path`. ' +
+                'To find WHERE a module/widget is used, call local_content_read (gateway-only), ' +
+                'never loop this per page.',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
-                template_id: TEMPLATE_ID,
+                layout_id: LAYOUT_ID,
                 fields: FIELDS,
                 max_chars: MAX_CHARS,
                 root_path: z
@@ -67,54 +42,95 @@ export function buildElementsTools(pool, deps) {
                     .string()
                     .optional()
                     .describe('Continuation token from a prior call\'s `next_cursor`.'),
+                include_meta: INCLUDE_META_SCHEMA,
             },
             outputSchema: ELEMENT_LIST_OUTPUT_SCHEMA,
             annotations: readOnly('List Elements'),
-            handler: async ({ site_id, ...rest }) => withSiteRetry(pool, site_id, async (client, site) => withSiteMeta(await handleElementList(makeDeps(client), rest), site)),
         }),
         defineTool({
             name: 'yootheme_builder_element_get',
-            description: 'Get the full element object at a specific JSON-Pointer path, including props and a ' +
-                '`children_count` (NOT the children themselves — use yootheme_builder_element_list ' +
-                'with root_path to enumerate children). `fields[]` narrows the returned object; ' +
-                '`max_chars` bounds the text output. Address by template_id only — resolve a ' +
-                'URL/post first via pages_resolve. ' +
-                'Operates on the default site unless site_id is provided.',
+            description: 'Get the full element object at a JSON-Pointer path, including props and a ' +
+                '`children_count` (not the children — use element_list with root_path). On a ' +
+                '`module`/`module_position` element it also returns `resolved` (the referenced ' +
+                'widget/module row) plus `resolved_reason` when it could not be resolved. ' +
+                '`max_chars` bounds the text output.',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
-                template_id: TEMPLATE_ID,
+                layout_id: LAYOUT_ID,
                 element_path: ELEMENT_PATH,
                 fields: FIELDS,
                 max_chars: MAX_CHARS,
             },
             outputSchema: ELEMENT_GET_OUTPUT_SCHEMA,
             annotations: readOnly('Get Element'),
-            handler: async ({ site_id, ...rest }) => withSiteRetry(pool, site_id, async (client, site) => withSiteMeta(await handleElementGet(makeDeps(client), rest), site)),
         }),
         defineTool({
             name: 'yootheme_builder_layout_query',
-            description: 'Find elements in a template by a structured filter (no expression language). ' +
-                'AND-combine any of: `type` (one type or a list), `name_matches` (case-insensitive ' +
-                'substring of the element name), `has_binding` (bound vs unbound), `max_depth` ' +
-                '(cap descent — 0 = top-level), `under_section` (only nodes inside a named ' +
-                'section). template_id only — resolve a URL/post first via pages_resolve. Returns ' +
-                'matching rows {path, element_type, label, has_binding}; paginate with ' +
-                '`limit`/`cursor`, narrow rows with `fields[]`, bound text with `max_chars`. ' +
-                'Operates on the default site unless site_id is provided.',
+            description: 'TWO scopes. OMIT layout_id → SITE-WIDE: binding counts per `source_name` ' +
+                '(COUNTED, never resolved — a source that no longer exists counts like a live ' +
+                'one; pages_audit flags those as `dangling-source`, with paths), ' +
+                '`max_paths` for individual paths, `has_implode_directives:true` to locate the ' +
+                'comma-joining leftovers. WITH layout_id → ONE layout, AND-combined `element_type`, ' +
+                '`name_matches`, `content_contains` (case-insensitive substring of ' +
+                '`content`/`title`/`meta` props), `has_binding`, `under_section`; paginate ' +
+                '`limit`/`cursor`. Mixing scope arguments is REFUSED, never dropped. ' +
+                'To find WHERE a module/widget is used call local_content_read ' +
+                '(kind:"modules"). On a module/module_position row `label` is the ' +
+                'builder-assigned element name, NOT the module title: read ' +
+                'element_get(.resolved).',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
-                template_id: TEMPLATE_ID,
-                type: z
+                layout_id: z
+                    .string()
+                    .min(1)
+                    .optional()
+                    .describe('Which layout: "page:42", "article:12", "default", or a bare id (42). ' +
+                    'Use yootheme_builder_pages_list to discover. ' +
+                    'OMIT it entirely for the site-wide answer.'),
+                source_name: z
+                    .string()
+                    .min(1)
+                    .optional()
+                    .describe('SITE scope only (omit layout_id). Count only bindings on this source ' +
+                    '— the name yootheme_builder_sources_list reports. Omit for every source.'),
+                max_paths: z
+                    .number()
+                    .int()
+                    .min(1)
+                    .max(MAX_PATHS_CAP)
+                    .optional()
+                    .describe('SITE scope only (omit layout_id). Also return up to N individual ' +
+                    `element paths. Server ceiling ${String(MAX_PATHS_CAP)}; the answer ` +
+                    'states `max_paths_cap` so a truncated list says whose limit bit. ' +
+                    'Omitted, the answer is counts per source — measured binding density ' +
+                    'runs 0 to 45 per page, so a full path list is unbounded.'),
+                has_implode_directives: z
+                    .boolean()
+                    .optional()
+                    .describe('SITE scope only (omit layout_id). true → count ONLY bindings carrying an ' +
+                    'implode directive, the leftover that joins a list into one comma-separated ' +
+                    'string. Same reading yootheme_builder_inspect_multi_items_binding reports; ' +
+                    'add `max_paths` for the exact element paths. Every count then describes ' +
+                    'that subset, not the site.'),
+                element_type: z
                     .union([z.string().min(1), z.array(z.string().min(1)).max(40)])
                     .optional()
-                    .describe('Keep only elements of this type, or any type in the list ' +
-                    '(e.g. "headline" or ["section","grid"]). ' +
-                    'Use yootheme_builder_element_types_list to discover types.'),
+                    .describe('Keep only elements of this type — the same value each row reports as ' +
+                    '`element_type` — or any type in the list (e.g. "headline" or ' +
+                    '["section","grid"]). Use yootheme_builder_element_types_list to ' +
+                    'discover types.'),
                 name_matches: z
                     .string()
                     .min(1)
                     .optional()
                     .describe('Case-insensitive substring of the element\'s name (e.g. "Hero").'),
+                content_contains: z
+                    .string()
+                    .min(1)
+                    .optional()
+                    .describe('Case-insensitive substring of the element\'s content-bearing props ' +
+                    '(`content`, `title`, `meta`) — e.g. "<h1" finds every html/text/code ' +
+                    'element whose markup contains an h1 tag.'),
                 has_binding: z
                     .boolean()
                     .optional()
@@ -143,24 +159,30 @@ export function buildElementsTools(pool, deps) {
                     .string()
                     .optional()
                     .describe('Continuation token from a prior call\'s `next_cursor`.'),
+                include_meta: INCLUDE_META_SCHEMA,
             },
             outputSchema: LAYOUT_QUERY_OUTPUT_SCHEMA,
             annotations: readOnly('Query Layout'),
-            handler: async ({ site_id, ...rest }) => withSiteRetry(pool, site_id, async (client, site) => withSiteMeta(await handleLayoutQuery(makeDeps(client), rest), site)),
         }),
         defineTool({
             name: 'yootheme_builder_element_add',
             description: 'Add a new element to a template. Provide `parent_path` (or "" for root), ' +
-                '`element_type` (e.g. "headline", "text", "grid"), and optional `props` / ' +
-                '`children`. Content/leaf elements may only be added inside a `column`; only ' +
-                '`section` is valid at the root — call yootheme_builder_scaffold_section first ' +
-                'for a valid column path. Appends by default; pass `index` (0 = first) to insert. ' +
-                'Inserting renumbers later siblings — re-read paths via element_list after any ' +
-                'structural write. Returns the new element\'s JSON-Pointer path. Requires ETag. ' +
-                'Operates on the default site unless site_id is provided.',
+                '`element_type`, and optional `props`/`children`. Content/leaf elements may ' +
+                'only be added inside a `column`; at the root only `section` — else call ' +
+                'scaffold_section for a valid column path. Inserting renumbers later siblings: ' +
+                '`renumbered_siblings` names each moved sibling address (absent if none). ' +
+                'Requires ETag. ' +
+                'Live at once in the stored tree — already save-transformed ' +
+                '(defaults filled, empty children removed). ' +
+                'Stage hidden with element_set_status(status:false). ' +
+                'Prop names are snake_case. Common ' +
+                'traps: `content` (not `title`) on button_item/headline/list_item/quotation/text; check ' +
+                '`element_type_get_schema` first. ' +
+                'The answer carries no `props`, only the new address. The stored node also ' +
+                'carries the element\'s defaults — read it back with element_get.',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
-                template_id: TEMPLATE_ID,
+                layout_id: LAYOUT_ID,
                 parent_path: z
                     .string()
                     .optional()
@@ -174,20 +196,12 @@ export function buildElementsTools(pool, deps) {
                     .describe('Type of element to create (e.g. "headline", "text", "grid"). ' +
                     'Use yootheme_builder_element_types_list for the catalogue. ' +
                     'Canonical key; `type_name` is accepted as an alias.'),
-                // F165 — accept the natural-but-wrong alias `type_name`
-                // (mirrors element_type_get_schema). Normalised to
-                // `element_type` server-side; never forwarded verbatim.
                 type_name: z
                     .string()
                     .min(1)
                     .optional()
                     .describe('Alias of `element_type` — use `element_type`. Accepted so a ' +
                     'verbatim call with the wrong key still lands.'),
-                // ELEMENT_WRITE-4 (part 2): the human-visible builder name is a
-                // FIRST-CLASS arg — it is node-level metadata (OUTSIDE `props`,
-                // surfaced as element_list `label`), the primary handle a
-                // customer finds an element by. Threaded to the node's top-level
-                // `name`, never buried inside props.
                 name: z
                     .string()
                     .optional()
@@ -200,12 +214,10 @@ export function buildElementsTools(pool, deps) {
                     .optional()
                     .describe('Optional initial children — array of element objects. Each child object ' +
                     'names its type with the `type` key (NOT `element_type`), plus optional ' +
-                    '`props` and nested `children` that recurse. Inline children ARE ' +
-                    'validated (reserved-key + prop-typo + live-schema guards), the same as ' +
-                    'top-level props.'),
-                // F70 (2026-06-10): optional insertion index. Default (absent)
-                // appends. 0 = first child; an over-shot index is clamped to
-                // the end server-side. `position` is accepted as an alias.
+                    '`props` and nested `children` that recurse. Checked at EVERY depth ' +
+                    'like top-level props: an unknown type, an illegal parent→child edge ' +
+                    'and an impossible prop value are REFUSED; an undeclared prop key is ' +
+                    'stored and named under `warnings`.'),
                 index: z
                     .number()
                     .int()
@@ -221,24 +233,22 @@ export function buildElementsTools(pool, deps) {
                     .describe('Alias of `index`.'),
                 etag: ETAG,
             },
+            outputSchema: ELEMENT_ADD_OUTPUT_SCHEMA,
             annotations: creating('Add Element'),
-            handler: async ({ site_id, ...rest }, extra) => withWriteSiteRetry(pool, site_id, 'yootheme_builder_element_add', async (client, site) => withSiteMeta(await handleElementAdd(makeDeps(client), rest, extra), site)),
         }),
         defineTool({
             name: 'yootheme_builder_element_update_settings',
-            description: 'Update `props` on an element. Default replaces all props; pass ' +
-                '`merge:true` for server-side deep-merge (only request keys overwritten, ' +
-                'others survive — avoids read-modify-write races). Requires ETag. ' +
-                'Pass `unset:["key",…]` to reset props to their YOOtheme default by removing them. ' +
-                'Operates on the default site unless site_id is provided.',
+            description: 'Update `props` on an element. Default replaces all props; pass `merge:true` ' +
+                'for server-side deep-merge (only request keys overwritten). Requires ETag. ' +
+                '`unset:["key",…]` resets props to their YOOtheme default and is valid ON ITS ' +
+                'OWN: sent without `props`, it removes only those keys and touches nothing ' +
+                'else. Send `props`, `unset`, or both — a call with neither is refused. ' +
+                'Live at once.',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
-                template_id: TEMPLATE_ID,
+                layout_id: LAYOUT_ID,
                 element_path: ELEMENT_PATH,
-                props: PROPS,
-                // ELEMENT_WRITE-4 (part 2): rename the element via its
-                // first-class node-level `name` (OUTSIDE `props`) — the builder
-                // tree label / element_list `label`. Omit to leave it unchanged.
+                props: PROPS.optional(),
                 name: z
                     .string()
                     .optional()
@@ -257,25 +267,47 @@ export function buildElementsTools(pool, deps) {
                     .describe('Prop keys to REMOVE from the element (reset-to-default). Removing a key ' +
                     'makes YOOtheme re-apply its own default — use this instead of setting an ' +
                     'empty value on a required field (an empty value on a required field is ' +
-                    'rejected). Removal is always allowed and never schema-validated.'),
+                    'rejected). Valid WITHOUT `props`: the named keys go, every other prop ' +
+                    'stays. Removal is always allowed and never schema-validated.'),
                 etag: ETAG,
             },
+            outputSchema: ELEMENT_UPDATE_SETTINGS_OUTPUT_SCHEMA,
             annotations: mutating('Update Element Settings'),
-            handler: async ({ site_id, ...rest }, extra) => withWriteSiteRetry(pool, site_id, 'yootheme_builder_element_update_settings', async (client, site) => withSiteMeta(await handleElementUpdateSettings(makeDeps(client), rest, extra), site)),
+        }),
+        defineTool({
+            name: 'yootheme_builder_element_set_status',
+            description: 'Enable or disable an element via its `props.status` field — the SAME field ' +
+                'YOOtheme\'s own native "Disable element" checkbox writes. status:false excludes ' +
+                'the element and its descendants from BOTH the live render and live findings; ' +
+                'pages_audit (gateway-only) and template_summary content_nodes both honour it. ' +
+                'Requires ETag. Live at once.',
+            inputSchema: {
+                site_id: SITE_ID_SCHEMA,
+                layout_id: LAYOUT_ID,
+                element_path: ELEMENT_PATH,
+                status: z
+                    .boolean()
+                    .describe('false disables this element (excluded from live findings and render); ' +
+                    'true re-enables it.'),
+                etag: ETAG,
+            },
+            outputSchema: ELEMENT_SET_STATUS_OUTPUT_SCHEMA,
+            annotations: mutating('Set Element Status'),
         }),
         defineTool({
             name: 'yootheme_builder_element_move',
-            description: 'Move an element to a new parent + index in the tree. Useful for reordering or ' +
-                'reparenting (e.g. moving a card from one grid column to another). Moving renumbers ' +
-                'later siblings — re-read paths via element_list after any structural write. ' +
-                'Requires ETag. Operates on the default site unless site_id is provided.',
+            description: 'Move an element to a new parent + index in the tree — reordering or ' +
+                'reparenting. Renumbers siblings at BOTH ends: `renumbered_siblings` names ' +
+                'each moved sibling address (absent if none). Requires ETag. Live at once.',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
-                template_id: TEMPLATE_ID,
+                layout_id: LAYOUT_ID,
                 element_path: ELEMENT_PATH,
                 to_parent_path: z
                     .string()
-                    .describe('Destination parent JSON-Pointer ("" for template root).'),
+                    .describe('Destination parent JSON-Pointer ("" for template root). Must already ' +
+                    'exist: a destination that does not resolve is rejected and nothing ' +
+                    'is moved. Use element_list to get a valid path.'),
                 to_index: z
                     .number()
                     .int()
@@ -285,37 +317,48 @@ export function buildElementsTools(pool, deps) {
                     'post-removal indexing (with 4 items, move-to-last is to_index:3, not 4).'),
                 etag: ETAG,
             },
+            outputSchema: ELEMENT_MOVE_OUTPUT_SCHEMA,
             annotations: mutating('Move Element'),
-            handler: async ({ site_id, ...rest }, extra) => withWriteSiteRetry(pool, site_id, 'yootheme_builder_element_move', async (client, site) => withSiteMeta(await handleElementMove(makeDeps(client), rest, extra), site)),
         }),
         defineTool({
             name: 'yootheme_builder_element_clone',
-            description: 'Clone an element as a sibling (same parent, immediately after the source). ' +
-                'Returns the new element\'s path. Cloning renumbers later siblings — re-read paths ' +
-                'via element_list after any structural write. Requires ETag. ' +
-                'Operates on the default site unless site_id is provided.',
+            description: 'Clone an element. Default: as a sibling right after the source; pass ' +
+                '`to_parent_path` to drop the copy elsewhere in the SAME template instead. ' +
+                'Renumbers later siblings: `renumbered_siblings` names each moved sibling ' +
+                'address (absent if none). Requires ETag. Live at once — stage hidden with ' +
+                'element_set_status(status:false).',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
-                template_id: TEMPLATE_ID,
+                layout_id: LAYOUT_ID,
                 element_path: ELEMENT_PATH,
+                to_parent_path: z
+                    .string()
+                    .optional()
+                    .describe('Optional destination parent JSON-Pointer, in THIS template ("" for ' +
+                    'the template root). Omit for the historical behaviour (sibling ' +
+                    'right after the source). Must already exist and must accept this ' +
+                    'element type — otherwise nothing is cloned. Use element_list.'),
+                to_index: z
+                    .number()
+                    .int()
+                    .min(0)
+                    .optional()
+                    .describe('Zero-based slot inside `to_parent_path` (default: append). Ignored ' +
+                    'when `to_parent_path` is omitted.'),
                 etag: ETAG,
             },
+            outputSchema: ELEMENT_CLONE_OUTPUT_SCHEMA,
             annotations: creating('Clone Element'),
-            handler: async ({ site_id, ...rest }, extra) => withWriteSiteRetry(pool, site_id, 'yootheme_builder_element_clone', async (client, site) => withSiteMeta(await handleElementClone(makeDeps(client), rest, extra), site)),
         }),
         defineTool({
             name: 'yootheme_builder_scaffold_section',
             description: 'Create a VALID section → row → column hull in ONE call; returns the column ' +
-                'JSON-Pointer path(s) for content. The correct way to start a layout block: only ' +
-                '`section` may sit at the layout root; a bare section accepts `row`, a bare row ' +
-                'accepts `column`; leaf/content elements are rejected anywhere except inside a ' +
-                '`column`. Pass `columns` (1-12, default 1); columns get width tokens so they ' +
-                'render side-by-side (hand-built columns default to full width), or `column_widths` ' +
-                '(one token per column) for an asymmetric row. Requires ETag. ' +
-                'Operates on the default site unless site_id is provided.',
+                'path(s) for content. Only `section` may sit at the layout root; leaf/content ' +
+                'elements are rejected anywhere except inside a `column`. Pass `columns` (1-12) ' +
+                'or `column_widths` for an asymmetric row. Requires ETag.',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
-                template_id: TEMPLATE_ID,
+                layout_id: LAYOUT_ID,
                 columns: z
                     .number()
                     .int()
@@ -334,38 +377,33 @@ export function buildElementsTools(pool, deps) {
                     'equal-width row (server distributes 1-1 / 1-N / expand).'),
                 etag: ETAG,
             },
+            outputSchema: SCAFFOLD_SECTION_OUTPUT_SCHEMA,
             annotations: creating('Scaffold Section'),
-            handler: async ({ site_id, ...rest }, extra) => withWriteSiteRetry(pool, site_id, 'yootheme_builder_scaffold_section', async (client, site) => withSiteMeta(await handleScaffoldSection(makeDeps(client), rest, extra), site)),
         }),
         defineTool({
             name: 'yootheme_builder_element_delete',
             description: 'PERMANENTLY delete an element + children. Cannot be undone. Pass `confirm: ' +
-                'true` (boolean) AND a fresh ETag. Deleting renumbers later siblings — re-read ' +
-                'paths via element_list after any structural write. If `preview:true` returns ' +
-                'despite confirm, check `details.received_confirm` — strings/numbers accepted, ' +
-                'but boolean is canonical. Operates on the default site unless site_id is provided.',
+                'true` AND a fresh ETag. Preview: neither. A real delete returns ' +
+                '`deleted:true` and NO ' +
+                '`requires_confirmation` key; a returned `requires_confirmation:true` means ' +
+                'NOTHING was deleted. `renumbered_siblings` names each moved sibling address ' +
+                '(absent if none). Live at once. Hide instead: element_set_status(status:false).',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
-                template_id: TEMPLATE_ID,
+                layout_id: LAYOUT_ID,
                 element_path: ELEMENT_PATH,
-                etag: ETAG,
-                // Wave-6 R4: accept boolean OR the string literals "true"/"false"
-                // and numeric 0/1 — the handler's `isConfirmedTrue` coerces all
-                // four into the canonical boolean. Cold-AI #4 reported a confirm
-                // gate that kept firing despite passing the value; the safety net
-                // prevents future schema-string mismatches from re-creating that
-                // class of bug.
+                etag: ETAG_PREVIEW_OPTIONAL.optional(),
                 confirm: z
                     .union([z.boolean(), z.literal('true'), z.literal('false'), z.literal(0), z.literal(1)])
                     .optional()
                     .describe('Must be `true` (boolean literal) to execute. Strings "true"/"false" ' +
                     'and numeric 1/0 are also accepted as a safety net but `true` is ' +
-                    'canonical. On supporting hosts the agent is prompted via MCP ' +
-                    'elicitation when omitted; otherwise the call returns a preview ' +
-                    'and the agent must retry with `confirm: true`.'),
+                    'canonical. A confirm-omitted call ALWAYS returns the preview first ' +
+                    'and deletes nothing. ' +
+                    HOST_PROMPT_PROMISE),
             },
+            outputSchema: ELEMENT_DELETE_OUTPUT_SCHEMA,
             annotations: destructive('Delete Element'),
-            handler: async ({ site_id, ...rest }, extra) => withWriteSiteRetry(pool, site_id, 'yootheme_builder_element_delete', async (client, site) => withSiteMeta(await handleElementDelete(makeDeps(client), rest, extra), site)),
         }),
     ];
 }

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

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

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

@@ -1,28 +1,2 @@
-/**
- * Element-tool barrel — public entry-point for the 7 element tools.
- *
- *   yootheme_builder_element_list
- *      → list all elements in a template (flat, with paths)
- *   yootheme_builder_element_get
- *      → fetch one element by JSON-Pointer
- *   yootheme_builder_element_add
- *      → POST new element
- *   yootheme_builder_element_update_settings
- *      → PUT props on an existing element
- *   yootheme_builder_element_move
- *      → relocate within tree
- *   yootheme_builder_element_clone
- *      → duplicate as sibling
- *   yootheme_builder_element_delete   (destructive — elicit/confirm)
- *
- * Wave G.4.0 — file split from the monolithic `src/tools/elements.ts`
- * (382 LoC) into `index.ts` (this file, re-exports), `builders.ts`
- * (defineTool factory list, ≤200 LoC), and `handlers.ts` (handler
- * bodies, ≤300 LoC). Tool surface is unchanged — see
- * `tests/tools/elements-split.test.ts` for the snapshot proof.
- *
- * @license MIT
- */
 export { buildElementsTools } from './builders.js';
-export type { ElementsHandlerDeps } from './handlers.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/elements/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/elements/index.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/elements/index.js

@@ -1,27 +1,2 @@
-/**
- * Element-tool barrel — public entry-point for the 7 element tools.
- *
- *   yootheme_builder_element_list
- *      → list all elements in a template (flat, with paths)
- *   yootheme_builder_element_get
- *      → fetch one element by JSON-Pointer
- *   yootheme_builder_element_add
- *      → POST new element
- *   yootheme_builder_element_update_settings
- *      → PUT props on an existing element
- *   yootheme_builder_element_move
- *      → relocate within tree
- *   yootheme_builder_element_clone
- *      → duplicate as sibling
- *   yootheme_builder_element_delete   (destructive — elicit/confirm)
- *
- * Wave G.4.0 — file split from the monolithic `src/tools/elements.ts`
- * (382 LoC) into `index.ts` (this file, re-exports), `builders.ts`
- * (defineTool factory list, ≤200 LoC), and `handlers.ts` (handler
- * bodies, ≤300 LoC). Tool surface is unchanged — see
- * `tests/tools/elements-split.test.ts` for the snapshot proof.
- *
- * @license MIT
- */
 export { buildElementsTools } from './builders.js';
 //# sourceMappingURL=index.js.map

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

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