@plurnk/plurnk-mcp 1.6.1 → 1.8.0

package/dist/oauth.js

@@ -0,0 +1,149 @@
+import { randomUUID } from "node:crypto";
+import packageJson from "../package.json" with { type: "json" };
+export default class InteractiveOAuthProvider {
+    redirectUrl;
+    clientMetadataUrl;
+    #scope;
+    #configuredClientInformation;
+    #clientInformation = new Map();
+    #tokens = new Map();
+    #configuredIssuer;
+    #activeIssuer;
+    #currentTokens;
+    #presentedToken = false;
+    #awaitingAuthorizationCallback = false;
+    #state;
+    #authorizationUrl;
+    #codeVerifier;
+    #discoveryState;
+    constructor({ redirectUrl, clientMetadataUrl, clientId, clientSecret, scope, }) {
+        this.redirectUrl = redirectUrl;
+        this.clientMetadataUrl = clientMetadataUrl;
+        this.#scope = scope;
+        this.#configuredClientInformation = clientId === undefined
+            ? undefined
+            : { client_id: clientId, ...(clientSecret === undefined ? {} : { client_secret: clientSecret }) };
+    }
+    get clientMetadata() {
+        return {
+            client_name: packageJson.name,
+            redirect_uris: [this.redirectUrl],
+            grant_types: ["authorization_code", "refresh_token"],
+            response_types: ["code"],
+            token_endpoint_auth_method: "none",
+            ...(this.#scope === undefined ? {} : { scope: this.#scope }),
+        };
+    }
+    state() {
+        this.#state = randomUUID();
+        return this.#state;
+    }
+    clientInformation(context) {
+        const issuer = context?.issuer ?? this.#activeIssuer;
+        if (issuer === undefined)
+            return undefined;
+        this.#activeIssuer = issuer;
+        const stored = this.#clientInformation.get(issuer);
+        if (stored !== undefined)
+            return stored;
+        if (this.#configuredClientInformation === undefined
+            || (this.#configuredIssuer !== undefined && this.#configuredIssuer !== issuer)) {
+            const metadata = this.#discoveryState?.authorizationServerMetadata;
+            const cimdAvailable = this.clientMetadataUrl !== undefined
+                && metadata?.client_id_metadata_document_supported === true;
+            if (!cimdAvailable && metadata?.registration_endpoint === undefined) {
+                throw new Error(`MCP authorization server '${issuer}' exposes no usable client registration: `
+                    + "configure pre-registration or advertised CIMD; its metadata does not advertise "
+                    + "a Dynamic Client Registration endpoint.");
+            }
+            return undefined;
+        }
+        this.#configuredIssuer = issuer;
+        const configured = { ...this.#configuredClientInformation, issuer };
+        this.#clientInformation.set(issuer, configured);
+        return configured;
+    }
+    saveClientInformation(clientInformation, context) {
+        const issuer = context?.issuer ?? clientInformation.issuer;
+        if (issuer === undefined) {
+            throw new Error("MCP OAuth client information is missing its authorization-server issuer.");
+        }
+        this.#activeIssuer = issuer;
+        this.#clientInformation.set(issuer, { ...clientInformation, issuer });
+    }
+    tokens(context) {
+        if (context === undefined) {
+            this.#presentedToken = this.#currentTokens !== undefined;
+            return this.#currentTokens;
+        }
+        this.#activeIssuer = context.issuer;
+        return this.#tokens.get(context.issuer);
+    }
+    saveTokens(tokens, context) {
+        const issuer = context?.issuer ?? tokens.issuer;
+        if (issuer === undefined) {
+            throw new Error("MCP OAuth tokens are missing their authorization-server issuer.");
+        }
+        const stored = { ...tokens, issuer };
+        this.#activeIssuer = issuer;
+        this.#currentTokens = stored;
+        this.#presentedToken = false;
+        this.#awaitingAuthorizationCallback = false;
+        this.#tokens.set(issuer, stored);
+    }
+    redirectToAuthorization(authorizationUrl) {
+        this.#awaitingAuthorizationCallback = true;
+        this.#authorizationUrl = authorizationUrl;
+    }
+    takeAuthorizationUrl() {
+        const authorizationUrl = this.#authorizationUrl;
+        this.#authorizationUrl = undefined;
+        return authorizationUrl;
+    }
+    assertCallbackState(callback) {
+        if (this.#state === undefined || callback.searchParams.get("state") !== this.#state) {
+            throw new Error("OAuth callback state does not match the pending authorization request.");
+        }
+    }
+    saveCodeVerifier(codeVerifier) {
+        this.#codeVerifier = codeVerifier;
+    }
+    codeVerifier() {
+        if (this.#codeVerifier === undefined) {
+            throw new Error("OAuth authorization has no pending PKCE verifier.");
+        }
+        return this.#codeVerifier;
+    }
+    saveDiscoveryState(state) {
+        if (state.authorizationServerMetadata === undefined) {
+            throw new Error("MCP OAuth requires validated authorization-server metadata; "
+                + "legacy endpoint inference is not supported.");
+        }
+        this.#discoveryState = state;
+    }
+    discoveryState() {
+        if (!this.#awaitingAuthorizationCallback && this.#presentedToken) {
+            this.#presentedToken = false;
+            this.#discoveryState = undefined;
+        }
+        return this.#discoveryState;
+    }
+    invalidateCredentials(scope) {
+        if ((scope === "all" || scope === "client") && this.#activeIssuer !== undefined) {
+            this.#clientInformation.delete(this.#activeIssuer);
+        }
+        if (scope === "all" || scope === "tokens") {
+            if (this.#activeIssuer !== undefined)
+                this.#tokens.delete(this.#activeIssuer);
+            this.#currentTokens = undefined;
+            this.#presentedToken = false;
+        }
+        if (scope === "all" || scope === "verifier") {
+            this.#codeVerifier = undefined;
+            this.#awaitingAuthorizationCallback = false;
+        }
+        if (scope === "all" || scope === "discovery")
+            this.#discoveryState = undefined;
+    }
+}
+//# sourceMappingURL=oauth.js.map

package/dist/oauth.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,8 @@
+export declare const MCP_PROTOCOL_VERSION = "2026-07-28";
+export declare const MCP_SPECIFICATION_COMMIT = "5f5440bb26a62e2cf3440b92da5a667efa03b267";
+export declare const MCP_TASKS_EXTENSION_ID = "io.modelcontextprotocol/tasks";
+export declare const MCP_OAUTH_CLIENT_CREDENTIALS_EXTENSION_ID = "io.modelcontextprotocol/oauth-client-credentials";
+export declare const MCP_TASKS_SPECIFICATION_COMMIT = "2c1425d9a288b9b1f489430fe1e00bb392b47e48";
+export declare const MCP_CLIENT_VERSION = "2.0.0";
+export declare const MCP_CONFORMANCE_VERSION = "0.2.0-alpha.11";
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,eAAO,MAAM,wBAAwB,6CAA6C,CAAC;AACnF,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AACtE,eAAO,MAAM,yCAAyC,qDAAqD,CAAC;AAC5G,eAAO,MAAM,8BAA8B,6CAA6C,CAAC;AACzF,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAC1C,eAAO,MAAM,uBAAuB,mBAAmB,CAAC"}

package/dist/protocol.js

@@ -0,0 +1,8 @@
+export const MCP_PROTOCOL_VERSION = "2026-07-28";
+export const MCP_SPECIFICATION_COMMIT = "5f5440bb26a62e2cf3440b92da5a667efa03b267";
+export const MCP_TASKS_EXTENSION_ID = "io.modelcontextprotocol/tasks";
+export const MCP_OAUTH_CLIENT_CREDENTIALS_EXTENSION_ID = "io.modelcontextprotocol/oauth-client-credentials";
+export const MCP_TASKS_SPECIFICATION_COMMIT = "2c1425d9a288b9b1f489430fe1e00bb392b47e48";
+export const MCP_CLIENT_VERSION = "2.0.0";
+export const MCP_CONFORMANCE_VERSION = "0.2.0-alpha.11";
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,0CAA0C,CAAC;AACnF,MAAM,CAAC,MAAM,sBAAsB,GAAG,+BAA+B,CAAC;AACtE,MAAM,CAAC,MAAM,yCAAyC,GAAG,kDAAkD,CAAC;AAC5G,MAAM,CAAC,MAAM,8BAA8B,GAAG,0CAA0C,CAAC;AACzF,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAC1C,MAAM,CAAC,MAAM,uBAAuB,GAAG,gBAAgB,CAAC"}

package/dist/protocolHeaders.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from "@modelcontextprotocol/client";
+export declare const mcpRoutingHeaderValue: (value: string) => string;
+export declare const mcpParamHeaders: (tool: Tool, args: Record<string, unknown>) => Readonly<Record<string, string>>;
+//# sourceMappingURL=protocolHeaders.d.ts.map

package/dist/protocolHeaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocolHeaders.d.ts","sourceRoot":"","sources":["../src/protocolHeaders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAoBzD,eAAO,MAAM,qBAAqB,UAAW,MAAM,KAAG,MAE3C,CAAC;AA8DZ,eAAO,MAAM,eAAe,SAClB,IAAI,QACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASjC,CAAC"}

package/dist/protocolHeaders.js

@@ -0,0 +1,87 @@
+const BASE64_PREFIX = "=?base64?";
+const BASE64_SUFFIX = "?=";
+const RFC9110_TOKEN = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/;
+const HEADER_TYPES = new Set(["string", "integer", "number", "boolean"]);
+const requiresEncoding = (value) => {
+    if (value.length === 0 || value !== value.trim())
+        return true;
+    if (value.startsWith(BASE64_PREFIX) && value.endsWith(BASE64_SUFFIX))
+        return true;
+    for (let index = 0; index < value.length; index += 1) {
+        const codePoint = value.codePointAt(index);
+        if (codePoint === 9 || (codePoint !== undefined && codePoint >= 32 && codePoint <= 126)) {
+            continue;
+        }
+        return true;
+    }
+    return false;
+};
+export const mcpRoutingHeaderValue = (value) => requiresEncoding(value)
+    ? `${BASE64_PREFIX}${Buffer.from(value, "utf8").toString("base64")}${BASE64_SUFFIX}`
+    : value;
+const headerDeclarations = (tool) => {
+    const declarations = [];
+    const seen = new Set();
+    const visit = (schema, path) => {
+        if (schema === null || typeof schema !== "object" || Array.isArray(schema))
+            return;
+        const node = schema;
+        const header = node["x-mcp-header"];
+        if (header !== undefined) {
+            if (path.length === 0
+                || typeof header !== "string"
+                || !RFC9110_TOKEN.test(header)
+                || typeof node.type !== "string"
+                || !HEADER_TYPES.has(node.type)) {
+                throw new Error(`MCP tool '${tool.name}' has an invalid x-mcp-header declaration.`);
+            }
+            const folded = header.toLowerCase();
+            if (seen.has(folded)) {
+                throw new Error(`MCP tool '${tool.name}' repeats x-mcp-header '${header}'.`);
+            }
+            seen.add(folded);
+            declarations.push({ name: header, path, type: node.type });
+        }
+        const properties = node.properties;
+        if (properties === null || typeof properties !== "object" || Array.isArray(properties))
+            return;
+        for (const [name, child] of Object.entries(properties)) {
+            visit(child, [...path, name]);
+        }
+    };
+    visit(tool.inputSchema, []);
+    return declarations;
+};
+const valueAt = (root, path) => {
+    let value = root;
+    for (const segment of path) {
+        if (value === null || typeof value !== "object" || Array.isArray(value))
+            return undefined;
+        value = value[segment];
+    }
+    return value;
+};
+const primitiveHeaderValue = (value, type) => {
+    if (type === "string")
+        return typeof value === "string" ? value : undefined;
+    if (type === "boolean")
+        return typeof value === "boolean" ? String(value) : undefined;
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return undefined;
+    if (Number.isInteger(value) && !Number.isSafeInteger(value))
+        return undefined;
+    if (type === "integer" && (!Number.isSafeInteger(value) || !Number.isInteger(value))) {
+        return undefined;
+    }
+    return String(value);
+};
+export const mcpParamHeaders = (tool, args) => Object.fromEntries(headerDeclarations(tool).flatMap((declaration) => {
+    const value = valueAt(args, declaration.path);
+    if (value === undefined || value === null)
+        return [];
+    const primitive = primitiveHeaderValue(value, declaration.type);
+    return primitive === undefined
+        ? []
+        : [[`Mcp-Param-${declaration.name}`, mcpRoutingHeaderValue(primitive)]];
+}));
+//# sourceMappingURL=protocolHeaders.js.map

package/dist/protocolHeaders.js.map

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

package/dist/subscriptions.d.ts

@@ -0,0 +1,15 @@
+import { type Client } from "@modelcontextprotocol/client";
+export interface SubscriptionOptions {
+    readonly timeout: number;
+    readonly tasks?: boolean;
+    readonly onError?: (error: Error) => void;
+}
+/** Owns the one current modern subscription filter for a server connection. */
+export default class Subscriptions {
+    #private;
+    constructor(client: Client, options: SubscriptionOptions);
+    selectTask(taskId: string): Promise<() => Promise<void>>;
+    selectResource(uri: string): Promise<void>;
+    retire(): Promise<void>;
+}
+//# sourceMappingURL=subscriptions.d.ts.map

package/dist/subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../src/subscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,MAAM,EAGd,MAAM,8BAA8B,CAAC;AAKtC,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC7C;AAuCD,+EAA+E;AAC/E,MAAM,CAAC,OAAO,OAAO,aAAa;;IAY9B,YAAY,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EASvD;IAEK,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAuB7D;IAWK,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/C;IAyFD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAOtB;CACJ"}

package/dist/subscriptions.js

@@ -0,0 +1,188 @@
+const RETRY_FLOOR_MS = 250;
+const RETRY_CEILING_MS = 5_000;
+const asError = (cause) => cause instanceof Error
+    ? cause
+    : new Error(String(cause));
+const filterFor = (client, resources, tasks, tasksEnabled) => {
+    const capabilities = client.getDiscoverResult()?.capabilities;
+    return {
+        ...(capabilities?.tools?.listChanged === true
+            ? { toolsListChanged: true }
+            : {}),
+        ...(capabilities?.prompts?.listChanged === true
+            ? { promptsListChanged: true }
+            : {}),
+        ...(capabilities?.resources?.listChanged === true
+            ? { resourcesListChanged: true }
+            : {}),
+        ...(capabilities?.resources?.subscribe === true && resources.size > 0
+            ? { resourceSubscriptions: [...resources].toSorted() }
+            : {}),
+        ...(tasksEnabled && tasks.size > 0
+            ? { taskIds: [...tasks.keys()].toSorted() }
+            : {}),
+    };
+};
+const hasSelections = (filter) => Object.keys(filter).length > 0;
+/** Owns the one current modern subscription filter for a server connection. */
+export default class Subscriptions {
+    #client;
+    #options;
+    #resources = new Set();
+    #tasks = new Map();
+    #current;
+    #work = Promise.resolve();
+    #retryTimer;
+    #retryAttempt = 0;
+    #listenAbort;
+    #closed = false;
+    constructor(client, options) {
+        this.#client = client;
+        this.#options = options;
+        this.#current = client.autoOpenedSubscription;
+        if (this.#current === undefined) {
+            if (hasSelections(this.#filter()))
+                this.#scheduleRetry();
+        }
+        else {
+            this.#observe(this.#current);
+        }
+    }
+    async selectTask(taskId) {
+        if (this.#closed)
+            throw new Error("MCP subscriptions are closed.");
+        if (this.#options.tasks !== true)
+            return async () => undefined;
+        const count = this.#tasks.get(taskId) ?? 0;
+        this.#tasks.set(taskId, count + 1);
+        if (count === 0) {
+            this.#clearRetry();
+            await this.#enqueueReplacement();
+        }
+        let released = false;
+        return async () => {
+            if (released || this.#closed)
+                return;
+            released = true;
+            const current = this.#tasks.get(taskId);
+            if (current === undefined)
+                return;
+            if (current > 1) {
+                this.#tasks.set(taskId, current - 1);
+                return;
+            }
+            this.#tasks.delete(taskId);
+            this.#clearRetry();
+            await this.#enqueueReplacement();
+        };
+    }
+    #filter() {
+        return filterFor(this.#client, this.#resources, this.#tasks, this.#options.tasks === true);
+    }
+    async selectResource(uri) {
+        if (this.#closed)
+            throw new Error("MCP subscriptions are closed.");
+        if (this.#client.getDiscoverResult()?.capabilities.resources?.subscribe !== true)
+            return;
+        if (this.#resources.has(uri))
+            return;
+        this.#resources.add(uri);
+        this.#clearRetry();
+        await this.#enqueueReplacement();
+    }
+    #enqueueReplacement() {
+        const replacement = this.#work.then(() => this.#replace());
+        this.#work = replacement.catch(() => undefined);
+        return replacement;
+    }
+    async #replace() {
+        if (this.#closed)
+            return;
+        const filter = this.#filter();
+        if (!hasSelections(filter)) {
+            const prior = this.#current;
+            this.#current = undefined;
+            if (prior !== undefined)
+                await prior.close();
+            return;
+        }
+        const prior = this.#current;
+        const controller = new AbortController();
+        this.#listenAbort = controller;
+        let next;
+        try {
+            next = await this.#client.listen(filter, {
+                timeout: this.#options.timeout,
+                signal: controller.signal,
+            });
+        }
+        catch (cause) {
+            if (!this.#closed && !controller.signal.aborted) {
+                this.#report(cause);
+                this.#scheduleRetry();
+            }
+            return;
+        }
+        finally {
+            if (this.#listenAbort === controller)
+                this.#listenAbort = undefined;
+        }
+        if (this.#closed)
+            return;
+        this.#clearRetry();
+        this.#retryAttempt = 0;
+        this.#current = next;
+        this.#observe(next);
+        if (prior !== undefined && prior !== next) {
+            try {
+                await prior.close();
+            }
+            catch (cause) {
+                this.#report(cause);
+            }
+        }
+    }
+    #observe(subscription) {
+        void subscription.closed.then((reason) => {
+            if (this.#closed
+                || reason === "local"
+                || this.#current !== subscription)
+                return;
+            this.#current = undefined;
+            this.#scheduleRetry();
+        });
+    }
+    #scheduleRetry() {
+        if (this.#closed || this.#retryTimer !== undefined)
+            return;
+        const delay = Math.min(RETRY_FLOOR_MS * (2 ** this.#retryAttempt), RETRY_CEILING_MS);
+        this.#retryAttempt += 1;
+        this.#retryTimer = setTimeout(() => {
+            this.#retryTimer = undefined;
+            void this.#enqueueReplacement().catch((cause) => {
+                if (!this.#closed)
+                    this.#report(cause);
+            });
+        }, delay);
+        this.#retryTimer.unref();
+    }
+    #clearRetry() {
+        if (this.#retryTimer === undefined)
+            return;
+        clearTimeout(this.#retryTimer);
+        this.#retryTimer = undefined;
+    }
+    #report(cause) {
+        this.#options.onError?.(asError(cause));
+    }
+    retire() {
+        if (this.#closed)
+            return this.#work;
+        this.#closed = true;
+        this.#clearRetry();
+        this.#listenAbort = undefined;
+        this.#current = undefined;
+        return this.#work;
+    }
+}
+//# sourceMappingURL=subscriptions.js.map

package/dist/subscriptions.js.map

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

package/dist/tasks.d.ts

@@ -0,0 +1,19 @@
+import { type CallToolResult, type Progress, type Tool } from "@modelcontextprotocol/client";
+import ExtensionChannel from "./extensionChannel.ts";
+import { type ClientInteractionHandler } from "./inputRequired.ts";
+import Subscriptions from "./subscriptions.ts";
+export interface TaskCallOptions {
+    readonly server: string;
+    readonly name: string;
+    readonly args: Record<string, unknown>;
+    readonly tool: Tool;
+    readonly signal?: AbortSignal;
+    readonly onProgress?: (progress: Progress) => void;
+    readonly interact?: ClientInteractionHandler;
+    readonly timeout: number;
+    readonly channel: ExtensionChannel;
+    readonly subscriptions: Subscriptions;
+}
+export declare const serverSupportsTasks: (capabilities: unknown) => boolean;
+export declare const callToolWithTasks: (options: TaskCallOptions) => Promise<CallToolResult>;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../src/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAQH,KAAK,cAAc,EAGnB,KAAK,QAAQ,EACb,KAAK,IAAI,EACZ,MAAM,8BAA8B,CAAC;AAEtC,OAAO,gBAAgB,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAGH,KAAK,wBAAwB,EAChC,MAAM,oBAAoB,CAAC;AAG5B,OAAO,aAAa,MAAM,oBAAoB,CAAC;AA0C/C,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;CACzC;AAgZD,eAAO,MAAM,mBAAmB,iBAAkB,OAAO,KAAG,OAG3D,CAAC;AAEF,eAAO,MAAM,iBAAiB,YAAmB,eAAe,KAAG,OAAO,CAAC,cAAc,CA2BxF,CAAC"}