@wootsup/yt-builder-mcp 1.0.0 → 1.0.1

package/dist/tools/sources/builders.js

@@ -1,103 +0,0 @@
-/**
- * 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 attached to an element — the bound source name, ' +
-                'the field-mappings (which source field feeds which element prop) and the ' +
-                'query arguments/directives. 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: 'Binds a Builder source to an element (sets `props.source`). Use bindingLevel ' +
-                '"item" on Multi-Items containers (grid/slideshow/switcher/…) to bind on the ' +
-                'first *_item child instead of the container itself. 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`.'),
-                field_mappings: z
-                    .record(z.string(), z.string())
-                    .optional()
-                    .describe('Optional {prop_name: source_field_name} map written to `source.props`. ' +
-                    'Pass "__node_item__" (or "__node_item__:<field>") as the value to ' +
-                    'emit YT-Pro INHERIT bindings ("Node - Item (Source/Items)" picker ' +
-                    'entry) on child *_item elements.'),
-                bindingLevel: z
-                    .enum(['auto', 'container', 'item'])
-                    .optional()
-                    .describe('Multi-Items binding level. "auto" (default): item if target is a *_item, ' +
-                    'container otherwise. "item": container targets resolve to their first ' +
-                    '*_item child. "container": binds on the container, response carries a ' +
-                    'warning because YT-Pro will clone the container N times.'),
-                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

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

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

@@ -1,28 +0,0 @@
-/**
- * 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;
-    bindingLevel?: 'auto' | 'container' | 'item';
-    field_mappings?: Record<string, 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

@@ -1 +0,0 @@
-{"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;IACb,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C,GACF,OAAO,CAAC,UAAU,CAAC,CA6ErB;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

@@ -1,129 +0,0 @@
-/**
- * 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, bindingLevel, field_mappings } = 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 (bindingLevel !== undefined) {
-        resolvedBody.bindingLevel = bindingLevel;
-    }
-    if (field_mappings !== undefined) {
-        resolvedBody.field_mappings = field_mappings;
-    }
-    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 = { ...resolvedBody, source_id: picked };
-        }
-    }
-    else {
-        resolvedBody = { ...resolvedBody, 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

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

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

@@ -1 +0,0 @@
-{"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,CAgCrB;AAID,OAAO,EACH,uBAAuB,EACvB,yBAAyB,GAC5B,MAAM,oBAAoB,CAAC"}

package/dist/tools/sources/handlers.js

@@ -1,91 +0,0 @@
-/**
- * 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 : {};
-        // F-01-Mapping (Audit v4): trust the BE-computed `has_binding`
-        // flag (BindingSerializer SSoT) — it also flips true for an
-        // item-level binding that has field_mappings but no source_name.
-        // Fall back to the source_name heuristic only when absent.
-        const hasBinding = typeof binding.has_binding === 'boolean'
-            ? binding.has_binding
-            : 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

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

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

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

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

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

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

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

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

package/dist/tools/sources.js

@@ -1,14 +0,0 @@
-/**
- * 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.js.map

package/dist/tools/sources.js.map

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

package/dist/tools/sparse-fields.d.ts

@@ -1,80 +0,0 @@
-/**
- * Sparse-fields helper — projects per-item field whitelists onto tool
- * responses and exposes per-tool default-sets that the AI client can rely
- * on when calling read tools without a `fields` parameter.
- *
- * Design references:
- *
- *   - §3.5 Sparse-Fields Adaption: 4 read tools opt-in to `fields[]`;
- *     the toolkit's `pickFields` is used directly; `projected_fields` is
- *     echoed in the result envelope so the LLM can confirm exactly which
- *     keys were kept.
- *   - §4.4.1 — when used together with `flat: true` projection runs
- *     AFTER the depth-first walk so paths are stable before narrowing.
- *
- * Reference implementation pattern: `connections.ts:721, 779-792, 810`
- * in `@wootsup/apimapper-mcp`.
- *
- * The defaults are pure constants so they can be imported, exported, and
- * asserted against in tests without any side-effects.
- *
- * @license MIT
- */
-import { z } from 'zod';
-/**
- * Optional whitelist of fields. Per Design §3.5 the cap is 40 to stop
- * runaway prompts from blowing up the request size; nested paths
- * (`props.title`) are supported by the toolkit's `pickFields`.
- */
-export declare const FIELDS: z.ZodOptional<z.ZodArray<z.ZodString>>;
-/**
- * Flag enabling client-side flattening on `page_get_layout`. When true
- * the response shape switches from `{layout, etag}` to
- * `{elements: [...], etag}` and `fields[]` projection becomes meaningful.
- */
-export declare const FLAT: z.ZodDefault<z.ZodBoolean>;
-/**
- * Default fields echoed when the caller omits `fields`. Following the
- * apimapper-mcp convention these are **echo-only** — projection itself
- * is skipped (default-all preserved) but `projected_fields` still
- * surfaces the implicit compact set so the AI can plan future requests.
- */
-export declare const DEFAULT_FIELDS_PAGES_LIST: readonly string[];
-export declare const DEFAULT_FIELDS_ELEMENT_LIST: readonly string[];
-export declare const DEFAULT_FIELDS_SCHEMA: readonly string[];
-export declare const DEFAULT_FIELDS_SOURCES_LIST: readonly string[];
-export declare const DEFAULT_FIELDS_TYPES_LIST: readonly string[];
-/**
- * element_get defaults to "all" because the AI often needs the full
- * props payload for follow-up edits; sparse projection here is opt-in
- * with nested-path support.
- */
-export declare const DEFAULT_FIELDS_ELEMENT_GET: readonly string[] | undefined;
-/**
- * Project an array of items to the requested fields. Returns items
- * unchanged when `fields` is undefined (default-all). Skips non-object
- * entries without crashing (they pass through as-is).
- *
- * @param items - The items to project.
- * @param fields - The whitelist; `undefined` skips projection.
- * @param _defaults - Per-tool default set, accepted for interface symmetry
- *   with `projectedFieldsEcho` (unused for actual projection — default-all
- *   semantics matches the apimapper-mcp reference, see `connections.ts:789`).
- */
-export declare function projectFields<T extends Record<string, unknown>>(items: readonly T[], fields: readonly string[] | undefined, _defaults: readonly string[]): T[];
-/**
- * Project a single object via the same `pickFields` rules. Returns the
- * object unchanged when `fields` is undefined.
- */
-export declare function projectFieldsSingle<T extends Record<string, unknown>>(obj: T, fields: readonly string[] | undefined, _defaults: readonly string[] | undefined): T;
-/**
- * Compute the `projected_fields` echo. Returns the caller-requested
- * fields when provided; otherwise returns the per-tool default set so
- * the AI client knows exactly which compact view it implicitly opted into.
- *
- * @returns `undefined` only when neither `requested` nor `defaults` was set
- *   (e.g. `element_get` with no opt-in) — callers should omit
- *   `projected_fields` from the structuredContent in that case.
- */
-export declare function projectedFieldsEcho(requested: readonly string[] | undefined, defaults: readonly string[] | undefined): readonly string[] | undefined;
-//# sourceMappingURL=sparse-fields.d.ts.map

package/dist/tools/sparse-fields.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sparse-fields.d.ts","sourceRoot":"","sources":["../../src/tools/sparse-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;GAIG;AACH,eAAO,MAAM,MAAM,wCASd,CAAC;AAEN;;;;GAIG;AACH,eAAO,MAAM,IAAI,4BAMZ,CAAC;AAIN;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAMtD,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,SAAS,MAAM,EAIxD,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAIlD,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,SAAS,MAAM,EAKxD,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAKtD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAAE,GAAG,SAAqB,CAAC;AAInF;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EACrC,SAAS,EAAE,SAAS,MAAM,EAAE,GAC7B,CAAC,EAAE,CAWL;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,GAAG,EAAE,CAAC,EACN,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EACrC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACzC,CAAC,CAQH;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAC/B,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EACxC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACxC,SAAS,MAAM,EAAE,GAAG,SAAS,CAI/B"}