mcp-use 1.0.4 → 1.0.6

package/dist/index.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Main package exports for MCP client and MCP agent functionality
+ *
+ * This file serves as the primary entry point for consuming MCP (Model Context Protocol)
+ * functionality in client applications and agent implementations. It exports all necessary
+ * classes, utilities, and types for building MCP-based applications.
+ *
+ * @important Server functionality is exported from ./src/server/index.js -
+ * do NOT export server-related modules from this file.
+ */
 import { MCPAgent } from './src/agents/mcp_agent.js';
 import { RemoteAgent } from './src/agents/remote.js';
 import { MCPClient } from './src/client.js';
@@ -13,8 +23,6 @@ export * from './src/agents/utils/index.js';
 export { ServerManager } from './src/managers/server_manager.js';
 export * from './src/managers/tools/index.js';
 export { type ObservabilityConfig, ObservabilityManager } from './src/observability/index.js';
-export { createMCPServer } from './src/server/index.js';
-export type { InputDefinition, PromptDefinition, PromptHandler, ResourceDefinition, ResourceHandler, ServerConfig, ToolDefinition, ToolHandler, } from './src/server/types.js';
 export { setTelemetrySource, Telemetry } from './src/telemetry/index.js';
 export { OAuthHelper, LINEAR_OAUTH_CONFIG, createOAuthMCPConfig } from './src/oauth-helper.js';
 export type { OAuthConfig, OAuthDiscovery, ClientRegistration, OAuthResult, OAuthState } from './src/oauth-helper.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAElE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAEvE,cAAc,6BAA6B,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAEhE,cAAc,+BAA+B,CAAA;AAG7C,OAAO,EAAE,KAAK,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAG7F,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,WAAW,GACZ,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAGxE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAC9F,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAGrH,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACpF,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAGtD,cAAc,sBAAsB,CAAA;AAGpC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAG3G,YAAY,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAA;AAErE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAElE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAEvE,cAAc,6BAA6B,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAEhE,cAAc,+BAA+B,CAAA;AAG7C,OAAO,EAAE,KAAK,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAG7F,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAGxE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAC9F,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAGrH,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACpF,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAGtD,cAAc,sBAAsB,CAAA;AAGpC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAG3G,YAAY,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAA;AAErE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/index.js

@@ -5,9 +5,6 @@ import {
   BrowserOAuthClientProvider,
   onMcpAuthorization
 } from "./chunk-TJXUCAST.js";
-import {
-  createMCPServer
-} from "./chunk-MZPKOZE4.js";
 import {
   Logger,
   logger
@@ -1776,7 +1773,8 @@ var MCPAgent = class {
     const startTime = Date.now();
     const toolsUsedNames = [];
     let stepsTaken = 0;
-    let success = false;
+    const structuredOutputSuccess = false;
+    const structuredOutputSuccessRef = { value: structuredOutputSuccess };
     let structuredLlm = null;
     let schemaDescription = "";
     if (outputSchema) {
@@ -1866,28 +1864,26 @@ var MCPAgent = class {
             result = nextStepOutput.returnValues?.output ?? "No output generated";
             runManager?.handleChainEnd({ output: result });
             if (outputSchema && structuredLlm) {
-              try {
-                logger.info("\u{1F527} Attempting structured output...");
-                const structuredResult = await this._attemptStructuredOutput(
-                  result,
-                  structuredLlm,
-                  outputSchema,
-                  schemaDescription
-                );
-                logger.debug(`\u{1F504} Structured result: ${JSON.stringify(structuredResult)}`);
+              logger.info("\u{1F527} Attempting structured output...");
+              const currentResult = result;
+              this._attemptStructuredOutput(
+                currentResult,
+                this.llm,
+                outputSchema
+              ).then((structuredResult) => {
                 if (this.memoryEnabled) {
                   this.addToHistory(new AIMessage(`Structured result: ${JSON.stringify(structuredResult)}`));
                 }
                 logger.info("\u2705 Structured output successful");
-                success = true;
+                structuredOutputSuccessRef.value = true;
                 return structuredResult;
-              } catch (e) {
+              }).catch((e) => {
                 logger.warn(`\u26A0\uFE0F Structured output failed: ${e}`);
                 const failedStructuredOutputPrompt = `
                 The current result cannot be formatted into the required structure.
                 Error: ${String(e)}
                 
-                Current information: ${result}
+                Current information: ${currentResult}
                 
                 If information is missing, please continue working to gather the missing information needed for:
                 ${schemaDescription}
@@ -1899,36 +1895,35 @@ var MCPAgent = class {
                   this.addToHistory(new HumanMessage(failedStructuredOutputPrompt));
                 }
                 logger.info("\u{1F504} Continuing execution to gather missing information...");
-                continue;
-              }
-            } else {
-              break;
+              });
             }
           }
-          const stepArray = nextStepOutput;
-          intermediateSteps.push(...stepArray);
-          for (const step of stepArray) {
-            yield step;
-            const { action, observation } = step;
-            const toolName = action.tool;
-            toolsUsedNames.push(toolName);
-            let toolInputStr = typeof action.toolInput === "string" ? action.toolInput : JSON.stringify(action.toolInput, null, 2);
-            if (toolInputStr.length > 100)
-              toolInputStr = `${toolInputStr.slice(0, 97)}...`;
-            logger.info(`\u{1F527} Tool call: ${toolName} with input: ${toolInputStr}`);
-            let outputStr = String(observation);
-            if (outputStr.length > 100)
-              outputStr = `${outputStr.slice(0, 97)}...`;
-            outputStr = outputStr.replace(/\n/g, " ");
-            logger.info(`\u{1F4C4} Tool result: ${outputStr}`);
-          }
-          if (stepArray.length) {
-            const lastStep = stepArray[stepArray.length - 1];
-            const toolReturn = await this._agentExecutor._getToolReturn(lastStep);
-            if (toolReturn) {
-              logger.info(`\u{1F3C6} Tool returned directly at step ${stepNum + 1}`);
-              result = toolReturn.returnValues?.output ?? "No output generated";
-              break;
+          if (Array.isArray(nextStepOutput)) {
+            const stepArray = nextStepOutput;
+            intermediateSteps.push(...stepArray);
+            for (const step of stepArray) {
+              yield step;
+              const { action, observation } = step;
+              const toolName = action.tool;
+              toolsUsedNames.push(toolName);
+              let toolInputStr = typeof action.toolInput === "string" ? action.toolInput : JSON.stringify(action.toolInput, null, 2);
+              if (toolInputStr.length > 100)
+                toolInputStr = `${toolInputStr.slice(0, 97)}...`;
+              logger.info(`\u{1F527} Tool call: ${toolName} with input: ${toolInputStr}`);
+              let outputStr = String(observation);
+              if (outputStr.length > 100)
+                outputStr = `${outputStr.slice(0, 97)}...`;
+              outputStr = outputStr.replace(/\n/g, " ");
+              logger.info(`\u{1F4C4} Tool result: ${outputStr}`);
+            }
+            if (stepArray.length) {
+              const lastStep = stepArray[stepArray.length - 1];
+              const toolReturn = await this._agentExecutor._getToolReturn(lastStep);
+              if (toolReturn) {
+                logger.info(`\u{1F3C6} Tool returned directly at step ${stepNum + 1}`);
+                result = toolReturn.returnValues?.output ?? "No output generated";
+                break;
+              }
             }
           }
         } catch (e) {
@@ -1951,7 +1946,7 @@ var MCPAgent = class {
         runManager?.handleChainEnd({ output: result });
       }
       logger.info("\u{1F389} Agent execution complete");
-      success = true;
+      structuredOutputSuccessRef.value = true;
       return result;
     } catch (e) {
       logger.error(`\u274C Error running query: ${e}`);
@@ -1972,7 +1967,7 @@ var MCPAgent = class {
       await this.telemetry.trackAgentExecution({
         executionMethod: "stream",
         query,
-        success,
+        success: structuredOutputSuccess,
         modelProvider: this.modelProvider,
         modelName: this.modelName,
         serverCount,
@@ -1990,7 +1985,7 @@ var MCPAgent = class {
         toolsUsedNames,
         response: result,
         executionTimeMs,
-        errorType: success ? null : "execution_error",
+        errorType: structuredOutputSuccess ? null : "execution_error",
         conversationHistoryLength
       });
       if (manageConnector && !this.client && initializedHere) {
@@ -2031,13 +2026,16 @@ var MCPAgent = class {
    * Yields LangChain StreamEvent objects from the underlying streamEvents() method.
    * This provides token-level streaming and fine-grained event updates.
    */
-  async *streamEvents(query, maxSteps, manageConnector = true, externalHistory) {
+  async *streamEvents(query, maxSteps, manageConnector = true, externalHistory, outputSchema) {
     let initializedHere = false;
     const startTime = Date.now();
     let success = false;
     let eventCount = 0;
     let totalResponseLength = 0;
     let finalResponse = "";
+    if (outputSchema) {
+      query = this._enhanceQueryWithSchema(query, outputSchema);
+    }
     try {
       if (manageConnector && !this._initialized) {
         await this.initialize();
@@ -2085,15 +2083,71 @@ var MCPAgent = class {
           totalResponseLength += event.data.chunk.content.length;
         }
         yield event;
-        await new Promise((resolve) => setTimeout(resolve, 0));
         if (event.event === "on_chain_end" && event.data?.output) {
           const output = event.data.output;
           if (Array.isArray(output) && output.length > 0 && output[0]?.text) {
             finalResponse = output[0].text;
+          } else if (typeof output === "string") {
+            finalResponse = output;
+          } else if (output && typeof output === "object" && "output" in output) {
+            finalResponse = output.output;
           }
         }
       }
-      if (this.memoryEnabled && finalResponse) {
+      if (outputSchema && finalResponse) {
+        logger.info("\u{1F527} Attempting structured output conversion...");
+        try {
+          let conversionCompleted = false;
+          let conversionResult = null;
+          let conversionError = null;
+          const _conversionPromise = this._attemptStructuredOutput(
+            finalResponse,
+            this.llm,
+            outputSchema
+          ).then((result) => {
+            conversionCompleted = true;
+            conversionResult = result;
+            return result;
+          }).catch((error) => {
+            conversionCompleted = true;
+            conversionError = error;
+            throw error;
+          });
+          let progressCount = 0;
+          while (!conversionCompleted) {
+            await new Promise((resolve) => setTimeout(resolve, 2e3));
+            if (!conversionCompleted) {
+              progressCount++;
+              yield {
+                event: "on_structured_output_progress",
+                data: {
+                  message: `Converting to structured output... (${progressCount * 2}s)`,
+                  elapsed: progressCount * 2
+                }
+              };
+            }
+          }
+          if (conversionError) {
+            throw conversionError;
+          }
+          if (conversionResult) {
+            yield {
+              event: "on_structured_output",
+              data: { output: conversionResult }
+            };
+            if (this.memoryEnabled) {
+              this.addToHistory(new AIMessage(`Structured result: ${JSON.stringify(conversionResult)}`));
+            }
+            logger.info("\u2705 Structured output successful");
+          }
+        } catch (e) {
+          logger.warn(`\u26A0\uFE0F Structured output failed: ${e}`);
+          yield {
+            event: "on_structured_output_error",
+            data: { error: e instanceof Error ? e.message : String(e) }
+          };
+        }
+      } else if (this.memoryEnabled && finalResponse) {
         this.addToHistory(new AIMessage(finalResponse));
       }
       logger.info(`\u{1F389} StreamEvents complete - ${eventCount} events emitted`);
@@ -2144,10 +2198,21 @@ var MCPAgent = class {
   /**
    * Attempt to create structured output from raw result with validation and retry logic.
    */
-  async _attemptStructuredOutput(rawResult, structuredLlm, outputSchema, schemaDescription) {
+  async _attemptStructuredOutput(rawResult, llm, outputSchema) {
     logger.info(`\u{1F504} Attempting structured output with schema: ${outputSchema}`);
-    logger.info(`\u{1F504} Schema description: ${schemaDescription}`);
     logger.info(`\u{1F504} Raw result: ${JSON.stringify(rawResult, null, 2)}`);
+    let structuredLlm = null;
+    let schemaDescription = "";
+    logger.debug(`\u{1F504} Structured output requested, schema: ${JSON.stringify(zodToJsonSchema2(outputSchema), null, 2)}`);
+    if (llm && "withStructuredOutput" in llm && typeof llm.withStructuredOutput === "function") {
+      structuredLlm = llm.withStructuredOutput(outputSchema);
+    } else if (llm) {
+      structuredLlm = llm;
+    } else {
+      throw new Error("LLM is required for structured output");
+    }
+    schemaDescription = JSON.stringify(zodToJsonSchema2(outputSchema), null, 2);
+    logger.info(`\u{1F504} Schema description: ${schemaDescription}`);
     let textContent = "";
     if (typeof rawResult === "string") {
       textContent = rawResult;
@@ -2191,6 +2256,7 @@ var MCPAgent = class {
         let chunkCount = 0;
         for await (const chunk of stream) {
           chunkCount++;
+          logger.info(`Chunk ${chunkCount}: ${JSON.stringify(chunk, null, 2)}`);
           if (typeof chunk === "string") {
             try {
               structuredResult = JSON.parse(chunk);
@@ -2206,7 +2272,6 @@ var MCPAgent = class {
               logger.warn(`\u{1F504} Failed to parse chunk as JSON: ${chunk}`);
             }
           }
-          await new Promise((resolve) => setTimeout(resolve, 0));
           if (chunkCount % 10 === 0) {
             logger.info(`\u{1F504} Structured output streaming: ${chunkCount} chunks`);
           }
@@ -3878,7 +3943,6 @@ export {
   Telemetry,
   ToolMessage2 as ToolMessage,
   WebSocketConnector,
-  createMCPServer,
   createOAuthMCPConfig,
   createReadableStreamFromGenerator,
   loadConfigFile,

package/dist/src/agents/mcp_agent.d.ts

@@ -129,7 +129,7 @@ export declare class MCPAgent {
      * Yields LangChain StreamEvent objects from the underlying streamEvents() method.
      * This provides token-level streaming and fine-grained event updates.
      */
-    streamEvents(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[]): AsyncGenerator<StreamEvent, void, void>;
+    streamEvents<T = string>(query: string, maxSteps?: number, manageConnector?: boolean, externalHistory?: BaseMessage[], outputSchema?: ZodSchema<T>): AsyncGenerator<StreamEvent, void, void>;
     /**
      * Attempt to create structured output from raw result with validation and retry logic.
      */

package/dist/src/agents/mcp_agent.d.ts.map

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

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

@@ -0,0 +1,66 @@
+/**
+ * MCP-UI Adapter Utilities
+ *
+ * Pure functions to convert mcp-use high-level UIResource definitions
+ * into @mcp-ui/server compatible resource objects.
+ *
+ * Ref: https://mcpui.dev/guide/server/typescript/usage-examples
+ */
+import type { UIResourceContent, UIResourceDefinition, UIEncoding } from '../types/resource.js';
+/**
+ * Configuration for building widget URLs
+ */
+export interface UrlConfig {
+    baseUrl: string;
+    port: number | string;
+}
+/**
+ * Build the full URL for a widget including query parameters
+ *
+ * @param widget - Widget identifier
+ * @param props - Parameters to pass as query params
+ * @param config - URL configuration (baseUrl and port)
+ * @returns Complete widget URL with encoded parameters
+ */
+export declare function buildWidgetUrl(widget: string, props: Record<string, any> | undefined, config: UrlConfig): string;
+/**
+ * Create a UIResource for an external URL (iframe)
+ *
+ * @param uri - Resource URI (must start with ui://)
+ * @param iframeUrl - URL to load in iframe
+ * @param encoding - Encoding type ('text' or 'blob')
+ * @returns UIResourceContent object
+ */
+export declare function createExternalUrlResource(uri: string, iframeUrl: string, encoding?: UIEncoding): 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')
+ * @returns UIResourceContent object
+ */
+export declare function createRawHtmlResource(uri: string, htmlString: string, encoding?: UIEncoding): UIResourceContent;
+/**
+ * Create a UIResource for Remote DOM scripting
+ *
+ * @param uri - Resource URI (must start with ui://)
+ * @param script - JavaScript code for remote DOM manipulation
+ * @param framework - Framework for remote DOM ('react' or 'webcomponents')
+ * @param encoding - Encoding type ('text' or 'blob')
+ * @returns UIResourceContent object
+ */
+export declare function createRemoteDomResource(uri: string, script: string, framework?: 'react' | 'webcomponents', encoding?: UIEncoding): UIResourceContent;
+/**
+ * Create a UIResource from a high-level definition
+ *
+ * This is the main function that routes to the appropriate resource creator
+ * based on the discriminated union type.
+ *
+ * @param definition - UIResource definition (discriminated union)
+ * @param params - Runtime parameters for the widget (for externalUrl type)
+ * @param config - URL configuration for building widget URLs
+ * @returns UIResourceContent object
+ */
+export declare function createUIResourceFromDefinition(definition: UIResourceDefinition, params: Record<string, any>, config: UrlConfig): UIResourceContent;
+//# sourceMappingURL=mcp-ui-adapter.d.ts.map

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

@@ -0,0 +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"}