@miragon/pulse-widget-shell 0.0.0-stage → 0.22.0

package/dist/testing/source-scan.js

@@ -0,0 +1,57 @@
+import { readdirSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+import ts from "typescript";
+/**
+ * The source walk shared by the code gates (`scanGlyphs`, `scanColors`):
+ * parse `.ts`/`.tsx` with `typescript` and visit what ends up on screen or in
+ * a class list, never comments (a comment may name what a gate bans).
+ */
+const SKIP_DIRS = new Set(["node_modules", "dist", "coverage"]);
+/**
+ * Every `.ts`/`.tsx` source under `dir`, tests, declarations and build output
+ * excluded, in name order (findings come out the same on every file system).
+ */
+export function sourceFiles(dir) {
+    const entries = readdirSync(dir, { withFileTypes: true });
+    // Names are unique within a directory: never equal.
+    entries.sort((a, b) => (a.name < b.name ? -1 : 1));
+    return entries.flatMap((entry) => {
+        const path = join(dir, entry.name);
+        if (entry.isDirectory())
+            return SKIP_DIRS.has(entry.name) ? [] : sourceFiles(path);
+        const isSource = /\.tsx?$/.test(entry.name) && !/\.(test|spec|d)\.tsx?$/.test(entry.name);
+        return isSource ? [path] : [];
+    });
+}
+/** `path` relative to `dir` with "/" separators: stable keys for allow lists on every OS. */
+export function relativePath(dir, path) {
+    return relative(dir, path).split(sep).join("/");
+}
+export function parseSource(source, file) {
+    const kind = file.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS;
+    return ts.createSourceFile(file, source, ts.ScriptTarget.Latest, true, kind);
+}
+/** The text of a string or template literal (each template part on its own). */
+export function literalText(node) {
+    if (ts.isStringLiteral(node) ||
+        ts.isNoSubstitutionTemplateLiteral(node) ||
+        ts.isTemplateHead(node) ||
+        ts.isTemplateMiddle(node) ||
+        ts.isTemplateTail(node)) {
+        return node.text;
+    }
+    return undefined;
+}
+/** The 1-based line a node starts on. */
+export function lineOf(sf, node) {
+    return sf.getLineAndCharacterOfPosition(node.getStart(sf)).line + 1;
+}
+/** Depth-first walk over every node of a source file. */
+export function walkNodes(sf, visit) {
+    const step = (node) => {
+        visit(node);
+        ts.forEachChild(node, step);
+    };
+    step(sf);
+}
+//# sourceMappingURL=source-scan.js.map

package/dist/testing/source-scan.js.map

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

package/dist/testing/tone-pairs.d.ts

@@ -0,0 +1,20 @@
+import type { ContrastPair } from "./contrast.js";
+/**
+ * Every pair the tone model promises, per tone: the tint's text, the ink,
+ * dot, icon and edge on the card and the page (text 4.5:1, the rest 3:1),
+ * the dot and icon inside the tint, and plain foreground text on the tint
+ * (a soft KPI card). Derived from the TONE_* maps themselves, so a new
+ * class there is measured without touching the test.
+ */
+export declare function toneContrastPairs(): ContrastPair[];
+/**
+ * The neutral and interaction roles of the theme contract (CI §3.2/§12):
+ * text on every surface, every `<role>-foreground` on its fill (primary at
+ * rest and on hover, secondary, accent — the hover and selected surface —,
+ * destructive, popover), the link, both focus indicators (`--focus`, the
+ * outline; `--ring`, the `focus-visible:ring-ring` utilities) and the input
+ * edge. Text 4.5:1, the rest 3:1. A role a consumer may override belongs in
+ * this list, so a brand that breaks it fails the suite that measures it.
+ */
+export declare const ROLE_CONTRAST_PAIRS: readonly ContrastPair[];
+//# sourceMappingURL=tone-pairs.d.ts.map

package/dist/testing/tone-pairs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tone-pairs.d.ts","sourceRoot":"","sources":["../../src/testing/tone-pairs.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAyDjD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,YAAY,EAAE,CAoBlD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,YAAY,EA2DtD,CAAA"}

package/dist/testing/tone-pairs.js

@@ -0,0 +1,154 @@
+// The toolkit's tone model (one vocabulary, three roles per tone) — the maps
+// every kit component and widget draws a state with.
+import { TONE_BORDER, TONE_DOT, TONE_ICON, TONE_INK, TONE_SOFT, TONE_VARIANTS, } from "@miragon/mcp-toolkit-ui";
+/** `bg-danger-soft text-danger-ink` + `"text"` → `--color-danger-ink` (the Tailwind theme variable). */
+function classVariable(classes, prefix) {
+    const token = classes.split(/\s+/).find((c) => c.startsWith(`${prefix}-`));
+    if (!token)
+        throw new Error(`No ${prefix}-* class in "${classes}"`);
+    return `--color-${token.slice(prefix.length + 1)}`;
+}
+const SURFACES = ["--color-card", "--color-background"];
+function surfacePairs(tone, surface) {
+    const soft = TONE_SOFT[tone];
+    const on = `on ${surface.replace("--color-", "")}`;
+    const pairs = [
+        {
+            label: `TONE_SOFT.${tone}: text on its tint ${on}`,
+            fg: classVariable(soft, "text"),
+            bg: classVariable(soft, "bg"),
+            over: surface,
+            min: 4.5,
+        },
+        {
+            label: `TONE_INK.${tone} ${on}`,
+            fg: classVariable(TONE_INK[tone], "text"),
+            bg: surface,
+            over: surface,
+            min: 4.5,
+        },
+        {
+            label: `TONE_DOT.${tone} ${on}`,
+            fg: classVariable(TONE_DOT[tone], "bg"),
+            bg: surface,
+            over: surface,
+            min: 3,
+        },
+        {
+            label: `TONE_ICON.${tone} ${on}`,
+            fg: classVariable(TONE_ICON[tone], "text"),
+            bg: surface,
+            over: surface,
+            min: 3,
+        },
+    ];
+    // The neutral edge is a decorative line (CI: --cd-linie, no contrast claim).
+    if (tone !== "neutral") {
+        pairs.push({
+            label: `TONE_BORDER.${tone} ${on}`,
+            fg: classVariable(TONE_BORDER[tone], "border"),
+            bg: surface,
+            over: surface,
+            min: 3,
+        });
+    }
+    return pairs;
+}
+/**
+ * Every pair the tone model promises, per tone: the tint's text, the ink,
+ * dot, icon and edge on the card and the page (text 4.5:1, the rest 3:1),
+ * the dot and icon inside the tint, and plain foreground text on the tint
+ * (a soft KPI card). Derived from the TONE_* maps themselves, so a new
+ * class there is measured without touching the test.
+ */
+export function toneContrastPairs() {
+    return TONE_VARIANTS.flatMap((tone) => {
+        const tint = classVariable(TONE_SOFT[tone], "bg");
+        return [
+            ...SURFACES.flatMap((surface) => surfacePairs(tone, surface)),
+            {
+                label: `TONE_DOT.${tone} inside its tint`,
+                fg: classVariable(TONE_DOT[tone], "bg"),
+                bg: tint,
+                min: 3,
+            },
+            {
+                label: `TONE_ICON.${tone} inside its tint`,
+                fg: classVariable(TONE_ICON[tone], "text"),
+                bg: tint,
+                min: 3,
+            },
+            { label: `foreground on the ${tone} tint`, fg: "--color-foreground", bg: tint, min: 4.5 },
+        ];
+    });
+}
+/**
+ * The neutral and interaction roles of the theme contract (CI §3.2/§12):
+ * text on every surface, every `<role>-foreground` on its fill (primary at
+ * rest and on hover, secondary, accent — the hover and selected surface —,
+ * destructive, popover), the link, both focus indicators (`--focus`, the
+ * outline; `--ring`, the `focus-visible:ring-ring` utilities) and the input
+ * edge. Text 4.5:1, the rest 3:1. A role a consumer may override belongs in
+ * this list, so a brand that breaks it fails the suite that measures it.
+ */
+export const ROLE_CONTRAST_PAIRS = [
+    {
+        label: "foreground on background",
+        fg: "--foreground",
+        bg: "--background",
+        over: "--background",
+        min: 4.5,
+    },
+    { label: "foreground on card", fg: "--foreground", bg: "--card", min: 4.5 },
+    { label: "card-foreground on card", fg: "--card-foreground", bg: "--card", min: 4.5 },
+    { label: "popover-foreground on popover", fg: "--popover-foreground", bg: "--popover", min: 4.5 },
+    { label: "muted-foreground on card", fg: "--muted-foreground", bg: "--card", min: 4.5 },
+    {
+        label: "muted-foreground on background",
+        fg: "--muted-foreground",
+        bg: "--background",
+        over: "--background",
+        min: 4.5,
+    },
+    { label: "muted-foreground on muted", fg: "--muted-foreground", bg: "--muted", min: 4.5 },
+    { label: "primary-foreground on primary", fg: "--primary-foreground", bg: "--primary", min: 4.5 },
+    {
+        label: "primary-foreground on primary-hover",
+        fg: "--primary-foreground",
+        bg: "--primary-hover",
+        min: 4.5,
+    },
+    {
+        label: "secondary-foreground on secondary",
+        fg: "--secondary-foreground",
+        bg: "--secondary",
+        min: 4.5,
+    },
+    { label: "accent-foreground on accent", fg: "--accent-foreground", bg: "--accent", min: 4.5 },
+    {
+        label: "destructive-foreground on destructive",
+        fg: "--destructive-foreground",
+        bg: "--destructive",
+        min: 4.5,
+    },
+    { label: "link on card", fg: "--link", bg: "--card", min: 4.5 },
+    { label: "link on background", fg: "--link", bg: "--background", over: "--background", min: 4.5 },
+    { label: "focus ring on card", fg: "--focus", bg: "--card", min: 3 },
+    {
+        label: "focus ring on background",
+        fg: "--focus",
+        bg: "--background",
+        over: "--background",
+        min: 3,
+    },
+    { label: "ring on card", fg: "--ring", bg: "--card", min: 3 },
+    { label: "ring on background", fg: "--ring", bg: "--background", over: "--background", min: 3 },
+    {
+        label: "input edge on background",
+        fg: "--input",
+        bg: "--background",
+        over: "--background",
+        min: 3,
+    },
+];
+//# sourceMappingURL=tone-pairs.js.map

package/dist/testing/tone-pairs.js.map

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

package/dist/testing/type-scale.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The type-scale gate (CLAUDE.md "Design-System"; modeler-tool-design §4,
+ * the toolkit's `TYPE_SCALE`): widget text sits on the five steps of the
+ * scale — `text-title` (28/700, a widget's page title, the CI h2),
+ * `text-section` (21/600), `text-body` (16), `text-dense` (14, dense tables
+ * and controls) and `text-small` (13, the FLOOR) — and nothing renders
+ * smaller than 13 px. Two rules:
+ *
+ * - `below-floor`: `text-xs` (12 px), `text-2xs`, an arbitrary size under
+ *   13 px (`text-[11px]`, `text-[0.7rem]`);
+ * - `off-scale`: Tailwind's own sizes (`text-sm`, `text-base`, `text-lg` …
+ *   `text-9xl`) and any other arbitrary size — the step names say what the
+ *   text IS, so the scale changes in one place.
+ *
+ * It reads string and template literals (class lists), never comments.
+ */
+export type TypeScaleRule = "below-floor" | "off-scale";
+export interface TypeScaleFinding {
+    file: string;
+    line: number;
+    rule: TypeScaleRule;
+    match: string;
+    text: string;
+}
+/** Every text size off the scale (or below its floor) in one source file. */
+export declare function typeScaleFindings(source: string, file: string): TypeScaleFinding[];
+export interface ScanTypeScaleOptions {
+    /**
+     * The rules to enforce (default both). A package still migrating its
+     * widgets onto the steps starts with `["below-floor"]`.
+     */
+    rules?: readonly TypeScaleRule[];
+}
+/**
+ * Scan every `.ts`/`.tsx` source under `dir` (tests and declarations
+ * excluded) for text sizes off the type scale. Findings carry "/"-separated
+ * paths relative to `dir`.
+ */
+export declare function scanTypeScale(dir: string, options?: ScanTypeScaleOptions): TypeScaleFinding[];
+//# sourceMappingURL=type-scale.d.ts.map

package/dist/testing/type-scale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-scale.d.ts","sourceRoot":"","sources":["../../src/testing/type-scale.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,WAAW,CAAA;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,aAAa,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb;AAiCD,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAWlF;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,aAAa,EAAE,CAAA;CACjC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,gBAAgB,EAAE,CAKjG"}

package/dist/testing/type-scale.js

@@ -0,0 +1,55 @@
+import { readFileSync } from "node:fs";
+import { lineOf, literalText, parseSource, relativePath, sourceFiles, walkNodes, } from "./source-scan.js";
+/** The floor, in px (CI §4 "klein"); `0.8125rem` at the default 16 px root. */
+const FLOOR_PX = 13;
+const ROOT_PX = 16;
+const BELOW_FLOOR_CLASS = /(?<![\w-])(?:[\w-]+:)*text-(?:2?xs)(?![\w-])/g;
+const OFF_SCALE_CLASS = /(?<![\w-])(?:[\w-]+:)*text-(?:sm|base|lg|[2-9]?xl)(?![\w-])/g;
+/** `text-[11px]`, `text-[0.8rem]`, `text-[length:12px]`. */
+const ARBITRARY_SIZE = /(?<![\w-])(?:[\w-]+:)*text-\[(?:length:)?(\d*\.?\d+)(px|rem|em)\]/g;
+/** The px value of an arbitrary size. */
+function px(value, unit) {
+    const n = Number(value);
+    return unit === "px" ? n : n * ROOT_PX;
+}
+/** Every off-scale or below-floor text size in one literal. */
+function literalFindings(text) {
+    const out = [];
+    for (const m of text.matchAll(BELOW_FLOOR_CLASS)) {
+        out.push({ rule: "below-floor", match: m[0], at: m.index });
+    }
+    for (const m of text.matchAll(OFF_SCALE_CLASS)) {
+        out.push({ rule: "off-scale", match: m[0], at: m.index });
+    }
+    for (const m of text.matchAll(ARBITRARY_SIZE)) {
+        const rule = px(m[1], m[2]) < FLOOR_PX ? "below-floor" : "off-scale";
+        out.push({ rule, match: m[0], at: m.index });
+    }
+    return out.sort((a, b) => a.at - b.at);
+}
+/** Every text size off the scale (or below its floor) in one source file. */
+export function typeScaleFindings(source, file) {
+    const sf = parseSource(source, file);
+    const findings = [];
+    walkNodes(sf, (node) => {
+        const text = literalText(node);
+        if (text === undefined)
+            return;
+        for (const { rule, match } of literalFindings(text)) {
+            findings.push({ file, line: lineOf(sf, node), rule, match, text: text.trim().slice(0, 80) });
+        }
+    });
+    return findings;
+}
+/**
+ * Scan every `.ts`/`.tsx` source under `dir` (tests and declarations
+ * excluded) for text sizes off the type scale. Findings carry "/"-separated
+ * paths relative to `dir`.
+ */
+export function scanTypeScale(dir, options = {}) {
+    const rules = new Set(options.rules ?? ["below-floor", "off-scale"]);
+    return sourceFiles(dir)
+        .flatMap((path) => typeScaleFindings(readFileSync(path, "utf8"), relativePath(dir, path)))
+        .filter((finding) => rules.has(finding.rule));
+}
+//# sourceMappingURL=type-scale.js.map

package/dist/testing/type-scale.js.map

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

package/dist/testing/type-scale.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type-scale.test.d.ts.map

package/dist/testing/type-scale.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-scale.test.d.ts","sourceRoot":"","sources":["../../src/testing/type-scale.test.ts"],"names":[],"mappings":""}

package/dist/testing/type-scale.test.js

@@ -0,0 +1,61 @@
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { scanTypeScale, typeScaleFindings } from "./type-scale.js";
+const found = (source) => typeScaleFindings(source, "x.tsx").map(({ rule, match }) => `${rule}:${match}`);
+describe("typeScaleFindings", () => {
+    it("passes the five steps of the scale", () => {
+        expect(found(`const a = "text-title text-section text-body text-dense text-small md:text-dense"
+         const b = \`text-small \${x}\``)).toEqual([]);
+    });
+    it("fails text below the 13 px floor", () => {
+        expect(found(`const a = "text-xs sm:text-2xs text-[11px] text-[0.7rem] text-[length:10px]"`)).toEqual([
+            "below-floor:text-xs",
+            "below-floor:sm:text-2xs",
+            "below-floor:text-[11px]",
+            "below-floor:text-[0.7rem]",
+            "below-floor:text-[length:10px]",
+        ]);
+    });
+    it("fails Tailwind's own sizes and other arbitrary sizes as off the scale", () => {
+        expect(found(`const a = "text-sm text-base md:text-lg text-xl text-2xl text-[15px] text-[1rem]"`)).toEqual([
+            "off-scale:text-sm",
+            "off-scale:text-base",
+            "off-scale:md:text-lg",
+            "off-scale:text-xl",
+            "off-scale:text-2xl",
+            "off-scale:text-[15px]",
+            "off-scale:text-[1rem]",
+        ]);
+    });
+    it("never mistakes a step or a colour for a size, and skips comments", () => {
+        expect(found(`// text-xs in a comment
+        const a = "text-small text-section text-muted-foreground text-smaller-thing text-sm-ish"`)).toEqual([]);
+    });
+    it("names the line of the literal", () => {
+        expect(typeScaleFindings(`\n\nconst a = "text-xs"`, "x.tsx")[0]).toMatchObject({
+            file: "x.tsx",
+            line: 3,
+            text: "text-xs",
+        });
+    });
+});
+describe("scanTypeScale", () => {
+    let dir;
+    afterEach(() => {
+        if (dir)
+            rmSync(dir, { recursive: true, force: true });
+    });
+    it("scans a tree's sources (not its tests), optionally one rule only", () => {
+        dir = mkdtempSync(join(tmpdir(), "type-scale-"));
+        writeFileSync(join(dir, "a.tsx"), `export const a = "text-xs text-sm"`);
+        writeFileSync(join(dir, "a.test.tsx"), `export const t = "text-xs"`);
+        expect(scanTypeScale(dir).map((f) => `${f.file}:${f.match}`)).toEqual([
+            "a.tsx:text-xs",
+            "a.tsx:text-sm",
+        ]);
+        expect(scanTypeScale(dir, { rules: ["below-floor"] }).map((f) => f.match)).toEqual(["text-xs"]);
+    });
+});
+//# sourceMappingURL=type-scale.test.js.map

package/dist/testing/type-scale.test.js.map

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

package/dist/tool-schema-trim.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Trims the input schemas `tools/list` advertises of keys that tell a model
+ * nothing but cost characters on EVERY tool of every turn:
+ *
+ * - the `$schema` dialect URI zod stamps on each input schema;
+ * - the ±`Number.MAX_SAFE_INTEGER` bounds zod emits for every `.int()` — no
+ *   caller ever approaches them, and a real bound (`maxResults ≤ 100`, an
+ *   offset `≥ 0`) stays untouched.
+ *
+ * Behaviour-neutral: input validation runs server-side against the zod
+ * schemas, never against the advertised JSON. Output schemas stay untouched —
+ * a client validates `structuredContent` against them, and the model never
+ * reads them. Server path only.
+ */
+/** The narrow structural surface the middleware needs (an `MCPServer` satisfies it). */
+export interface ToolListMiddlewareHost {
+    use(pattern: "mcp:tools/list", fn: (ctx: unknown, next: () => Promise<unknown[]>) => Promise<unknown[]>): unknown;
+}
+/** One advertised schema, trimmed: no root `$schema`, no safe-integer bounds. */
+export declare function trimToolSchema(schema: unknown): unknown;
+/** One `tools/list` entry with its input schema trimmed. */
+export declare function trimToolDescriptor(tool: unknown): unknown;
+export declare function installToolSchemaTrim(server: ToolListMiddlewareHost): void;
+//# sourceMappingURL=tool-schema-trim.d.ts.map

package/dist/tool-schema-trim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema-trim.d.ts","sourceRoot":"","sources":["../src/tool-schema-trim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,wFAAwF;AACxF,MAAM,WAAW,sBAAsB;IACrC,GAAG,CACD,OAAO,EAAE,gBAAgB,EACzB,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,GACvE,OAAO,CAAA;CACX;AAwBD,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAKvD;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAGzD;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAE1E"}

package/dist/tool-schema-trim.js

@@ -0,0 +1,49 @@
+/**
+ * Trims the input schemas `tools/list` advertises of keys that tell a model
+ * nothing but cost characters on EVERY tool of every turn:
+ *
+ * - the `$schema` dialect URI zod stamps on each input schema;
+ * - the ±`Number.MAX_SAFE_INTEGER` bounds zod emits for every `.int()` — no
+ *   caller ever approaches them, and a real bound (`maxResults ≤ 100`, an
+ *   offset `≥ 0`) stays untouched.
+ *
+ * Behaviour-neutral: input validation runs server-side against the zod
+ * schemas, never against the advertised JSON. Output schemas stay untouched —
+ * a client validates `structuredContent` against them, and the model never
+ * reads them. Server path only.
+ */
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isSafeIntegerBound(key, value) {
+    return ((key === "maximum" && value === Number.MAX_SAFE_INTEGER) ||
+        (key === "minimum" && value === Number.MIN_SAFE_INTEGER));
+}
+/** A copy of `node` without the safe-integer bounds, at every depth. */
+function withoutSafeIntegerBounds(node) {
+    if (Array.isArray(node))
+        return node.map(withoutSafeIntegerBounds);
+    if (!isRecord(node))
+        return node;
+    return Object.fromEntries(Object.entries(node)
+        .filter(([key, value]) => !isSafeIntegerBound(key, value))
+        .map(([key, value]) => [key, withoutSafeIntegerBounds(value)]));
+}
+/** One advertised schema, trimmed: no root `$schema`, no safe-integer bounds. */
+export function trimToolSchema(schema) {
+    if (!isRecord(schema))
+        return schema;
+    const rest = { ...schema };
+    delete rest.$schema;
+    return withoutSafeIntegerBounds(rest);
+}
+/** One `tools/list` entry with its input schema trimmed. */
+export function trimToolDescriptor(tool) {
+    if (!isRecord(tool) || !("inputSchema" in tool))
+        return tool;
+    return { ...tool, inputSchema: trimToolSchema(tool.inputSchema) };
+}
+export function installToolSchemaTrim(server) {
+    server.use("mcp:tools/list", async (_ctx, next) => (await next()).map(trimToolDescriptor));
+}
+//# sourceMappingURL=tool-schema-trim.js.map

package/dist/tool-schema-trim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema-trim.js","sourceRoot":"","sources":["../src/tool-schema-trim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW,EAAE,KAAc;IACrD,OAAO,CACL,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,KAAK,MAAM,CAAC,gBAAgB,CAAC;QACxD,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,KAAK,MAAM,CAAC,gBAAgB,CAAC,CACzD,CAAA;AACH,CAAC;AAED,wEAAwE;AACxE,SAAS,wBAAwB,CAAC,IAAa;IAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAA;IAClE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAChC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;SACjB,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;SACzD,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC,CACjE,CAAA;AACH,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAA;IACpC,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,EAAE,CAAA;IAC1B,OAAO,IAAI,CAAC,OAAO,CAAA;IACnB,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAA;AACvC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,aAAa,IAAI,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAC5D,OAAO,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAA;AACnE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAA8B;IAClE,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAA;AAC5F,CAAC"}

package/dist/tool-schema-trim.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-schema-trim.test.d.ts.map

package/dist/tool-schema-trim.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema-trim.test.d.ts","sourceRoot":"","sources":["../src/tool-schema-trim.test.ts"],"names":[],"mappings":""}

package/dist/tool-schema-trim.test.js

@@ -0,0 +1,53 @@
+import { describe, expect, it, vi } from "vitest";
+import { z } from "zod";
+import { installToolSchemaTrim, trimToolDescriptor, trimToolSchema } from "./tool-schema-trim.js";
+const input = z.toJSONSchema(z.object({
+    firstResult: z.number().int().min(0).optional(),
+    maxResults: z.number().int().positive().max(100).optional(),
+    nested: z.object({ count: z.number().int() }).optional(),
+    items: z.array(z.object({ retries: z.number().int() })).optional(),
+}));
+describe("trimToolSchema", () => {
+    it("drops the $schema dialect and every safe-integer bound, keeping real bounds", () => {
+        expect(input.$schema).toBeDefined();
+        expect(JSON.stringify(input)).toContain(String(Number.MAX_SAFE_INTEGER));
+        const trimmed = trimToolSchema(input);
+        expect(trimmed).not.toHaveProperty("$schema");
+        expect(JSON.stringify(trimmed)).not.toContain(String(Number.MAX_SAFE_INTEGER));
+        expect(trimmed.properties).toMatchObject({
+            firstResult: { type: "integer", minimum: 0 },
+            maxResults: { type: "integer", exclusiveMinimum: 0, maximum: 100 },
+            nested: { properties: { count: { type: "integer" } } },
+            items: { items: { properties: { retries: { type: "integer" } } } },
+        });
+    });
+    it("never drops a property merely NAMED maximum/minimum", () => {
+        const schema = {
+            type: "object",
+            properties: { maximum: { type: "integer" }, minimum: { type: "number" } },
+        };
+        expect(trimToolSchema(schema)).toEqual(schema);
+    });
+    it("passes non-objects through", () => {
+        expect(trimToolSchema(undefined)).toBeUndefined();
+        expect(trimToolSchema("x")).toBe("x");
+    });
+});
+describe("trimToolDescriptor / installToolSchemaTrim", () => {
+    it("trims the input schema only — the output schema is what clients validate against", () => {
+        const tool = { name: "t", inputSchema: input, outputSchema: input };
+        const trimmed = trimToolDescriptor(tool);
+        expect(trimmed.inputSchema).not.toHaveProperty("$schema");
+        expect(trimmed.outputSchema).toBe(input);
+        expect(trimToolDescriptor({ name: "no-schema" })).toEqual({ name: "no-schema" });
+    });
+    it("registers a tools/list middleware that maps every advertised tool", async () => {
+        const use = vi.fn();
+        installToolSchemaTrim({ use });
+        expect(use).toHaveBeenCalledWith("mcp:tools/list", expect.any(Function));
+        const middleware = use.mock.calls[0][1];
+        const listed = await middleware({}, () => Promise.resolve([{ name: "t", inputSchema: input }]));
+        expect(listed).toEqual([{ name: "t", inputSchema: trimToolSchema(input) }]);
+    });
+});
+//# sourceMappingURL=tool-schema-trim.test.js.map

package/dist/tool-schema-trim.test.js.map

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