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

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,56 @@
+/**
+ * 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;
+    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 }: {
+    template_id: string;
+    fields?: readonly 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

@@ -0,0 +1 @@
+{"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;;;;;iBAKrC,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;AAID,wBAAsB,iBAAiB,CACnC,EAAE,MAAM,EAAE,EAAE,mBAAmB,EAC/B,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAC7E,OAAO,CAAC,UAAU,CAAC,CA8BrB;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

@@ -0,0 +1,113 @@
+/**
+ * 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(),
+    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 ────────────────────────────────────────────────────
+export async function handleElementList({ client }, { template_id, fields }) {
+    try {
+        const data = await client.get(`/pages/${encodeURIComponent(template_id)}/elements`);
+        const raw = Array.isArray(data.elements) ? data.elements : [];
+        const mapped = raw
+            .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);
+        const toolkitResult = 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: items.length,
+            template_id,
+            ...(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

@@ -0,0 +1 @@
+{"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

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

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

package/dist/tools/elements/index.js

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

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

package/dist/tools/elements.d.ts

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

@@ -0,0 +1 @@
+{"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

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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation.d.ts","sourceRoot":"","sources":["../../src/tools/elicitation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAER,wBAAwB,EAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEjE,YAAY,EAAE,wBAAwB,EAAE,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CACnC,UAAU,EAAE,SAAS,GACtB,wBAAwB,CAe1B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,SAAS,oBAAoB,EAAE,GAAG,MAAM,CAEvF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,UAAU,CAeb"}

package/dist/tools/elicitation.js

@@ -0,0 +1,100 @@
+/**
+ * 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 { errorResult } from './tool-builder.js';
+/**
+ * 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 function toElicitationCapability(realServer) {
+    return {
+        server: {
+            elicitInput: (params) => 
+            // Cast: the toolkit only ever produces form-mode elicitation
+            // requests (verified: elicitChoice + elicitConfirmation both pass
+            // `mode: "form"` with a string/boolean `requestedSchema`). The
+            // loose `ElicitInputParams` is asserted to the SDK's
+            // `ElicitRequestFormParams` so the SDK's overloaded
+            // `elicitInput` accepts it. The runtime payload is exactly a
+            // valid form request — only the static type is widened on the
+            // toolkit side.
+            realServer.server.elicitInput(params),
+        },
+    };
+}
+/**
+ * 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 function renderCandidateList(candidates) {
+    return candidates.map((c) => `  • ${c.id} — ${c.label}`).join('\n');
+}
+/**
+ * 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 function ambiguityFallbackError(opts) {
+    const list = renderCandidateList(opts.candidates);
+    return errorResult({
+        // We piggy-back on the local errorResult shape: `error` is the
+        // human-readable message, `context` echoes inputs + candidate ids,
+        // `hint` is the recovery instruction with the full candidate list.
+        error: new Error(`Multiple ${opts.what} match — cannot pick automatically.`),
+        context: {
+            ...opts.context,
+            code: opts.code,
+            candidates: opts.candidates.map((c) => ({ id: c.id, label: c.label })),
+        },
+        hint: `Retry with an explicit \`${opts.paramName}\` set to one of:\n${list}`,
+    });
+}
+//# sourceMappingURL=elicitation.js.map

package/dist/tools/elicitation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation.js","sourceRoot":"","sources":["../../src/tools/elicitation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AASH,OAAO,EAAE,WAAW,EAAmB,MAAM,mBAAmB,CAAC;AAIjE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,uBAAuB,CACnC,UAAqB;IAErB,OAAO;QACH,MAAM,EAAE;YACJ,WAAW,EAAE,CAAC,MAAyB,EAAE,EAAE;YACvC,6DAA6D;YAC7D,kEAAkE;YAClE,+DAA+D;YAC/D,qDAAqD;YACrD,oDAAoD;YACpD,6DAA6D;YAC7D,8DAA8D;YAC9D,gBAAgB;YAChB,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,MAAiC,CAAC;SACvE;KACJ,CAAC;AACN,CAAC;AAYD;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAA2C;IAC3E,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAMtC;IACG,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClD,OAAO,WAAW,CAAC;QACf,+DAA+D;QAC/D,mEAAmE;QACnE,mEAAmE;QACnE,KAAK,EAAE,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,IAAI,qCAAqC,CAAC;QAC5E,OAAO,EAAE;YACL,GAAG,IAAI,CAAC,OAAO;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;SACzE;QACD,IAAI,EACA,4BAA4B,IAAI,CAAC,SAAS,sBAAsB,IAAI,EAAE;KAC7E,CAAC,CAAC;AACP,CAAC"}

package/dist/tools/format/elements-format.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Elements format-sidecar — pure transforms for `element_list` (table) and
+ * `element_get` (detail). Wave G.2.5 (Design §3.2 rows 9 / 10).
+ *
+ * @license MIT
+ */
+import type { DetailGroup, TableColumn } from '@getimo/mcp-toolkit';
+export declare const ELEMENTS_TABLE_COLUMNS: readonly TableColumn[];
+/** Compact columns kick in at 21+ rows — keep path + type only. */
+export declare const ELEMENTS_COMPACT_COLUMNS: readonly TableColumn[];
+/**
+ * Maps an `/elements` row to the table shape.
+ *
+ * - `label` falls back to `title` (REST surface varies — newer builds emit
+ *   `label`, older emit `title` as the human-readable name).
+ * - `has_binding` honours an explicit boolean from the REST plugin, else
+ *   derives from `props.source` presence.
+ */
+export declare function mapElementRow(input: Record<string, unknown>): Record<string, unknown>;
+interface ElementChildLike {
+    type?: unknown;
+}
+export declare function buildElementDetail(payload: {
+    path: string;
+    element_type: string;
+    props?: unknown;
+    children?: ElementChildLike[];
+    label?: string;
+}): {
+    groups: DetailGroup[];
+    title?: string;
+};
+export {};
+//# sourceMappingURL=elements-format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"elements-format.d.ts","sourceRoot":"","sources":["../../../src/tools/format/elements-format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIpE,eAAO,MAAM,sBAAsB,EAAE,SAAS,WAAW,EAKxD,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,wBAAwB,EAAE,SAAS,WAAW,EAG1D,CAAC;AAcF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgBrF;AAID,UAAU,gBAAgB;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAoBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG;IAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA4C5C"}

package/dist/tools/format/elements-format.js

@@ -0,0 +1,112 @@
+/**
+ * Elements format-sidecar — pure transforms for `element_list` (table) and
+ * `element_get` (detail). Wave G.2.5 (Design §3.2 rows 9 / 10).
+ *
+ * @license MIT
+ */
+// ─── Element-list columns (Design §3.2 row 9) ────────────────────────
+export const ELEMENTS_TABLE_COLUMNS = [
+    { key: 'path', label: 'PATH', width: 32, llmOnly: true },
+    { key: 'element_type', label: 'TYPE', width: 16 },
+    { key: 'label', label: 'LABEL', width: 28 },
+    { key: 'has_binding', label: 'BIND', width: 8 },
+];
+/** Compact columns kick in at 21+ rows — keep path + type only. */
+export const ELEMENTS_COMPACT_COLUMNS = [
+    { key: 'path', label: 'PATH', width: 32, llmOnly: true },
+    { key: 'element_type', label: 'TYPE', width: 16 },
+];
+// ─── Row mapper ──────────────────────────────────────────────────────
+function asString(v) {
+    return typeof v === 'string' ? v : '';
+}
+function hasSourceBinding(props) {
+    if (props === null || typeof props !== 'object')
+        return false;
+    const obj = props;
+    return typeof obj.source === 'string' && obj.source.length > 0;
+}
+/**
+ * Maps an `/elements` row to the table shape.
+ *
+ * - `label` falls back to `title` (REST surface varies — newer builds emit
+ *   `label`, older emit `title` as the human-readable name).
+ * - `has_binding` honours an explicit boolean from the REST plugin, else
+ *   derives from `props.source` presence.
+ */
+export function mapElementRow(input) {
+    const label = asString(input.label) !== ''
+        ? asString(input.label)
+        : asString(input.title);
+    const explicitBinding = typeof input.has_binding === 'boolean' ? input.has_binding : undefined;
+    return {
+        path: asString(input.path),
+        element_type: asString(input.element_type),
+        label,
+        has_binding: explicitBinding ?? hasSourceBinding(input.props),
+    };
+}
+function summarizeProps(props) {
+    if (props === null || typeof props !== 'object')
+        return '—';
+    const keys = Object.keys(props);
+    if (keys.length === 0)
+        return '—';
+    if (keys.length <= 6)
+        return keys.join(', ');
+    return `${keys.slice(0, 6).join(', ')}, …(+${String(keys.length - 6)} more)`;
+}
+function listChildTypes(children) {
+    if (children.length === 0)
+        return '—';
+    const seen = new Map();
+    for (const c of children) {
+        const t = typeof c.type === 'string' ? c.type : '?';
+        seen.set(t, (seen.get(t) ?? 0) + 1);
+    }
+    return [...seen.entries()].map(([t, n]) => (n > 1 ? `${t}×${String(n)}` : t)).join(', ');
+}
+export function buildElementDetail(payload) {
+    const children = Array.isArray(payload.children) ? payload.children : [];
+    return {
+        title: `Element ${payload.path}`,
+        groups: [
+            {
+                label: 'Identity',
+                entries: [
+                    { key: 'path', label: 'Path', value: payload.path, format: 'code', copyable: true },
+                    { key: 'element_type', label: 'Type', value: payload.element_type, format: 'badge' },
+                    ...(typeof payload.label === 'string' && payload.label.length > 0
+                        ? [{ key: 'label', label: 'Label', value: payload.label }]
+                        : []),
+                ],
+            },
+            {
+                label: 'Props (summary)',
+                entries: [
+                    { key: 'keys', label: 'Keys', value: summarizeProps(payload.props) },
+                ],
+            },
+            {
+                label: 'Children',
+                entries: [
+                    { key: 'count', label: 'Count', value: children.length, format: 'text' },
+                    { key: 'types', label: 'Types', value: listChildTypes(children) },
+                ],
+            },
+            {
+                label: 'Next steps',
+                entries: [
+                    {
+                        key: 'next',
+                        label: 'Suggestions',
+                        value: 'Use yootheme_builder_element_update_settings to change props, ' +
+                            'yootheme_builder_element_clone to duplicate, or ' +
+                            'yootheme_builder_element_delete to remove (requires confirm).',
+                    },
+                ],
+            },
+        ],
+    };
+}
+//# sourceMappingURL=elements-format.js.map