@mcp-use/client 0.0.0-bootstrap.0 → 2.0.0-beta.0

package/dist/transport/base.d.ts

@@ -0,0 +1,505 @@
+import type { CallToolResult, Client, ClientOptions, CompleteRequestParams, CompleteResult, ElicitRequestFormParams, ElicitRequestURLParams, ElicitResult, AuthProvider, Notification, OAuthClientProvider, ProtocolEra, RequestOptions, Root, Tool } from "@modelcontextprotocol/client";
+import type { SamplingCreateMessageParams, SamplingCreateMessageResult } from "../core/config.js";
+import type { ConnectionManager } from "./connection-manager.js";
+import type { ConnectorInitEventData } from "../telemetry/events.js";
+import type { MCPServerInfo } from "../core/session.js";
+/**
+ * Handler function for server notifications
+ */
+export type NotificationHandler = (notification: Notification) => void | Promise<void>;
+export interface ConnectorInitOptions {
+    /**
+     * Options forwarded to the underlying MCP `Client` instance.
+     *
+     * By default, all connectors (HTTP and stdio) use `DialectJsonSchemaValidator`
+     * to support common `$schema` dialects (draft-04, draft-07, 2019-09, 2020-12)
+     * for cross-version compatibility with v1-era servers. Override with
+     * `clientOptions.jsonSchemaValidator` if stricter validation is needed.
+     */
+    clientOptions?: ClientOptions;
+    /**
+     * Arbitrary request options (timeouts, cancellation, etc.) used by helper
+     * methods when they issue SDK requests. Can be overridden per‑call.
+     */
+    defaultRequestOptions?: RequestOptions;
+    /**
+     * OAuth client provider for automatic authentication
+     */
+    authProvider?: AuthProvider | OAuthClientProvider;
+    /**
+     * Optional callback to wrap the transport before passing it to the Client.
+     * Useful for logging, monitoring, or other transport-level interceptors.
+     */
+    wrapTransport?: (transport: any, serverId: string) => any;
+    /**
+     * Initial roots to provide to the server.
+     * Roots allow the server to know which directories/files the client has access to.
+     */
+    roots?: Root[];
+    /**
+     * Optional callback function to handle sampling requests from servers.
+     * When provided, the client will declare sampling capability and handle
+     * `sampling/createMessage` requests by calling this callback.
+     *
+     * @deprecated Sampling is deprecated by the 2026 protocol. Retained for v1
+     * push requests and v2 multi-round-trip compatibility.
+     */
+    onSampling?: (params: SamplingCreateMessageParams) => Promise<SamplingCreateMessageResult>;
+    /**
+     * Optional callback function to handle elicitation requests from servers.
+     * When provided, the client will declare elicitation capability and handle
+     * `elicitation/create` requests by calling this callback.
+     *
+     * Elicitation allows servers to request additional information from users:
+     * - Form mode: Collect structured data with JSON schema validation
+     * - URL mode: Direct users to external URLs for sensitive interactions
+     */
+    onElicitation?: (params: ElicitRequestFormParams | ElicitRequestURLParams) => Promise<ElicitResult>;
+    /**
+     * Optional callback for server notifications.
+     * When provided, registered as initial notification handler.
+     */
+    onNotification?: NotificationHandler;
+    /**
+     * Reconnection options for streamable HTTP transport.
+     * Controls retry behavior of the underlying `StreamableHTTPClientTransport`.
+     */
+    reconnectionOptions?: {
+        maxReconnectionDelay?: number;
+        initialReconnectionDelay?: number;
+        reconnectionDelayGrowFactor?: number;
+        maxRetries?: number;
+    };
+}
+/**
+ * Base class for MCP connectors.
+ */
+export declare abstract class BaseConnector {
+    protected client: Client | null;
+    protected connectionManager: ConnectionManager<any> | null;
+    protected toolsCache: Tool[] | null;
+    protected capabilitiesCache: Record<string, unknown> | null;
+    protected serverInfoCache: MCPServerInfo | null;
+    protected connected: boolean;
+    protected readonly opts: ConnectorInitOptions;
+    protected notificationHandlers: NotificationHandler[];
+    protected rootsCache: Root[];
+    private activeProgressHandlers;
+    constructor(opts?: ConnectorInitOptions);
+    /**
+     * Track connector initialization event
+     * Should be called by subclasses after successful connection
+     */
+    protected trackConnectorInit(data: Omit<ConnectorInitEventData, "connectorType">): void;
+    /**
+     * Register a handler for server notifications
+     *
+     * @param handler - Function to call when a notification is received
+     *
+     * @example
+     * ```typescript
+     * connector.onNotification((notification) => {
+     *   console.log(`Received: ${notification.method}`, notification.params);
+     * });
+     * ```
+     */
+    onNotification(handler: NotificationHandler): void;
+    /** Forward a normalized notification to every registered consumer. */
+    protected forwardNotification(notification: Notification): Promise<void>;
+    /** Handle SDK list-change callbacks identically on v1 and v2 connections. */
+    protected handleListChanged(method: "notifications/tools/list_changed" | "notifications/resources/list_changed" | "notifications/prompts/list_changed", error: Error | null, tools?: Tool[] | null): Promise<void>;
+    /**
+     * Internal: wire notification handlers to the SDK client
+     * Includes automatic handling for list_changed notifications per MCP spec
+     */
+    protected setupNotificationHandler(): void;
+    /**
+     * Forward v2 MRTR progress whose retry request IDs are not associated with
+     * the original call callback by the current SDK beta.
+     *
+     * ponytail: fallback is enabled only when exactly one progress-aware call is
+     * active; remove it when the upstream SDK propagates handlers to MRTR rounds.
+     */
+    protected setupRoundProgressForwarding(): void;
+    /** Forward progress parsed from a transport stream to the active call. */
+    protected forwardRoundProgress(params: unknown): void;
+    /**
+     * Auto-refresh tools cache when server sends tools/list_changed notification
+     */
+    protected refreshToolsCache(): Promise<void>;
+    /**
+     * Called when server sends resources/list_changed notification
+     * Resources aren't cached by default, but we log for user awareness
+     */
+    protected onResourcesListChanged(): Promise<void>;
+    /**
+     * Called when server sends prompts/list_changed notification
+     * Prompts aren't cached by default, but we log for user awareness
+     */
+    protected onPromptsListChanged(): Promise<void>;
+    /**
+     * Set roots and notify the server.
+     * Roots represent directories or files that the client has access to.
+     *
+     * @param roots - Array of Root objects with `uri` (must start with "file://") and optional `name`
+     *
+     * @deprecated Roots are retained only for v1 compatibility.
+     *
+     * @example
+     * ```typescript
+     * await connector.setRoots([
+     *   { uri: "file:///home/user/project", name: "My Project" },
+     *   { uri: "file:///home/user/data" }
+     * ]);
+     * ```
+     */
+    setRoots(roots: Root[]): Promise<void>;
+    /**
+     * Get the current roots.
+     */
+    getRoots(): Root[];
+    /**
+     * Internal: set up roots/list request handler.
+     * Must be registered after Client construction and before connect() so the
+     * handler is available during initialize / reverse RPC for the full session.
+     */
+    protected setupRootsHandler(): void;
+    /**
+     * Internal: set up sampling/createMessage request handler.
+     * Must be registered after Client construction and before connect().
+     */
+    protected setupSamplingHandler(): void;
+    /**
+     * Internal: set up elicitation/create request handler.
+     * Must be registered after Client construction and before connect().
+     */
+    protected setupElicitationHandler(): void;
+    /** Establish the connection and create the SDK client. */
+    abstract connect(): Promise<void>;
+    /** Get the identifier for the connector. */
+    abstract get publicIdentifier(): Record<string, string>;
+    /** Disconnect and release resources. */
+    disconnect(): Promise<void>;
+    /** Check if the client is connected */
+    get isClientConnected(): boolean;
+    /**
+     * Initialise the MCP session **after** `connect()` has succeeded.
+     *
+     * In the SDK, `Client.connect(transport)` automatically performs the
+     * protocol‑level `initialize` handshake, so we only need to cache the list of
+     * tools and expose some server info.
+     */
+    initialize(defaultRequestOptions?: RequestOptions): Promise<ReturnType<Client["getServerCapabilities"]>>;
+    /** Lazily expose the cached tools list. */
+    get tools(): Tool[];
+    /** Expose cached server capabilities. */
+    get serverCapabilities(): Record<string, unknown>;
+    /** Expose cached server info. */
+    get serverInfo(): MCPServerInfo | null;
+    /** Instructions supplied by the connected server, if any. */
+    get instructions(): string | undefined;
+    /**
+     * The negotiated protocol era for the active connection.
+     * - `"legacy"` — 2025-era server, sessionful `initialize` handshake.
+     * - `"modern"` — 2026-era server, stateless per-request.
+     * `undefined` before the connection has negotiated.
+     */
+    get protocolEra(): ProtocolEra | undefined;
+    /** The protocol version string negotiated for the active connection. */
+    get negotiatedProtocolVersion(): string | undefined;
+    /** Call a tool on the server. */
+    callTool(name: string, args: Record<string, any>, options?: RequestOptions): Promise<CallToolResult>;
+    /**
+     * List all available tools from the MCP server.
+     * This method fetches fresh tools from the server, unlike the `tools` getter which returns cached tools.
+     *
+     * @param options - Optional request options
+     * @returns Array of available tools
+     */
+    listTools(options?: RequestOptions): Promise<Tool[]>;
+    /**
+     * List resources from the server with optional pagination
+     *
+     * @param cursor - Optional cursor for pagination
+     * @param options - Request options
+     * @returns Resource list with optional nextCursor for pagination
+     */
+    listResources(cursor?: string, options?: RequestOptions): Promise<{
+        [x: string]: unknown;
+        resources: {
+            uri: string;
+            name: string;
+            description?: string | undefined;
+            mimeType?: string | undefined;
+            size?: number | undefined;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        }[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        nextCursor?: string | undefined;
+    }>;
+    /**
+     * List all resources from the server, automatically handling pagination
+     *
+     * @param options - Request options
+     * @returns Complete list of all resources
+     */
+    listAllResources(options?: RequestOptions): Promise<{
+        resources: any[];
+    }>;
+    /**
+     * List resource templates from the server
+     *
+     * @param options - Request options
+     * @returns List of available resource templates
+     */
+    listResourceTemplates(options?: RequestOptions): Promise<{
+        [x: string]: unknown;
+        resourceTemplates: {
+            uriTemplate: string;
+            name: string;
+            description?: string | undefined;
+            mimeType?: string | undefined;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        }[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        nextCursor?: string | undefined;
+    }>;
+    /**
+     * Request completion suggestions for a prompt or resource template argument
+     *
+     * @param params - Completion request parameters
+     * @param options - Request options
+     * @returns Completion suggestions from the server
+     */
+    complete(params: CompleteRequestParams, options?: RequestOptions): Promise<CompleteResult>;
+    /** Read a resource by URI. */
+    readResource(uri: string, options?: RequestOptions): Promise<{
+        [x: string]: unknown;
+        contents: ({
+            uri: string;
+            text: string;
+            mimeType?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            uri: string;
+            blob: string;
+            mimeType?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    }>;
+    /**
+     * Subscribe to resource updates
+     *
+     * @param uri - URI of the resource to subscribe to
+     * @param options - Request options
+     */
+    subscribeToResource(uri: string, options?: RequestOptions): Promise<{
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    }>;
+    /**
+     * Unsubscribe from resource updates
+     *
+     * @param uri - URI of the resource to unsubscribe from
+     * @param options - Request options
+     */
+    unsubscribeFromResource(uri: string, options?: RequestOptions): Promise<{
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    }>;
+    listPrompts(): Promise<{
+        [x: string]: unknown;
+        prompts: {
+            name: string;
+            description?: string | undefined;
+            arguments?: {
+                name: string;
+                description?: string | undefined;
+                required?: boolean | undefined;
+            }[] | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        }[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        nextCursor?: string | undefined;
+    }>;
+    getPrompt(name: string, args: Record<string, any>): Promise<{
+        [x: string]: unknown;
+        messages: {
+            role: "user" | "assistant";
+            content: {
+                type: "text";
+                text: string;
+                annotations?: {
+                    audience?: ("user" | "assistant")[] | undefined;
+                    priority?: number | undefined;
+                    lastModified?: string | undefined;
+                } | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                type: "image";
+                data: string;
+                mimeType: string;
+                annotations?: {
+                    audience?: ("user" | "assistant")[] | undefined;
+                    priority?: number | undefined;
+                    lastModified?: string | undefined;
+                } | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                type: "audio";
+                data: string;
+                mimeType: string;
+                annotations?: {
+                    audience?: ("user" | "assistant")[] | undefined;
+                    priority?: number | undefined;
+                    lastModified?: string | undefined;
+                } | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                uri: string;
+                name: string;
+                type: "resource_link";
+                description?: string | undefined;
+                mimeType?: string | undefined;
+                size?: number | undefined;
+                annotations?: {
+                    audience?: ("user" | "assistant")[] | undefined;
+                    priority?: number | undefined;
+                    lastModified?: string | undefined;
+                } | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                icons?: {
+                    src: string;
+                    mimeType?: string | undefined;
+                    sizes?: string[] | undefined;
+                    theme?: "light" | "dark" | undefined;
+                }[] | undefined;
+                title?: string | undefined;
+            } | {
+                type: "resource";
+                resource: {
+                    uri: string;
+                    text: string;
+                    mimeType?: string | undefined;
+                    _meta?: {
+                        [x: string]: unknown;
+                    } | undefined;
+                } | {
+                    uri: string;
+                    blob: string;
+                    mimeType?: string | undefined;
+                    _meta?: {
+                        [x: string]: unknown;
+                    } | undefined;
+                };
+                annotations?: {
+                    audience?: ("user" | "assistant")[] | undefined;
+                    priority?: number | undefined;
+                    lastModified?: string | undefined;
+                } | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            };
+        }[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        description?: string | undefined;
+    }>;
+    /** Send a raw request through the client. */
+    request(method: string, params?: Record<string, any> | null, options?: RequestOptions): Promise<unknown>;
+    /**
+     * Helper to tear down the client & connection manager safely.
+     */
+    protected cleanupResources(): Promise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

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

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

package/dist/transport/connection-manager.d.ts

@@ -0,0 +1,55 @@
+export declare abstract class ConnectionManager<T = any> {
+    private _readyPromise;
+    private _readyResolver;
+    private _donePromise;
+    private _doneResolver;
+    private _exception;
+    private _connection;
+    private _task;
+    private _abortController;
+    constructor();
+    /**
+     * Establish the connection.
+     *
+     * This method should be implemented by subclasses to establish the specific
+     * type of connection needed.
+     *
+     * @returns The established connection.
+     * @throws If the connection cannot be established.
+     */
+    protected abstract establishConnection(): Promise<T>;
+    /**
+     * Close the connection.
+     *
+     * This method should be implemented by subclasses to close the specific type
+     * of connection.
+     *
+     * @param connection The connection to close.
+     */
+    protected abstract closeConnection(connection: T): Promise<void>;
+    /**
+     * Start the connection manager and establish a connection.
+     *
+     * @returns The established connection.
+     * @throws If the connection cannot be established.
+     */
+    start(): Promise<T>;
+    /**
+     * Stop the connection manager and close the connection.
+     */
+    stop(): Promise<void>;
+    /**
+     * Reset all internal state.
+     */
+    private reset;
+    /**
+     * The background task responsible for establishing and maintaining the
+     * connection until it is cancelled.
+     */
+    private connectionTask;
+    /**
+     * Helper that returns a promise which resolves when the abort signal fires.
+     */
+    private waitForAbort;
+}
+//# sourceMappingURL=connection-manager.d.ts.map

package/dist/transport/connection-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-manager.d.ts","sourceRoot":"","sources":["../../src/transport/connection-manager.ts"],"names":[],"mappings":"AAEA,8BAAsB,iBAAiB,CAAC,CAAC,GAAG,GAAG;IAC7C,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,cAAc,CAAc;IAEpC,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,aAAa,CAAc;IAEnC,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,gBAAgB,CAAgC;;IAMxD;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,CAAC,mBAAmB,IAAI,OAAO,CAAC,CAAC,CAAC;IAEpD;;;;;;;OAOG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,UAAU,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAEhE;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC;IAwBzB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB3B;;OAEG;IACH,OAAO,CAAC,KAAK;IASb;;;OAGG;YACW,cAAc;IAqC5B;;OAEG;YACW,YAAY;CAqB3B"}

package/dist/transport/http.d.ts

@@ -0,0 +1,74 @@
+import { type VersionNegotiationMode } from "@modelcontextprotocol/client";
+import type { ConnectorInitOptions } from "./base.js";
+import { BaseConnector } from "./base.js";
+export type ClientInfo = {
+    name: string;
+    title?: string;
+    version: string;
+    description?: string;
+    icons?: Array<{
+        src: string;
+        mimeType?: string;
+        sizes?: string[];
+    }>;
+    websiteUrl?: string;
+};
+interface HttpConnectorOptions extends ConnectorInitOptions {
+    authToken?: string;
+    fetch?: typeof fetch;
+    headers?: Record<string, string>;
+    timeout?: number;
+    clientInfo?: ClientInfo;
+    /**
+     * Protocol version negotiation mode passed to the SDK `Client`.
+     * - `"legacy"` (default): classic 2025 `initialize` handshake, no probe —
+     *   matches the SDK's own default. Still connects to both v1 and v2 servers
+     *   (v2 servers serve 2025-era traffic).
+     * - `"auto"`: probe with `server/discover`, falling back to the 2025
+     *   handshake against legacy servers. Opt-in: the probe performs OAuth
+     *   discovery on auth-required servers and can fail on servers whose
+     *   authorization-server issuer differs from the server URL (RFC 8414 §3.3),
+     *   which would otherwise mask the normal 401 → auth flow.
+     * - `{ pin: "2026-07-28" }`: modern era only, no fallback.
+     */
+    protocolNegotiation?: VersionNegotiationMode;
+    gatewayUrl?: string;
+    serverId?: string;
+    reconnectionOptions?: {
+        maxReconnectionDelay?: number;
+        initialReconnectionDelay?: number;
+        reconnectionDelayGrowFactor?: number;
+        maxRetries?: number;
+    };
+}
+export declare class HttpConnector extends BaseConnector {
+    private readonly baseUrl;
+    private readonly headers;
+    private readonly timeout;
+    private readonly customFetch?;
+    private readonly clientInfo;
+    private readonly protocolNegotiation;
+    private readonly gatewayUrl?;
+    private readonly serverId?;
+    private readonly reconnectionOptions?;
+    private transportType;
+    private streamableTransport;
+    constructor(baseUrl: string, opts?: HttpConnectorOptions);
+    private buildClientOptions;
+    private unwrapStreamableError;
+    private classifyStreamableHttpFailure;
+    /** Establish connection to the MCP implementation via streamable HTTP. */
+    connect(): Promise<void>;
+    /**
+     * Tee an SSE response so v2 MRTR progress can be correlated even when the
+     * upstream SDK does not carry the original callback to retry request IDs.
+     */
+    private observeSseProgress;
+    private connectWithStreamableHttp;
+    get publicIdentifier(): Record<string, string>;
+    /** Get the active transport type (`streamable-http` once connected). */
+    getTransportType(): "streamable-http" | null;
+    protected cleanupResources(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transport/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,sBAAsB,EAC5B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAsB1C,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,UAAU,oBAAqB,SAAQ,oBAAoB;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,EAAE,sBAAsB,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE;QACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,2BAA2B,CAAC,EAAE,MAAM,CAAC;QACrC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAmDD,qBAAa,aAAc,SAAQ,aAAa;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAyB;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAA8C;IACnF,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,mBAAmB,CAA8C;gBAE7D,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,oBAAyB;IAmC5D,OAAO,CAAC,kBAAkB;IAqD1B,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,6BAA6B;IA0DrC,0EAA0E;IACpE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC9B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;YAmDZ,yBAAyB;IAuNvC,IAAI,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO7C;IAED,wEAAwE;IACxE,gBAAgB,IAAI,iBAAiB,GAAG,IAAI;cAQ5B,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;CA8BlD"}