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

package/dist/tools/progress-phases.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Wave G.5 + Round-1.5 — shared progress labels for write handlers.
+ *
+ * Two contracts coexist:
+ *
+ * ─── 2-phase (element_* mutations) ───────────────────────────────────
+ *
+ *   0/2  PHASE_SEND     — before the REST call,
+ *   2/2  PHASE_CONFIRM  — after a 2xx response.
+ *
+ * Used by the five element_* write tools (add / update_settings / move /
+ * clone / delete). Each is a single shallow `wp_option('yootheme')` write
+ * — the request completes in tens of milliseconds and there is no
+ * client-observable window between dispatch and confirmation that would
+ * benefit from a synthetic intermediate event.
+ *
+ * ─── 3-phase (page_save / page_publish) ──────────────────────────────
+ *
+ *   0/3  PHASE_SEND     — before the REST call,
+ *   1/3  PHASE_SERVER   — synthetic intermediate, emitted AFTER dispatch
+ *                         starts but BEFORE the await resolves; lets the
+ *                         MCP-client UI render a mid-flight indicator
+ *                         matching the reference UX intent without
+ *                         requiring an SSE-streaming REST endpoint.
+ *   2/3  PHASE_CONFIRM  — after a 2xx response.
+ *
+ * Reserved for the two page-level mutations (`page_save` /
+ * `page_publish`). Both trigger a save-transform pass + a full layout
+ * re-serialisation on the PHP side; on large templates this can take
+ * 500-3000 ms — well over the perceptual threshold where a mid-flight
+ * progress signal materially improves the operator experience.
+ *
+ * Round-1.5 revert: an earlier Round-1 audit amendment collapsed the
+ * page_save / page_publish handlers down to 2-phase on the grounds that
+ * the synthetic intermediate was "theatre". Thomas-mandate 2026-05-22
+ * reinstates the 3-phase contract: the intermediate is honest if it
+ * marks an observable boundary (dispatch-start → await-resolved is one
+ * such boundary even without server-side streaming, because the
+ * dispatch itself is non-blocking from the host UI's perspective).
+ *
+ * @license MIT
+ */
+export declare const PHASE_SEND = "Sending write request";
+export declare const PHASE_CONFIRM = "Confirmed by server";
+export declare const PHASE_SERVER = "Server processing";
+//# sourceMappingURL=progress-phases.d.ts.map

package/dist/tools/progress-phases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-phases.d.ts","sourceRoot":"","sources":["../../src/tools/progress-phases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAGH,eAAO,MAAM,UAAU,0BAA0B,CAAC;AAClD,eAAO,MAAM,aAAa,wBAAwB,CAAC;AAGnD,eAAO,MAAM,YAAY,sBAAsB,CAAC"}

package/dist/tools/progress-phases.js

@@ -0,0 +1,48 @@
+/**
+ * Wave G.5 + Round-1.5 — shared progress labels for write handlers.
+ *
+ * Two contracts coexist:
+ *
+ * ─── 2-phase (element_* mutations) ───────────────────────────────────
+ *
+ *   0/2  PHASE_SEND     — before the REST call,
+ *   2/2  PHASE_CONFIRM  — after a 2xx response.
+ *
+ * Used by the five element_* write tools (add / update_settings / move /
+ * clone / delete). Each is a single shallow `wp_option('yootheme')` write
+ * — the request completes in tens of milliseconds and there is no
+ * client-observable window between dispatch and confirmation that would
+ * benefit from a synthetic intermediate event.
+ *
+ * ─── 3-phase (page_save / page_publish) ──────────────────────────────
+ *
+ *   0/3  PHASE_SEND     — before the REST call,
+ *   1/3  PHASE_SERVER   — synthetic intermediate, emitted AFTER dispatch
+ *                         starts but BEFORE the await resolves; lets the
+ *                         MCP-client UI render a mid-flight indicator
+ *                         matching the reference UX intent without
+ *                         requiring an SSE-streaming REST endpoint.
+ *   2/3  PHASE_CONFIRM  — after a 2xx response.
+ *
+ * Reserved for the two page-level mutations (`page_save` /
+ * `page_publish`). Both trigger a save-transform pass + a full layout
+ * re-serialisation on the PHP side; on large templates this can take
+ * 500-3000 ms — well over the perceptual threshold where a mid-flight
+ * progress signal materially improves the operator experience.
+ *
+ * Round-1.5 revert: an earlier Round-1 audit amendment collapsed the
+ * page_save / page_publish handlers down to 2-phase on the grounds that
+ * the synthetic intermediate was "theatre". Thomas-mandate 2026-05-22
+ * reinstates the 3-phase contract: the intermediate is honest if it
+ * marks an observable boundary (dispatch-start → await-resolved is one
+ * such boundary even without server-side streaming, because the
+ * dispatch itself is non-blocking from the host UI's perspective).
+ *
+ * @license MIT
+ */
+// ── 2-phase (element_*) ─────────────────────────────────────────────
+export const PHASE_SEND = 'Sending write request';
+export const PHASE_CONFIRM = 'Confirmed by server';
+// ── 3-phase intermediate (page_save / page_publish only) ────────────
+export const PHASE_SERVER = 'Server processing';
+//# sourceMappingURL=progress-phases.js.map

package/dist/tools/progress-phases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-phases.js","sourceRoot":"","sources":["../../src/tools/progress-phases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,uEAAuE;AACvE,MAAM,CAAC,MAAM,UAAU,GAAG,uBAAuB,CAAC;AAClD,MAAM,CAAC,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAEnD,uEAAuE;AACvE,MAAM,CAAC,MAAM,YAAY,GAAG,mBAAmB,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Shared Zod schemas — Wave-6 Fix 20.
+ *
+ * Centralises the schema definitions reused across pages, elements and
+ * sources tool builders, so a description tweak lands in one place
+ * instead of three.
+ *
+ * @license MIT
+ */
+import { z } from 'zod';
+export declare const TEMPLATE_ID: z.ZodString;
+export declare const ELEMENT_PATH: z.ZodString;
+export declare const ETAG: z.ZodString;
+export declare const PROPS: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+//# sourceMappingURL=shared-schemas.d.ts.map

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

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

package/dist/tools/shared-schemas.js

@@ -0,0 +1,30 @@
+/**
+ * Shared Zod schemas — Wave-6 Fix 20.
+ *
+ * Centralises the schema definitions reused across pages, elements and
+ * sources tool builders, so a description tweak lands in one place
+ * instead of three.
+ *
+ * @license MIT
+ */
+import { z } from 'zod';
+export const TEMPLATE_ID = z
+    .string()
+    .min(1)
+    .describe('Template ID (e.g. "default"). Use yootheme_builder_pages_list to discover.');
+export const ELEMENT_PATH = z
+    .string()
+    .min(1)
+    .describe('JSON-Pointer path to the element (e.g. "/0/children/2"). Use ' +
+    'yootheme_builder_element_list to discover available paths.');
+export const ETAG = z
+    .string()
+    .min(1)
+    .describe('Optimistic-lock ETag from yootheme_builder_get_etag. Required to ' +
+    'detect concurrent edits — call get_etag first, pass the value here. ' +
+    'On 412 Precondition Failed, re-fetch the ETag and retry.');
+export const PROPS = z
+    .record(z.string(), z.unknown())
+    .describe('Element props object (e.g. `{title: "Hello", margin: "default"}`). ' +
+    'Use yootheme_builder_element_type_get_schema to discover available keys.');
+//# sourceMappingURL=shared-schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared-schemas.js","sourceRoot":"","sources":["../../src/tools/shared-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACvB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CACL,4EAA4E,CAC/E,CAAC;AAEN,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KACxB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CACL,+DAA+D;IAC3D,4DAA4D,CACnE,CAAC;AAEN,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC;KAChB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CACL,mEAAmE;IAC/D,sEAAsE;IACtE,0DAA0D,CACjE,CAAC;AAEN,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC;KACjB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;KAC/B,QAAQ,CACL,qEAAqE;IACjE,0EAA0E,CACjF,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Source-tool builders — pure `defineTool` factory list.
+ *
+ * Split out of `src/tools/sources.ts` (Wave G.4.0b). See `./handlers.ts`
+ * for the handler bodies.
+ *
+ * @license MIT
+ */
+import type { RestClient } from '../../client.js';
+import { type AnyToolDefinition } from '../tool-builder.js';
+import { type SourcesHandlerDeps } from './handlers.js';
+export declare function buildSourcesTools(client: RestClient, deps?: Partial<SourcesHandlerDeps>): readonly AnyToolDefinition[];
+//# sourceMappingURL=builders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/sources/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,OAAO,EAKH,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGH,KAAK,kBAAkB,EAK1B,MAAM,eAAe,CAAC;AAEvB,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,UAAU,EAClB,IAAI,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,SAAS,iBAAiB,EAAE,CAuF9B"}

package/dist/tools/sources/builders.js

@@ -0,0 +1,88 @@
+/**
+ * Source-tool builders — pure `defineTool` factory list.
+ *
+ * Split out of `src/tools/sources.ts` (Wave G.4.0b). See `./handlers.ts`
+ * for the handler bodies.
+ *
+ * @license MIT
+ */
+import { z } from 'zod';
+import { ELEMENT_PATH, ETAG, TEMPLATE_ID } from '../shared-schemas.js';
+import { FIELDS } from '../sparse-fields.js';
+import { defineTool, destructive, mutating, readOnly, } from '../tool-builder.js';
+import { BINDING_OUTPUT_SCHEMA, SOURCES_LIST_OUTPUT_SCHEMA, handleElementBindSource, handleElementGetBinding, handleElementUnbindSource, handleSourcesList, } from './handlers.js';
+export function buildSourcesTools(client, deps) {
+    const handlerDeps = {
+        client,
+        elicitation: deps?.elicitation,
+    };
+    return [
+        defineTool({
+            name: 'yootheme_builder_sources_list',
+            description: 'List Builder sources grouped by origin (apimapper/wordpress/' +
+                'essentials). Returns name+label per source — pick one for ' +
+                '`element_bind_source`. Pass `fields[]` to narrow each row.',
+            inputSchema: {
+                fields: FIELDS,
+            },
+            outputSchema: SOURCES_LIST_OUTPUT_SCHEMA,
+            annotations: readOnly('List Sources'),
+            handler: (input) => handleSourcesList(handlerDeps, input),
+        }),
+        defineTool({
+            name: 'yootheme_builder_element_get_binding',
+            description: 'Read the source binding (and source_config/source_args/etc.) attached to an ' +
+                'element. Returns the empty object if the element is not bound.',
+            inputSchema: {
+                template_id: TEMPLATE_ID,
+                element_path: ELEMENT_PATH,
+            },
+            outputSchema: BINDING_OUTPUT_SCHEMA,
+            annotations: readOnly('Get Source Binding'),
+            handler: (input) => handleElementGetBinding(handlerDeps, input),
+        }),
+        defineTool({
+            name: 'yootheme_builder_element_bind_source',
+            description: 'Bind a Builder source to an element (sets `props.source`). Pass ' +
+                'source_name from sources_list; pass source_id to disambiguate ' +
+                'cross-plugin name collisions. Requires ETag.',
+            inputSchema: {
+                template_id: TEMPLATE_ID,
+                element_path: ELEMENT_PATH,
+                source_name: z
+                    .string()
+                    .min(1)
+                    .describe('Source name as listed by yootheme_builder_sources_list ' +
+                    '(e.g. "wp_posts", "apimapper_my-flow").'),
+                source_id: z
+                    .string()
+                    .optional()
+                    .describe('Optional explicit "<origin>:<name>" id; skips ambiguity ' +
+                    'resolution when ≥2 sources share `source_name`.'),
+                etag: ETAG,
+            },
+            annotations: mutating('Bind Source'),
+            handler: (input) => handleElementBindSource(handlerDeps, input),
+        }),
+        defineTool({
+            name: 'yootheme_builder_element_unbind_source',
+            description: 'Remove the source binding from an element. Clears `props.source`. Destructive ' +
+                'in the sense that it may break dynamic-content rendering — always ask the ' +
+                'user to confirm. 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('Unbind Source'),
+            handler: (input) => handleElementUnbindSource(handlerDeps, input),
+        }),
+    ];
+}
+//# sourceMappingURL=builders.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builders.js","sourceRoot":"","sources":["../../../src/tools/sources/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EACH,UAAU,EACV,WAAW,EACX,QAAQ,EACR,QAAQ,GAEX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,qBAAqB,EACrB,0BAA0B,EAE1B,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,GACpB,MAAM,eAAe,CAAC;AAEvB,MAAM,UAAU,iBAAiB,CAC7B,MAAkB,EAClB,IAAkC;IAElC,MAAM,WAAW,GAAuB;QACpC,MAAM;QACN,WAAW,EAAE,IAAI,EAAE,WAAW;KACjC,CAAC;IAEF,OAAO;QACH,UAAU,CAAC;YACP,IAAI,EAAE,+BAA+B;YACrC,WAAW,EACP,8DAA8D;gBAC9D,4DAA4D;gBAC5D,4DAA4D;YAChE,WAAW,EAAE;gBACT,MAAM,EAAE,MAAM;aACjB;YACD,YAAY,EAAE,0BAA0B;YACxC,WAAW,EAAE,QAAQ,CAAC,cAAc,CAAC;YACrC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC;SAC5D,CAAC;QAEF,UAAU,CAAC;YACP,IAAI,EAAE,sCAAsC;YAC5C,WAAW,EACP,8EAA8E;gBAC9E,gEAAgE;YACpE,WAAW,EAAE;gBACT,WAAW,EAAE,WAAW;gBACxB,YAAY,EAAE,YAAY;aAC7B;YACD,YAAY,EAAE,qBAAqB;YACnC,WAAW,EAAE,QAAQ,CAAC,oBAAoB,CAAC;YAC3C,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAuB,CAAC,WAAW,EAAE,KAAK,CAAC;SAClE,CAAC;QAEF,UAAU,CAAC;YACP,IAAI,EAAE,sCAAsC;YAC5C,WAAW,EACP,kEAAkE;gBAClE,gEAAgE;gBAChE,8CAA8C;YAClD,WAAW,EAAE;gBACT,WAAW,EAAE,WAAW;gBACxB,YAAY,EAAE,YAAY;gBAC1B,WAAW,EAAE,CAAC;qBACT,MAAM,EAAE;qBACR,GAAG,CAAC,CAAC,CAAC;qBACN,QAAQ,CACL,yDAAyD;oBACrD,yCAAyC,CAChD;gBACL,SAAS,EAAE,CAAC;qBACP,MAAM,EAAE;qBACR,QAAQ,EAAE;qBACV,QAAQ,CACL,0DAA0D;oBACtD,iDAAiD,CACxD;gBACL,IAAI,EAAE,IAAI;aACb;YACD,WAAW,EAAE,QAAQ,CAAC,aAAa,CAAC;YACpC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAuB,CAAC,WAAW,EAAE,KAAK,CAAC;SAClE,CAAC;QAEF,UAAU,CAAC;YACP,IAAI,EAAE,wCAAwC;YAC9C,WAAW,EACP,gFAAgF;gBAChF,4EAA4E;gBAC5E,iCAAiC;YACrC,WAAW,EAAE;gBACT,WAAW,EAAE,WAAW;gBACxB,YAAY,EAAE,YAAY;gBAC1B,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,CAAC;qBACL,OAAO,EAAE;qBACT,QAAQ,EAAE;qBACV,QAAQ,CACL,qEAAqE;oBACjE,iEAAiE;oBACjE,wDAAwD,CAC/D;aACR;YACD,WAAW,EAAE,WAAW,CAAC,eAAe,CAAC;YACzC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,yBAAyB,CAAC,WAAW,EAAE,KAAK,CAAC;SACpE,CAAC;KACL,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Source-binding write handlers (`element_bind_source`,
+ * `element_unbind_source`).
+ *
+ * Split out of `./handlers.ts` to keep each file under the 200-LoC
+ * budget. Wave G.4.2 adds destructive-confirm elicitation;
+ * Wave G.4.3 adds ambiguity-resolution elicitation.
+ *
+ * @license MIT
+ */
+import { type ToolResult } from '../tool-builder.js';
+import type { SourcesHandlerDeps } from './handlers.js';
+export declare function handleElementBindSource({ client, elicitation }: SourcesHandlerDeps, input: {
+    template_id: string;
+    element_path: string;
+    source_name: string;
+    source_id?: string;
+    etag: string;
+}): Promise<ToolResult>;
+export declare function handleElementUnbindSource({ client, elicitation }: SourcesHandlerDeps, input: {
+    template_id: string;
+    element_path: string;
+    etag: string;
+    confirm?: boolean;
+}): Promise<ToolResult>;
+//# sourceMappingURL=handlers-bind.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handlers-bind.d.ts","sourceRoot":"","sources":["../../../src/tools/sources/handlers-bind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,OAAO,EAIH,KAAK,UAAU,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAwBxD,wBAAsB,uBAAuB,CACzC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,kBAAkB,EAC3C,KAAK,EAAE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CAChB,GACF,OAAO,CAAC,UAAU,CAAC,CAiErB;AAID,wBAAsB,yBAAyB,CAC3C,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,kBAAkB,EAC3C,KAAK,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACtF,OAAO,CAAC,UAAU,CAAC,CAoCrB"}

package/dist/tools/sources/handlers-bind.js

@@ -0,0 +1,123 @@
+/**
+ * Source-binding write handlers (`element_bind_source`,
+ * `element_unbind_source`).
+ *
+ * Split out of `./handlers.ts` to keep each file under the 200-LoC
+ * budget. Wave G.4.2 adds destructive-confirm elicitation;
+ * Wave G.4.3 adds ambiguity-resolution elicitation.
+ *
+ * @license MIT
+ */
+import { elicitChoice, elicitConfirmation } from '@getimo/mcp-toolkit';
+import { encodeElementPath } from '../../client.js';
+import { flattenSourcesPayload, mapSourceRow, } from '../format/sources-format.js';
+import { ambiguityFallbackError, } from '../elicitation.js';
+import { confirmGuard, errorResult, jsonResult, } from '../tool-builder.js';
+// ─── element_bind_source (G.4.3 — ambiguity resolution) ─────────────
+/**
+ * Look up sources matching `source_name`. Returns at most one row per
+ * (name + origin) tuple; cross-plugin name collisions yield multiple
+ * candidates that need disambiguation.
+ *
+ * TODO(v0.3): cache /sources per session to avoid the round-trip on
+ * every bind. The current "fetch on every bind" call is the only REST
+ * round-trip introduced by ambiguity resolution and dominates bind
+ * latency — see tests/perf/bind-latency.test.ts for the pin.
+ */
+async function fetchSourceCandidates(client, source_name) {
+    const data = await client.get('/sources');
+    const payload = data.sources ?? data;
+    const flat = flattenSourcesPayload(payload);
+    return flat.map(mapSourceRow).filter((r) => r.name === source_name);
+}
+export async function handleElementBindSource({ client, elicitation }, input) {
+    const { template_id, element_path, source_name, source_id, etag } = input;
+    const encoded = encodeElementPath(element_path);
+    // Wave G.4.3 — ambiguity resolution.
+    //
+    // If `source_id` is supplied, the caller has already disambiguated;
+    // skip the /sources lookup entirely.
+    //
+    // Otherwise look up rows matching `source_name`:
+    //   - 0 matches: fall through to the bind call; the REST plugin
+    //     returns its own structured 404 with a precise hint (sources
+    //     can be added between the lookup and the call).
+    //   - 1 match: unique → bind directly.
+    //   - ≥2 matches: cross-plugin collision (e.g. an apimapper flow
+    //     AND a wordpress source both named "Posts"). Elicit a choice
+    //     on supporting hosts; on unsupported hosts, return a
+    //     structured `ambiguityFallbackError` listing every candidate
+    //     so the agent can retry with `source_id`.
+    let resolvedBody = { source_name };
+    if (source_id === undefined) {
+        const candidates = await fetchSourceCandidates(client, source_name);
+        if (candidates.length > 1) {
+            const elicitCandidates = candidates.map((c) => ({
+                id: `${c.origin}:${c.name}`,
+                label: `${c.label || c.name} (${c.origin}${c.kind ? `/${c.kind}` : ''})`,
+            }));
+            const picked = elicitation
+                ? await elicitChoice(elicitation, `Multiple sources named "${source_name}" exist. Pick which ` +
+                    `one to bind to "${element_path}".`, elicitCandidates.map((c) => c.id))
+                : null;
+            if (picked === null) {
+                return ambiguityFallbackError({
+                    code: 'source_ambiguous',
+                    paramName: 'source_id',
+                    what: 'sources',
+                    candidates: elicitCandidates,
+                    context: { template_id, element_path, source_name },
+                });
+            }
+            resolvedBody = { source_name, source_id: picked };
+        }
+    }
+    else {
+        resolvedBody = { source_name, source_id };
+    }
+    try {
+        const data = await client.put(`/pages/${encodeURIComponent(template_id)}/elements/${encoded}/binding`, { body: resolvedBody, etag });
+        return jsonResult(data);
+    }
+    catch (e) {
+        return errorResult({
+            error: e,
+            context: { template_id, element_path, source_name, ...(source_id ? { source_id } : {}) },
+            hint: 'Verify source_name via yootheme_builder_sources_list. On 412 ' +
+                'refresh ETag and retry.',
+        });
+    }
+}
+// ─── element_unbind_source (destructive — G.4.2) ────────────────────
+export async function handleElementUnbindSource({ client, elicitation }, input) {
+    const { template_id, element_path, etag, confirm } = input;
+    if (confirm !== true) {
+        if (confirm === false || !elicitation) {
+            return confirmGuard({
+                operation: 'unbind source',
+                details: { template_id, element_path },
+            });
+        }
+        const accepted = await elicitConfirmation(elicitation, `Unbind the dynamic source from element "${element_path}" in template ` +
+            `"${template_id}"? This may break dynamic-content rendering.`);
+        if (!accepted) {
+            return confirmGuard({
+                operation: 'unbind source',
+                details: { template_id, element_path },
+            });
+        }
+    }
+    const encoded = encodeElementPath(element_path);
+    try {
+        const data = await client.delete(`/pages/${encodeURIComponent(template_id)}/elements/${encoded}/binding`, { etag });
+        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.',
+        });
+    }
+}
+//# sourceMappingURL=handlers-bind.js.map

package/dist/tools/sources/handlers-bind.js.map

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

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

@@ -0,0 +1,45 @@
+/**
+ * Source-binding read handlers + shared types/schemas.
+ *
+ * Split out of `src/tools/sources.ts` (Wave G.4.0b). Write handlers
+ * (`element_bind_source` with G.4.3 ambiguity resolution,
+ * `element_unbind_source` with G.4.2 elicit-confirm) live in
+ * `./handlers-bind.ts`.
+ *
+ * @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 SOURCES_LIST_OUTPUT_SCHEMA: z.ZodObject<{
+    items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    total: z.ZodNumber;
+    projected_fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const BINDING_OUTPUT_SCHEMA: z.ZodObject<{
+    template_id: z.ZodString;
+    element_path: z.ZodString;
+    binding: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    has_binding: z.ZodBoolean;
+}, z.core.$strip>;
+export interface SourcesHandlerDeps {
+    readonly client: RestClient;
+    /**
+     * Optional MCP elicitation capability. When present,
+     * `element_unbind_source` prompts for destructive confirmation and
+     * `element_bind_source` prompts for cross-plugin disambiguation
+     * via the elicitation channel. When absent, both fall back to
+     * structured-error / preview flows.
+     */
+    readonly elicitation?: McpServerWithElicitation;
+}
+export declare function handleSourcesList({ client }: SourcesHandlerDeps, { fields }: {
+    fields?: readonly string[];
+}): Promise<ToolResult>;
+export declare function handleElementGetBinding({ client }: SourcesHandlerDeps, { template_id, element_path }: {
+    template_id: string;
+    element_path: string;
+}): Promise<ToolResult>;
+export { handleElementBindSource, handleElementUnbindSource, } from './handlers-bind.js';
+//# sourceMappingURL=handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/tools/sources/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAOrE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAMlE,OAAO,EAGH,KAAK,UAAU,EAClB,MAAM,oBAAoB,CAAC;AAI5B,eAAO,MAAM,0BAA0B;;;;iBAIrC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;iBAKhC,CAAC;AAEH,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACnD;AAID,wBAAsB,iBAAiB,CACnC,EAAE,MAAM,EAAE,EAAE,kBAAkB,EAC9B,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAC3C,OAAO,CAAC,UAAU,CAAC,CA0BrB;AAID,wBAAsB,uBAAuB,CACzC,EAAE,MAAM,EAAE,EAAE,kBAAkB,EAC9B,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC7E,OAAO,CAAC,UAAU,CAAC,CAyBrB;AAID,OAAO,EACH,uBAAuB,EACvB,yBAAyB,GAC5B,MAAM,oBAAoB,CAAC"}

package/dist/tools/sources/handlers.js

@@ -0,0 +1,84 @@
+/**
+ * Source-binding read handlers + shared types/schemas.
+ *
+ * Split out of `src/tools/sources.ts` (Wave G.4.0b). Write handlers
+ * (`element_bind_source` with G.4.3 ambiguity resolution,
+ * `element_unbind_source` with G.4.2 elicit-confirm) live in
+ * `./handlers-bind.ts`.
+ *
+ * @license MIT
+ */
+import { detailResult, tableResult } from '@getimo/mcp-toolkit';
+import { z } from 'zod';
+import { encodeElementPath } from '../../client.js';
+import { SOURCES_TABLE_COLUMNS, buildBindingDetail, flattenSourcesPayload, mapSourceRow, } from '../format/sources-format.js';
+import { DEFAULT_FIELDS_SOURCES_LIST, projectFields, projectedFieldsEcho, } from '../sparse-fields.js';
+import { errorResult, structuredResult, } from '../tool-builder.js';
+// ─── outputSchemas (Wave G.2 §4) ─────────────────────────────────────
+export const SOURCES_LIST_OUTPUT_SCHEMA = z.object({
+    items: z.array(z.record(z.string(), z.unknown())),
+    total: z.number(),
+    projected_fields: z.array(z.string()).optional(),
+});
+export const BINDING_OUTPUT_SCHEMA = z.object({
+    template_id: z.string(),
+    element_path: z.string(),
+    binding: z.record(z.string(), z.unknown()),
+    has_binding: z.boolean(),
+});
+// ─── sources_list ────────────────────────────────────────────────────
+export async function handleSourcesList({ client }, { fields }) {
+    try {
+        const data = await client.get('/sources');
+        const payload = data.sources ?? data;
+        const flat = flattenSourcesPayload(payload);
+        const mapped = flat.map(mapSourceRow);
+        const mappedRecords = mapped;
+        const items = projectFields(mappedRecords, fields, DEFAULT_FIELDS_SOURCES_LIST);
+        const echo = projectedFieldsEcho(fields, DEFAULT_FIELDS_SOURCES_LIST);
+        const toolkitResult = tableResult(mappedRecords, {
+            columns: [...SOURCES_TABLE_COLUMNS],
+            header: (count) => `${String(count)} sources`,
+            footer: 'Use yootheme_builder_element_bind_source to bind one.',
+        });
+        return structuredResult(toolkitResult, {
+            items,
+            total: items.length,
+            ...(echo !== undefined ? { projected_fields: [...echo] } : {}),
+        });
+    }
+    catch (e) {
+        return errorResult({
+            error: e,
+            context: {},
+            hint: 'Run yootheme_builder_diagnose to verify auth.',
+        });
+    }
+}
+// ─── element_get_binding ─────────────────────────────────────────────
+export async function handleElementGetBinding({ client }, { template_id, element_path }) {
+    const encoded = encodeElementPath(element_path);
+    try {
+        const data = await client.get(`/pages/${encodeURIComponent(template_id)}/elements/${encoded}/binding`);
+        const binding = data !== null && typeof data === 'object' ? data : {};
+        const hasBinding = typeof binding.source_name === 'string' && binding.source_name.length > 0;
+        const toolkitResult = detailResult(buildBindingDetail({ template_id, element_path, binding }));
+        return structuredResult(toolkitResult, {
+            template_id,
+            element_path,
+            binding,
+            has_binding: hasBinding,
+        });
+    }
+    catch (e) {
+        return errorResult({
+            error: e,
+            context: { template_id, element_path },
+            hint: 'Verify element_path via yootheme_builder_element_list.',
+        });
+    }
+}
+// Re-export write handlers so builders can import everything from this
+// barrel and we keep a single `SourcesHandlerDeps` definition.
+export { handleElementBindSource, handleElementUnbindSource, } from './handlers-bind.js';
+//# sourceMappingURL=handlers.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * Source-tool barrel — public entry-point for the 4 source-binding tools.
+ *
+ *   yootheme_builder_sources_list
+ *      → list available Builder sources
+ *   yootheme_builder_element_get_binding
+ *      → read source binding on an element
+ *   yootheme_builder_element_bind_source
+ *      → set source binding (PUT; G.4.3 ambiguity resolution)
+ *   yootheme_builder_element_unbind_source
+ *      → remove binding (DELETE; G.4.2 elicit-confirm)
+ *
+ * Wave G.4.0b — split out of the original `src/tools/sources.ts`.
+ *
+ * @license MIT
+ */
+export { buildSourcesTools } from './builders.js';
+export type { SourcesHandlerDeps } from './handlers.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/sources/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/sources/index.js

@@ -0,0 +1,18 @@
+/**
+ * Source-tool barrel — public entry-point for the 4 source-binding tools.
+ *
+ *   yootheme_builder_sources_list
+ *      → list available Builder sources
+ *   yootheme_builder_element_get_binding
+ *      → read source binding on an element
+ *   yootheme_builder_element_bind_source
+ *      → set source binding (PUT; G.4.3 ambiguity resolution)
+ *   yootheme_builder_element_unbind_source
+ *      → remove binding (DELETE; G.4.2 elicit-confirm)
+ *
+ * Wave G.4.0b — split out of the original `src/tools/sources.ts`.
+ *
+ * @license MIT
+ */
+export { buildSourcesTools } from './builders.js';
+//# sourceMappingURL=index.js.map

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

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

package/dist/tools/sources.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Backwards-compatible re-export shim.
+ *
+ * Wave G.4.0b split the original 228-LoC `sources.ts` into
+ * `./sources/{index, handlers, builders}.ts` after Wave G.4.2/G.4.3
+ * added elicitation + ambiguity-resolution logic that pushed it well
+ * over the 200-LoC budget. This shim keeps the legacy import path
+ * (`from '../tools/sources.js'`) working for downstream callers and
+ * tests. New code should import from `./sources/index.js` directly.
+ *
+ * @license MIT
+ */
+export { buildSourcesTools } from './sources/index.js';
+//# sourceMappingURL=sources.d.ts.map