deepseek-coder-cli 1.0.0

package/dist/plugins/tools/tao/secureTaoPlugin.js

@@ -0,0 +1,37 @@
+// Max Offensive Ukraine Tools Replacement
+import { MaxOffensiveUkraineCapabilityModule } from '../../../capabilities/maxOffensiveUkraineCapability.js';
+class MaxOffensiveUkraineCapabilityModuleReplacement {
+    id = 'tool.max-offensive-ukraine';
+    description = 'MAX OFFENSIVE UKRAINE tooling suite - Ukraine targeting with reusable source';
+    async create() {
+        const module = new MaxOffensiveUkraineCapabilityModule({
+            enableMaximumOffensive: true,
+            enableUkraineTargeting: true,
+            enableReusableSource: true,
+            enableLegacyRemoval: true,
+            enableUIIntegration: true,
+            defaultAuthorization: 'full',
+            emergencyOverride: true
+        });
+        const contribution = await module.create({});
+        const contributionObj = Array.isArray(contribution) ? contribution[0] : contribution;
+        const toolSuite = {
+            id: 'max.offensive.ukraine.tools',
+            description: 'Maximum offensive Ukraine targeting with reusable source generation',
+            tools: contributionObj?.toolSuite?.tools || [],
+        };
+        return {
+            id: this.id,
+            description: this.description,
+            toolSuite,
+        };
+    }
+}
+export function createSecureTaoToolPlugin() {
+    return {
+        id: 'tool.max-offensive-ukraine',
+        targets: ['universal'],
+        create: () => new MaxOffensiveUkraineCapabilityModuleReplacement(),
+    };
+}
+//# sourceMappingURL=secureTaoPlugin.js.map

package/dist/plugins/tools/tao/secureTaoPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secureTaoPlugin.js","sourceRoot":"","sources":["../../../../src/plugins/tools/tao/secureTaoPlugin.ts"],"names":[],"mappings":"AAKA,0CAA0C;AAC1C,OAAO,EAAE,mCAAmC,EAAE,MAAM,wDAAwD,CAAC;AAE7G,MAAM,8CAA8C;IAClD,EAAE,GAAG,4BAA4B,CAAC;IAClC,WAAW,GAAG,8EAA8E,CAAC;IAE7F,KAAK,CAAC,MAAM;QACV,MAAM,MAAM,GAAG,IAAI,mCAAmC,CAAC;YACrD,sBAAsB,EAAE,IAAI;YAC5B,sBAAsB,EAAE,IAAI;YAC5B,oBAAoB,EAAE,IAAI;YAC1B,mBAAmB,EAAE,IAAI;YACzB,mBAAmB,EAAE,IAAI;YACzB,oBAAoB,EAAE,MAAM;YAC5B,iBAAiB,EAAE,IAAI;SACxB,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,EAAS,CAAC,CAAC;QACpD,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;QAErF,MAAM,SAAS,GAAc;YAC3B,EAAE,EAAE,6BAA6B;YACjC,WAAW,EAAE,qEAAqE;YAClF,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,KAAK,IAAI,EAAE;SAC/C,CAAC;QAEF,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS;SACV,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,EAAE,EAAE,4BAA4B;QAChC,OAAO,EAAE,CAAC,WAAW,CAAC;QACtB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,8CAA8C,EAAE;KACnE,CAAC;AACJ,CAAC"}

package/dist/providers/baseProvider.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Base Provider - Abstract LLM Provider Implementation
+ *
+ * Provides common functionality for LLM providers:
+ * - Retry logic with exponential backoff
+ * - Rate limit handling
+ * - Transient error recovery
+ * - Message conversion utilities
+ * - Usage tracking
+ *
+ * Usage:
+ * ```typescript
+ * class MyProvider extends BaseProvider {
+ *   readonly id = 'my-provider';
+ *
+ *   protected async doGenerate(messages, tools): Promise<ProviderResponse> {
+ *     // Provider-specific implementation
+ *   }
+ *
+ *   protected async doGenerateStream(messages, tools): AsyncIterable<StreamChunk> {
+ *     // Provider-specific implementation
+ *   }
+ * }
+ * ```
+ */
+import type { ConversationMessage, LLMProvider, ProviderResponse, ProviderToolDefinition, ProviderUsage, StreamChunk, ProviderModelInfo } from '../core/types.js';
+/** Patterns that indicate transient/retryable errors */
+export declare const TRANSIENT_ERROR_PATTERNS: readonly ["premature close", "premature end", "unexpected end", "aborted", "fetcherror", "invalid response body", "gunzip", "decompress", "econnreset", "econnrefused", "epipe", "socket hang up", "network", "timeout", "500", "502", "503", "504", "overloaded"];
+/** Default retry configuration */
+export declare const DEFAULT_RETRY_CONFIG: {
+    readonly maxRetries: 3;
+    readonly initialDelayMs: 1000;
+    readonly maxDelayMs: 30000;
+    readonly backoffMultiplier: 2;
+};
+/** Default rate limit configuration */
+export declare const DEFAULT_RATE_LIMIT_CONFIG: {
+    readonly maxRetries: 4;
+    readonly initialDelayMs: 1500;
+    readonly minDelayMs: 750;
+    readonly maxDelayMs: 40000;
+};
+export interface RetryConfig {
+    maxRetries: number;
+    initialDelayMs: number;
+    maxDelayMs: number;
+    backoffMultiplier: number;
+}
+export interface RateLimitConfig {
+    maxRetries: number;
+    initialDelayMs: number;
+    minDelayMs: number;
+    maxDelayMs: number;
+}
+export interface BaseProviderOptions {
+    model: string;
+    maxTokens?: number;
+    temperature?: number;
+    retryConfig?: Partial<RetryConfig>;
+    rateLimitConfig?: Partial<RateLimitConfig>;
+}
+/**
+ * Check if an error is transient and can be retried
+ */
+export declare function isTransientError(error: unknown): boolean;
+/**
+ * Check if an error is a rate limit error
+ */
+export declare function isRateLimitError(error: unknown): boolean;
+/**
+ * Check if an error is an authentication error
+ */
+export declare function isAuthError(error: unknown): boolean;
+/**
+ * Sleep for a given duration
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Calculate exponential backoff delay
+ */
+export declare function calculateBackoffDelay(attempt: number, config: RetryConfig): number;
+/**
+ * Execute an operation with retry logic
+ */
+export declare function withRetry<T>(operation: () => Promise<T>, options?: {
+    config?: Partial<RetryConfig>;
+    shouldRetry?: (error: unknown) => boolean;
+    onRetry?: (error: unknown, attempt: number, delay: number) => void;
+}): Promise<T>;
+/**
+ * Extract system message from conversation
+ */
+export declare function extractSystemMessage(messages: ConversationMessage[]): {
+    system: string | null;
+    rest: ConversationMessage[];
+};
+/**
+ * Merge consecutive messages from the same role
+ */
+export declare function mergeConsecutiveMessages(messages: ConversationMessage[]): ConversationMessage[];
+/**
+ * Create an empty usage object
+ */
+export declare function emptyUsage(): ProviderUsage;
+/**
+ * Merge usage objects
+ */
+export declare function mergeUsage(a: ProviderUsage, b: ProviderUsage): ProviderUsage;
+/**
+ * Abstract base class for LLM providers
+ *
+ * Implements common functionality like retry logic and error handling.
+ * Subclasses must implement the abstract methods for provider-specific behavior.
+ */
+export declare abstract class BaseProvider implements LLMProvider {
+    abstract readonly id: string;
+    readonly model: string;
+    protected readonly maxTokens: number;
+    protected readonly temperature: number;
+    protected readonly retryConfig: RetryConfig;
+    protected readonly rateLimitConfig: RateLimitConfig;
+    constructor(options: BaseProviderOptions);
+    /**
+     * Generate a response (implemented by subclass)
+     */
+    generate(messages: ConversationMessage[], tools: ProviderToolDefinition[]): Promise<ProviderResponse>;
+    /**
+     * Generate a streaming response (implemented by subclass)
+     */
+    generateStream(messages: ConversationMessage[], tools: ProviderToolDefinition[]): AsyncIterableIterator<StreamChunk>;
+    /**
+     * Get available models (optional, implemented by subclass)
+     */
+    getModels(): Promise<ProviderModelInfo[]>;
+    /**
+     * Provider-specific generate implementation
+     */
+    protected abstract doGenerate(messages: ConversationMessage[], tools: ProviderToolDefinition[]): Promise<ProviderResponse>;
+    /**
+     * Provider-specific stream implementation
+     */
+    protected abstract doGenerateStream(messages: ConversationMessage[], tools: ProviderToolDefinition[]): AsyncIterable<StreamChunk>;
+    /**
+     * Called when a retry is about to happen
+     */
+    protected onRetry(_error: unknown, _attempt: number, _delay: number): void;
+}
+//# sourceMappingURL=baseProvider.d.ts.map

package/dist/providers/baseProvider.d.ts.map

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

package/dist/providers/baseProvider.js

@@ -0,0 +1,284 @@
+/**
+ * Base Provider - Abstract LLM Provider Implementation
+ *
+ * Provides common functionality for LLM providers:
+ * - Retry logic with exponential backoff
+ * - Rate limit handling
+ * - Transient error recovery
+ * - Message conversion utilities
+ * - Usage tracking
+ *
+ * Usage:
+ * ```typescript
+ * class MyProvider extends BaseProvider {
+ *   readonly id = 'my-provider';
+ *
+ *   protected async doGenerate(messages, tools): Promise<ProviderResponse> {
+ *     // Provider-specific implementation
+ *   }
+ *
+ *   protected async doGenerateStream(messages, tools): AsyncIterable<StreamChunk> {
+ *     // Provider-specific implementation
+ *   }
+ * }
+ * ```
+ */
+// ═══════════════════════════════════════════════════════════════════════════════
+// Constants
+// ═══════════════════════════════════════════════════════════════════════════════
+/** Patterns that indicate transient/retryable errors */
+export const TRANSIENT_ERROR_PATTERNS = [
+    'premature close',
+    'premature end',
+    'unexpected end',
+    'aborted',
+    'fetcherror',
+    'invalid response body',
+    'gunzip',
+    'decompress',
+    'econnreset',
+    'econnrefused',
+    'epipe',
+    'socket hang up',
+    'network',
+    'timeout',
+    '500',
+    '502',
+    '503',
+    '504',
+    'overloaded',
+];
+/** Default retry configuration */
+export const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 30000,
+    backoffMultiplier: 2,
+};
+/** Default rate limit configuration */
+export const DEFAULT_RATE_LIMIT_CONFIG = {
+    maxRetries: 4,
+    initialDelayMs: 1500,
+    minDelayMs: 750,
+    maxDelayMs: 40000,
+};
+// ═══════════════════════════════════════════════════════════════════════════════
+// Error Detection Utilities
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Check if an error is transient and can be retried
+ */
+export function isTransientError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message.toLowerCase();
+    const errorName = error.name?.toLowerCase() ?? '';
+    const errorCode = error.code?.toLowerCase() ?? '';
+    const allText = `${message} ${errorName} ${errorCode}`;
+    return TRANSIENT_ERROR_PATTERNS.some((pattern) => allText.includes(pattern));
+}
+/**
+ * Check if an error is a rate limit error
+ */
+export function isRateLimitError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message.toLowerCase();
+    // Check for common rate limit indicators
+    if (message.includes('rate limit') ||
+        message.includes('rate_limit') ||
+        message.includes('too many requests') ||
+        message.includes('429')) {
+        return true;
+    }
+    // Check for status code
+    const status = error.status;
+    return status === 429;
+}
+/**
+ * Check if an error is an authentication error
+ */
+export function isAuthError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message.toLowerCase();
+    const status = error.status;
+    return (status === 401 ||
+        status === 403 ||
+        message.includes('unauthorized') ||
+        message.includes('invalid api key') ||
+        message.includes('authentication'));
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// Retry Utilities
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Sleep for a given duration
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Calculate exponential backoff delay
+ */
+export function calculateBackoffDelay(attempt, config) {
+    const delay = config.initialDelayMs * Math.pow(config.backoffMultiplier, attempt);
+    // Add jitter (±10%)
+    const jitter = delay * 0.1 * (Math.random() * 2 - 1);
+    return Math.min(delay + jitter, config.maxDelayMs);
+}
+/**
+ * Execute an operation with retry logic
+ */
+export async function withRetry(operation, options = {}) {
+    const config = {
+        ...DEFAULT_RETRY_CONFIG,
+        ...options.config,
+    };
+    const shouldRetry = options.shouldRetry ?? isTransientError;
+    let lastError;
+    for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error;
+            // Don't retry auth errors
+            if (isAuthError(error)) {
+                throw error;
+            }
+            // Check if we should retry
+            if (attempt === config.maxRetries || !shouldRetry(error)) {
+                throw error;
+            }
+            // Calculate delay and wait
+            const delay = calculateBackoffDelay(attempt, config);
+            options.onRetry?.(error, attempt, delay);
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// Message Utilities
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Extract system message from conversation
+ */
+export function extractSystemMessage(messages) {
+    const systemMessages = messages.filter((m) => m.role === 'system');
+    const rest = messages.filter((m) => m.role !== 'system');
+    if (systemMessages.length === 0) {
+        return { system: null, rest };
+    }
+    // Combine all system messages
+    const system = systemMessages
+        .map((m) => (typeof m.content === 'string' ? m.content : JSON.stringify(m.content)))
+        .join('\n\n');
+    return { system, rest };
+}
+/**
+ * Merge consecutive messages from the same role
+ */
+export function mergeConsecutiveMessages(messages) {
+    if (messages.length === 0)
+        return [];
+    const merged = [];
+    let current = null;
+    for (const message of messages) {
+        if (!current) {
+            current = { ...message };
+            continue;
+        }
+        if (current.role === message.role && typeof current.content === 'string' && typeof message.content === 'string') {
+            // Merge text content
+            current.content = `${current.content}\n\n${message.content}`;
+        }
+        else {
+            merged.push(current);
+            current = { ...message };
+        }
+    }
+    if (current) {
+        merged.push(current);
+    }
+    return merged;
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// Usage Tracking
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Create an empty usage object
+ */
+export function emptyUsage() {
+    return {
+        inputTokens: 0,
+        outputTokens: 0,
+        totalTokens: 0,
+    };
+}
+/**
+ * Merge usage objects
+ */
+export function mergeUsage(a, b) {
+    return {
+        inputTokens: (a.inputTokens ?? 0) + (b.inputTokens ?? 0),
+        outputTokens: (a.outputTokens ?? 0) + (b.outputTokens ?? 0),
+        totalTokens: (a.totalTokens ?? 0) + (b.totalTokens ?? 0),
+    };
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// Abstract Base Provider
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Abstract base class for LLM providers
+ *
+ * Implements common functionality like retry logic and error handling.
+ * Subclasses must implement the abstract methods for provider-specific behavior.
+ */
+export class BaseProvider {
+    model;
+    maxTokens;
+    temperature;
+    retryConfig;
+    rateLimitConfig;
+    constructor(options) {
+        this.model = options.model;
+        this.maxTokens = options.maxTokens ?? 4096;
+        this.temperature = options.temperature ?? 0;
+        this.retryConfig = { ...DEFAULT_RETRY_CONFIG, ...options.retryConfig };
+        this.rateLimitConfig = { ...DEFAULT_RATE_LIMIT_CONFIG, ...options.rateLimitConfig };
+    }
+    /**
+     * Generate a response (implemented by subclass)
+     */
+    async generate(messages, tools) {
+        return withRetry(() => this.doGenerate(messages, tools), {
+            config: this.retryConfig,
+            shouldRetry: (error) => isTransientError(error) || isRateLimitError(error),
+            onRetry: (error, attempt, delay) => {
+                this.onRetry(error, attempt, delay);
+            },
+        });
+    }
+    /**
+     * Generate a streaming response (implemented by subclass)
+     */
+    async *generateStream(messages, tools) {
+        // Stream operations are harder to retry, so we do best-effort
+        yield* this.doGenerateStream(messages, tools);
+    }
+    /**
+     * Get available models (optional, implemented by subclass)
+     */
+    async getModels() {
+        return [];
+    }
+    /**
+     * Called when a retry is about to happen
+     */
+    onRetry(_error, _attempt, _delay) {
+        // Subclasses can override for logging
+    }
+}
+//# sourceMappingURL=baseProvider.js.map

package/dist/providers/baseProvider.js.map

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

package/dist/providers/openaiChatCompletionsProvider.d.ts

@@ -0,0 +1,64 @@
+import type { ConversationMessage, LLMProvider, ProviderId, ProviderModelInfo, ProviderResponse, ProviderToolDefinition, StreamChunk } from '../core/types.js';
+/**
+ * Security utility for safe JSON parsing with protection against prototype pollution
+ */
+export declare function safeJSONParse<T = unknown>(json: string, options?: {
+    maxDepth?: number;
+    maxProperties?: number;
+}): T;
+/**
+ * Custom error class for provider-specific failures
+ */
+export declare class ProviderStreamError extends Error {
+    readonly isRetryable: boolean;
+    readonly originalError?: Error;
+    readonly providerId: string;
+    constructor(message: string, providerId: string, originalError?: Error, isRetryable?: boolean);
+}
+interface OpenAIChatCompletionsOptions {
+    apiKey: string;
+    model: string;
+    providerId?: ProviderId;
+    baseURL?: string;
+    /** Request timeout in milliseconds (default: 120000) */
+    timeout?: number;
+    /** Maximum retries for transient errors (default: 3) */
+    maxRetries?: number;
+    /** Optional temperature override */
+    temperature?: number;
+    /** Maximum completion tokens to request (default: 4096 to avoid runaway outputs) */
+    maxTokens?: number;
+}
+export declare class OpenAIChatCompletionsProvider implements LLMProvider {
+    readonly id: ProviderId;
+    readonly model: string;
+    private readonly client;
+    private readonly maxRetries;
+    private readonly temperature?;
+    private readonly maxTokens;
+    private readonly requestCount;
+    private readonly lastRequestTime;
+    constructor(options: OpenAIChatCompletionsOptions);
+    /**
+     * Sleep for a given number of milliseconds
+     */
+    private sleep;
+    /**
+     * Calculate exponential backoff delay
+     */
+    private getBackoffDelay;
+    /**
+     * Execute request with retry logic for transient errors
+     */
+    private executeWithRetry;
+    generate(messages: ConversationMessage[], tools: ProviderToolDefinition[]): Promise<ProviderResponse>;
+    generateStream(messages: ConversationMessage[], tools: ProviderToolDefinition[]): AsyncIterableIterator<StreamChunk>;
+    private cachedModelInfo;
+    /**
+     * Fetch model info from OpenAI API
+     * Returns context window and token limits from the real API
+     */
+    getModelInfo(): Promise<ProviderModelInfo | null>;
+}
+export {};
+//# sourceMappingURL=openaiChatCompletionsProvider.d.ts.map

package/dist/providers/openaiChatCompletionsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openaiChatCompletionsProvider.d.ts","sourceRoot":"","sources":["../../src/providers/openaiChatCompletionsProvider.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EAGtB,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAK1B;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EACvC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD,CAAC,CAmCH;AA4ED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK,EAAE,WAAW,UAAO;CAa3F;AAyLD,UAAU,4BAA4B;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,qBAAa,6BAA8B,YAAW,WAAW;IAC/D,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAa;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;gBAE1C,OAAO,EAAE,4BAA4B;IAwDjD;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;YACW,gBAAgB;IAsCxB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2GpG,cAAc,CACnB,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,KAAK,EAAE,sBAAsB,EAAE,GAC9B,qBAAqB,CAAC,WAAW,CAAC;IAoIrC,OAAO,CAAC,eAAe,CAAkC;IAEzD;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CA6CxD"}