@wootsup/yt-builder-mcp 1.11.0 → 2.0.0

package/dist/tools/multi-items/inspect-handler.d.ts

@@ -1,97 +0,0 @@
-/**
- * `inspect_multi_items_binding` handler — surfaces Multi-Items binding
- * state on an element via REST round-trip.
- *
- * Companion of the PHP `MultiItemsInspector` — see
- * src/modules/builder-source-binding/src/MultiItemsInspector.php
- * for the report shape.
- *
- * Wave-16 #34:
- *   - 6.1 depth-cap: the human-readable text leg is capped at
- *     {@link MAX_INSPECTION_DEPTH}; structuredContent stays verbatim so
- *     it keeps validating against the output schema.
- *   - 6.4 severity marker: the response carries a typed `hint.severity`
- *     ("advisory" | "blocking") so the agent can tell a structural
- *     container-level binding bug apart from informational guidance.
- *
- * @license MIT
- */
-import { z } from 'zod';
-import { type RestClient } from '../../client.js';
-import { type ToolResult } from '../tool-builder.js';
-import { InspectionCache } from './inspection-cache.js';
-/**
- * Severity of the advisory hint the inspector attaches to every report.
- * `blocking` means the binding is structurally wrong (sits on the
- * container instead of the `*_item` child) and the rendered output will
- * be broken until fixed; `advisory` is informational guidance.
- */
-export type HintSeverity = 'advisory' | 'blocking';
-export declare const INSPECT_MULTI_ITEMS_OUTPUT_SCHEMA: z.ZodObject<{
-    template_id: z.ZodString;
-    report: z.ZodObject<{
-        element_path: z.ZodString;
-        element_type: z.ZodString;
-        is_container: z.ZodBoolean;
-        is_item: z.ZodBoolean;
-        container_type: z.ZodNullable<z.ZodString>;
-        item_type: z.ZodNullable<z.ZodString>;
-        current_binding_level: z.ZodEnum<{
-            container: "container";
-            item: "item";
-            none: "none";
-        }>;
-        item_child_binding_level: z.ZodOptional<z.ZodEnum<{
-            item: "item";
-            none: "none";
-        }>>;
-        is_bound: z.ZodOptional<z.ZodBoolean>;
-        has_implode_directives: z.ZodBoolean;
-        bound_source_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        bound_source_exists: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-        source_missing_warning: z.ZodOptional<z.ZodString>;
-        map_location_missing: z.ZodOptional<z.ZodBoolean>;
-        field_mapping_count: z.ZodOptional<z.ZodNumber>;
-        zero_field_mappings: z.ZodOptional<z.ZodBoolean>;
-        iterator_is_leaf_renderer: z.ZodOptional<z.ZodBoolean>;
-        relation_native_binding: z.ZodOptional<z.ZodBoolean>;
-        archive_context: z.ZodOptional<z.ZodObject<{
-            query_name: z.ZodString;
-            relation: z.ZodString;
-            relation_field: z.ZodString;
-            current_term_arg: z.ZodString;
-            current_term: z.ZodNumber;
-        }, z.core.$strip>>;
-        map_location_warning: z.ZodOptional<z.ZodString>;
-        warning: z.ZodOptional<z.ZodString>;
-        recommended_fix: z.ZodOptional<z.ZodString>;
-    }, 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>;
-/** The structured inspect payload the handler caches + emits. */
-type InspectStructured = Record<string, unknown>;
-export interface MultiItemsHandlerDeps {
-    readonly client: RestClient;
-    /**
-     * 6.2 — optional inspection cache. When provided, the handler keys
-     * results on (template_id, element_path, global-etag) with a 60s TTL.
-     * The builder injects one shared instance so repeat inspects within
-     * the TTL skip the REST round-trip; a write bumps the global etag and
-     * naturally invalidates the entry. Omit it to disable caching (e.g.
-     * the cold-AI shape-pin tests that assert the raw round-trip).
-     */
-    readonly cache?: InspectionCache<InspectStructured>;
-}
-export declare function handleInspectMultiItemsBinding({ client, cache }: MultiItemsHandlerDeps, { template_id, element_path }: {
-    template_id: string;
-    element_path: string;
-}): Promise<ToolResult>;
-export {};
-//# sourceMappingURL=inspect-handler.d.ts.map

package/dist/tools/multi-items/inspect-handler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"inspect-handler.d.ts","sourceRoot":"","sources":["../../../src/tools/multi-items/inspect-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;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,uBAAuB,CAAC;AAExD;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,UAAU,CAAC;AAEnD,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyE5C,CAAC;AAEH,iEAAiE;AACjE,KAAK,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IAClC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;CACvD;AAgPD,wBAAsB,8BAA8B,CAChD,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,qBAAqB,EACxC,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC7E,OAAO,CAAC,UAAU,CAAC,CAwCrB"}

package/dist/tools/multi-items/inspect-handler.js

@@ -1,323 +0,0 @@
-/**
- * `inspect_multi_items_binding` handler — surfaces Multi-Items binding
- * state on an element via REST round-trip.
- *
- * Companion of the PHP `MultiItemsInspector` — see
- * src/modules/builder-source-binding/src/MultiItemsInspector.php
- * for the report shape.
- *
- * Wave-16 #34:
- *   - 6.1 depth-cap: the human-readable text leg is capped at
- *     {@link MAX_INSPECTION_DEPTH}; structuredContent stays verbatim so
- *     it keeps validating against the output schema.
- *   - 6.4 severity marker: the response carries a typed `hint.severity`
- *     ("advisory" | "blocking") so the agent can tell a structural
- *     container-level binding bug apart from informational guidance.
- *
- * @license MIT
- */
-import { z } from 'zod';
-import { encodeElementPath, encodeTemplateId } from '../../client.js';
-import { errorResult, jsonResult, structuredResult } from '../tool-builder.js';
-import { capInspectionDepth } from './format/inspection-format.js';
-export const INSPECT_MULTI_ITEMS_OUTPUT_SCHEMA = z.object({
-    template_id: z.string(),
-    report: z.object({
-        element_path: z.string(),
-        element_type: z.string(),
-        is_container: z.boolean(),
-        is_item: z.boolean(),
-        container_type: z.string().nullable(),
-        item_type: z.string().nullable(),
-        current_binding_level: z.enum(['none', 'container', 'item']),
-        // C7 (2026-06-10) — binding level of the container's first `*_item`
-        // child. Optional so a pre-C7 backend's report still validates.
-        item_child_binding_level: z.enum(['none', 'item']).optional(),
-        // C7 — single honest "is anything bound (here or on the item child)"
-        // signal. Optional for back-compat with pre-C7 reports.
-        is_bound: z.boolean().optional(),
-        has_implode_directives: z.boolean(),
-        // C7 — bound source name + live-registry existence cross-check.
-        // `bound_source_exists` is null when the registry is not wired.
-        bound_source_name: z.string().nullable().optional(),
-        bound_source_exists: z.boolean().nullable().optional(),
-        source_missing_warning: z.string().optional(),
-        // F143 — true when a bound map_item/map carries no resolved
-        // `location` leaf (the map renders 0 markers). Optional so reports
-        // for non-map elements (and pre-F143 backends) still validate.
-        map_location_missing: z.boolean().optional(),
-        // F174 — number of field mappings on the bound node (0 when unbound /
-        // mapping-less). Optional so a pre-F174 backend's report still validates.
-        field_mapping_count: z.number().int().nonnegative().optional(),
-        // F174 — true when the element IS bound but carries 0 field mappings
-        // (the N clones render only the template's static placeholder text).
-        // Optional for back-compat with pre-F174 reports.
-        zero_field_mappings: z.boolean().optional(),
-        // F189 — true when a `…List` source sits on a LEAF renderer (grid_item /
-        // any non-container) with non-empty children (the children never paint).
-        // Optional so reports for other shapes + pre-F189 backends still validate.
-        iterator_is_leaf_renderer: z.boolean().optional(),
-        // B8 (2026-06-27) — true when the binding is a relation-traversal NATIVE
-        // binding (dotted query.name + current-term `id` arg), e.g.
-        // categoryFaqs.taxonomyCategoryFaq → faq. A VALID, correctly-scoped item
-        // binding — the verdict must NOT false-flag it. Optional so reports for
-        // non-relation bindings + pre-B8 backends still validate.
-        relation_native_binding: z.boolean().optional(),
-        // B8 — the archive-context descriptor accompanying the flag (mirrors
-        // SourceRegistry::getSourceSchema()'s archive_context record). Optional
-        // (present only alongside relation_native_binding).
-        archive_context: z
-            .object({
-            query_name: z.string(),
-            relation: z.string(),
-            relation_field: z.string(),
-            current_term_arg: z.string(),
-            current_term: z.number().int(),
-        })
-            .optional(),
-        // F39 (2026-06-10) — emitted when a map/map_item is bound without a
-        // `location` field mapping (renders 0 markers). Optional so non-map
-        // reports still validate. Companion human-readable signal to the
-        // structured `map_location_missing` boolean above.
-        map_location_warning: z.string().optional(),
-        warning: z.string().optional(),
-        recommended_fix: z.string().optional(),
-    }),
-    etag: z.string(),
-    // 6.4 — typed advisory/blocking marker. Optional so a verbatim REST
-    // passthrough that predates this field still validates, but the
-    // handler always populates it.
-    hint: z
-        .object({
-        severity: z.enum(['advisory', 'blocking']),
-        message: z.string(),
-    })
-        .optional(),
-});
-/**
- * Classify the report into an advisory/blocking hint.
- *
- * C7 (2026-06-10) — the verdict now reflects what is ACTUALLY bound, not
- * just the container-node's own binding level. Three structural bugs the
- * pre-C7 single-axis (`current_binding_level`) classifier produced:
- *
- *   1. A container bound *through* its `*_item` child reported "none" + a
- *      reassuring "structurally correct" hint. Now `is_bound` /
- *      `item_child_binding_level` make the child binding visible.
- *   2. A fully-unbound element was called "structurally correct". Now a
- *      false `is_bound` yields an honest "no source binding present" hint.
- *   3. A binding to a since-deleted source looked fine. Now
- *      `bound_source_exists === false` is `blocking` with the missing-
- *      source message.
- *
- * Precedence: container-level binding (blocking) → deleted source
- * (blocking) → nothing bound (advisory, honest) → B8 relation-traversal
- * native binding (advisory, "structurally correct (relation/current-term)")
- * → bound + live (advisory, "structurally correct").
- */
-function buildHint(report) {
-    const r = (report ?? {});
-    // F143 — a bound map with no resolved `location` leaf renders 0
-    // markers. That is a render-breaking bug, not advisory: surface it as
-    // `blocking` even though the binding level itself is "item". This is the
-    // structured-boolean entry point; the human-readable `map_location_warning`
-    // (F39, branch 1b below) is the companion signal a different backend emits.
-    if (r.map_location_missing === true) {
-        const fix = typeof r.recommended_fix === 'string' && r.recommended_fix !== ''
-            ? r.recommended_fix
-            : 'Map a single `location` field holding a combined "lat,lng" string.';
-        return {
-            severity: 'blocking',
-            message: 'Map is bound but no `location` field is mapped — no markers will ' +
-                `render. ${fix}`,
-        };
-    }
-    // F189 — a `…List` source on a LEAF renderer (grid_item / any non-container)
-    // that carries non-empty children: repeatSource clones it per row but the
-    // template renders ONLY its own slots, never its nested children → the
-    // children are render-dead and the grid shows placeholders. Render-breaking
-    // tier → blocking. The PHP inspector ships the human-readable `warning` with
-    // both recipes; surface it verbatim. Runs before the zero-mappings / generic
-    // branches so the iterator-shape bug is named first.
-    if (r.iterator_is_leaf_renderer === true) {
-        const msg = typeof r.warning === 'string' && r.warning !== ''
-            ? r.warning
-            : 'This element iterates a list source but is a LEAF renderer ' +
-                '(grid_item / *_item) — its nested children are never rendered. ' +
-                'Map fields onto the item\'s own slots (title/meta/content/image), ' +
-                'or move the List onto a container (column/fragment/row) with #parent leaves.';
-        return { severity: 'blocking', message: msg };
-    }
-    // F174 — a bound element with ZERO field mappings clones the container N
-    // times but every clone renders only the template's static placeholder
-    // text ("Title" / "Lorem ipsum"), not real data. The binding is
-    // structurally item-level so every other signal reports healthy. Same
-    // render-breaking tier as map_location_missing → blocking. The PHP
-    // inspector ships the human-readable `warning`; surface it verbatim.
-    if (r.zero_field_mappings === true) {
-        const msg = typeof r.warning === 'string' && r.warning !== ''
-            ? r.warning
-            : 'Bound to a source but with 0 field mappings — the cloned items ' +
-                'render the template\'s static placeholder text (Title / Lorem ipsum), ' +
-                'not real data. Re-bind with field_mappings AT THIS ITEM ' +
-                '(element_bind_source on this same element with non-empty ' +
-                'field_mappings). Do NOT bind the individual child leaves instead: ' +
-                'on YT5 a "#parent" leaf bind written directly under an iterating ' +
-                'item renders placeholder text.';
-        return { severity: 'blocking', message: msg };
-    }
-    // (1) Container-level binding — the original structural bug. Blocking.
-    if (r.current_binding_level === 'container') {
-        const fix = typeof r.recommended_fix === 'string' && r.recommended_fix !== ''
-            ? r.recommended_fix
-            : 'Move the binding to the first `*_item` child element.';
-        return { severity: 'blocking', message: fix };
-    }
-    // (1b) F39 — a map/map_item bound WITHOUT a `location` field mapping
-    // renders zero markers. The PHP inspector only emits map_location_warning
-    // for a genuinely-bound map pair, so its mere presence is the signal.
-    // Blocking, because the map looks healthy but shows nothing.
-    if (typeof r.map_location_warning === 'string' && r.map_location_warning !== '') {
-        return { severity: 'blocking', message: r.map_location_warning };
-    }
-    // (2) C7 bug 3 — bound source no longer exists in the live registry.
-    // `bound_source_exists` is only a hard `false` when the registry was
-    // wired AND the name was absent; `null`/`undefined` (unknown) never trips
-    // this branch.
-    if (r.bound_source_exists === false) {
-        const msg = typeof r.source_missing_warning === 'string' && r.source_missing_warning !== ''
-            ? r.source_missing_warning
-            : 'The bound source no longer exists in the live source registry — ' +
-                'the frontend will render empty. Re-bind to a current source.';
-        return { severity: 'blocking', message: msg };
-    }
-    // (3) C7 bug 2 — nothing is actually bound (neither this node nor, for a
-    // container, its item child). `is_bound` is the authoritative signal;
-    // when a pre-C7 backend omits it, fall back to current_binding_level.
-    const isBound = typeof r.is_bound === 'boolean'
-        ? r.is_bound
-        : r.current_binding_level === 'item';
-    if (!isBound) {
-        return {
-            severity: 'advisory',
-            message: 'No source binding present on this element' +
-                (r.current_binding_level !== 'item' && r.item_child_binding_level !== 'item'
-                    ? ' or its item child'
-                    : '') +
-                '. Bind a source directly: yootheme_builder_element_bind_source({ ' +
-                'template_id, element_path, source_name, field_mappings }) — for a ' +
-                'Multi-Items container, bind on the first `*_item` child.',
-        };
-    }
-    // (3b) B8 — a relation-traversal NATIVE binding (dotted query.name +
-    // current-term `id` arg, e.g. categoryFaqs.taxonomyCategoryFaq → faq). It is
-    // a VALID, correctly-scoped item-level binding. The pre-B8 verdict had no
-    // signal for it and fell through to the generic "structurally correct"
-    // message; worse, an over-eager existence check could mis-read the dotted
-    // name. Surface an EXPLICIT advisory naming the relation + current-term so
-    // the agent stops treating a working archive binding as broken/none. Runs
-    // AFTER every blocking branch (deleted source / container-level / map /
-    // zero-mappings / iterator-leaf) and after the unbound check — so a genuinely
-    // broken relation binding still reports blocking, never this advisory.
-    if (r.relation_native_binding === true) {
-        const ac = r.archive_context !== null && typeof r.archive_context === 'object'
-            ? r.archive_context
-            : {};
-        const relation = typeof ac.relation === 'string' && ac.relation !== '' ? ac.relation : 'relation';
-        const relationField = typeof ac.relation_field === 'string' && ac.relation_field !== '' ? ac.relation_field : 'the relation field';
-        const termArg = typeof ac.current_term_arg === 'string' && ac.current_term_arg !== '' ? ac.current_term_arg : 'id';
-        return {
-            severity: 'advisory',
-            message: 'Binding looks structurally correct (relation/current-term). This is a ' +
-                `native relation-traversal binding — it follows the "${relation}" relation ` +
-                `to "${relationField}" scoped to the CURRENT term (${termArg}: 0), the canonical ` +
-                'archive-context shape. It renders the current term\'s related items on an ' +
-                'archive/term page and is correctly scoped — NOT broken. Verify on a real ' +
-                'archive/term URL if it still renders empty.',
-        };
-    }
-    // (4) C7 bug 1 — bound through the item child. Surface that explicitly so
-    // the agent does not mistake the container's own "none" level for "unbound".
-    if (r.item_child_binding_level === 'item') {
-        return {
-            severity: 'advisory',
-            message: 'Binding looks structurally correct — the source is bound at the ' +
-                'item level (on the `*_item` child), which is the canonical ' +
-                'Multi-Items shape. Verify element_path via ' +
-                'yootheme_builder_element_list if the source still renders empty.',
-        };
-    }
-    // (5) Genuinely item-bound with a live (or unknown) source.
-    return {
-        severity: 'advisory',
-        message: 'Binding looks structurally correct. Verify element_path via ' +
-            'yootheme_builder_element_list if the source still renders empty.',
-    };
-}
-/**
- * Render a structured inspect payload into the ToolResult envelope.
- * Shared by the cache-hit and cache-miss paths so both legs (text +
- * structuredContent) are built identically.
- *
- * 6.1 — 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_MULTI_ITEMS_OUTPUT_SCHEMA
- * (additionalProperties:false).
- */
-function renderInspectResult(structured) {
-    const text = jsonResult(capInspectionDepth(structured));
-    return structuredResult(text, structured);
-}
-export async function handleInspectMultiItemsBinding({ client, cache }, { template_id, element_path }) {
-    const encoded = encodeElementPath(element_path);
-    try {
-        // 6.2 — when a cache is wired, key on the GLOBAL state etag. Every
-        // write tool 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}/multi-items/inspect`);
-        // 6.4 — attach the typed severity marker to the structured payload.
-        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: 'Verify element_path via yootheme_builder_element_list. Paths are JSON-Pointer ' +
-                '(RFC-6901) style: /0/children/1. Use yootheme_builder_element_list to enumerate ' +
-                'valid paths.',
-        });
-    }
-}
-/**
- * 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 the whole call.
- */
-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-handler.js.map

package/dist/tools/multi-items/inspect-handler.js.map

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

package/dist/tools/multi-items/inspection-cache.d.ts

@@ -1,85 +0,0 @@
-/**
- * InspectionCache — Wave-16 #34 (6.2).
- *
- * A tiny in-process TTL cache for `inspect_multi_items_binding` results.
- * Keyed by `(template_id, element_path, etag)`:
- *
- *   - `template_id` + `element_path` identify the element;
- *   - `etag` is the GLOBAL state ETag (from `GET /etag`). Every write
- *     tool bumps it (see ETAG schema note: "every successful write
- *     returns a NEW ETag"). So a write to ANY template surfaces a fresh
- *     etag → a NEW cache key → a guaranteed miss. The stale entry for a
- *     mutated template can never be served. This reuses the existing
- *     etag-bump mechanism rather than inventing a parallel invalidation
- *     channel.
- *
- * TTL is a hard 60s upper bound so an entry cannot live indefinitely
- * even if the etag never changes (read-only sessions). The clock is
- * injectable so the TTL behaviour is testable without sleeping.
- *
- * Bounded growth — Wave-16 Phase-6 nit. The key embeds the GLOBAL etag,
- * and every write bumps it, so each `set()` lands under a NEW key while
- * the old-etag entries are never re-queried (the handler always reads the
- * current etag). Without a bound they would accumulate in the Map forever
- * in a long-lived high-write session. Two cheap defenses keep it bounded:
- *
- *   1. Opportunistic sweep on every `set()`: drop entries already past
- *      the TTL. The TTL is a hard upper bound, so a past-TTL entry is dead
- *      and can never be served — sweeping it changes no observable
- *      behaviour, it only reclaims the slot.
- *   2. Hard max-size cap with oldest-first eviction (belt-and-suspenders)
- *      for the pathological case where many DISTINCT keys all stay fresh
- *      (a read-only burst the sweep cannot reclaim). `Map` preserves
- *      insertion order, so the oldest entry is the first key.
- *
- * Concrete generic type `T` — no `any`. The cache stores whatever the
- * handler computed (the structured inspect payload).
- *
- * @license MIT
- */
-/** Hard TTL upper bound for a cached inspection entry (60 seconds). */
-export declare const INSPECTION_CACHE_TTL_MS = 60000;
-/**
- * Hard ceiling on live entries. Reached only when many DISTINCT keys stay
- * fresh inside the TTL (a read-only burst the TTL-sweep cannot reclaim);
- * the normal write-driven etag churn is reclaimed by the sweep long before
- * this. 256 covers a generous working set while keeping the Map tiny.
- */
-export declare const INSPECTION_CACHE_MAX_ENTRIES = 256;
-/** Monotonic-ish millisecond clock; defaults to `Date.now`. */
-export type Clock = () => number;
-export declare class InspectionCache<T> {
-    private readonly store;
-    private readonly now;
-    private readonly ttlMs;
-    private readonly maxEntries;
-    constructor(now?: Clock, ttlMs?: number, maxEntries?: number);
-    /** Build the composite cache key. Pipe-joined; the parts are
-     * server-controlled identifiers (template id, JSON-Pointer, quoted
-     * etag) so collision via a literal `|` in a value is not a concern. */
-    private key;
-    /** Read a fresh entry, or `undefined` on miss / expiry. Expired
-     * entries are evicted on access. */
-    get(templateId: string, elementPath: string, etag: string): T | undefined;
-    /**
-     * Store a value under the composite key, stamped with the clock.
-     *
-     * Bounds the Map first (sweep past-TTL entries, then enforce the
-     * max-size cap with oldest-first eviction) so a long-lived high-write
-     * session cannot leak old-etag keys. See class doc for the why.
-     */
-    set(templateId: string, elementPath: string, etag: string, value: T): void;
-    /**
-     * Number of LIVE (non-expired) entries currently held. Counts rather
-     * than returns `store.size` so a caller (and the tests) sees the true
-     * working-set size even if a not-yet-swept dead entry lingers.
-     */
-    size(): number;
-    /** Drop every entry whose TTL has elapsed. Cheap, and dead entries
-     * can never be served, so this changes no observable behaviour. */
-    private sweepExpired;
-    /** Evict oldest-first until the Map is within the max-size cap. `Map`
-     * iterates in insertion order, so the first key is the oldest. */
-    private enforceMaxEntries;
-}
-//# sourceMappingURL=inspection-cache.d.ts.map

package/dist/tools/multi-items/inspection-cache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"inspection-cache.d.ts","sourceRoot":"","sources":["../../../src/tools/multi-items/inspection-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD,+DAA+D;AAC/D,MAAM,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC;AAOjC,qBAAa,eAAe,CAAC,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAC1D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGhC,GAAG,GAAE,KAAgB,EACrB,KAAK,GAAE,MAAgC,EACvC,UAAU,GAAE,MAAqC;IAOrD;;2EAEuE;IACvE,OAAO,CAAC,GAAG;IAIX;wCACoC;IACpC,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAWzE;;;;;;OAMG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAO1E;;;;OAIG;IACH,IAAI,IAAI,MAAM;IASd;uEACmE;IACnE,OAAO,CAAC,YAAY;IASpB;sEACkE;IAClE,OAAO,CAAC,iBAAiB;CAO5B"}

package/dist/tools/multi-items/inspection-cache.js

@@ -1,126 +0,0 @@
-/**
- * InspectionCache — Wave-16 #34 (6.2).
- *
- * A tiny in-process TTL cache for `inspect_multi_items_binding` results.
- * Keyed by `(template_id, element_path, etag)`:
- *
- *   - `template_id` + `element_path` identify the element;
- *   - `etag` is the GLOBAL state ETag (from `GET /etag`). Every write
- *     tool bumps it (see ETAG schema note: "every successful write
- *     returns a NEW ETag"). So a write to ANY template surfaces a fresh
- *     etag → a NEW cache key → a guaranteed miss. The stale entry for a
- *     mutated template can never be served. This reuses the existing
- *     etag-bump mechanism rather than inventing a parallel invalidation
- *     channel.
- *
- * TTL is a hard 60s upper bound so an entry cannot live indefinitely
- * even if the etag never changes (read-only sessions). The clock is
- * injectable so the TTL behaviour is testable without sleeping.
- *
- * Bounded growth — Wave-16 Phase-6 nit. The key embeds the GLOBAL etag,
- * and every write bumps it, so each `set()` lands under a NEW key while
- * the old-etag entries are never re-queried (the handler always reads the
- * current etag). Without a bound they would accumulate in the Map forever
- * in a long-lived high-write session. Two cheap defenses keep it bounded:
- *
- *   1. Opportunistic sweep on every `set()`: drop entries already past
- *      the TTL. The TTL is a hard upper bound, so a past-TTL entry is dead
- *      and can never be served — sweeping it changes no observable
- *      behaviour, it only reclaims the slot.
- *   2. Hard max-size cap with oldest-first eviction (belt-and-suspenders)
- *      for the pathological case where many DISTINCT keys all stay fresh
- *      (a read-only burst the sweep cannot reclaim). `Map` preserves
- *      insertion order, so the oldest entry is the first key.
- *
- * Concrete generic type `T` — no `any`. The cache stores whatever the
- * handler computed (the structured inspect payload).
- *
- * @license MIT
- */
-/** Hard TTL upper bound for a cached inspection entry (60 seconds). */
-export const INSPECTION_CACHE_TTL_MS = 60_000;
-/**
- * Hard ceiling on live entries. Reached only when many DISTINCT keys stay
- * fresh inside the TTL (a read-only burst the TTL-sweep cannot reclaim);
- * the normal write-driven etag churn is reclaimed by the sweep long before
- * this. 256 covers a generous working set while keeping the Map tiny.
- */
-export const INSPECTION_CACHE_MAX_ENTRIES = 256;
-export class InspectionCache {
-    store = new Map();
-    now;
-    ttlMs;
-    maxEntries;
-    constructor(now = Date.now, ttlMs = INSPECTION_CACHE_TTL_MS, maxEntries = INSPECTION_CACHE_MAX_ENTRIES) {
-        this.now = now;
-        this.ttlMs = ttlMs;
-        this.maxEntries = maxEntries;
-    }
-    /** Build the composite cache key. Pipe-joined; the parts are
-     * server-controlled identifiers (template id, JSON-Pointer, quoted
-     * etag) so collision via a literal `|` in a value is not a concern. */
-    key(templateId, elementPath, etag) {
-        return `${templateId}|${elementPath}|${etag}`;
-    }
-    /** Read a fresh entry, or `undefined` on miss / expiry. Expired
-     * entries are evicted on access. */
-    get(templateId, elementPath, etag) {
-        const k = this.key(templateId, elementPath, etag);
-        const entry = this.store.get(k);
-        if (entry === undefined)
-            return undefined;
-        if (this.now() - entry.storedAt >= this.ttlMs) {
-            this.store.delete(k);
-            return undefined;
-        }
-        return entry.value;
-    }
-    /**
-     * Store a value under the composite key, stamped with the clock.
-     *
-     * Bounds the Map first (sweep past-TTL entries, then enforce the
-     * max-size cap with oldest-first eviction) so a long-lived high-write
-     * session cannot leak old-etag keys. See class doc for the why.
-     */
-    set(templateId, elementPath, etag, value) {
-        const k = this.key(templateId, elementPath, etag);
-        this.sweepExpired();
-        this.store.set(k, { value, storedAt: this.now() });
-        this.enforceMaxEntries();
-    }
-    /**
-     * Number of LIVE (non-expired) entries currently held. Counts rather
-     * than returns `store.size` so a caller (and the tests) sees the true
-     * working-set size even if a not-yet-swept dead entry lingers.
-     */
-    size() {
-        let live = 0;
-        const cutoff = this.now();
-        for (const entry of this.store.values()) {
-            if (cutoff - entry.storedAt < this.ttlMs)
-                live++;
-        }
-        return live;
-    }
-    /** Drop every entry whose TTL has elapsed. Cheap, and dead entries
-     * can never be served, so this changes no observable behaviour. */
-    sweepExpired() {
-        const cutoff = this.now();
-        for (const [k, entry] of this.store) {
-            if (cutoff - entry.storedAt >= this.ttlMs) {
-                this.store.delete(k);
-            }
-        }
-    }
-    /** Evict oldest-first until the Map is within the max-size cap. `Map`
-     * iterates in insertion order, so the first key is the oldest. */
-    enforceMaxEntries() {
-        while (this.store.size > this.maxEntries) {
-            const oldest = this.store.keys().next().value;
-            if (oldest === undefined)
-                break;
-            this.store.delete(oldest);
-        }
-    }
-}
-//# sourceMappingURL=inspection-cache.js.map