@wootsup/yt-builder-mcp 1.12.0 → 2.0.0

package/dist/tools/strict-input.js

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+function editDistance(a, b) {
+    if (a === b)
+        return 0;
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    let prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+    let curr = new Array(b.length + 1).fill(0);
+    for (let i = 1; i <= a.length; i += 1) {
+        curr[0] = i;
+        for (let j = 1; j <= b.length; j += 1) {
+            const substitution = (prev[j - 1] ?? 0) + (a[i - 1] === b[j - 1] ? 0 : 1);
+            const deletion = (prev[j] ?? 0) + 1;
+            const insertion = (curr[j - 1] ?? 0) + 1;
+            curr[j] = Math.min(substitution, deletion, insertion);
+        }
+        const swap = prev;
+        prev = curr;
+        curr = swap;
+    }
+    return prev[b.length] ?? Math.max(a.length, b.length);
+}
+export function rankNearestKeys(unknownKey, declared, take = 3) {
+    const lower = unknownKey.toLowerCase();
+    return [...declared]
+        .map((key, index) => ({ key, index, d: editDistance(lower, key.toLowerCase()) }))
+        .sort((x, y) => (x.d === y.d ? x.index - y.index : x.d - y.d))
+        .slice(0, take)
+        .map((entry) => entry.key);
+}
+export function unknownArgumentMessage(toolName, keys, declared) {
+    const offenders = keys
+        .map((key) => {
+        const near = rankNearestKeys(key, declared);
+        return near.length > 0
+            ? `"${key}" (closest declared: ${near.join(', ')})`
+            : `"${key}"`;
+    })
+        .join('; ');
+    const noun = keys.length === 1 ? 'argument' : 'arguments';
+    return (`Unknown ${noun} for ${toolName}: ${offenders}. ` +
+        `Unknown arguments are REJECTED, not ignored — nothing was written. ` +
+        `Declared arguments: ${declared.length > 0 ? declared.join(', ') : '(none)'}.`);
+}
+export function strictInputObject(toolName, shape) {
+    const declared = Object.keys(shape);
+    return z.strictObject(shape, {
+        error: (issue) => issue.code === 'unrecognized_keys'
+            ? unknownArgumentMessage(toolName, issue.keys ?? [], declared)
+            : undefined,
+    });
+}
+//# sourceMappingURL=strict-input.js.map

package/dist/tools/strict-input.js.map

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

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

@@ -1,23 +1,3 @@
-/**
- * Sublayout tool builder.
- *
- * Surfaces one tool that operates on the YT5 `< SUBLAYOUT` mechanism
- * (F154 / F93):
- *
- *   yootheme_builder_inspect_sublayout
- *     → Reports the fragment subtree (bindable leaves with full JSON-Pointer
- *       paths) AND the render-time inner grid (gated title/image props), so an
- *       agent enriching a panel/grid_item binds the right node and avoids the
- *       silent-no-op trap (grid props set but the gate unsatisfied).
- *
- * L2 (advanced lane) — routed via `yootheme_builder_advanced`. It is a
- * specialized layout diagnostic for one element family (panel/grid_item
- * enrichment), not a hot-path every workflow needs (unlike
- * inspect_multi_items_binding, which earns its L1 slot).
- *
- * @license MIT
- */
-import type { ClientPool } from '../../sites/client-pool.js';
 import { type AnyToolDefinition } from '../tool-builder.js';
-export declare function buildSublayoutTools(pool: ClientPool): readonly AnyToolDefinition[];
+export declare function buildSublayoutTools(): readonly AnyToolDefinition[];
 //# sourceMappingURL=builders.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/sublayout/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAG7D,OAAO,EAIH,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAC;AAQ5B,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,iBAAiB,EAAE,CA8BlF"}
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/tools/sublayout/builders.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGlF,wBAAgB,mBAAmB,IAAI,SAAS,iBAAiB,EAAE,CA8BlE"}

package/dist/tools/sublayout/builders.js

@@ -1,52 +1,23 @@
-/**
- * Sublayout tool builder.
- *
- * Surfaces one tool that operates on the YT5 `< SUBLAYOUT` mechanism
- * (F154 / F93):
- *
- *   yootheme_builder_inspect_sublayout
- *     → Reports the fragment subtree (bindable leaves with full JSON-Pointer
- *       paths) AND the render-time inner grid (gated title/image props), so an
- *       agent enriching a panel/grid_item binds the right node and avoids the
- *       silent-no-op trap (grid props set but the gate unsatisfied).
- *
- * L2 (advanced lane) — routed via `yootheme_builder_advanced`. It is a
- * specialized layout diagnostic for one element family (panel/grid_item
- * enrichment), not a hot-path every workflow needs (unlike
- * inspect_multi_items_binding, which earns its L1 slot).
- *
- * @license MIT
- */
-import { withSiteRetry } from '../pool-resolve-helper.js';
-import { ELEMENT_PATH, SITE_ID_SCHEMA, TEMPLATE_ID } from '../shared-schemas.js';
-import { defineTool, readOnly, withSiteMeta, } from '../tool-builder.js';
-import { InspectionCache } from '../multi-items/inspection-cache.js';
-import { INSPECT_SUBLAYOUT_OUTPUT_SCHEMA, handleInspectSublayout, } from './inspect-sublayout-handler.js';
-export function buildSublayoutTools(pool) {
-    // One shared inspection cache per tool-build, keyed on (template_id,
-    // element_path, global-etag) with a 60s TTL. A write bumps the global
-    // etag and naturally invalidates the entry (mirrors multi-items).
-    const inspectionCache = new InspectionCache();
+import { ELEMENT_PATH, SITE_ID_SCHEMA, LAYOUT_ID } from '../shared-schemas.js';
+import { MAX_CHARS } from '../sparse-fields.js';
+import { defineTool, readOnly } from '../tool-builder.js';
+import { INSPECT_SUBLAYOUT_OUTPUT_SCHEMA } from './output-schemas.js';
+export function buildSublayoutTools() {
     return [
         defineTool({
             name: 'yootheme_builder_inspect_sublayout',
             description: 'Inspects a panel/grid_item `< SUBLAYOUT`: lists the `fragment` subtree ' +
-                'bindable leaves (with JSON-Pointer paths to bind on — NOT the container) ' +
-                'and the render-time inner grid. Flags `ungated_grid_prop` (blocking): grid ' +
-                'props set but the gate (title_align=left / image_align=left|right) ' +
-                'unsatisfied → silent no-op. For container↔item binding see ' +
-                'inspect_multi_items_binding.',
+                'bindable leaves and the render-time inner grid. Flags `ungated_grid_prop`: ' +
+                'grid props set but the gate unsatisfied → silent no-op. For container↔item ' +
+                'binding see inspect_multi_items_binding.',
             inputSchema: {
                 site_id: SITE_ID_SCHEMA,
-                template_id: TEMPLATE_ID,
+                layout_id: LAYOUT_ID,
                 element_path: ELEMENT_PATH,
+                max_chars: MAX_CHARS,
             },
             outputSchema: INSPECT_SUBLAYOUT_OUTPUT_SCHEMA,
             annotations: readOnly('Inspect Sublayout'),
-            handler: async ({ site_id, ...rest }) => withSiteRetry(pool, site_id, async (client, site) => {
-                const deps = { client, cache: inspectionCache };
-                return withSiteMeta(await handleInspectSublayout(deps, rest), site);
-            }),
         }),
     ];
 }

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

@@ -1 +1 @@
-{"version":3,"file":"builders.js","sourceRoot":"","sources":["../../../src/tools/sublayout/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EACH,UAAU,EACV,QAAQ,EACR,YAAY,GAEf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EACH,+BAA+B,EAC/B,sBAAsB,GAEzB,MAAM,gCAAgC,CAAC;AAExC,MAAM,UAAU,mBAAmB,CAAC,IAAgB;IAChD,qEAAqE;IACrE,sEAAsE;IACtE,kEAAkE;IAClE,MAAM,eAAe,GAAG,IAAI,eAAe,EAA2B,CAAC;IAEvE,OAAO;QACH,UAAU,CAAC;YACP,IAAI,EAAE,oCAAoC;YAC1C,WAAW,EACP,yEAAyE;gBACzE,2EAA2E;gBAC3E,6EAA6E;gBAC7E,qEAAqE;gBACrE,6DAA6D;gBAC7D,8BAA8B;YAClC,WAAW,EAAE;gBACT,OAAO,EAAE,cAAc;gBACvB,WAAW,EAAE,WAAW;gBACxB,YAAY,EAAE,YAAY;aAC7B;YACD,YAAY,EAAE,+BAA+B;YAC7C,WAAW,EAAE,QAAQ,CAAC,mBAAmB,CAAC;YAC1C,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CACpC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;gBAChD,MAAM,IAAI,GAAyB,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;gBACtE,OAAO,YAAY,CAAC,MAAM,sBAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;YACxE,CAAC,CAAC;SACT,CAAC;KACL,CAAC;AACN,CAAC"}
+{"version":3,"file":"builders.js","sourceRoot":"","sources":["../../../src/tools/sublayout/builders.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAA0B,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAEtE,MAAM,UAAU,mBAAmB;IAC/B,OAAO;QACH,UAAU,CAAC;YACP,IAAI,EAAE,oCAAoC;YAC1C,WAAW,EACP,yEAAyE;gBACzE,6EAA6E;gBAC7E,6EAA6E;gBAC7E,0CAA0C;YAC9C,WAAW,EAAE;gBACT,OAAO,EAAE,cAAc;gBACvB,SAAS,EAAE,SAAS;gBACpB,YAAY,EAAE,YAAY;gBAY1B,SAAS,EAAE,SAAS;aACvB;YACD,YAAY,EAAE,+BAA+B;YAC7C,WAAW,EAAE,QAAQ,CAAC,mBAAmB,CAAC;SAC7C,CAAC;KACL,CAAC;AACN,CAAC"}

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

@@ -1,13 +1,3 @@
-/**
- * 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, type SublayoutHandlerDeps, } from './inspect-sublayout-handler.js';
+export { INSPECT_SUBLAYOUT_OUTPUT_SCHEMA } from './output-schemas.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/sublayout/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/tools/sublayout/index.js

@@ -1,13 +1,3 @@
-/**
- * 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';
+export { INSPECT_SUBLAYOUT_OUTPUT_SCHEMA } from './output-schemas.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/sublayout/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/tools/sublayout/output-schemas.d.ts

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+export declare const INSPECT_SUBLAYOUT_OUTPUT_SCHEMA: z.ZodObject<{
+    layout_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>>;
+    resolved_layout_id: z.ZodOptional<z.ZodString>;
+    resolved_via: z.ZodOptional<z.ZodEnum<{
+        prefixed: "prefixed";
+        theme_template: "theme_template";
+        content_id: "content_id";
+    }>>;
+}, z.core.$strip>;
+//# sourceMappingURL=output-schemas.d.ts.map

package/dist/tools/sublayout/output-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/sublayout/output-schemas.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqCxB,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwB1C,CAAC"}

package/dist/tools/sublayout/output-schemas.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import { RESOLVED_LAYOUT_ID_OUTPUT } from '../shared-schemas.js';
+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()),
+});
+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(),
+    bound_source_exists: z.boolean().nullable().optional(),
+});
+const FRAGMENT_SCHEMA = z.object({
+    fragment_path: z.string(),
+    child_count: z.number().int().nonnegative(),
+    bindable_leaves: z.array(BINDABLE_LEAF_SCHEMA),
+});
+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({
+    ...RESOLVED_LAYOUT_ID_OUTPUT,
+    layout_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(),
+    hint: z
+        .object({
+        severity: z.enum(['advisory', 'blocking']),
+        message: z.string(),
+    })
+        .optional(),
+});
+//# sourceMappingURL=output-schemas.js.map

package/dist/tools/sublayout/output-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-schemas.js","sourceRoot":"","sources":["../../../src/tools/sublayout/output-schemas.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE;IAC3B,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;CAClD,CAAC,CAAC;AAGH,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAExC,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAC;AAGH,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC3C,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC;CACjD,CAAC,CAAC;AAGH,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,GAAG,yBAAyB;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,oBAAoB,EAAE,CAAC,CAAC,OAAO,EAAE;QACjC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;QACnC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACX,KAAK,EAAE,gBAAgB;YACvB,KAAK,EAAE,gBAAgB;SAC1B,CAAC;QACF,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC;QAC3C,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE;KAC5B,CAAC;IACF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAGhB,IAAI,EAAE,CAAC;SACF,MAAM,CAAC;QACJ,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;SACD,QAAQ,EAAE;CAClB,CAAC,CAAC"}

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

@@ -1,55 +1,7 @@
-/**
- * `tool-builder/annotations` — annotation builders that produce the
- * MCP `ToolAnnotations` shape. Each helper encodes a verified
- * read/write/destructive policy so call-sites in domain tools (pages,
- * elements, sources, …) get a single one-liner instead of repeating
- * the four-flag pattern verbatim.
- *
- * Split from `tool-builder.ts` in Round-1.5 — see `index.ts` for
- * the cohesion rationale.
- *
- * Audit-v3 / Stream D3 T3 (2026-05-22) — per Anthropic MCP spec
- * 2026-03-16 "Tool Annotations", every registered tool MUST advertise
- * the full 4-tuple `{readOnlyHint, destructiveHint, idempotentHint,
- * openWorldHint}`. Hosts treat `undefined` hints as "potentially
- * destructive" — defaulting `destructiveHint:false` and
- * `idempotentHint:true/false` explicitly removes that ambiguity for
- * read-only and additive tools.
- *
- * `openWorldHint:false` reflects the closed Builder domain: the REST
- * surface writes to a single local `wp_option('yootheme')` blob —
- * there is no external network side-effect or world-modifying action.
- * The gateway (`yootheme_builder_advanced`) is the exception (its
- * effective behaviour is dynamic, decided at call-time).
- *
- * @license MIT
- */
 import type { ToolAnnotations } from './types.js';
-/**
- * Build a `readOnly` annotation.
- *
- * Reads are idempotent by definition — repeating a read returns the
- * same data (modulo concurrent writes). Setting `idempotentHint:true`
- * is informative for hosts that surface a "safe-to-retry" badge.
- */
 export declare function readOnly(title?: string): ToolAnnotations;
-/**
- * Build a `mutating` annotation for idempotent updates (PUT-style
- * writes — full replacement semantics where repeating the call with
- * the same inputs yields the same end-state).
- */
 export declare function mutating(title?: string): ToolAnnotations;
-/**
- * Build a `creating` annotation for non-idempotent creates (POST-style
- * writes — repeating the call produces additional elements / new IDs).
- */
 export declare function creating(title?: string): ToolAnnotations;
-/**
- * Build a `destructive` annotation. Callers MUST also expose a
- * `confirm` param + preview guard (see annotations-pin.test.ts).
- *
- * Destructive ops are inherently non-idempotent (the first call
- * removes data; the second call hits a 404 / already-gone state).
- */
 export declare function destructive(title?: string): ToolAnnotations;
+export declare function destructiveIdempotent(title?: string): ToolAnnotations;
 //# sourceMappingURL=annotations.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../../src/tools/tool-builder/annotations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAQxD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAQxD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAQxD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAQ3D"}
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../../src/tools/tool-builder/annotations.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AASlD,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAQxD;AAOD,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAQxD;AAMD,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAQxD;AAaD,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAQ3D;AAsBD,wBAAgB,qBAAqB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAQrE"}

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

@@ -1,36 +1,3 @@
-/**
- * `tool-builder/annotations` — annotation builders that produce the
- * MCP `ToolAnnotations` shape. Each helper encodes a verified
- * read/write/destructive policy so call-sites in domain tools (pages,
- * elements, sources, …) get a single one-liner instead of repeating
- * the four-flag pattern verbatim.
- *
- * Split from `tool-builder.ts` in Round-1.5 — see `index.ts` for
- * the cohesion rationale.
- *
- * Audit-v3 / Stream D3 T3 (2026-05-22) — per Anthropic MCP spec
- * 2026-03-16 "Tool Annotations", every registered tool MUST advertise
- * the full 4-tuple `{readOnlyHint, destructiveHint, idempotentHint,
- * openWorldHint}`. Hosts treat `undefined` hints as "potentially
- * destructive" — defaulting `destructiveHint:false` and
- * `idempotentHint:true/false` explicitly removes that ambiguity for
- * read-only and additive tools.
- *
- * `openWorldHint:false` reflects the closed Builder domain: the REST
- * surface writes to a single local `wp_option('yootheme')` blob —
- * there is no external network side-effect or world-modifying action.
- * The gateway (`yootheme_builder_advanced`) is the exception (its
- * effective behaviour is dynamic, decided at call-time).
- *
- * @license MIT
- */
-/**
- * Build a `readOnly` annotation.
- *
- * Reads are idempotent by definition — repeating a read returns the
- * same data (modulo concurrent writes). Setting `idempotentHint:true`
- * is informative for hosts that surface a "safe-to-retry" badge.
- */
 export function readOnly(title) {
     return {
         title,
@@ -40,11 +7,6 @@ export function readOnly(title) {
         openWorldHint: false,
     };
 }
-/**
- * Build a `mutating` annotation for idempotent updates (PUT-style
- * writes — full replacement semantics where repeating the call with
- * the same inputs yields the same end-state).
- */
 export function mutating(title) {
     return {
         title,
@@ -54,10 +16,6 @@ export function mutating(title) {
         openWorldHint: false,
     };
 }
-/**
- * Build a `creating` annotation for non-idempotent creates (POST-style
- * writes — repeating the call produces additional elements / new IDs).
- */
 export function creating(title) {
     return {
         title,
@@ -67,13 +25,6 @@ export function creating(title) {
         openWorldHint: false,
     };
 }
-/**
- * Build a `destructive` annotation. Callers MUST also expose a
- * `confirm` param + preview guard (see annotations-pin.test.ts).
- *
- * Destructive ops are inherently non-idempotent (the first call
- * removes data; the second call hits a 404 / already-gone state).
- */
 export function destructive(title) {
     return {
         title,
@@ -83,4 +34,13 @@ export function destructive(title) {
         openWorldHint: false,
     };
 }
+export function destructiveIdempotent(title) {
+    return {
+        title,
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+    };
+}
 //# sourceMappingURL=annotations.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../../src/tools/tool-builder/annotations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACnC,OAAO;QACH,KAAK;QACL,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACnC,OAAO;QACH,KAAK;QACL,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACnC,OAAO;QACH,KAAK;QACL,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK;QACrB,aAAa,EAAE,KAAK;KACvB,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACtC,OAAO;QACH,KAAK;QACL,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,KAAK;QACrB,aAAa,EAAE,KAAK;KACvB,CAAC;AACN,CAAC"}
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../../src/tools/tool-builder/annotations.ts"],"names":[],"mappings":"AA8CA,MAAM,UAAU,QAAQ,CAAC,KAAc;IACnC,OAAO;QACH,KAAK;QACL,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB,CAAC;AACN,CAAC;AAOD,MAAM,UAAU,QAAQ,CAAC,KAAc;IACnC,OAAO;QACH,KAAK;QACL,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB,CAAC;AACN,CAAC;AAMD,MAAM,UAAU,QAAQ,CAAC,KAAc;IACnC,OAAO;QACH,KAAK;QACL,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK;QACrB,aAAa,EAAE,KAAK;KACvB,CAAC;AACN,CAAC;AAaD,MAAM,UAAU,WAAW,CAAC,KAAc;IACtC,OAAO;QACH,KAAK;QACL,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,KAAK;QACrB,aAAa,EAAE,KAAK;KACvB,CAAC;AACN,CAAC;AAsBD,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAChD,OAAO;QACH,KAAK;QACL,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB,CAAC;AACN,CAAC"}

package/dist/tools/tool-builder/confirm-preview.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export declare const HOST_PROMPT_PROMISE: string;
+export declare const CONFIRM_PREVIEW_FIELDS: {
+    readonly preview: z.ZodOptional<z.ZodBoolean>;
+    readonly applied: z.ZodOptional<z.ZodBoolean>;
+    readonly step_reversible: z.ZodOptional<z.ZodBoolean>;
+    readonly requires_confirmation: z.ZodOptional<z.ZodLiteral<true>>;
+    readonly requires_confirm: z.ZodOptional<z.ZodLiteral<true>>;
+    readonly operation: z.ZodOptional<z.ZodString>;
+    readonly hint: z.ZodOptional<z.ZodString>;
+    readonly warning: z.ZodOptional<z.ZodString>;
+    readonly instruction: z.ZodOptional<z.ZodString>;
+    readonly received_confirm: z.ZodOptional<z.ZodUnknown>;
+    readonly received_confirm_type: z.ZodOptional<z.ZodString>;
+    readonly expected_confirm: z.ZodOptional<z.ZodString>;
+    readonly label: z.ZodOptional<z.ZodString>;
+    readonly host_prompt: z.ZodOptional<z.ZodEnum<{
+        preview_only_host_said_yes: "preview_only_host_said_yes";
+        preview_only_host_said_no: "preview_only_host_said_no";
+        preview_only_host_not_asked: "preview_only_host_not_asked";
+    }>>;
+};
+export declare function requireOnExecutedWrite(value: Record<string, unknown>, ctx: z.RefinementCtx, keys: readonly string[]): void;
+//# sourceMappingURL=confirm-preview.d.ts.map

package/dist/tools/tool-builder/confirm-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-preview.d.ts","sourceRoot":"","sources":["../../../src/tools/tool-builder/confirm-preview.ts"],"names":[],"mappings":"AA8DA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsCxB,eAAO,MAAM,mBAAmB,QAG2D,CAAC;AAuB5F,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;CA0IzB,CAAC;AA8BX,wBAAgB,sBAAsB,CAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,EAAE,CAAC,CAAC,aAAa,EACpB,IAAI,EAAE,SAAS,MAAM,EAAE,GACxB,IAAI,CAmBN"}

package/dist/tools/tool-builder/confirm-preview.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { HOST_PROMPT_ANSWERS } from '../../proxy/confirm-question-contract.js';
+export const HOST_PROMPT_PROMISE = 'If the preview says the step cannot be undone (`step_reversible: false`), a host that '
+    + 'supports elicitation is ALSO asked to confirm and its answer arrives as `host_prompt` — '
+    + 'a report, never an authorization: only a repeat call with `confirm: true` executes.';
+export const CONFIRM_PREVIEW_FIELDS = {
+    preview: z.boolean().optional(),
+    applied: z.boolean().optional(),
+    step_reversible: z.boolean().optional(),
+    requires_confirmation: z.literal(true).optional(),
+    requires_confirm: z.literal(true).optional(),
+    operation: z.string().optional(),
+    hint: z.string().optional(),
+    warning: z.string().optional(),
+    instruction: z.string().optional(),
+    received_confirm: z.unknown().optional(),
+    received_confirm_type: z.string().optional(),
+    expected_confirm: z.string().optional(),
+    label: z.string().optional(),
+    host_prompt: z.enum(HOST_PROMPT_ANSWERS).optional(),
+};
+export function requireOnExecutedWrite(value, ctx, keys) {
+    if (value['requires_confirmation'] === true)
+        return;
+    if (value['applied'] === false)
+        return;
+    for (const key of keys) {
+        if (value[key] === undefined) {
+            ctx.addIssue({
+                code: 'custom',
+                path: [key],
+                message: `an executed write must carry \`${key}\` — only a preview that wrote nothing (\`requires_confirmation: true\` or \`applied: false\`) may omit it`,
+            });
+        }
+    }
+}
+//# sourceMappingURL=confirm-preview.js.map

package/dist/tools/tool-builder/confirm-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-preview.js","sourceRoot":"","sources":["../../../src/tools/tool-builder/confirm-preview.ts"],"names":[],"mappings":"AA8DA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAoC/E,MAAM,CAAC,MAAM,mBAAmB,GAC5B,wFAAwF;MACtF,0FAA0F;MAC1F,qFAAqF,CAAC;AAuB5F,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAclC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAe/B,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACvC,qBAAqB,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IAcjD,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IAM5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAKhC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IASlC,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAUxC,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE5C,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IA4BvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IA8B5B,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE;CAC7C,CAAC;AA8BX,MAAM,UAAU,sBAAsB,CAClC,KAA8B,EAC9B,GAAoB,EACpB,IAAuB;IAEvB,IAAI,KAAK,CAAC,uBAAuB,CAAC,KAAK,IAAI;QAAE,OAAO;IAQpD,IAAI,KAAK,CAAC,SAAS,CAAC,KAAK,KAAK;QAAE,OAAO;IACvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3B,GAAG,CAAC,QAAQ,CAAC;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,GAAG,CAAC;gBACX,OAAO,EAAE,kCAAkC,GAAG,4GAA4G;aAC7J,CAAC,CAAC;QACP,CAAC;IACL,CAAC;AACL,CAAC"}

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

@@ -1,31 +1,11 @@
-/**
- * `tool-builder/define` — the `defineTool` identity helper plus the
- * progress-reporter re-export.
- *
- * `defineTool` is intentionally trivial at runtime (returns its
- * argument verbatim) — its only job is to preserve the inferred Zod
- * schema shape so each tool's handler is fully type-checked against
- * its inputSchema. The wrapping/sanitising work happens in
- * `results.ts`.
- *
- * Split from `tool-builder.ts` in Round-1.5 — see `index.ts` for
- * the cohesion rationale.
- *
- * @license MIT
- */
 import { createProgressReporter as toolkitCreateProgressReporter } from '@getimo/mcp-toolkit';
 import type { ZodRawShape } from 'zod';
-import type { ToolDefinition } from './types.js';
-/**
- * Re-export the toolkit's `createProgressReporter` under a stable
- * local symbol so every write-handler in this package depends on a
- * single import path. Returns `null` when the caller sent no
- * `progressToken` — handlers then no-op via `progress?.report(...)`.
- */
+import type { ToolDefinition, ToolHandler } from './types.js';
 export declare const createProgressReporter: typeof toolkitCreateProgressReporter;
-/**
- * `defineTool` — preserves the inferred Zod-schema shape so each
- * tool's handler is fully type-checked against its inputSchema.
- */
+export declare function defineTool<TSchema extends ZodRawShape>(def: ToolDefinition<TSchema> & {
+    handler: ToolHandler<TSchema>;
+}): ToolDefinition<TSchema> & {
+    handler: ToolHandler<TSchema>;
+};
 export declare function defineTool<TSchema extends ZodRawShape>(def: ToolDefinition<TSchema>): ToolDefinition<TSchema>;
 //# sourceMappingURL=define.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../../src/tools/tool-builder/define.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,sBAAsB,IAAI,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,sCAAgC,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,SAAS,WAAW,EAClD,GAAG,EAAE,cAAc,CAAC,OAAO,CAAC,GAC7B,cAAc,CAAC,OAAO,CAAC,CAEzB"}
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../../src/tools/tool-builder/define.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,sBAAsB,IAAI,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAQ9D,eAAO,MAAM,sBAAsB,sCAAgC,CAAC;AAcpE,wBAAgB,UAAU,CAAC,OAAO,SAAS,WAAW,EAClD,GAAG,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG;IAAE,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;CAAE,GACjE,cAAc,CAAC,OAAO,CAAC,GAAG;IAAE,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC;AAC/D,wBAAgB,UAAU,CAAC,OAAO,SAAS,WAAW,EAClD,GAAG,EAAE,cAAc,CAAC,OAAO,CAAC,GAC7B,cAAc,CAAC,OAAO,CAAC,CAAC"}

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

@@ -1,30 +1,5 @@
-/**
- * `tool-builder/define` — the `defineTool` identity helper plus the
- * progress-reporter re-export.
- *
- * `defineTool` is intentionally trivial at runtime (returns its
- * argument verbatim) — its only job is to preserve the inferred Zod
- * schema shape so each tool's handler is fully type-checked against
- * its inputSchema. The wrapping/sanitising work happens in
- * `results.ts`.
- *
- * Split from `tool-builder.ts` in Round-1.5 — see `index.ts` for
- * the cohesion rationale.
- *
- * @license MIT
- */
 import { createProgressReporter as toolkitCreateProgressReporter } from '@getimo/mcp-toolkit';
-/**
- * Re-export the toolkit's `createProgressReporter` under a stable
- * local symbol so every write-handler in this package depends on a
- * single import path. Returns `null` when the caller sent no
- * `progressToken` — handlers then no-op via `progress?.report(...)`.
- */
 export const createProgressReporter = toolkitCreateProgressReporter;
-/**
- * `defineTool` — preserves the inferred Zod-schema shape so each
- * tool's handler is fully type-checked against its inputSchema.
- */
 export function defineTool(def) {
     return def;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"define.js","sourceRoot":"","sources":["../../../src/tools/tool-builder/define.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,sBAAsB,IAAI,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAI9F;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,6BAA6B,CAAC;AAEpE;;;GAGG;AACH,MAAM,UAAU,UAAU,CACtB,GAA4B;IAE5B,OAAO,GAAG,CAAC;AACf,CAAC"}
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../../src/tools/tool-builder/define.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,sBAAsB,IAAI,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAU9F,MAAM,CAAC,MAAM,sBAAsB,GAAG,6BAA6B,CAAC;AAoBpE,MAAM,UAAU,UAAU,CACtB,GAA4B;IAE5B,OAAO,GAAG,CAAC;AACf,CAAC"}