@wootsup/yt-builder-mcp 0.2.0-alpha.2

package/dist/setup-wizard.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Interactive setup wizard for `@wootsup/yt-builder-mcp`.
+ *
+ * `runWizard()` accepts a {@link WizardDeps} bag so unit tests can drive
+ * a deterministic prompt → validate → probe → write → handshake sequence
+ * without touching real subprocesses or filesystems.
+ *
+ * After the Round-1 audit I5 fix, this file is the wizard ALGORITHM only:
+ *   - `WizardDeps` and its result types live in `setup-wizard-types.ts`.
+ *   - Default real-I/O implementations + `rollbackWrites` + `majorMinor`
+ *     live in `setup-wizard-defaults.ts`.
+ *   - The CLI dispatcher + main-guard live in `setup-cli.ts`.
+ *
+ * @license MIT
+ */
+import type { AuthProbeResult, HandshakeResult, HealthProbeResult, WizardAnswers, WizardDeps, WriteResult } from './setup-wizard-types.js';
+export { DEFAULT_WIZARD_DEPS, majorMinor } from './setup-wizard-defaults.js';
+export type { AuthProbeResult, HandshakeResult, HealthProbeResult, WizardAnswers, WizardDeps, WriteResult, };
+/**
+ * Run the interactive setup wizard. Returns a process exit-code so the
+ * outer dispatcher can `process.exit(rc)` cleanly.
+ *
+ * Exit codes:
+ *   0  — success (configs written, handshake OK)
+ *   1  — invalid input that prevents proceeding
+ *   2  — health probe failed and user declined to continue
+ *   3  — auth probe failed and user declined to continue
+ *   4  — write failed; configs rolled back
+ *   5  — handshake failed; configs rolled back
+ *   130 — user cancelled (matches the SIGINT convention)
+ */
+export declare function runWizard(deps?: WizardDeps): Promise<number>;
+//# sourceMappingURL=setup-wizard.d.ts.map

package/dist/setup-wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-wizard.d.ts","sourceRoot":"","sources":["../src/setup-wizard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAUH,OAAO,KAAK,EACR,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,WAAW,EACd,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7E,YAAY,EACR,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,WAAW,GACd,CAAC;AAIF;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAC3B,IAAI,GAAE,UAAgC,GACvC,OAAO,CAAC,MAAM,CAAC,CAyJjB"}

package/dist/setup-wizard.js

@@ -0,0 +1,166 @@
+/**
+ * Interactive setup wizard for `@wootsup/yt-builder-mcp`.
+ *
+ * `runWizard()` accepts a {@link WizardDeps} bag so unit tests can drive
+ * a deterministic prompt → validate → probe → write → handshake sequence
+ * without touching real subprocesses or filesystems.
+ *
+ * After the Round-1 audit I5 fix, this file is the wizard ALGORITHM only:
+ *   - `WizardDeps` and its result types live in `setup-wizard-types.ts`.
+ *   - Default real-I/O implementations + `rollbackWrites` + `majorMinor`
+ *     live in `setup-wizard-defaults.ts`.
+ *   - The CLI dispatcher + main-guard live in `setup-cli.ts`.
+ *
+ * @license MIT
+ */
+import { cancel, log, note, outro, spinner } from '@clack/prompts';
+import { SERVER_NAME, SERVER_VERSION } from './server.js';
+import { DEFAULT_WIZARD_DEPS, rollbackWrites, } from './setup-wizard-defaults.js';
+// Re-export the public surface so `import { runWizard, WizardDeps } from
+// './setup-wizard.js'` continues to work without touching the split files.
+export { DEFAULT_WIZARD_DEPS, majorMinor } from './setup-wizard-defaults.js';
+const SERVER_KEY = 'yootheme-builder';
+/**
+ * Run the interactive setup wizard. Returns a process exit-code so the
+ * outer dispatcher can `process.exit(rc)` cleanly.
+ *
+ * Exit codes:
+ *   0  — success (configs written, handshake OK)
+ *   1  — invalid input that prevents proceeding
+ *   2  — health probe failed and user declined to continue
+ *   3  — auth probe failed and user declined to continue
+ *   4  — write failed; configs rolled back
+ *   5  — handshake failed; configs rolled back
+ *   130 — user cancelled (matches the SIGINT convention)
+ */
+export async function runWizard(deps = DEFAULT_WIZARD_DEPS) {
+    const logFn = deps.log ?? ((line) => process.stderr.write(`${line}\n`));
+    // 1. Detect clients + collect answers.
+    const detected = deps.detectClients();
+    const answers = await deps.prompt({ detected });
+    if (answers === null)
+        return 130;
+    if (answers.wpUrl === '' || answers.bearer === '') {
+        logFn('Both the WordPress URL and the Bearer key are required.');
+        return 1;
+    }
+    // 2a. Identity probe (no auth) — confirms the URL hosts our plugin
+    //     and cross-checks against the URL the user entered. Optional
+    //     dep for back-compat: missing field = skip (older WizardDeps
+    //     bags + pre-6.5 plugins don't expose it).
+    if (deps.probeIdentity !== undefined) {
+        const idSpinner = spinner();
+        idSpinner.start('Verifying plugin identity…');
+        const identity = await deps.probeIdentity(answers.wpUrl);
+        if (identity.ok) {
+            const summary = identity.siteurl !== undefined
+                ? `Plugin identified at ${identity.siteurl}.`
+                : 'Plugin identified.';
+            idSpinner.stop(summary);
+            if (identity.siteurl !== undefined && identity.siteurl !== answers.wpUrl) {
+                log.warn(`URL mismatch: you entered ${answers.wpUrl} but the plugin reports its canonical URL as ${identity.siteurl}. ` +
+                    `Using the URL you entered — fix the mismatch if you get auth errors.`);
+            }
+        }
+        else {
+            idSpinner.stop('Identity probe failed.');
+            log.warn(`Identity probe: ${identity.error ?? 'unknown'} (continuing — older plugins lack this endpoint).`);
+        }
+    }
+    // 2b. Health probe (no auth).
+    const healthSpinner = spinner();
+    healthSpinner.start('Probing plugin health…');
+    const health = await deps.probeHealth(answers.wpUrl);
+    if (health.ok) {
+        healthSpinner.stop(health.pluginVersion !== undefined
+            ? `Plugin reachable (v${health.pluginVersion}).`
+            : 'Plugin reachable.');
+    }
+    else {
+        healthSpinner.stop('Plugin probe failed.');
+        log.error(`Could not reach the plugin: ${health.error ?? 'unknown'}`);
+        const cont = await deps.confirmContinue('Continue anyway and write the config? (You can fix this later.)');
+        if (!cont) {
+            cancel('Setup cancelled.');
+            return 2;
+        }
+    }
+    // 3. Auth probe (Bearer).
+    const authSpinner = spinner();
+    authSpinner.start('Verifying Bearer key…');
+    const auth = await deps.probeAuth(answers.wpUrl, answers.bearer);
+    const authOk = auth.ok;
+    if (authOk) {
+        authSpinner.stop('Bearer key accepted.');
+    }
+    else {
+        authSpinner.stop('Bearer probe failed.');
+        log.warn(`Auth probe failed: ${auth.error ?? 'unknown'}`);
+        const cont = await deps.confirmContinue('Continue anyway and write the config?');
+        if (!cont) {
+            cancel('Setup cancelled.');
+            return 3;
+        }
+    }
+    // 4. Write configs. Track previous content for rollback.
+    const serverConfig = {
+        command: 'npx',
+        args: ['-y', SERVER_NAME],
+        env: {
+            YTB_MCP_WP_URL: answers.wpUrl,
+            YTB_MCP_BEARER_TOKEN: answers.bearer,
+        },
+    };
+    const writes = [];
+    let writeFailed = false;
+    for (const id of answers.selectedClients) {
+        const result = await deps.writeClient(id, SERVER_KEY, serverConfig);
+        writes.push(result);
+        if (!result.ok) {
+            writeFailed = true;
+            break;
+        }
+    }
+    const summary = writes
+        .map((r) => r.ok
+        ? `  ✓ ${r.label}: configured`
+        : `  ✗ ${r.label}: FAILED (${r.error ?? 'unknown'})`)
+        .join('\n');
+    note(summary, 'Results');
+    if (writeFailed) {
+        log.error('Write failed — rolling back any partial writes.');
+        await rollbackWrites(writes, logFn);
+        return 4;
+    }
+    // 5. Dist-tag handshake (only when auth probe succeeded — there's
+    // no point handshaking with a known-bad token).
+    if (authOk) {
+        const hsSpinner = spinner();
+        hsSpinner.start('Verifying dist-tag handshake…');
+        const hs = await deps.handshake(answers.wpUrl, answers.bearer, SERVER_VERSION);
+        if (!hs.ok) {
+            hsSpinner.stop('Handshake failed.');
+            log.error(`Handshake failed after writing configs: ${hs.error ?? 'unknown'}. Rolling back.`);
+            await rollbackWrites(writes, logFn);
+            return 5;
+        }
+        if (hs.warning !== undefined) {
+            hsSpinner.stop('Handshake OK (with warning).');
+            log.warn(hs.warning);
+        }
+        else {
+            hsSpinner.stop('Handshake OK.');
+        }
+    }
+    else {
+        log.warn('Skipping handshake because the Bearer probe failed.');
+    }
+    if (writes.every((r) => r.ok) && authOk) {
+        outro('Done — restart your AI client to load the new MCP server.');
+    }
+    else {
+        outro('Setup finished with warnings. See the messages above.');
+    }
+    return 0;
+}
+//# sourceMappingURL=setup-wizard.js.map

package/dist/setup-wizard.js.map

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

package/dist/setup.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Backwards-compat entry point for `npx -y @wootsup/yt-builder-mcp setup`.
+ *
+ * The Wave G.7 refactor moved the wizard implementation into
+ * {@link runWizard} (with dependency injection so it's unit-testable)
+ * and the subcommand dispatcher into {@link runCli}, both in
+ * `./setup-cli.ts`. This file remains so the published `bin/`
+ * shim that does `import('../dist/setup.js')` still works after a
+ * partial deploy where only the published tarball is updated; it
+ * simply forwards to `runWizard()`.
+ *
+ * `YTB_MCP_TEST_MODE=1` short-circuits the wizard for smoke tests.
+ *
+ * @license MIT
+ */
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/dist/setup.js

@@ -0,0 +1,33 @@
+/**
+ * Backwards-compat entry point for `npx -y @wootsup/yt-builder-mcp setup`.
+ *
+ * The Wave G.7 refactor moved the wizard implementation into
+ * {@link runWizard} (with dependency injection so it's unit-testable)
+ * and the subcommand dispatcher into {@link runCli}, both in
+ * `./setup-cli.ts`. This file remains so the published `bin/`
+ * shim that does `import('../dist/setup.js')` still works after a
+ * partial deploy where only the published tarball is updated; it
+ * simply forwards to `runWizard()`.
+ *
+ * `YTB_MCP_TEST_MODE=1` short-circuits the wizard for smoke tests.
+ *
+ * @license MIT
+ */
+import { runWizard } from './setup-cli.js';
+const TEST_MODE = process.env.YTB_MCP_TEST_MODE === '1';
+async function run() {
+    if (TEST_MODE) {
+        process.stderr.write('[yt-builder-mcp setup] Test mode — exiting after banner.\n');
+        return;
+    }
+    const code = await runWizard();
+    if (code !== 0) {
+        process.exit(code);
+    }
+}
+run().catch((e) => {
+    const message = e instanceof Error ? e.message : String(e);
+    process.stderr.write(`[yt-builder-mcp setup] fatal: ${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,GAAG,CAAC;AAExD,KAAK,UAAU,GAAG;IACd,IAAI,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;QACnF,OAAO;IACX,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,SAAS,EAAE,CAAC;IAC/B,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;AACL,CAAC;AAED,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;IACvB,MAAM,OAAO,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,OAAO,IAAI,CAAC,CAAC;IACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,24 @@
+/**
+ * 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 type { RestClient } from '../../client.js';
+import { type AnyToolDefinition } from '../tool-builder.js';
+import { type ElementsHandlerDeps } 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 declare function buildElementsTools(client: RestClient, deps?: Partial<ElementsHandlerDeps>): readonly AnyToolDefinition[];
+//# sourceMappingURL=builders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/elements/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,OAAO,EAMH,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGH,KAAK,mBAAmB,EAQ3B,MAAM,eAAe,CAAC;AAEvB;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,UAAU,EAClB,IAAI,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACpC,SAAS,iBAAiB,EAAE,CAgJ9B"}

package/dist/tools/elements/builders.js

@@ -0,0 +1,150 @@
+/**
+ * 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 { ELEMENT_PATH, ETAG, PROPS, TEMPLATE_ID } from '../shared-schemas.js';
+import { FIELDS } from '../sparse-fields.js';
+import { creating, defineTool, destructive, mutating, readOnly, } from '../tool-builder.js';
+import { ELEMENT_GET_OUTPUT_SCHEMA, ELEMENT_LIST_OUTPUT_SCHEMA, handleElementAdd, handleElementClone, handleElementDelete, handleElementGet, handleElementList, handleElementMove, handleElementUpdateSettings, } 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(client, deps) {
+    const handlerDeps = {
+        client,
+        elicitation: deps?.elicitation,
+    };
+    return [
+        defineTool({
+            name: 'yootheme_builder_element_list',
+            description: 'List all elements in a template as a flat array with JSON-Pointer paths + ' +
+                'element types. Best starting-point for "find the element I want to edit". ' +
+                'Pass `fields:["path","element_type"]` to narrow each row.',
+            inputSchema: {
+                template_id: TEMPLATE_ID,
+                fields: FIELDS,
+            },
+            outputSchema: ELEMENT_LIST_OUTPUT_SCHEMA,
+            annotations: readOnly('List Elements'),
+            handler: (input) => handleElementList(handlerDeps, input),
+        }),
+        defineTool({
+            name: 'yootheme_builder_element_get',
+            description: 'Get the full element object at a specific JSON-Pointer path, including props ' +
+                'and children. Use yootheme_builder_element_list to discover paths.',
+            inputSchema: {
+                template_id: TEMPLATE_ID,
+                element_path: ELEMENT_PATH,
+            },
+            outputSchema: ELEMENT_GET_OUTPUT_SCHEMA,
+            annotations: readOnly('Get Element'),
+            handler: (input) => handleElementGet(handlerDeps, input),
+        }),
+        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`. Returns the new element\'s JSON-Pointer path. Requires ETag.',
+            inputSchema: {
+                template_id: TEMPLATE_ID,
+                parent_path: z
+                    .string()
+                    .default('')
+                    .describe('JSON-Pointer of the parent node ("" for template root, ' +
+                    '"/0/children/2" for nested). Use yootheme_builder_element_list to find.'),
+                element_type: z
+                    .string()
+                    .min(1)
+                    .describe('Type of element to create (e.g. "headline", "text", "grid"). ' +
+                    'Use yootheme_builder_element_types_list for the catalogue.'),
+                props: PROPS.optional(),
+                children: z
+                    .array(z.record(z.string(), z.unknown()))
+                    .optional()
+                    .describe('Optional initial children — array of element objects.'),
+                etag: ETAG,
+            },
+            annotations: creating('Add Element'),
+            handler: (input, extra) => handleElementAdd(handlerDeps, input, extra),
+        }),
+        defineTool({
+            name: 'yootheme_builder_element_update_settings',
+            description: 'Replace the `props` on an element. Use this for any setting change — title, ' +
+                'margins, classes, sources, etc. Requires ETag. Existing props NOT in the ' +
+                'request are removed.',
+            inputSchema: {
+                template_id: TEMPLATE_ID,
+                element_path: ELEMENT_PATH,
+                props: PROPS,
+                etag: ETAG,
+            },
+            annotations: mutating('Update Element Settings'),
+            handler: (input, extra) => handleElementUpdateSettings(handlerDeps, input, extra),
+        }),
+        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). Requires ETag.',
+            inputSchema: {
+                template_id: TEMPLATE_ID,
+                element_path: ELEMENT_PATH,
+                to_parent_path: z
+                    .string()
+                    .describe('Destination parent JSON-Pointer ("" for template root).'),
+                to_index: z
+                    .number()
+                    .int()
+                    .min(0)
+                    .describe('Zero-based index within the destination parent.'),
+                etag: ETAG,
+            },
+            annotations: mutating('Move Element'),
+            handler: (input, extra) => handleElementMove(handlerDeps, input, extra),
+        }),
+        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. Requires ETag.',
+            inputSchema: {
+                template_id: TEMPLATE_ID,
+                element_path: ELEMENT_PATH,
+                etag: ETAG,
+            },
+            annotations: creating('Clone Element'),
+            handler: (input, extra) => handleElementClone(handlerDeps, input, extra),
+        }),
+        defineTool({
+            name: 'yootheme_builder_element_delete',
+            description: 'PERMANENTLY delete an element and all its children. Cannot be undone. Always ' +
+                'ask the user to confirm first, then call again with `confirm: true`. Requires ' +
+                'ETag.',
+            inputSchema: {
+                template_id: TEMPLATE_ID,
+                element_path: ELEMENT_PATH,
+                etag: ETAG,
+                confirm: z
+                    .boolean()
+                    .optional()
+                    .describe('Must be true to execute. 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`.'),
+            },
+            annotations: destructive('Delete Element'),
+            handler: (input, extra) => handleElementDelete(handlerDeps, input, extra),
+        }),
+    ];
+}
+//# sourceMappingURL=builders.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * 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>;
+    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

@@ -0,0 +1 @@
+{"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,IAAI,EAAE,MAAM,CAAC;CAChB,EACD,KAAK,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAsBrB;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

@@ -0,0 +1,141 @@
+/**
+ * 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, 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.put(`/pages/${encodeURIComponent(template_id)}/elements/${encoded}/settings`, { body: { props }, 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, fetch via yootheme_builder_element_get ' +
+                'first and pass the merged result.',
+        });
+    }
+}
+// ─── 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