mcp-use-compat 0.3.0

package/dist/checks/schema.js

@@ -0,0 +1,412 @@
+import { Ajv } from "ajv";
+import { Ajv2020 } from "ajv/dist/2020.js";
+import { connected, isObject, items, str, withNote } from "./util.js";
+import { defineCheck } from "./types.js";
+const MAX_DEPTH = 5;
+const COMBINATORS = ["oneOf", "anyOf", "allOf", "not"];
+const ajv2020 = new Ajv2020({ strict: false, validateSchema: false, logger: false });
+const ajv07 = new Ajv({ strict: false, validateSchema: false, logger: false });
+const hasTools = (s) => connected(s) && items(s, "tools").length > 0;
+const toolName = (t) => str(t.name) ?? "(unnamed)";
+/** Tools whose schema at `key` is an object (ignores missing/invalid ones). */
+function schemas(s, key) {
+    return items(s, "tools").flatMap((t) => (isObject(t[key]) ? [[t, t[key]]] : []));
+}
+/** Meta-validates against the draft named in $schema (2020-12 by default, per the MCP spec). */
+export function metaValidate(schema) {
+    const dialect = str(schema.$schema) ?? "https://json-schema.org/draft/2020-12/schema";
+    const validator = /draft-0[67]/.test(dialect) ? ajv07 : /2020-12/.test(dialect) ? ajv2020 : undefined;
+    if (!validator)
+        return undefined; // Unknown dialect: don't guess.
+    const valid = validator.validateSchema(schema);
+    if (valid)
+        return [];
+    return (validator.errors ?? []).map((e) => `${e.instancePath || "/"} ${e.message ?? "is invalid"}`);
+}
+/** Walks subschemas and collects keywords, nesting depth, and properties without a type. */
+export function analyze(schema) {
+    const stats = { keywords: new Set(), depth: 0, untypedProperties: [], typeArrays: [] };
+    const visit = (node, depth, path) => {
+        if (!isObject(node))
+            return;
+        stats.depth = Math.max(stats.depth, depth);
+        if (Array.isArray(node.type))
+            stats.typeArrays.push(path.replace(/\.$/, "") || "(root)");
+        for (const key of Object.keys(node))
+            stats.keywords.add(key);
+        if (isObject(node.properties)) {
+            for (const [name, sub] of Object.entries(node.properties)) {
+                const p = `${path}${name}`;
+                if (isObject(sub) && !hasTypeInfo(sub))
+                    stats.untypedProperties.push(p);
+                visit(sub, depth + 1, `${p}.`);
+            }
+        }
+        for (const key of ["items", "additionalProperties", "not", "if", "then", "else", "contains"]) {
+            visit(node[key], depth + 1, `${path}${key}.`);
+        }
+        for (const key of ["anyOf", "oneOf", "allOf", "prefixItems"]) {
+            if (Array.isArray(node[key]))
+                node[key].forEach((sub) => visit(sub, depth + 1, path));
+        }
+        for (const key of ["$defs", "definitions", "patternProperties"]) {
+            if (isObject(node[key]))
+                Object.values(node[key]).forEach((sub) => visit(sub, depth, path));
+        }
+    };
+    visit(schema, 0, "");
+    return stats;
+}
+/** Every enum in the schema with its path. */
+function enumPaths(schema, path = "", out = []) {
+    if (!isObject(schema))
+        return out;
+    if (Array.isArray(schema.enum))
+        out.push([path || "(root)", schema.enum]);
+    if (isObject(schema.properties)) {
+        for (const [name, sub] of Object.entries(schema.properties))
+            enumPaths(sub, path ? `${path}.${name}` : name, out);
+    }
+    if (isObject(schema.items))
+        enumPaths(schema.items, `${path}[]`, out);
+    for (const key of ["anyOf", "oneOf", "allOf"]) {
+        if (Array.isArray(schema[key]))
+            schema[key].forEach((sub) => enumPaths(sub, path, out));
+    }
+    return out;
+}
+/**
+ * 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 function rootCombinatorBreaks(schema) {
+    if (typeof schema.type === "string")
+        return false;
+    if ("properties" in schema || "required" in schema || "additionalProperties" in schema)
+        return false;
+    const isObjectBranch = (b) => isObject(b) && b.type === "object";
+    for (const key of ["oneOf", "anyOf", "allOf"]) {
+        const branches = schema[key];
+        if (!Array.isArray(branches) || branches.length === 0)
+            continue;
+        return key === "allOf" ? !branches.some(isObjectBranch) : !branches.every(isObjectBranch);
+    }
+    return false;
+}
+function hasTypeInfo(schema) {
+    return ["type", "enum", "const", "$ref", ...COMBINATORS].some((k) => k in schema);
+}
+export const schemaChecks = [
+    defineCheck({
+        id: "SCHEMA_MISSING",
+        area: "schema",
+        description: "Every tool has an inputSchema object",
+        appliesTo: hasTools,
+        run: (s) => items(s, "tools")
+            .filter((t) => !isObject(t.inputSchema))
+            .map((t) => ({
+            checkId: "SCHEMA_MISSING",
+            severity: "error",
+            subject: toolName(t),
+            message: "Tool has no inputSchema object. The spec requires one; the TypeScript SDK rejects the whole tools/list response, so SDK-based clients see no tools at all.",
+            fix: 'Use { "type": "object", "properties": {} } for tools without arguments.',
+        })),
+    }),
+    defineCheck({
+        id: "SCHEMA_NOT_OBJECT",
+        area: "schema",
+        description: 'inputSchema and outputSchema have type "object" at the root',
+        appliesTo: hasTools,
+        run: (s) => ["inputSchema", "outputSchema"].flatMap((key) => schemas(s, key)
+            .filter(([, schema]) => schema.type !== "object")
+            .map(([t, schema]) => ({
+            checkId: "SCHEMA_NOT_OBJECT",
+            severity: "error",
+            subject: toolName(t),
+            message: `${key} root type is ${JSON.stringify(schema.type ?? null)}, but MCP requires "object"; the TypeScript SDK rejects the whole tools/list response.`,
+            fix: 'Wrap arguments in an object schema: { "type": "object", "properties": { ... } }.',
+        }))),
+    }),
+    defineCheck({
+        id: "SCHEMA_INVALID",
+        area: "schema",
+        description: "Schemas are valid JSON Schema",
+        appliesTo: hasTools,
+        run: (s) => ["inputSchema", "outputSchema"].flatMap((key) => schemas(s, key).flatMap(([t, schema]) => {
+            const errors = metaValidate(schema);
+            if (!errors || errors.length === 0)
+                return [];
+            return [
+                {
+                    checkId: "SCHEMA_INVALID",
+                    severity: "error",
+                    subject: toolName(t),
+                    message: `${key} is not valid JSON Schema: ${errors.slice(0, 3).join("; ")}`,
+                    evidence: { errors },
+                    fix: "Generate schemas with your SDK's schema helper instead of writing them by hand.",
+                },
+            ];
+        })),
+    }),
+    defineCheck({
+        id: "SCHEMA_REQUIRED_UNKNOWN",
+        area: "schema",
+        description: "required only lists declared properties",
+        appliesTo: hasTools,
+        run: (s) => schemas(s, "inputSchema").flatMap(([t, schema]) => {
+            if (!Array.isArray(schema.required))
+                return [];
+            const props = isObject(schema.properties) ? schema.properties : {};
+            const unknown = schema.required.filter((r) => typeof r === "string" && !(r in props));
+            if (unknown.length === 0)
+                return [];
+            return [
+                {
+                    checkId: "SCHEMA_REQUIRED_UNKNOWN",
+                    severity: "warn",
+                    subject: toolName(t),
+                    message: `required lists ${unknown.map((u) => JSON.stringify(u)).join(", ")}, which ${unknown.length === 1 ? "is" : "are"} not in properties; the model can't know their type.`,
+                    fix: "Add the missing properties or remove them from required.",
+                },
+            ];
+        }),
+    }),
+    defineCheck({
+        id: "SCHEMA_TOP_LEVEL_COMBINATOR",
+        area: "schema",
+        description: "inputSchema has no root-level oneOf/anyOf/allOf/not",
+        appliesTo: hasTools,
+        run: (s) => schemas(s, "inputSchema").flatMap(([t, schema]) => {
+            const used = COMBINATORS.filter((k) => k in schema);
+            if (used.length === 0)
+                return [];
+            return [
+                {
+                    checkId: "SCHEMA_TOP_LEVEL_COMBINATOR",
+                    severity: "info",
+                    subject: toolName(t),
+                    message: `inputSchema uses ${used.join("/")} at the root. Valid JSON Schema, but clients handle it differently: some rewrite it (Claude Code), and some fail on it (see client-specific results).`,
+                    fix: "Use one flat object schema; express variants with optional properties or an enum discriminator.",
+                },
+            ];
+        }),
+    }),
+    defineCheck({
+        id: "SCHEMA_UNSUPPORTED_KEYWORD",
+        area: "schema",
+        description: "Schemas avoid keywords a client rejects or drops",
+        appliesTo: hasTools,
+        run: (s, { profiles }) => profiles.flatMap((p) => {
+            const rule = p.limits.schemaUnsupported;
+            if (!rule)
+                return [];
+            return schemas(s, "inputSchema").flatMap(([t, schema]) => {
+                const { keywords } = analyze(schema);
+                const bad = rule.value.filter((k) => keywords.has(k));
+                if (bad.length === 0)
+                    return [];
+                return [
+                    {
+                        checkId: "SCHEMA_UNSUPPORTED_KEYWORD",
+                        severity: "warn",
+                        subject: toolName(t),
+                        client: p.id,
+                        source: rule.source,
+                        message: withNote(`inputSchema uses ${bad.join(", ")}, which ${p.displayName} does not support.`, rule.note),
+                        fix: "Inline definitions and simplify the schema for maximum compatibility.",
+                    },
+                ];
+            });
+        }),
+    }),
+    defineCheck({
+        id: "SCHEMA_PROPERTY_NAME_REJECTED",
+        area: "schema",
+        description: "Top-level input property names match each client's rules",
+        appliesTo: hasTools,
+        run: (s, { profiles }) => profiles.flatMap((p) => {
+            const rule = p.limits.inputPropertyNamePattern;
+            if (!rule)
+                return [];
+            const pattern = new RegExp(rule.value);
+            return schemas(s, "inputSchema").flatMap(([t, schema]) => {
+                const names = isObject(schema.properties) ? Object.keys(schema.properties) : [];
+                const bad = names.filter((n) => !pattern.test(n));
+                if (bad.length === 0)
+                    return [];
+                return [
+                    {
+                        checkId: "SCHEMA_PROPERTY_NAME_REJECTED",
+                        severity: "warn",
+                        subject: toolName(t),
+                        client: p.id,
+                        source: rule.source,
+                        message: withNote(`Property name(s) ${bad.map((b) => JSON.stringify(b)).join(", ")} don't match /${rule.value}/, so ${p.displayName} may drop this tool.`, rule.note),
+                        fix: "Rename arguments to 1-64 characters of letters, digits, _, - and .",
+                    },
+                ];
+            });
+        }),
+    }),
+    defineCheck({
+        id: "SCHEMA_EMPTY_ENUM",
+        area: "schema",
+        description: "enum lists have at least one value",
+        appliesTo: hasTools,
+        run: (s) => schemas(s, "inputSchema").flatMap(([t, schema]) => {
+            const empty = enumPaths(schema).filter(([, values]) => values.length === 0).map(([path]) => path);
+            if (empty.length === 0)
+                return [];
+            return [
+                {
+                    checkId: "SCHEMA_EMPTY_ENUM",
+                    severity: "warn",
+                    subject: toolName(t),
+                    message: `Empty enum at ${empty.join(", ")}: no value can satisfy it, so the tool can never be called correctly.`,
+                    fix: "List the allowed values, or remove enum.",
+                },
+            ];
+        }),
+    }),
+    defineCheck({
+        id: "SCHEMA_ROOT_COMBINATOR_CLIENT",
+        area: "schema",
+        description: "Root-level oneOf/anyOf/allOf is shaped the way each client can handle",
+        appliesTo: hasTools,
+        run: (s, { profiles }) => profiles.flatMap((p) => {
+            const rule = p.limits.rootCombinatorNonObject;
+            if (!rule)
+                return [];
+            const bad = schemas(s, "inputSchema").filter(([, schema]) => rootCombinatorBreaks(schema));
+            if (bad.length === 0)
+                return [];
+            return [
+                {
+                    checkId: "SCHEMA_ROOT_COMBINATOR_CLIENT",
+                    severity: "error",
+                    subject: bad.map(([t]) => toolName(t)).join(", "),
+                    client: p.id,
+                    source: rule.source,
+                    message: `${bad.length} tool(s) have no root type and a root-level oneOf/anyOf with a branch that isn't type: "object" (or an allOf without one); ${p.displayName} fails to register them and drops every tool from this server.`,
+                    fix: 'Add "type": "object" at the root (MCP requires it anyway), or make every branch type: "object".',
+                },
+            ];
+        }),
+    }),
+    defineCheck({
+        id: "SCHEMA_TYPE_ARRAY_CLIENT",
+        area: "schema",
+        description: 'Type arrays (e.g. ["string","null"]) avoided for clients that fail on them',
+        appliesTo: hasTools,
+        run: (s, { profiles }) => profiles.flatMap((p) => {
+            const rule = p.limits.typeArraysRejected;
+            if (!rule?.value)
+                return [];
+            const bad = schemas(s, "inputSchema").filter(([, schema]) => analyze(schema).typeArrays.length > 0);
+            if (bad.length === 0)
+                return [];
+            return [
+                {
+                    checkId: "SCHEMA_TYPE_ARRAY_CLIENT",
+                    severity: "warn",
+                    subject: bad.map(([t]) => toolName(t)).join(", "),
+                    client: p.id,
+                    source: rule.source,
+                    message: withNote(`${bad.length} tool(s) use type arrays such as ["string","null"], which ${p.displayName}'s argument validation rejects.`, rule.note),
+                    fix: "Make the property optional instead of nullable, or use a single type.",
+                },
+            ];
+        }),
+    }),
+    defineCheck({
+        id: "SCHEMA_KEYWORDS_DROPPED",
+        area: "schema",
+        description: "Notes schema constraints a client removes before the model sees them",
+        appliesTo: hasTools,
+        run: (s, { profiles }) => profiles.flatMap((p) => {
+            const rule = p.limits.schemaDroppedKeywords;
+            if (!rule)
+                return [];
+            const used = new Set(schemas(s, "inputSchema").flatMap(([, schema]) => [...analyze(schema).keywords]));
+            const dropped = rule.value.filter((k) => used.has(k));
+            if (dropped.length === 0)
+                return [];
+            return [
+                {
+                    checkId: "SCHEMA_KEYWORDS_DROPPED",
+                    severity: "info",
+                    client: p.id,
+                    source: rule.source,
+                    message: `${p.displayName} silently removes ${dropped.join(", ")} from schemas, so the model never sees those constraints.`,
+                    fix: "Validate arguments on the server and state important constraints in descriptions.",
+                },
+            ];
+        }),
+    }),
+    defineCheck({
+        id: "SCHEMA_TOO_LARGE",
+        area: "schema",
+        description: "inputSchema fits each client's size limit",
+        appliesTo: hasTools,
+        run: (s, { profiles }) => profiles.flatMap((p) => {
+            const limit = p.limits.maxSchemaChars;
+            if (!limit)
+                return [];
+            return schemas(s, "inputSchema")
+                .map(([t, schema]) => [toolName(t), JSON.stringify(schema).length])
+                .filter(([, size]) => size > limit.value)
+                .map(([name, size]) => ({
+                checkId: "SCHEMA_TOO_LARGE",
+                severity: "warn",
+                subject: name,
+                client: p.id,
+                source: limit.source,
+                message: withNote(`inputSchema is about ${size} characters; ${p.displayName} compacts schemas over ${limit.value}.`, limit.note),
+                fix: "Trim long descriptions and nested definitions, or split the tool.",
+            }));
+        }),
+    }),
+    defineCheck({
+        id: "SCHEMA_PROPERTY_NO_TYPE",
+        area: "schema",
+        description: "Every input property declares a type",
+        appliesTo: hasTools,
+        run: (s) => schemas(s, "inputSchema").flatMap(([t, schema]) => {
+            const { untypedProperties } = analyze(schema);
+            if (untypedProperties.length === 0)
+                return [];
+            return [
+                {
+                    checkId: "SCHEMA_PROPERTY_NO_TYPE",
+                    severity: "info",
+                    subject: toolName(t),
+                    message: `Properties without a type: ${untypedProperties.slice(0, 5).join(", ")}${untypedProperties.length > 5 ? ", …" : ""}.`,
+                    fix: "Give every property a type so the model sends the right kind of value.",
+                },
+            ];
+        }),
+    }),
+    defineCheck({
+        id: "SCHEMA_TOO_DEEP",
+        area: "schema",
+        description: `inputSchema nests at most ${MAX_DEPTH} levels`,
+        appliesTo: hasTools,
+        run: (s) => schemas(s, "inputSchema").flatMap(([t, schema]) => {
+            const { depth } = analyze(schema);
+            if (depth <= MAX_DEPTH)
+                return [];
+            return [
+                {
+                    checkId: "SCHEMA_TOO_DEEP",
+                    severity: "info",
+                    subject: toolName(t),
+                    message: `inputSchema nests ${depth} levels deep; models fill deeply nested arguments unreliably.`,
+                    fix: "Flatten the arguments where you can.",
+                },
+            ];
+        }),
+    }),
+];
+//# sourceMappingURL=schema.js.map

package/dist/checks/schema.js.map

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

package/dist/checks/sdk.d.ts

@@ -0,0 +1,10 @@
+import { type UpgradeAdvice } from "../sdk-facts.js";
+import type { ServerSnapshot } from "../snapshot.js";
+export declare function adviceFor(s: ServerSnapshot): UpgradeAdvice[];
+/**
+ * The concrete next step for protocol findings: the exact upgrade command when
+ * we know the project, otherwise how to get one.
+ */
+export declare function upgradeHint(s: ServerSnapshot, wantModern?: boolean): string;
+export declare const sdkChecks: import("./types.js").Check[];
+//# sourceMappingURL=sdk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/checks/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAKrD,wBAAgB,SAAS,CAAC,CAAC,EAAE,cAAc,GAAG,aAAa,EAAE,CAE5D;AAOD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,UAAQ,GAAG,MAAM,CAYzE;AAED,eAAO,MAAM,SAAS,8BAoCrB,CAAC"}

package/dist/checks/sdk.js

@@ -0,0 +1,68 @@
+import { adviseUpgrade, SDK_FACTS } from "../sdk-facts.js";
+import { defineCheck } from "./types.js";
+const LATEST_HANDSHAKE = "2025-11-25";
+export function adviceFor(s) {
+    return (s.project?.sdks ?? []).map(adviseUpgrade);
+}
+const protocolIsOld = (s) => {
+    const v = s.initialize?.negotiatedProtocolVersion;
+    return s.era !== "modern" && !!v && v < LATEST_HANDSHAKE;
+};
+/**
+ * The concrete next step for protocol findings: the exact upgrade command when
+ * we know the project, otherwise how to get one.
+ */
+export function upgradeHint(s, wantModern = false) {
+    const advice = adviceFor(s);
+    const actionable = advice.filter((a) => a.command && (a.kind === "minor" || a.kind === "major") && (!wantModern || a.addsModern));
+    if (actionable.length)
+        return actionable.map((a) => `${a.summary} Run: ${a.command}`).join(" ");
+    const migrate = advice.find((a) => a.kind === "migrate");
+    if (wantModern && migrate)
+        return `${migrate.summary}`;
+    if (advice.length && advice.every((a) => a.kind === "current")) {
+        return "Your MCP SDK is already the latest release; check whether the server pins an older protocolVersion.";
+    }
+    return s.target.kind === "stdio"
+        ? "Upgrade your MCP SDK. Run `mcp-use-compat upgrade -- <your server command>` in the server's project for the exact command."
+        : "Upgrade the server's MCP SDK. Run `mcp-use-compat upgrade -- <server command>` in its project for the exact command.";
+}
+export const sdkChecks = [
+    defineCheck({
+        id: "SDK_OUTDATED",
+        area: "sdk",
+        description: "The server's MCP SDK is the latest release",
+        appliesTo: (s) => (s.project?.sdks.length ?? 0) > 0,
+        run: (s) => adviceFor(s).flatMap((a) => {
+            if (a.kind === "current" || a.kind === "unknown")
+                return [];
+            const fact = SDK_FACTS[a.sdk.name];
+            if (a.kind === "migrate") {
+                if (s.discover?.ok)
+                    return [];
+                return [
+                    {
+                        checkId: "SDK_OUTDATED",
+                        severity: "info",
+                        subject: a.sdk.name,
+                        message: a.summary,
+                        source: fact?.source,
+                        fix: `Plan a migration to ${fact?.migrateTo} when your target clients need 2026-07-28.`,
+                    },
+                ];
+            }
+            return [
+                {
+                    checkId: "SDK_OUTDATED",
+                    severity: protocolIsOld(s) ? "warn" : "info",
+                    subject: a.sdk.name,
+                    message: `${a.summary}${protocolIsOld(s) ? ` The server negotiates ${s.initialize.negotiatedProtocolVersion}; upgrading is the usual fix.` : ""}`,
+                    evidence: { installed: a.sdk.installed, declared: a.sdk.declared, latest: a.sdk.latest, manifest: a.sdk.manifest, manager: a.sdk.manager },
+                    source: fact?.source,
+                    fix: `Run: ${a.command}${a.kind === "major" ? " (major upgrade: read the release notes first)" : ""}`,
+                },
+            ];
+        }),
+    }),
+];
+//# sourceMappingURL=sdk.js.map

package/dist/checks/sdk.js.map

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

package/dist/checks/tools.d.ts

@@ -0,0 +1,18 @@
+import type { ClientProfile } from "../profiles/types.js";
+import type { ServerSnapshot } from "../snapshot.js";
+/** Tool name format from the MCP spec (SEP-986), as enforced by the SDK. */
+export declare const SPEC_TOOL_NAME: RegExp;
+/** The first word of a tool name, lowercased: get_user → get, createEvent → create, files.read → files. */
+export declare function leadingVerb(name: string): string;
+/** "read" / "write" from the tool name's leading verb, or undefined if it doesn't say. */
+export declare function nameIntent(name: string): "read" | "write" | undefined;
+/** Replaces characters outside the allowed class with "_". */
+export declare function sanitize(name: string, allowed: string): string;
+/** The prefix a client puts in front of this server's tool names ("" if none/unknown). */
+export declare function clientPrefix(s: ServerSnapshot, p: ClientProfile): string;
+/** The name the client ends up using, applying only documented replace/truncate behaviour. */
+export declare function clientToolName(s: ServerSnapshot, p: ClientProfile, name: string): string;
+/** Start and end joined by "..." (Gemini CLI's scheme: 30 + "..." + 30 for a 63 limit). */
+export declare function truncateMiddle(name: string, max: number): string;
+export declare const toolChecks: import("./types.js").Check[];
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/checks/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAW,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAI9D,4EAA4E;AAC5E,eAAO,MAAM,cAAc,QAA4B,CAAC;AAexD,2GAA2G;AAC3G,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAGrE;AAID,8DAA8D;AAC9D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,aAAa,GAAG,MAAM,CASxE;AAED,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CASxF;AAED,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED,eAAO,MAAM,UAAU,8BA+XtB,CAAC"}