@wootsup/yt-builder-mcp 0.2.0-alpha.2

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

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

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

@@ -0,0 +1,73 @@
+/**
+ * Health format-sidecar — pure transforms for `yootheme_builder_health` and
+ * `yootheme_builder_diagnose`. Wave G.2.11 (Design §3.2 rows 1 / 2).
+ *
+ * Stateless helpers; the handlers themselves are tested separately in
+ * `tests/tools/health.test.ts` (probe orchestration + error paths).
+ *
+ * @license MIT
+ */
+import type { DetailGroup, StatsResultOptions } from '@getimo/mcp-toolkit';
+export interface HealthPayload {
+    plugin_version: string;
+    yootheme_version: string | null;
+    wp_version: string | null;
+    php_version: string;
+    storage_type: string;
+    storage_target: string;
+    yootheme_loaded: boolean;
+    available_endpoints: string[];
+}
+/**
+ * Build the detail body for `yootheme_builder_health`.
+ *
+ * Three groups:
+ *   1. **Plugin** — plugin_version + yootheme_loaded + yootheme_version
+ *   2. **Host**   — wp_version + php_version + storage info
+ *   3. **Endpoints** — count + a comma-separated sample (no full enumeration)
+ *
+ * Endpoint count rather than a long list keeps the detail card compact
+ * (real installs expose 16+ endpoints across pages/elements/sources/etc.).
+ */
+export declare function buildHealthDetail(payload: HealthPayload): {
+    groups: DetailGroup[];
+    title?: string;
+};
+/**
+ * Build the flat stats payload for `yootheme_builder_health` per
+ * Design-Doc §3.2 row 1 (Round-1 audit I1 fix). Returns the shape
+ * required by `@getimo/mcp-toolkit`'s `statsResult({ stats: [...] })`:
+ * a flat metric array (no nested groups) suitable for the stats-display
+ * Rich-Card variant.
+ *
+ * Metrics shipped (per Design-Doc §3.2 row 1 spec):
+ *   plugin_version, yootheme_version, wp_version, php_version,
+ *   storage_type, yootheme_loaded, endpoint_count
+ *
+ * `available_endpoints` is condensed to `endpoint_count` here — the
+ * full enumeration lives in the structuredContent payload for hosts
+ * that want it.
+ */
+export declare function buildHealthStats(payload: HealthPayload): StatsResultOptions;
+export interface DiagnoseChecks {
+    plugin_reachable: boolean;
+    plugin_version?: string;
+    yootheme_loaded?: boolean;
+    yootheme_version?: string | null;
+    endpoint_count?: number;
+    plugin_error?: string;
+    bearer_valid?: boolean;
+    bearer_error?: string;
+}
+/**
+ * Build the detail body for `yootheme_builder_diagnose`.
+ *
+ * Always 2 groups: Plugin probe + Bearer probe. The Bearer group is still
+ * present when the plugin is unreachable — its entries collapse to N/A so
+ * the structure stays stable across success / partial-fail / full-fail.
+ */
+export declare function buildDiagnoseDetail(checks: DiagnoseChecks): {
+    groups: DetailGroup[];
+    title?: string;
+};
+//# sourceMappingURL=health-format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health-format.d.ts","sourceRoot":"","sources":["../../../src/tools/format/health-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAI3E,MAAM,WAAW,aAAa;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,mBAAmB,EAAE,MAAM,EAAE,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG;IACvD,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CA0DA;AAQD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,kBAAkB,CA0C3E;AAID,MAAM,WAAW,cAAc;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG;IACzD,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CA6BA"}

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

@@ -0,0 +1,178 @@
+/**
+ * Health format-sidecar — pure transforms for `yootheme_builder_health` and
+ * `yootheme_builder_diagnose`. Wave G.2.11 (Design §3.2 rows 1 / 2).
+ *
+ * Stateless helpers; the handlers themselves are tested separately in
+ * `tests/tools/health.test.ts` (probe orchestration + error paths).
+ *
+ * @license MIT
+ */
+/**
+ * Build the detail body for `yootheme_builder_health`.
+ *
+ * Three groups:
+ *   1. **Plugin** — plugin_version + yootheme_loaded + yootheme_version
+ *   2. **Host**   — wp_version + php_version + storage info
+ *   3. **Endpoints** — count + a comma-separated sample (no full enumeration)
+ *
+ * Endpoint count rather than a long list keeps the detail card compact
+ * (real installs expose 16+ endpoints across pages/elements/sources/etc.).
+ */
+export function buildHealthDetail(payload) {
+    const endpoints = payload.available_endpoints;
+    const endpointPreview = summarizeEndpoints(endpoints);
+    return {
+        title: 'YT Builder MCP — Health',
+        groups: [
+            {
+                label: 'Plugin',
+                entries: [
+                    {
+                        key: 'plugin_version',
+                        label: 'Plugin version',
+                        value: payload.plugin_version,
+                        format: 'badge',
+                    },
+                    {
+                        key: 'yootheme_loaded',
+                        label: 'YOOtheme loaded',
+                        value: payload.yootheme_loaded,
+                        format: 'boolean',
+                    },
+                    {
+                        key: 'yootheme_version',
+                        label: 'YOOtheme version',
+                        value: payload.yootheme_version,
+                    },
+                ],
+            },
+            {
+                label: 'Host',
+                entries: [
+                    { key: 'wp_version', label: 'WordPress version', value: payload.wp_version },
+                    { key: 'php_version', label: 'PHP version', value: payload.php_version },
+                    {
+                        key: 'storage_type',
+                        label: 'Storage type',
+                        value: payload.storage_type,
+                        format: 'badge',
+                    },
+                    {
+                        key: 'storage_target',
+                        label: 'Storage target',
+                        value: payload.storage_target,
+                        format: 'code',
+                        copyable: true,
+                    },
+                ],
+            },
+            {
+                label: 'Endpoints',
+                entries: [
+                    { key: 'count', label: 'Count', value: endpoints.length, format: 'text' },
+                    { key: 'sample', label: 'Sample', value: endpointPreview },
+                ],
+            },
+        ],
+    };
+}
+function summarizeEndpoints(endpoints) {
+    if (endpoints.length === 0)
+        return '—';
+    if (endpoints.length <= 6)
+        return endpoints.join(', ');
+    return `${endpoints.slice(0, 6).join(', ')}, …(+${String(endpoints.length - 6)} more)`;
+}
+/**
+ * Build the flat stats payload for `yootheme_builder_health` per
+ * Design-Doc §3.2 row 1 (Round-1 audit I1 fix). Returns the shape
+ * required by `@getimo/mcp-toolkit`'s `statsResult({ stats: [...] })`:
+ * a flat metric array (no nested groups) suitable for the stats-display
+ * Rich-Card variant.
+ *
+ * Metrics shipped (per Design-Doc §3.2 row 1 spec):
+ *   plugin_version, yootheme_version, wp_version, php_version,
+ *   storage_type, yootheme_loaded, endpoint_count
+ *
+ * `available_endpoints` is condensed to `endpoint_count` here — the
+ * full enumeration lives in the structuredContent payload for hosts
+ * that want it.
+ */
+export function buildHealthStats(payload) {
+    return {
+        title: 'YT Builder MCP — Health',
+        stats: [
+            {
+                key: 'plugin_version',
+                label: 'Plugin version',
+                value: payload.plugin_version,
+            },
+            {
+                key: 'yootheme_version',
+                label: 'YOOtheme version',
+                value: payload.yootheme_version ?? '—',
+            },
+            {
+                key: 'wp_version',
+                label: 'WordPress version',
+                value: payload.wp_version ?? '—',
+            },
+            {
+                key: 'php_version',
+                label: 'PHP version',
+                value: payload.php_version,
+            },
+            {
+                key: 'storage_type',
+                label: 'Storage type',
+                value: payload.storage_type,
+            },
+            {
+                key: 'yootheme_loaded',
+                label: 'YOOtheme loaded',
+                value: payload.yootheme_loaded,
+            },
+            {
+                key: 'endpoint_count',
+                label: 'Endpoint count',
+                value: payload.available_endpoints.length,
+                format: 'number',
+            },
+        ],
+    };
+}
+/**
+ * Build the detail body for `yootheme_builder_diagnose`.
+ *
+ * Always 2 groups: Plugin probe + Bearer probe. The Bearer group is still
+ * present when the plugin is unreachable — its entries collapse to N/A so
+ * the structure stays stable across success / partial-fail / full-fail.
+ */
+export function buildDiagnoseDetail(checks) {
+    const pluginEntries = [
+        { key: 'plugin_reachable', label: 'Reachable', value: checks.plugin_reachable, format: 'boolean' },
+    ];
+    if (typeof checks.plugin_version === 'string')
+        pluginEntries.push({ key: 'plugin_version', label: 'Plugin version', value: checks.plugin_version, format: 'badge' });
+    if (typeof checks.yootheme_loaded === 'boolean')
+        pluginEntries.push({ key: 'yootheme_loaded', label: 'YOOtheme loaded', value: checks.yootheme_loaded, format: 'boolean' });
+    if (typeof checks.yootheme_version === 'string')
+        pluginEntries.push({ key: 'yootheme_version', label: 'YOOtheme version', value: checks.yootheme_version });
+    if (typeof checks.endpoint_count === 'number')
+        pluginEntries.push({ key: 'endpoint_count', label: 'Endpoint count', value: checks.endpoint_count, format: 'text' });
+    if (typeof checks.plugin_error === 'string')
+        pluginEntries.push({ key: 'plugin_error', label: 'Plugin error', value: checks.plugin_error, format: 'code' });
+    const bearerEntries = typeof checks.bearer_valid === 'boolean'
+        ? [{ key: 'bearer_valid', label: 'Bearer valid', value: checks.bearer_valid, format: 'boolean' }]
+        : [{ key: 'bearer_valid', label: 'Bearer valid', value: null }];
+    if (typeof checks.bearer_error === 'string')
+        bearerEntries.push({ key: 'bearer_error', label: 'Bearer error', value: checks.bearer_error, format: 'code' });
+    return {
+        title: 'YT Builder MCP — Diagnose',
+        groups: [
+            { label: 'Plugin probe', entries: pluginEntries },
+            { label: 'Bearer probe', entries: bearerEntries },
+        ],
+    };
+}
+//# sourceMappingURL=health-format.js.map

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

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

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

@@ -0,0 +1,45 @@
+/**
+ * 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
+ */
+import type { DetailGroup, TableColumn } from '@getimo/mcp-toolkit';
+/** Full columns for `yootheme_builder_element_types_list`. */
+export declare const TYPES_TABLE_COLUMNS: readonly TableColumn[];
+/** Compact columns kick in at 21+ rows — drop the boolean. */
+export declare const TYPES_COMPACT_COLUMNS: readonly TableColumn[];
+export interface TypeRow {
+    name: string;
+    label: string;
+    origin: string;
+    has_children_support: boolean;
+}
+/**
+ * Maps an `/element-types` row to the table shape.
+ *
+ * - `has_children_support` honours an explicit boolean, else falls back to
+ *   presence of a `children` field on the type definition.
+ * - Missing fields default to empty.
+ */
+export declare function mapTypeRow(input: Record<string, unknown>): TypeRow;
+/**
+ * The REST plugin exposes element types EITHER as a flat array of
+ * `{name, label, origin, …}` objects OR as a wrapper object with an
+ * `element_types` array. Tolerate both. Also tolerate string-only
+ * entries (older shape — just the name) by promoting to `{name}`.
+ */
+export declare function flattenTypesPayload(payload: unknown): Record<string, unknown>[];
+export declare function buildTypeSchemaDetail(payload: {
+    name: string;
+    label?: string;
+    origin?: string;
+    fields?: unknown;
+}): {
+    groups: DetailGroup[];
+    title?: string;
+};
+//# sourceMappingURL=inspection-format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inspection-format.d.ts","sourceRoot":"","sources":["../../../src/tools/format/inspection-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIpE,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,EAAE,SAAS,WAAW,EAKrD,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,EAAE,SAAS,WAAW,EAIvD,CAAC;AAYF,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,EAAE,OAAO,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAalE;AAUD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAY/E;AAuBD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG;IAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAyB5C"}

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

@@ -0,0 +1,125 @@
+/**
+ * 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, else falls back to
+ *   presence of a `children` field on the type definition.
+ * - Missing fields default to empty.
+ */
+export function mapTypeRow(input) {
+    const explicitChildren = typeof input.has_children_support === 'boolean'
+        ? input.has_children_support
+        : undefined;
+    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 EITHER as a flat array of
+ * `{name, label, origin, …}` objects OR as a wrapper object with an
+ * `element_types` array. Tolerate both. Also tolerate string-only
+ * entries (older shape — just the name) by promoting to `{name}`.
+ */
+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;
+        const list = obj.element_types;
+        if (Array.isArray(list)) {
+            return list.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 '—';
+    const keys = 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;
+    return Object.keys(fields).length;
+}
+export function buildTypeSchemaDetail(payload) {
+    return {
+        title: `Element type: ${payload.name}`,
+        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) },
+                ],
+            },
+        ],
+    };
+}
+//# 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,39 @@
+/**
+ * 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. */
+export declare function mapPageRow(input: Record<string, unknown>): Record<string, unknown>;
+/** Maps a `/pages/{id}/schema` node to the table row shape. */
+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;AAIF,eAAO,MAAM,oBAAoB,EAAE,SAAS,WAAW,EAKtD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,WAAW,EAIxD,CAAC;AAgBF,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQlF;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOxF;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,110 @@
+/**
+ * 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) ────
+export const SCHEMA_TABLE_COLUMNS = [
+    { key: 'path', label: 'PATH', width: 32, 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: 'path', label: 'PATH', width: 32, 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;
+}
+/** Maps an `/pages` element to the table row shape. Missing fields default to empty. */
+export function mapPageRow(input) {
+    return {
+        id: asString(input.id),
+        label: asString(input.label),
+        type: asString(input.type),
+        elements_count: asInt(input.elements_count),
+        modified_at: asString(input.modified_at),
+    };
+}
+/** Maps a `/pages/{id}/schema` node to the table row shape. */
+export function mapSchemaNodeRow(input) {
+    return {
+        path: asString(input.path),
+        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,25 @@
+/**
+ * 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>[];
+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,CAOtE;AAWD,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,OAAO,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAqB3B;AAID,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,CA0D5C"}