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

package/dist/tools/layout-flatten.js

@@ -0,0 +1,95 @@
+/**
+ * Layout-flatten helper — depth-first walk that turns a nested YOOtheme
+ * layout tree into a flat array of `{ path, parent_path, depth,
+ * element_type, props }` records.
+ *
+ * Used by `yootheme_builder_page_get_layout` when called with
+ * `flat: true`. Per Design §4.4.1:
+ *
+ *   - Walk-order: depth-first, parent BEFORE children, original child
+ *     order preserved (no sort).
+ *   - `path` uses JSON-Pointer-style notation rooted at `/layout/<key>`
+ *     and descends via `/children/<index>` segments. The root segments
+ *     mirror the keys the REST plugin produces (string keys "0","1",…
+ *     when the top-level layout is an object; numeric indices when it
+ *     happens to be an array).
+ *   - `parent_path` is `null` for top-level entries.
+ *   - The emitted record's `children` field is REMOVED — children become
+ *     their own emitted entries with their own `path`. Keeping the nested
+ *     array would defeat the purpose of flattening.
+ *   - Non-object children are skipped silently but their index is
+ *     preserved in the parent's child-numbering (the next valid sibling
+ *     keeps its original index).
+ *
+ * Pure function — no I/O, no client dependency. Test-covered in
+ * `tests/tools/layout-flatten.test.ts`.
+ *
+ * @license MIT
+ */
+/**
+ * Flatten a YOOtheme nested layout tree.
+ *
+ * @param layout - The top-level layout container. Accepts either an
+ *   object keyed by stringified indices ("0","1",…) or an actual array.
+ *   Returns `[]` for empty input or anything that isn't iterable.
+ */
+export function flattenLayout(layout) {
+    const out = [];
+    if (layout === null || typeof layout !== 'object') {
+        return out;
+    }
+    // Iterate top-level entries in insertion order. For arrays this gives
+    // numeric indices; for objects keyed by "0","1",… it gives the same
+    // ordering YT serialises.
+    const entries = Array.isArray(layout)
+        ? layout.map((v, i) => [String(i), v])
+        : Object.entries(layout);
+    for (const [key, node] of entries) {
+        walk(node, `/layout/${key}`, null, 0, out);
+    }
+    return out;
+}
+/**
+ * Depth-first walker. Emits the node, then recurses into its children.
+ * Skips non-object nodes silently while preserving child-index numbering.
+ */
+function walk(node, path, parentPath, depth, out) {
+    if (node === null || typeof node !== 'object' || Array.isArray(node)) {
+        return;
+    }
+    const obj = node;
+    const elementType = typeof obj.type === 'string' ? obj.type : '';
+    const props = obj.props !== null && typeof obj.props === 'object' && !Array.isArray(obj.props)
+        ? obj.props
+        : undefined;
+    // Build a passthrough shallow-clone WITHOUT the children field. We
+    // copy every other top-level key so future REST additions (label,
+    // has_binding, …) survive the flatten.
+    const emitted = {
+        path,
+        parent_path: parentPath,
+        depth,
+        element_type: elementType,
+    };
+    for (const [k, v] of Object.entries(obj)) {
+        if (k === 'children' || k === 'type' || k === 'props')
+            continue;
+        emitted[k] = v;
+    }
+    if (props !== undefined)
+        emitted.props = props;
+    out.push(emitted);
+    const children = obj.children;
+    if (Array.isArray(children)) {
+        for (let i = 0; i < children.length; i++) {
+            const child = children[i];
+            if (child === null || typeof child !== 'object' || Array.isArray(child)) {
+                // Skip non-object children; their index is preserved in
+                // the next sibling's path.
+                continue;
+            }
+            walk(child, `${path}/children/${String(i)}`, path, depth + 1, out);
+        }
+    }
+}
+//# sourceMappingURL=layout-flatten.js.map

package/dist/tools/layout-flatten.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-flatten.js","sourceRoot":"","sources":["../../src/tools/layout-flatten.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AA6BH;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,MAAe;IACzC,MAAM,GAAG,GAAkB,EAAE,CAAC;IAE9B,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,GAAG,CAAC;IACf,CAAC;IAED,sEAAsE;IACtE,oEAAoE;IACpE,0BAA0B;IAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QACjC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAqB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAiC,CAAC,CAAC;IAExD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,IAAI,CACT,IAAa,EACb,IAAY,EACZ,UAAyB,EACzB,KAAa,EACb,GAAkB;IAElB,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACnE,OAAO;IACX,CAAC;IACD,MAAM,GAAG,GAAG,IAA+B,CAAC;IAE5C,MAAM,WAAW,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,MAAM,KAAK,GACP,GAAG,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;QAC5E,CAAC,CAAE,GAAG,CAAC,KAAiC;QACxC,CAAC,CAAC,SAAS,CAAC;IAEpB,mEAAmE;IACnE,kEAAkE;IAClE,uCAAuC;IACvC,MAAM,OAAO,GAAgB;QACzB,IAAI;QACJ,WAAW,EAAE,UAAU;QACvB,KAAK;QACL,YAAY,EAAE,WAAW;KAC5B,CAAC;IACF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,OAAO;YAAE,SAAS;QAChE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;IAC/C,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAElB,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtE,wDAAwD;gBACxD,2BAA2B;gBAC3B,SAAS;YACb,CAAC;YACD,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,aAAa,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QACvE,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/tools/pages/builders.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Page-tool builders — pure `defineTool` factory list.
+ *
+ * Split out of `src/tools/pages.ts` (Round-2 R2-A2-CRIT1). Handler
+ * bodies live in `./handlers-read.ts` (pages_list, page_get_layout,
+ * page_get_schema, get_etag) and `./handlers-write.ts` (page_save,
+ * page_publish — 3-phase progress contract).
+ *
+ * @license MIT
+ */
+import type { RestClient } from '../../client.js';
+import { type AnyToolDefinition } from '../tool-builder.js';
+export declare function buildPagesTools(client: RestClient): readonly AnyToolDefinition[];
+//# sourceMappingURL=builders.d.ts.map

package/dist/tools/pages/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/pages/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,OAAO,EAKH,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAC;AAyB5B,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,iBAAiB,EAAE,CAiFhF"}

package/dist/tools/pages/builders.js

@@ -0,0 +1,97 @@
+/**
+ * Page-tool builders — pure `defineTool` factory list.
+ *
+ * Split out of `src/tools/pages.ts` (Round-2 R2-A2-CRIT1). Handler
+ * bodies live in `./handlers-read.ts` (pages_list, page_get_layout,
+ * page_get_schema, get_etag) and `./handlers-write.ts` (page_save,
+ * page_publish — 3-phase progress contract).
+ *
+ * @license MIT
+ */
+import { z } from 'zod';
+import { TEMPLATE_ID } from '../shared-schemas.js';
+import { FIELDS, FLAT } from '../sparse-fields.js';
+import { creating, defineTool, mutating, readOnly, } from '../tool-builder.js';
+import { handleGetEtag, handlePageGetLayout, handlePageGetSchema, handlePagesList, } from './handlers-read.js';
+import { handlePagePublish, handlePageSave } from './handlers-write.js';
+import { ETAG_OUTPUT_SCHEMA, PAGES_LIST_OUTPUT_SCHEMA, SCHEMA_OUTPUT_SCHEMA, } from './schemas.js';
+// Wave-6 Fix 20: pages.ts retains an OPTIONAL ETag (page-level save/publish
+// is allowed without a precondition; element/binding mutations REQUIRE
+// one via the strict ETAG in shared-schemas.ts).
+const ETAG = z
+    .string()
+    .optional()
+    .describe('Optimistic-lock ETag (e.g. "abc123" from yootheme_builder_get_etag). ' +
+    'Required for write operations after the first call.');
+export function buildPagesTools(client) {
+    return [
+        defineTool({
+            name: 'yootheme_builder_pages_list',
+            description: 'List all YOOtheme templates ("pages") on the site. Returns id, label and ' +
+                'usage metadata for each. Use this first to discover template IDs. ' +
+                'Pass `fields:["id","label"]` to project per-item to a smaller shape.',
+            inputSchema: { fields: FIELDS },
+            outputSchema: PAGES_LIST_OUTPUT_SCHEMA,
+            annotations: readOnly('List Pages'),
+            handler: (input) => handlePagesList(client, input),
+        }),
+        defineTool({
+            name: 'yootheme_builder_page_get_layout',
+            description: 'Get full layout tree for one template. Default nested `{layout, ' +
+                'etag}`. Set `flat:true` for depth-first array `{elements:[...], ' +
+                'etag}`; combine with `fields[]` to project per-element.',
+            inputSchema: {
+                template_id: TEMPLATE_ID,
+                flat: FLAT,
+                fields: FIELDS,
+            },
+            // No outputSchema: the response shape is a union (nested OR flat with
+            // optional projection) and the JSON-Pointer-keyed nested shape is
+            // structurally open-ended — modelling it precisely buys nothing here.
+            annotations: readOnly('Get Page Layout'),
+            handler: (input) => handlePageGetLayout(client, input),
+        }),
+        defineTool({
+            name: 'yootheme_builder_page_get_schema',
+            description: 'Get the flat schema for a template — a list of nodes with their JSON-Pointer ' +
+                'paths and element types. Best entry-point for navigation: lighter than ' +
+                'page_get_layout, sufficient to locate elements before editing.',
+            inputSchema: { template_id: TEMPLATE_ID },
+            outputSchema: SCHEMA_OUTPUT_SCHEMA,
+            annotations: readOnly('Get Page Schema'),
+            handler: (input) => handlePageGetSchema(client, input),
+        }),
+        defineTool({
+            name: 'yootheme_builder_get_etag',
+            description: 'Get the current top-level state ETag. Pass this back via the `etag` parameter ' +
+                'on any write tool to prevent overwriting concurrent edits.',
+            inputSchema: {},
+            outputSchema: ETAG_OUTPUT_SCHEMA,
+            annotations: readOnly('Get ETag'),
+            handler: () => handleGetEtag(client),
+        }),
+        defineTool({
+            name: 'yootheme_builder_page_save',
+            description: 'Re-run save-transforms on a template and persist. Useful after a series of ' +
+                'low-level writes to trigger the Builder normalization pass. Requires ETag.',
+            inputSchema: {
+                template_id: TEMPLATE_ID,
+                etag: ETAG,
+            },
+            annotations: mutating('Save Page'),
+            handler: (input, extra) => handlePageSave(client, input, extra),
+        }),
+        defineTool({
+            name: 'yootheme_builder_page_publish',
+            description: 'Publish a template. Currently behaves as save + sets `published: true` in the ' +
+                'response. Requires ETag.',
+            inputSchema: {
+                template_id: TEMPLATE_ID,
+                etag: ETAG,
+            },
+            annotations: creating('Publish Page'),
+            handler: (input, extra) => handlePagePublish(client, input, extra),
+        }),
+    ];
+}
+//# sourceMappingURL=builders.js.map

package/dist/tools/pages/builders.js.map

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

package/dist/tools/pages/handlers-read.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Page-tool READ handlers + shared output-schemas.
+ *
+ * Split out of `src/tools/pages.ts` (Round-2 R2-A2-CRIT1) to keep
+ * each file ≤ 200 LoC per Architecture §11. Write handlers (page_save,
+ * page_publish — 3-phase progress contract) live in `./handlers-write.ts`.
+ *
+ * @license MIT
+ */
+import type { RestClient } from '../../client.js';
+import { type ToolResult } from '../tool-builder.js';
+export declare function handlePagesList(client: RestClient, { fields }: {
+    fields?: readonly string[];
+}): Promise<ToolResult>;
+export declare function handlePageGetLayout(client: RestClient, { template_id, flat, fields }: {
+    template_id: string;
+    flat?: boolean;
+    fields?: readonly string[];
+}): Promise<ToolResult>;
+export declare function handlePageGetSchema(client: RestClient, { template_id }: {
+    template_id: string;
+}): Promise<ToolResult>;
+export declare function handleGetEtag(client: RestClient): Promise<ToolResult>;
+//# sourceMappingURL=handlers-read.d.ts.map

package/dist/tools/pages/handlers-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers-read.d.ts","sourceRoot":"","sources":["../../../src/tools/pages/handlers-read.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAgBlD,OAAO,EAIH,KAAK,UAAU,EAClB,MAAM,oBAAoB,CAAC;AAI5B,wBAAsB,eAAe,CACjC,MAAM,EAAE,UAAU,EAClB,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAC3C,OAAO,CAAC,UAAU,CAAC,CAgCrB;AAID,wBAAsB,mBAAmB,CACrC,MAAM,EAAE,UAAU,EAClB,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B,GACF,OAAO,CAAC,UAAU,CAAC,CAmCrB;AAID,wBAAsB,mBAAmB,CACrC,MAAM,EAAE,UAAU,EAClB,EAAE,WAAW,EAAE,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GACzC,OAAO,CAAC,UAAU,CAAC,CA4CrB;AAID,wBAAsB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAoB3E"}

package/dist/tools/pages/handlers-read.js

@@ -0,0 +1,141 @@
+/**
+ * Page-tool READ handlers + shared output-schemas.
+ *
+ * Split out of `src/tools/pages.ts` (Round-2 R2-A2-CRIT1) to keep
+ * each file ≤ 200 LoC per Architecture §11. Write handlers (page_save,
+ * page_publish — 3-phase progress contract) live in `./handlers-write.ts`.
+ *
+ * @license MIT
+ */
+import { detailResult, tableResult } from '@getimo/mcp-toolkit';
+import { flattenLayout } from '../layout-flatten.js';
+import { PAGES_COMPACT_COLUMNS, PAGES_TABLE_COLUMNS, SCHEMA_COMPACT_COLUMNS, SCHEMA_TABLE_COLUMNS, buildEtagDetail, buildSchemaRows, mapPageRow, } from '../format/pages-format.js';
+import { DEFAULT_FIELDS_PAGES_LIST, projectFields, projectedFieldsEcho, } from '../sparse-fields.js';
+import { errorResult, jsonResult, structuredResult, } from '../tool-builder.js';
+// ─── pages_list ─────────────────────────────────────────────────────
+export async function handlePagesList(client, { fields }) {
+    try {
+        const data = await client.get('/pages');
+        const rawPages = Array.isArray(data.pages) ? data.pages : [];
+        const mapped = rawPages
+            .filter((x) => x !== null && typeof x === 'object')
+            .map(mapPageRow);
+        // Project AFTER mapping — keeps stable key names and lets the
+        // toolkit's tableResult format the raw, full-shape rows for the
+        // LLM text leg while the structuredContent leg carries the
+        // projected per-item slice.
+        const items = projectFields(mapped, fields, DEFAULT_FIELDS_PAGES_LIST);
+        const echo = projectedFieldsEcho(fields, DEFAULT_FIELDS_PAGES_LIST);
+        const toolkitResult = tableResult(mapped, {
+            columns: [...PAGES_TABLE_COLUMNS],
+            compactColumns: [...PAGES_COMPACT_COLUMNS],
+            header: (count) => `${String(count)} pages`,
+            footer: 'Use yootheme_builder_page_get_schema <id> to inspect.',
+        });
+        return structuredResult(toolkitResult, {
+            items,
+            total: items.length,
+            ...(typeof data.etag === 'string' ? { etag: data.etag } : {}),
+            ...(echo !== undefined ? { projected_fields: [...echo] } : {}),
+        });
+    }
+    catch (e) {
+        return errorResult({
+            error: e,
+            context: {},
+            hint: 'Run yootheme_builder_diagnose to verify connectivity and auth.',
+        });
+    }
+}
+// ─── page_get_layout ────────────────────────────────────────────────
+export async function handlePageGetLayout(client, { template_id, flat, fields }) {
+    try {
+        const data = await client.get(`/pages/${encodeURIComponent(template_id)}/layout`);
+        if (flat !== true) {
+            // Default: nested passthrough — unchanged from pre-G.3.
+            return jsonResult(data);
+        }
+        // flat: true → depth-first walk on the nested layout. Apply
+        // pickFields per element when `fields[]` was passed; echo the
+        // projection so the AI knows the per-item shape it received.
+        const flatElements = flattenLayout(data.layout);
+        const projected = projectFields(flatElements, fields, 
+        // No default-set on layout.flat: keep "all" semantics
+        // unless caller opts-in. The echo helper below mirrors that.
+        []);
+        const echo = projectedFieldsEcho(fields, undefined);
+        return jsonResult({
+            elements: projected,
+            ...(typeof data.etag === 'string' ? { etag: data.etag } : {}),
+            ...(echo !== undefined ? { projected_fields: [...echo] } : {}),
+        });
+    }
+    catch (e) {
+        return errorResult({
+            error: e,
+            context: { template_id },
+            hint: 'Verify the template_id exists via yootheme_builder_pages_list. ' +
+                'IDs are case-sensitive.',
+        });
+    }
+}
+// ─── page_get_schema ────────────────────────────────────────────────
+export async function handlePageGetSchema(client, { template_id }) {
+    try {
+        const data = await client.get(`/pages/${encodeURIComponent(template_id)}/schema`);
+        const rawNodes = Array.isArray(data.nodes) ? data.nodes : [];
+        const items = buildSchemaRows(rawNodes.filter((x) => x !== null && typeof x === 'object'));
+        // Templates routinely exceed 21 nodes (a typical home page has
+        // 30–150 elements). Force compact level so the LLM never gets
+        // truncated text — toolkit's resolveDetailLevel honours the
+        // explicit override.
+        //
+        // TODO(toolkit-upstream): contribute a `compactWhen: (count) => boolean`
+        // field to @getimo/mcp-toolkit's AutoFormatOptions so this
+        // can be expressed declaratively on the config object instead
+        // of via the third positional argument. Tracked as Round-1.5
+        // follow-up (I2).
+        const toolkitResult = tableResult(items, {
+            columns: [...SCHEMA_TABLE_COLUMNS],
+            compactColumns: [...SCHEMA_COMPACT_COLUMNS],
+            header: (count) => `${String(count)} nodes in template "${template_id}"`,
+            footer: 'Use yootheme_builder_element_get <path> for full element data.',
+        }, 'compact');
+        return structuredResult(toolkitResult, {
+            items,
+            total: items.length,
+            template_id,
+        });
+    }
+    catch (e) {
+        return errorResult({
+            error: e,
+            context: { template_id },
+            hint: 'Verify the template_id exists via yootheme_builder_pages_list.',
+        });
+    }
+}
+// ─── get_etag ───────────────────────────────────────────────────────
+export async function handleGetEtag(client) {
+    try {
+        const data = await client.get('/etag');
+        const toolkitResult = detailResult(buildEtagDetail({
+            etag: data.etag,
+            generated_at: data.generated_at,
+        }));
+        return structuredResult(toolkitResult, {
+            etag: data.etag,
+            ...(typeof data.generated_at === 'string'
+                ? { generated_at: data.generated_at }
+                : {}),
+        });
+    }
+    catch (e) {
+        return errorResult({
+            error: e,
+            context: {},
+            hint: 'Run yootheme_builder_diagnose to verify auth.',
+        });
+    }
+}
+//# sourceMappingURL=handlers-read.js.map

package/dist/tools/pages/handlers-read.js.map

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

package/dist/tools/pages/handlers-write.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Page-tool WRITE handlers — `page_save`, `page_publish`. Both implement
+ * the 3-phase progress contract (PHASE_SEND → PHASE_SERVER → PHASE_CONFIRM).
+ * PHASE_SERVER is emitted BEFORE the await so the synthetic intermediate
+ * fires even when the REST call ultimately errors — the dispatch IS the
+ * boundary, not the response.
+ *
+ * Split out of `src/tools/pages.ts` (Round-2 R2-A2-CRIT1).
+ *
+ * @license MIT
+ */
+import type { RestClient } from '../../client.js';
+import { type HandlerExtra, type ToolResult } from '../tool-builder.js';
+interface SavePublishInput {
+    template_id: string;
+    etag?: string;
+}
+export declare function handlePageSave(client: RestClient, { template_id, etag }: SavePublishInput, extra?: HandlerExtra): Promise<ToolResult>;
+export declare function handlePagePublish(client: RestClient, { template_id, etag }: SavePublishInput, extra?: HandlerExtra): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=handlers-write.d.ts.map

package/dist/tools/pages/handlers-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers-write.d.ts","sourceRoot":"","sources":["../../../src/tools/pages/handlers-write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAIH,KAAK,YAAY,EACjB,KAAK,UAAU,EAClB,MAAM,oBAAoB,CAAC;AAE5B,UAAU,gBAAgB;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,wBAAsB,cAAc,CAChC,MAAM,EAAE,UAAU,EAClB,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,gBAAgB,EACvC,KAAK,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAoBrB;AAID,wBAAsB,iBAAiB,CACnC,MAAM,EAAE,UAAU,EAClB,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,gBAAgB,EACvC,KAAK,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAoBrB"}

package/dist/tools/pages/handlers-write.js

@@ -0,0 +1,52 @@
+/**
+ * Page-tool WRITE handlers — `page_save`, `page_publish`. Both implement
+ * the 3-phase progress contract (PHASE_SEND → PHASE_SERVER → PHASE_CONFIRM).
+ * PHASE_SERVER is emitted BEFORE the await so the synthetic intermediate
+ * fires even when the REST call ultimately errors — the dispatch IS the
+ * boundary, not the response.
+ *
+ * Split out of `src/tools/pages.ts` (Round-2 R2-A2-CRIT1).
+ *
+ * @license MIT
+ */
+import { PHASE_CONFIRM, PHASE_SEND, PHASE_SERVER } from '../progress-phases.js';
+import { createProgressReporter, errorResult, jsonResult, } from '../tool-builder.js';
+// ─── page_save ──────────────────────────────────────────────────────
+export async function handlePageSave(client, { template_id, etag }, extra) {
+    const progress = extra ? createProgressReporter(extra) : null;
+    await progress?.report(0, 3, PHASE_SEND);
+    await progress?.report(1, 3, PHASE_SERVER);
+    try {
+        const data = await client.post(`/pages/${encodeURIComponent(template_id)}/save`, { etag });
+        await progress?.report(2, 3, PHASE_CONFIRM);
+        return jsonResult(data);
+    }
+    catch (e) {
+        return errorResult({
+            error: e,
+            context: { template_id, etag },
+            hint: 'On 412 (precondition failed) refresh via yootheme_builder_get_etag ' +
+                'and retry — someone else edited the page.',
+        });
+    }
+}
+// ─── page_publish ───────────────────────────────────────────────────
+export async function handlePagePublish(client, { template_id, etag }, extra) {
+    const progress = extra ? createProgressReporter(extra) : null;
+    await progress?.report(0, 3, PHASE_SEND);
+    await progress?.report(1, 3, PHASE_SERVER);
+    try {
+        const data = await client.post(`/pages/${encodeURIComponent(template_id)}/publish`, { etag });
+        await progress?.report(2, 3, PHASE_CONFIRM);
+        return jsonResult(data);
+    }
+    catch (e) {
+        return errorResult({
+            error: e,
+            context: { template_id, etag },
+            hint: 'On 412 (precondition failed) refresh via yootheme_builder_get_etag ' +
+                'and retry.',
+        });
+    }
+}
+//# sourceMappingURL=handlers-write.js.map

package/dist/tools/pages/handlers-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers-write.js","sourceRoot":"","sources":["../../../src/tools/pages/handlers-write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EACH,sBAAsB,EACtB,WAAW,EACX,UAAU,GAGb,MAAM,oBAAoB,CAAC;AAO5B,uEAAuE;AAEvE,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,MAAkB,EAClB,EAAE,WAAW,EAAE,IAAI,EAAoB,EACvC,KAAoB;IAEpB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;IACzC,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC;IAC3C,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAC1B,UAAU,kBAAkB,CAAC,WAAW,CAAC,OAAO,EAChD,EAAE,IAAI,EAAE,CACX,CAAC;QACF,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC;QAC5C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,WAAW,CAAC;YACf,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;YAC9B,IAAI,EACA,qEAAqE;gBACrE,2CAA2C;SAClD,CAAC,CAAC;IACP,CAAC;AACL,CAAC;AAED,uEAAuE;AAEvE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACnC,MAAkB,EAClB,EAAE,WAAW,EAAE,IAAI,EAAoB,EACvC,KAAoB;IAEpB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;IACzC,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC;IAC3C,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAC1B,UAAU,kBAAkB,CAAC,WAAW,CAAC,UAAU,EACnD,EAAE,IAAI,EAAE,CACX,CAAC;QACF,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC;QAC5C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,WAAW,CAAC;YACf,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;YAC9B,IAAI,EACA,qEAAqE;gBACrE,YAAY;SACnB,CAAC,CAAC;IACP,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * Page-tool barrel — public entry-point for the 6 page-level tools:
+ *
+ *   yootheme_builder_pages_list        → list templates (tableResult + structuredContent)
+ *   yootheme_builder_page_get_layout   → full layout tree (jsonResult)
+ *   yootheme_builder_page_get_schema   → flat schema (tableResult compact)
+ *   yootheme_builder_page_save         → re-run save-transforms + persist
+ *   yootheme_builder_page_publish      → publish
+ *   yootheme_builder_get_etag          → top-level state ETag (detailResult)
+ *
+ * Round-2 R2-A2-CRIT1 — split out of the original `src/tools/pages.ts`.
+ *
+ * @license MIT
+ */
+export { buildPagesTools } from './builders.js';
+export { ETAG_OUTPUT_SCHEMA, PAGES_LIST_OUTPUT_SCHEMA, SCHEMA_OUTPUT_SCHEMA, } from './schemas.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/pages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACH,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,GACvB,MAAM,cAAc,CAAC"}

package/dist/tools/pages/index.js

@@ -0,0 +1,17 @@
+/**
+ * Page-tool barrel — public entry-point for the 6 page-level tools:
+ *
+ *   yootheme_builder_pages_list        → list templates (tableResult + structuredContent)
+ *   yootheme_builder_page_get_layout   → full layout tree (jsonResult)
+ *   yootheme_builder_page_get_schema   → flat schema (tableResult compact)
+ *   yootheme_builder_page_save         → re-run save-transforms + persist
+ *   yootheme_builder_page_publish      → publish
+ *   yootheme_builder_get_etag          → top-level state ETag (detailResult)
+ *
+ * Round-2 R2-A2-CRIT1 — split out of the original `src/tools/pages.ts`.
+ *
+ * @license MIT
+ */
+export { buildPagesTools } from './builders.js';
+export { ETAG_OUTPUT_SCHEMA, PAGES_LIST_OUTPUT_SCHEMA, SCHEMA_OUTPUT_SCHEMA, } from './schemas.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/pages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACH,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,GACvB,MAAM,cAAc,CAAC"}

package/dist/tools/pages/schemas.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Page-tool output-schemas (Wave G.2 §4 structuredContent contracts).
+ *
+ * Split out of `src/tools/pages.ts` (Round-2 R2-A2-CRIT1) so the
+ * handler files stay focused on logic.
+ *
+ * @license MIT
+ */
+import { z } from 'zod';
+export declare const PAGES_LIST_OUTPUT_SCHEMA: z.ZodObject<{
+    items: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    total: z.ZodNumber;
+    etag: z.ZodOptional<z.ZodString>;
+    projected_fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const SCHEMA_OUTPUT_SCHEMA: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        element_type: z.ZodString;
+        label: z.ZodString;
+        has_binding: z.ZodBoolean;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    template_id: z.ZodString;
+}, z.core.$strip>;
+export declare const ETAG_OUTPUT_SCHEMA: z.ZodObject<{
+    etag: z.ZodString;
+    generated_at: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/pages/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/pages/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,wBAAwB;;;;;iBAKnC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;iBAW/B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC"}

package/dist/tools/pages/schemas.js

@@ -0,0 +1,30 @@
+/**
+ * Page-tool output-schemas (Wave G.2 §4 structuredContent contracts).
+ *
+ * Split out of `src/tools/pages.ts` (Round-2 R2-A2-CRIT1) so the
+ * handler files stay focused on logic.
+ *
+ * @license MIT
+ */
+import { z } from 'zod';
+export const PAGES_LIST_OUTPUT_SCHEMA = z.object({
+    items: z.array(z.record(z.string(), z.unknown())),
+    total: z.number(),
+    etag: z.string().optional(),
+    projected_fields: z.array(z.string()).optional(),
+});
+export const SCHEMA_OUTPUT_SCHEMA = z.object({
+    items: z.array(z.object({
+        path: z.string(),
+        element_type: z.string(),
+        label: z.string(),
+        has_binding: z.boolean(),
+    })),
+    total: z.number(),
+    template_id: z.string(),
+});
+export const ETAG_OUTPUT_SCHEMA = z.object({
+    etag: z.string(),
+    generated_at: z.string().optional(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tools/pages/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/tools/pages/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACjD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,KAAK,CACV,CAAC,CAAC,MAAM,CAAC;QACL,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE;KAC3B,CAAC,CACL;IACD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC"}

package/dist/tools/pages.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Backward-compat shim for `src/tools/pages.ts`.
+ *
+ * The original 358-LoC module was split into `src/tools/pages/`
+ * (5 files, each ≤ 200 LoC) per Architecture §11 cap (Round-2
+ * R2-A2-CRIT1 audit fix). This shim preserves the public import path
+ * (`from '../../src/tools/pages.js'`) so all existing test imports
+ * and `tools/index.ts` keep working unchanged.
+ *
+ * @license MIT
+ */
+export * from './pages/index.js';
+//# sourceMappingURL=pages.d.ts.map

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

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

package/dist/tools/pages.js

@@ -0,0 +1,13 @@
+/**
+ * Backward-compat shim for `src/tools/pages.ts`.
+ *
+ * The original 358-LoC module was split into `src/tools/pages/`
+ * (5 files, each ≤ 200 LoC) per Architecture §11 cap (Round-2
+ * R2-A2-CRIT1 audit fix). This shim preserves the public import path
+ * (`from '../../src/tools/pages.js'`) so all existing test imports
+ * and `tools/index.ts` keep working unchanged.
+ *
+ * @license MIT
+ */
+export * from './pages/index.js';
+//# sourceMappingURL=pages.js.map

package/dist/tools/pages.js.map

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