@wootsup/yt-builder-mcp 1.0.0 → 1.0.1

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

@@ -1,161 +0,0 @@
-/**
- * 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.',
-        });
-    }
-}
-// ─── template_summary (T9 — Audit-v3 B.5 token-efficient overview) ────
-/**
- * T9: a one-call structured overview of a template — element counts by
- * type, binding count, max nesting depth, and named landmarks. Lets the
- * agent grasp a 96-node template for ~1 kB instead of pulling the full
- * element_list dump (20 kB+).
- */
-export async function handleTemplateSummary(client, { template_id }) {
-    try {
-        const data = await client.get(`/pages/${encodeURIComponent(template_id)}/summary`);
-        return jsonResult(data);
-    }
-    catch (e) {
-        return errorResult({
-            error: e,
-            context: { template_id },
-            hint: 'Verify the template_id exists via yootheme_builder_pages_list.',
-        });
-    }
-}
-//# sourceMappingURL=handlers-read.js.map

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/tools/progress-phases.d.ts

@@ -1,46 +0,0 @@
-/**
- * Wave G.5 + Round-1.5 — shared progress labels for write handlers.
- *
- * Two contracts coexist:
- *
- * ─── 2-phase (element_* mutations) ───────────────────────────────────
- *
- *   0/2  PHASE_SEND     — before the REST call,
- *   2/2  PHASE_CONFIRM  — after a 2xx response.
- *
- * Used by the five element_* write tools (add / update_settings / move /
- * clone / delete). Each is a single shallow `wp_option('yootheme')` write
- * — the request completes in tens of milliseconds and there is no
- * client-observable window between dispatch and confirmation that would
- * benefit from a synthetic intermediate event.
- *
- * ─── 3-phase (page_save / page_publish) ──────────────────────────────
- *
- *   0/3  PHASE_SEND     — before the REST call,
- *   1/3  PHASE_SERVER   — synthetic intermediate, emitted AFTER dispatch
- *                         starts but BEFORE the await resolves; lets the
- *                         MCP-client UI render a mid-flight indicator
- *                         matching the reference UX intent without
- *                         requiring an SSE-streaming REST endpoint.
- *   2/3  PHASE_CONFIRM  — after a 2xx response.
- *
- * Reserved for the two page-level mutations (`page_save` /
- * `page_publish`). Both trigger a save-transform pass + a full layout
- * re-serialisation on the PHP side; on large templates this can take
- * 500-3000 ms — well over the perceptual threshold where a mid-flight
- * progress signal materially improves the operator experience.
- *
- * Round-1.5 revert: an earlier Round-1 audit amendment collapsed the
- * page_save / page_publish handlers down to 2-phase on the grounds that
- * the synthetic intermediate was "theatre". Thomas-mandate 2026-05-22
- * reinstates the 3-phase contract: the intermediate is honest if it
- * marks an observable boundary (dispatch-start → await-resolved is one
- * such boundary even without server-side streaming, because the
- * dispatch itself is non-blocking from the host UI's perspective).
- *
- * @license MIT
- */
-export declare const PHASE_SEND = "Sending write request";
-export declare const PHASE_CONFIRM = "Confirmed by server";
-export declare const PHASE_SERVER = "Server processing";
-//# sourceMappingURL=progress-phases.d.ts.map

package/dist/tools/progress-phases.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"progress-phases.d.ts","sourceRoot":"","sources":["../../src/tools/progress-phases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAGH,eAAO,MAAM,UAAU,0BAA0B,CAAC;AAClD,eAAO,MAAM,aAAa,wBAAwB,CAAC;AAGnD,eAAO,MAAM,YAAY,sBAAsB,CAAC"}

package/dist/tools/progress-phases.js

@@ -1,48 +0,0 @@
-/**
- * Wave G.5 + Round-1.5 — shared progress labels for write handlers.
- *
- * Two contracts coexist:
- *
- * ─── 2-phase (element_* mutations) ───────────────────────────────────
- *
- *   0/2  PHASE_SEND     — before the REST call,
- *   2/2  PHASE_CONFIRM  — after a 2xx response.
- *
- * Used by the five element_* write tools (add / update_settings / move /
- * clone / delete). Each is a single shallow `wp_option('yootheme')` write
- * — the request completes in tens of milliseconds and there is no
- * client-observable window between dispatch and confirmation that would
- * benefit from a synthetic intermediate event.
- *
- * ─── 3-phase (page_save / page_publish) ──────────────────────────────
- *
- *   0/3  PHASE_SEND     — before the REST call,
- *   1/3  PHASE_SERVER   — synthetic intermediate, emitted AFTER dispatch
- *                         starts but BEFORE the await resolves; lets the
- *                         MCP-client UI render a mid-flight indicator
- *                         matching the reference UX intent without
- *                         requiring an SSE-streaming REST endpoint.
- *   2/3  PHASE_CONFIRM  — after a 2xx response.
- *
- * Reserved for the two page-level mutations (`page_save` /
- * `page_publish`). Both trigger a save-transform pass + a full layout
- * re-serialisation on the PHP side; on large templates this can take
- * 500-3000 ms — well over the perceptual threshold where a mid-flight
- * progress signal materially improves the operator experience.
- *
- * Round-1.5 revert: an earlier Round-1 audit amendment collapsed the
- * page_save / page_publish handlers down to 2-phase on the grounds that
- * the synthetic intermediate was "theatre". Thomas-mandate 2026-05-22
- * reinstates the 3-phase contract: the intermediate is honest if it
- * marks an observable boundary (dispatch-start → await-resolved is one
- * such boundary even without server-side streaming, because the
- * dispatch itself is non-blocking from the host UI's perspective).
- *
- * @license MIT
- */
-// ── 2-phase (element_*) ─────────────────────────────────────────────
-export const PHASE_SEND = 'Sending write request';
-export const PHASE_CONFIRM = 'Confirmed by server';
-// ── 3-phase intermediate (page_save / page_publish only) ────────────
-export const PHASE_SERVER = 'Server processing';
-//# sourceMappingURL=progress-phases.js.map

package/dist/tools/progress-phases.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"progress-phases.js","sourceRoot":"","sources":["../../src/tools/progress-phases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,uEAAuE;AACvE,MAAM,CAAC,MAAM,UAAU,GAAG,uBAAuB,CAAC;AAClD,MAAM,CAAC,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAEnD,uEAAuE;AACvE,MAAM,CAAC,MAAM,YAAY,GAAG,mBAAmB,CAAC"}

package/dist/tools/shared-schemas.d.ts

@@ -1,15 +0,0 @@
-/**
- * Shared Zod schemas — Wave-6 Fix 20.
- *
- * Centralises the schema definitions reused across pages, elements and
- * sources tool builders, so a description tweak lands in one place
- * instead of three.
- *
- * @license MIT
- */
-import { z } from 'zod';
-export declare const TEMPLATE_ID: z.ZodString;
-export declare const ELEMENT_PATH: z.ZodString;
-export declare const ETAG: z.ZodString;
-export declare const PROPS: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-//# sourceMappingURL=shared-schemas.d.ts.map

package/dist/tools/shared-schemas.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shared-schemas.d.ts","sourceRoot":"","sources":["../../src/tools/shared-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,WAAW,aAKnB,CAAC;AAEN,eAAO,MAAM,YAAY,aAMpB,CAAC;AAEN,eAAO,MAAM,IAAI,aAOZ,CAAC;AAEN,eAAO,MAAM,KAAK,wCAKb,CAAC"}

package/dist/tools/shared-schemas.js

@@ -1,30 +0,0 @@
-/**
- * Shared Zod schemas — Wave-6 Fix 20.
- *
- * Centralises the schema definitions reused across pages, elements and
- * sources tool builders, so a description tweak lands in one place
- * instead of three.
- *
- * @license MIT
- */
-import { z } from 'zod';
-export const TEMPLATE_ID = z
-    .string()
-    .min(1)
-    .describe('Template ID (e.g. "default"). Use yootheme_builder_pages_list to discover.');
-export const ELEMENT_PATH = z
-    .string()
-    .min(1)
-    .describe('JSON-Pointer path to the element (e.g. "/0/children/2"). Use ' +
-    'yootheme_builder_element_list to discover available paths.');
-export const ETAG = z
-    .string()
-    .min(1)
-    .describe('Optimistic-lock ETag from yootheme_builder_get_etag. Required to ' +
-    'detect concurrent edits — call get_etag first, pass the value here. ' +
-    'On 412 Precondition Failed, re-fetch the ETag and retry.');
-export const PROPS = z
-    .record(z.string(), z.unknown())
-    .describe('Element props object (e.g. `{title: "Hello", margin: "default"}`). ' +
-    'Use yootheme_builder_element_type_get_schema to discover available keys.');
-//# sourceMappingURL=shared-schemas.js.map

package/dist/tools/shared-schemas.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"shared-schemas.js","sourceRoot":"","sources":["../../src/tools/shared-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACvB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CACL,4EAA4E,CAC/E,CAAC;AAEN,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KACxB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CACL,+DAA+D;IAC3D,4DAA4D,CACnE,CAAC;AAEN,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC;KAChB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CACL,mEAAmE;IAC/D,sEAAsE;IACtE,0DAA0D,CACjE,CAAC;AAEN,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC;KACjB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;KAC/B,QAAQ,CACL,qEAAqE;IACjE,0EAA0E,CACjF,CAAC"}

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

@@ -1,13 +0,0 @@
-/**
- * Source-tool builders — pure `defineTool` factory list.
- *
- * Split out of `src/tools/sources.ts` (Wave G.4.0b). See `./handlers.ts`
- * for the handler bodies.
- *
- * @license MIT
- */
-import type { RestClient } from '../../client.js';
-import { type AnyToolDefinition } from '../tool-builder.js';
-import { type SourcesHandlerDeps } from './handlers.js';
-export declare function buildSourcesTools(client: RestClient, deps?: Partial<SourcesHandlerDeps>): readonly AnyToolDefinition[];
-//# sourceMappingURL=builders.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/sources/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,OAAO,EAKH,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGH,KAAK,kBAAkB,EAK1B,MAAM,eAAe,CAAC;AAEvB,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,UAAU,EAClB,IAAI,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,SAAS,iBAAiB,EAAE,CA0G9B"}