@wootsup/yt-builder-mcp 1.12.0 → 2.0.0

package/dist/skill-topics.js

@@ -0,0 +1,181 @@
+import { createHash } from 'node:crypto';
+import { loadSkillContent } from './skill-loader.js';
+export const TOPIC_SPLIT_BYTES = 25_705;
+export const SUB_TOPIC_SEPARATOR = '--';
+function composeSubSlug(parentSlug, heading, taken) {
+    const cut = (value, max) => value.length <= max ? value : (value.slice(0, max).replace(/-[^-]*$/, '') || value.slice(0, max));
+    const base = `${cut(parentSlug, 24)}${SUB_TOPIC_SEPARATOR}${cut(slugify(heading), 22)}`;
+    if (!taken.has(base))
+        return base;
+    const suffix = createHash('sha1').update(`${parentSlug}/${heading}`).digest('hex').slice(0, 6);
+    return `${cut(base, MAX_SLUG_LENGTH - suffix.length - 1)}-${suffix}`;
+}
+const MAX_SLUG_LENGTH = 48;
+function fallbackSlug(heading) {
+    const hash = createHash('sha1').update(heading).digest('hex').slice(0, 8);
+    return `topic-${hash}`;
+}
+export function slugify(heading) {
+    const parenIdx = heading.indexOf(' (');
+    const base = parenIdx > 0 ? heading.slice(0, parenIdx) : heading;
+    let slug = base
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    if (slug.length > MAX_SLUG_LENGTH) {
+        slug = slug.slice(0, MAX_SLUG_LENGTH).replace(/-[^-]*$/, '');
+    }
+    if (slug.length === 0) {
+        slug = fallbackSlug(heading);
+    }
+    return slug;
+}
+export function parseHeadings(content, level = 2) {
+    const marker = level === 2 ? '## ' : '### ';
+    const lines = content.split('\n');
+    const marks = [];
+    let open = null;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? '';
+        const fence = matchFence(line);
+        if (fence !== null) {
+            if (open === null) {
+                open = { char: fence.char, len: fence.len };
+            }
+            else if (fence.char === open.char && fence.len >= open.len && fence.info === '') {
+                open = null;
+            }
+            continue;
+        }
+        if (open !== null)
+            continue;
+        if (level === 2 && line.startsWith('### '))
+            continue;
+        if (line.startsWith(marker))
+            marks.push({ heading: line.slice(marker.length).trim(), line: i });
+    }
+    return marks;
+}
+function matchFence(line) {
+    const m = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line);
+    if (m === null)
+        return null;
+    const run = m[1] ?? '';
+    const info = (m[2] ?? '').trim();
+    if (run.startsWith('`') && info.includes('`'))
+        return null;
+    return { char: run[0] ?? '`', len: run.length, info };
+}
+function splitChapter(lines, chapter) {
+    const body = lines.slice(chapter.start, chapter.end).join('\n');
+    const subs = parseHeadings(body, 3);
+    if (subs.length < 2)
+        return null;
+    const parts = [];
+    const taken = new Set();
+    for (let i = 0; i < subs.length; i++) {
+        const mark = subs[i];
+        if (mark === undefined)
+            continue;
+        const start = chapter.start + mark.line;
+        const end = chapter.start + (subs[i + 1]?.line ?? (chapter.end - chapter.start));
+        const bytes = Buffer.byteLength(lines.slice(start, end).join('\n').trimEnd(), 'utf-8');
+        const subSlug = composeSubSlug(chapter.slug, mark.heading, taken);
+        taken.add(subSlug);
+        parts.push({
+            slug: subSlug,
+            heading: mark.heading,
+            bytes,
+            ...(bytes >= TOPIC_SPLIT_BYTES
+                ? {
+                    oversized_note: `${String(bytes)} B — still over the split limit after one level. `
+                        + 'Served whole; expect your client to shorten it.',
+                }
+                : {}),
+            start,
+            end,
+        });
+    }
+    const firstMark = subs[0];
+    const introEnd = firstMark === undefined ? chapter.end : chapter.start + firstMark.line;
+    return { intro: { start: chapter.start, end: introEnd }, parts };
+}
+let parsedCache;
+function parse() {
+    if (parsedCache !== undefined)
+        return parsedCache;
+    const content = loadSkillContent();
+    const lines = content.split('\n');
+    const marks = parseHeadings(content);
+    const out = [];
+    for (let k = 0; k < marks.length; k++) {
+        const m = marks[k];
+        if (m === undefined || m.heading.startsWith('Appendix:'))
+            continue;
+        const next = marks[k + 1];
+        const slug = slugify(m.heading);
+        const start = m.line;
+        const end = next?.line ?? lines.length;
+        const bytes = Buffer.byteLength(lines.slice(start, end).join('\n').trimEnd(), 'utf-8');
+        if (bytes >= TOPIC_SPLIT_BYTES) {
+            const split = splitChapter(lines, { slug, start, end });
+            if (split !== null) {
+                const introBytes = Buffer.byteLength(lines.slice(split.intro.start, split.intro.end).join('\n').trimEnd(), 'utf-8');
+                out.push({
+                    slug,
+                    heading: m.heading,
+                    bytes: introBytes,
+                    parts: split.parts.map((p) => p.slug),
+                    start: split.intro.start,
+                    end: split.intro.end,
+                });
+                out.push(...split.parts);
+                continue;
+            }
+            out.push({
+                slug,
+                heading: m.heading,
+                bytes,
+                oversized_note: `${String(bytes)} B in one piece — this chapter carries no sub-headings to `
+                    + 'split on, so it is served whole. Expect your client to shorten it.',
+                start,
+                end,
+            });
+            continue;
+        }
+        out.push({
+            slug,
+            heading: m.heading,
+            bytes,
+            start: m.line,
+            end: next?.line ?? lines.length,
+        });
+    }
+    parsedCache = { topics: out, lines };
+    return parsedCache;
+}
+export function listTopics() {
+    return parse().topics.map(({ slug, heading, bytes, parts, oversized_note }) => ({
+        slug,
+        heading,
+        bytes,
+        ...(parts !== undefined ? { parts } : {}),
+        ...(oversized_note !== undefined ? { oversized_note } : {}),
+    }));
+}
+export function getTopicContent(slug) {
+    const { topics, lines } = parse();
+    const t = topics.find((x) => x.slug === slug);
+    if (t === undefined)
+        return undefined;
+    const body = lines.slice(t.start, t.end).join('\n').trimEnd();
+    if (t.parts === undefined)
+        return body;
+    return (`${body}\n\n`
+        + `This chapter is served in ${String(t.parts.length)} parts. Call get_skill again with:\n`
+        + t.parts.map((p) => `  - ${p}`).join('\n'));
+}
+export function __resetTopicsCacheForTests() {
+    parsedCache = undefined;
+}
+//# sourceMappingURL=skill-topics.js.map

package/dist/skill-topics.js.map

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

package/dist/tools/active-site.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export type ActiveSiteVia = 'explicit' | 'use_site' | 'registry_default';
+export interface ActiveSite {
+    readonly site_id: string;
+    readonly via: ActiveSiteVia;
+    readonly process_scoped: boolean;
+}
+export declare const ACTIVE_SITE_VIA_VALUES: readonly ["explicit", "use_site", "registry_default"];
+export declare function activeSiteFromResolution(siteId: string, resolvedVia: 'explicit' | 'active_override' | 'registry_default' | undefined): ActiveSite | undefined;
+export declare function activeSiteFromRouting(explicitSiteId: string | undefined, runtimeActiveSiteId: string | null, registryDefaultSiteId: string | null): ActiveSite | undefined;
+export declare const ACTIVE_SITE_KEY = "active_site";
+export declare const ACTIVE_SITE_OUTPUT_DECLARATION: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+export declare function withActiveSiteKey(payload: Record<string, unknown>, active: ActiveSite): Record<string, unknown>;
+export declare function textWithActiveSite(text: string, active: ActiveSite): string | null;
+export declare function activeSiteSummary(active: ActiveSite): string;
+//# sourceMappingURL=active-site.d.ts.map

package/dist/tools/active-site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-site.d.ts","sourceRoot":"","sources":["../../src/tools/active-site.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,UAAU,GAAG,kBAAkB,CAAC;AAGzE,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CACpC;AAMD,eAAO,MAAM,sBAAsB,uDAAwD,CAAC;AAe5F,wBAAgB,wBAAwB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,UAAU,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,SAAS,GAC7E,UAAU,GAAG,SAAS,CAIxB;AAUD,wBAAgB,qBAAqB,CACjC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,mBAAmB,EAAE,MAAM,GAAG,IAAI,EAClC,qBAAqB,EAAE,MAAM,GAAG,IAAI,GACrC,UAAU,GAAG,SAAS,CAWxB;AAMD,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAsC7C,eAAO,MAAM,8BAA8B,+CAA+B,CAAC;AAU3E,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,UAAU,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzB;AAYD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAWlF;AAOD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAQ5D"}

package/dist/tools/active-site.js

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+export const ACTIVE_SITE_VIA_VALUES = ['explicit', 'use_site', 'registry_default'];
+function processScoped(via) {
+    return via !== 'explicit';
+}
+export function activeSiteFromResolution(siteId, resolvedVia) {
+    if (resolvedVia === undefined)
+        return undefined;
+    const via = resolvedVia === 'active_override' ? 'use_site' : resolvedVia;
+    return { site_id: siteId, via, process_scoped: processScoped(via) };
+}
+export function activeSiteFromRouting(explicitSiteId, runtimeActiveSiteId, registryDefaultSiteId) {
+    if (explicitSiteId !== undefined) {
+        return { site_id: explicitSiteId, via: 'explicit', process_scoped: false };
+    }
+    if (runtimeActiveSiteId !== null) {
+        return { site_id: runtimeActiveSiteId, via: 'use_site', process_scoped: true };
+    }
+    if (registryDefaultSiteId !== null) {
+        return { site_id: registryDefaultSiteId, via: 'registry_default', process_scoped: true };
+    }
+    return undefined;
+}
+export const ACTIVE_SITE_KEY = 'active_site';
+export const ACTIVE_SITE_OUTPUT_DECLARATION = z.looseObject({}).optional();
+export function withActiveSiteKey(payload, active) {
+    if (ACTIVE_SITE_KEY in payload)
+        return payload;
+    return { ...payload, [ACTIVE_SITE_KEY]: active };
+}
+export function textWithActiveSite(text, active) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
+        return null;
+    const enriched = withActiveSiteKey(parsed, active);
+    if (enriched === parsed)
+        return null;
+    return JSON.stringify(enriched, null, 2);
+}
+export function activeSiteSummary(active) {
+    if (active.via === 'explicit') {
+        return `${active.site_id} (you passed site_id — isolated)`;
+    }
+    if (active.via === 'use_site') {
+        return `${active.site_id} (use_site switched this server process — NOT the sites-file default)`;
+    }
+    return `${active.site_id} (sites-file default)`;
+}
+//# sourceMappingURL=active-site.js.map

package/dist/tools/active-site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-site.js","sourceRoot":"","sources":["../../src/tools/active-site.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,kBAAkB,CAAU,CAAC;AAG5F,SAAS,aAAa,CAAC,GAAkB;IACrC,OAAO,GAAG,KAAK,UAAU,CAAC;AAC9B,CAAC;AAUD,MAAM,UAAU,wBAAwB,CACpC,MAAc,EACd,WAA4E;IAE5E,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,GAAG,GAAkB,WAAW,KAAK,iBAAiB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC;IACxF,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;AACxE,CAAC;AAUD,MAAM,UAAU,qBAAqB,CACjC,cAAkC,EAClC,mBAAkC,EAClC,qBAAoC;IAEpC,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;IAC/E,CAAC;IACD,IAAI,mBAAmB,KAAK,IAAI,EAAE,CAAC;QAC/B,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,GAAG,EAAE,UAAU,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;IACnF,CAAC;IACD,IAAI,qBAAqB,KAAK,IAAI,EAAE,CAAC;QACjC,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,GAAG,EAAE,kBAAkB,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;IAC7F,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAMD,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAsC7C,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;AAU3E,MAAM,UAAU,iBAAiB,CAC7B,OAAgC,EAChC,MAAkB;IAElB,IAAI,eAAe,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC/C,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;AACrD,CAAC;AAYD,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,MAAkB;IAC/D,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACxF,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAiC,EAAE,MAAM,CAAC,CAAC;IAC9E,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC7C,CAAC;AAOD,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAChD,IAAI,MAAM,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QAC5B,OAAO,GAAG,MAAM,CAAC,OAAO,kCAAkC,CAAC;IAC/D,CAAC;IACD,IAAI,MAAM,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QAC5B,OAAO,GAAG,MAAM,CAAC,OAAO,uEAAuE,CAAC;IACpG,CAAC;IACD,OAAO,GAAG,MAAM,CAAC,OAAO,uBAAuB,CAAC;AACpD,CAAC"}

package/dist/tools/bind-guidance.d.ts

@@ -1,80 +1,10 @@
-/**
- * Canonical binding-guidance phrasing (C6 2026-06-10; F176 2026-06-12).
- *
- * `yootheme_builder_element_bind_source` was promoted from L2 (advanced
- * gateway) to **L1** by F116 (2026-06-11) — it is now a FIRST-CLASS entry in
- * `tools/list` (see `gateway/essentials.ts`: it is in ESSENTIAL_TOOLS). The
- * CapturingServer enforces a DISJOINT-LANE invariant, so the tool is NOT in
- * the advanced registry: calling `yootheme_builder_advanced({ tool:
- * "yootheme_builder_element_bind_source" })` returns `unknown_tool` on a
- * current build. An agent that follows OLD guidance saying "wrap the bind
- * call in the advanced gateway" therefore hits an `invalid_value` /
- * `unknown tool` dead end (F176: cage agents reproduced this 4× in R3).
- *
- * Every binding hint, schema annotation, and error message therefore now
- * instructs a DIRECT call through this single source of truth. Centralising
- * the phrasing keeps the ~dozen call-sites in lock-step and lets
- * `bind-guidance.test.ts` + `l1-no-gateway-wrap-pin.test.ts` pin the shape.
- *
- * Back-compat: a customer on a PRE-F116 server build (where the tool was
- * still L2) can reach it via `yootheme_builder_advanced({ tool:
- * "yootheme_builder_element_bind_source", arguments: {…} })`. That fallback
- * lives only in customer-facing skill docs, never in the runtime guidance
- * strings below.
- *
- * @license MIT
- */
-/** The gateway tool that reaches every advanced (L2) tool. */
 export declare const ADVANCED_GATEWAY_TOOL = "yootheme_builder_advanced";
-/** The bind tool — a first-class L1 entry in `tools/list` since F116. */
 export declare const BIND_SOURCE_TOOL = "yootheme_builder_element_bind_source";
-/**
- * A runnable one-line example of the DIRECT bind call. Kept short so it can
- * ride inside error strings + schema descriptions without bloating the
- * payload. (Named *_VIA_GATEWAY_* for source-compat with the ~dozen existing
- * import sites; the value is now a direct call — see file header / F176.)
- */
-export declare const BIND_VIA_GATEWAY_EXAMPLE = "yootheme_builder_element_bind_source({ template_id, element_path, source_name, field_mappings })";
-/**
- * The canonical hint string. Use verbatim wherever guidance previously said
- * "use element_bind_source". It states that the bind tool is first-class
- * (call it directly) and shows the exact call shape.
- */
+export declare const UNBIND_SOURCE_TOOL = "yootheme_builder_element_unbind_source";
+export declare const BIND_VIA_GATEWAY_EXAMPLE = "yootheme_builder_element_bind_source({ layout_id, element_path, source_name, field_mappings })";
 export declare const BIND_VIA_GATEWAY_HINT: string;
-/**
- * Compose a hint for a specific reason, e.g.
- * `bindViaGateway('to bind the grid_item child')`. Produces:
- *   "<reason>, call yootheme_builder_element_bind_source({ … }) directly —
- *    it is a first-class tool in tools/list."
- */
 export declare function bindViaGateway(reason: string): string;
-/**
- * F189 (2026-06-12) — the three canonical Multi-Items binding-correctness
- * steering texts, grounded in the YT5 renderer truth table (SourceTransform.php
- * + element templates, code+empirically verified). Centralised here so the bind
- * handler, the inspect handler, and the tool descriptions stay in lock-step and
- * `bind-guidance.test.ts` can pin them.
- *
- * The ONE rule: a `…List` source renders nested children ONLY when the element
- * carrying it is a CONTAINER whose template renders `$children` (column /
- * fragment / row / section / grid). `grid_item` and every `*_item` atom are
- * LEAF renderers — repeatSource clones them per row, but their children are
- * NEVER rendered. `item.source.props` maps row fields onto the element's OWN
- * slots only (last-write-wins, no merge).
- */
-/**
- * Reject text — a `…List` on a grid_item that carries nested children. The
- * children are render-dead; only the item's own slots paint.
- */
 export declare const GRID_ITEM_ITERATOR_REJECT: string;
-/**
- * Canonical multi-leaf form — iterate on a CONTAINER, one #parent leaf per
- * field; no leaf limit.
- */
 export declare const CANONICAL_MULTI_LEAF_FORM: string;
-/**
- * Slot-collision text — two fields cannot bind to the same prop slot on one
- * element (last-write-wins drops one).
- */
 export declare const SLOT_COLLISION_STEERING: string;
 //# sourceMappingURL=bind-guidance.d.ts.map

package/dist/tools/bind-guidance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bind-guidance.d.ts","sourceRoot":"","sources":["../../src/tools/bind-guidance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,8BAA8B,CAAC;AAEjE,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,yCAAyC,CAAC;AAEvE;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,qGACgD,CAAC;AAEtF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAEqB,CAAC;AAExD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,eAAO,MAAM,yBAAyB,QAKgD,CAAC;AAEvF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,QAKmD,CAAC;AAE1F;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QAIG,CAAC"}
+{"version":3,"file":"bind-guidance.d.ts","sourceRoot":"","sources":["../../src/tools/bind-guidance.ts"],"names":[],"mappings":"AAkCA,eAAO,MAAM,qBAAqB,8BAA8B,CAAC;AAGjE,eAAO,MAAM,gBAAgB,yCAAyC,CAAC;AAWvE,eAAO,MAAM,kBAAkB,2CAA2C,CAAC;AAQ3E,eAAO,MAAM,wBAAwB,mGAC8C,CAAC;AAOpF,eAAO,MAAM,qBAAqB,QAEqB,CAAC;AAQxD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKrD;AAqBD,eAAO,MAAM,yBAAyB,QAKgD,CAAC;AAMvF,eAAO,MAAM,yBAAyB,QAKmD,CAAC;AAM1F,eAAO,MAAM,uBAAuB,QAIG,CAAC"}

package/dist/tools/bind-guidance.js

@@ -1,93 +1,23 @@
-/**
- * Canonical binding-guidance phrasing (C6 2026-06-10; F176 2026-06-12).
- *
- * `yootheme_builder_element_bind_source` was promoted from L2 (advanced
- * gateway) to **L1** by F116 (2026-06-11) — it is now a FIRST-CLASS entry in
- * `tools/list` (see `gateway/essentials.ts`: it is in ESSENTIAL_TOOLS). The
- * CapturingServer enforces a DISJOINT-LANE invariant, so the tool is NOT in
- * the advanced registry: calling `yootheme_builder_advanced({ tool:
- * "yootheme_builder_element_bind_source" })` returns `unknown_tool` on a
- * current build. An agent that follows OLD guidance saying "wrap the bind
- * call in the advanced gateway" therefore hits an `invalid_value` /
- * `unknown tool` dead end (F176: cage agents reproduced this 4× in R3).
- *
- * Every binding hint, schema annotation, and error message therefore now
- * instructs a DIRECT call through this single source of truth. Centralising
- * the phrasing keeps the ~dozen call-sites in lock-step and lets
- * `bind-guidance.test.ts` + `l1-no-gateway-wrap-pin.test.ts` pin the shape.
- *
- * Back-compat: a customer on a PRE-F116 server build (where the tool was
- * still L2) can reach it via `yootheme_builder_advanced({ tool:
- * "yootheme_builder_element_bind_source", arguments: {…} })`. That fallback
- * lives only in customer-facing skill docs, never in the runtime guidance
- * strings below.
- *
- * @license MIT
- */
-/** The gateway tool that reaches every advanced (L2) tool. */
 export const ADVANCED_GATEWAY_TOOL = 'yootheme_builder_advanced';
-/** The bind tool — a first-class L1 entry in `tools/list` since F116. */
 export const BIND_SOURCE_TOOL = 'yootheme_builder_element_bind_source';
-/**
- * A runnable one-line example of the DIRECT bind call. Kept short so it can
- * ride inside error strings + schema descriptions without bloating the
- * payload. (Named *_VIA_GATEWAY_* for source-compat with the ~dozen existing
- * import sites; the value is now a direct call — see file header / F176.)
- */
-export const BIND_VIA_GATEWAY_EXAMPLE = `${BIND_SOURCE_TOOL}({ template_id, element_path, source_name, field_mappings })`;
-/**
- * The canonical hint string. Use verbatim wherever guidance previously said
- * "use element_bind_source". It states that the bind tool is first-class
- * (call it directly) and shows the exact call shape.
- */
+export const UNBIND_SOURCE_TOOL = 'yootheme_builder_element_unbind_source';
+export const BIND_VIA_GATEWAY_EXAMPLE = `${BIND_SOURCE_TOOL}({ layout_id, element_path, source_name, field_mappings })`;
 export const BIND_VIA_GATEWAY_HINT = `call \`${BIND_SOURCE_TOOL}\` directly — it is a first-class tool in tools/list ` +
     `(since F116). Shape: ${BIND_VIA_GATEWAY_EXAMPLE}.`;
-/**
- * Compose a hint for a specific reason, e.g.
- * `bindViaGateway('to bind the grid_item child')`. Produces:
- *   "<reason>, call yootheme_builder_element_bind_source({ … }) directly —
- *    it is a first-class tool in tools/list."
- */
 export function bindViaGateway(reason) {
     return (`${reason}, call ${BIND_VIA_GATEWAY_EXAMPLE} directly ` +
         `— \`${BIND_SOURCE_TOOL}\` is a first-class tool in tools/list (since F116).`);
 }
-/**
- * F189 (2026-06-12) — the three canonical Multi-Items binding-correctness
- * steering texts, grounded in the YT5 renderer truth table (SourceTransform.php
- * + element templates, code+empirically verified). Centralised here so the bind
- * handler, the inspect handler, and the tool descriptions stay in lock-step and
- * `bind-guidance.test.ts` can pin them.
- *
- * The ONE rule: a `…List` source renders nested children ONLY when the element
- * carrying it is a CONTAINER whose template renders `$children` (column /
- * fragment / row / section / grid). `grid_item` and every `*_item` atom are
- * LEAF renderers — repeatSource clones them per row, but their children are
- * NEVER rendered. `item.source.props` maps row fields onto the element's OWN
- * slots only (last-write-wins, no merge).
- */
-/**
- * Reject text — a `…List` on a grid_item that carries nested children. The
- * children are render-dead; only the item's own slots paint.
- */
 export const GRID_ITEM_ITERATOR_REJECT = 'A list source on a grid_item makes it repeat per row, but a grid_item only ' +
     'renders its OWN slots (title, meta, content, image, link) — it NEVER renders ' +
     'nested child elements, so they are dropped and you see placeholders. Fix: ' +
     '(1) map fields onto the item\'s slots props:{title,meta,content,image}, or ' +
     '(2) move the List onto a container (column/fragment/row) and use #parent leaves.';
-/**
- * Canonical multi-leaf form — iterate on a CONTAINER, one #parent leaf per
- * field; no leaf limit.
- */
 export const CANONICAL_MULTI_LEAF_FORM = 'To render more fields per row than an item has slots, iterate on a CONTAINER: ' +
     'put source:{query:{name:"…List"}} on a column (or fragment/row), then add one ' +
     'leaf element per field inside, each with source:{query:{name:"#parent"}, ' +
     'props:{<slot>:{name:"<field>"}}}. <slot> is content for headline/text, or ' +
     'title/meta/image for panel. There is no leaf limit. A fragment wrapper is optional.';
-/**
- * Slot-collision text — two fields cannot bind to the same prop slot on one
- * element (last-write-wins drops one).
- */
 export const SLOT_COLLISION_STEERING = 'Two fields cannot bind to the same prop slot on one element — YT5 mapSource ' +
     'does last-write-wins and one value is lost. Give each field its own leaf ' +
     'element, or map them to DISTINCT slots of a multi-slot element ' +

package/dist/tools/bind-guidance.js.map

@@ -1 +1 @@
-{"version":3,"file":"bind-guidance.js","sourceRoot":"","sources":["../../src/tools/bind-guidance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AAEjE,yEAAyE;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAAG,sCAAsC,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACjC,GAAG,gBAAgB,8DAA8D,CAAC;AAEtF;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAC9B,UAAU,gBAAgB,uDAAuD;IACjF,wBAAwB,wBAAwB,GAAG,CAAC;AAExD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IACzC,OAAO,CACH,GAAG,MAAM,UAAU,wBAAwB,YAAY;QACvD,OAAO,gBAAgB,sDAAsD,CAChF,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAClC,6EAA6E;IAC7E,+EAA+E;IAC/E,4EAA4E;IAC5E,6EAA6E;IAC7E,kFAAkF,CAAC;AAEvF;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAClC,gFAAgF;IAChF,gFAAgF;IAChF,2EAA2E;IAC3E,4EAA4E;IAC5E,qFAAqF,CAAC;AAE1F;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAChC,8EAA8E;IAC9E,2EAA2E;IAC3E,iEAAiE;IACjE,mCAAmC,CAAC"}
+{"version":3,"file":"bind-guidance.js","sourceRoot":"","sources":["../../src/tools/bind-guidance.ts"],"names":[],"mappings":"AAkCA,MAAM,CAAC,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AAGjE,MAAM,CAAC,MAAM,gBAAgB,GAAG,sCAAsC,CAAC;AAWvE,MAAM,CAAC,MAAM,kBAAkB,GAAG,wCAAwC,CAAC;AAQ3E,MAAM,CAAC,MAAM,wBAAwB,GACjC,GAAG,gBAAgB,4DAA4D,CAAC;AAOpF,MAAM,CAAC,MAAM,qBAAqB,GAC9B,UAAU,gBAAgB,uDAAuD;IACjF,wBAAwB,wBAAwB,GAAG,CAAC;AAQxD,MAAM,UAAU,cAAc,CAAC,MAAc;IACzC,OAAO,CACH,GAAG,MAAM,UAAU,wBAAwB,YAAY;QACvD,OAAO,gBAAgB,sDAAsD,CAChF,CAAC;AACN,CAAC;AAqBD,MAAM,CAAC,MAAM,yBAAyB,GAClC,6EAA6E;IAC7E,+EAA+E;IAC/E,4EAA4E;IAC5E,6EAA6E;IAC7E,kFAAkF,CAAC;AAMvF,MAAM,CAAC,MAAM,yBAAyB,GAClC,gFAAgF;IAChF,gFAAgF;IAChF,2EAA2E;IAC3E,4EAA4E;IAC5E,qFAAqF,CAAC;AAM1F,MAAM,CAAC,MAAM,uBAAuB,GAChC,8EAA8E;IAC9E,2EAA2E;IAC3E,iEAAiE;IACjE,mCAAmC,CAAC"}

package/dist/tools/budgeted-table.d.ts

@@ -1,21 +1,16 @@
 import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-import { type DetailLevel, type TableResultOptions } from "@getimo/mcp-toolkit";
-/**
- * `tableResult`, bounded by `maxChars` instead of by the toolkit's row-count
- * heuristic.
- *
- * Identical to `tableResult` whenever the rendered table fits BOTH budgets —
- * the same bytes, the same `_meta.ui`. It diverges only where the toolkit would
- * have cut: a table the resolved budget can afford now arrives whole, and a
- * table it cannot afford arrives with whole rows dropped and the omission
- * stated.
- */
-export declare function budgetedTableResult(items: Record<string, unknown>[], options: TableResultOptions, maxChars: number, detailOverride?: DetailLevel): CallToolResult;
-/**
- * The TEXT of a table bounded by `maxChars` — for a caller that wants the
- * rendering, not an MCP result (the `apimapper_render` renderers extract the
- * text and re-wrap it themselves, so `autoFormatTable`'s internal 2 000 was
- * shortening their output before their own, wider cap ever saw it).
- */
-export declare function renderTableWithinBudget(items: Record<string, unknown>[], options: TableResultOptions, maxChars: number, detailOverride?: DetailLevel): string;
+import { type DetailLevel, type TableColumn, type TableResultOptions } from "@getimo/mcp-toolkit";
+export interface HonestTableOptions extends TableResultOptions {
+    readonly omittedFields?: readonly string[];
+}
+export interface ReferencedTableColumn extends TableColumn {
+    readonly neverTruncate?: true;
+}
+export declare function budgetedTableResult(items: Record<string, unknown>[], options: HonestTableOptions, maxChars: number, detailOverride?: DetailLevel): CallToolResult;
+export declare function honestTableResult(items: Record<string, unknown>[], options: HonestTableOptions, detailOverride?: DetailLevel): CallToolResult;
+export declare function honestTableResultWithin(items: Record<string, unknown>[], options: HonestTableOptions, maxChars: number | undefined, detailOverride?: DetailLevel): CallToolResult;
+export declare function renderedColumns(itemCount: number, options: {
+    columns: readonly TableColumn[];
+    compactColumns?: readonly TableColumn[];
+}, detailOverride?: DetailLevel): readonly TableColumn[];
 //# sourceMappingURL=budgeted-table.d.ts.map

package/dist/tools/budgeted-table.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"budgeted-table.d.ts","sourceRoot":"","sources":["../../src/tools/budgeted-table.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAK7B;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAChC,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,WAAW,GAC3B,cAAc,CA6BhB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAChC,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,WAAW,GAC3B,MAAM,CAMR"}
+{"version":3,"file":"budgeted-table.d.ts","sourceRoot":"","sources":["../../src/tools/budgeted-table.ts"],"names":[],"mappings":"AAuDA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAuB7B,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAM5D,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AASD,MAAM,WAAW,qBAAsB,SAAQ,WAAW;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC;CAC/B;AA2ED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAChC,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,WAAW,GAC3B,cAAc,CAqBhB;AA+CD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAChC,OAAO,EAAE,kBAAkB,EAC3B,cAAc,CAAC,EAAE,WAAW,GAC3B,cAAc,CAIhB;AAyBD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAChC,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,cAAc,CAAC,EAAE,WAAW,GAC3B,cAAc,CAIhB;AAuGD,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IAAE,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IAAC,cAAc,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;CAAE,EACrF,cAAc,CAAC,EAAE,WAAW,GAC3B,SAAS,WAAW,EAAE,CAGxB"}