@defai.digital/mcp-runtime 13.0.3

package/dist/response/helpers.js

@@ -0,0 +1,235 @@
+import { DEFAULT_RESPONSE_LIMITS, isRetryableError, TIMEOUT_HEALTH_CHECK, TIMEOUT_ORCHESTRATION_GRACEFUL, } from '@defai.digital/contracts';
+// ============================================================================
+// Response Helpers
+// ============================================================================
+/**
+ * Create a success response.
+ *
+ * INV-MCP-RESP-001: Uses consistent envelope structure.
+ * INV-MCP-RESP-005: Includes duration tracking.
+ */
+export function createSuccessResponse(data, options = {}) {
+    const response = {
+        success: true,
+        data,
+    };
+    // Add metadata if any tracking info provided
+    if (options.startTime !== undefined || options.cached || options.truncated) {
+        response.metadata = {
+            durationMs: options.startTime ? Date.now() - options.startTime : 0,
+            cached: options.cached ?? false,
+            truncated: options.truncated ?? false,
+            originalSizeBytes: options.originalSizeBytes,
+            requestId: options.requestId,
+        };
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+    };
+}
+/**
+ * Create an error response.
+ *
+ * INV-MCP-RESP-001: Uses consistent envelope structure.
+ * INV-MCP-RESP-002: Includes error code.
+ * INV-MCP-RESP-006: Sets retryable based on error code.
+ */
+export function createErrorResponse(code, message, options = {}) {
+    const error = {
+        code,
+        message,
+        context: options.context,
+        retryable: isRetryableError(code),
+        retryAfterMs: options.retryAfterMs,
+    };
+    const response = {
+        success: false,
+        error,
+    };
+    // Add metadata
+    if (options.startTime !== undefined || options.requestId) {
+        response.metadata = {
+            durationMs: options.startTime ? Date.now() - options.startTime : 0,
+            cached: false,
+            truncated: false,
+            requestId: options.requestId,
+        };
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+        isError: true,
+    };
+}
+/**
+ * Create a list response with pagination.
+ *
+ * INV-MCP-RESP-003: Enforces list item limits.
+ */
+export function createListResponse(items, options = {}) {
+    const limits = options.limits ?? DEFAULT_RESPONSE_LIMITS;
+    const limit = Math.min(options.limit ?? limits.maxListItems, limits.maxListItems);
+    const offset = options.offset ?? 0;
+    const total = options.total ?? items.length;
+    // Apply limit
+    const limitedItems = items.slice(0, limit);
+    const truncated = items.length > limit;
+    const pagination = {
+        total,
+        limit,
+        offset,
+        hasMore: offset + limitedItems.length < total,
+    };
+    const data = {
+        items: limitedItems,
+        pagination,
+    };
+    const successOptions = { truncated };
+    if (options.startTime !== undefined) {
+        successOptions.startTime = options.startTime;
+    }
+    if (options.requestId !== undefined) {
+        successOptions.requestId = options.requestId;
+    }
+    return createSuccessResponse(data, successOptions);
+}
+/**
+ * Create a not found error response.
+ */
+export function createNotFoundResponse(resourceType, resourceId, options = {}) {
+    const errorOptions = { context: { resourceType, resourceId } };
+    if (options.startTime !== undefined) {
+        errorOptions.startTime = options.startTime;
+    }
+    if (options.requestId !== undefined) {
+        errorOptions.requestId = options.requestId;
+    }
+    return createErrorResponse('NOT_FOUND', `${resourceType} not found: ${resourceId}`, errorOptions);
+}
+/**
+ * Create a validation error response.
+ */
+export function createValidationErrorResponse(message, errors, options = {}) {
+    const errorOptions = { context: { validationErrors: errors } };
+    if (options.startTime !== undefined) {
+        errorOptions.startTime = options.startTime;
+    }
+    if (options.requestId !== undefined) {
+        errorOptions.requestId = options.requestId;
+    }
+    return createErrorResponse('INVALID_INPUT', message, errorOptions);
+}
+/**
+ * Create a timeout error response.
+ */
+export function createTimeoutResponse(timeoutMs, options = {}) {
+    const errorOptions = {
+        context: { timeoutMs },
+        retryAfterMs: Math.min(timeoutMs, TIMEOUT_HEALTH_CHECK),
+    };
+    if (options.startTime !== undefined) {
+        errorOptions.startTime = options.startTime;
+    }
+    if (options.requestId !== undefined) {
+        errorOptions.requestId = options.requestId;
+    }
+    return createErrorResponse('TOOL_TIMEOUT', `Operation timed out after ${timeoutMs}ms`, errorOptions);
+}
+/**
+ * Create a memory pressure error response.
+ */
+export function createMemoryPressureResponse(pressureLevel, options = {}) {
+    const errorOptions = {
+        context: { pressureLevel },
+        retryAfterMs: TIMEOUT_ORCHESTRATION_GRACEFUL,
+    };
+    if (options.startTime !== undefined) {
+        errorOptions.startTime = options.startTime;
+    }
+    if (options.requestId !== undefined) {
+        errorOptions.requestId = options.requestId;
+    }
+    return createErrorResponse('MEMORY_PRESSURE', `Operation rejected due to ${pressureLevel} memory pressure`, errorOptions);
+}
+/**
+ * Create an internal error response.
+ */
+export function createInternalErrorResponse(error, options = {}) {
+    const errorOptions = {
+        context: {
+            errorName: error.name,
+            // Don't include stack in production
+            ...(process.env.NODE_ENV === 'development' && { stack: error.stack }),
+        },
+    };
+    if (options.startTime !== undefined) {
+        errorOptions.startTime = options.startTime;
+    }
+    if (options.requestId !== undefined) {
+        errorOptions.requestId = options.requestId;
+    }
+    return createErrorResponse('INTERNAL_ERROR', error.message, errorOptions);
+}
+// ============================================================================
+// Truncation Helpers
+// ============================================================================
+/**
+ * Truncate a string to max length.
+ *
+ * INV-MCP-RESP-003: Enforces string length limits.
+ * INV-MCP-RESP-004: Adds truncation indicator.
+ */
+export function truncateString(str, maxLength, suffix = '... [truncated]') {
+    if (str.length <= maxLength) {
+        return { text: str, truncated: false };
+    }
+    const truncatedLength = maxLength - suffix.length;
+    return {
+        text: str.slice(0, truncatedLength) + suffix,
+        truncated: true,
+    };
+}
+/**
+ * Truncate response data to fit within size limits.
+ *
+ * INV-MCP-RESP-003: Enforces response size limits.
+ * INV-MCP-RESP-004: Sets truncated flag.
+ */
+export function truncateResponse(data, limits = DEFAULT_RESPONSE_LIMITS) {
+    const serialized = JSON.stringify(data);
+    const originalSizeBytes = serialized.length * 2; // Approximate UTF-8 size
+    if (originalSizeBytes <= limits.maxResponseBytes) {
+        return { data, truncated: false, originalSizeBytes };
+    }
+    // For arrays, reduce items
+    if (Array.isArray(data)) {
+        const targetItems = Math.floor((limits.maxResponseBytes / originalSizeBytes) * data.length * 0.8);
+        return {
+            data: data.slice(0, Math.max(1, targetItems)),
+            truncated: true,
+            originalSizeBytes,
+        };
+    }
+    // For strings, truncate directly
+    if (typeof data === 'string') {
+        const result = truncateString(data, Math.floor(limits.maxResponseBytes / 2), limits.truncationSuffix);
+        return {
+            data: result.text,
+            truncated: result.truncated,
+            originalSizeBytes,
+        };
+    }
+    // For objects, try to reduce nested arrays/strings
+    // This is a simplified approach - complex objects may need custom handling
+    return { data, truncated: false, originalSizeBytes };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/response/helpers.js.map

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

package/dist/response/index.d.ts

@@ -0,0 +1,2 @@
+export { type MCPToolResult, type SuccessResponseData, type ErrorResponseData, type ResponseData, createSuccessResponse, createErrorResponse, createListResponse, createNotFoundResponse, createValidationErrorResponse, createTimeoutResponse, createMemoryPressureResponse, createInternalErrorResponse, truncateString, truncateResponse, } from './helpers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/response/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/response/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAGjB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAG3B,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC"}

package/dist/response/index.js

@@ -0,0 +1,6 @@
+export { 
+// Response helpers
+createSuccessResponse, createErrorResponse, createListResponse, createNotFoundResponse, createValidationErrorResponse, createTimeoutResponse, createMemoryPressureResponse, createInternalErrorResponse, 
+// Truncation helpers
+truncateString, truncateResponse, } from './helpers.js';
+//# sourceMappingURL=index.js.map

package/dist/response/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/response/index.ts"],"names":[],"mappings":"AAAA,OAAO;AAOL,mBAAmB;AACnB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B;AAE3B,qBAAqB;AACrB,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC"}

package/dist/timeout/index.d.ts

@@ -0,0 +1,2 @@
+export { DEFAULT_TIMEOUT_CONFIG, TimeoutError, withTimeout, withToolTimeout, createTimeoutWrapper, getToolCategory, isTimeoutResult, isSuccessResult, unwrapResult, } from './wrapper.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/timeout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/timeout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,GACb,MAAM,cAAc,CAAC"}

package/dist/timeout/index.js

@@ -0,0 +1,2 @@
+export { DEFAULT_TIMEOUT_CONFIG, TimeoutError, withTimeout, withToolTimeout, createTimeoutWrapper, getToolCategory, isTimeoutResult, isSuccessResult, unwrapResult, } from './wrapper.js';
+//# sourceMappingURL=index.js.map

package/dist/timeout/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/timeout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,GACb,MAAM,cAAc,CAAC"}

package/dist/timeout/wrapper.d.ts

@@ -0,0 +1,52 @@
+import type { MCPTimeoutConfig, TimeoutResult, ToolCategory } from '@defai.digital/contracts';
+/**
+ * Default timeout configuration.
+ */
+export declare const DEFAULT_TIMEOUT_CONFIG: MCPTimeoutConfig;
+/**
+ * Timeout error class for identification.
+ */
+export declare class TimeoutError extends Error {
+    readonly code = "TOOL_TIMEOUT";
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number, message?: string);
+}
+/**
+ * Wrap an async operation with timeout protection.
+ *
+ * Invariants enforced:
+ * - INV-MCP-TIMEOUT-001: Guaranteed termination
+ * - INV-MCP-TIMEOUT-004: Returns TOOL_TIMEOUT error code
+ * - INV-MCP-TIMEOUT-005: Duration tracking
+ */
+export declare function withTimeout<T>(operation: () => Promise<T>, timeoutMs: number): Promise<TimeoutResult>;
+/**
+ * Wrap a tool handler with timeout protection.
+ *
+ * Invariants enforced:
+ * - INV-MCP-TIMEOUT-002: Category consistency
+ * - INV-MCP-TIMEOUT-003: Override precedence
+ */
+export declare function withToolTimeout<TArgs, TResult>(toolName: string, handler: (args: TArgs) => Promise<TResult>, config?: MCPTimeoutConfig): (args: TArgs) => Promise<TimeoutResult>;
+/**
+ * Create a timeout-wrapped handler factory.
+ */
+export declare function createTimeoutWrapper(config?: MCPTimeoutConfig): <TArgs, TResult>(toolName: string, handler: (args: TArgs) => Promise<TResult>) => (args: TArgs) => Promise<TimeoutResult>;
+/**
+ * Get the category for a tool.
+ */
+export declare function getToolCategory(toolName: string): ToolCategory | undefined;
+/**
+ * Check if a result is a timeout.
+ */
+export declare function isTimeoutResult(result: TimeoutResult): boolean;
+/**
+ * Check if a result is successful.
+ */
+export declare function isSuccessResult(result: TimeoutResult): boolean;
+/**
+ * Extract the result value from a successful TimeoutResult.
+ * Throws if result is not successful.
+ */
+export declare function unwrapResult<T>(result: TimeoutResult): T;
+//# sourceMappingURL=wrapper.d.ts.map

package/dist/timeout/wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../../src/timeout/wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,YAAY,EACb,MAAM,0BAA0B,CAAC;AAGlC;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,gBASpC,CAAC;AAEF;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAKhD;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CAiDxB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAC5C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,EAC1C,MAAM,GAAE,gBAAyC,GAChD,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,aAAa,CAAC,CAMzC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,GAAE,gBAAyC,IAErB,KAAK,EAAE,OAAO,EACxC,UAAU,MAAM,EAChB,SAAS,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,KACzC,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,aAAa,CAAC,CAG3C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE1E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAE9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAE9D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,GAAG,CAAC,CAQxD"}

package/dist/timeout/wrapper.js

@@ -0,0 +1,133 @@
+import { TOOL_CATEGORIES, getToolTimeout } from '@defai.digital/contracts';
+/**
+ * Default timeout configuration.
+ */
+export const DEFAULT_TIMEOUT_CONFIG = {
+    defaultTimeoutMs: 30_000,
+    toolTimeouts: {
+        query: 10_000, // 10 seconds
+        mutation: 30_000, // 30 seconds
+        scan: 120_000, // 2 minutes
+        execution: 1_200_000, // 20 minutes
+    },
+    toolOverrides: {},
+};
+/**
+ * Timeout error class for identification.
+ */
+export class TimeoutError extends Error {
+    code = 'TOOL_TIMEOUT';
+    timeoutMs;
+    constructor(timeoutMs, message) {
+        super(message ?? `Operation timed out after ${timeoutMs}ms`);
+        this.name = 'TimeoutError';
+        this.timeoutMs = timeoutMs;
+    }
+}
+/**
+ * Wrap an async operation with timeout protection.
+ *
+ * Invariants enforced:
+ * - INV-MCP-TIMEOUT-001: Guaranteed termination
+ * - INV-MCP-TIMEOUT-004: Returns TOOL_TIMEOUT error code
+ * - INV-MCP-TIMEOUT-005: Duration tracking
+ */
+export async function withTimeout(operation, timeoutMs) {
+    const startTime = Date.now();
+    // Create timeout promise
+    let timeoutId;
+    const timeoutPromise = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            reject(new TimeoutError(timeoutMs));
+        }, timeoutMs);
+    });
+    try {
+        // Race between operation and timeout
+        const result = await Promise.race([operation(), timeoutPromise]);
+        // Clear timeout if operation completed first
+        if (timeoutId)
+            clearTimeout(timeoutId);
+        return {
+            status: 'completed',
+            result,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    catch (error) {
+        // Clear timeout
+        if (timeoutId)
+            clearTimeout(timeoutId);
+        const durationMs = Date.now() - startTime;
+        // Check if it was a timeout
+        if (error instanceof TimeoutError) {
+            return {
+                status: 'timeout',
+                timeoutMs: error.timeoutMs,
+                durationMs,
+            };
+        }
+        // Other error
+        return {
+            status: 'error',
+            error: {
+                code: error instanceof Error ? error.name : 'UNKNOWN_ERROR',
+                message: error instanceof Error ? error.message : String(error),
+                stack: error instanceof Error ? error.stack : undefined,
+            },
+            durationMs,
+        };
+    }
+}
+/**
+ * Wrap a tool handler with timeout protection.
+ *
+ * Invariants enforced:
+ * - INV-MCP-TIMEOUT-002: Category consistency
+ * - INV-MCP-TIMEOUT-003: Override precedence
+ */
+export function withToolTimeout(toolName, handler, config = DEFAULT_TIMEOUT_CONFIG) {
+    const timeoutMs = getToolTimeout(toolName, config);
+    return async (args) => {
+        return withTimeout(() => handler(args), timeoutMs);
+    };
+}
+/**
+ * Create a timeout-wrapped handler factory.
+ */
+export function createTimeoutWrapper(config = DEFAULT_TIMEOUT_CONFIG) {
+    return function wrapHandler(toolName, handler) {
+        return withToolTimeout(toolName, handler, config);
+    };
+}
+/**
+ * Get the category for a tool.
+ */
+export function getToolCategory(toolName) {
+    return TOOL_CATEGORIES[toolName];
+}
+/**
+ * Check if a result is a timeout.
+ */
+export function isTimeoutResult(result) {
+    return result.status === 'timeout';
+}
+/**
+ * Check if a result is successful.
+ */
+export function isSuccessResult(result) {
+    return result.status === 'completed';
+}
+/**
+ * Extract the result value from a successful TimeoutResult.
+ * Throws if result is not successful.
+ */
+export function unwrapResult(result) {
+    if (result.status !== 'completed') {
+        if (result.status === 'timeout') {
+            throw new TimeoutError(result.timeoutMs);
+        }
+        throw new Error(result.error.message);
+    }
+    return result.result;
+}
+//# sourceMappingURL=wrapper.js.map

package/dist/timeout/wrapper.js.map

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

package/dist/validation/index.d.ts

@@ -0,0 +1,2 @@
+export { validateRequest, createValidationMiddleware, isValidRequest, formatValidationErrors, } from './request-validator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,cAAc,EACd,sBAAsB,GACvB,MAAM,wBAAwB,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,2 @@
+export { validateRequest, createValidationMiddleware, isValidRequest, formatValidationErrors, } from './request-validator.js';
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,cAAc,EACd,sBAAsB,GACvB,MAAM,wBAAwB,CAAC"}

package/dist/validation/request-validator.d.ts

@@ -0,0 +1,28 @@
+import type { MCPRequestLimits, ValidationResult, ValidationError } from '@defai.digital/contracts';
+/**
+ * Validate request against limits.
+ *
+ * Invariants enforced:
+ * - INV-MCP-LIMIT-001: Array size enforcement
+ * - INV-MCP-LIMIT-002: Early rejection
+ * - INV-MCP-LIMIT-003: Tool-specific limits
+ * - INV-MCP-LIMIT-004: Descriptive errors
+ */
+export declare function validateRequest(toolName: string, args: unknown, limits?: MCPRequestLimits): ValidationResult;
+/**
+ * Create a validation middleware for tool handlers.
+ *
+ * INV-MCP-LIMIT-002: Early rejection.
+ */
+export declare function createValidationMiddleware(limits?: MCPRequestLimits): (toolName: string, args: unknown) => ValidationResult;
+/**
+ * Check if a validation result indicates success.
+ */
+export declare function isValidRequest(result: ValidationResult): result is {
+    valid: true;
+};
+/**
+ * Format validation errors for display.
+ */
+export declare function formatValidationErrors(errors: ValidationError[]): string;
+//# sourceMappingURL=request-validator.d.ts.map

package/dist/validation/request-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-validator.d.ts","sourceRoot":"","sources":["../../src/validation/request-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAOlC;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,MAAM,GAAE,gBAAyC,GAChD,gBAAgB,CAuBlB;AA6HD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,GAAE,gBAAyC,IAG/C,UAAU,MAAM,EAChB,MAAM,OAAO,KACZ,gBAAgB,CAGpB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,CAElF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAUxE"}