@wootsup/yt-builder-mcp 1.1.6 → 1.2.0

package/dist/tools/elements/handlers.js

@@ -0,0 +1,292 @@
+/**
+ * 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, encodeTemplateId } from '../../client.js';
+import { RestError } from '../../errors.js';
+import { ELEMENTS_COMPACT_COLUMNS, ELEMENTS_TABLE_COLUMNS, buildElementDetail, mapElementRow, } from '../format/elements-format.js';
+import { DEFAULT_FIELDS_ELEMENT_LIST, projectFields, projectionFeedback, 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({
+    // 1.0.1 Wave-1.5 — Cold agents need to see the row shape so they know
+    // they can copy `rel_path`/`path`/`element_type`/`parent_path` straight
+    // back into the next call. All fields are optional + the row is
+    // `passthrough()` so projected/narrow `fields[]` calls still validate.
+    items: z.array(z
+        .object({
+        path: z
+            .string()
+            .optional()
+            .describe('Fully-qualified JSON-Pointer ' +
+            '(`/templates/<id>/layout/children/...`).'),
+        rel_path: z
+            .string()
+            .optional()
+            .describe('Path relative to layout root (`/children/0/...`). ' +
+            'Pass either form back as `element_path`.'),
+        element_type: z
+            .string()
+            .optional()
+            .describe("Element type (e.g. `headline`, `section`, `grid`). " +
+            "Feeds `element_add.element_type` directly."),
+        parent_path: z
+            .string()
+            .optional()
+            .describe("Path of this element's parent. Feeds `element_add.parent_path` / " +
+            "`element_move.to_parent_path` directly (rel_path form preferred)."),
+        label: z
+            .string()
+            .optional()
+            .describe('Human-readable name of the element (alias of `name`).'),
+        has_binding: z
+            .boolean()
+            .optional()
+            .describe('True when this element is dynamically bound to a data ' +
+            'source. Use `element_get_binding` for the full mapping.'),
+    })
+        .passthrough()),
+    total: z.number(),
+    template_id: z.string(),
+    // N-01: present only when the call was paginated and more rows remain.
+    next_cursor: z.string().optional(),
+    projected_fields: z.array(z.string()).optional(),
+    // F-005 fix (2026-05-25 exhaustive audit): projection-feedback so
+    // callers passing the wrong field name (e.g. `type` instead of
+    // `element_type`) get an explicit hint instead of silently-empty
+    // table columns. See sparse-fields.ts::projectionFeedback.
+    available_fields: z.array(z.string()).optional(),
+    unknown_fields: z.array(z.string()).optional(),
+});
+export const ELEMENT_GET_OUTPUT_SCHEMA = z.object({
+    template_id: z.string(),
+    element_path: z.string(),
+    element_type: z.string(),
+    label: z.string().optional(),
+    props: z.record(z.string(), z.unknown()).optional(),
+    children_count: z.number(),
+});
+// ─── element_list ────────────────────────────────────────────────────
+/**
+ * N-01 (Audit v4): build slim text-table columns from a caller-supplied
+ * `fields[]` projection. The default compact text table truncates at
+ * 2000 chars (~26 of 96 nodes); projecting to a couple of narrow
+ * columns lets the FULL node list fit in the 8000-char `full` budget.
+ *
+ * Width heuristic: paths get a wide column, everything else a modest
+ * one. Labels are uppercased for the header to match the toolkit style.
+ */
+function columnsFromFields(fields) {
+    return fields.map((key) => {
+        const isPath = key === 'path' || key === 'rel_path' || key === 'parent_path';
+        return {
+            key,
+            label: key.replace(/_/g, ' ').toUpperCase(),
+            width: isPath ? 48 : 16,
+        };
+    });
+}
+/**
+ * F-205 (Audit 2026-05-26): shape-validate a cursor token up-front.
+ *
+ * The server-side cursor format (see `ElementOps::encodeCursor`) is
+ * base64url-encoded `o:<digits>`. Accept ALSO the raw `o:<digits>`
+ * form so hand-crafted iteration scripts + tests don't break. Anything
+ * else is a typo / corrupted token and must be rejected with a
+ * structured 400 — silently returning page 1 (the pre-fix behaviour)
+ * makes cold-agents loop on invalid cursors.
+ *
+ * We deliberately do NOT validate the cursor against the actual page
+ * state (no decode + range-check) — only shape.
+ */
+function isValidCursorShape(cursor) {
+    if (cursor.length === 0)
+        return false;
+    // Form A: raw `o:<digits>`.
+    if (/^o:\d+$/.test(cursor))
+        return true;
+    // Form B: base64url (charset only). Must decode to `o:<digits>`.
+    if (!/^[A-Za-z0-9_-]+$/.test(cursor))
+        return false;
+    try {
+        const padded = cursor.replace(/-/g, '+').replace(/_/g, '/');
+        const padLen = (4 - (padded.length % 4)) % 4;
+        const decoded = Buffer.from(padded + '='.repeat(padLen), 'base64').toString('utf8');
+        return /^o:\d+$/.test(decoded);
+    }
+    catch {
+        return false;
+    }
+}
+export async function handleElementList({ client }, { template_id, fields, root_path, depth, limit, cursor, }) {
+    // F-205 (Audit 2026-05-26): validate cursor shape BEFORE the REST
+    // call so an invalid token surfaces a structured 400 instead of
+    // silently returning page 1.
+    if (typeof cursor === 'string' && cursor !== '' && !isValidCursorShape(cursor)) {
+        return errorResult({
+            error: new RestError({
+                status: 400,
+                code: 'yootheme_builder_mcp.elements.invalid_cursor',
+                message: `Invalid cursor "${cursor}" — expected an opaque token from a prior call's next_cursor.`,
+                body: null,
+            }),
+            context: { cursor, template_id },
+            hint: 'Omit `cursor` for page 1, or copy the `next_cursor` field ' +
+                "from a prior `element_list` call's response.",
+        });
+    }
+    try {
+        // N-01 (Audit-v3): forward the transport-safe scoping params as
+        // query string. The REST layer returns the pagination envelope
+        // `{items, next_cursor, total}` when `limit` is set, else the flat
+        // `{elements, total}` shape — handle both.
+        const qs = new URLSearchParams();
+        if (typeof root_path === 'string' && root_path !== '') {
+            qs.set('root_path', root_path);
+        }
+        if (typeof depth === 'number')
+            qs.set('depth', String(depth));
+        if (typeof limit === 'number')
+            qs.set('limit', String(limit));
+        if (typeof cursor === 'string' && cursor !== '')
+            qs.set('cursor', cursor);
+        const query = qs.toString();
+        const data = await client.get(`/pages/${encodeTemplateId(template_id)}/elements${query !== '' ? `?${query}` : ''}`);
+        // Paginated envelope uses `items`; flat shape uses `elements`.
+        const rawSource = Array.isArray(data.items)
+            ? data.items
+            : Array.isArray(data.elements)
+                ? data.elements
+                : [];
+        // F-206 (Audit 2026-05-26): distinguish "explicit root_path
+        // pointer not found" from "template is truly empty". Without
+        // this branch, `element_list({root_path: '/does/not/exist'})`
+        // returned `0 elements` silently — cold agents had no signal
+        // whether the pointer was a typo or the subtree empty. Only
+        // raise when (a) the caller PASSED a non-empty root_path AND
+        // (b) the REST returned 0 rows. Omitted root_path on a truly
+        // empty template stays a success.
+        if (typeof root_path === 'string' &&
+            root_path !== '' &&
+            rawSource.length === 0) {
+            return errorResult({
+                error: new RestError({
+                    status: 404,
+                    code: 'yootheme_builder_mcp.elements.unknown_root_path',
+                    message: `root_path "${root_path}" not found in template "${template_id}".`,
+                    body: null,
+                }),
+                context: { root_path, template_id },
+                hint: 'Verify via yootheme_builder_element_list (omit root_path) ' +
+                    'to discover existing JSON-Pointers in the template.',
+            });
+        }
+        const mapped = rawSource
+            .filter((x) => x !== null && typeof x === 'object')
+            .map(mapElementRow);
+        const items = projectFields(mapped, fields, DEFAULT_FIELDS_ELEMENT_LIST);
+        const echo = projectedFieldsEcho(fields, DEFAULT_FIELDS_ELEMENT_LIST);
+        const feedback = projectionFeedback(mapped, fields);
+        const unknownNote = feedback !== undefined && feedback.unknown_fields.length > 0
+            ? ` (unknown fields ignored: ${feedback.unknown_fields.join(', ')}; available: ${feedback.available_fields.join(', ')})`
+            : '';
+        // N-01 (Audit v4): when the caller passes an explicit narrow
+        // `fields[]`, render the text table from the projected (slim)
+        // rows with `full` detail (8000 chars) so the WHOLE node list
+        // survives — the default compact table caps at 2000 chars and
+        // hides ~70 of a 96-node template. Without `fields[]` keep the
+        // auto-scaling behaviour (full columns, count-driven level).
+        const hasNarrowProjection = Array.isArray(fields) && fields.length > 0;
+        const toolkitResult = hasNarrowProjection
+            ? tableResult(items, {
+                columns: columnsFromFields(fields),
+                header: (count) => `${String(count)} elements in template "${template_id}"${unknownNote}`,
+                footer: 'Use yootheme_builder_element_get <path> for full data.',
+            }, 'full')
+            : tableResult(mapped, {
+                columns: [...ELEMENTS_TABLE_COLUMNS],
+                compactColumns: [...ELEMENTS_COMPACT_COLUMNS],
+                header: (count) => `${String(count)} elements in template "${template_id}"${unknownNote}`,
+                footer: 'Use yootheme_builder_element_get <path> for full data.',
+            });
+        return structuredResult(toolkitResult, {
+            items,
+            total: typeof data.total === 'number' ? data.total : items.length,
+            template_id,
+            ...(typeof data.next_cursor === 'string' && data.next_cursor !== ''
+                ? { next_cursor: data.next_cursor }
+                : {}),
+            ...(echo !== undefined ? { projected_fields: [...echo] } : {}),
+            ...(feedback !== undefined ? {
+                available_fields: [...feedback.available_fields],
+                unknown_fields: [...feedback.unknown_fields],
+            } : {}),
+        });
+    }
+    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/${encodeTemplateId(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,40 @@
+/**
+ * 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[];
+/**
+ * True iff the node carries a source-binding. Exported so the
+ * layout-flatten helper (page_get_layout flat-mode) derives
+ * `has_binding` from the SAME logic element_list uses — one SSoT.
+ */
+export declare function hasSourceBinding(node: unknown): boolean;
+/**
+ * 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;AAOpE,eAAO,MAAM,sBAAsB,EAAE,SAAS,WAAW,EAKxD,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,wBAAwB,EAAE,SAAS,WAAW,EAG1D,CAAC;AA+CF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CA+BvD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBrF;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"}