@wootsup/yt-builder-mcp 1.11.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

@@ -0,0 +1,8 @@
+export declare const RESPONSE_BUDGET: {
+    readonly COMPACT: 1496;
+    readonly BULKY: 74408;
+    readonly UNMEASURED: 4000;
+};
+export type ResponseBudgetName = keyof typeof RESPONSE_BUDGET;
+export declare const COMPACT_DEFAULT: number;
+//# sourceMappingURL=response-budget.d.ts.map

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

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

@@ -0,0 +1,7 @@
+export const RESPONSE_BUDGET = {
+    COMPACT: 1496,
+    BULKY: 74408,
+    UNMEASURED: 4000,
+};
+export const COMPACT_DEFAULT = Math.max(RESPONSE_BUDGET.COMPACT, RESPONSE_BUDGET.UNMEASURED);
+//# sourceMappingURL=response-budget.js.map

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

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

package/dist/tools/shared-schemas.js

@@ -1,124 +1,69 @@
-/**
- * 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
+export const LAYOUT_ID = z
     .string()
     .min(1)
-    .describe(
-// F206 (P3): name the argument key explicitly and rule out the
-// look-alikes. The Desktop client guessed `page_id` / `id` for tools
-// that take this schema; the arg key is `template_id` (NOT `page_id`,
-// NOT `id`). Use yootheme_builder_pages_list to discover valid values.
-'Template ID (e.g. "default"). The argument key is `template_id` ' +
-    '(NOT `page_id`, NOT `id`). Use yootheme_builder_pages_list to discover.');
-// F-102 (2026-05-26): the input-arg name is **`element_path`** (NOT
-// `element_rel_path`). `rel_path` is a PROJECTION COLUMN name on the
-// output of `element_list` / `page_get_schema` — copy its VALUE back
-// here as `element_path`. The disambiguation is baked into the
-// `.describe()` string so the LLM sees it at every call site that
-// reuses this shared schema. There is no `element_rel_path` server
-// argument anywhere.
-// G-A (Track-C URL→layout): the three interchangeable addressing modes a
-// read tool accepts. `template_id` becomes optional (one of the three is
-// required); `post_id` and `url` are the cold-agent fast-paths so ONE MCP
-// call reaches a layout from a bare numeric id or a pasted public URL.
-export const TEMPLATE_ID_OPTIONAL = z
+    .describe('Which layout: "page:42", "article:12", "default", or a bare id (42). ' +
+    'Use yootheme_builder_pages_list to discover.');
+export const LAYOUT_ID_OPTIONAL = z
     .string()
     .min(1)
     .optional()
-    .describe('Template ID (e.g. "default" or "page:42"). Use yootheme_builder_pages_list ' +
-    'to discover. OPTIONAL — instead you may pass `post_id` (a numeric ' +
-    'WP post-id / Joomla article-id) or `url` (a public page URL). Exactly ' +
-    'one of template_id / post_id / url is required.');
-export const POST_ID = z
-    .number()
-    .int()
-    .positive()
-    .optional()
-    .describe('A numeric WordPress post-id / Joomla article-id (e.g. 6420). Resolves ' +
-    'directly to that page\'s per-page layout — no need to know the ' +
-    '`page:`/`article:` prefix. Alternative to template_id / url.');
+    .describe('Which layout: "page:42", "article:12", "default", or a bare id (42). ' +
+    'Use yootheme_builder_pages_list to discover. OPTIONAL — instead you may ' +
+    'pass `url` (a public page URL). Exactly one of layout_id / url is required.');
+export const RESOLVED_LAYOUT_ID_OUTPUT = {
+    resolved_layout_id: z.string().optional(),
+    resolved_via: z.enum(['prefixed', 'theme_template', 'content_id']).optional(),
+};
 export const RESOLVE_URL = z
     .string()
     .min(1)
     .optional()
     .describe('A public frontend URL of the page (e.g. "https://site.com/schedule-demo/"). ' +
     'Resolved to the per-page layout in one call — paste a URL, get the layout. ' +
-    'Alternative to template_id / post_id. 404s for theme-template URLs ' +
+    'Alternative to layout_id. 404s for theme-template URLs ' +
     '(use yootheme_builder_pages_list instead).');
 export const ELEMENT_PATH = z
     .string()
     .min(1)
-    .describe(
-// Wave-16 #34 (6.3): lead with the standard JSON-Pointer (RFC-6901)
-// docstring so every element_path param across all tools opens with
-// the canonical form + the enumerate-paths pointer. F165 (2026-06-11)
-// tightened the trailing essay; the F-102 disambiguation
-// (element_path is the INPUT arg, element_rel_path is only the
-// element_list projection COLUMN) stays load-bearing.
-'JSON-Pointer (RFC-6901) style: /0/children/1. ' +
+    .describe('JSON-Pointer (RFC-6901) style, RELATIVE to the layout root: ' +
+    '/children/0/children/1. ' +
     'Use yootheme_builder_element_list to enumerate valid paths. ' +
-    'Preferred: copy a `rel_path` VALUE from element_list (e.g. ' +
-    '`/children/0`); fully-qualified pointers also work. The arg is ' +
-    '`element_path`; `element_rel_path` is only the list projection ' +
-    'column, not an input arg.');
-/**
- * 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).
- */
+    'Copy a `rel_path` value as `element_path`; `element_rel_path` is ' +
+    'only that list column, not an input arg.');
 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. ' +
-    'Note (Wave-8 C2 2026-05-29): every successful write returns a NEW ' +
-    'ETag in the response body — use that next-ETag for the following ' +
-    'call, do NOT reuse the same value across multiple writes (the server ' +
-    'bumps a monotonic revision per persist, so byte-identical state ' +
-    'still surfaces as a distinct ETag).');
+    .describe('Staleness check from yootheme_builder_get_etag, not a lock: it does NOT ' +
+    'stop two writers overwriting each other. Call get_etag first, pass the ' +
+    'value here. It covers the WHOLE site, so a 412 can come from a write to ' +
+    'a DIFFERENT page; re-read and retry with the `expected_etag` the refusal ' +
+    'names. Every successful write returns a NEW ETag; use that next, do not ' +
+    'reuse a prior value.');
+export const ETAG_PREVIEW_OPTIONAL = z
+    .string()
+    .min(1)
+    .describe('Staleness check from yootheme_builder_get_etag, not a lock: it does NOT ' +
+    'stop two writers overwriting each other. A real write needs it: without ' +
+    'it, 428. A preview mutates nothing and may omit it. It covers the WHOLE ' +
+    'site, so a 412 can come from a write to a DIFFERENT page; retry with the ' +
+    '`expected_etag` the refusal names. A stale value returns 412 even on a ' +
+    'preview. Every successful write returns a NEW ETag; use that next, do ' +
+    'not reuse a prior value.');
 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.');
-/**
- * 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.
- */
+    .describe('Element props object. Keys are PER element_type — a `headline` takes ' +
+    '`{content: "Our Services", title_element: "h2"}`; it has no `title` key. ' +
+    'Read the keys of YOUR type first with yootheme_builder_element_type_get_schema.');
 export const SITE_ID_SCHEMA = z.string()
     .min(1).max(64)
     .regex(/^[a-zA-Z0-9_-]+$/, 'site_id uses letters/digits/dash/underscore only')
     .optional()
-    .describe('Target site (e.g., "wp-acme"). Omit to use the default site. ' +
-    'Use yootheme_builder_sites_list to discover available IDs.');
+    .describe('Target site (e.g. "wp-acme"). Omit for the ACTIVE site (use_site) ' +
+    'else the default site. IDs: yootheme_builder_sites_list.');
+export const INCLUDE_META_SCHEMA = z.boolean()
+    .default(false)
+    .describe('Include the Rich-Card `_meta` payload (base64, appended to table ' +
+    'text). Default false (no MCP host renders it); table text is ' +
+    'unaffected.');
 //# sourceMappingURL=shared-schemas.js.map

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

@@ -1 +1 @@
-{"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;AACL,+DAA+D;AAC/D,qEAAqE;AACrE,sEAAsE;AACtE,uEAAuE;AACvE,kEAAkE;IAC9D,yEAAyE,CAChF,CAAC;AAEN,oEAAoE;AACpE,qEAAqE;AACrE,qEAAqE;AACrE,+DAA+D;AAC/D,kEAAkE;AAClE,mEAAmE;AACnE,qBAAqB;AACrB,yEAAyE;AACzE,yEAAyE;AACzE,0EAA0E;AAC1E,uEAAuE;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAChC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,EAAE;KACV,QAAQ,CACL,6EAA6E;IACzE,oEAAoE;IACpE,wEAAwE;IACxE,iDAAiD,CACxD,CAAC;AAEN,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC;KACnB,MAAM,EAAE;KACR,GAAG,EAAE;KACL,QAAQ,EAAE;KACV,QAAQ,EAAE;KACV,QAAQ,CACL,wEAAwE;IACpE,iEAAiE;IACjE,8DAA8D,CACrE,CAAC;AAEN,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACvB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,EAAE;KACV,QAAQ,CACL,8EAA8E;IAC1E,6EAA6E;IAC7E,qEAAqE;IACrE,4CAA4C,CACnD,CAAC;AAEN,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KACxB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ;AACL,oEAAoE;AACpE,oEAAoE;AACpE,sEAAsE;AACtE,yDAAyD;AACzD,+DAA+D;AAC/D,sDAAsD;AACtD,gDAAgD;IAC5C,8DAA8D;IAC9D,6DAA6D;IAC7D,iEAAiE;IACjE,iEAAiE;IACjE,2BAA2B,CAClC,CAAC;AAEN;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC;KAChB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CACL,mEAAmE;IAC/D,sEAAsE;IACtE,2DAA2D;IAC3D,oEAAoE;IACpE,mEAAmE;IACnE,uEAAuE;IACvE,kEAAkE;IAClE,qCAAqC,CAC5C,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;AAEN;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE;KACnC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;KACd,KAAK,CAAC,kBAAkB,EAAE,kDAAkD,CAAC;KAC7E,QAAQ,EAAE;KACV,QAAQ,CACL,+DAA+D;IAC/D,4DAA4D,CAC/D,CAAC"}
+{"version":3,"file":"shared-schemas.js","sourceRoot":"","sources":["../../src/tools/shared-schemas.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC;KACrB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CAML,uEAAuE;IACnE,8CAA8C,CACrD,CAAC;AAKN,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAC9B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,EAAE;KACV,QAAQ,CACL,uEAAuE;IACnE,0EAA0E;IAC1E,6EAA6E,CACpF,CAAC;AAmBN,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACrC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,gBAAgB,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE;CACvE,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACvB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,EAAE;KACV,QAAQ,CACL,8EAA8E;IAC1E,6EAA6E;IAC7E,yDAAyD;IACzD,4CAA4C,CACnD,CAAC;AAEN,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KACxB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CAUL,8DAA8D;IAC1D,0BAA0B;IAC1B,8DAA8D;IAC9D,mEAAmE;IACnE,0CAA0C,CACjD,CAAC;AAwBN,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC;KAChB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CAQL,0EAA0E;IACtE,yEAAyE;IACzE,0EAA0E;IAC1E,2EAA2E;IAC3E,0EAA0E;IAC1E,sBAAsB,CAC7B,CAAC;AAsCN,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACjC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CACL,0EAA0E;IACtE,0EAA0E;IAC1E,0EAA0E;IAC1E,2EAA2E;IAC3E,yEAAyE;IACzE,wEAAwE;IACxE,0BAA0B,CACjC,CAAC;AAoBN,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC;KACjB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;KAC/B,QAAQ,CACL,uEAAuE;IACnE,2EAA2E;IAC3E,iFAAiF,CACxF,CAAC;AAyBN,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE;KACnC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;KACd,KAAK,CAAC,kBAAkB,EAAE,kDAAkD,CAAC;KAC7E,QAAQ,EAAE;KACV,QAAQ,CACL,oEAAoE;IACpE,0DAA0D,CAC7D,CAAC;AAwBN,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,OAAO,EAAE;KACzC,OAAO,CAAC,KAAK,CAAC;KACd,QAAQ,CAIL,mEAAmE;IACnE,+DAA+D;IAC/D,aAAa,CAChB,CAAC"}

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

@@ -0,0 +1,3 @@
+import { type ServedToolDefinition } from '../tool-builder.js';
+export declare function buildSkillTools(): readonly ServedToolDefinition[];
+//# sourceMappingURL=builders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/skill/builders.ts"],"names":[],"mappings":"AA8BA,OAAO,EAIH,KAAK,oBAAoB,EAC5B,MAAM,oBAAoB,CAAC;AA8B5B,wBAAgB,eAAe,IAAI,SAAS,oBAAoB,EAAE,CAsFjE"}