@office-ai/aioncli-core 0.2.3 → 0.18.4

package/dist/src/utils/googleQuotaErrors.js

@@ -0,0 +1,157 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { parseGoogleApiError } from './googleErrors.js';
+import { getErrorStatus, ModelNotFoundError } from './httpErrors.js';
+/**
+ * A non-retryable error indicating a hard quota limit has been reached (e.g., daily limit).
+ */
+export class TerminalQuotaError extends Error {
+    cause;
+    retryDelayMs;
+    constructor(message, cause, retryDelayMs) {
+        super(message);
+        this.cause = cause;
+        this.name = 'TerminalQuotaError';
+        this.retryDelayMs = retryDelayMs ? retryDelayMs * 1000 : undefined;
+    }
+}
+/**
+ * A retryable error indicating a temporary quota issue (e.g., per-minute limit).
+ */
+export class RetryableQuotaError extends Error {
+    cause;
+    retryDelayMs;
+    constructor(message, cause, retryDelaySeconds) {
+        super(message);
+        this.cause = cause;
+        this.name = 'RetryableQuotaError';
+        this.retryDelayMs = retryDelaySeconds * 1000;
+    }
+}
+/**
+ * Parses a duration string (e.g., "34.074824224s", "60s", "900ms") and returns the time in seconds.
+ * @param duration The duration string to parse.
+ * @returns The duration in seconds, or null if parsing fails.
+ */
+function parseDurationInSeconds(duration) {
+    if (duration.endsWith('ms')) {
+        const milliseconds = parseFloat(duration.slice(0, -2));
+        return isNaN(milliseconds) ? null : milliseconds / 1000;
+    }
+    if (duration.endsWith('s')) {
+        const seconds = parseFloat(duration.slice(0, -1));
+        return isNaN(seconds) ? null : seconds;
+    }
+    return null;
+}
+/**
+ * Analyzes a caught error and classifies it as a specific quota-related error if applicable.
+ *
+ * It decides whether an error is a `TerminalQuotaError` or a `RetryableQuotaError` based on
+ * the following logic:
+ * - If the error indicates a daily limit, it's a `TerminalQuotaError`.
+ * - If the error suggests a retry delay of more than 2 minutes, it's a `TerminalQuotaError`.
+ * - If the error suggests a retry delay of 2 minutes or less, it's a `RetryableQuotaError`.
+ * - If the error indicates a per-minute limit, it's a `RetryableQuotaError`.
+ * - If the error message contains the phrase "Please retry in X[s|ms]", it's a `RetryableQuotaError`.
+ *
+ * @param error The error to classify.
+ * @returns A `TerminalQuotaError`, `RetryableQuotaError`, or the original `unknown` error.
+ */
+export function classifyGoogleError(error) {
+    const googleApiError = parseGoogleApiError(error);
+    const status = googleApiError?.code ?? getErrorStatus(error);
+    if (status === 404) {
+        const message = googleApiError?.message ||
+            (error instanceof Error ? error.message : 'Model not found');
+        return new ModelNotFoundError(message, status);
+    }
+    if (!googleApiError || googleApiError.code !== 429) {
+        // Fallback: try to parse the error message for a retry delay
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const match = errorMessage.match(/Please retry in ([0-9.]+(?:ms|s))/);
+        if (match?.[1]) {
+            const retryDelaySeconds = parseDurationInSeconds(match[1]);
+            if (retryDelaySeconds !== null) {
+                return new RetryableQuotaError(errorMessage, googleApiError ?? {
+                    code: 429,
+                    message: errorMessage,
+                    details: [],
+                }, retryDelaySeconds);
+            }
+        }
+        return error; // Not a 429 error we can handle.
+    }
+    const quotaFailure = googleApiError.details.find((d) => d['@type'] === 'type.googleapis.com/google.rpc.QuotaFailure');
+    const errorInfo = googleApiError.details.find((d) => d['@type'] === 'type.googleapis.com/google.rpc.ErrorInfo');
+    const retryInfo = googleApiError.details.find((d) => d['@type'] === 'type.googleapis.com/google.rpc.RetryInfo');
+    // 1. Check for long-term limits in QuotaFailure or ErrorInfo
+    if (quotaFailure) {
+        for (const violation of quotaFailure.violations) {
+            const quotaId = violation.quotaId ?? '';
+            if (quotaId.includes('PerDay') || quotaId.includes('Daily')) {
+                return new TerminalQuotaError(`You have exhausted your daily quota on this model.`, googleApiError);
+            }
+        }
+    }
+    let delaySeconds;
+    if (retryInfo?.retryDelay) {
+        const parsedDelay = parseDurationInSeconds(retryInfo.retryDelay);
+        if (parsedDelay) {
+            delaySeconds = parsedDelay;
+        }
+    }
+    if (errorInfo) {
+        // New Cloud Code API quota handling
+        if (errorInfo.domain) {
+            const validDomains = [
+                'cloudcode-pa.googleapis.com',
+                'staging-cloudcode-pa.googleapis.com',
+                'autopush-cloudcode-pa.googleapis.com',
+            ];
+            if (validDomains.includes(errorInfo.domain)) {
+                if (errorInfo.reason === 'RATE_LIMIT_EXCEEDED') {
+                    return new RetryableQuotaError(`${googleApiError.message}`, googleApiError, delaySeconds ?? 10);
+                }
+                if (errorInfo.reason === 'QUOTA_EXHAUSTED') {
+                    return new TerminalQuotaError(`${googleApiError.message}`, googleApiError, delaySeconds);
+                }
+            }
+        }
+        // Existing Cloud Code API quota handling
+        const quotaLimit = errorInfo.metadata?.['quota_limit'] ?? '';
+        if (quotaLimit.includes('PerDay') || quotaLimit.includes('Daily')) {
+            return new TerminalQuotaError(`You have exhausted your daily quota on this model.`, googleApiError);
+        }
+    }
+    // 2. Check for long delays in RetryInfo
+    if (retryInfo?.retryDelay) {
+        if (delaySeconds) {
+            if (delaySeconds > 120) {
+                return new TerminalQuotaError(`${googleApiError.message}\nSuggested retry after ${retryInfo.retryDelay}.`, googleApiError, delaySeconds);
+            }
+            // This is a retryable error with a specific delay.
+            return new RetryableQuotaError(`${googleApiError.message}\nSuggested retry after ${retryInfo.retryDelay}.`, googleApiError, delaySeconds);
+        }
+    }
+    // 3. Check for short-term limits in QuotaFailure or ErrorInfo
+    if (quotaFailure) {
+        for (const violation of quotaFailure.violations) {
+            const quotaId = violation.quotaId ?? '';
+            if (quotaId.includes('PerMinute')) {
+                return new RetryableQuotaError(`${googleApiError.message}\nSuggested retry after 60s.`, googleApiError, 60);
+            }
+        }
+    }
+    if (errorInfo) {
+        const quotaLimit = errorInfo.metadata?.['quota_limit'] ?? '';
+        if (quotaLimit.includes('PerMinute')) {
+            return new RetryableQuotaError(`${errorInfo.reason}\nSuggested retry after 60s.`, googleApiError, 60);
+        }
+    }
+    return error; // Fallback to original error if no specific classification fits.
+}
+//# sourceMappingURL=googleQuotaErrors.js.map

package/dist/src/utils/googleQuotaErrors.js.map

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

package/dist/src/utils/googleQuotaErrors.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/utils/googleQuotaErrors.test.js

@@ -0,0 +1,311 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import { classifyGoogleError, RetryableQuotaError, TerminalQuotaError, } from './googleQuotaErrors.js';
+import * as errorParser from './googleErrors.js';
+describe('classifyGoogleError', () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('should return original error if not a Google API error', () => {
+        const regularError = new Error('Something went wrong');
+        vi.spyOn(errorParser, 'parseGoogleApiError').mockReturnValue(null);
+        const result = classifyGoogleError(regularError);
+        expect(result).toBe(regularError);
+    });
+    it('should return RetryableQuotaError when message contains "Please retry in Xs"', () => {
+        const complexError = {
+            error: {
+                message: '{"error": {"code": 429, "status": 429, "message": "You exceeded your current quota, please check your plan and billing details. For more information on this error, head to: https://ai.google.dev/gemini-api/docs/rate-limits. To monitor your current usage, head to: https://ai.dev/usage?tab=rate-limit. \n* Quota exceeded for metric: generativelanguage.googleapis.com/generate_content_free_tier_requests, limit: 2\nPlease retry in 44.097740004s.", "details": [{"detail": "??? to (unknown) : APP_ERROR(8) You exceeded your current quota, please check your plan and billing details. For more information on this error, head to: https://ai.google.dev/gemini-api/docs/rate-limits. To monitor your current usage, head to: https://ai.dev/usage?tab=rate-limit. \n* Quota exceeded for metric: generativelanguage.googleapis.com/generate_content_free_tier_requests, limit: 2\nPlease retry in 44.097740004s."}]}}',
+                code: 429,
+                status: 'Too Many Requests',
+            },
+        };
+        const rawError = new Error(JSON.stringify(complexError));
+        vi.spyOn(errorParser, 'parseGoogleApiError').mockReturnValue(null);
+        const result = classifyGoogleError(rawError);
+        expect(result).toBeInstanceOf(RetryableQuotaError);
+        expect(result.retryDelayMs).toBe(44097.740004);
+        expect(result.message).toBe(rawError.message);
+    });
+    it('should return RetryableQuotaError when error is a string and message contains "Please retry in Xms"', () => {
+        const complexErrorString = JSON.stringify({
+            error: {
+                message: '{"error": {"code": 429, "status": 429, "message": "You exceeded your current quota, please check your plan and billing details. For more information on this error, head to: https://ai.google.dev/gemini-api/docs/rate-limits. To monitor your current usage, head to: https://ai.dev/usage?tab=rate-limit. \n* Quota exceeded for metric: generativelanguage.googleapis.com/generate_content_free_tier_requests, limit: 2\nPlease retry in 900.2ms.", "details": [{"detail": "??? to (unknown) : APP_ERROR(8) You exceeded your current quota, please check your plan and billing details. For more information on this error, head to: https://ai.google.dev/gemini-api/docs/rate-limits. To monitor your current usage, head to: https://ai.dev/usage?tab=rate-limit. \n* Quota exceeded for metric: generativelanguage.googleapis.com/generate_content_free_tier_requests, limit: 2\nPlease retry in 900.2ms."}]}}',
+                code: 429,
+                status: 'Too Many Requests',
+            },
+        });
+        const rawError = new Error(complexErrorString);
+        vi.spyOn(errorParser, 'parseGoogleApiError').mockReturnValue(null);
+        const result = classifyGoogleError(rawError);
+        expect(result).toBeInstanceOf(RetryableQuotaError);
+        expect(result.retryDelayMs).toBeCloseTo(900.2);
+        expect(result.message).toBe(rawError.message);
+    });
+    it('should return original error if code is not 429', () => {
+        const apiError = {
+            code: 500,
+            message: 'Server error',
+            details: [],
+        };
+        vi.spyOn(errorParser, 'parseGoogleApiError').mockReturnValue(apiError);
+        const originalError = new Error();
+        const result = classifyGoogleError(originalError);
+        expect(result).toBe(originalError);
+        expect(result).not.toBeInstanceOf(TerminalQuotaError);
+        expect(result).not.toBeInstanceOf(RetryableQuotaError);
+    });
+    it('should return TerminalQuotaError for daily quota violations in QuotaFailure', () => {
+        const apiError = {
+            code: 429,
+            message: 'Quota exceeded',
+            details: [
+                {
+                    '@type': 'type.googleapis.com/google.rpc.QuotaFailure',
+                    violations: [
+                        {
+                            subject: 'user',
+                            description: 'daily limit',
+                            quotaId: 'RequestsPerDay-limit',
+                        },
+                    ],
+                },
+            ],
+        };
+        vi.spyOn(errorParser, 'parseGoogleApiError').mockReturnValue(apiError);
+        const result = classifyGoogleError(new Error());
+        expect(result).toBeInstanceOf(TerminalQuotaError);
+        expect(result.cause).toBe(apiError);
+    });
+    it('should return TerminalQuotaError for daily quota violations in ErrorInfo', () => {
+        const apiError = {
+            code: 429,
+            message: 'Quota exceeded',
+            details: [
+                {
+                    '@type': 'type.googleapis.com/google.rpc.ErrorInfo',
+                    reason: 'QUOTA_EXCEEDED',
+                    domain: 'googleapis.com',
+                    metadata: {
+                        quota_limit: 'RequestsPerDay_PerProject_PerUser',
+                    },
+                },
+            ],
+        };
+        vi.spyOn(errorParser, 'parseGoogleApiError').mockReturnValue(apiError);
+        const result = classifyGoogleError(new Error());
+        expect(result).toBeInstanceOf(TerminalQuotaError);
+    });
+    it('should return TerminalQuotaError for long retry delays', () => {
+        const apiError = {
+            code: 429,
+            message: 'Too many requests',
+            details: [
+                {
+                    '@type': 'type.googleapis.com/google.rpc.RetryInfo',
+                    retryDelay: '301s', // > 5 minutes
+                },
+            ],
+        };
+        vi.spyOn(errorParser, 'parseGoogleApiError').mockReturnValue(apiError);
+        const result = classifyGoogleError(new Error());
+        expect(result).toBeInstanceOf(TerminalQuotaError);
+    });
+    it('should return RetryableQuotaError for short retry delays', () => {
+        const apiError = {
+            code: 429,
+            message: 'Too many requests',
+            details: [
+                {
+                    '@type': 'type.googleapis.com/google.rpc.RetryInfo',
+                    retryDelay: '45.123s',
+                },
+            ],
+        };
+        vi.spyOn(errorParser, 'parseGoogleApiError').mockReturnValue(apiError);
+        const result = classifyGoogleError(new Error());
+        expect(result).toBeInstanceOf(RetryableQuotaError);
+        expect(result.retryDelayMs).toBe(45123);
+    });
+    it('should return RetryableQuotaError for per-minute quota violations in QuotaFailure', () => {
+        const apiError = {
+            code: 429,
+            message: 'Quota exceeded',
+            details: [
+                {
+                    '@type': 'type.googleapis.com/google.rpc.QuotaFailure',
+                    violations: [
+                        {
+                            subject: 'user',
+                            description: 'per minute limit',
+                            quotaId: 'RequestsPerMinute-limit',
+                        },
+                    ],
+                },
+            ],
+        };
+        vi.spyOn(errorParser, 'parseGoogleApiError').mockReturnValue(apiError);
+        const result = classifyGoogleError(new Error());
+        expect(result).toBeInstanceOf(RetryableQuotaError);
+        expect(result.retryDelayMs).toBe(60000);
+    });
+    it('should return RetryableQuotaError for per-minute quota violations in ErrorInfo', () => {
+        const apiError = {
+            code: 429,
+            message: 'Quota exceeded',
+            details: [
+                {
+                    '@type': 'type.googleapis.com/google.rpc.ErrorInfo',
+                    reason: 'QUOTA_EXCEEDED',
+                    domain: 'googleapis.com',
+                    metadata: {
+                        quota_limit: 'RequestsPerMinute_PerProject_PerUser',
+                    },
+                },
+            ],
+        };
+        vi.spyOn(errorParser, 'parseGoogleApiError').mockReturnValue(apiError);
+        const result = classifyGoogleError(new Error());
+        expect(result).toBeInstanceOf(RetryableQuotaError);
+        expect(result.retryDelayMs).toBe(60000);
+    });
+    it('should return RetryableQuotaError for another short retry delay', () => {
+        const apiError = {
+            code: 429,
+            message: 'You exceeded your current quota, please check your plan and billing details. For more information on this error, head to: https://ai.google.dev/gemini-api/docs/rate-limits.\n* Quota exceeded for metric: generativelanguage.googleapis.com/generate_content_free_tier_requests, limit: 2\nPlease retry in 56.185908122s.',
+            details: [
+                {
+                    '@type': 'type.googleapis.com/google.rpc.QuotaFailure',
+                    violations: [
+                        {
+                            quotaMetric: 'generativelanguage.googleapis.com/generate_content_free_tier_requests',
+                            quotaId: 'GenerateRequestsPerMinutePerProjectPerModel-FreeTier',
+                            quotaDimensions: {
+                                location: 'global',
+                                model: 'gemini-2.5-pro',
+                            },
+                            quotaValue: '2',
+                        },
+                    ],
+                },
+                {
+                    '@type': 'type.googleapis.com/google.rpc.Help',
+                    links: [
+                        {
+                            description: 'Learn more about Gemini API quotas',
+                            url: 'https://ai.google.dev/gemini-api/docs/rate-limits',
+                        },
+                    ],
+                },
+                {
+                    '@type': 'type.googleapis.com/google.rpc.RetryInfo',
+                    retryDelay: '56s',
+                },
+            ],
+        };
+        vi.spyOn(errorParser, 'parseGoogleApiError').mockReturnValue(apiError);
+        const result = classifyGoogleError(new Error());
+        expect(result).toBeInstanceOf(RetryableQuotaError);
+        expect(result.retryDelayMs).toBe(56000);
+    });
+    it('should return RetryableQuotaError for Cloud Code RATE_LIMIT_EXCEEDED with retry delay', () => {
+        const apiError = {
+            code: 429,
+            message: 'You have exhausted your capacity on this model. Your quota will reset after 0s.',
+            details: [
+                {
+                    '@type': 'type.googleapis.com/google.rpc.ErrorInfo',
+                    reason: 'RATE_LIMIT_EXCEEDED',
+                    domain: 'cloudcode-pa.googleapis.com',
+                    metadata: {
+                        uiMessage: 'true',
+                        model: 'gemini-2.5-pro',
+                        quotaResetDelay: '539.477544ms',
+                        quotaResetTimeStamp: '2025-10-20T19:14:08Z',
+                    },
+                },
+                {
+                    '@type': 'type.googleapis.com/google.rpc.RetryInfo',
+                    retryDelay: '0.539477544s',
+                },
+            ],
+        };
+        vi.spyOn(errorParser, 'parseGoogleApiError').mockReturnValue(apiError);
+        const result = classifyGoogleError(new Error());
+        expect(result).toBeInstanceOf(RetryableQuotaError);
+        expect(result.retryDelayMs).toBeCloseTo(539.477544);
+    });
+    it('should return TerminalQuotaError for Cloud Code QUOTA_EXHAUSTED', () => {
+        const apiError = {
+            code: 429,
+            message: 'You have exhausted your capacity on this model. Your quota will reset after 0s.',
+            details: [
+                {
+                    '@type': 'type.googleapis.com/google.rpc.ErrorInfo',
+                    reason: 'QUOTA_EXHAUSTED',
+                    domain: 'cloudcode-pa.googleapis.com',
+                    metadata: {
+                        uiMessage: 'true',
+                        model: 'gemini-2.5-pro',
+                        quotaResetDelay: '539.477544ms',
+                        quotaResetTimeStamp: '2025-10-20T19:14:08Z',
+                    },
+                },
+                {
+                    '@type': 'type.googleapis.com/google.rpc.RetryInfo',
+                    retryDelay: '0.539477544s',
+                },
+            ],
+        };
+        vi.spyOn(errorParser, 'parseGoogleApiError').mockReturnValue(apiError);
+        const result = classifyGoogleError(new Error());
+        expect(result).toBeInstanceOf(TerminalQuotaError);
+    });
+    it('should prioritize daily limit over retry info', () => {
+        const apiError = {
+            code: 429,
+            message: 'Quota exceeded',
+            details: [
+                {
+                    '@type': 'type.googleapis.com/google.rpc.QuotaFailure',
+                    violations: [
+                        {
+                            subject: 'user',
+                            description: 'daily limit',
+                            quotaId: 'RequestsPerDay-limit',
+                        },
+                    ],
+                },
+                {
+                    '@type': 'type.googleapis.com/google.rpc.RetryInfo',
+                    retryDelay: '10s',
+                },
+            ],
+        };
+        vi.spyOn(errorParser, 'parseGoogleApiError').mockReturnValue(apiError);
+        const result = classifyGoogleError(new Error());
+        expect(result).toBeInstanceOf(TerminalQuotaError);
+    });
+    it('should return original error for 429 without specific details', () => {
+        const apiError = {
+            code: 429,
+            message: 'Too many requests',
+            details: [
+                {
+                    '@type': 'type.googleapis.com/google.rpc.DebugInfo',
+                    detail: 'some debug info',
+                    stackEntries: [],
+                },
+            ],
+        };
+        vi.spyOn(errorParser, 'parseGoogleApiError').mockReturnValue(apiError);
+        const originalError = new Error();
+        const result = classifyGoogleError(originalError);
+        expect(result).toBe(originalError);
+    });
+});
+//# sourceMappingURL=googleQuotaErrors.test.js.map

package/dist/src/utils/googleQuotaErrors.test.js.map

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

package/dist/src/utils/httpErrors.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface HttpError extends Error {
+    status?: number;
+}
+/**
+ * Extracts the HTTP status code from an error object.
+ * @param error The error object.
+ * @returns The HTTP status code, or undefined if not found.
+ */
+export declare function getErrorStatus(error: unknown): number | undefined;
+export declare class ModelNotFoundError extends Error {
+    code: number;
+    constructor(message: string, code?: number);
+}

package/dist/src/utils/httpErrors.js

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Extracts the HTTP status code from an error object.
+ * @param error The error object.
+ * @returns The HTTP status code, or undefined if not found.
+ */
+export function getErrorStatus(error) {
+    if (typeof error === 'object' && error !== null) {
+        if ('status' in error && typeof error.status === 'number') {
+            return error.status;
+        }
+        // Check for error.response.status (common in axios errors)
+        if ('response' in error &&
+            typeof error.response === 'object' &&
+            error.response !== null) {
+            const response = error.response;
+            if ('status' in response && typeof response.status === 'number') {
+                return response.status;
+            }
+        }
+    }
+    return undefined;
+}
+export class ModelNotFoundError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = 'ModelNotFoundError';
+        this.code = code ? code : 404;
+    }
+}
+//# sourceMappingURL=httpErrors.js.map

package/dist/src/utils/httpErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpErrors.js","sourceRoot":"","sources":["../../../src/utils/httpErrors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,IAAI,QAAQ,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1D,OAAO,KAAK,CAAC,MAAM,CAAC;QACtB,CAAC;QACD,2DAA2D;QAC3D,IACE,UAAU,IAAI,KAAK;YACnB,OAAQ,KAAgC,CAAC,QAAQ,KAAK,QAAQ;YAC7D,KAAgC,CAAC,QAAQ,KAAK,IAAI,EACnD,CAAC;YACD,MAAM,QAAQ,GACZ,KACD,CAAC,QAAQ,CAAC;YACX,IAAI,QAAQ,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAChE,OAAO,QAAQ,CAAC,MAAM,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,IAAI,CAAS;IACb,YAAY,OAAe,EAAE,IAAa;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IAChC,CAAC;CACF"}