@wootsup/yt-builder-mcp 1.0.0 → 1.0.1

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

@@ -1,49 +0,0 @@
-/**
- * Element-tool write handlers (add/update/move/clone/delete).
- *
- * Wave G.4.0 split: read handlers + shared types in `./handlers.ts`.
- * Wave G.4.1: `handleElementDelete` consults `deps.elicitation` when
- * `confirm` is undefined — falls back to the explicit preview when
- * elicitation is unavailable.
- * Wave G.5: every handler emits 2-phase client-side progress
- * (`PHASE_SEND` → `PHASE_CONFIRM`) when the caller supplied a
- * `progressToken` — see `../progress-phases.ts` for the contract.
- *
- * @license MIT
- */
-import { type HandlerExtra, type ToolResult } from '../tool-builder.js';
-import type { ElementsHandlerDeps } from './handlers.js';
-export declare function handleElementAdd({ client }: ElementsHandlerDeps, input: {
-    template_id: string;
-    parent_path: string;
-    element_type: string;
-    props?: Record<string, unknown>;
-    children?: Record<string, unknown>[];
-    etag: string;
-}, extra?: HandlerExtra): Promise<ToolResult>;
-export declare function handleElementUpdateSettings({ client }: ElementsHandlerDeps, input: {
-    template_id: string;
-    element_path: string;
-    props: Record<string, unknown>;
-    merge?: boolean;
-    etag: string;
-}, extra?: HandlerExtra): Promise<ToolResult>;
-export declare function handleElementMove({ client }: ElementsHandlerDeps, input: {
-    template_id: string;
-    element_path: string;
-    to_parent_path: string;
-    to_index: number;
-    etag: string;
-}, extra?: HandlerExtra): Promise<ToolResult>;
-export declare function handleElementClone({ client }: ElementsHandlerDeps, input: {
-    template_id: string;
-    element_path: string;
-    etag: string;
-}, extra?: HandlerExtra): Promise<ToolResult>;
-export declare function handleElementDelete({ client, elicitation }: ElementsHandlerDeps, input: {
-    template_id: string;
-    element_path: string;
-    etag: string;
-    confirm?: boolean;
-}, extra?: HandlerExtra): Promise<ToolResult>;
-//# sourceMappingURL=handlers-write.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"handlers-write.d.ts","sourceRoot":"","sources":["../../../src/tools/elements/handlers-write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EAKH,KAAK,YAAY,EACjB,KAAK,UAAU,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAIzD,wBAAsB,gBAAgB,CAClC,EAAE,MAAM,EAAE,EAAE,mBAAmB,EAC/B,KAAK,EAAE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CAChB,EACD,KAAK,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAoBrB;AAID,wBAAsB,2BAA2B,CAC7C,EAAE,MAAM,EAAE,EAAE,mBAAmB,EAC/B,KAAK,EAAE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CAChB,EACD,KAAK,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CA6BrB;AAID,wBAAsB,iBAAiB,CACnC,EAAE,MAAM,EAAE,EAAE,mBAAmB,EAC/B,KAAK,EAAE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CAChB,EACD,KAAK,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAqBrB;AAID,wBAAsB,kBAAkB,CACpC,EAAE,MAAM,EAAE,EAAE,mBAAmB,EAC/B,KAAK,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAClE,KAAK,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAmBrB;AAiCD,wBAAsB,mBAAmB,CACrC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,mBAAmB,EAC5C,KAAK,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,EACrF,KAAK,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAwBrB"}

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

@@ -1,148 +0,0 @@
-/**
- * Element-tool write handlers (add/update/move/clone/delete).
- *
- * Wave G.4.0 split: read handlers + shared types in `./handlers.ts`.
- * Wave G.4.1: `handleElementDelete` consults `deps.elicitation` when
- * `confirm` is undefined — falls back to the explicit preview when
- * elicitation is unavailable.
- * Wave G.5: every handler emits 2-phase client-side progress
- * (`PHASE_SEND` → `PHASE_CONFIRM`) when the caller supplied a
- * `progressToken` — see `../progress-phases.ts` for the contract.
- *
- * @license MIT
- */
-import { elicitConfirmation } from '@getimo/mcp-toolkit';
-import { encodeElementPath } from '../../client.js';
-import { PHASE_CONFIRM, PHASE_SEND } from '../progress-phases.js';
-import { confirmGuard, createProgressReporter, errorResult, jsonResult, } from '../tool-builder.js';
-// ─── element_add ─────────────────────────────────────────────────────
-export async function handleElementAdd({ client }, input, extra) {
-    const { template_id, etag, ...body } = input;
-    const progress = extra ? createProgressReporter(extra) : null;
-    await progress?.report(0, 2, PHASE_SEND);
-    try {
-        const data = await client.post(`/pages/${encodeURIComponent(template_id)}/elements`, { body, etag });
-        await progress?.report(2, 2, PHASE_CONFIRM);
-        return jsonResult(data);
-    }
-    catch (e) {
-        return errorResult({
-            error: e,
-            context: input,
-            hint: 'On 412 refresh via yootheme_builder_get_etag and retry. On 400 ' +
-                'check `element_type` is valid via yootheme_builder_element_types_list.',
-        });
-    }
-}
-// ─── element_update_settings ─────────────────────────────────────────
-export async function handleElementUpdateSettings({ client }, input, extra) {
-    const { template_id, element_path, props, merge, etag } = input;
-    const encoded = encodeElementPath(element_path);
-    const progress = extra ? createProgressReporter(extra) : null;
-    await progress?.report(0, 2, PHASE_SEND);
-    try {
-        // T5 / F-12: forward `merge` only when explicitly true so older PHP
-        // builds (which ignore unknown keys anyway) get the same byte-for-
-        // byte body they did before.
-        const body = { props };
-        if (merge === true) {
-            body.merge = true;
-        }
-        const data = await client.put(`/pages/${encodeURIComponent(template_id)}/elements/${encoded}/settings`, { body, etag });
-        await progress?.report(2, 2, PHASE_CONFIRM);
-        return jsonResult(data);
-    }
-    catch (e) {
-        return errorResult({
-            error: e,
-            context: { template_id, element_path },
-            hint: 'On 412 refresh via yootheme_builder_get_etag and retry. To merge ' +
-                'props instead of replacing, pass `merge:true` (server deep-merges ' +
-                'the request into current props).',
-        });
-    }
-}
-// ─── element_move ────────────────────────────────────────────────────
-export async function handleElementMove({ client }, input, extra) {
-    const { template_id, element_path, to_parent_path, to_index, etag } = input;
-    const encoded = encodeElementPath(element_path);
-    const progress = extra ? createProgressReporter(extra) : null;
-    await progress?.report(0, 2, PHASE_SEND);
-    try {
-        const data = await client.post(`/pages/${encodeURIComponent(template_id)}/elements/${encoded}/move`, { body: { to_parent_path, to_index }, etag });
-        await progress?.report(2, 2, PHASE_CONFIRM);
-        return jsonResult(data);
-    }
-    catch (e) {
-        return errorResult({
-            error: e,
-            context: { template_id, element_path, to_parent_path, to_index },
-            hint: 'Verify destination parent accepts the element type. On 412 refresh ' +
-                'ETag and retry.',
-        });
-    }
-}
-// ─── element_clone ───────────────────────────────────────────────────
-export async function handleElementClone({ client }, input, extra) {
-    const { template_id, element_path, etag } = input;
-    const encoded = encodeElementPath(element_path);
-    const progress = extra ? createProgressReporter(extra) : null;
-    await progress?.report(0, 2, PHASE_SEND);
-    try {
-        const data = await client.post(`/pages/${encodeURIComponent(template_id)}/elements/${encoded}/clone`, { etag });
-        await progress?.report(2, 2, PHASE_CONFIRM);
-        return jsonResult(data);
-    }
-    catch (e) {
-        return errorResult({
-            error: e,
-            context: { template_id, element_path },
-            hint: 'On 412 refresh via yootheme_builder_get_etag and retry.',
-        });
-    }
-}
-// ─── element_delete (destructive — elicitation + confirm-guard) ─────
-//
-// Wave G.4.1 — destructive confirm via MCP elicitation. Progress
-// reports (Wave G.5) only start AFTER the confirm gate clears.
-async function resolveDeleteConfirm(elicitation, template_id, element_path, confirm) {
-    if (confirm === true)
-        return null;
-    if (confirm === false || !elicitation) {
-        return confirmGuard({
-            operation: 'delete element',
-            details: { template_id, element_path },
-        });
-    }
-    const accepted = await elicitConfirmation(elicitation, `Permanently delete element at "${element_path}" in template ` +
-        `"${template_id}"? This cannot be undone.`);
-    return accepted
-        ? null
-        : confirmGuard({
-            operation: 'delete element',
-            details: { template_id, element_path },
-        });
-}
-export async function handleElementDelete({ client, elicitation }, input, extra) {
-    const { template_id, element_path, etag, confirm } = input;
-    const blocked = await resolveDeleteConfirm(elicitation, template_id, element_path, confirm);
-    if (blocked)
-        return blocked;
-    const encoded = encodeElementPath(element_path);
-    const progress = extra ? createProgressReporter(extra) : null;
-    await progress?.report(0, 2, PHASE_SEND);
-    try {
-        const data = await client.delete(`/pages/${encodeURIComponent(template_id)}/elements/${encoded}`, { etag });
-        await progress?.report(2, 2, PHASE_CONFIRM);
-        return jsonResult(data);
-    }
-    catch (e) {
-        return errorResult({
-            error: e,
-            context: { template_id, element_path },
-            hint: 'On 412 refresh via yootheme_builder_get_etag and retry. On 404 the ' +
-                'element may already be gone — verify with yootheme_builder_element_list.',
-        });
-    }
-}
-//# sourceMappingURL=handlers-write.js.map

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

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

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

@@ -1,61 +0,0 @@
-/**
- * Element-tool read handlers + shared types/schemas.
- *
- * Split out of the original `src/tools/elements.ts` (Wave G.4.0). Write
- * handlers (add/update/move/clone/delete) live in `./handlers-write.ts`
- * to keep each file under the 200-LoC budget.
- *
- * Handler responsibilities:
- *   - call the REST endpoint via `deps.client`,
- *   - map REST data to the toolkit output builders (`tableResult`,
- *     `detailResult`),
- *   - wrap in `structuredResult` to carry the typed
- *     `structuredContent` payload,
- *   - on error, return `errorResult` with `context` + `hint`.
- *
- * @license MIT
- */
-import { z } from 'zod';
-import { type RestClient } from '../../client.js';
-import type { McpServerWithElicitation } from '../elicitation.js';
-import { type ToolResult } from '../tool-builder.js';
-export declare const ELEMENT_LIST_OUTPUT_SCHEMA: z.ZodObject<{
-    items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    total: z.ZodNumber;
-    template_id: z.ZodString;
-    next_cursor: z.ZodOptional<z.ZodString>;
-    projected_fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-export declare const ELEMENT_GET_OUTPUT_SCHEMA: z.ZodObject<{
-    template_id: z.ZodString;
-    element_path: z.ZodString;
-    element_type: z.ZodString;
-    label: z.ZodOptional<z.ZodString>;
-    props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    children_count: z.ZodNumber;
-}, z.core.$strip>;
-export interface ElementsHandlerDeps {
-    readonly client: RestClient;
-    /**
-     * Optional MCP elicitation capability. When present, destructive
-     * tools (`element_delete`) prompt the user for confirmation via the
-     * elicitation channel instead of demanding an explicit
-     * `confirm: true` round-trip. When absent, tools fall back to the
-     * preview-then-retry flow.
-     */
-    readonly elicitation?: McpServerWithElicitation;
-}
-export declare function handleElementList({ client }: ElementsHandlerDeps, { template_id, fields, root_path, depth, limit, cursor, }: {
-    template_id: string;
-    fields?: readonly string[];
-    root_path?: string;
-    depth?: number;
-    limit?: number;
-    cursor?: string;
-}): Promise<ToolResult>;
-export declare function handleElementGet({ client }: ElementsHandlerDeps, { template_id, element_path }: {
-    template_id: string;
-    element_path: string;
-}): Promise<ToolResult>;
-export { handleElementAdd, handleElementClone, handleElementDelete, handleElementMove, handleElementUpdateSettings, } from './handlers-write.js';
-//# sourceMappingURL=handlers.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/tools/elements/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAYlE,OAAO,EAGH,KAAK,UAAU,EAClB,MAAM,oBAAoB,CAAC;AAI5B,eAAO,MAAM,0BAA0B;;;;;;iBAOrC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;iBAOpC,CAAC;AAIH,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACnD;AAyBD,wBAAsB,iBAAiB,CACnC,EAAE,MAAM,EAAE,EAAE,mBAAmB,EAC/B,EACI,WAAW,EACX,MAAM,EACN,SAAS,EACT,KAAK,EACL,KAAK,EACL,MAAM,GACT,EAAE;IACC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,GACF,OAAO,CAAC,UAAU,CAAC,CA4ErB;AAID,wBAAsB,gBAAgB,CAClC,EAAE,MAAM,EAAE,EAAE,mBAAmB,EAC/B,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC7E,OAAO,CAAC,UAAU,CAAC,CA8CrB;AAGD,OAAO,EACH,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,2BAA2B,GAC9B,MAAM,qBAAqB,CAAC"}

package/dist/tools/elements/handlers.js

@@ -1,170 +0,0 @@
-/**
- * Element-tool read handlers + shared types/schemas.
- *
- * Split out of the original `src/tools/elements.ts` (Wave G.4.0). Write
- * handlers (add/update/move/clone/delete) live in `./handlers-write.ts`
- * to keep each file under the 200-LoC budget.
- *
- * Handler responsibilities:
- *   - call the REST endpoint via `deps.client`,
- *   - map REST data to the toolkit output builders (`tableResult`,
- *     `detailResult`),
- *   - wrap in `structuredResult` to carry the typed
- *     `structuredContent` payload,
- *   - on error, return `errorResult` with `context` + `hint`.
- *
- * @license MIT
- */
-import { detailResult, tableResult } from '@getimo/mcp-toolkit';
-import { z } from 'zod';
-import { encodeElementPath } from '../../client.js';
-import { ELEMENTS_COMPACT_COLUMNS, ELEMENTS_TABLE_COLUMNS, buildElementDetail, mapElementRow, } from '../format/elements-format.js';
-import { DEFAULT_FIELDS_ELEMENT_LIST, projectFields, projectedFieldsEcho, } from '../sparse-fields.js';
-import { errorResult, structuredResult, } from '../tool-builder.js';
-// ─── outputSchemas (Wave G.2 §4) ─────────────────────────────────────
-export const ELEMENT_LIST_OUTPUT_SCHEMA = z.object({
-    items: z.array(z.record(z.string(), z.unknown())),
-    total: z.number(),
-    template_id: z.string(),
-    // N-01: present only when the call was paginated and more rows remain.
-    next_cursor: z.string().optional(),
-    projected_fields: z.array(z.string()).optional(),
-});
-export const ELEMENT_GET_OUTPUT_SCHEMA = z.object({
-    template_id: z.string(),
-    element_path: z.string(),
-    element_type: z.string(),
-    label: z.string().optional(),
-    props: z.record(z.string(), z.unknown()).optional(),
-    children_count: z.number(),
-});
-// ─── element_list ────────────────────────────────────────────────────
-/**
- * N-01 (Audit v4): build slim text-table columns from a caller-supplied
- * `fields[]` projection. The default compact text table truncates at
- * 2000 chars (~26 of 96 nodes); projecting to a couple of narrow
- * columns lets the FULL node list fit in the 8000-char `full` budget.
- *
- * Width heuristic: paths get a wide column, everything else a modest
- * one. Labels are uppercased for the header to match the toolkit style.
- */
-function columnsFromFields(fields) {
-    return fields.map((key) => {
-        const isPath = key === 'path' || key === 'rel_path' || key === 'parent_path';
-        return {
-            key,
-            label: key.replace(/_/g, ' ').toUpperCase(),
-            width: isPath ? 48 : 16,
-        };
-    });
-}
-export async function handleElementList({ client }, { template_id, fields, root_path, depth, limit, cursor, }) {
-    try {
-        // N-01 (Audit-v3): forward the transport-safe scoping params as
-        // query string. The REST layer returns the pagination envelope
-        // `{items, next_cursor, total}` when `limit` is set, else the flat
-        // `{elements, total}` shape — handle both.
-        const qs = new URLSearchParams();
-        if (typeof root_path === 'string' && root_path !== '') {
-            qs.set('root_path', root_path);
-        }
-        if (typeof depth === 'number')
-            qs.set('depth', String(depth));
-        if (typeof limit === 'number')
-            qs.set('limit', String(limit));
-        if (typeof cursor === 'string' && cursor !== '')
-            qs.set('cursor', cursor);
-        const query = qs.toString();
-        const data = await client.get(`/pages/${encodeURIComponent(template_id)}/elements${query !== '' ? `?${query}` : ''}`);
-        // Paginated envelope uses `items`; flat shape uses `elements`.
-        const rawSource = Array.isArray(data.items)
-            ? data.items
-            : Array.isArray(data.elements)
-                ? data.elements
-                : [];
-        const mapped = rawSource
-            .filter((x) => x !== null && typeof x === 'object')
-            .map(mapElementRow);
-        const items = projectFields(mapped, fields, DEFAULT_FIELDS_ELEMENT_LIST);
-        const echo = projectedFieldsEcho(fields, DEFAULT_FIELDS_ELEMENT_LIST);
-        // N-01 (Audit v4): when the caller passes an explicit narrow
-        // `fields[]`, render the text table from the projected (slim)
-        // rows with `full` detail (8000 chars) so the WHOLE node list
-        // survives — the default compact table caps at 2000 chars and
-        // hides ~70 of a 96-node template. Without `fields[]` keep the
-        // auto-scaling behaviour (full columns, count-driven level).
-        const hasNarrowProjection = Array.isArray(fields) && fields.length > 0;
-        const toolkitResult = hasNarrowProjection
-            ? tableResult(items, {
-                columns: columnsFromFields(fields),
-                header: (count) => `${String(count)} elements in template "${template_id}"`,
-                footer: 'Use yootheme_builder_element_get <path> for full data.',
-            }, 'full')
-            : tableResult(mapped, {
-                columns: [...ELEMENTS_TABLE_COLUMNS],
-                compactColumns: [...ELEMENTS_COMPACT_COLUMNS],
-                header: (count) => `${String(count)} elements in template "${template_id}"`,
-                footer: 'Use yootheme_builder_element_get <path> for full data.',
-            });
-        return structuredResult(toolkitResult, {
-            items,
-            total: typeof data.total === 'number' ? data.total : items.length,
-            template_id,
-            ...(typeof data.next_cursor === 'string' && data.next_cursor !== ''
-                ? { next_cursor: data.next_cursor }
-                : {}),
-            ...(echo !== undefined ? { projected_fields: [...echo] } : {}),
-        });
-    }
-    catch (e) {
-        return errorResult({
-            error: e,
-            context: { template_id },
-            hint: 'Verify the template_id via yootheme_builder_pages_list.',
-        });
-    }
-}
-// ─── element_get ─────────────────────────────────────────────────────
-export async function handleElementGet({ client }, { template_id, element_path }) {
-    const encoded = encodeElementPath(element_path);
-    try {
-        const data = await client.get(`/pages/${encodeURIComponent(template_id)}/elements/${encoded}`);
-        const elementType = typeof data.element_type === 'string'
-            ? data.element_type
-            : typeof data.type === 'string'
-                ? data.type
-                : '';
-        const label = typeof data.label === 'string' ? data.label : undefined;
-        const propsRaw = data.props;
-        const props = propsRaw !== null && typeof propsRaw === 'object'
-            ? propsRaw
-            : undefined;
-        const children = Array.isArray(data.children) ? data.children : [];
-        const toolkitResult = detailResult(buildElementDetail({
-            path: element_path,
-            element_type: elementType,
-            label,
-            props,
-            children: children,
-        }));
-        return structuredResult(toolkitResult, {
-            template_id,
-            element_path,
-            element_type: elementType,
-            ...(label !== undefined ? { label } : {}),
-            ...(props !== undefined ? { props } : {}),
-            children_count: children.length,
-        });
-    }
-    catch (e) {
-        return errorResult({
-            error: e,
-            context: { template_id, element_path },
-            hint: 'Paths are JSON-Pointer style ("/0/children/1"). Use ' +
-                'yootheme_builder_element_list to enumerate valid paths.',
-        });
-    }
-}
-// Re-export write handlers so callers can import from this barrel.
-export { handleElementAdd, handleElementClone, handleElementDelete, handleElementMove, handleElementUpdateSettings, } from './handlers-write.js';
-//# sourceMappingURL=handlers.js.map

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

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

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

@@ -1,28 +0,0 @@
-/**
- * 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 +0,0 @@
-{"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"}

package/dist/tools/elements/index.js

@@ -1,27 +0,0 @@
-/**
- * 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 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/elements/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/elements.d.ts

@@ -1,13 +0,0 @@
-/**
- * Backwards-compatible re-export shim.
- *
- * Wave G.4.0 split the original 382-LoC `elements.ts` into
- * `./elements/{index, handlers, builders}.ts`. This shim keeps the
- * legacy import path (`from '../tools/elements.js'`) working for
- * downstream callers and tests. New code should import from
- * `./elements/index.js` directly.
- *
- * @license MIT
- */
-export { buildElementsTools } from './elements/index.js';
-//# sourceMappingURL=elements.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"elements.d.ts","sourceRoot":"","sources":["../../src/tools/elements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/tools/elements.js

@@ -1,13 +0,0 @@
-/**
- * Backwards-compatible re-export shim.
- *
- * Wave G.4.0 split the original 382-LoC `elements.ts` into
- * `./elements/{index, handlers, builders}.ts`. This shim keeps the
- * legacy import path (`from '../tools/elements.js'`) working for
- * downstream callers and tests. New code should import from
- * `./elements/index.js` directly.
- *
- * @license MIT
- */
-export { buildElementsTools } from './elements/index.js';
-//# sourceMappingURL=elements.js.map

package/dist/tools/elements.js.map

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

package/dist/tools/elicitation.d.ts

@@ -1,87 +0,0 @@
-/**
- * Targeted-elicitation support (Wave G.4 — Design §3.4 / §4.18).
- *
- * Three tool sites use elicitation:
- *   - element_delete (destructive confirm)
- *   - element_unbind_source (destructive confirm)
- *   - element_bind_source (ambiguity resolution: ≥2 sources with the
- *     same `source_name` → ask the user which one)
- *
- * Architecture mirrors `~/Projekte/wootsup/packages/apimapper-mcp/src/
- * modules/apimapper/elicitation.ts` (the reference Goldstandard impl):
- *
- *   1. `toElicitationCapability(server)` — typed adapter that bridges the
- *      SDK's stricter discriminated `ElicitRequestFormParams` to the
- *      toolkit's looser `ElicitInputParams`. ONE documented cast, justified
- *      by the toolkit only ever emitting form-mode requests.
- *   2. `ElicitationCandidate` + `renderCandidateList` — a candidate is
- *      `{ id, label }`; the list renders as a readable bullet block for the
- *      mandatory non-elicitation fallback error.
- *   3. `ambiguityFallbackError` — the structured `errorResult` returned
- *      when elicitation is unavailable (unsupported client) or declined.
- *      Lists every candidate so the LLM (or operator) has an actionable
- *      recovery path: "retry with explicit param X set to one of …".
- *
- * MANDATORY non-elicitation fallback: `elicitChoice` returns `null` on a
- * client without elicitation support, on decline, and on cancel. Every
- * call site MUST then return a structured `errorResult` listing the
- * candidates with a recovery hint — never hang, never guess, never
- * silently pick.
- *
- * @license MIT
- */
-import type { McpServerWithElicitation } from '@getimo/mcp-toolkit';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { type ToolResult } from './tool-builder.js';
-export type { McpServerWithElicitation };
-/**
- * Build the `McpServerWithElicitation` capability object the toolkit's
- * `elicitChoice` / `elicitConfirmation` consume, from the real `McpServer`.
- *
- * Why an adapter and not the bare `McpServer`:
- *   The toolkit's `McpServerWithElicitation.server.elicitInput` is typed
- *   with the loose `ElicitInputParams` (`mode: "form" | "url"`,
- *   `requestedSchema?: Record<string, unknown>`). The SDK's
- *   `Server.elicitInput` is the stricter discriminated
- *   `ElicitRequestFormParams | ElicitRequestURLParams` with a fully-typed
- *   `requestedSchema`. A real `McpServer` is therefore NOT structurally
- *   assignable to `McpServerWithElicitation` — the parameter types are
- *   contravariantly incompatible.
- *
- *   The toolkit's `elicitChoice` / `elicitConfirmation` ALWAYS call with
- *   `mode: "form"` and a `requestedSchema` whose properties are plain
- *   `{ type: "string", enum: [...] }` / `{ type: "boolean" }` shapes —
- *   i.e. always a valid `ElicitRequestFormParams` at runtime. This adapter
- *   is the single, documented interop boundary that re-narrows the loose
- *   toolkit params to the SDK's form-params type.
- */
-export declare function toElicitationCapability(realServer: McpServer): McpServerWithElicitation;
-/**
- * A disambiguation candidate. `id` is the value a tool needs (source ID,
- * credential ID, …); `label` is a human-readable name shown in the
- * elicitation prompt and the fallback error list.
- */
-export interface ElicitationCandidate {
-    readonly id: string;
-    readonly label: string;
-}
-/**
- * Render a candidate list as a readable bullet block for the structured
- * fallback error — so a client without elicitation support still gets a
- * fully actionable recovery path.
- */
-export declare function renderCandidateList(candidates: readonly ElicitationCandidate[]): string;
-/**
- * Build the structured `errorResult` returned when elicitation is
- * unavailable (unsupported client) or the user declined / cancelled. The
- * error names every candidate and tells the caller exactly which
- * parameter to supply on retry.
- */
-export declare function ambiguityFallbackError(opts: {
-    code: string;
-    paramName: string;
-    what: string;
-    candidates: readonly ElicitationCandidate[];
-    context: Record<string, unknown>;
-}): ToolResult;
-//# sourceMappingURL=elicitation.d.ts.map