mcp-use-compat 0.3.0

package/dist/checks/protocol.js

@@ -0,0 +1,380 @@
+import { LATEST_PROTOCOL_VERSION, SUPPORTED_PROTOCOL_VERSIONS } from "@modelcontextprotocol/sdk/types.js";
+import { LIST_KINDS } from "../snapshot.js";
+import { connected, declared, str } from "./util.js";
+import { upgradeHint } from "./sdk.js";
+import { defineCheck } from "./types.js";
+const KINDS = Object.keys(LIST_KINDS);
+const MODERN = "2026-07-28";
+const SPEC_MODERN = `https://modelcontextprotocol.io/specification/${MODERN}`;
+/** Server rejected initialize but speaks 2026-07-28 (older snapshots: discover worked, connect failed). */
+export function modernOnly(s) {
+    return s.era === "modern" || (!s.connect.ok && !!s.discover?.ok);
+}
+const legacyConnected = (s) => connected(s) && s.era !== "modern";
+const modernSupported = (s) => !!s.modern?.supported && !!s.modern.lists;
+const VALID_RESULT_TYPES = new Set(["complete", "input_required"]);
+/** Every modern result we saw, labelled by where it came from. */
+function modernResults(s) {
+    const out = [];
+    if (s.modern?.discoverMeta)
+        out.push(["server/discover", s.modern.discoverMeta]);
+    for (const kind of KINDS) {
+        for (const meta of s.modern?.pagesMeta?.[kind] ?? [])
+            out.push([LIST_KINDS[kind].method, meta]);
+    }
+    return out;
+}
+function supportedVersions(s) {
+    const v = s.discover?.result?.supportedVersions;
+    return Array.isArray(v) ? v.filter((x) => typeof x === "string") : [];
+}
+export const protocolChecks = [
+    defineCheck({
+        id: "PROTOCOL_MODERN_ONLY",
+        area: "protocol",
+        description: "Server still accepts the initialize handshake most clients use",
+        appliesTo: (s) => !!s.discover,
+        run: (s) => modernOnly(s)
+            ? [
+                {
+                    checkId: "PROTOCOL_MODERN_ONLY",
+                    severity: "error",
+                    message: `Server rejects initialize and only answers server/discover (versions: ${supportedVersions(s).join(", ") || "none listed"}). Clients that still use the initialize handshake (protocol 2025-11-25 and older) cannot connect.`,
+                    evidence: { initializeError: s.connect.legacyError ?? s.connect.error, discover: s.discover?.result },
+                    fix: "Keep accepting initialize alongside server/discover until your target clients support the new revision.",
+                },
+            ]
+            : [],
+    }),
+    defineCheck({
+        id: "PROTOCOL_DISCOVER_MISSING",
+        area: "protocol",
+        description: `Server implements server/discover (required from protocol ${MODERN})`,
+        appliesTo: (s) => connected(s) && !!s.discover,
+        run: (s) => s.discover.ok
+            ? []
+            : [
+                {
+                    checkId: "PROTOCOL_DISCOVER_MISSING",
+                    severity: "info",
+                    message: `server/discover failed (${s.discover.error?.message ?? "unknown error"}), so the server only speaks the initialize-based protocol. That works with today's clients; clients on revision ${MODERN} have to fall back to initialize.`,
+                    fix: `When your target clients support ${MODERN}: ${upgradeHint(s, true)}`,
+                },
+            ],
+    }),
+    defineCheck({
+        id: "PROTOCOL_MODERN_RESULT_TYPE",
+        area: "protocol",
+        description: `${MODERN} results carry a valid resultType`,
+        appliesTo: modernSupported,
+        run: (s) => {
+            const results = modernResults(s);
+            const missing = results.filter(([, m]) => m.resultType === undefined).map(([where]) => where);
+            const invalid = results.filter(([, m]) => m.resultType !== undefined && !VALID_RESULT_TYPES.has(String(m.resultType)));
+            const findings = [];
+            if (missing.length) {
+                findings.push({
+                    checkId: "PROTOCOL_MODERN_RESULT_TYPE",
+                    severity: "warn",
+                    subject: [...new Set(missing)].join(", "),
+                    message: `${MODERN} requires resultType on every result; it's missing from ${[...new Set(missing)].join(", ")}. The v2 SDK treats a missing value as "complete", but stricter clients may not.`,
+                    source: `${SPEC_MODERN}/basic/index`,
+                    fix: 'Upgrade to an SDK that implements 2026-07-28, or add resultType: "complete".',
+                });
+            }
+            for (const [where, meta] of invalid) {
+                findings.push({
+                    checkId: "PROTOCOL_MODERN_RESULT_TYPE",
+                    severity: "error",
+                    subject: where,
+                    message: `resultType ${JSON.stringify(meta.resultType)} is not "complete" or "input_required"; clients must treat the result as invalid.`,
+                    source: `${SPEC_MODERN}/basic/index`,
+                });
+            }
+            return findings;
+        },
+    }),
+    defineCheck({
+        id: "PROTOCOL_MODERN_CACHE_FIELDS",
+        area: "protocol",
+        description: `${MODERN} list and discover results carry ttlMs and cacheScope`,
+        appliesTo: modernSupported,
+        run: (s) => {
+            const bad = modernResults(s).filter(([, m]) => typeof m.ttlMs !== "number" || m.ttlMs < 0 || (m.cacheScope !== "public" && m.cacheScope !== "private"));
+            if (bad.length === 0)
+                return [];
+            const where = [...new Set(bad.map(([w]) => w))];
+            return [
+                {
+                    checkId: "PROTOCOL_MODERN_CACHE_FIELDS",
+                    severity: "warn",
+                    subject: where.join(", "),
+                    message: `${MODERN} requires ttlMs (≥ 0) and cacheScope ("public" or "private") on ${where.join(", ")}, but they're missing or invalid (e.g. ttlMs=${JSON.stringify(bad[0][1].ttlMs ?? null)}, cacheScope=${JSON.stringify(bad[0][1].cacheScope ?? null)}). Clients can't tell how long to cache the list, or whether it's per-user.`,
+                    source: `${SPEC_MODERN}/changelog`,
+                    fix: 'Return e.g. ttlMs: 60000, cacheScope: "private" (use "private" when the list depends on who is authorized).',
+                },
+            ];
+        },
+    }),
+    defineCheck({
+        id: "PROTOCOL_MODERN_SERVERINFO",
+        area: "protocol",
+        description: `${MODERN} results identify the server in _meta`,
+        appliesTo: modernSupported,
+        run: (s) => {
+            const missing = modernResults(s).filter(([, m]) => !m.serverInfo);
+            if (missing.length === 0)
+                return [];
+            return [
+                {
+                    checkId: "PROTOCOL_MODERN_SERVERINFO",
+                    severity: "info",
+                    message: `Without initialize, results SHOULD carry _meta["io.modelcontextprotocol/serverInfo"]; ${missing.length} result(s) don't, so clients can't show which server answered.`,
+                    source: `${SPEC_MODERN}/basic/index`,
+                },
+            ];
+        },
+    }),
+    defineCheck({
+        id: "PROTOCOL_MODERN_VERSION_ERROR",
+        area: "protocol",
+        description: `${MODERN} servers reject unsupported versions with UnsupportedProtocolVersion (-32022)`,
+        appliesTo: (s) => modernSupported(s) && !!s.modern?.unsupportedVersion,
+        run: (s) => {
+            const r = s.modern.unsupportedVersion;
+            const data = r.data;
+            if (!r.answered && r.code === -32022 && Array.isArray(data?.supported))
+                return [];
+            return [
+                {
+                    checkId: "PROTOCOL_MODERN_VERSION_ERROR",
+                    severity: "warn",
+                    message: r.answered
+                        ? "A request with an unsupported protocol version (1999-01-01) was answered normally. Clients rely on the -32022 error to retry with a version both sides support."
+                        : r.code !== -32022
+                            ? `An unsupported protocol version got error ${r.code ?? "(none)"} ("${r.message}") instead of -32022, so clients won't know to retry with another version.`
+                            : "The -32022 error has no data.supported list, so clients can't pick a version to retry with.",
+                    evidence: { answered: r.answered, code: r.code, data: r.data },
+                    source: `${SPEC_MODERN}/basic/versioning`,
+                    fix: 'Answer unknown versions with { code: -32022, data: { supported: ["2026-07-28", ...], requested } }.',
+                },
+            ];
+        },
+    }),
+    defineCheck({
+        id: "PROTOCOL_MODERN_SURFACE_DIFFERS",
+        area: "protocol",
+        description: `Tools are the same over the initialize handshake and ${MODERN}`,
+        appliesTo: (s) => s.era === "both" && !!s.modern?.lists?.tools?.ok && !!s.lists.tools?.ok,
+        run: (s) => {
+            const names = (items) => new Set(items.flatMap((t) => (typeof t.name === "string" ? [t.name] : [])));
+            const legacy = names(s.lists.tools.items);
+            const modern = names(s.modern.lists.tools.items);
+            const onlyLegacy = [...legacy].filter((n) => !modern.has(n));
+            const onlyModern = [...modern].filter((n) => !legacy.has(n));
+            if (!onlyLegacy.length && !onlyModern.length)
+                return [];
+            return [
+                {
+                    checkId: "PROTOCOL_MODERN_SURFACE_DIFFERS",
+                    severity: "info",
+                    message: `Tool lists differ by protocol: only over initialize: ${onlyLegacy.join(", ") || "none"}; only over ${MODERN}: ${onlyModern.join(", ") || "none"}. Clients see different tools depending on which protocol they speak.`,
+                    evidence: { onlyLegacy, onlyModern },
+                    fix: "Expose the same tools on both, unless the difference is intentional.",
+                },
+            ];
+        },
+    }),
+    defineCheck({
+        id: "PROTOCOL_VERSION_UNSUPPORTED",
+        area: "protocol",
+        description: "Negotiated protocol version is one the SDK supports",
+        appliesTo: legacyConnected,
+        run: (s) => {
+            const v = s.initialize?.negotiatedProtocolVersion;
+            if (v && SUPPORTED_PROTOCOL_VERSIONS.includes(v))
+                return [];
+            return [
+                {
+                    checkId: "PROTOCOL_VERSION_UNSUPPORTED",
+                    severity: "error",
+                    message: v
+                        ? `Server answered with protocol version "${v}", which SDK-based clients reject.`
+                        : "initialize result has no protocolVersion.",
+                    evidence: { negotiated: v ?? null, supported: SUPPORTED_PROTOCOL_VERSIONS },
+                    fix: `Return the client's requested version (${LATEST_PROTOCOL_VERSION}) if you support it, otherwise the latest version you do support.`,
+                },
+            ];
+        },
+    }),
+    defineCheck({
+        id: "PROTOCOL_VERSION_OLD",
+        area: "protocol",
+        description: "Server speaks the latest protocol version",
+        appliesTo: (s) => legacyConnected(s) && SUPPORTED_PROTOCOL_VERSIONS.includes(s.initialize?.negotiatedProtocolVersion ?? ""),
+        run: (s) => {
+            const v = s.initialize.negotiatedProtocolVersion;
+            if (v === LATEST_PROTOCOL_VERSION)
+                return [];
+            return [
+                {
+                    checkId: "PROTOCOL_VERSION_OLD",
+                    severity: v.startsWith("2024-") ? "warn" : "info",
+                    message: `Server negotiated ${v}; latest is ${LATEST_PROTOCOL_VERSION}. Features added in later spec revisions are unavailable to clients.`,
+                    evidence: { negotiated: v, latest: LATEST_PROTOCOL_VERSION },
+                    fix: upgradeHint(s),
+                },
+            ];
+        },
+    }),
+    defineCheck({
+        id: "PROTOCOL_VERSIONS_REJECTED",
+        area: "protocol",
+        description: "Server handles every published protocol version clients may request (--version-matrix)",
+        appliesTo: (s) => connected(s) && !!s.versionMatrix?.length,
+        run: (s) => s.versionMatrix.flatMap((probe) => {
+            if (!probe.ok) {
+                return [
+                    {
+                        checkId: "PROTOCOL_VERSIONS_REJECTED",
+                        severity: "warn",
+                        subject: probe.requested,
+                        message: `initialize with protocolVersion ${probe.requested} failed (${probe.error}). The spec says to answer with a version the server supports, so clients can decide; failing instead cuts off clients that start at ${probe.requested}.`,
+                        fix: "On an unsupported version, respond with your latest supported version instead of an error.",
+                    },
+                ];
+            }
+            if (probe.negotiated && !SUPPORTED_PROTOCOL_VERSIONS.includes(probe.negotiated)) {
+                return [
+                    {
+                        checkId: "PROTOCOL_VERSIONS_REJECTED",
+                        severity: "error",
+                        subject: probe.requested,
+                        message: `Asked for ${probe.requested}, server answered with unknown version "${probe.negotiated}".`,
+                        fix: "Answer with a published protocol version.",
+                    },
+                ];
+            }
+            // Answering with an older version is correct negotiation; answering with a newer one
+            // (versions are dates, so they compare as strings) leaves an older client unable to talk.
+            if (probe.negotiated && probe.negotiated > probe.requested) {
+                return [
+                    {
+                        checkId: "PROTOCOL_VERSIONS_REJECTED",
+                        severity: "info",
+                        subject: probe.requested,
+                        message: `Asked for ${probe.requested}, server answered the newer ${probe.negotiated}; clients that only speak ${probe.requested} will disconnect.`,
+                        fix: `Support ${probe.requested} too if you need older clients (most SDKs do by default).`,
+                    },
+                ];
+            }
+            return [];
+        }),
+    }),
+    defineCheck({
+        id: "PROTOCOL_VERSION_SURFACE_DIFFERS",
+        area: "protocol",
+        description: "The tool list is the same whichever protocol version a client negotiates",
+        appliesTo: (s) => connected(s) && (s.versionMatrix?.filter((p) => p.tools).length ?? 0) > 1,
+        run: (s) => {
+            const probes = s.versionMatrix.filter((p) => p.tools);
+            const all = new Set(probes.flatMap((p) => p.tools));
+            return probes.flatMap((p) => {
+                const missing = [...all].filter((t) => !p.tools.includes(t));
+                if (missing.length === 0)
+                    return [];
+                return [
+                    {
+                        checkId: "PROTOCOL_VERSION_SURFACE_DIFFERS",
+                        severity: "info",
+                        subject: p.requested,
+                        message: `Clients negotiating ${p.negotiated ?? p.requested} don't get ${missing.length} tool(s) other versions get: ${missing.slice(0, 8).join(", ")}${missing.length > 8 ? ", …" : ""}.`,
+                        evidence: { missing },
+                        fix: "If intentional (features that need newer protocol), document it; otherwise expose the same tools on every version.",
+                    },
+                ];
+            });
+        },
+    }),
+    defineCheck({
+        id: "PROTOCOL_SERVERINFO_MISSING",
+        area: "protocol",
+        description: "initialize returns serverInfo with name and version",
+        appliesTo: legacyConnected,
+        run: (s) => {
+            const info = s.initialize?.serverInfo;
+            const missing = ["name", "version"].filter((k) => !str(info?.[k]));
+            if (missing.length === 0)
+                return [];
+            return [
+                {
+                    checkId: "PROTOCOL_SERVERINFO_MISSING",
+                    severity: "warn",
+                    message: `serverInfo is missing ${missing.join(" and ")}.`,
+                    fix: "Pass name and version when constructing the server.",
+                },
+            ];
+        },
+    }),
+    defineCheck({
+        id: "PROTOCOL_CAPABILITY_UNDECLARED",
+        area: "protocol",
+        description: "Every feature the server serves is declared in capabilities",
+        appliesTo: connected,
+        run: (s) => KINDS.flatMap((kind) => {
+            const list = s.lists[kind];
+            const cap = LIST_KINDS[kind].capability;
+            if (!list?.ok || list.items.length === 0 || declared(s, cap))
+                return [];
+            return [
+                {
+                    checkId: "PROTOCOL_CAPABILITY_UNDECLARED",
+                    severity: "error",
+                    subject: kind,
+                    message: `Server answers ${LIST_KINDS[kind].method} with ${list.items.length} item(s) but doesn't declare the "${cap}" capability, so spec-following clients never ask for them.`,
+                    fix: `Declare "${cap}": {} in the server capabilities.`,
+                },
+            ];
+        }),
+    }),
+    defineCheck({
+        id: "PROTOCOL_CAPABILITY_BROKEN",
+        area: "protocol",
+        description: "Every declared capability's list method works",
+        appliesTo: connected,
+        run: (s) => KINDS.flatMap((kind) => {
+            const list = s.lists[kind];
+            const cap = LIST_KINDS[kind].capability;
+            if (!list || list.ok || !declared(s, cap))
+                return [];
+            // resources/templates/list is optional-ish in practice; many servers skip it.
+            const severity = kind === "resourceTemplates" ? "warn" : "error";
+            return [
+                {
+                    checkId: "PROTOCOL_CAPABILITY_BROKEN",
+                    severity,
+                    subject: kind,
+                    message: `"${cap}" is declared but ${LIST_KINDS[kind].method} failed: ${list.error?.message ?? "unknown error"}`,
+                    evidence: { error: list.error },
+                    fix: kind === "resourceTemplates"
+                        ? "Implement resources/templates/list (an empty list is fine)."
+                        : `Implement ${LIST_KINDS[kind].method} or stop declaring "${cap}".`,
+                },
+            ];
+        }),
+    }),
+    defineCheck({
+        id: "PROTOCOL_PAGINATION_BROKEN",
+        area: "protocol",
+        description: "List pagination terminates",
+        appliesTo: connected,
+        run: (s) => KINDS.filter((kind) => s.lists[kind]?.cursorLoop).map((kind) => ({
+            checkId: "PROTOCOL_PAGINATION_BROKEN",
+            severity: "error",
+            subject: kind,
+            message: `${LIST_KINDS[kind].method} returned a nextCursor it had already returned; clients loop forever or stop early.`,
+            fix: "Return a new cursor per page and omit nextCursor on the last page.",
+        })),
+    }),
+];
+//# sourceMappingURL=protocol.js.map

package/dist/checks/protocol.js.map

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

package/dist/checks/resources.d.ts

@@ -0,0 +1,10 @@
+/**
+ * RFC 6570 syntax check. Returns undefined when valid, otherwise the problem.
+ * `fatal` marks errors the TypeScript SDK's own parser throws on.
+ */
+export declare function uriTemplateProblem(template: string): {
+    problem: string;
+    fatal: boolean;
+} | undefined;
+export declare const resourceChecks: import("./types.js").Check[];
+//# sourceMappingURL=resources.d.ts.map

package/dist/checks/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/checks/resources.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAoBpG;AAED,eAAO,MAAM,cAAc,8BAqG1B,CAAC"}

package/dist/checks/resources.js

@@ -0,0 +1,144 @@
+import { connected, itemLabel, items, str } from "./util.js";
+import { defineCheck } from "./types.js";
+const hasResources = (s) => connected(s) && items(s, "resources").length > 0;
+const hasTemplates = (s) => connected(s) && items(s, "resourceTemplates").length > 0;
+function parsesAsUri(value) {
+    try {
+        new URL(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+const VARSPEC = /^(?:[A-Za-z0-9_]|%[0-9A-Fa-f]{2})(?:\.?(?:[A-Za-z0-9_]|%[0-9A-Fa-f]{2}))*(?::[1-9][0-9]{0,3}|\*)?$/;
+/**
+ * RFC 6570 syntax check. Returns undefined when valid, otherwise the problem.
+ * `fatal` marks errors the TypeScript SDK's own parser throws on.
+ */
+export function uriTemplateProblem(template) {
+    let depth = 0;
+    for (const ch of template) {
+        if (ch === "{")
+            depth++;
+        if (ch === "}")
+            depth--;
+        if (depth > 1)
+            return { problem: "nested '{'", fatal: false };
+        if (depth < 0)
+            return { problem: "unmatched '}'", fatal: false };
+    }
+    if (depth !== 0)
+        return { problem: "unclosed '{' expression", fatal: true };
+    for (const [, body] of template.matchAll(/\{([^}]*)\}/g)) {
+        const op = /^[+#./;?&]/.test(body) ? body[0] : "";
+        const vars = body.slice(op.length);
+        if (/^[=,!@|]/.test(vars))
+            return { problem: `reserved operator in {${body}}`, fatal: false };
+        if (vars === "")
+            return { problem: "empty expression {}", fatal: false };
+        for (const v of vars.split(",")) {
+            if (!VARSPEC.test(v))
+                return { problem: `invalid variable ${JSON.stringify(v)} in {${body}}`, fatal: false };
+        }
+    }
+    return undefined;
+}
+export const resourceChecks = [
+    defineCheck({
+        id: "RESOURCE_URI_INVALID",
+        area: "resources",
+        description: "Resource URIs are absolute and parse",
+        appliesTo: hasResources,
+        run: (s) => items(s, "resources")
+            .filter((r) => typeof r.uri !== "string" || !parsesAsUri(r.uri))
+            .map((r) => ({
+            checkId: "RESOURCE_URI_INVALID",
+            severity: "error",
+            subject: itemLabel(r),
+            message: typeof r.uri !== "string"
+                ? "Resource has no string uri."
+                : `${JSON.stringify(r.uri)} is not an absolute URI; clients can't read it back.`,
+            fix: "Use a scheme, e.g. file:///path or myapp://items/1.",
+        })),
+    }),
+    defineCheck({
+        id: "RESOURCE_URI_DUPLICATE",
+        area: "resources",
+        description: "Resource URIs are unique",
+        appliesTo: hasResources,
+        run: (s) => {
+            const counts = new Map();
+            for (const r of items(s, "resources")) {
+                if (typeof r.uri === "string")
+                    counts.set(r.uri, (counts.get(r.uri) ?? 0) + 1);
+            }
+            return [...counts]
+                .filter(([, n]) => n > 1)
+                .map(([uri, n]) => ({
+                checkId: "RESOURCE_URI_DUPLICATE",
+                severity: "error",
+                subject: uri,
+                message: `${n} resources share the URI ${uri}.`,
+                fix: "Give every resource a unique URI.",
+            }));
+        },
+    }),
+    defineCheck({
+        id: "RESOURCE_NAME_MISSING",
+        area: "resources",
+        description: "Resources and templates have a name (required by the spec)",
+        appliesTo: (s) => hasResources(s) || hasTemplates(s),
+        run: (s) => [...items(s, "resources"), ...items(s, "resourceTemplates")]
+            .filter((r) => !str(r.name))
+            .map((r) => ({
+            checkId: "RESOURCE_NAME_MISSING",
+            severity: "error",
+            subject: itemLabel(r),
+            message: "Resource has no name; the spec requires one and the TypeScript SDK rejects the list.",
+            fix: "Add a short name to every resource and template.",
+        })),
+    }),
+    defineCheck({
+        id: "RESOURCE_MIME_MISSING",
+        area: "resources",
+        description: "Resources declare a mimeType",
+        appliesTo: hasResources,
+        run: (s) => {
+            const missing = items(s, "resources").filter((r) => !str(r.mimeType));
+            if (missing.length === 0)
+                return [];
+            return [
+                {
+                    checkId: "RESOURCE_MIME_MISSING",
+                    severity: "info",
+                    message: `${missing.length} resource(s) have no mimeType, so clients must guess how to display them.`,
+                    evidence: { resources: missing.slice(0, 10).map((r) => itemLabel(r)) },
+                    fix: "Set mimeType (e.g. text/markdown, application/json).",
+                },
+            ];
+        },
+    }),
+    defineCheck({
+        id: "RESOURCE_TEMPLATE_INVALID",
+        area: "resources",
+        description: "Resource templates are valid RFC 6570 URI templates",
+        appliesTo: hasTemplates,
+        run: (s) => items(s, "resourceTemplates").flatMap((t) => {
+            const template = str(t.uriTemplate);
+            const problem = template === undefined ? { problem: "missing uriTemplate", fatal: true } : uriTemplateProblem(template);
+            if (!problem)
+                return [];
+            return [
+                {
+                    checkId: "RESOURCE_TEMPLATE_INVALID",
+                    severity: problem.fatal ? "error" : "warn",
+                    subject: itemLabel(t),
+                    message: `uriTemplate ${JSON.stringify(template ?? null)}: ${problem.problem}.`,
+                    fix: "Use RFC 6570 syntax, e.g. users://{id}/profile.",
+                },
+            ];
+        }),
+    }),
+];
+//# sourceMappingURL=resources.js.map

package/dist/checks/resources.js.map

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

package/dist/checks/schema.d.ts

@@ -0,0 +1,21 @@
+/** Meta-validates against the draft named in $schema (2020-12 by default, per the MCP spec). */
+export declare function metaValidate(schema: Record<string, unknown>): string[] | undefined;
+interface SchemaStats {
+    keywords: Set<string>;
+    depth: number;
+    untypedProperties: string[];
+    /** Paths of subschemas whose type is an array. */
+    typeArrays: string[];
+}
+/** Walks subschemas and collects keywords, nesting depth, and properties without a type. */
+export declare function analyze(schema: unknown): SchemaStats;
+/**
+ * Mirrors Cline's normalizeToolInputSchema (sdk/packages/shared/src/tools/create.ts @ 252082b):
+ * schemas with a string `type`, or with properties/required/additionalProperties, pass.
+ * Otherwise the first non-empty root oneOf/anyOf/allOf decides: oneOf/anyOf need every
+ * branch to be `type: "object"`, allOf needs at least one such branch.
+ */
+export declare function rootCombinatorBreaks(schema: Record<string, unknown>): boolean;
+export declare const schemaChecks: import("./types.js").Check[];
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/checks/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/checks/schema.ts"],"names":[],"mappings":"AAsBA,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,SAAS,CAOlF;AAED,UAAU,WAAW;IACnB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,kDAAkD;IAClD,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,4FAA4F;AAC5F,wBAAgB,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,CA0BpD;AAgBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAU7E;AAMD,eAAO,MAAM,YAAY,8BAwUxB,CAAC"}