@wootsup/yt-builder-mcp 1.12.0 → 2.0.0

package/dist/tools/pool-resolve-helper.js

@@ -1,40 +1,36 @@
-/**
- * W6.3 — shared helper for the per-handler `pool.resolve(site_id)`
- * pattern.
- *
- * Every tool handler does the same dance:
- *   1. Extract `site_id` from args (optional, undefined → default site).
- *   2. Call `pool.resolve(site_id)`.
- *   3. Translate `NoDefaultSiteError` / `UnknownSiteError` into a
- *      structured `errorResult` so the agent can self-recover.
- *   4. Hand back `{client, site}` for downstream use.
- *
- * Centralising the dance keeps the 24 handler bodies short and ensures
- * the error wording stays consistent across the tool surface.
- *
- * @license MIT
- */
 import { RestError } from '../errors.js';
 import { NoDefaultSiteError, UnknownSiteError, } from '../sites/client-pool.js';
+import { substitutedRegistryRefusal } from '../sites/substituted-registry.js';
+import { unknownNameResult } from '../sites/unknown-name-result.js';
 import { jsonResult } from './tool-builder.js';
-/**
- * Resolve a site_id through the pool, translating the W4 typed errors
- * into structured `ToolResult` envelopes. Non-typed errors (genuine
- * fetch failures during the platform probe, secret-resolver crashes,
- * etc.) re-throw so the handler's outer try/catch can shape them with
- * domain-specific hints.
- */
 export async function resolveSiteOrError(pool, siteId) {
+    const configProblem = pool.registry.configProblem;
+    if (siteId !== undefined && pool.registry.sitesAreSubstituted && configProblem !== null) {
+        return {
+            ok: false,
+            error: jsonResult(substitutedRegistryRefusal(siteId, configProblem), { isError: true }),
+        };
+    }
     try {
         const { client, site } = await pool.resolve(siteId);
         return { ok: true, client, site };
     }
     catch (e) {
         if (e instanceof NoDefaultSiteError) {
-            // Custom payload to surface `code: 'no_default_site'` —
-            // `errorResult` only forwards `code` for RestError, but
-            // agents branch on `error.code === 'no_default_site'` to
-            // route the user into the setup wizard.
+            const configProblem = pool.registry.configProblem;
+            if (configProblem !== null) {
+                return {
+                    ok: false,
+                    error: jsonResult({
+                        error: 'No site_id supplied and no default site is configured.',
+                        code: e.code,
+                        config_problem: configProblem,
+                        context: { site_id: siteId ?? null },
+                        hint: 'A configured connection was rejected at startup — see config_problem '
+                            + 'for the exact reason. Fix it and restart this server.',
+                    }, { isError: true }),
+                };
+            }
             return {
                 ok: false,
                 error: jsonResult({
@@ -51,61 +47,21 @@ export async function resolveSiteOrError(pool, siteId) {
         if (e instanceof UnknownSiteError) {
             return {
                 ok: false,
-                error: jsonResult({
-                    error: e.message,
+                error: unknownNameResult({
+                    argument: 'site_id',
+                    value: e.siteId,
+                    available: e.available,
                     code: e.code,
-                    context: {
-                        site_id: siteId ?? null,
-                        available: [...e.available],
-                    },
+                    error: e.message,
                     hint: 'The requested site_id is not in the registry. '
                         + 'Use yootheme_builder_sites_list to list configured IDs '
                         + 'and retry with one of them.',
-                }, { isError: true }),
+                }),
             };
         }
-        // Unknown failure (probe crash, secret-resolver crash, etc.) —
-        // re-throw so the handler's domain-specific catch can shape it
-        // with the right hint (e.g. "verify YTB_MCP_SITE_URL …" for a
-        // health probe, "verify the template_id …" for a page op).
         throw e;
     }
 }
-/**
- * W12-R2A (A4-F3 / A5-S2) — resolve a site + execute a handler-body with
- * a 1-shot 401 retry.
- *
- * Bearer-rotation use case: a site's bearer is revoked / rotated /
- * expired AFTER the pool cached a {@link RestClient} for it. The next
- * call returns HTTP 401. Without retry the agent has to be told
- * "restart your client". With retry we drop the cached client (so the
- * next `pool.resolve` re-runs `secretResolver.resolve`), then call the
- * handler-body again exactly once. If the second attempt also returns
- * 401, we surface a structured `bearer_invalid` error with an
- * actionable hint pointing at `sites_test` / sites.json.
- *
- * Scope: deliberately ONE retry. A second 401 means the bearer is
- * genuinely revoked at the source — looping forever wastes tokens and
- * masks the real problem.
- *
- * The wrapper handles {@link NoDefaultSiteError} / {@link
- * UnknownSiteError} via the same `resolveSiteOrError` envelope so
- * call-sites don't have to duplicate the structured-error wording.
- * Non-401 thrown errors propagate to the handler's outer try/catch
- * (or the SDK boundary) untouched — only HTTP 401 triggers the retry
- * / structured-error path.
- *
- * Usage (post-migration):
- *
- *   handler: async ({ site_id, ...rest }) =>
- *     withSiteRetry(pool, site_id, async (client, site) =>
- *       withSiteMeta(await handleX(makeDeps(client), rest), site)),
- */
-/**
- * U2 — the read-only-token fast error returned by the write-tool pre-flight.
- * Mirrors the PHP `read_only_token` chokepoint message so the Node fast path
- * and the REST floor steer the agent identically.
- */
 function readOnlyTokenError(tool) {
     return jsonResult({
         error: `This bearer is read-only — regenerate a write-scoped key in `
@@ -116,27 +72,10 @@ function readOnlyTokenError(tool) {
             + '(YT Builder MCP → Keys).',
     }, { isError: true });
 }
-/**
- * U2 — resolve a site + execute a WRITE handler-body, with a read-only-token
- * PRE-FLIGHT in front of the 1-shot-401 retry.
- *
- * When the resolved site's coarse token scope is KNOWN to be `read` (learned by
- * a prior health / diagnose call — see {@link ClientPool.tokenScope}), the write
- * fails FAST: the read-only error is returned BEFORE the handler runs, so no
- * ETag is fetched and no request body is built — the exact "fail-fast-before-prep"
- * the U2 handoff asks for. An UNKNOWN scope (never probed) does NOT block; the
- * PHP `read_only_token` chokepoint remains the authority, and the fast path is a
- * pure latency/clarity optimisation, never a new gate.
- *
- * `toolName` is surfaced in the fast error so the steer names the exact tool.
- */
 export async function withWriteSiteRetry(pool, siteId, toolName, fn) {
     const r1 = await resolveSiteOrError(pool, siteId);
     if (!r1.ok)
         return r1.error;
-    // Pre-flight: a KNOWN read-only key can never satisfy a write — refuse here,
-    // before any ETag fetch / body build. `undefined` (not yet learned) passes
-    // through to the REST chokepoint, which stays authoritative.
     if (pool.tokenScope(r1.site.id) === 'read') {
         return readOnlyTokenError(toolName);
     }
@@ -148,12 +87,6 @@ export async function withSiteRetry(pool, siteId, fn) {
         return r1.error;
     return withSiteRetryResolved(pool, siteId, fn, r1);
 }
-/**
- * Shared 1-shot-401 retry body. Split out of {@link withSiteRetry} so the U2
- * write pre-flight ({@link withWriteSiteRetry}) can run its read-only check on
- * the ALREADY-resolved site BEFORE entering the retry loop — without resolving
- * the site twice.
- */
 async function withSiteRetryResolved(pool, siteId, fn, r1) {
     try {
         return await fn(r1.client, r1.site);
@@ -162,11 +95,6 @@ async function withSiteRetryResolved(pool, siteId, fn, r1) {
         if (!(e instanceof RestError) || e.status !== 401) {
             throw e;
         }
-        // First attempt got 401 — invalidate the cached client so the
-        // pool re-runs `secretResolver.resolve` (this picks up a rotated
-        // Bearer from `op` / a freshly-edited sites.json) and try once
-        // more. Use the resolved id from r1.site so the invalidation
-        // works even when `siteId` was undefined (default-site case).
         pool.invalidate(r1.site.id);
         const r2 = await resolveSiteOrError(pool, siteId);
         if (!r2.ok)
@@ -176,9 +104,6 @@ async function withSiteRetryResolved(pool, siteId, fn, r1) {
         }
         catch (e2) {
             if (e2 instanceof RestError && e2.status === 401) {
-                // Second 401 — surface a structured error so the agent
-                // can route the user to verification + sites.json edit
-                // instead of silently failing.
                 return jsonResult({
                     error: e2.message,
                     status: 401,

package/dist/tools/pool-resolve-helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"pool-resolve-helper.js","sourceRoot":"","sources":["../../src/tools/pool-resolve-helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAEH,kBAAkB,EAElB,gBAAgB,GACnB,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EAAE,UAAU,EAAmB,MAAM,mBAAmB,CAAC;AAqBhE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACpC,IAAgB,EAChB,MAA0B;IAE1B,IAAI,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACpD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACtC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,IAAI,CAAC,YAAY,kBAAkB,EAAE,CAAC;YAClC,wDAAwD;YACxD,wDAAwD;YACxD,yDAAyD;YACzD,wCAAwC;YACxC,OAAO;gBACH,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,UAAU,CACb;oBACI,KAAK,EAAE,CAAC,CAAC,OAAO;oBAChB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,IAAI,IAAI,EAAE;oBACpC,IAAI,EACA,yDAAyD;0BACvD,4DAA4D;0BAC5D,wDAAwD;0BACxD,6CAA6C;iBACtD,EACD,EAAE,OAAO,EAAE,IAAI,EAAE,CACpB;aACJ,CAAC;QACN,CAAC;QACD,IAAI,CAAC,YAAY,gBAAgB,EAAE,CAAC;YAChC,OAAO;gBACH,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,UAAU,CACb;oBACI,KAAK,EAAE,CAAC,CAAC,OAAO;oBAChB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,OAAO,EAAE;wBACL,OAAO,EAAE,MAAM,IAAI,IAAI;wBACvB,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC;qBAC9B;oBACD,IAAI,EACA,gDAAgD;0BAC9C,yDAAyD;0BACzD,6BAA6B;iBACtC,EACD,EAAE,OAAO,EAAE,IAAI,EAAE,CACpB;aACJ,CAAC;QACN,CAAC;QACD,+DAA+D;QAC/D,+DAA+D;QAC/D,8DAA8D;QAC9D,2DAA2D;QAC3D,MAAM,CAAC,CAAC;IACZ,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,IAAY;IACpC,OAAO,UAAU,CACb;QACI,KAAK,EAAE,8DAA8D;cAC/D,kCAAkC,IAAI,IAAI;QAChD,UAAU,EAAE,iBAAiB;QAC7B,IAAI,EACA,yEAAyE;cACvE,2DAA2D;cAC3D,0BAA0B;KACnC,EACD,EAAE,OAAO,EAAE,IAAI,EAAE,CACpB,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACpC,IAAgB,EAChB,MAA0B,EAC1B,QAAgB,EAChB,EAAmE;IAEnE,MAAM,EAAE,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC,KAAK,CAAC;IAE5B,6EAA6E;IAC7E,2EAA2E;IAC3E,6DAA6D;IAC7D,IAAI,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,MAAM,EAAE,CAAC;QACzC,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAC/B,IAAgB,EAChB,MAA0B,EAC1B,EAAmE;IAEnE,MAAM,EAAE,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC,KAAK,CAAC;IAC5B,OAAO,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,qBAAqB,CAChC,IAAgB,EAChB,MAA0B,EAC1B,EAAmE,EACnE,EAAmF;IAEnF,IAAI,CAAC;QACD,OAAO,MAAM,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,IAAI,CAAC,CAAC,CAAC,YAAY,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAChD,MAAM,CAAC,CAAC;QACZ,CAAC;QACD,8DAA8D;QAC9D,iEAAiE;QACjE,+DAA+D;QAC/D,6DAA6D;QAC7D,8DAA8D;QAC9D,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAE5B,MAAM,EAAE,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC,EAAE,CAAC,EAAE;YAAE,OAAO,EAAE,CAAC,KAAK,CAAC;QAE5B,IAAI,CAAC;YACD,OAAO,MAAM,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,EAAE,EAAE,CAAC;YACV,IAAI,EAAE,YAAY,SAAS,IAAI,EAAE,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC/C,uDAAuD;gBACvD,uDAAuD;gBACvD,+BAA+B;gBAC/B,OAAO,UAAU,CACb;oBACI,KAAK,EAAE,EAAE,CAAC,OAAO;oBACjB,MAAM,EAAE,GAAG;oBACX,IAAI,EAAE,gBAAgB;oBACtB,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE;oBAChC,IAAI,EACA,8DAA8D;0BAC5D,+CAA+C;0BAC/C,4CAA4C;0BAC5C,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,uCAAuC;0BACpD,kDAAkD;iBAC3D,EACD,EAAE,OAAO,EAAE,IAAI,EAAE,CACpB,CAAC;YACN,CAAC;YACD,MAAM,EAAE,CAAC;QACb,CAAC;IACL,CAAC;AACL,CAAC"}
+{"version":3,"file":"pool-resolve-helper.js","sourceRoot":"","sources":["../../src/tools/pool-resolve-helper.ts"],"names":[],"mappings":"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"}

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

@@ -1,45 +1,3 @@
-/**
- * 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";

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"progress-phases.d.ts","sourceRoot":"","sources":["../../src/tools/progress-phases.ts"],"names":[],"mappings":"AA4CA,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 +1,4 @@
-/**
- * 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 +1 @@
-{"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"}
+{"version":3,"file":"progress-phases.js","sourceRoot":"","sources":["../../src/tools/progress-phases.ts"],"names":[],"mappings":"AA4CA,MAAM,CAAC,MAAM,UAAU,GAAG,uBAAuB,CAAC;AAClD,MAAM,CAAC,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAGnD,MAAM,CAAC,MAAM,YAAY,GAAG,mBAAmB,CAAC"}

package/dist/tools/response-budget.d.ts

@@ -1,77 +1,8 @@
 export declare const RESPONSE_BUDGET: {
-    /**
-     * Tools whose largest measured response fell in the lower cluster (k-means
-     * centre 419 chars): status envelopes, single-element reads, binding probes,
-     * etag and diagnose.
-     *
-     * value        1496
-     * population   135 responses from 27 tools
-     * percentile   nearest-rank p99 = rank 134 of 135
-     * captured     2026-07-27, baseline HEAD 65e60f6a5
-     *
-     * At n = 135 the nearest-rank p99 coincides with the class maximum (the top
-     * sizes repeat — every tool was measured 2-8 times). Stated, not hidden: this
-     * is "the largest response this class actually produced", and it will
-     * separate from the maximum only with a larger sample.
-     */
     readonly COMPACT: 1496;
-    /**
-     * Tools whose largest measured response fell in the upper cluster (k-means
-     * centre 5 902 chars): page layouts, element and page schemas, library and
-     * source listings, audits, navigation.
-     *
-     * value        74408
-     * population   182 responses from 33 tools
-     * percentile   nearest-rank p99 = rank 181 of 182
-     * captured     2026-07-27, baseline HEAD 65e60f6a5
-     *
-     * Same n-artefact as COMPACT: p99 == class maximum. The value is carried by
-     * apimapper's `library_catalog` on the ts-fat transport, which the baseline
-     * also flags as a format divergence (§4) — if Task 8C makes that transport
-     * render what PHP renders, this number moves. That is a re-measurement
-     * trigger, not a licence to adjust it by hand.
-     */
     readonly BULKY: 74408;
-    /**
-     * Handlers with NO measured population — every write and mutate tool, which
-     * the read-only baseline sweep deliberately did not call.
-     *
-     * value        4000, inherited from the toolkit's `MAX_RESPONSE_CHARS`
-     * population   none
-     *
-     * "Not decidable" is a legitimate result (P5); inventing a number for an
-     * unmeasured tool is not. These keep the value they have always had, under a
-     * name that says exactly why.
-     */
     readonly UNMEASURED: 4000;
 };
 export type ResponseBudgetName = keyof typeof RESPONSE_BUDGET;
-/**
- * The DEFAULT a COMPACT-class call site uses: `RESPONSE_BUDGET.COMPACT` applied
- * RAISE-ONLY against the inherited budget those sites shipped with.
- *
- * WHY A CLASS VALUE IS NOT DIRECTLY USABLE AS A DEFAULT
- *
- * At the measured n the nearest-rank p99 of this class COINCIDES with its
- * maximum — 1496 is the largest response the class produced, on two dev
- * instances. A default set to a measured maximum fires on the first response
- * larger than anything dev happened to have, i.e. on REGULAR traffic. The plan's
- * own derivation policy rules that out in the same sentence it uses to condemn
- * the inherited 4000: "a default that fires on regular traffic is by definition
- * the wrong default" (2026-07-27-02, Task 5, Herleitungs-POLITIK §1).
- *
- * So the measurement is used in the only direction it supports. Raising a budget
- * can only deliver MORE of a response; lowering one needs evidence that less
- * suffices, and the baseline supplies the opposite — it measured **zero**
- * truncation on the api-mapper PHP transport, and most of these tools declare no
- * `max_chars`, so a caller could not raise it back (P2/P4).
- *
- * `BULKY` needs no such form: at 74408 it is already far above the inherited
- * figure, so adopting it is itself a raise.
- *
- * The PHP twins are `ResponseBudget::COMPACT_DEFAULT` in both plugins; P6 makes
- * the two transports one tool, so the same site must carry the same number on
- * both.
- */
 export declare const COMPACT_DEFAULT: number;
 //# sourceMappingURL=response-budget.d.ts.map

package/dist/tools/response-budget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response-budget.d.ts","sourceRoot":"","sources":["../../src/tools/response-budget.ts"],"names":[],"mappings":"AA2DA,eAAO,MAAM,eAAe;IAC1B;;;;;;;;;;;;;;OAcG;;IAGH;;;;;;;;;;;;;;;OAeG;;IAGH;;;;;;;;;;OAUG;;CAEK,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,eAAe,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,eAAe,QAAgE,CAAC"}
+{"version":3,"file":"response-budget.d.ts","sourceRoot":"","sources":["../../src/tools/response-budget.ts"],"names":[],"mappings":"AA2DA,eAAO,MAAM,eAAe;;;;CAgDlB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,eAAe,CAAC;AA6B9D,eAAO,MAAM,eAAe,QAAgE,CAAC"}

package/dist/tools/response-budget.js

@@ -1,134 +1,7 @@
-// src/tools/response-budget.ts — the DERIVED response budgets.
-//
-// WHY THIS MODULE EXISTS
-//
-// Until 2026-07-27 every budget in both MCP servers descended from one guessed
-// number: the toolkit's `MAX_RESPONSE_CHARS = 4000`, justified as "~1000
-// tokens" at 4 chars/token. Nothing was ever measured against it. When it
-// finally was (`yt-builder-mcp/docs/mcp-response-size-baseline.md`) the guess
-// turned out to sit BELOW the p90 of every measured population and to truncate
-// 13 of 29 yt-builder tools, the worst losing 91.6 % of its response.
-//
-// A fourth budget authority hid underneath: the toolkit's `autoFormatTable` /
-// `tableResult` auto-scale tables to 2 000 chars — a number that appears in
-// neither codebase and that shortened 15 tool/server combinations in the
-// baseline run. Call sites now pass a resolved budget explicitly so that
-// internal scale can never decide again.
-//
-// A budget is now measured (plan 2026-07-27-02, principle P5). The classes and
-// values below come from `yt-builder-mcp/scripts/derive-response-budgets.mjs`,
-// which reads the raw capture behind the baseline document and prints the whole
-// derivation. Re-run it after a re-measurement; never hand-edit these values.
-//
-// WHAT A BUDGET IS FOR, NOW
-//
-// After Task 2 (`max_chars` actually binds), Task 3 (shrinking drops whole
-// entries and says so) and Task 4 (a caller can ask for the fields it needs),
-// the default budget is only the SAFETY NET against a pathological response —
-// not the instrument that keeps normal answers small. A default that fires on
-// regular traffic is by definition the wrong default, which is precisely what
-// the measurement proved about the inherited 4 000.
-//
-// DERIVATION (identical in both servers; the PHP twins live at
-// `yt-builder-mcp/src/modules/core-mcp/src/ResponseBudget.php` and
-// `src/modules/core/src/Mcp/ResponseBudget.php`)
-//
-//   population   321 answered responses, PRE-trim size (`full_text_chars`),
-//                pooled across both transports — P6 makes proxy and fat mode
-//                two paths to one tool, so their sizes are one population.
-//   capture      2026-07-27T17:36:35Z, baseline git HEAD 65e60f6a5,
-//                dev5wp.wootsup.com + dev5j.wootsup.com
-//   classes      1-D k-means over log(size) (Jenks natural breaks); k fixed by
-//                the parameter-free elbow (maximal second difference of the
-//                within-cluster sum of squares) = 2. The distribution is a
-//                continuum with exactly ONE decisive multiplicative break
-//                (8.549x, 74 408 -> 636 143). The plan's guess of three classes
-//                is NOT what the data shows, and reporting that is the point.
-//   membership   a tool belongs to the class its measured MAXIMUM falls in — a
-//                safety net must cover the worst case of the tool it guards.
-//   filter       a tool counts only if BOTH transports answered for it at least
-//                once. `call_status: ok` means the transport delivered a body,
-//                not that the application performed the operation — five tools
-//                (`brandfetch`, `library_activated`, `library_get`,
-//                `sites_list`, `sites_test`) answered on one transport only and
-//                are excluded from class FORMATION. Excluding them leaves both
-//                class values unchanged; it corrects membership, not budgets.
-//   value        nearest-rank p99 of the class population, never interpolated
-//                and never rounded (rounding a measured value to a nicer one is
-//                inventing it again).
 export const RESPONSE_BUDGET = {
-    /**
-     * Tools whose largest measured response fell in the lower cluster (k-means
-     * centre 419 chars): status envelopes, single-element reads, binding probes,
-     * etag and diagnose.
-     *
-     * value        1496
-     * population   135 responses from 27 tools
-     * percentile   nearest-rank p99 = rank 134 of 135
-     * captured     2026-07-27, baseline HEAD 65e60f6a5
-     *
-     * At n = 135 the nearest-rank p99 coincides with the class maximum (the top
-     * sizes repeat — every tool was measured 2-8 times). Stated, not hidden: this
-     * is "the largest response this class actually produced", and it will
-     * separate from the maximum only with a larger sample.
-     */
     COMPACT: 1496,
-    /**
-     * Tools whose largest measured response fell in the upper cluster (k-means
-     * centre 5 902 chars): page layouts, element and page schemas, library and
-     * source listings, audits, navigation.
-     *
-     * value        74408
-     * population   182 responses from 33 tools
-     * percentile   nearest-rank p99 = rank 181 of 182
-     * captured     2026-07-27, baseline HEAD 65e60f6a5
-     *
-     * Same n-artefact as COMPACT: p99 == class maximum. The value is carried by
-     * apimapper's `library_catalog` on the ts-fat transport, which the baseline
-     * also flags as a format divergence (§4) — if Task 8C makes that transport
-     * render what PHP renders, this number moves. That is a re-measurement
-     * trigger, not a licence to adjust it by hand.
-     */
     BULKY: 74408,
-    /**
-     * Handlers with NO measured population — every write and mutate tool, which
-     * the read-only baseline sweep deliberately did not call.
-     *
-     * value        4000, inherited from the toolkit's `MAX_RESPONSE_CHARS`
-     * population   none
-     *
-     * "Not decidable" is a legitimate result (P5); inventing a number for an
-     * unmeasured tool is not. These keep the value they have always had, under a
-     * name that says exactly why.
-     */
     UNMEASURED: 4000,
 };
-/**
- * The DEFAULT a COMPACT-class call site uses: `RESPONSE_BUDGET.COMPACT` applied
- * RAISE-ONLY against the inherited budget those sites shipped with.
- *
- * WHY A CLASS VALUE IS NOT DIRECTLY USABLE AS A DEFAULT
- *
- * At the measured n the nearest-rank p99 of this class COINCIDES with its
- * maximum — 1496 is the largest response the class produced, on two dev
- * instances. A default set to a measured maximum fires on the first response
- * larger than anything dev happened to have, i.e. on REGULAR traffic. The plan's
- * own derivation policy rules that out in the same sentence it uses to condemn
- * the inherited 4000: "a default that fires on regular traffic is by definition
- * the wrong default" (2026-07-27-02, Task 5, Herleitungs-POLITIK §1).
- *
- * So the measurement is used in the only direction it supports. Raising a budget
- * can only deliver MORE of a response; lowering one needs evidence that less
- * suffices, and the baseline supplies the opposite — it measured **zero**
- * truncation on the api-mapper PHP transport, and most of these tools declare no
- * `max_chars`, so a caller could not raise it back (P2/P4).
- *
- * `BULKY` needs no such form: at 74408 it is already far above the inherited
- * figure, so adopting it is itself a raise.
- *
- * The PHP twins are `ResponseBudget::COMPACT_DEFAULT` in both plugins; P6 makes
- * the two transports one tool, so the same site must carry the same number on
- * both.
- */
 export const COMPACT_DEFAULT = Math.max(RESPONSE_BUDGET.COMPACT, RESPONSE_BUDGET.UNMEASURED);
 //# sourceMappingURL=response-budget.js.map

package/dist/tools/response-budget.js.map

@@ -1 +1 @@
-{"version":3,"file":"response-budget.js","sourceRoot":"","sources":["../../src/tools/response-budget.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,yBAAyB;AACzB,EAAE;AACF,+EAA+E;AAC/E,yEAAyE;AACzE,0EAA0E;AAC1E,8EAA8E;AAC9E,+EAA+E;AAC/E,sEAAsE;AACtE,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,yEAAyE;AACzE,yEAAyE;AACzE,yCAAyC;AACzC,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,8EAA8E;AAC9E,EAAE;AACF,4BAA4B;AAC5B,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAC9E,oDAAoD;AACpD,EAAE;AACF,+DAA+D;AAC/D,mEAAmE;AACnE,iDAAiD;AACjD,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,2EAA2E;AAC3E,oEAAoE;AACpE,wDAAwD;AACxD,+EAA+E;AAC/E,4EAA4E;AAC5E,2EAA2E;AAC3E,0EAA0E;AAC1E,gFAAgF;AAChF,8EAA8E;AAC9E,+EAA+E;AAC/E,6EAA6E;AAC7E,gFAAgF;AAChF,+EAA+E;AAC/E,+EAA+E;AAC/E,oEAAoE;AACpE,gFAAgF;AAChF,+EAA+E;AAC/E,8EAA8E;AAC9E,8EAA8E;AAC9E,gFAAgF;AAChF,sCAAsC;AAEtC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B;;;;;;;;;;;;;;OAcG;IACH,OAAO,EAAE,IAAI;IAEb;;;;;;;;;;;;;;;OAeG;IACH,KAAK,EAAE,KAAK;IAEZ;;;;;;;;;;OAUG;IACH,UAAU,EAAE,IAAI;CACR,CAAC;AAIX;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC"}
+{"version":3,"file":"response-budget.js","sourceRoot":"","sources":["../../src/tools/response-budget.ts"],"names":[],"mappings":"AA2DA,MAAM,CAAC,MAAM,eAAe,GAAG;IAgB7B,OAAO,EAAE,IAAI;IAkBb,KAAK,EAAE,KAAK;IAaZ,UAAU,EAAE,IAAI;CACR,CAAC;AA+BX,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC"}

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

@@ -1,73 +1,19 @@
-/**
- * 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 TEMPLATE_ID_OPTIONAL: z.ZodOptional<z.ZodString>;
-export declare const POST_ID: z.ZodOptional<z.ZodNumber>;
+export declare const LAYOUT_ID: z.ZodString;
+export declare const LAYOUT_ID_OPTIONAL: z.ZodOptional<z.ZodString>;
+export declare const RESOLVED_LAYOUT_ID_OUTPUT: {
+    readonly resolved_layout_id: z.ZodOptional<z.ZodString>;
+    readonly resolved_via: z.ZodOptional<z.ZodEnum<{
+        prefixed: "prefixed";
+        theme_template: "theme_template";
+        content_id: "content_id";
+    }>>;
+};
 export declare const RESOLVE_URL: z.ZodOptional<z.ZodString>;
 export declare const ELEMENT_PATH: z.ZodString;
-/**
- * Write-response ETag convention (SSOT — PAGES_LIBRARY_MEDIA-18 doc note).
- *
- * Every write tool's response carries the POST-WRITE state as its chainable
- * ETag. Concretely, at the MCP boundary:
- *   - `etag`     — the POST-WRITE current value (safe to chain straight into the
- *                  next write's If-Match), IDENTICAL to `new_etag` where both are
- *                  emitted.
- *   - `new_etag` — the post-write value too (kept for callers reading either name).
- *
- * This is the SOURCES_BINDING-16 decision: `element_set_source` / `template_set_type`
- * emit a pre-write `etag` in their PHP body, and their TS handlers NORMALISE it to
- * the post-write value so `etag` is ALWAYS chainable; `pages_create` / `pages_delete`
- * already emit both fields at the post-write value. So an agent can chain `etag`
- * OR `new_etag` from ANY write and it never 412s a first follow-up write.
- *
- * NOTE: PAGES_LIBRARY_MEDIA-18 proposed the OPPOSITE (`etag` = echo of the caller's
- * input, `new_etag` = post-write). That was NOT adopted — it contradicts the shipped
- * + tested SOURCES_BINDING-16 convention and would strand the caller's first chained
- * write on a stale value. Any move to the echo convention needs Thomas's sign-off
- * (it is a behavioural reversal, not a standardisation).
- */
 export declare const ETAG: z.ZodString;
+export declare const ETAG_PREVIEW_OPTIONAL: z.ZodString;
 export declare const PROPS: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-/**
- * W5 — Multi-Site selector. Every tool exposes this field as an OPTIONAL
- * first-position input so an agent can target a specific site while
- * defaulting to the primary site when omitted. The handler bodies do not
- * yet read this field — W6 wires `pool.resolve(site_id)` into each
- * handler. Keep this addition non-breaking: the regex is permissive enough
- * to allow customer ids like `wp-acme` or `joomla_beta`, and the field is
- * optional so existing clients continue to work without modification.
- */
 export declare const SITE_ID_SCHEMA: z.ZodOptional<z.ZodString>;
-/**
- * T-C3 (mega-push, customer P1.3/K4) — per-call opt-out for the toolkit's
- * embedded `_meta.ui` Rich-Card payload on table-shaped results. The
- * `@getimo/mcp-toolkit` `tableResult()` builder can attach a base64
- * `<!-- structured-meta:… -->` marker to the visible text (on top of the
- * sibling result-level `_meta`) so the payload survives `@ai-sdk/mcp`
- * stripping `_meta` for a host chat UI that renders it as rich cards — but on
- * a generic MCP host (Claude Desktop / Cursor / Claude Code / Zed) nothing
- * renders it, so an agent that only reads `content[].text` pays pure token
- * cost for a payload it cannot use.
- *
- * T-C3b (2026-07-24, Thomas follow-up decision): default flipped to `false`.
- * Every WootsUp customer runs on a generic MCP host, so the lean response is
- * now the out-of-the-box behaviour. Set `true` to opt back into the
- * Rich-Card payload (e.g. a future WootsUp-owned Chat UI).
- *
- * T-C3c (native `@getimo/mcp-toolkit@1.2.0` migration): this value is now
- * threaded straight into the toolkit builder's own `includeMeta` option
- * (`tableResult(items, { ...opts, includeMeta: include_meta })`) — the
- * toolkit natively skips allocating the payload when `false`, rather than a
- * consumer-side shim building then stripping it.
- */
 export declare const INCLUDE_META_SCHEMA: z.ZodDefault<z.ZodBoolean>;
 //# sourceMappingURL=shared-schemas.d.ts.map

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

@@ -1 +1 @@
-{"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,aAUnB,CAAC;AAaN,eAAO,MAAM,oBAAoB,4BAS5B,CAAC;AAEN,eAAO,MAAM,OAAO,4BASf,CAAC;AAEN,eAAO,MAAM,WAAW,4BASnB,CAAC;AAEN,eAAO,MAAM,YAAY,aAgBpB,CAAC;AAEN;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,IAAI,aAYZ,CAAC;AAEN,eAAO,MAAM,KAAK,wCAKb,CAAC;AAEN;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,4BAOtB,CAAC;AAEN;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,mBAAmB,4BAO3B,CAAC"}
+{"version":3,"file":"shared-schemas.d.ts","sourceRoot":"","sources":["../../src/tools/shared-schemas.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,SAAS,aAWjB,CAAC;AAKN,eAAO,MAAM,kBAAkB,4BAQ1B,CAAC;AAmBN,eAAO,MAAM,yBAAyB;;;;;;;CAG5B,CAAC;AAEX,eAAO,MAAM,WAAW,4BASnB,CAAC;AAEN,eAAO,MAAM,YAAY,aAkBpB,CAAC;AAwBN,eAAO,MAAM,IAAI,aAiBZ,CAAC;AAsCN,eAAO,MAAM,qBAAqB,aAW7B,CAAC;AAoBN,eAAO,MAAM,KAAK,wCAMb,CAAC;AAyBN,eAAO,MAAM,cAAc,4BAOtB,CAAC;AAwBN,eAAO,MAAM,mBAAmB,4BAS3B,CAAC"}