@1mcp/agent 0.29.0-beta4 → 0.29.0-beta6

package/build/core/loading/parallelExecutor.js

@@ -0,0 +1,130 @@
+import { EventEmitter } from 'events';
+import logger from '../../logger/logger.js';
+/**
+ * Events emitted by ParallelExecutor during execution
+ */
+export var ParallelExecutorEvent;
+(function (ParallelExecutorEvent) {
+    /** Emitted when an item begins processing */
+    ParallelExecutorEvent["ItemStart"] = "item-start";
+    /** Emitted when an item completes processing (success or failure) */
+    ParallelExecutorEvent["ItemComplete"] = "item-complete";
+    /** Emitted when a batch of items completes processing */
+    ParallelExecutorEvent["BatchComplete"] = "batch-complete";
+})(ParallelExecutorEvent || (ParallelExecutorEvent = {}));
+/**
+ * ParallelExecutor - Executes items in parallel with concurrency control
+ *
+ * This utility processes multiple items concurrently while respecting a maximum
+ * concurrency limit. Items are processed in batches, and events are emitted for
+ * observability during execution.
+ *
+ * @example
+ * ```typescript
+ * const executor = new ParallelExecutor<string, number>();
+ *
+ * executor.on(ParallelExecutorEvent.ItemStart, (item) => {
+ *   console.log(`Processing: ${item}`);
+ * });
+ *
+ * const results = await executor.execute(
+ *   ['a', 'b', 'c'],
+ *   async (item) => {
+ *     return item.length; // Some async operation
+ *   },
+ *   { maxConcurrent: 2 }
+ * );
+ *
+ * // Results: Map {'a' => 1, 'b' => 1, 'c' => 1}
+ * ```
+ */
+export class ParallelExecutor extends EventEmitter {
+    constructor() {
+        super();
+        this.setMaxListeners(100); // Allow many listeners for observability
+    }
+    /**
+     * Execute items in parallel with concurrency control
+     *
+     * @param items - Array of items to process
+     * @param handler - Async function that processes each item
+     * @param options - Execution options including max concurrency
+     * @returns Map of items to their successful results only. Failed items are not included
+     *          but can be tracked via ItemComplete events (which emit Error objects)
+     * @throws Never throws - individual item failures are caught and logged, other items continue processing
+     * @remarks Errors from individual items do not prevent other items from processing.
+     *          Failed items emit ItemComplete events with Error objects and are logged,
+     *          then excluded from the returned results Map. Use event listeners to track failures.
+     */
+    async execute(items, handler, options) {
+        const results = new Map();
+        // Process items in batches based on maxConcurrent
+        for (let i = 0; i < items.length; i += options.maxConcurrent) {
+            const batch = items.slice(i, i + options.maxConcurrent);
+            // Start all items in this batch
+            const batchPromises = batch.map(async (item) => {
+                this.emit(ParallelExecutorEvent.ItemStart, item);
+                try {
+                    const result = await handler(item);
+                    results.set(item, result);
+                    this.emit(ParallelExecutorEvent.ItemComplete, item, result);
+                    return result;
+                }
+                catch (error) {
+                    const errorObj = error instanceof Error ? error : new Error(String(error));
+                    // Still emit the completion event, but don't set in results Map
+                    // This allows other items to continue processing
+                    this.emit(ParallelExecutorEvent.ItemComplete, item, errorObj);
+                    throw errorObj; // Re-throw for Promise.allSettled handling
+                }
+            });
+            // Wait for this batch to complete before starting next batch
+            const batchResults = await Promise.allSettled(batchPromises);
+            // Log and track failed items from this batch
+            const failedItems = [];
+            batchResults.forEach((result, index) => {
+                if (result.status === 'rejected') {
+                    failedItems.push({ item: batch[index], result });
+                }
+            });
+            if (failedItems.length > 0) {
+                for (const { item, result } of failedItems) {
+                    const error = result.reason;
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    logger.error(`Failed to process item in parallel execution: ${item}`, {
+                        error: errorMessage,
+                        itemType: typeof item,
+                    });
+                }
+            }
+            // Emit batch complete event
+            this.emit(ParallelExecutorEvent.BatchComplete, batch);
+        }
+        return results;
+    }
+    /**
+     * Type-safe event listener registration
+     */
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    /**
+     * Type-safe one-time event listener registration
+     */
+    once(event, listener) {
+        return super.once(event, listener);
+    }
+    /**
+     * Type-safe event listener removal
+     */
+    off(event, listener) {
+        return super.off(event, listener);
+    }
+    /**
+     * Type-safe event emission
+     */
+    emit(event, ...args) {
+        return super.emit(event, ...args);
+    }
+}
+//# sourceMappingURL=parallelExecutor.js.map

package/build/core/loading/parallelExecutor.js.map

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

package/build/transport/http/restorableStreamableTransport.d.ts

@@ -1,11 +1,23 @@
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 /**
- * Information about the restoration state of a transport
+ * Metadata about a transport's restoration state, used for debugging
+ * and monitoring session restoration flow.
  */
 export interface RestorationInfo {
     isRestored: boolean;
     sessionId?: string;
 }
+/**
+ * Result type for operations that may fail.
+ * Uses discriminated union to make invalid states unrepresentable.
+ */
+export type OperationResult = {
+    success: true;
+    error?: never;
+} | {
+    success: false;
+    error: string;
+};
 /**
  * RestorableStreamableHTTPServerTransport extends the MCP SDK's StreamableHTTPServerTransport
  * to provide proper session restoration capabilities with type-safe access to internal properties.
@@ -13,22 +25,55 @@ export interface RestorationInfo {
  * This wrapper class encapsulates the initialization logic needed for restored sessions,
  * providing a clean interface that's less likely to break with SDK updates.
  *
+ * @remarks
+ * The class works by:
+ * 1. Storing a restored sessionId that overrides the SDK's getter
+ * 2. Providing methods to safely access and modify internal SDK properties
+ * 3. Returning success/failure status from operations for proper error handling
+ *
  * @example
  * ```typescript
- * // For session restoration
+ * // SessionService handles the full restoration flow:
  * const transport = new RestorableStreamableHTTPServerTransport({
- *   sessionIdGenerator: () => sessionId,
+ *   sessionIdGenerator: () => originalSessionId,
  * });
- * transport.markAsInitialized();
- *
- * // Check if session was restored
- * if (transport.isRestored()) {
- *   // Handle restored session logic
- * }
+ * const initResult = transport.markAsInitialized();
+ * transport.setSessionId(originalSessionId);
+ * // Now transport.isRestored() returns true
  * ```
  */
 export declare class RestorableStreamableHTTPServerTransport extends StreamableHTTPServerTransport {
     private _isRestored;
+    private _restoredSessionId?;
+    /**
+     * Sets the sessionId for a restored session.
+     *
+     * When restoring a session, we need to ensure the sessionId is available immediately
+     * without waiting for the sessionIdGenerator to be called by the SDK. This method
+     * directly sets the sessionId on the underlying transport.
+     *
+     * @param sessionId - The sessionId to set for the restored session
+     * @returns OperationResult indicating success or failure with error details
+     */
+    setSessionId(sessionId: string): OperationResult;
+    /**
+     * Override sessionId getter to return restored sessionId if available.
+     *
+     * This ensures that even if the underlying transport hasn't generated the sessionId yet,
+     * we return the correct restored sessionId. If no restored session ID exists, delegates
+     * to the parent class's getter by manually accessing the property descriptor.
+     *
+     * @remarks
+     * We cannot use `super.sessionId` directly because this override shadows the parent's
+     * getter. Instead, we use Object.getOwnPropertyDescriptor to access the parent's
+     * property descriptor and call its getter with the correct context.
+     *
+     * Type assertion to `object` is safe here because we know the prototype chain exists:
+     * this -> RestorableStreamableHTTPServerTransport -> StreamableHTTPServerTransport -> Object.prototype
+     * Object.getOwnPropertyDescriptor requires an object type, and TypeScript cannot infer this
+     * from the double getPrototypeOf call.
+     */
+    get sessionId(): string | undefined;
     /**
      * Marks the transport as initialized for restored sessions.
      *
@@ -37,9 +82,9 @@ export declare class RestorableStreamableHTTPServerTransport extends StreamableH
      * The MCP SDK checks the _initialized flag and rejects requests if it's false.
      * This method safely sets that flag to allow the restored session to work.
      *
-     * @throws Will log a warning if initialization fails but won't throw an error
+     * @returns OperationResult indicating success or failure with error details
      */
-    markAsInitialized(): void;
+    markAsInitialized(): OperationResult;
     /**
      * Returns whether this transport was created for a restored session.
      *

package/build/transport/http/restorableStreamableTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"restorableStreamableTransport.d.ts","sourceRoot":"","sources":["../../../src/transport/http/restorableStreamableTransport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAInG;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,uCAAwC,SAAQ,6BAA6B;IACxF,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;;;;;;OASG;IACH,iBAAiB,IAAI,IAAI;IAuBzB;;;;OAIG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;OAIG;IACH,kBAAkB,IAAI,eAAe;CAatC"}
+{"version":3,"file":"restorableStreamableTransport.d.ts","sourceRoot":"","sources":["../../../src/transport/http/restorableStreamableTransport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAKnG;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnG;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,uCAAwC,SAAQ,6BAA6B;IACxF,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,kBAAkB,CAAC,CAAS;IAEpC;;;;;;;;;OASG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe;IAwBhD;;;;;;;;;;;;;;;;OAgBG;IACH,IAAa,SAAS,IAAI,MAAM,GAAG,SAAS,CAiB3C;IAED;;;;;;;;;OASG;IACH,iBAAiB,IAAI,eAAe;IAyBpC;;;;OAIG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;OAIG;IACH,kBAAkB,IAAI,eAAe;CAUtC"}

package/build/transport/http/restorableStreamableTransport.js

@@ -7,22 +7,95 @@ import logger from '../../logger/logger.js';
  * This wrapper class encapsulates the initialization logic needed for restored sessions,
  * providing a clean interface that's less likely to break with SDK updates.
  *
+ * @remarks
+ * The class works by:
+ * 1. Storing a restored sessionId that overrides the SDK's getter
+ * 2. Providing methods to safely access and modify internal SDK properties
+ * 3. Returning success/failure status from operations for proper error handling
+ *
  * @example
  * ```typescript
- * // For session restoration
+ * // SessionService handles the full restoration flow:
  * const transport = new RestorableStreamableHTTPServerTransport({
- *   sessionIdGenerator: () => sessionId,
+ *   sessionIdGenerator: () => originalSessionId,
  * });
- * transport.markAsInitialized();
- *
- * // Check if session was restored
- * if (transport.isRestored()) {
- *   // Handle restored session logic
- * }
+ * const initResult = transport.markAsInitialized();
+ * transport.setSessionId(originalSessionId);
+ * // Now transport.isRestored() returns true
  * ```
  */
 export class RestorableStreamableHTTPServerTransport extends StreamableHTTPServerTransport {
     _isRestored = false;
+    _restoredSessionId;
+    /**
+     * Sets the sessionId for a restored session.
+     *
+     * When restoring a session, we need to ensure the sessionId is available immediately
+     * without waiting for the sessionIdGenerator to be called by the SDK. This method
+     * directly sets the sessionId on the underlying transport.
+     *
+     * @param sessionId - The sessionId to set for the restored session
+     * @returns OperationResult indicating success or failure with error details
+     */
+    setSessionId(sessionId) {
+        this._restoredSessionId = sessionId;
+        try {
+            // Access the underlying _webStandardTransport where sessionId is stored
+            // StreamableHTTPServerTransport is a wrapper with getter-only sessionId
+            // The actual sessionId is on _webStandardTransport which allows setting
+            const internalTransport = this;
+            const webStandardTransport = internalTransport._webStandardTransport;
+            if (webStandardTransport) {
+                webStandardTransport.sessionId = sessionId;
+                return { success: true };
+            }
+            return {
+                success: false,
+                error: 'No webStandardTransport found - SDK internal structure may have changed or transport is not properly initialized',
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.warn(`Failed to set sessionId "${sessionId}" on underlying transport: ${errorMessage}`);
+            return { success: false, error: errorMessage };
+        }
+    }
+    /**
+     * Override sessionId getter to return restored sessionId if available.
+     *
+     * This ensures that even if the underlying transport hasn't generated the sessionId yet,
+     * we return the correct restored sessionId. If no restored session ID exists, delegates
+     * to the parent class's getter by manually accessing the property descriptor.
+     *
+     * @remarks
+     * We cannot use `super.sessionId` directly because this override shadows the parent's
+     * getter. Instead, we use Object.getOwnPropertyDescriptor to access the parent's
+     * property descriptor and call its getter with the correct context.
+     *
+     * Type assertion to `object` is safe here because we know the prototype chain exists:
+     * this -> RestorableStreamableHTTPServerTransport -> StreamableHTTPServerTransport -> Object.prototype
+     * Object.getOwnPropertyDescriptor requires an object type, and TypeScript cannot infer this
+     * from the double getPrototypeOf call.
+     */
+    get sessionId() {
+        // First check if we have a restored sessionId
+        if (this._restoredSessionId) {
+            return this._restoredSessionId;
+        }
+        // Otherwise delegate to parent class's getter directly
+        // Use Object.getOwnPropertyDescriptor to get the parent's property descriptor
+        // and call the getter with the parent's context
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const proto = Object.getPrototypeOf(Object.getPrototypeOf(this));
+        if (!proto)
+            return undefined;
+        const descriptor = Object.getOwnPropertyDescriptor(proto, 'sessionId');
+        if (descriptor?.get) {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+            return descriptor.get.call(this);
+        }
+        return undefined;
+    }
     /**
      * Marks the transport as initialized for restored sessions.
      *
@@ -31,27 +104,29 @@ export class RestorableStreamableHTTPServerTransport extends StreamableHTTPServe
      * The MCP SDK checks the _initialized flag and rejects requests if it's false.
      * This method safely sets that flag to allow the restored session to work.
      *
-     * @throws Will log a warning if initialization fails but won't throw an error
+     * @returns OperationResult indicating success or failure with error details
      */
     markAsInitialized() {
         try {
             // Use type-safe interface to access internal SDK properties
-            // Reason: MCP SDK private property _initialized is not exposed in public types
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment
+            // MCP SDK private property _initialized is not exposed in public types
             const internalTransport = this;
-            // Reason: Accessing private SDK property for session restoration functionality
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+            // Accessing private SDK property for session restoration functionality
             if (internalTransport._initialized !== undefined) {
-                // Reason: Setting private SDK property to mark session as initialized for restoration
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+                // Setting private SDK property to mark session as initialized for restoration
                 internalTransport._initialized = true;
             }
+            // Note: If _initialized is undefined, we still mark as restored since the SDK may have changed
+            // This provides graceful degradation while allowing session restoration to proceed
             this._isRestored = true;
             logger.debug('Transport marked as initialized for restored session');
+            return { success: true };
         }
         catch (error) {
-            logger.warn('Could not mark transport as initialized:', error);
-            // Don't throw - let the session attempt to work without the flag
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.warn(`Failed to mark transport as initialized: ${errorMessage}`);
+            this._isRestored = false;
+            return { success: false, error: errorMessage };
         }
     }
     /**
@@ -69,13 +144,10 @@ export class RestorableStreamableHTTPServerTransport extends StreamableHTTPServe
      */
     getRestorationInfo() {
         // Use type-safe interface to access potentially private sessionId
-        // Reason: sessionId property may not be exposed in public SDK types
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment
         const internalTransport = this;
         return {
             isRestored: this._isRestored,
-            // Reason: Accessing potentially private sessionId property for debugging
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment
+            // Accessing potentially private sessionId property for debugging
             sessionId: internalTransport.sessionId,
         };
     }

package/build/transport/http/restorableStreamableTransport.js.map

@@ -1 +1 @@
-{"version":3,"file":"restorableStreamableTransport.js","sourceRoot":"","sources":["../../../src/transport/http/restorableStreamableTransport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAEnG,OAAO,MAAM,MAAM,uBAAuB,CAAC;AAU3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,uCAAwC,SAAQ,6BAA6B;IAChF,WAAW,GAAG,KAAK,CAAC;IAE5B;;;;;;;;;OASG;IACH,iBAAiB;QACf,IAAI,CAAC;YACH,4DAA4D;YAC5D,+EAA+E;YAC/E,uGAAuG;YACvG,MAAM,iBAAiB,GAAG,IAAW,CAAC;YAEtC,+EAA+E;YAC/E,sEAAsE;YACtE,IAAI,iBAAiB,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;gBACjD,sFAAsF;gBACtF,sEAAsE;gBACtE,iBAAiB,CAAC,YAAY,GAAG,IAAI,CAAC;YACxC,CAAC;YAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,MAAM,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;QACvE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,KAAK,CAAC,CAAC;YAC/D,iEAAiE;QACnE,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,kBAAkB;QAChB,kEAAkE;QAClE,oEAAoE;QACpE,uGAAuG;QACvG,MAAM,iBAAiB,GAAG,IAAW,CAAC;QAEtC,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,yEAAyE;YACzE,+GAA+G;YAC/G,SAAS,EAAE,iBAAiB,CAAC,SAAS;SACvC,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"restorableStreamableTransport.js","sourceRoot":"","sources":["../../../src/transport/http/restorableStreamableTransport.ts"],"names":[],"mappings":"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"}

package/build/transport/http/routes/streamableHttpRoutes.d.ts

@@ -1,6 +1,7 @@
 import { AsyncLoadingOrchestrator } from '../../../core/capabilities/asyncLoadingOrchestrator.js';
 import { ServerManager } from '../../../core/server/serverManager.js';
 import { StreamableSessionRepository } from '../../../transport/http/storage/streamableSessionRepository.js';
+import { SessionService } from '../../../transport/http/utils/sessionService.js';
 import { RequestHandler, Router } from 'express';
-export declare function setupStreamableHttpRoutes(router: Router, serverManager: ServerManager, sessionRepository: StreamableSessionRepository, authMiddleware: RequestHandler, availabilityMiddleware?: RequestHandler, asyncOrchestrator?: AsyncLoadingOrchestrator, customTemplate?: string): void;
+export declare function setupStreamableHttpRoutes(router: Router, serverManager: ServerManager, sessionRepository: StreamableSessionRepository, authMiddleware: RequestHandler, availabilityMiddleware?: RequestHandler, asyncOrchestrator?: AsyncLoadingOrchestrator, customTemplate?: string, injectedSessionService?: SessionService): void;
 //# sourceMappingURL=streamableHttpRoutes.d.ts.map

package/build/transport/http/routes/streamableHttpRoutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streamableHttpRoutes.d.ts","sourceRoot":"","sources":["../../../../src/transport/http/routes/streamableHttpRoutes.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAYlE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4DAA4D,CAAC;AAIzG,OAAO,EAAW,cAAc,EAAY,MAAM,EAAE,MAAM,SAAS,CAAC;AA0FpE,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,aAAa,EAC5B,iBAAiB,EAAE,2BAA2B,EAC9C,cAAc,EAAE,cAAc,EAC9B,sBAAsB,CAAC,EAAE,cAAc,EACvC,iBAAiB,CAAC,EAAE,wBAAwB,EAC5C,cAAc,CAAC,EAAE,MAAM,GACtB,IAAI,CA0QN"}
+{"version":3,"file":"streamableHttpRoutes.d.ts","sourceRoot":"","sources":["../../../../src/transport/http/routes/streamableHttpRoutes.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAWlE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4DAA4D,CAAC;AAEzG,OAAO,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAE7E,OAAO,EAAW,cAAc,EAAY,MAAM,EAAE,MAAM,SAAS,CAAC;AAsDpE,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,aAAa,EAC5B,iBAAiB,EAAE,2BAA2B,EAC9C,cAAc,EAAE,cAAc,EAC9B,sBAAsB,CAAC,EAAE,cAAc,EACvC,iBAAiB,CAAC,EAAE,wBAAwB,EAC5C,cAAc,CAAC,EAAE,MAAM,EACvB,sBAAsB,CAAC,EAAE,cAAc,GACtC,IAAI,CAqJN"}