mcp-use-compat 0.3.0

package/dist/checks/tools.js

@@ -0,0 +1,422 @@
+import { connected, declared, isObject, items, str, withNote } from "./util.js";
+import { defineCheck } from "./types.js";
+/** Tool name format from the MCP spec (SEP-986), as enforced by the SDK. */
+export const SPEC_TOOL_NAME = /^[A-Za-z0-9._-]{1,128}$/;
+const SHORT_DESCRIPTION = 20;
+const hasTools = (s) => connected(s) && items(s, "tools").length > 0;
+const toolName = (t) => str(t.name) ?? "(unnamed)";
+const toolNames = (s) => items(s, "tools").flatMap((t) => (typeof t.name === "string" ? [t.name] : []));
+const serverName = (s) => str(s.initialize?.serverInfo?.name) ?? "server";
+const READ_VERBS = new Set("get list search find read fetch query describe show lookup count check view browse retrieve inspect preview download export".split(" "));
+const WRITE_VERBS = new Set("create add update edit delete remove place cancel modify send post write set move rename execute run deploy transfer buy sell pay charge drop insert upsert archive publish submit approve reject revoke grant invite kill stop start restart reset clear purge destroy close open merge push".split(" "));
+/** The first word of a tool name, lowercased: get_user → get, createEvent → create, files.read → files. */
+export function leadingVerb(name) {
+    return name.replace(/([a-z0-9])([A-Z])/g, "$1_$2").split(/[_\-.\s]+/)[0]?.toLowerCase() ?? "";
+}
+/** "read" / "write" from the tool name's leading verb, or undefined if it doesn't say. */
+export function nameIntent(name) {
+    const verb = leadingVerb(name);
+    return READ_VERBS.has(verb) ? "read" : WRITE_VERBS.has(verb) ? "write" : undefined;
+}
+const annotations = (t) => (isObject(t.annotations) ? t.annotations : {});
+/** Replaces characters outside the allowed class with "_". */
+export function sanitize(name, allowed) {
+    return name.replace(new RegExp(`[^${allowed}]`, "g"), "_");
+}
+/** The prefix a client puts in front of this server's tool names ("" if none/unknown). */
+export function clientPrefix(s, p) {
+    const rule = p.limits.toolNamePrefix?.value;
+    if (!rule)
+        return "";
+    let server = serverName(s);
+    if (rule.lowercase)
+        server = server.toLowerCase();
+    const allowed = p.limits.toolNameChars?.value;
+    if (allowed?.onInvalid === "replace")
+        server = sanitize(server, allowed.allowed);
+    const prefix = rule.format.replace("{server}", server);
+    return rule.maxLength ? prefix.slice(0, rule.maxLength) : prefix;
+}
+/** The name the client ends up using, applying only documented replace/truncate behaviour. */
+export function clientToolName(s, p, name) {
+    const chars = p.limits.toolNameChars?.value;
+    let result = clientPrefix(s, p) + (chars?.onInvalid === "replace" ? sanitize(name, chars.allowed) : name);
+    const length = p.limits.maxToolNameLength?.value;
+    if (length && result.length > length.max) {
+        if (length.onExceed === "truncate")
+            result = result.slice(0, length.max);
+        if (length.onExceed === "truncateMiddle")
+            result = truncateMiddle(result, length.max);
+    }
+    return result;
+}
+/** Start and end joined by "..." (Gemini CLI's scheme: 30 + "..." + 30 for a 63 limit). */
+export function truncateMiddle(name, max) {
+    if (name.length <= max)
+        return name;
+    const keep = Math.floor((max - 3) / 2);
+    return `${name.slice(0, keep)}...${name.slice(name.length - keep)}`;
+}
+export const toolChecks = [
+    defineCheck({
+        id: "TOOL_NONE",
+        area: "tools",
+        description: "A server declaring tools exposes at least one",
+        appliesTo: (s) => connected(s) && declared(s, "tools") && !!s.lists.tools?.ok,
+        run: (s) => items(s, "tools").length > 0
+            ? []
+            : [
+                {
+                    checkId: "TOOL_NONE",
+                    severity: "warn",
+                    message: 'Server declares the "tools" capability but tools/list is empty.',
+                    fix: "Register tools before connecting the transport, or drop the capability.",
+                },
+            ],
+    }),
+    defineCheck({
+        id: "TOOL_NAME_INVALID",
+        area: "tools",
+        description: "Tool names match the MCP spec format (A-Z a-z 0-9 _ - ., 1-128 chars)",
+        appliesTo: hasTools,
+        run: (s) => items(s, "tools")
+            .filter((t) => typeof t.name !== "string" || !SPEC_TOOL_NAME.test(t.name))
+            .map((t) => ({
+            checkId: "TOOL_NAME_INVALID",
+            severity: "error",
+            subject: toolName(t),
+            message: typeof t.name !== "string"
+                ? "Tool has no string name."
+                : `Tool name ${JSON.stringify(t.name)} is not a valid MCP tool name.`,
+            fix: "Use only letters, digits, underscore, dash and dot (max 128 characters).",
+        })),
+    }),
+    defineCheck({
+        id: "TOOL_NAME_DUPLICATE",
+        area: "tools",
+        description: "Tool names are unique",
+        appliesTo: hasTools,
+        run: (s) => {
+            const counts = new Map();
+            for (const t of items(s, "tools")) {
+                if (typeof t.name === "string")
+                    counts.set(t.name, (counts.get(t.name) ?? 0) + 1);
+            }
+            return [...counts]
+                .filter(([, n]) => n > 1)
+                .map(([name, n]) => ({
+                checkId: "TOOL_NAME_DUPLICATE",
+                severity: "error",
+                subject: name,
+                message: `${n} tools are named ${JSON.stringify(name)}; clients keep only one or reject the list.`,
+                fix: "Give every tool a unique name.",
+            }));
+        },
+    }),
+    defineCheck({
+        id: "TOOL_NAME_CLIENT_CHARS",
+        area: "tools",
+        description: "Tool names use only characters each client accepts as-is",
+        appliesTo: hasTools,
+        run: (s, { profiles }) => profiles.flatMap((p) => {
+            const rule = p.limits.toolNameChars;
+            if (!rule)
+                return [];
+            return toolNames(s)
+                .filter((name) => sanitize(name, rule.value.allowed) !== name)
+                .map((name) => {
+                const { onInvalid } = rule.value;
+                const renamed = sanitize(name, rule.value.allowed);
+                return {
+                    checkId: "TOOL_NAME_CLIENT_CHARS",
+                    severity: onInvalid === "reject" ? "error" : "warn",
+                    subject: name,
+                    client: p.id,
+                    source: rule.source,
+                    message: onInvalid === "reject"
+                        ? `${p.displayName} rejects tool names with characters outside [${rule.value.allowed}].`
+                        : onInvalid === "replace"
+                            ? `${p.displayName} renames it to "${renamed}" (only [${rule.value.allowed}] allowed).`
+                            : onInvalid === "replaceUnique"
+                                ? `${p.displayName} renames it to "${renamed}" (only [${rule.value.allowed}] allowed; clashing names get a hash suffix).`
+                                : onInvalid === "truncateWithHash"
+                                    ? `${p.displayName} renames it to "${renamed}" plus a hash suffix (only [${rule.value.allowed}] allowed), so the model sees a mangled name.`
+                                    : withNote(`${p.displayName} only accepts [${rule.value.allowed}].`, rule.note),
+                    fix: "Use only letters, digits, underscores and dashes in tool names.",
+                };
+            });
+        }),
+    }),
+    defineCheck({
+        id: "TOOL_NAME_TOO_LONG",
+        area: "tools",
+        description: "Prefixed tool names fit each client's length limit",
+        appliesTo: hasTools,
+        run: (s, { profiles }) => profiles.flatMap((p) => {
+            const limit = p.limits.maxToolNameLength;
+            if (!limit)
+                return [];
+            const prefix = clientPrefix(s, p);
+            const { max, onExceed } = limit.value;
+            return toolNames(s)
+                .filter((name) => prefix.length + name.length > max)
+                .map((name) => {
+                const full = prefix + name;
+                const what = onExceed === "reject"
+                    ? "rejects it"
+                    : onExceed === "truncate"
+                        ? `truncates it to "${full.slice(0, max)}"`
+                        : onExceed === "truncateWithHash"
+                            ? "truncates it and appends a hash, so the model sees a mangled name"
+                            : onExceed === "truncateMiddle"
+                                ? `shortens it to "${truncateMiddle(full, max)}"`
+                                : "may reject or rewrite it";
+                return {
+                    checkId: "TOOL_NAME_TOO_LONG",
+                    severity: onExceed === "reject" ? "error" : "warn",
+                    subject: name,
+                    client: p.id,
+                    source: limit.source,
+                    message: prefix
+                        ? `With ${p.displayName}'s server prefix ("${prefix}", assuming the server is registered as "${serverName(s)}") the name is ${full.length} characters; the limit is ${max} and ${p.displayName} ${what}.`
+                        : `The name is ${full.length} characters; ${p.displayName} allows ${max} and ${what}.`,
+                    fix: "Shorten the tool name, and suggest a short server name in your install instructions.",
+                };
+            });
+        }),
+    }),
+    defineCheck({
+        id: "TOOL_NAME_CLIENT_COLLISION",
+        area: "tools",
+        description: "Tool names stay unique after a client renames or truncates them",
+        appliesTo: hasTools,
+        run: (s, { profiles }) => profiles.flatMap((p) => {
+            const byClientName = new Map();
+            for (const name of new Set(toolNames(s))) {
+                const sent = clientToolName(s, p, name);
+                byClientName.set(sent, [...(byClientName.get(sent) ?? []), name]);
+            }
+            const chars = p.limits.toolNameChars;
+            return [...byClientName]
+                .filter(([, names]) => names.length > 1)
+                .map(([sent, names]) => {
+                // Blame character replacement when it alone makes the names equal.
+                const renamed = chars?.value.onInvalid === "replace" ? names.map((n) => sanitize(n, chars.value.allowed)) : names;
+                const byReplacement = new Set(renamed).size === 1;
+                const quoted = names.map((n) => `"${n}"`);
+                const list = quoted.length === 2 ? quoted.join(" and ") : quoted.join(", ");
+                return {
+                    checkId: "TOOL_NAME_CLIENT_COLLISION",
+                    severity: "error",
+                    subject: names.join(", "),
+                    client: p.id,
+                    source: (byReplacement ? chars : p.limits.maxToolNameLength)?.source,
+                    message: byReplacement
+                        ? `${list} ${names.length === 2 ? "both" : "all"} become "${renamed[0]}" in ${p.displayName}, so only one of them is usable.`
+                        : `${list} are truncated to the same name "${sent}" in ${p.displayName}, so only one of them is usable.`,
+                    fix: byReplacement
+                        ? "Use only letters, digits, _ and - in tool names."
+                        : "Make tool names differ within their first characters.",
+                };
+            });
+        }),
+    }),
+    defineCheck({
+        id: "TOOL_COUNT_OVER_LIMIT",
+        area: "tools",
+        description: "Tool count fits each client's limit",
+        appliesTo: hasTools,
+        run: (s, { profiles }) => {
+            const count = items(s, "tools").length;
+            return profiles.flatMap((p) => {
+                const limit = p.limits.maxTools;
+                if (!limit || count <= limit.value)
+                    return [];
+                return [
+                    {
+                        checkId: "TOOL_COUNT_OVER_LIMIT",
+                        severity: "warn",
+                        client: p.id,
+                        source: limit.source,
+                        message: withNote(`Server exposes ${count} tools; ${p.displayName} uses at most ${limit.value}.`, limit.note),
+                        fix: "Consolidate tools, or split the server so users can enable only what they need.",
+                    },
+                ];
+            });
+        },
+    }),
+    defineCheck({
+        id: "TOOL_DESCRIPTION_MISSING",
+        area: "tools",
+        description: "Every tool has a non-empty description",
+        appliesTo: hasTools,
+        run: (s) => items(s, "tools")
+            .filter((t) => typeof t.description !== "string" || t.description.trim() === "")
+            .map((t) => ({
+            checkId: "TOOL_DESCRIPTION_MISSING",
+            severity: "error",
+            subject: toolName(t),
+            message: t.description === null
+                ? "description is null. The spec allows omitting it, not null; the TypeScript SDK's result schema rejects the whole tools/list response, so SDK-based clients see no tools at all."
+                : "Tool has no description, so the model has to guess when to use it.",
+            evidence: { description: t.description ?? "(absent)" },
+            fix: "Describe what the tool does and when to use it.",
+        })),
+    }),
+    defineCheck({
+        id: "TOOL_DESCRIPTION_SHORT",
+        area: "tools",
+        description: `Tool descriptions are at least ${SHORT_DESCRIPTION} characters`,
+        appliesTo: hasTools,
+        run: (s) => items(s, "tools")
+            .filter((t) => typeof t.description === "string" && t.description.trim() !== "")
+            .filter((t) => t.description.trim().length < SHORT_DESCRIPTION)
+            .map((t) => ({
+            checkId: "TOOL_DESCRIPTION_SHORT",
+            severity: "info",
+            subject: toolName(t),
+            message: `Description ${JSON.stringify(t.description)} is very short; models pick tools from descriptions.`,
+            fix: "Say what the tool does, what it returns, and when to prefer it over similar tools.",
+        })),
+    }),
+    defineCheck({
+        id: "TOOL_DESCRIPTION_TRUNCATED",
+        area: "tools",
+        description: "Tool descriptions and server instructions fit each client's length limit",
+        appliesTo: connected,
+        run: (s, { profiles }) => profiles.flatMap((p) => {
+            const limit = p.limits.maxDescriptionLength;
+            if (!limit)
+                return [];
+            const texts = items(s, "tools")
+                .filter((t) => typeof t.description === "string")
+                .map((t) => [toolName(t), t.description]);
+            if (s.initialize?.instructions)
+                texts.push(["(server instructions)", s.initialize.instructions]);
+            return texts
+                .filter(([, text]) => text.length > limit.value)
+                .map(([subject, text]) => ({
+                checkId: "TOOL_DESCRIPTION_TRUNCATED",
+                severity: "warn",
+                subject,
+                client: p.id,
+                source: limit.source,
+                message: `${text.length} characters; ${p.displayName} truncates after ${limit.value}, so the end is never seen by the model.`,
+                fix: "Put the most important guidance first and move reference material into a resource or the tool result.",
+            }));
+        }),
+    }),
+    defineCheck({
+        id: "TOOL_STRUCTURED_OUTPUT_HANDLING",
+        area: "tools",
+        description: "Notes how each client passes structured tool output to the model",
+        appliesTo: (s) => connected(s) && items(s, "tools").some((t) => isObject(t.outputSchema)),
+        run: (s, { profiles }) => {
+            const tools = items(s, "tools").filter((t) => isObject(t.outputSchema)).map(toolName);
+            return profiles.flatMap((p) => {
+                const rule = p.limits.structuredContent;
+                if (!rule || rule.value === "alongsideText")
+                    return [];
+                return [
+                    {
+                        checkId: "TOOL_STRUCTURED_OUTPUT_HANDLING",
+                        severity: "info",
+                        subject: tools.join(", "),
+                        client: p.id,
+                        source: rule.source,
+                        message: rule.value === "replacesText"
+                            ? `${p.displayName} sends the model JSON of structuredContent instead of the text content, so anything only in the text is lost.`
+                            : rule.value === "textOnly"
+                                ? `${p.displayName} only ever sends the model the text content; structuredContent never reaches it.`
+                                : `${p.displayName} sends the model only the text content (structuredContent is used only when content is empty).`,
+                        fix: rule.value === "replacesText"
+                            ? "Put everything the model needs into structuredContent."
+                            : "Keep the text content complete; don't rely on structuredContent alone.",
+                    },
+                ];
+            });
+        },
+    }),
+    defineCheck({
+        id: "TOOL_ANNOTATIONS_CONFLICT",
+        area: "tools",
+        description: "Tool annotations are consistent with each other and with the tool's name",
+        appliesTo: hasTools,
+        run: (s) => items(s, "tools").flatMap((t) => {
+            const a = annotations(t);
+            if (a.readOnlyHint !== true)
+                return [];
+            if (a.destructiveHint === true || a.idempotentHint === false) {
+                return [
+                    {
+                        checkId: "TOOL_ANNOTATIONS_CONFLICT",
+                        severity: "warn",
+                        subject: toolName(t),
+                        message: "readOnlyHint is true but destructiveHint/idempotentHint describe a writing tool; clients may skip confirmation prompts.",
+                        evidence: { annotations: t.annotations },
+                        fix: "Set readOnlyHint: false for tools that modify anything.",
+                    },
+                ];
+            }
+            if (typeof t.name === "string" && nameIntent(t.name) === "write") {
+                return [
+                    {
+                        checkId: "TOOL_ANNOTATIONS_CONFLICT",
+                        severity: "warn",
+                        subject: t.name,
+                        message: `"${t.name}" sounds like it changes something ("${leadingVerb(t.name)}") but declares readOnlyHint: true, so clients may run it without asking.`,
+                        evidence: { annotations: t.annotations },
+                        fix: "If the tool modifies state, set readOnlyHint: false (and destructiveHint as appropriate).",
+                    },
+                ];
+            }
+            return [];
+        }),
+    }),
+    defineCheck({
+        id: "TOOL_TITLE_MISSING",
+        area: "tools",
+        description: "Tools have a human-readable title",
+        appliesTo: hasTools,
+        run: (s) => {
+            const untitled = items(s, "tools").filter((t) => !str(t.title) && !str(annotations(t).title));
+            if (untitled.length === 0)
+                return [];
+            return [
+                {
+                    checkId: "TOOL_TITLE_MISSING",
+                    severity: "info",
+                    subject: untitled.map(toolName).slice(0, 10).join(", ") + (untitled.length > 10 ? ", …" : ""),
+                    message: `${untitled.length} tool(s) have no title, so clients such as VS Code show the raw name; Anthropic's connector directory requires a title on every tool.`,
+                    evidence: { tools: untitled.map(toolName) },
+                    fix: 'Add title: "Get weather" (or annotations.title) to each tool.',
+                },
+            ];
+        },
+    }),
+    defineCheck({
+        id: "TOOL_ANNOTATIONS_MISSING",
+        area: "tools",
+        description: "Read-only tools declare readOnlyHint",
+        appliesTo: hasTools,
+        run: (s, { profiles }) => {
+            const tools = items(s, "tools");
+            const skipping = profiles.filter((p) => p.limits.readOnlySkipsApproval?.value === true).map((p) => p.displayName);
+            const reads = tools.filter((t) => typeof t.name === "string" && nameIntent(t.name) === "read" && annotations(t).readOnlyHint === undefined);
+            if (reads.length === 0)
+                return [];
+            const none = tools.every((t) => !isObject(t.annotations));
+            return [
+                {
+                    checkId: "TOOL_ANNOTATIONS_MISSING",
+                    severity: "info",
+                    subject: reads.map(toolName).join(", "),
+                    message: `${reads.length} tool(s) look read-only but don't declare readOnlyHint${none ? " (the server sets no annotations at all)" : ""}. Without it the spec tells clients to assume they may be destructive${skipping.length ? `; ${skipping.join(", ")} ask for confirmation on every call to them` : ", so users get needless confirmations"}.`,
+                    evidence: { tools: reads.map(toolName) },
+                    fix: "Add annotations: { readOnlyHint: true } to read-only tools, and destructiveHint: false to writes that only add data.",
+                },
+            ];
+        },
+    }),
+];
+//# sourceMappingURL=tools.js.map

package/dist/checks/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/checks/tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAC;AAEvD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,cAAc,GAAG,yBAAyB,CAAC;AACxD,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B,MAAM,QAAQ,GAAG,CAAC,CAAiB,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACrF,MAAM,QAAQ,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC;AAC5D,MAAM,SAAS,GAAG,CAAC,CAAiB,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACxH,MAAM,UAAU,GAAG,CAAC,CAAiB,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,QAAQ,CAAC;AAE1F,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,6HAA6H,CAAC,KAAK,CAAC,GAAG,CAAC,CACzI,CAAC;AACF,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,+RAA+R,CAAC,KAAK,CAAC,GAAG,CAAC,CAC3S,CAAC;AAEF,2GAA2G;AAC3G,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAChG,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACrF,CAAC;AAED,MAAM,WAAW,GAAG,CAAC,CAAU,EAA2B,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAE5G,8DAA8D;AAC9D,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,OAAe;IACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,KAAK,OAAO,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7D,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,YAAY,CAAC,CAAiB,EAAE,CAAgB;IAC9D,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC;IAC5C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,IAAI,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,IAAI,CAAC,SAAS;QAAE,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC;IAC9C,IAAI,OAAO,EAAE,SAAS,KAAK,SAAS;QAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACjF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AACnE,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,cAAc,CAAC,CAAiB,EAAE,CAAgB,EAAE,IAAY;IAC9E,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC;IAC5C,IAAI,MAAM,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1G,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,iBAAiB,EAAE,KAAK,CAAC;IACjD,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;QACzC,IAAI,MAAM,CAAC,QAAQ,KAAK,UAAU;YAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QACzE,IAAI,MAAM,CAAC,QAAQ,KAAK,gBAAgB;YAAE,MAAM,GAAG,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,GAAW;IACtD,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,WAAW,CAAC;QACV,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,+CAA+C;QAC5D,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE;QAC7E,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CACT,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;YAC1B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE;oBACE,OAAO,EAAE,WAAW;oBACpB,QAAQ,EAAE,MAAM;oBAChB,OAAO,EAAE,iEAAiE;oBAC1E,GAAG,EAAE,yEAAyE;iBAC/E;aACF;KACR,CAAC;IAEF,WAAW,CAAC;QACV,EAAE,EAAE,mBAAmB;QACvB,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,uEAAuE;QACpF,SAAS,EAAE,QAAQ;QACnB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CACT,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC;aACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aACzE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACX,OAAO,EAAE,mBAAmB;YAC5B,QAAQ,EAAE,OAAgB;YAC1B,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;YACpB,OAAO,EACL,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;gBACxB,CAAC,CAAC,0BAA0B;gBAC5B,CAAC,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,gCAAgC;YACzE,GAAG,EAAE,0EAA0E;SAChF,CAAC,CAAC;KACR,CAAC;IAEF,WAAW,CAAC;QACV,EAAE,EAAE,qBAAqB;QACzB,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,uBAAuB;QACpC,SAAS,EAAE,QAAQ;QACnB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;YACzC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC;gBAClC,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;oBAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACpF,CAAC;YACD,OAAO,CAAC,GAAG,MAAM,CAAC;iBACf,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;iBACxB,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACnB,OAAO,EAAE,qBAAqB;gBAC9B,QAAQ,EAAE,OAAgB;gBAC1B,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,GAAG,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,6CAA6C;gBAClG,GAAG,EAAE,gCAAgC;aACtC,CAAC,CAAC,CAAC;QACR,CAAC;KACF,CAAC;IAEF,WAAW,CAAC;QACV,EAAE,EAAE,wBAAwB;QAC5B,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,0DAA0D;QACvE,SAAS,EAAE,QAAQ;QACnB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CACvB,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACrB,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;YACpC,IAAI,CAAC,IAAI;gBAAE,OAAO,EAAE,CAAC;YACrB,OAAO,SAAS,CAAC,CAAC,CAAC;iBAChB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;iBAC7D,GAAG,CAAC,CAAC,IAAI,EAAW,EAAE;gBACrB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;gBACjC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACnD,OAAO;oBACL,OAAO,EAAE,wBAAwB;oBACjC,QAAQ,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;oBACnD,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,CAAC,CAAC,EAAE;oBACZ,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,OAAO,EACL,SAAS,KAAK,QAAQ;wBACpB,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,gDAAgD,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI;wBACxF,CAAC,CAAC,SAAS,KAAK,SAAS;4BACvB,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,mBAAmB,OAAO,YAAY,IAAI,CAAC,KAAK,CAAC,OAAO,aAAa;4BACvF,CAAC,CAAC,SAAS,KAAK,eAAe;gCAC7B,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,mBAAmB,OAAO,YAAY,IAAI,CAAC,KAAK,CAAC,OAAO,+CAA+C;gCAC3H,CAAC,CAAC,SAAS,KAAK,kBAAkB;oCAChC,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,mBAAmB,OAAO,+BAA+B,IAAI,CAAC,KAAK,CAAC,OAAO,+CAA+C;oCAC5I,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,kBAAkB,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;oBACvF,GAAG,EAAE,iEAAiE;iBACvE,CAAC;YACJ,CAAC,CAAC,CAAC;QACP,CAAC,CAAC;KACL,CAAC;IAEF,WAAW,CAAC;QACV,EAAE,EAAE,oBAAoB;QACxB,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,oDAAoD;QACjE,SAAS,EAAE,QAAQ;QACnB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CACvB,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACrB,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;YACzC,IAAI,CAAC,KAAK;gBAAE,OAAO,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAClC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC;YACtC,OAAO,SAAS,CAAC,CAAC,CAAC;iBAChB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;iBACnD,GAAG,CAAC,CAAC,IAAI,EAAW,EAAE;gBACrB,MAAM,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;gBAC3B,MAAM,IAAI,GACR,QAAQ,KAAK,QAAQ;oBACnB,CAAC,CAAC,YAAY;oBACd,CAAC,CAAC,QAAQ,KAAK,UAAU;wBACvB,CAAC,CAAC,oBAAoB,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG;wBAC3C,CAAC,CAAC,QAAQ,KAAK,kBAAkB;4BAC/B,CAAC,CAAC,mEAAmE;4BACrE,CAAC,CAAC,QAAQ,KAAK,gBAAgB;gCAC7B,CAAC,CAAC,mBAAmB,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG;gCACjD,CAAC,CAAC,0BAA0B,CAAC;gBACvC,OAAO;oBACL,OAAO,EAAE,oBAAoB;oBAC7B,QAAQ,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;oBAClD,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,CAAC,CAAC,EAAE;oBACZ,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,OAAO,EAAE,MAAM;wBACb,CAAC,CAAC,QAAQ,CAAC,CAAC,WAAW,sBAAsB,MAAM,4CAA4C,UAAU,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,MAAM,6BAA6B,GAAG,QAAQ,CAAC,CAAC,WAAW,IAAI,IAAI,GAAG;wBACzM,CAAC,CAAC,eAAe,IAAI,CAAC,MAAM,gBAAgB,CAAC,CAAC,WAAW,WAAW,GAAG,QAAQ,IAAI,GAAG;oBACxF,GAAG,EAAE,sFAAsF;iBAC5F,CAAC;YACJ,CAAC,CAAC,CAAC;QACP,CAAC,CAAC;KACL,CAAC;IAEF,WAAW,CAAC;QACV,EAAE,EAAE,4BAA4B;QAChC,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,iEAAiE;QAC9E,SAAS,EAAE,QAAQ;QACnB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CACvB,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACrB,MAAM,YAAY,GAAG,IAAI,GAAG,EAAoB,CAAC;YACjD,KAAK,MAAM,IAAI,IAAI,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;gBACxC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;YACpE,CAAC;YACD,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;YACrC,OAAO,CAAC,GAAG,YAAY,CAAC;iBACrB,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;iBACvC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAW,EAAE;gBAC9B,mEAAmE;gBACnE,MAAM,OAAO,GAAG,KAAK,EAAE,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;gBAClH,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC;gBAClD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5E,OAAO;oBACL,OAAO,EAAE,4BAA4B;oBACrC,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;oBACzB,MAAM,EAAE,CAAC,CAAC,EAAE;oBACZ,MAAM,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,MAAM;oBACpE,OAAO,EAAE,aAAa;wBACpB,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,YAAY,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,WAAW,kCAAkC;wBAC7H,CAAC,CAAC,GAAG,IAAI,oCAAoC,IAAI,QAAQ,CAAC,CAAC,WAAW,kCAAkC;oBAC1G,GAAG,EAAE,aAAa;wBAChB,CAAC,CAAC,kDAAkD;wBACpD,CAAC,CAAC,uDAAuD;iBAC5D,CAAC;YACJ,CAAC,CAAC,CAAC;QACP,CAAC,CAAC;KACL,CAAC;IAEF,WAAW,CAAC;QACV,EAAE,EAAE,uBAAuB;QAC3B,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,qCAAqC;QAClD,SAAS,EAAE,QAAQ;QACnB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;YACvB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC;YACvC,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAa,EAAE;gBACvC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;gBAChC,IAAI,CAAC,KAAK,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK;oBAAE,OAAO,EAAE,CAAC;gBAC9C,OAAO;oBACL;wBACE,OAAO,EAAE,uBAAuB;wBAChC,QAAQ,EAAE,MAAM;wBAChB,MAAM,EAAE,CAAC,CAAC,EAAE;wBACZ,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,OAAO,EAAE,QAAQ,CAAC,kBAAkB,KAAK,WAAW,CAAC,CAAC,WAAW,iBAAiB,KAAK,CAAC,KAAK,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC;wBAC7G,GAAG,EAAE,iFAAiF;qBACvF;iBACF,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IAEF,WAAW,CAAC;QACV,EAAE,EAAE,0BAA0B;QAC9B,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,wCAAwC;QACrD,SAAS,EAAE,QAAQ;QACnB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CACT,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC;aACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;aAC/E,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACX,OAAO,EAAE,0BAA0B;YACnC,QAAQ,EAAE,OAAgB;YAC1B,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;YACpB,OAAO,EACL,CAAC,CAAC,WAAW,KAAK,IAAI;gBACpB,CAAC,CAAC,iLAAiL;gBACnL,CAAC,CAAC,oEAAoE;YAC1E,QAAQ,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,UAAU,EAAE;YACtD,GAAG,EAAE,iDAAiD;SACvD,CAAC,CAAC;KACR,CAAC;IAEF,WAAW,CAAC;QACV,EAAE,EAAE,wBAAwB;QAC5B,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,kCAAkC,iBAAiB,aAAa;QAC7E,SAAS,EAAE,QAAQ;QACnB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CACT,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC;aACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;aAC/E,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAAC,CAAC,WAAsB,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,iBAAiB,CAAC;aAC1E,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACX,OAAO,EAAE,wBAAwB;YACjC,QAAQ,EAAE,MAAe;YACzB,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;YACpB,OAAO,EAAE,eAAe,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,sDAAsD;YAC3G,GAAG,EAAE,oFAAoF;SAC1F,CAAC,CAAC;KACR,CAAC;IAEF,WAAW,CAAC;QACV,EAAE,EAAE,4BAA4B;QAChC,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,0EAA0E;QACvF,SAAS,EAAE,SAAS;QACpB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CACvB,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACrB,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,oBAAoB,CAAC;YAC5C,IAAI,CAAC,KAAK;gBAAE,OAAO,EAAE,CAAC;YACtB,MAAM,KAAK,GAA4B,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC;iBACrD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,CAAC;iBAChD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAqB,CAAC,CAAC,CAAC;YACtD,IAAI,CAAC,CAAC,UAAU,EAAE,YAAY;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,uBAAuB,EAAE,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;YACjG,OAAO,KAAK;iBACT,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC;iBAC/C,GAAG,CACF,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,EAAW,EAAE,CAAC,CAAC;gBAC7B,OAAO,EAAE,4BAA4B;gBACrC,QAAQ,EAAE,MAAM;gBAChB,OAAO;gBACP,MAAM,EAAE,CAAC,CAAC,EAAE;gBACZ,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,gBAAgB,CAAC,CAAC,WAAW,oBAAoB,KAAK,CAAC,KAAK,0CAA0C;gBAC7H,GAAG,EAAE,uGAAuG;aAC7G,CAAC,CACH,CAAC;QACN,CAAC,CAAC;KACL,CAAC;IAEF,WAAW,CAAC;QACV,EAAE,EAAE,iCAAiC;QACrC,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,kEAAkE;QAC/E,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QACzF,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;YACvB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACtF,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAa,EAAE;gBACvC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;gBACxC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,eAAe;oBAAE,OAAO,EAAE,CAAC;gBACvD,OAAO;oBACL;wBACE,OAAO,EAAE,iCAAiC;wBAC1C,QAAQ,EAAE,MAAM;wBAChB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;wBACzB,MAAM,EAAE,CAAC,CAAC,EAAE;wBACZ,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,OAAO,EACL,IAAI,CAAC,KAAK,KAAK,cAAc;4BAC3B,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,+GAA+G;4BACjI,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,UAAU;gCACzB,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,kFAAkF;gCACpG,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,gGAAgG;wBACxH,GAAG,EACD,IAAI,CAAC,KAAK,KAAK,cAAc;4BAC3B,CAAC,CAAC,wDAAwD;4BAC1D,CAAC,CAAC,wEAAwE;qBAC/E;iBACF,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IAEF,WAAW,CAAC;QACV,EAAE,EAAE,2BAA2B;QAC/B,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,0EAA0E;QACvF,SAAS,EAAE,QAAQ;QACnB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CACT,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAa,EAAE;YACzC,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC,CAAC,YAAY,KAAK,IAAI;gBAAE,OAAO,EAAE,CAAC;YACvC,IAAI,CAAC,CAAC,eAAe,KAAK,IAAI,IAAI,CAAC,CAAC,cAAc,KAAK,KAAK,EAAE,CAAC;gBAC7D,OAAO;oBACL;wBACE,OAAO,EAAE,2BAA2B;wBACpC,QAAQ,EAAE,MAAM;wBAChB,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;wBACpB,OAAO,EAAE,yHAAyH;wBAClI,QAAQ,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE;wBACxC,GAAG,EAAE,yDAAyD;qBAC/D;iBACF,CAAC;YACJ,CAAC;YACD,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;gBACjE,OAAO;oBACL;wBACE,OAAO,EAAE,2BAA2B;wBACpC,QAAQ,EAAE,MAAM;wBAChB,OAAO,EAAE,CAAC,CAAC,IAAI;wBACf,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,wCAAwC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,2EAA2E;wBACzJ,QAAQ,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE;wBACxC,GAAG,EAAE,2FAA2F;qBACjG;iBACF,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;KACL,CAAC;IAEF,WAAW,CAAC;QACV,EAAE,EAAE,oBAAoB;QACxB,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,mCAAmC;QAChD,SAAS,EAAE,QAAQ;QACnB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9F,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YACrC,OAAO;gBACL;oBACE,OAAO,EAAE,oBAAoB;oBAC7B,QAAQ,EAAE,MAAM;oBAChB,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7F,OAAO,EAAE,GAAG,QAAQ,CAAC,MAAM,uIAAuI;oBAClK,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;oBAC3C,GAAG,EAAE,+DAA+D;iBACrE;aACF,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,WAAW,CAAC;QACV,EAAE,EAAE,0BAA0B;QAC9B,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,sCAAsC;QACnD,SAAS,EAAE,QAAQ;QACnB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;YACvB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAChC,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,qBAAqB,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;YAClH,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CACxB,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,CAChH,CAAC;YACF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;YAC1D,OAAO;gBACL;oBACE,OAAO,EAAE,0BAA0B;oBACnC,QAAQ,EAAE,MAAM;oBAChB,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;oBACvC,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,yDAAyD,IAAI,CAAC,CAAC,CAAC,0CAA0C,CAAC,CAAC,CAAC,EAAE,wEAAwE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC,CAAC,uCAAuC,GAAG;oBACnV,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;oBACxC,GAAG,EAAE,sHAAsH;iBAC5H;aACF,CAAC;QACJ,CAAC;KACF,CAAC;CACH,CAAC"}

package/dist/checks/transport.d.ts

@@ -0,0 +1,2 @@
+export declare const transportChecks: import("./types.js").Check[];
+//# sourceMappingURL=transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/checks/transport.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,eAAe,8BAwH3B,CAAC"}

package/dist/checks/transport.js

@@ -0,0 +1,123 @@
+import { modernOnly } from "./protocol.js";
+import { connected, isHttp, isStdio } from "./util.js";
+import { defineCheck } from "./types.js";
+const SLOW_STARTUP_MS = 5000;
+const SLOW_LIST_MS = 3000;
+function authRequired(s) {
+    const status = s.http?.unauthenticated.status;
+    return !s.connect.ok && (status === 401 || status === 403);
+}
+export const transportChecks = [
+    defineCheck({
+        id: "TRANSPORT_CONNECT_FAILED",
+        area: "transport",
+        description: "The server starts and answers initialize",
+        appliesTo: (s) => !authRequired(s) && !modernOnly(s),
+        run: (s) => s.connect.ok
+            ? []
+            : [
+                {
+                    checkId: "TRANSPORT_CONNECT_FAILED",
+                    severity: "error",
+                    message: `Could not connect: ${s.connect.error ?? "unknown error"}`,
+                    evidence: { stderrTail: s.io.stderrTail.slice(-10) },
+                    fix: "Check the command, working directory and required environment variables (--env).",
+                },
+            ],
+    }),
+    defineCheck({
+        id: "TRANSPORT_AUTH_REQUIRED",
+        area: "transport",
+        description: "Notes when an HTTP server needs credentials before initialize",
+        appliesTo: isHttp,
+        run: (s) => authRequired(s)
+            ? [
+                {
+                    checkId: "TRANSPORT_AUTH_REQUIRED",
+                    severity: "info",
+                    message: `Server requires authorization (HTTP ${s.http.unauthenticated.status}); only auth discovery was checked.`,
+                    fix: "Pass --header 'Authorization: Bearer <token>' to also check tools, resources and prompts.",
+                },
+            ]
+            : [],
+    }),
+    defineCheck({
+        id: "TRANSPORT_STDOUT_POLLUTION",
+        area: "transport",
+        description: "stdout carries only JSON-RPC messages",
+        appliesTo: isStdio,
+        run: (s) => {
+            const lines = s.io.stdoutNonJsonLines;
+            if (lines.length === 0)
+                return [];
+            // A protocol message glued to log output (no newline between them) is lost entirely.
+            const corrupted = lines.filter((l) => l.includes('"jsonrpc"'));
+            const count = `${lines.length}${lines.length >= 50 ? "+" : ""}`;
+            return [
+                {
+                    checkId: "TRANSPORT_STDOUT_POLLUTION",
+                    severity: corrupted.length > 0 ? "error" : "warn",
+                    message: corrupted.length > 0
+                        ? `Log output on stdout corrupted ${corrupted.length} JSON-RPC message(s), e.g. ${JSON.stringify(corrupted[0])}; clients drop them and the request hangs.`
+                        : `Server wrote ${count} non-JSON-RPC line(s) to stdout, e.g. ${JSON.stringify(lines[0])}. MCP SDK clients drop these lines (the v1 TypeScript SDK reports each as an error), and any log write without a trailing newline corrupts the next message.`,
+                    evidence: { lines: (corrupted.length > 0 ? corrupted : lines).slice(0, 5) },
+                    affects: ["stdio"],
+                    fix: "Send logs to stderr (console.error / logging to sys.stderr). stdout is reserved for protocol messages.",
+                },
+            ];
+        },
+    }),
+    defineCheck({
+        id: "TRANSPORT_SLOW_STARTUP",
+        area: "transport",
+        description: `initialize answers within ${SLOW_STARTUP_MS / 1000}s of launch`,
+        appliesTo: connected,
+        run: (s) => (s.connect.startupMs ?? 0) > SLOW_STARTUP_MS
+            ? [
+                {
+                    checkId: "TRANSPORT_SLOW_STARTUP",
+                    severity: "warn",
+                    message: `initialize took ${s.connect.startupMs}ms; some clients time out on slow startup.`,
+                    evidence: { startupMs: s.connect.startupMs },
+                    fix: "Defer expensive setup (network, model loading) until after initialize. If launched via npx/uvx, first-run installs count too.",
+                },
+            ]
+            : [],
+    }),
+    defineCheck({
+        id: "TRANSPORT_SLOW_LIST",
+        area: "transport",
+        description: `list requests answer within ${SLOW_LIST_MS / 1000}s`,
+        appliesTo: connected,
+        run: (s) => Object.entries(s.lists)
+            .filter(([, list]) => list && list.durationMs > SLOW_LIST_MS)
+            .map(([kind, list]) => ({
+            checkId: "TRANSPORT_SLOW_LIST",
+            severity: "warn",
+            subject: kind,
+            message: `${kind} listing took ${list.durationMs}ms.`,
+            evidence: { durationMs: list.durationMs, pages: list.pages },
+            fix: "Build list responses from static metadata; don't call upstream APIs while listing.",
+        })),
+    }),
+    defineCheck({
+        id: "TRANSPORT_STDERR_ERRORS",
+        area: "transport",
+        description: "stderr shows no errors during the session",
+        appliesTo: isStdio,
+        run: (s) => {
+            const errors = s.io.stderrTail.filter((l) => /\b(error|exception|traceback|unhandled)\b/i.test(l));
+            if (errors.length === 0 || !s.connect.ok)
+                return [];
+            return [
+                {
+                    checkId: "TRANSPORT_STDERR_ERRORS",
+                    severity: "info",
+                    message: `stderr contained ${errors.length} error-looking line(s), e.g. ${JSON.stringify(errors[0])}`,
+                    evidence: { lines: errors.slice(0, 5) },
+                },
+            ];
+        },
+    }),
+];
+//# sourceMappingURL=transport.js.map

package/dist/checks/transport.js.map

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

package/dist/checks/types.d.ts

@@ -0,0 +1,37 @@
+import type { ClientFeature, ClientProfile } from "../profiles/types.js";
+import type { ServerSnapshot } from "../snapshot.js";
+export type Severity = "error" | "warn" | "info";
+export type CheckArea = "transport" | "protocol" | "tools" | "schema" | "discovery" | "resources" | "ui" | "auth" | "calls" | "sdk";
+export interface Finding {
+    checkId: string;
+    severity: Severity;
+    message: string;
+    /** Tool/resource/prompt name or URL the finding is about. */
+    subject?: string;
+    evidence?: Record<string, unknown>;
+    fix?: string;
+    /**
+     * Client features that make this finding matter. A client known not to
+     * support any of them gets INFO instead of FAIL/WARN. Absent = all clients.
+     */
+    affects?: ClientFeature[];
+    /** Set when the finding only applies to one client (limit checks). */
+    client?: string;
+    /** Profile source backing a client-specific finding. */
+    source?: string;
+}
+export interface CheckContext {
+    profiles: ClientProfile[];
+}
+export interface Check {
+    id: string;
+    area: CheckArea;
+    /** One line, shown by --list-checks. */
+    description: string;
+    /** False → the check is reported as SKIP (e.g. auth checks on stdio). */
+    appliesTo: (snapshot: ServerSnapshot) => boolean;
+    run: (snapshot: ServerSnapshot, ctx: CheckContext) => Finding[];
+}
+/** Helper so check modules can define checks with less boilerplate. */
+export declare function defineCheck(check: Check): Check;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/checks/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjD,MAAM,MAAM,SAAS,GACjB,WAAW,GACX,UAAU,GACV,OAAO,GACP,QAAQ,GACR,WAAW,GACX,WAAW,GACX,IAAI,GACJ,MAAM,GACN,OAAO,GACP,KAAK,CAAC;AAEV,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,SAAS,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC;IACjD,GAAG,EAAE,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,YAAY,KAAK,OAAO,EAAE,CAAC;CACjE;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAE/C"}

package/dist/checks/types.js

@@ -0,0 +1,5 @@
+/** Helper so check modules can define checks with less boilerplate. */
+export function defineCheck(check) {
+    return check;
+}
+//# sourceMappingURL=types.js.map

package/dist/checks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/checks/types.ts"],"names":[],"mappings":"AAkDA,uEAAuE;AACvE,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,OAAO,KAAK,CAAC;AACf,CAAC"}