@wootsup/yt-builder-mcp 1.12.0 → 2.1.0

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

@@ -1,368 +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
- */
-// ─── Element-list columns (Design §3.2 row 9) ────────────────────────
-// F-06: PATH column widened to 64 chars + 'rel_path' shows just the
-// template-layout suffix so every row stays uniquely identifiable in
-// the text table. Full path remains available in structuredContent.
-export const ELEMENTS_TABLE_COLUMNS = [
-    { key: 'rel_path', label: 'PATH', width: 48, 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: 'rel_path', label: 'PATH', width: 48, llmOnly: true },
-    { key: 'element_type', label: 'TYPE', width: 16 },
-];
-// ─── Row mapper ──────────────────────────────────────────────────────
-function asString(v) {
-    return typeof v === 'string' ? v : '';
-}
-/**
- * Defensive `has_binding` derivation used when the REST plugin does not
- * surface an explicit boolean. Mirrors `BindingSerializer::hasBinding()`
- * on the PHP side so all readers agree on the same node.
- *
- * Task #43 (2026-05-29) — Bug A: precedence flipped to match PHP.
- *   1. top-level node.source       — YT-Pro canonical, writer-1.1.13+
- *   2. props.source                — pre-1.1.13 writer slot (back-compat)
- *   3. node.source_extended        — YT4 internal cached/expanded form
- *   4. legacy plain-string source  — pre-F-13 user data
- *
- * A node is "bound" if any carrier yields either a non-empty `query.name`
- * OR at least one `props.<el>.name` field-mapping (inherit-from-parent
- * pattern — the field-bindings reference the parent iteration source via
- * the `${builder.source}` token without a local query name).
- */
-function isStructuredBinding(src) {
-    if (src === null || typeof src !== 'object')
-        return false;
-    const obj = src;
-    const query = obj.query;
-    if (query !== null && typeof query === 'object') {
-        const name = query.name;
-        if (typeof name === 'string' && name.length > 0)
-            return true;
-    }
-    // No query name — bound only if at least one props.<el>.name field-
-    // mapping is present (inherit-from-parent pattern).
-    const props = obj.props;
-    if (props !== null && typeof props === 'object') {
-        for (const k of Object.keys(props)) {
-            const v = props[k];
-            if (v !== null && typeof v === 'object') {
-                const name = v.name;
-                if (typeof name === 'string' && name.length > 0)
-                    return true;
-            }
-        }
-    }
-    return false;
-}
-/**
- * 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 function hasSourceBinding(node) {
-    if (node === null || typeof node !== 'object')
-        return false;
-    const obj = node;
-    // (1) top-level node.source — YT-Pro canonical (Task #43 — Bug A).
-    if ('source' in obj) {
-        const src = obj.source;
-        if (typeof src === 'string') {
-            if (src.length > 0)
-                return true;
-        }
-        else if (isStructuredBinding(src)) {
-            return true;
-        }
-    }
-    // (2) props.source — pre-1.1.13 writer slot (back-compat).
-    const props = obj.props;
-    if (props !== null && typeof props === 'object' && 'source' in props) {
-        const src = props.source;
-        if (typeof src === 'string') {
-            if (src.length > 0)
-                return true;
-        }
-        else if (isStructuredBinding(src)) {
-            return true;
-        }
-    }
-    // (3) node.source_extended — YT4 cached/expanded.
-    if ('source_extended' in obj && isStructuredBinding(obj.source_extended)) {
-        return true;
-    }
-    return false;
-}
-/**
- * Build the compact `binding_summary` string for a structured binding
- * object: `<query.name> ← <el>:<field>, <el>:<field>, …`. A binding with
- * no `props` field-mappings (e.g. a bare iterating query on a container)
- * summarises to just the query name. Inherit-only bindings (no query
- * name) lead with `#inherit`.
- */
-function summarizeBinding(src) {
-    if (src === null || typeof src !== 'object')
-        return String(src);
-    const obj = src;
-    const query = obj.query;
-    const queryName = query !== null && typeof query === 'object' && typeof query.name === 'string'
-        ? query.name
-        : '';
-    const leaves = [];
-    const props = obj.props;
-    if (props !== null && typeof props === 'object') {
-        for (const el of Object.keys(props)) {
-            const v = props[el];
-            if (v !== null && typeof v === 'object') {
-                const name = v.name;
-                leaves.push(`${el}:${typeof name === 'string' ? name : '?'}`);
-            }
-        }
-    }
-    const head = queryName !== '' ? queryName : '#inherit';
-    return leaves.length > 0 ? `${head} ← ${leaves.join(', ')}` : head;
-}
-/**
- * Find the binding carrier on a node and return the raw binding object +
- * a compact summary, or `null` when the node carries no binding. Carrier
- * precedence mirrors `hasSourceBinding` (YT-Pro canonical `node.source`
- * first, then the pre-1.1.13 `props.source` slot, then the YT4
- * `source_extended` cache). A bare non-empty string source (legacy
- * pre-F-13 user data) is surfaced too so it stays readable.
- */
-export function extractBinding(node) {
-    // (1) top-level node.source — YT-Pro canonical.
-    if ('source' in node) {
-        const src = node.source;
-        if (typeof src === 'string' && src.length > 0) {
-            return { carrier: 'source', source: src, binding_summary: src };
-        }
-        if (isStructuredBinding(src)) {
-            return { carrier: 'source', source: src, binding_summary: summarizeBinding(src) };
-        }
-    }
-    // (2) props.source — pre-1.1.13 writer slot (the leaf #parent shape lives here).
-    const props = node.props;
-    if (props !== null && typeof props === 'object' && 'source' in props) {
-        const src = props.source;
-        if (typeof src === 'string' && src.length > 0) {
-            return { carrier: 'props.source', source: src, binding_summary: src };
-        }
-        if (isStructuredBinding(src)) {
-            return { carrier: 'props.source', source: src, binding_summary: summarizeBinding(src) };
-        }
-    }
-    // (3) node.source_extended — YT4 cached/expanded.
-    if ('source_extended' in node && isStructuredBinding(node.source_extended)) {
-        return {
-            carrier: 'source_extended',
-            source: node.source_extended,
-            binding_summary: summarizeBinding(node.source_extended),
-        };
-    }
-    return null;
-}
-/**
- * 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.
- * - F88: when a binding carrier is present, surface the raw `source`
- *   object + a compact `binding_summary` so leaf field-bindings are
- *   readable back (and appear in `available_fields`).
- */
-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;
-    const path = asString(input.path);
-    // F-06: derive relative path by stripping `/templates/<id>/layout` prefix
-    // so the LLM table column shows uniquely-identifying suffix.
-    const relPath = path.replace(/^\/templates\/[^/]+\/layout/, '') || '/';
-    const row = {
-        path,
-        rel_path: relPath,
-        element_type: asString(input.element_type),
-        label,
-        has_binding: explicitBinding ?? hasSourceBinding(input),
-    };
-    // F13 (2026-06-09): preserve the row's `props` object when the REST
-    // plugin attached it (it does so only on `include=props`, see
-    // ElementOps::listOnTemplate). Keeping `props` lets the sparse-fields
-    // helper project nested paths (`fields:["props.content"]`) — the same
-    // capability page_get_layout flat-mode already has (flattenLayout keeps
-    // props). Without this the nested path landed in `unknown_fields` and
-    // the value never surfaced. A zero-length array (PHP `json_encode([])`
-    // on an empty map from an un-upgraded host) is normalised to `{}` so
-    // the shape stays an object, mirroring the element_get C3 defense.
-    if (Array.isArray(input.props) && input.props.length === 0) {
-        row.props = {};
-    }
-    else if (input.props !== null &&
-        typeof input.props === 'object' &&
-        !Array.isArray(input.props)) {
-        row.props = input.props;
-    }
-    // F88: surface the resolved binding so leaf field-mappings are readable
-    // back. Only emitted when a carrier is actually present — keeps unbound
-    // rows byte-identical (and out of `available_fields`).
-    const binding = extractBinding(input);
-    if (binding !== null) {
-        row.source = binding.source;
-        row.binding_summary = binding.binding_summary;
-    }
-    // N7 (2026-06-27): pass the native item-level `source_extended` carrier
-    // through verbatim when the PHP row carried it, so `fields:["source_extended"]`
-    // (and the binding map for a bound `*_item`) projects deterministically.
-    // Present only when the row is actually bound at item-level — unbound rows
-    // stay byte-identical.
-    if (input.source_extended !== null && typeof input.source_extended === 'object') {
-        row.source_extended = input.source_extended;
-    }
-    return row;
-}
-/**
- * T-D2 (customer K2, 2026-07-24): per-VALUE character cap for the Props
- * group. A single prop can carry an entire HTML/base64 blob — capping
- * length here keeps one entry from swallowing the whole card while still
- * SHOWING the value (with a visible marker) instead of hiding it the way
- * the old keys-only "+N more" summary did.
- *
- * @budget not a response budget — a per-VALUE display cap inside one entry, so
- * no class from `RESPONSE_BUDGET` applies. The response budget that governs the
- * whole leg is resolved separately by the calling tool.
- */
-const PROP_VALUE_MAX_CHARS = 200;
-/**
- * Render one prop value for the text leg. `JSON.stringify` keeps strings
- * quoted (so an embedded newline/quote never breaks the one-line-per-entry
- * layout `detailResult` renders) and keeps the type unambiguous (a string
- * "true" reads as `"true"`, not the boolean). Falls back to `String(value)`
- * for the practically-unreachable non-serializable case (e.g. a circular
- * reference). Values longer than `PROP_VALUE_MAX_CHARS` are cut with a
- * trailing `…(+N chars)` marker — never a silent, unmarked truncation.
- */
-function renderPropValue(value) {
-    let rendered;
-    try {
-        rendered = value === undefined ? 'undefined' : (JSON.stringify(value) ?? String(value));
-    }
-    catch {
-        rendered = String(value);
-    }
-    if (rendered.length <= PROP_VALUE_MAX_CHARS)
-        return rendered;
-    const hiddenChars = rendered.length - PROP_VALUE_MAX_CHARS;
-    return `${rendered.slice(0, PROP_VALUE_MAX_CHARS)}…(+${String(hiddenChars)} chars)`;
-}
-/**
- * T-D2: one `DetailEntry` per prop key, each carrying its (capped) VALUE.
- * Before this fix the Props group listed only KEYS ("content, title_element,
- * …(+2 more)"), so a value like `title_element: "h1"` never appeared in the
- * text leg — the leg most MCP clients actually hand the model, per K2 in
- * `customer-classification.md` — and reading it back needed a second
- * `element_list` round-trip even though `structuredContent.props` already
- * carried the full value. Every prop gets its own entry (no COUNT cap); only
- * the per-value LENGTH is capped, always with a visible marker.
- */
-function buildPropEntries(props) {
-    if (props === null || typeof props !== 'object')
-        return [];
-    return Object.entries(props).map(([key, value]) => ({
-        key,
-        label: key,
-        value: renderPropValue(value),
-    }));
-}
-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 : [];
-    // F88: resolve the binding from whichever carrier is present so a bound
-    // leaf surfaces a dedicated Binding group (query + leaf field mappings)
-    // instead of hiding the source inside the Props-keys summary.
-    const bindingNode = {
-        ...(payload.props !== null && typeof payload.props === 'object' && !Array.isArray(payload.props)
-            ? { props: payload.props }
-            : {}),
-        ...(payload.source !== undefined ? { source: payload.source } : {}),
-        ...(payload.source_extended !== undefined ? { source_extended: payload.source_extended } : {}),
-    };
-    const binding = extractBinding(bindingNode);
-    const propEntries = buildPropEntries(payload.props);
-    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',
-                // T-D2: one entry per prop key/VALUE (see buildPropEntries) — a
-                // props-less element still gets a placeholder row, not an empty group.
-                entries: propEntries.length > 0 ? propEntries : [{ key: 'keys', label: 'Keys', value: '(none)' }],
-            },
-            // F88: Binding group — only when the element actually carries a
-            // source. Surfaces the carrier slot + the compact summary so the
-            // agent can read back leaf field-mappings without a props dump.
-            ...(binding !== null
-                ? [
-                    {
-                        label: 'Binding',
-                        entries: [
-                            { key: 'carrier', label: 'Carrier', value: binding.carrier, format: 'code' },
-                            { key: 'summary', label: 'Summary', value: binding.binding_summary },
-                        ],
-                    },
-                ]
-                : []),
-            {
-                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

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

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

package/dist/tools/format/source-schema-format.d.ts

@@ -1,74 +0,0 @@
-/**
- * Source-schema format-sidecar — pure transforms for `source_get_schema`
- * (detail view). U4 (B2 + B6).
- *
- * The PHP REST returns the source's query methods + arguments + relations +
- * the B6 archive-context flag (one shared `SourceRegistry::getSourceSchema()`
- * engine on both platforms). This sidecar maps that envelope into a
- * `mcp-toolkit` DetailGroup tree so the LLM reads exactly WHICH relation
- * traverses Term→Posts and which argument selects the current term — turning
- * the ~25-call YOOtheme code-dive into one call.
- *
- * @license MIT
- */
-import type { DetailGroup } from '@getimo/mcp-toolkit';
-/** A single GraphQL argument descriptor on a query method / relation. */
-export interface SchemaArgument {
-    name: string;
-    type: string;
-    description: string;
-    /**
-     * B5 — the allowed values when the argument is enum-constrained, so an
-     * agent can build a valid filter/sort without guessing. PHP populates it
-     * from two truth-grounded sources (precedence): a real GraphQL EnumType's
-     * value names, else the YOOtheme customizer `metadata.fields[arg].options`
-     * panel config (the SSOT both api-mapper Flow sources and native YT content
-     * sources populate). Absent for free-form scalars (offset/limit Int, free-
-     * text date bounds, …).
-     */
-    enum_values?: string[];
-}
-/** A query method (the source field itself) + its arguments. */
-export interface SchemaQueryMethod {
-    name: string;
-    dotted_name: string;
-    arguments: SchemaArgument[];
-}
-/** A relation field on the source's inner type (Term→Posts, Post→Author, …). */
-export interface SchemaRelation {
-    name: string;
-    dotted_name: string;
-    relation_fields: string[];
-    arguments: SchemaArgument[];
-    provides_archive_context: boolean;
-}
-/** The B6 archive-context descriptor (the current-term traversal). */
-export interface SchemaArchiveContext {
-    query_method: string;
-    dotted_name: string;
-    relation_field: string;
-    current_term_arg: string;
-}
-/** The normalised source schema returned by `source_get_schema`. */
-export interface SourceSchema {
-    source_name: string;
-    label: string;
-    group: string;
-    type: string;
-    query_methods: SchemaQueryMethod[];
-    relations: SchemaRelation[];
-    provides_archive_context: boolean;
-    archive_context: SchemaArchiveContext | null;
-}
-/**
- * Normalise the REST `source_get_schema` body (or the embedded MCP body) into
- * the structured {@link SourceSchema} the handler emits as structuredContent.
- * Tolerant of both the bare schema body and a `{ schema: {...} }` wrapper.
- */
-export declare function mapSourceSchema(payload: unknown): SourceSchema;
-/** Render the source schema into a `mcp-toolkit` DetailGroup tree. */
-export declare function buildSourceSchemaDetail(schema: SourceSchema): {
-    groups: DetailGroup[];
-    title?: string;
-};
-//# sourceMappingURL=source-schema-format.d.ts.map

package/dist/tools/format/source-schema-format.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"source-schema-format.d.ts","sourceRoot":"","sources":["../../../src/tools/format/source-schema-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAoBvD,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,wBAAwB,EAAE,OAAO,CAAC;CACrC;AAED,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AAED,oEAAoE;AACpE,MAAM,WAAW,YAAY;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,wBAAwB,EAAE,OAAO,CAAC;IAClC,eAAe,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAChD;AA0ED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAiB9D;AAaD,sEAAsE;AACtE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG;IAC3D,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CA6EA"}

package/dist/tools/format/source-schema-format.js

@@ -1,208 +0,0 @@
-/**
- * Source-schema format-sidecar — pure transforms for `source_get_schema`
- * (detail view). U4 (B2 + B6).
- *
- * The PHP REST returns the source's query methods + arguments + relations +
- * the B6 archive-context flag (one shared `SourceRegistry::getSourceSchema()`
- * engine on both platforms). This sidecar maps that envelope into a
- * `mcp-toolkit` DetailGroup tree so the LLM reads exactly WHICH relation
- * traverses Term→Posts and which argument selects the current term — turning
- * the ~25-call YOOtheme code-dive into one call.
- *
- * @license MIT
- */
-function asString(v) {
-    return typeof v === 'string' ? v : '';
-}
-function asBool(v) {
-    return v === true;
-}
-/** Coerce an unknown into a list of non-empty strings (drops non-strings/empties). */
-function asStringArray(v) {
-    if (!Array.isArray(v))
-        return [];
-    const out = [];
-    for (const x of v) {
-        if (typeof x === 'string' && x !== '')
-            out.push(x);
-    }
-    return out;
-}
-function mapArguments(raw) {
-    if (!Array.isArray(raw))
-        return [];
-    const out = [];
-    for (const a of raw) {
-        if (a !== null && typeof a === 'object') {
-            const rec = a;
-            const arg = {
-                name: asString(rec.name),
-                type: asString(rec.type),
-                description: asString(rec.description),
-            };
-            // B5 — additive: only attach `enum_values` when the PHP side resolved
-            // a non-empty allowed-value set, so a free-form scalar keeps the
-            // lean {name,type,description} shape (and the strict re-parse passes).
-            const enumValues = asStringArray(rec.enum_values);
-            if (enumValues.length > 0) {
-                arg.enum_values = enumValues;
-            }
-            out.push(arg);
-        }
-    }
-    return out;
-}
-function mapQueryMethods(raw) {
-    if (!Array.isArray(raw))
-        return [];
-    const out = [];
-    for (const m of raw) {
-        if (m !== null && typeof m === 'object') {
-            const rec = m;
-            out.push({
-                name: asString(rec.name),
-                dotted_name: asString(rec.dotted_name),
-                arguments: mapArguments(rec.arguments),
-            });
-        }
-    }
-    return out;
-}
-function mapRelations(raw) {
-    if (!Array.isArray(raw))
-        return [];
-    const out = [];
-    for (const r of raw) {
-        if (r !== null && typeof r === 'object') {
-            const rec = r;
-            const fields = Array.isArray(rec.relation_fields)
-                ? rec.relation_fields.filter((x) => typeof x === 'string')
-                : [];
-            out.push({
-                name: asString(rec.name),
-                dotted_name: asString(rec.dotted_name),
-                relation_fields: fields,
-                arguments: mapArguments(rec.arguments),
-                provides_archive_context: asBool(rec.provides_archive_context),
-            });
-        }
-    }
-    return out;
-}
-function mapArchiveContext(raw) {
-    if (raw === null || typeof raw !== 'object')
-        return null;
-    const rec = raw;
-    return {
-        query_method: asString(rec.query_method),
-        dotted_name: asString(rec.dotted_name),
-        relation_field: asString(rec.relation_field),
-        current_term_arg: asString(rec.current_term_arg),
-    };
-}
-/**
- * Normalise the REST `source_get_schema` body (or the embedded MCP body) into
- * the structured {@link SourceSchema} the handler emits as structuredContent.
- * Tolerant of both the bare schema body and a `{ schema: {...} }` wrapper.
- */
-export function mapSourceSchema(payload) {
-    const root = payload !== null && typeof payload === 'object' && 'source_name' in payload
-        ? payload
-        : payload !== null && typeof payload === 'object'
-            ? payload
-            : {};
-    return {
-        source_name: asString(root.source_name),
-        label: asString(root.label),
-        group: asString(root.group),
-        type: asString(root.type),
-        query_methods: mapQueryMethods(root.query_methods),
-        relations: mapRelations(root.relations),
-        provides_archive_context: asBool(root.provides_archive_context),
-        archive_context: mapArchiveContext(root.archive_context),
-    };
-}
-/**
- * Render one argument for the text leg: `name` normally, `name=v1|v2` when its
- * allowed values are known (B5), so an agent reading the detail surface sees the
- * exact values to pass — not just the GraphQL type.
- */
-function formatArg(a) {
-    return a.enum_values !== undefined && a.enum_values.length > 0
-        ? `${a.name}=${a.enum_values.join('|')}`
-        : a.name;
-}
-/** Render the source schema into a `mcp-toolkit` DetailGroup tree. */
-export function buildSourceSchemaDetail(schema) {
-    const groups = [
-        {
-            label: 'Source',
-            entries: [
-                { key: 'source_name', label: 'Name', value: schema.source_name, format: 'badge', copyable: true },
-                { key: 'label', label: 'Label', value: schema.label, format: 'text' },
-                { key: 'group', label: 'Group', value: schema.group, format: 'text' },
-                { key: 'type', label: 'GraphQL type', value: schema.type, format: 'code' },
-                {
-                    key: 'provides_archive_context',
-                    label: 'Provides archive context',
-                    value: schema.provides_archive_context,
-                    format: 'text',
-                },
-            ],
-        },
-    ];
-    // Query-arguments group (B5) — the source field's own args + their allowed
-    // values, so sortable/filterable scalars (order, order_direction, …) and
-    // their enum values surface on the text leg, not only in structuredContent.
-    const queryArgs = schema.query_methods.flatMap((m) => m.arguments);
-    if (queryArgs.length > 0) {
-        groups.push({
-            label: 'Query arguments',
-            entries: queryArgs.map((a, i) => ({
-                key: `query_arg_${String(i)}`,
-                label: a.name,
-                value: a.type +
-                    (a.enum_values !== undefined && a.enum_values.length > 0
-                        ? ` · allowed: [${a.enum_values.join(', ')}]`
-                        : ''),
-                format: 'code',
-            })),
-        });
-    }
-    // Relations group — one entry per relation, flagging the Term→Posts one.
-    if (schema.relations.length > 0) {
-        groups.push({
-            label: 'Relations',
-            entries: schema.relations.map((r, i) => ({
-                key: `relation_${String(i)}`,
-                label: r.dotted_name,
-                value: `fields: [${r.relation_fields.join(', ')}]` +
-                    (r.arguments.length > 0 ? ` · args: [${r.arguments.map(formatArg).join(', ')}]` : '') +
-                    (r.provides_archive_context ? ' · ARCHIVE CONTEXT (current term)' : ''),
-                format: 'code',
-            })),
-        });
-    }
-    // Archive-context group — the B6 current-term binding recipe.
-    if (schema.archive_context !== null) {
-        const ac = schema.archive_context;
-        groups.push({
-            label: 'Archive context (B6 — current term)',
-            entries: [
-                { key: 'ac_dotted', label: 'Bind query.field', value: ac.dotted_name, format: 'code', copyable: true },
-                { key: 'ac_field', label: 'Relation field', value: ac.relation_field, format: 'badge' },
-                {
-                    key: 'ac_arg',
-                    label: 'Current-term arg',
-                    value: `${ac.current_term_arg}: 0`,
-                    format: 'code',
-                },
-            ],
-        });
-    }
-    return {
-        title: `Schema for ${schema.source_name}`,
-        groups,
-    };
-}
-//# sourceMappingURL=source-schema-format.js.map