mcp-use 1.0.6 → 1.1.0

package/dist/{chunk-CWWNPIJZ.js → chunk-56ZYVEAJ.js}

@@ -8,17 +8,17 @@ import {
 // src/react/useMcp.ts
 import {
   CallToolResultSchema,
-  ListToolsResultSchema,
-  ListResourcesResultSchema,
-  ReadResourceResultSchema,
+  GetPromptResultSchema,
   ListPromptsResultSchema,
-  GetPromptResultSchema
+  ListResourcesResultSchema,
+  ListToolsResultSchema,
+  ReadResourceResultSchema
 } from "@modelcontextprotocol/sdk/types.js";
 import { useCallback, useEffect, useRef, useState } from "react";
+import { auth, UnauthorizedError } from "@modelcontextprotocol/sdk/client/auth.js";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { auth, UnauthorizedError } from "@modelcontextprotocol/sdk/client/auth.js";
 import { sanitizeUrl } from "strict-url-sanitise";
 
 // src/utils/assert.ts
@@ -48,7 +48,11 @@ function useMcp(options) {
     autoReconnect = DEFAULT_RECONNECT_DELAY,
     transportType = "auto",
     preventAutoAuth = false,
-    onPopupWindow
+    onPopupWindow,
+    timeout = 3e4,
+    // 30 seconds default for connection timeout
+    sseReadTimeout = 3e5
+    // 5 minutes default for SSE read timeout
   } = options;
   const [state, setState] = useState("discovering");
   const [tools, setTools] = useState([]);
@@ -186,6 +190,9 @@ function useMcp(options) {
               ...customHeaders
             }
           }
+          // Note: The MCP SDK's SSEClientTransport doesn't expose timeout configuration directly
+          // Timeout handling is managed by the underlying EventSource and browser/Node.js fetch implementations
+          // The timeout and sseReadTimeout options are preserved for future use or custom implementations
         };
         const sanitizedUrl = sanitizeUrl(url);
         const targetUrl = new URL(sanitizedUrl);
@@ -376,7 +383,9 @@ function useMcp(options) {
     transportType,
     preventAutoAuth,
     onPopupWindow,
-    enabled
+    enabled,
+    timeout,
+    sseReadTimeout
   ]);
   const callTool = useCallback(
     async (name, args) => {

package/dist/index.cjs

@@ -3442,8 +3442,8 @@ var HttpConnector = class extends BaseConnector {
     if (opts.authToken) {
       this.headers.Authorization = `Bearer ${opts.authToken}`;
     }
-    this.timeout = opts.timeout ?? 5;
-    this.sseReadTimeout = opts.sseReadTimeout ?? 60 * 5;
+    this.timeout = opts.timeout ?? 3e4;
+    this.sseReadTimeout = opts.sseReadTimeout ?? 3e5;
     this.clientInfo = opts.clientInfo ?? { name: "http-connector", version: "1.0.0" };
     this.preferSse = opts.preferSse ?? false;
   }
@@ -4725,10 +4725,10 @@ __name(onMcpAuthorization, "onMcpAuthorization");
 // src/react/useMcp.ts
 var import_types = require("@modelcontextprotocol/sdk/types.js");
 var import_react = require("react");
+var import_auth2 = require("@modelcontextprotocol/sdk/client/auth.js");
+var import_client3 = require("@modelcontextprotocol/sdk/client/index.js");
 var import_sse3 = require("@modelcontextprotocol/sdk/client/sse.js");
 var import_streamableHttp3 = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
-var import_client3 = require("@modelcontextprotocol/sdk/client/index.js");
-var import_auth2 = require("@modelcontextprotocol/sdk/client/auth.js");
 var import_strict_url_sanitise2 = require("strict-url-sanitise");
 
 // src/utils/assert.ts
@@ -4758,7 +4758,11 @@ function useMcp(options) {
     autoReconnect = DEFAULT_RECONNECT_DELAY,
     transportType = "auto",
     preventAutoAuth = false,
-    onPopupWindow
+    onPopupWindow,
+    timeout = 3e4,
+    // 30 seconds default for connection timeout
+    sseReadTimeout = 3e5
+    // 5 minutes default for SSE read timeout
   } = options;
   const [state, setState] = (0, import_react.useState)("discovering");
   const [tools, setTools] = (0, import_react.useState)([]);
@@ -4896,6 +4900,9 @@ function useMcp(options) {
               ...customHeaders
             }
           }
+          // Note: The MCP SDK's SSEClientTransport doesn't expose timeout configuration directly
+          // Timeout handling is managed by the underlying EventSource and browser/Node.js fetch implementations
+          // The timeout and sseReadTimeout options are preserved for future use or custom implementations
         };
         const sanitizedUrl = (0, import_strict_url_sanitise2.sanitizeUrl)(url);
         const targetUrl = new URL(sanitizedUrl);
@@ -5086,7 +5093,9 @@ function useMcp(options) {
     transportType,
     preventAutoAuth,
     onPopupWindow,
-    enabled
+    enabled,
+    timeout,
+    sseReadTimeout
   ]);
   const callTool = (0, import_react.useCallback)(
     async (name, args) => {

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   useMcp
-} from "./chunk-CWWNPIJZ.js";
+} from "./chunk-56ZYVEAJ.js";
 import {
   BrowserOAuthClientProvider,
   onMcpAuthorization
@@ -2931,8 +2931,8 @@ var HttpConnector = class extends BaseConnector {
     if (opts.authToken) {
       this.headers.Authorization = `Bearer ${opts.authToken}`;
     }
-    this.timeout = opts.timeout ?? 5;
-    this.sseReadTimeout = opts.sseReadTimeout ?? 60 * 5;
+    this.timeout = opts.timeout ?? 3e4;
+    this.sseReadTimeout = opts.sseReadTimeout ?? 3e5;
     this.clientInfo = opts.clientInfo ?? { name: "http-connector", version: "1.0.0" };
     this.preferSse = opts.preferSse ?? false;
   }

package/dist/src/connectors/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/connectors/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAMrD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,qBAAa,aAAc,SAAQ,aAAa;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,aAAa,CAAyC;gBAElD,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,oBAAyB;IAe5D,mFAAmF;IAC7E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAiFhB,yBAAyB;YAoDzB,cAAc;IA4B5B,IAAI,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM7C;IAED;;OAEG;IACH,gBAAgB,IAAI,iBAAiB,GAAG,KAAK,GAAG,IAAI;CAGrD"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/connectors/http.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,qBAAa,aAAc,SAAQ,aAAa;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,aAAa,CAAyC;gBAElD,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,oBAAyB;IAe5D,mFAAmF;IAC7E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAiFhB,yBAAyB;YAoDzB,cAAc;IA8B5B,IAAI,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM7C;IAED;;OAEG;IACH,gBAAgB,IAAI,iBAAiB,GAAG,KAAK,GAAG,IAAI;CAGrD"}

package/dist/src/react/index.cjs

@@ -29,10 +29,10 @@ module.exports = __toCommonJS(react_exports);
 // src/react/useMcp.ts
 var import_types = require("@modelcontextprotocol/sdk/types.js");
 var import_react = require("react");
+var import_auth = require("@modelcontextprotocol/sdk/client/auth.js");
+var import_client = require("@modelcontextprotocol/sdk/client/index.js");
 var import_sse = require("@modelcontextprotocol/sdk/client/sse.js");
 var import_streamableHttp = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
-var import_client = require("@modelcontextprotocol/sdk/client/index.js");
-var import_auth = require("@modelcontextprotocol/sdk/client/auth.js");
 var import_strict_url_sanitise2 = require("strict-url-sanitise");
 
 // src/auth/browser-provider.ts
@@ -262,7 +262,11 @@ function useMcp(options) {
     autoReconnect = DEFAULT_RECONNECT_DELAY,
     transportType = "auto",
     preventAutoAuth = false,
-    onPopupWindow
+    onPopupWindow,
+    timeout = 3e4,
+    // 30 seconds default for connection timeout
+    sseReadTimeout = 3e5
+    // 5 minutes default for SSE read timeout
   } = options;
   const [state, setState] = (0, import_react.useState)("discovering");
   const [tools, setTools] = (0, import_react.useState)([]);
@@ -400,6 +404,9 @@ function useMcp(options) {
               ...customHeaders
             }
           }
+          // Note: The MCP SDK's SSEClientTransport doesn't expose timeout configuration directly
+          // Timeout handling is managed by the underlying EventSource and browser/Node.js fetch implementations
+          // The timeout and sseReadTimeout options are preserved for future use or custom implementations
         };
         const sanitizedUrl = (0, import_strict_url_sanitise2.sanitizeUrl)(url);
         const targetUrl = new URL(sanitizedUrl);
@@ -590,7 +597,9 @@ function useMcp(options) {
     transportType,
     preventAutoAuth,
     onPopupWindow,
-    enabled
+    enabled,
+    timeout,
+    sseReadTimeout
   ]);
   const callTool = (0, import_react.useCallback)(
     async (name, args) => {

package/dist/src/react/index.js

@@ -1,6 +1,6 @@
 import {
   useMcp
-} from "../../chunk-CWWNPIJZ.js";
+} from "../../chunk-56ZYVEAJ.js";
 import {
   onMcpAuthorization
 } from "../../chunk-TJXUCAST.js";

package/dist/src/react/types.d.ts

@@ -1,4 +1,4 @@
-import type { Tool, Resource, ResourceTemplate, Prompt } from '@modelcontextprotocol/sdk/types.js';
+import type { Prompt, Resource, ResourceTemplate, Tool } from '@modelcontextprotocol/sdk/types.js';
 export type UseMcpOptions = {
     /** The /sse URL of your remote MCP server */
     url?: string;
@@ -37,6 +37,10 @@ export type UseMcpOptions = {
      * @param features The features string for the popup window.
      */
     onPopupWindow?: (url: string, features: string, window: globalThis.Window | null) => void;
+    /** Connection timeout in milliseconds for establishing initial connection (default: 30000 / 30 seconds) */
+    timeout?: number;
+    /** SSE read timeout in milliseconds to prevent idle connection drops (default: 300000 / 5 minutes) */
+    sseReadTimeout?: number;
 };
 export type UseMcpResult = {
     /** List of tools available from the connected MCP server */

package/dist/src/react/types.d.ts.map

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

package/dist/src/react/useMcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMcp.d.ts","sourceRoot":"","sources":["../../../src/react/useMcp.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAU7D,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAouB3D"}
+{"version":3,"file":"useMcp.d.ts","sourceRoot":"","sources":["../../../src/react/useMcp.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS9D,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CA2uB3D"}

package/dist/src/server/adapters/mcp-ui-adapter.d.ts

@@ -5,8 +5,11 @@
  * into @mcp-ui/server compatible resource objects.
  *
  * Ref: https://mcpui.dev/guide/server/typescript/usage-examples
+ * Apps SDK: https://mcpui.dev/guide/apps-sdk
+ * Official Apps SDK Docs: https://developers.openai.com/apps-sdk/build/mcp-server
  */
-import type { UIResourceContent, UIResourceDefinition, UIEncoding } from '../types/resource.js';
+import { type AdaptersConfig } from '@mcp-ui/server';
+import type { UIResourceContent, UIResourceDefinition, UIEncoding, AppsSdkMetadata } from '../types/resource.js';
 /**
  * Configuration for building widget URLs
  */
@@ -29,18 +32,22 @@ export declare function buildWidgetUrl(widget: string, props: Record<string, any
  * @param uri - Resource URI (must start with ui://)
  * @param iframeUrl - URL to load in iframe
  * @param encoding - Encoding type ('text' or 'blob')
+ * @param adapters - Adapter configuration (e.g., Apps SDK)
+ * @param metadata - Additional metadata for the resource
  * @returns UIResourceContent object
  */
-export declare function createExternalUrlResource(uri: string, iframeUrl: string, encoding?: UIEncoding): UIResourceContent;
+export declare function createExternalUrlResource(uri: string, iframeUrl: string, encoding?: UIEncoding, adapters?: AdaptersConfig, metadata?: AppsSdkMetadata): UIResourceContent;
 /**
  * Create a UIResource for raw HTML content
  *
  * @param uri - Resource URI (must start with ui://)
  * @param htmlString - HTML content to render
  * @param encoding - Encoding type ('text' or 'blob')
+ * @param adapters - Adapter configuration (e.g., Apps SDK)
+ * @param metadata - Additional metadata for the resource
  * @returns UIResourceContent object
  */
-export declare function createRawHtmlResource(uri: string, htmlString: string, encoding?: UIEncoding): UIResourceContent;
+export declare function createRawHtmlResource(uri: string, htmlString: string, encoding?: UIEncoding, adapters?: AdaptersConfig, metadata?: AppsSdkMetadata): UIResourceContent;
 /**
  * Create a UIResource for Remote DOM scripting
  *
@@ -48,9 +55,52 @@ export declare function createRawHtmlResource(uri: string, htmlString: string, e
  * @param script - JavaScript code for remote DOM manipulation
  * @param framework - Framework for remote DOM ('react' or 'webcomponents')
  * @param encoding - Encoding type ('text' or 'blob')
+ * @param adapters - Adapter configuration (e.g., Apps SDK)
+ * @param metadata - Additional metadata for the resource
  * @returns UIResourceContent object
  */
-export declare function createRemoteDomResource(uri: string, script: string, framework?: 'react' | 'webcomponents', encoding?: UIEncoding): UIResourceContent;
+export declare function createRemoteDomResource(uri: string, script: string, framework?: 'react' | 'webcomponents', encoding?: UIEncoding, adapters?: AdaptersConfig, metadata?: AppsSdkMetadata): UIResourceContent;
+/**
+ * Create a UIResource for OpenAI Apps SDK
+ *
+ * This creates a resource compatible with OpenAI's Apps SDK using the
+ * text/html+skybridge mime type. The HTML template should contain the
+ * component code with embedded JS/CSS.
+ *
+ * The Apps SDK pattern:
+ * - Uses mime type text/html+skybridge
+ * - Tool's structuredContent gets injected as window.openai.toolOutput
+ * - Supports Apps SDK metadata (CSP, widget domain, description, etc.)
+ *
+ * @param uri - Resource URI (must start with ui://)
+ * @param htmlTemplate - HTML template with embedded component code
+ * @param metadata - Apps SDK metadata (CSP, description, domain, etc.)
+ * @returns UIResourceContent object
+ *
+ * @see https://developers.openai.com/apps-sdk/build/mcp-server
+ * @see https://mcpui.dev/guide/apps-sdk
+ *
+ * @example
+ * ```typescript
+ * const resource = createAppsSdkResource(
+ *   'ui://widget/kanban-board.html',
+ *   `
+ *     <div id="kanban-root"></div>
+ *     <style>${kanbanCSS}</style>
+ *     <script type="module">${kanbanJS}</script>
+ *   `,
+ *   {
+ *     'openai/widgetDescription': 'Displays an interactive kanban board',
+ *     'openai/widgetCSP': {
+ *       connect_domains: [],
+ *       resource_domains: ['https://cdn.example.com']
+ *     },
+ *     'openai/widgetPrefersBorder': true
+ *   }
+ * )
+ * ```
+ */
+export declare function createAppsSdkResource(uri: string, htmlTemplate: string, metadata?: AppsSdkMetadata): UIResourceContent;
 /**
  * Create a UIResource from a high-level definition
  *

package/dist/src/server/adapters/mcp-ui-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-ui-adapter.d.ts","sourceRoot":"","sources":["../../../../src/server/adapters/mcp-ui-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACX,MAAM,sBAAsB,CAAA;AAE7B;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,EACtC,MAAM,EAAE,SAAS,GAChB,MAAM,CAkBR;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,UAAmB,GAC5B,iBAAiB,CAMnB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,UAAmB,GAC5B,iBAAiB,CAMnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,OAAO,GAAG,eAAyB,EAC9C,QAAQ,GAAE,UAAmB,GAC5B,iBAAiB,CAMnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,EAAE,SAAS,GAChB,iBAAiB,CAyBnB"}
+{"version":3,"file":"mcp-ui-adapter.d.ts","sourceRoot":"","sources":["../../../../src/server/adapters/mcp-ui-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEtE,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,eAAe,EAChB,MAAM,sBAAsB,CAAA;AAE7B;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,EACtC,MAAM,EAAE,SAAS,GAChB,MAAM,CAkBR;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,UAAmB,EAC7B,QAAQ,CAAC,EAAE,cAAc,EACzB,QAAQ,CAAC,EAAE,eAAe,GACzB,iBAAiB,CAQnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,UAAmB,EAC7B,QAAQ,CAAC,EAAE,cAAc,EACzB,QAAQ,CAAC,EAAE,eAAe,GACzB,iBAAiB,CAQnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,OAAO,GAAG,eAAyB,EAC9C,QAAQ,GAAE,UAAmB,EAC7B,QAAQ,CAAC,EAAE,cAAc,EACzB,QAAQ,CAAC,EAAE,eAAe,GACzB,iBAAiB,CAQnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,eAAe,GACzB,iBAAiB,CAkBnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,EAAE,SAAS,GAChB,iBAAiB,CAuDnB"}