@wootsup/yt-builder-mcp 1.1.0 → 1.1.5

package/dist/tools/elements/handlers.js

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

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

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

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

@@ -1,28 +0,0 @@
-/**
- * Element-tool barrel — public entry-point for the 7 element tools.
- *
- *   yootheme_builder_element_list
- *      → list all elements in a template (flat, with paths)
- *   yootheme_builder_element_get
- *      → fetch one element by JSON-Pointer
- *   yootheme_builder_element_add
- *      → POST new element
- *   yootheme_builder_element_update_settings
- *      → PUT props on an existing element
- *   yootheme_builder_element_move
- *      → relocate within tree
- *   yootheme_builder_element_clone
- *      → duplicate as sibling
- *   yootheme_builder_element_delete   (destructive — elicit/confirm)
- *
- * Wave G.4.0 — file split from the monolithic `src/tools/elements.ts`
- * (382 LoC) into `index.ts` (this file, re-exports), `builders.ts`
- * (defineTool factory list, ≤200 LoC), and `handlers.ts` (handler
- * bodies, ≤300 LoC). Tool surface is unchanged — see
- * `tests/tools/elements-split.test.ts` for the snapshot proof.
- *
- * @license MIT
- */
-export { buildElementsTools } from './builders.js';
-export type { ElementsHandlerDeps } from './handlers.js';
-//# sourceMappingURL=index.d.ts.map

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

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

package/dist/tools/elements/index.js

@@ -1,27 +0,0 @@
-/**
- * Element-tool barrel — public entry-point for the 7 element tools.
- *
- *   yootheme_builder_element_list
- *      → list all elements in a template (flat, with paths)
- *   yootheme_builder_element_get
- *      → fetch one element by JSON-Pointer
- *   yootheme_builder_element_add
- *      → POST new element
- *   yootheme_builder_element_update_settings
- *      → PUT props on an existing element
- *   yootheme_builder_element_move
- *      → relocate within tree
- *   yootheme_builder_element_clone
- *      → duplicate as sibling
- *   yootheme_builder_element_delete   (destructive — elicit/confirm)
- *
- * Wave G.4.0 — file split from the monolithic `src/tools/elements.ts`
- * (382 LoC) into `index.ts` (this file, re-exports), `builders.ts`
- * (defineTool factory list, ≤200 LoC), and `handlers.ts` (handler
- * bodies, ≤300 LoC). Tool surface is unchanged — see
- * `tests/tools/elements-split.test.ts` for the snapshot proof.
- *
- * @license MIT
- */
-export { buildElementsTools } from './builders.js';
-//# sourceMappingURL=index.js.map

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

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

package/dist/tools/elements.d.ts

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

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

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

package/dist/tools/elements.js

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

package/dist/tools/elements.js.map

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

package/dist/tools/elicitation.d.ts

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

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

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

@@ -1,100 +0,0 @@
-/**
- * Targeted-elicitation support (Wave G.4 — Design §3.4 / §4.18).
- *
- * Three tool sites use elicitation:
- *   - element_delete (destructive confirm)
- *   - element_unbind_source (destructive confirm)
- *   - element_bind_source (ambiguity resolution: ≥2 sources with the
- *     same `source_name` → ask the user which one)
- *
- * Architecture mirrors `~/Projekte/wootsup/packages/apimapper-mcp/src/
- * modules/apimapper/elicitation.ts` (the reference Goldstandard impl):
- *
- *   1. `toElicitationCapability(server)` — typed adapter that bridges the
- *      SDK's stricter discriminated `ElicitRequestFormParams` to the
- *      toolkit's looser `ElicitInputParams`. ONE documented cast, justified
- *      by the toolkit only ever emitting form-mode requests.
- *   2. `ElicitationCandidate` + `renderCandidateList` — a candidate is
- *      `{ id, label }`; the list renders as a readable bullet block for the
- *      mandatory non-elicitation fallback error.
- *   3. `ambiguityFallbackError` — the structured `errorResult` returned
- *      when elicitation is unavailable (unsupported client) or declined.
- *      Lists every candidate so the LLM (or operator) has an actionable
- *      recovery path: "retry with explicit param X set to one of …".
- *
- * MANDATORY non-elicitation fallback: `elicitChoice` returns `null` on a
- * client without elicitation support, on decline, and on cancel. Every
- * call site MUST then return a structured `errorResult` listing the
- * candidates with a recovery hint — never hang, never guess, never
- * silently pick.
- *
- * @license MIT
- */
-import { 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

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

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

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