@wootsup/yt-builder-mcp 1.1.7 → 1.3.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/sublayout/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACH,+BAA+B,EAC/B,sBAAsB,EACtB,KAAK,oBAAoB,GAC5B,MAAM,gCAAgC,CAAC"}

package/dist/tools/sublayout/index.js

@@ -0,0 +1,13 @@
+/**
+ * Sublayout tool barrel — public entry-point for the YT5 `< SUBLAYOUT`
+ * inspection tool (F154 / F93).
+ *
+ *   yootheme_builder_inspect_sublayout
+ *     → Report the fragment subtree (bindable leaves) + the render-time inner
+ *       grid (gated props) for a panel/grid_item.
+ *
+ * @license MIT
+ */
+export { buildSublayoutTools } from './builders.js';
+export { INSPECT_SUBLAYOUT_OUTPUT_SCHEMA, handleInspectSublayout, } from './inspect-sublayout-handler.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/sublayout/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACH,+BAA+B,EAC/B,sBAAsB,GAEzB,MAAM,gCAAgC,CAAC"}

package/dist/tools/sublayout/inspect-sublayout-handler.d.ts

@@ -0,0 +1,95 @@
+/**
+ * `inspect_sublayout` handler — surfaces the YT5 `< SUBLAYOUT` mechanism
+ * (F154 / F93) via REST round-trip.
+ *
+ * YT5's `< SUBLAYOUT` breadcrumb conflates TWO structurally different things:
+ *
+ *  1. The `fragment` element — a real container node whose bind-able leaves
+ *     (title, meta, crest image) live in `fragment.children[...]`, NOT on the
+ *     `panel`/`grid_item` the Customizer first selected.
+ *  2. The render-time inner grid — `panel`/`grid_item` build a `uk-grid` from
+ *     PROPS injected by the container at render. There is NO JSON node for it,
+ *     and it is GATED: the inner wrapper is only emitted when
+ *     `title_align === 'left'` / `image_align ∈ {left,right}`. Patching
+ *     `title_grid_width` without first satisfying the gate is a SILENT no-op.
+ *
+ * Companion of the PHP `SublayoutInspector` — see
+ * src/modules/builder-source-binding/src/SublayoutInspector.php for the
+ * report shape. Mirrors the `inspect_multi_items_binding` handler:
+ * optional InspectionCache keyed on (template_id, element_path, global-etag).
+ *
+ * @license MIT
+ */
+import { z } from 'zod';
+import { type RestClient } from '../../client.js';
+import { type ToolResult } from '../tool-builder.js';
+import { InspectionCache } from '../multi-items/inspection-cache.js';
+export declare const INSPECT_SUBLAYOUT_OUTPUT_SCHEMA: z.ZodObject<{
+    template_id: z.ZodString;
+    report: z.ZodObject<{
+        element_path: z.ZodString;
+        element_type: z.ZodString;
+        is_sublayout_capable: z.ZodBoolean;
+        fragments: z.ZodArray<z.ZodObject<{
+            fragment_path: z.ZodString;
+            child_count: z.ZodNumber;
+            bindable_leaves: z.ZodArray<z.ZodObject<{
+                leaf_path: z.ZodString;
+                element_type: z.ZodString;
+                bindable_props: z.ZodArray<z.ZodString>;
+                is_bound: z.ZodBoolean;
+                bound_source_name: z.ZodNullable<z.ZodString>;
+                bound_source_exists: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        grid: z.ZodObject<{
+            title: z.ZodObject<{
+                gate_prop: z.ZodString;
+                gate_value: z.ZodNullable<z.ZodString>;
+                gate_satisfied: z.ZodBoolean;
+                active_props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>;
+            image: z.ZodObject<{
+                gate_prop: z.ZodString;
+                gate_value: z.ZodNullable<z.ZodString>;
+                gate_satisfied: z.ZodBoolean;
+                active_props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        warnings: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            props: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            gate_prop: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        no_sublayout: z.ZodBoolean;
+    }, z.core.$strip>;
+    etag: z.ZodString;
+    hint: z.ZodOptional<z.ZodObject<{
+        severity: z.ZodEnum<{
+            advisory: "advisory";
+            blocking: "blocking";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Severity of the advisory hint attached to every report. */
+export type HintSeverity = 'advisory' | 'blocking';
+/** The structured inspect payload the handler caches + emits. */
+type InspectStructured = Record<string, unknown>;
+export interface SublayoutHandlerDeps {
+    readonly client: RestClient;
+    /**
+     * Optional inspection cache. When provided, results are keyed on
+     * (template_id, element_path, global-etag) with a 60s TTL. A write bumps
+     * the global etag and naturally invalidates the entry. Omit to disable
+     * caching (e.g. shape-pin tests that assert the raw round-trip).
+     */
+    readonly cache?: InspectionCache<InspectStructured>;
+}
+export declare function handleInspectSublayout({ client, cache }: SublayoutHandlerDeps, { template_id, element_path }: {
+    template_id: string;
+    element_path: string;
+}): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=inspect-sublayout-handler.d.ts.map

package/dist/tools/sublayout/inspect-sublayout-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-sublayout-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/sublayout/inspect-sublayout-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAuC,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACvF,OAAO,EAA6C,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhG,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAoCrE,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuB1C,CAAC;AAEH,8DAA8D;AAC9D,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,UAAU,CAAC;AAEnD,iEAAiE;AACjE,KAAK,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,MAAM,WAAW,oBAAoB;IACjC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;CACvD;AAyED,wBAAsB,sBAAsB,CACxC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,oBAAoB,EACvC,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC7E,OAAO,CAAC,UAAU,CAAC,CAuCrB"}

package/dist/tools/sublayout/inspect-sublayout-handler.js

@@ -0,0 +1,181 @@
+/**
+ * `inspect_sublayout` handler — surfaces the YT5 `< SUBLAYOUT` mechanism
+ * (F154 / F93) via REST round-trip.
+ *
+ * YT5's `< SUBLAYOUT` breadcrumb conflates TWO structurally different things:
+ *
+ *  1. The `fragment` element — a real container node whose bind-able leaves
+ *     (title, meta, crest image) live in `fragment.children[...]`, NOT on the
+ *     `panel`/`grid_item` the Customizer first selected.
+ *  2. The render-time inner grid — `panel`/`grid_item` build a `uk-grid` from
+ *     PROPS injected by the container at render. There is NO JSON node for it,
+ *     and it is GATED: the inner wrapper is only emitted when
+ *     `title_align === 'left'` / `image_align ∈ {left,right}`. Patching
+ *     `title_grid_width` without first satisfying the gate is a SILENT no-op.
+ *
+ * Companion of the PHP `SublayoutInspector` — see
+ * src/modules/builder-source-binding/src/SublayoutInspector.php for the
+ * report shape. Mirrors the `inspect_multi_items_binding` handler:
+ * optional InspectionCache keyed on (template_id, element_path, global-etag).
+ *
+ * @license MIT
+ */
+import { z } from 'zod';
+import { encodeElementPath, encodeTemplateId } from '../../client.js';
+import { errorResult, jsonResult, structuredResult } from '../tool-builder.js';
+import { capInspectionDepth } from '../multi-items/format/inspection-format.js';
+/** A single render-time inner-grid axis (title | image). */
+const GRID_AXIS_SCHEMA = z.object({
+    gate_prop: z.string(),
+    gate_value: z.string().nullable(),
+    gate_satisfied: z.boolean(),
+    active_props: z.record(z.string(), z.unknown()),
+});
+/** A bindable leaf inside a fragment subtree. */
+const BINDABLE_LEAF_SCHEMA = z.object({
+    leaf_path: z.string(),
+    element_type: z.string(),
+    bindable_props: z.array(z.string()),
+    is_bound: z.boolean(),
+    bound_source_name: z.string().nullable(),
+    // null when the registry is not wired (UNKNOWN, never a false miss).
+    bound_source_exists: z.boolean().nullable().optional(),
+});
+/** A direct fragment child of the addressed container. */
+const FRAGMENT_SCHEMA = z.object({
+    fragment_path: z.string(),
+    child_count: z.number().int().nonnegative(),
+    bindable_leaves: z.array(BINDABLE_LEAF_SCHEMA),
+});
+/** A single enrichment-hazard warning. */
+const SUBLAYOUT_WARNING_SCHEMA = z.object({
+    code: z.string(),
+    message: z.string(),
+    props: z.array(z.string()).optional(),
+    gate_prop: z.string().optional(),
+});
+export const INSPECT_SUBLAYOUT_OUTPUT_SCHEMA = z.object({
+    template_id: z.string(),
+    report: z.object({
+        element_path: z.string(),
+        element_type: z.string(),
+        is_sublayout_capable: z.boolean(),
+        fragments: z.array(FRAGMENT_SCHEMA),
+        grid: z.object({
+            title: GRID_AXIS_SCHEMA,
+            image: GRID_AXIS_SCHEMA,
+        }),
+        warnings: z.array(SUBLAYOUT_WARNING_SCHEMA),
+        no_sublayout: z.boolean(),
+    }),
+    etag: z.string(),
+    // Typed advisory/blocking marker. `blocking` when an ungated grid prop is
+    // a silent no-op (the trap this tool exists for); `advisory` otherwise.
+    hint: z
+        .object({
+        severity: z.enum(['advisory', 'blocking']),
+        message: z.string(),
+    })
+        .optional(),
+});
+/**
+ * Classify the report into an advisory/blocking hint.
+ *
+ * Precedence: an `ungated_grid_prop` warning (a silent no-op — the trap this
+ * tool exists for) is `blocking`; everything else is `advisory`. A
+ * sublayout-less element gets a short "nothing to enrich" advisory so the
+ * agent does not keep probing.
+ */
+function buildHint(report) {
+    const r = (report ?? {});
+    const warnings = Array.isArray(r.warnings)
+        ? r.warnings
+        : [];
+    const ungated = warnings.find((w) => w.code === 'ungated_grid_prop');
+    if (ungated !== undefined && typeof ungated.message === 'string' && ungated.message !== '') {
+        return { severity: 'blocking', message: ungated.message };
+    }
+    if (r.no_sublayout === true) {
+        return {
+            severity: 'advisory',
+            message: 'This element has no `fragment` sublayout child and no inner-grid ' +
+                'props — there is nothing to enrich here. Bind a source directly on a ' +
+                'leaf via yootheme_builder_element_bind_source, or add a fragment first.',
+        };
+    }
+    if (r.is_sublayout_capable === false) {
+        return {
+            severity: 'advisory',
+            message: 'This element type is not sublayout-capable (panel / grid_item). The ' +
+                'fragment subtree + inner-grid gate apply only to those containers.',
+        };
+    }
+    return {
+        severity: 'advisory',
+        message: 'Sublayout looks consistent. Bind the source on a `fragment.children` leaf ' +
+            '(use a leaf_path from the report), NOT on this container. Inner-grid props ' +
+            'only take effect when their gate (title_align=left / image_align=left|right) ' +
+            'is satisfied.',
+    };
+}
+/**
+ * Render a structured inspect payload into the ToolResult envelope. The text
+ * leg is depth-capped so a deeply-nested report cannot balloon the LLM
+ * context; structuredContent stays verbatim so it keeps validating against
+ * INSPECT_SUBLAYOUT_OUTPUT_SCHEMA (additionalProperties:false).
+ */
+function renderInspectResult(structured) {
+    const text = jsonResult(capInspectionDepth(structured));
+    return structuredResult(text, structured);
+}
+export async function handleInspectSublayout({ client, cache }, { template_id, element_path }) {
+    const encoded = encodeElementPath(element_path);
+    try {
+        // When a cache is wired, key on the GLOBAL state etag. Every write
+        // bumps it, so a mutated template surfaces a fresh etag → a new key →
+        // a guaranteed miss. Read-only repeats within the TTL skip the inspect
+        // round-trip below.
+        let cacheEtag;
+        if (cache !== undefined) {
+            cacheEtag = await fetchStateEtag(client);
+            if (cacheEtag !== undefined) {
+                const cached = cache.get(template_id, element_path, cacheEtag);
+                if (cached !== undefined) {
+                    return renderInspectResult(cached);
+                }
+            }
+        }
+        const data = await client.get(`/pages/${encodeTemplateId(template_id)}/elements/${encoded}/sublayout/inspect`);
+        const hint = buildHint(data.report);
+        const structured = { ...data, hint };
+        if (cache !== undefined && cacheEtag !== undefined) {
+            cache.set(template_id, element_path, cacheEtag, structured);
+        }
+        return renderInspectResult(structured);
+    }
+    catch (e) {
+        return errorResult({
+            error: e,
+            context: { template_id, element_path },
+            hint: 'Pass the CONTAINER element_path (a `panel` or `grid_item`) — the tool ' +
+                'descends into its fragment child itself. Verify the path via ' +
+                'yootheme_builder_element_list (JSON-Pointer, RFC-6901: /0/children/1).',
+        });
+    }
+}
+/**
+ * Read the global state ETag used as the cache-invalidation token. Returns
+ * `undefined` (cache disabled for this call) if the etag probe fails or
+ * returns a non-string — a missing etag must never poison the cache key, and
+ * a probe failure should fall through to a live inspect rather than abort.
+ */
+async function fetchStateEtag(client) {
+    try {
+        const res = await client.get('/etag');
+        return typeof res.etag === 'string' && res.etag !== '' ? res.etag : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=inspect-sublayout-handler.js.map

package/dist/tools/sublayout/inspect-sublayout-handler.js.map

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

package/dist/tools/tool-builder/results.d.ts

@@ -12,6 +12,25 @@
  */
 import type { ResolvedSite } from '../../sites/registry.js';
 import type { ToolContent, ToolResult } from './types.js';
+/**
+ * F80 (2026-06-10): the size at/above which a JSON-document text body is
+ * split off into its own content block instead of carrying the in-band
+ * `[label @ host] ` site-prefix.
+ *
+ * Why a threshold rather than "all JSON": a tool host (Claude Code, …)
+ * spills only OVERSIZED tool results to a temp file. That file is read
+ * back with `jq`, so the bytes must be pure JSON — an in-band prefix
+ * corrupts the first line and breaks the parse (the observed F80
+ * friction on `page_get_layout`, a multi-kB layout dump). Small JSON
+ * envelopes (error results, single-element confirms, short lists) are
+ * NEVER dumped, so they keep the in-band prefix — which preserves the
+ * long-standing contract that `content[0].text` is the directly-parseable
+ * JSON for those results (141 error-matrix / handler tests depend on it).
+ *
+ * 8 kB is comfortably below any host's spill threshold yet above every
+ * small structured envelope this surface emits.
+ */
+export declare const SITE_PREFIX_JSON_SPLIT_THRESHOLD: number;
 /**
  * Convert any JSON-serializable value into the MCP content envelope
  * (2-space JSON). Wave G.6.4b: every payload is deep-walked through
@@ -37,6 +56,18 @@ export declare function errorResult(opts: {
  * Confirm-guard preview helper for destructive tools. Returns the
  * preview `ToolResult` when `confirm` is false; callers `return` it
  * before executing the destructive REST call.
+ *
+ * F131 (Wave 4a): the blocked-state result is now STRUCTURALLY distinct
+ * from a successful mutation. Previously the preview was a plain
+ * `jsonResult` with no `isError` — envelope-identical to a success — so a
+ * model that did not parse `preview:true` read "delete succeeded" and
+ * silently left the element in place (the dry-run / silent-no-op footgun
+ * class). Three redundant signals now make the block unmistakable:
+ *   1. result-level `isError: true` (hosts that only read the error flag),
+ *   2. body `applied: false` + `requires_confirmation: true` (structured
+ *      consumers),
+ *   3. a leading "NOT EXECUTED" line in the human-readable warning text
+ *      (models that skim prose).
  */
 export declare function confirmGuard(opts: {
     operation: string;

package/dist/tools/tool-builder/results.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../../src/tools/tool-builder/results.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAU1D;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,UAAU,CAM5F;AAaD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CAChB,GAAG,UAAU,CAYb;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,UAAU,CAQb;AAuBD;;;;;;;GAOG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,UAAU,EAC7C,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,YAAY,GACnB,CAAC,CA2DH;AAED,wBAAgB,gBAAgB,CAC5B,aAAa,EAAE;IACX,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB,EACD,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3C,UAAU,CAgBZ"}
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../../src/tools/tool-builder/results.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAU1D;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gCAAgC,QAAW,CAAC;AA2BzD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,UAAU,CAM5F;AAaD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CAChB,GAAG,UAAU,CAYb;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,UAAU,CAab;AAuBD;;;;;;;GAOG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,UAAU,EAC7C,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,YAAY,GACnB,CAAC,CA6FH;AAED,wBAAgB,gBAAgB,CAC5B,aAAa,EAAE;IACX,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB,EACD,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3C,UAAU,CAgBZ"}

package/dist/tools/tool-builder/results.js

@@ -21,6 +21,52 @@ function stringify(value) {
         return String(value);
     }
 }
+/**
+ * F80 (2026-06-10): the size at/above which a JSON-document text body is
+ * split off into its own content block instead of carrying the in-band
+ * `[label @ host] ` site-prefix.
+ *
+ * Why a threshold rather than "all JSON": a tool host (Claude Code, …)
+ * spills only OVERSIZED tool results to a temp file. That file is read
+ * back with `jq`, so the bytes must be pure JSON — an in-band prefix
+ * corrupts the first line and breaks the parse (the observed F80
+ * friction on `page_get_layout`, a multi-kB layout dump). Small JSON
+ * envelopes (error results, single-element confirms, short lists) are
+ * NEVER dumped, so they keep the in-band prefix — which preserves the
+ * long-standing contract that `content[0].text` is the directly-parseable
+ * JSON for those results (141 error-matrix / handler tests depend on it).
+ *
+ * 8 kB is comfortably below any host's spill threshold yet above every
+ * small structured envelope this surface emits.
+ */
+export const SITE_PREFIX_JSON_SPLIT_THRESHOLD = 8 * 1024;
+/**
+ * Detect whether a text body is a PURE JSON DOCUMENT (object or array)
+ * LARGE enough that a host might spill it to a `jq`-read temp file.
+ * Tools like `page_get_layout` emit `jsonResult(data)` whose
+ * `content[0].text` IS the JSON payload; for a large layout that text
+ * lands in the dump verbatim, so an in-band `[label @ host] ` prefix
+ * would corrupt the first bytes.
+ *
+ * Only OBJECT / ARRAY documents qualify (a bare scalar like `"hello"`
+ * stays in-band). The cheap length + first-glyph pre-checks avoid a
+ * JSON.parse on every human-readable table on the hot path.
+ */
+function isLargeJsonDocumentText(text) {
+    if (text.length < SITE_PREFIX_JSON_SPLIT_THRESHOLD)
+        return false;
+    const trimmed = text.trimStart();
+    const first = trimmed.charAt(0);
+    if (first !== '{' && first !== '[')
+        return false;
+    try {
+        const parsed = JSON.parse(trimmed);
+        return parsed !== null && typeof parsed === 'object';
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Convert any JSON-serializable value into the MCP content envelope
  * (2-space JSON). Wave G.6.4b: every payload is deep-walked through
@@ -66,15 +112,29 @@ export function errorResult(opts) {
  * Confirm-guard preview helper for destructive tools. Returns the
  * preview `ToolResult` when `confirm` is false; callers `return` it
  * before executing the destructive REST call.
+ *
+ * F131 (Wave 4a): the blocked-state result is now STRUCTURALLY distinct
+ * from a successful mutation. Previously the preview was a plain
+ * `jsonResult` with no `isError` — envelope-identical to a success — so a
+ * model that did not parse `preview:true` read "delete succeeded" and
+ * silently left the element in place (the dry-run / silent-no-op footgun
+ * class). Three redundant signals now make the block unmistakable:
+ *   1. result-level `isError: true` (hosts that only read the error flag),
+ *   2. body `applied: false` + `requires_confirmation: true` (structured
+ *      consumers),
+ *   3. a leading "NOT EXECUTED" line in the human-readable warning text
+ *      (models that skim prose).
  */
 export function confirmGuard(opts) {
     return jsonResult({
         preview: true,
-        warning: 'DESTRUCTIVE — Confirmation required',
+        applied: false,
+        requires_confirmation: true,
+        warning: `NOT EXECUTED — DESTRUCTIVE operation requires confirmation. The "${opts.operation}" call was BLOCKED and nothing was changed.`,
         operation: opts.operation,
         details: opts.details,
         instruction: 'Ask the user to confirm, then call again with `confirm: true`.',
-    });
+    }, { isError: true });
 }
 /**
  * Sanitise a single content item from a toolkit builder. Text items
@@ -158,11 +218,28 @@ export function withSiteMeta(result, site) {
     catch {
         host = site.url;
     }
-    const prefix = `[${displayLabel} @ ${host}] `;
+    // F178 (2026-06-12): when a call was routed via the PROCESS-WIDE
+    // default/override (i.e. the caller omitted `site_id`), append a
+    // ` · default` marker INSIDE the visible prefix so the human SEES the
+    // call was not isolated from concurrent `use_site` switches. An
+    // explicit `site_id` (or a legacy fixture without `resolvedVia`) gets
+    // the plain prefix.
+    const routedViaSharedDefault = site.resolvedVia === 'registry_default'
+        || site.resolvedVia === 'active_override';
+    const marker = routedViaSharedDefault ? ' · default' : '';
+    const prefix = `[${displayLabel} @ ${host}${marker}] `;
+    // `resolved_site_id` is stamped LÜCKENLOS on every site-bound result
+    // (it mirrors `site_id` but names the concept the agent reasons about
+    // — "which site did this call actually land on"). `resolved_via` is
+    // only stamped when known, so legacy fixtures add no noise.
     const meta = {
         site_id: site.id,
         site_url: site.url,
         platform: site.platform.kind,
+        resolved_site_id: site.id,
+        ...(site.resolvedVia !== undefined
+            ? { resolved_via: site.resolvedVia }
+            : {}),
     };
     // W12-R1.2 (A4-F2): site-awareness is the LOAD-BEARING surface for
     // Claude-Desktop users. When the wrapped result has no text content
@@ -172,10 +249,24 @@ export function withSiteMeta(result, site) {
     // text block so the prefix is ALWAYS the first visible glyph.
     // Trim the trailing space — a standalone prefix block reads better
     // without it.
+    //
+    // F80 (2026-06-10): the SAME synthetic-block path is taken when the
+    // first text body is a PURE JSON DOCUMENT (page_get_layout etc.).
+    // Concatenating the prefix in-band there yields `[label @ host] {...}`
+    // — not valid JSON — which corrupts the harness's file-dump of an
+    // oversized result and breaks `jq`. Routing JSON documents through the
+    // synthetic block keeps the JSON byte-pure while the human still sees
+    // the marker first. Human-readable text (tables / details / prose)
+    // keeps the in-band prefix unchanged.
     const firstItem = result.content[0];
+    const firstIsLargeJsonDoc = firstItem !== undefined
+        && firstItem.type === 'text'
+        && typeof firstItem.text === 'string'
+        && isLargeJsonDocumentText(firstItem.text);
     const needsSynthetic = result.content.length === 0
         || firstItem === undefined
-        || firstItem.type !== 'text';
+        || firstItem.type !== 'text'
+        || firstIsLargeJsonDoc;
     const newContent = needsSynthetic
         ? [
             { type: 'text', text: prefix.trimEnd() },

package/dist/tools/tool-builder/results.js.map

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

package/dist/uninstall-skill.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `uninstall-skill` — the inverse of {@link installSkill}.
+ *
+ * Removes the bundled skill directory from the user's agent-skill folder
+ * (`~/.claude/skills/yt-builder-mcp/`, plus the legacy
+ * `~/.claude/skills/yootheme-builder/`) and strips the marker block this
+ * package appended to `~/AGENTS.md`.
+ *
+ * Idempotent + non-destructive to the user's own content: only OUR
+ * `## YT Builder MCP` marker section is removed from AGENTS.md; every
+ * other line the user wrote is preserved verbatim.
+ *
+ * @license MIT
+ */
+export interface UninstallSkillOptions {
+    /** Dir that holds the installed skill folder(s). Default `~/.claude/skills`. */
+    readonly targetSkillsDir?: string;
+    /** AGENTS.md file the marker block was appended to. Default `~/AGENTS.md`. */
+    readonly targetAgentsFile?: string;
+}
+export interface UninstallSkillResult {
+    /** True when at least one skill directory was removed. */
+    readonly skillRemoved: boolean;
+    /** Absolute path of the canonical skill dir that was targeted. */
+    readonly skillTargetDir: string;
+    /** True when the marker block was stripped from AGENTS.md. */
+    readonly markerRemoved: boolean;
+    /** Absolute AGENTS.md path that was inspected / mutated. */
+    readonly agentsFile: string;
+}
+/**
+ * True when a skill folder OR an AGENTS.md marker is present — used by
+ * the uninstall CLI to decide whether to surface the "remove skill"
+ * checkbox at all.
+ */
+export declare function isSkillInstalled(opts?: UninstallSkillOptions): boolean;
+/**
+ * Strip our `## YT Builder MCP` marker section from an AGENTS.md body.
+ *
+ * The block installSkill writes is:
+ *
+ *   \n\n## YT Builder MCP\n\n<MARKER_LINE>\n<a few prose lines>\n
+ *
+ * It is always appended at EOF. We locate the `## YT Builder MCP`
+ * heading whose following lines contain {@link MARKER_LINE}, then remove
+ * from that heading (collapsing the blank lines that preceded it) up to
+ * the next top-level/section heading (`# ` or `## `) or EOF. Returns the
+ * cleaned body, or `null` when no marker block was found (no-op).
+ */
+export declare function stripMarkerBlock(body: string): string | null;
+export declare function uninstallSkill(options?: UninstallSkillOptions): Promise<UninstallSkillResult>;
+//# sourceMappingURL=uninstall-skill.d.ts.map

package/dist/uninstall-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall-skill.d.ts","sourceRoot":"","sources":["../src/uninstall-skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAgBH,MAAM,WAAW,qBAAqB;IAClC,gFAAgF;IAChF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,8EAA8E;IAC9E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,oBAAoB;IACjC,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC/B;AAUD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAc1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoD5D;AAED,wBAAsB,cAAc,CAChC,OAAO,GAAE,qBAA0B,GACpC,OAAO,CAAC,oBAAoB,CAAC,CAgC/B"}