@wootsup/yt-builder-mcp 1.1.6 → 1.2.0

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

@@ -0,0 +1,359 @@
+/**
+ * Inspection format-sidecar — pure transforms for `element_types_list` (table)
+ * and `element_type_get_schema` (detail). Wave G.2.9 (Design §3.2 rows 11 / 12).
+ *
+ * These functions are stateless. The handlers themselves are tested separately
+ * in `tests/tools/inspection.test.ts` (shape pins on the REST URL).
+ *
+ * @license MIT
+ */
+// ─── element_types_list columns (Design §3.2 row 11) ─────────────────
+/** Full columns for `yootheme_builder_element_types_list`. */
+export const TYPES_TABLE_COLUMNS = [
+    { key: 'name', label: 'NAME', width: 24, llmOnly: true },
+    { key: 'label', label: 'LABEL', width: 28 },
+    { key: 'origin', label: 'ORIGIN', width: 14 },
+    { key: 'has_children_support', label: 'CHILDREN', width: 10 },
+];
+/** Compact columns kick in at 21+ rows — drop the boolean. */
+export const TYPES_COMPACT_COLUMNS = [
+    { key: 'name', label: 'NAME', width: 24, llmOnly: true },
+    { key: 'label', label: 'LABEL', width: 28 },
+    { key: 'origin', label: 'ORIGIN', width: 14 },
+];
+// ─── Row mapper ──────────────────────────────────────────────────────
+function asString(v) {
+    return typeof v === 'string' ? v : '';
+}
+function asBool(v) {
+    return v === true;
+}
+/**
+ * Maps an `/element-types` row to the table shape.
+ *
+ * - `has_children_support` honours an explicit boolean (the canonical
+ *   column key on the MCP-TS side). The PHP REST envelope surfaces both
+ *   `has_children` (its canonical key) AND `has_children_support` (this
+ *   alias) for every row — accept either to ride out a deploy skew where
+ *   the wp-plugin and npm-package versions are temporarily out of step.
+ *   Maria-Audit Stream C2 F-03 v2 (2026-05-22).
+ * - Falls back to presence of a `children` field on the type definition.
+ * - Missing fields default to empty.
+ */
+export function mapTypeRow(input) {
+    let explicitChildren;
+    if (typeof input.has_children_support === 'boolean') {
+        explicitChildren = input.has_children_support;
+    }
+    else if (typeof input.has_children === 'boolean') {
+        // F-03 v2: PHP wire-shape uses `has_children`; older wp-plugins
+        // may surface only this key. MCP-TS keeps `has_children_support`
+        // as the canonical column-key but accepts the PHP-side spelling.
+        explicitChildren = input.has_children;
+    }
+    return {
+        name: asString(input.name),
+        label: asString(input.label),
+        origin: asString(input.origin),
+        has_children_support: explicitChildren ?? hasChildrenField(input.children),
+    };
+}
+function hasChildrenField(v) {
+    if (Array.isArray(v))
+        return v.length > 0;
+    if (v !== null && typeof v === 'object') {
+        return Object.keys(v).length > 0;
+    }
+    return asBool(v);
+}
+/**
+ * The REST plugin exposes element types in one of three shapes:
+ *
+ *   1. F-03 v2 (current — Maria-Audit Stream C2 2026-05-22): wrapper object
+ *      `{items: [{name, label, origin, has_children, has_children_support,
+ *      …}], total, element_types: [<string>, …]}`. This is the richest
+ *      shape and the only one carrying label/origin/has_children — prefer
+ *      it always.
+ *   2. Legacy F-03 v1: wrapper object `{element_types: [<string>, …]}`
+ *      with name-only entries (older WP-plugin versions). Used as the
+ *      back-compat fallback when `items` is absent.
+ *   3. Flat array of `{name, …}` objects — never seen on the live
+ *      yt-builder-mcp REST but kept for paranoia.
+ */
+export function flattenTypesPayload(payload) {
+    if (Array.isArray(payload)) {
+        return payload.map(normalizeTypeEntry).filter((x) => x !== null);
+    }
+    if (payload !== null && typeof payload === 'object') {
+        const obj = payload;
+        // F-03 v2 preferred shape: `items[]` carries the full row.
+        // Reading from `element_types` (plain string list) drops every
+        // label/origin/has_children value before mapTypeRow ever sees
+        // them, which is the root-cause of the audit-finding.
+        if (Array.isArray(obj.items)) {
+            return obj.items.map(normalizeTypeEntry).filter((x) => x !== null);
+        }
+        if (Array.isArray(obj.element_types)) {
+            return obj.element_types.map(normalizeTypeEntry).filter((x) => x !== null);
+        }
+    }
+    return [];
+}
+function normalizeTypeEntry(entry) {
+    if (typeof entry === 'string')
+        return { name: entry };
+    if (entry !== null && typeof entry === 'object')
+        return entry;
+    return null;
+}
+// ─── Detail builder (Design §3.2 row 12) ─────────────────────────────
+function summarizeFieldKeys(fields) {
+    if (fields === null || typeof fields !== 'object')
+        return '—';
+    // `fields` is a list of {name,…} descriptors (canonical REST shape);
+    // a plain record is also tolerated for back-compat.
+    const keys = Array.isArray(fields)
+        ? fields.map((f) => {
+            if (f !== null && typeof f === 'object') {
+                const n = f.name;
+                if (typeof n === 'string')
+                    return n;
+            }
+            return '?';
+        })
+        : Object.keys(fields);
+    if (keys.length === 0)
+        return '—';
+    if (keys.length <= 8)
+        return keys.join(', ');
+    return `${keys.slice(0, 8).join(', ')}, …(+${String(keys.length - 8)} more)`;
+}
+function countFields(fields) {
+    if (fields === null || typeof fields !== 'object')
+        return 0;
+    if (Array.isArray(fields))
+        return fields.length;
+    return Object.keys(fields).length;
+}
+// F-201 (Audit 2026-05-26): cap so the rendered tabular field list cannot
+// blow the toolkit `detail` 8000-char budget. The largest element type
+// observed in the wild (`grid`) carries 148 field descriptors — at ~70
+// chars per row that would be ~10 kB which truncates. 50 rows comfortably
+// fits and the footer points the agent at `structuredContent.fields` for
+// the full list.
+const FIELD_TABLE_CAP = 50;
+function asFieldDescriptor(raw) {
+    if (raw === null || typeof raw !== 'object')
+        return null;
+    const obj = raw;
+    const name = typeof obj.name === 'string' ? obj.name : '';
+    if (name === '')
+        return null;
+    return {
+        name,
+        type: typeof obj.type === 'string' ? obj.type : '',
+        label: typeof obj.label === 'string' ? obj.label : '',
+        // F-201 follow-up (reviewer Gap 1): honour an explicit
+        // `required: true` flag on the field descriptor.
+        //
+        // Upstream-status: the live YT REST endpoint backing
+        // `element_type_get_schema` does NOT surface required-ness today
+        // (`Inspector::projectField` emits only
+        // `{name, type, label?, default?, enum?, group?}` — YT4 itself
+        // treats required-ness as UI-validation, not schema-declared).
+        // The renderer still honours the flag so the moment upstream
+        // adds a required-marker the table updates automatically with
+        // no code change here.
+        required: obj.required === true,
+    };
+}
+function normaliseFieldList(fields) {
+    if (Array.isArray(fields)) {
+        const out = [];
+        for (const raw of fields) {
+            const d = asFieldDescriptor(raw);
+            if (d !== null)
+                out.push(d);
+        }
+        return out;
+    }
+    if (fields !== null && typeof fields === 'object') {
+        // Back-compat: record-shaped (legacy back-end).
+        const out = [];
+        for (const [name, def] of Object.entries(fields)) {
+            const type = def !== null && typeof def === 'object'
+                ? (typeof def.type === 'string'
+                    ? def.type
+                    : '')
+                : '';
+            const label = def !== null && typeof def === 'object'
+                && typeof def.label === 'string'
+                ? def.label
+                : '';
+            const required = def !== null && typeof def === 'object'
+                && def.required === true;
+            out.push({ name, type, label, required });
+        }
+        return out;
+    }
+    return [];
+}
+function padRight(s, width) {
+    if (s.length >= width)
+        return s.slice(0, width);
+    return s + ' '.repeat(width - s.length);
+}
+/**
+ * F-201 (Audit 2026-05-26): render the field descriptor list as a
+ * markdown-light text table for the LLM. Layout:
+ *
+ *     NAME              | TYPE         | LABEL
+ *     ----------------- | ------------ | ----------------
+ *   * content           | editor       | Content     ← required
+ *     link              | link         | Link
+ *
+ * The leading 2-char gutter carries `* ` for required fields and two
+ * spaces for optional fields, keeping column alignment intact whether
+ * or not any row is required. A legend at the foot of the table
+ * explains the marker semantics so the LLM doesn't have to guess.
+ *
+ * Required-marker upstream-status: see `asFieldDescriptor` above — live
+ * YT REST does not surface required-ness, so the marker is dormant
+ * until upstream adds the flag. The test fixture proves the renderer
+ * is ready.
+ *
+ * Capped at FIELD_TABLE_CAP rows; large element types (`grid` = 148
+ * fields) get a footer pointing the agent at `structuredContent.fields`
+ * for the full list.
+ *
+ * Returns `undefined` when the field list is empty so the caller can
+ * skip the section entirely.
+ */
+function buildFieldTable(fields) {
+    if (fields.length === 0)
+        return undefined;
+    // Column widths: name 24, type 14, label fills remainder (cap 36).
+    const nameW = 24;
+    const typeW = 14;
+    const labelW = 36;
+    const lines = ['[Fields]'];
+    // Header row — the gutter is empty here (no row gets a `*`).
+    lines.push(`  ${padRight('NAME', nameW)} | ${padRight('TYPE', typeW)} | ${padRight('LABEL', labelW)}`);
+    lines.push(`  ${'-'.repeat(nameW)} | ${'-'.repeat(typeW)} | ${'-'.repeat(labelW)}`);
+    const visible = fields.slice(0, FIELD_TABLE_CAP);
+    let anyRequired = false;
+    for (const f of visible) {
+        const prefix = f.required ? '* ' : '  ';
+        if (f.required)
+            anyRequired = true;
+        lines.push(`${prefix}${padRight(f.name, nameW)} | ${padRight(f.type, typeW)} | ${padRight(f.label, labelW)}`);
+    }
+    // Legend: only emit when at least one visible row is required, so
+    // the common (no-required) case stays uncluttered. The literal
+    // string `* = required` is the assertion target in the test.
+    if (anyRequired) {
+        lines.push('');
+        lines.push('* = required');
+    }
+    if (fields.length > FIELD_TABLE_CAP) {
+        // Detect required-ness in the truncated tail too so the legend
+        // still fires when the only required rows are beyond the cap.
+        if (!anyRequired) {
+            const tailRequired = fields.slice(FIELD_TABLE_CAP).some((f) => f.required);
+            if (tailRequired) {
+                lines.push('');
+                lines.push('* = required');
+            }
+        }
+        const remaining = fields.length - FIELD_TABLE_CAP;
+        lines.push('');
+        lines.push(`…and ${String(remaining)} more — see structuredContent.fields for the full list.`);
+    }
+    return lines.join('\n');
+}
+export function buildTypeSchemaDetail(payload) {
+    const normalisedFields = normaliseFieldList(payload.fields);
+    const appendText = buildFieldTable(normalisedFields);
+    const groups = [
+        {
+            label: 'Identity',
+            entries: [
+                { key: 'name', label: 'Name', value: payload.name, format: 'code', copyable: true },
+                ...(typeof payload.label === 'string' && payload.label.length > 0
+                    ? [{ key: 'label', label: 'Label', value: payload.label }]
+                    : []),
+                ...(typeof payload.origin === 'string' && payload.origin.length > 0
+                    ? [{ key: 'origin', label: 'Origin', value: payload.origin, format: 'badge' }]
+                    : []),
+            ],
+        },
+        {
+            label: 'Fields (summary)',
+            entries: [
+                { key: 'count', label: 'Count', value: countFields(payload.fields), format: 'text' },
+                { key: 'keys', label: 'Keys', value: summarizeFieldKeys(payload.fields) },
+            ],
+        },
+    ];
+    if (payload.bindingContract !== undefined) {
+        const bc = payload.bindingContract;
+        const entries = [
+            { key: 'kind', label: 'Kind', value: bc.kind, format: 'badge' },
+            { key: 'pattern', label: 'Pattern', value: bc.pattern },
+        ];
+        if (typeof bc.child_type === 'string') {
+            entries.push({
+                key: 'child_type',
+                label: 'Bind on child',
+                value: bc.child_type,
+                format: 'code',
+                copyable: true,
+            });
+        }
+        if (Array.isArray(bc.binding_target_props) && bc.binding_target_props.length > 0) {
+            entries.push({
+                key: 'targets',
+                label: 'Binding target props',
+                value: bc.binding_target_props.join(', '),
+                format: 'code',
+            });
+        }
+        if (typeof bc.set_via_tool === 'string') {
+            entries.push({
+                key: 'set_via',
+                label: 'Set via',
+                value: bc.set_via_tool,
+                format: 'code',
+            });
+        }
+        if (typeof bc.discover_source_tool === 'string') {
+            entries.push({
+                key: 'discover',
+                label: 'Discover source',
+                value: bc.discover_source_tool,
+            });
+        }
+        if (Array.isArray(bc.do_not) && bc.do_not.length > 0) {
+            entries.push({
+                key: 'do_not',
+                label: 'Do NOT',
+                value: bc.do_not.map((s) => `• ${s}`).join('\n'),
+            });
+        }
+        if (bc.minimal_layout !== undefined) {
+            entries.push({
+                key: 'minimal_layout',
+                label: 'Minimal layout (canonical)',
+                value: JSON.stringify(bc.minimal_layout, null, 2),
+                format: 'code',
+            });
+        }
+        groups.push({ label: 'Binding contract (Multi-Items)', entries });
+    }
+    return {
+        title: `Element type: ${payload.name}`,
+        groups,
+        ...(appendText !== undefined ? { appendText } : {}),
+    };
+}
+//# sourceMappingURL=inspection-format.js.map

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

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

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

@@ -0,0 +1,57 @@
+/**
+ * Pages format-sidecar — pure transforms for `pages_list`, `page_get_schema`
+ * and `get_etag`. Wave G.2.1 (Design §3.2 rows 3 / 5 / 6).
+ *
+ * These functions are stateless and free of REST-client concerns so the
+ * handlers stay tiny and so the shape is asserted in unit tests
+ * (`tests/tools/format/pages-format.test.ts`) and shape-pin tests
+ * (`tests/wave-shape-pin.test.ts`).
+ *
+ * @license MIT
+ */
+import type { DetailGroup, TableColumn } from '@getimo/mcp-toolkit';
+/** Full columns for `pages_list`. */
+export declare const PAGES_TABLE_COLUMNS: readonly TableColumn[];
+/** Compact columns kick in at 21+ rows; drops `modified_at` + `type`. */
+export declare const PAGES_COMPACT_COLUMNS: readonly TableColumn[];
+export declare const SCHEMA_TABLE_COLUMNS: readonly TableColumn[];
+/**
+ * Compact columns for `page_get_schema`. Real-world templates routinely
+ * exceed 21 nodes (a typical home-page has 30–150 elements; landing pages
+ * reach 300+), so the handler ALWAYS uses these compact columns via the
+ * `detailOverride: 'compact'` argument to `tableResult` (toolkit's
+ * `resolveDetailLevel` short-circuits when given a direct level).
+ */
+export declare const SCHEMA_COMPACT_COLUMNS: readonly TableColumn[];
+/** Maps an `/pages` element to the table row shape. Missing fields default to empty.
+ *  REST returns `name` (YOOtheme's internal field name); we surface it as `label`
+ *  for LLM-friendly schemas. The legacy `label` fallback is for forward-compat
+ *  if the backend ever switches naming.
+ *
+ *  F-Frontend-URL (2026-05-25): the three frontend-URL hints carry through
+ *  the mapper unchanged. The table-renderer doesn't render them (would
+ *  blow the column budget), but the structured-content leg surfaces them
+ *  so an MCP-agent walking the response sees the per-template URL hint
+ *  without a follow-up REST call. */
+export declare function mapPageRow(input: Record<string, unknown>): Record<string, unknown>;
+/** Maps a `/pages/{id}/schema` node to the table row shape.
+ *
+ *  F-006 (2026-05-26): also surfaces `rel_path` (path minus the
+ *  `/templates/<id>/layout` prefix) so paths copied from `page_get_schema`
+ *  match the `rel_path` form emitted by `element_list` + `page_get_layout`
+ *  — agents that copy paths between tools no longer hit "no such element"
+ *  on the fully-qualified pointer. Mirrors `mapElementRow` in
+ *  `elements-format.ts`. The full `path` stays on the row for back-compat;
+ *  the table column header points at `rel_path` instead.
+ */
+export declare function mapSchemaNodeRow(input: Record<string, unknown>): Record<string, unknown>;
+/** Builds schema rows from the array returned by the REST `nodes` field. */
+export declare function buildSchemaRows(nodes: ReadonlyArray<Record<string, unknown>>): Record<string, unknown>[];
+/** Build the `detailResult` body for `get_etag`. Two groups: identity + freshness. */
+export declare function buildEtagDetail(payload: {
+    etag: string;
+    generated_at?: string;
+}): {
+    groups: DetailGroup[];
+};
+//# sourceMappingURL=pages-format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pages-format.d.ts","sourceRoot":"","sources":["../../../src/tools/format/pages-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIpE,qCAAqC;AACrC,eAAO,MAAM,mBAAmB,EAAE,SAAS,WAAW,EAMrD,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,qBAAqB,EAAE,SAAS,WAAW,EAIvD,CAAC;AAQF,eAAO,MAAM,oBAAoB,EAAE,SAAS,WAAW,EAKtD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,WAAW,EAIxD,CAAC;AA4BF;;;;;;;;;qCASqC;AACrC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAelF;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAcxF;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAC3B,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC9C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAE3B;AAID,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG;IAAE,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CA4B5B"}

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

@@ -0,0 +1,157 @@
+/**
+ * Pages format-sidecar — pure transforms for `pages_list`, `page_get_schema`
+ * and `get_etag`. Wave G.2.1 (Design §3.2 rows 3 / 5 / 6).
+ *
+ * These functions are stateless and free of REST-client concerns so the
+ * handlers stay tiny and so the shape is asserted in unit tests
+ * (`tests/tools/format/pages-format.test.ts`) and shape-pin tests
+ * (`tests/wave-shape-pin.test.ts`).
+ *
+ * @license MIT
+ */
+// ─── Pages list columns (Design §3.2 row 3) ──────────────────────────
+/** Full columns for `pages_list`. */
+export const PAGES_TABLE_COLUMNS = [
+    { key: 'id', label: 'ID', width: 36, llmOnly: true },
+    { key: 'label', label: 'NAME', width: 28 },
+    { key: 'type', label: 'TYPE', width: 12 },
+    { key: 'elements_count', label: '#EL', width: 8, align: 'right' },
+    { key: 'modified_at', label: 'MODIFIED', width: 20 },
+];
+/** Compact columns kick in at 21+ rows; drops `modified_at` + `type`. */
+export const PAGES_COMPACT_COLUMNS = [
+    { key: 'id', label: 'ID', width: 36, llmOnly: true },
+    { key: 'label', label: 'NAME', width: 28 },
+    { key: 'elements_count', label: '#EL', width: 8, align: 'right' },
+];
+// ─── Schema columns (Design §3.2 row 5 — always-compact override) ────
+// F-006 (2026-05-26): PATH column shows `rel_path` (path minus the
+// `/templates/<id>/layout` prefix) so paths copied out of page_get_schema
+// match the form element_list emits. Fully-qualified `path` remains on
+// the row for back-compat and is surfaced via structuredContent.
+export const SCHEMA_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 for `page_get_schema`. Real-world templates routinely
+ * exceed 21 nodes (a typical home-page has 30–150 elements; landing pages
+ * reach 300+), so the handler ALWAYS uses these compact columns via the
+ * `detailOverride: 'compact'` argument to `tableResult` (toolkit's
+ * `resolveDetailLevel` short-circuits when given a direct level).
+ */
+export const SCHEMA_COMPACT_COLUMNS = [
+    { key: 'rel_path', label: 'PATH', width: 48, llmOnly: true },
+    { key: 'element_type', label: 'TYPE', width: 16 },
+    { key: 'label', label: 'LABEL', width: 28 },
+];
+// ─── Row mappers ─────────────────────────────────────────────────────
+function asString(v) {
+    return typeof v === 'string' ? v : '';
+}
+function asInt(v) {
+    return typeof v === 'number' && Number.isFinite(v) ? Math.trunc(v) : 0;
+}
+function asBool(v) {
+    return v === true;
+}
+function asNullableString(v) {
+    if (typeof v === 'string') {
+        return v;
+    }
+    if (v === null) {
+        return null;
+    }
+    // Unknown / undefined → null (consistent with the server-side honest-null
+    // convention — `frontend_url: null` is meaningful, `undefined` is not).
+    return null;
+}
+/** Maps an `/pages` element to the table row shape. Missing fields default to empty.
+ *  REST returns `name` (YOOtheme's internal field name); we surface it as `label`
+ *  for LLM-friendly schemas. The legacy `label` fallback is for forward-compat
+ *  if the backend ever switches naming.
+ *
+ *  F-Frontend-URL (2026-05-25): the three frontend-URL hints carry through
+ *  the mapper unchanged. The table-renderer doesn't render them (would
+ *  blow the column budget), but the structured-content leg surfaces them
+ *  so an MCP-agent walking the response sees the per-template URL hint
+ *  without a follow-up REST call. */
+export function mapPageRow(input) {
+    return {
+        id: asString(input.id),
+        label: asString(input.name ?? input.label),
+        type: asString(input.type),
+        elements_count: asInt(input.elements_count),
+        modified_at: asString(input.modified_at),
+        // F-Frontend-URL: nullable-strings, NOT empty-string coercion —
+        // a null frontend_url is semantically different from an empty
+        // string ("not applicable" vs "we tried and got nothing"). The
+        // server emits null deliberately; the mapper preserves it.
+        frontend_url: asNullableString(input.frontend_url),
+        frontend_url_template: asNullableString(input.frontend_url_template),
+        frontend_url_description: asNullableString(input.frontend_url_description),
+    };
+}
+/** Maps a `/pages/{id}/schema` node to the table row shape.
+ *
+ *  F-006 (2026-05-26): also surfaces `rel_path` (path minus the
+ *  `/templates/<id>/layout` prefix) so paths copied from `page_get_schema`
+ *  match the `rel_path` form emitted by `element_list` + `page_get_layout`
+ *  — agents that copy paths between tools no longer hit "no such element"
+ *  on the fully-qualified pointer. Mirrors `mapElementRow` in
+ *  `elements-format.ts`. The full `path` stays on the row for back-compat;
+ *  the table column header points at `rel_path` instead.
+ */
+export function mapSchemaNodeRow(input) {
+    const path = asString(input.path);
+    // F-006: derive relative path by stripping `/templates/<id>/layout`
+    // prefix so the LLM table column shows uniquely-identifying suffix,
+    // and the `rel_path` value can be copy-pasted into `element_path` /
+    // `root_path` arguments without further trimming.
+    const relPath = path.replace(/^\/templates\/[^/]+\/layout/, '') || '/';
+    return {
+        path,
+        rel_path: relPath,
+        element_type: asString(input.element_type),
+        label: asString(input.label),
+        has_binding: asBool(input.has_binding),
+    };
+}
+/** Builds schema rows from the array returned by the REST `nodes` field. */
+export function buildSchemaRows(nodes) {
+    return nodes.map(mapSchemaNodeRow);
+}
+// ─── Detail builders ─────────────────────────────────────────────────
+/** Build the `detailResult` body for `get_etag`. Two groups: identity + freshness. */
+export function buildEtagDetail(payload) {
+    return {
+        groups: [
+            {
+                label: 'Identity',
+                entries: [
+                    {
+                        key: 'etag',
+                        label: 'ETag',
+                        value: payload.etag,
+                        format: 'code',
+                        copyable: true,
+                    },
+                ],
+            },
+            {
+                label: 'Freshness',
+                entries: [
+                    {
+                        key: 'generated_at',
+                        label: 'Generated',
+                        value: payload.generated_at ?? null,
+                        format: 'date',
+                    },
+                ],
+            },
+        ],
+    };
+}
+//# sourceMappingURL=pages-format.js.map

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

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

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

@@ -0,0 +1,44 @@
+/**
+ * Sources format-sidecar — pure transforms for `sources_list` (table) and
+ * `element_get_binding` (detail). Wave G.2.7 (Design §3.2 rows 16 / 17).
+ *
+ * @license MIT
+ */
+import type { DetailGroup, TableColumn } from '@getimo/mcp-toolkit';
+export declare const SOURCES_TABLE_COLUMNS: readonly TableColumn[];
+export interface SourceRow {
+    name: string;
+    label: string;
+    origin: string;
+    kind: string;
+}
+export declare function mapSourceRow(input: Record<string, unknown>): SourceRow;
+export declare function flattenSourcesPayload(payload: unknown): Record<string, unknown>[];
+/**
+ * F-A5-1 (v1.1.5) — Joomla content sources arrive tagged with
+ * `origin: "wordpress"` because YT Pro historically uses that group
+ * key for "host-CMS-native" sources. On Joomla that label is wrong:
+ * `Article` / `Category` / `Tag` are Joomla concepts, not WordPress.
+ *
+ * The MCP server knows the bound client's platform via
+ * {@link RestClient.getPlatform}, so we remap unconditionally:
+ *
+ *   platform === 'joomla' AND origin === 'wordpress' → 'joomla'
+ *
+ * The unconditional remap is safe in v1.x: the Joomla host plugin
+ * never serves WP-named sources (WP custom-post-type integrations
+ * don't apply on Joomla), so any row tagged `wordpress` on a Joomla
+ * site is by definition a Joomla-native source mis-labelled by the
+ * upstream group key. A server-side fix is tracked separately for
+ * v1.2; until then this keeps cross-platform agent reasoning honest.
+ */
+export declare function remapOriginForPlatform(rows: Record<string, unknown>[], platformKind: 'wordpress' | 'joomla'): Record<string, unknown>[];
+export declare function buildBindingDetail(payload: {
+    template_id: string;
+    element_path: string;
+    binding: Record<string, unknown>;
+}): {
+    groups: DetailGroup[];
+    title?: string;
+};
+//# sourceMappingURL=sources-format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sources-format.d.ts","sourceRoot":"","sources":["../../../src/tools/format/sources-format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIpE,eAAO,MAAM,qBAAqB,EAAE,SAAS,WAAW,EAKvD,CAAC;AAQF,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAYtE;AAgBD,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,OAAO,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAqB3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,YAAY,EAAE,WAAW,GAAG,QAAQ,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAU3B;AAsED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG;IAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAgG5C"}