codehere 0.2.0 → 0.4.0

package/dist/infrastructure/providers/cohere-provider.js

@@ -0,0 +1,359 @@
+/**
+ * Provider Layer: CohereProvider
+ * Thin wrapper implementing IModelProvider for Cohere API
+ *
+ * Phase 4A: Foundation Implementation (No Behavior Change)
+ *
+ * TODO: In Phase 4B, integrate with CohereAIService context compression and prompt building.
+ * For now, this is a minimal wrapper that preserves existing Cohere behavior.
+ */
+import { CohereClient } from 'cohere-ai';
+import { config } from 'dotenv';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { encoding_for_model } from 'tiktoken';
+import { retryWithBackoff, cohereCircuitBreaker } from '../../error-handler.js';
+// Load .env (same pattern as CohereAIService)
+try {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const agentDir = join(__dirname, '../../../..');
+    config({ path: join(agentDir, '.env') });
+}
+catch { }
+config();
+// Token counting (same as CohereAIService for consistency)
+let tokenEncoder = null;
+function getTokenEncoder() {
+    if (!tokenEncoder) {
+        try {
+            tokenEncoder = encoding_for_model('gpt-3.5-turbo');
+        }
+        catch {
+            tokenEncoder = encoding_for_model('gpt-4');
+        }
+    }
+    return tokenEncoder;
+}
+function countTokens(text) {
+    try {
+        const encoder = getTokenEncoder();
+        return encoder.encode(text).length;
+    }
+    catch (error) {
+        console.warn('Warning: tiktoken failed, using character-based estimate (less accurate)');
+        return Math.ceil(text.length / 4);
+    }
+}
+/**
+ * Cohere Provider
+ * Minimal wrapper around CohereClient implementing IModelProvider
+ */
+export class CohereProvider {
+    id = 'cohere';
+    name = 'Cohere';
+    capabilities = {
+        chat: true,
+        streaming: true,
+        embedding: true,
+        embeddingQuery: true, // Cohere supports separate query embeddings
+        rerank: true,
+        toolCalling: true, // Cohere supports tool calling
+    };
+    client;
+    constructor(apiKey) {
+        const key = apiKey || process.env.COHERE_API_KEY;
+        if (!key) {
+            throw new Error('COHERE_API_KEY not found in environment');
+        }
+        this.client = new CohereClient({ token: key });
+    }
+    async getModels() {
+        // TODO: In Phase 4B, fetch available models from Cohere API if possible
+        // For now, return known Cohere models
+        return [
+            {
+                id: 'command-r-plus',
+                name: 'Command R+',
+                providerId: 'cohere',
+                providerModelId: 'command-r-plus',
+                contextWindow: 128000,
+                capabilities: {
+                    chat: true,
+                    streaming: true,
+                    embedding: false,
+                    embeddingQuery: false,
+                    rerank: false,
+                    toolCalling: true,
+                },
+            },
+            {
+                id: 'embed-english-v3',
+                name: 'Embed English v3.0',
+                providerId: 'cohere',
+                providerModelId: 'embed-english-v3.0',
+                contextWindow: 512,
+                capabilities: {
+                    chat: false,
+                    streaming: false,
+                    embedding: true,
+                    embeddingQuery: true,
+                    rerank: false,
+                    toolCalling: false,
+                },
+            },
+            {
+                id: 'rerank-english-v3',
+                name: 'Rerank English v3.0',
+                providerId: 'cohere',
+                providerModelId: 'rerank-english-v3.0',
+                contextWindow: 4096,
+                capabilities: {
+                    chat: false,
+                    streaming: false,
+                    embedding: false,
+                    embeddingQuery: false,
+                    rerank: true,
+                    toolCalling: false,
+                },
+            },
+        ];
+    }
+    getDefaultModel() {
+        return 'command-r-plus';
+    }
+    async chat(prompt, options) {
+        const model = options?.model || this.getDefaultModel();
+        return await retryWithBackoff(async () => {
+            return await cohereCircuitBreaker.execute(async () => {
+                const response = await this.client.chat({
+                    message: prompt,
+                    ...(model ? { model } : {}),
+                    temperature: options?.temperature ?? 0.7,
+                    ...(options?.maxTokens ? { maxTokens: options.maxTokens } : {}),
+                });
+                const text = response.text || 'No response generated';
+                const inputTokens = countTokens(prompt);
+                const outputTokens = countTokens(text);
+                return {
+                    text,
+                    model: model || 'default',
+                    usage: {
+                        inputTokens,
+                        outputTokens,
+                    },
+                };
+            });
+        }, {
+            maxRetries: 5,
+            baseDelay: 2000,
+            maxDelay: 60000,
+            operationName: 'cohere-provider-chat',
+        });
+    }
+    async chatStream(prompt, options, onEvent) {
+        const model = options?.model || this.getDefaultModel();
+        let fullText = '';
+        try {
+            if (onEvent) {
+                onEvent({ type: 'start' });
+            }
+            // Check if Cohere SDK supports streaming
+            if (typeof this.client.chatStream === 'function') {
+                const stream = await this.client.chatStream({
+                    message: prompt,
+                    ...(model ? { model } : {}),
+                    temperature: options?.temperature ?? 0.7,
+                });
+                for await (const event of stream) {
+                    if (event.eventType === 'text-generation' || event.type === 'text') {
+                        const token = event.text || event.delta || '';
+                        if (token) {
+                            fullText += token;
+                            if (onEvent) {
+                                onEvent({ type: 'delta', text: token });
+                            }
+                        }
+                    }
+                }
+            }
+            else {
+                // Fallback: Use regular chat
+                const response = await this.chat(prompt, options);
+                fullText = response.text;
+                // Simulate streaming by sending chunks
+                if (onEvent && fullText.length > 0) {
+                    const chunkSize = 10;
+                    for (let i = 0; i < fullText.length; i += chunkSize) {
+                        const chunk = fullText.substring(i, i + chunkSize);
+                        onEvent({ type: 'delta', text: chunk });
+                        if (fullText.length > chunkSize * 2) {
+                            await new Promise(resolve => setTimeout(resolve, 50));
+                        }
+                    }
+                }
+            }
+            if (onEvent) {
+                onEvent({ type: 'complete' });
+            }
+            const inputTokens = countTokens(prompt);
+            const outputTokens = countTokens(fullText);
+            return {
+                text: fullText,
+                model: model || 'default',
+                usage: {
+                    inputTokens,
+                    outputTokens,
+                },
+            };
+        }
+        catch (error) {
+            if (onEvent) {
+                onEvent({
+                    type: 'error',
+                    error: error instanceof Error ? error : new Error(String(error)),
+                });
+            }
+            throw error;
+        }
+    }
+    async embed(text) {
+        const texts = Array.isArray(text) ? text : [text];
+        return await retryWithBackoff(async () => {
+            return await cohereCircuitBreaker.execute(async () => {
+                const response = await this.client.embed({
+                    texts,
+                    model: 'embed-english-v3.0',
+                    inputType: 'search_document',
+                });
+                const embeddings = response.embeddings;
+                if (texts.length === 1) {
+                    return embeddings[0];
+                }
+                return embeddings;
+            });
+        }, {
+            maxRetries: 5,
+            baseDelay: 2000,
+            maxDelay: 60000,
+            operationName: 'cohere-provider-embed',
+        });
+    }
+    async embedQuery(query) {
+        return await retryWithBackoff(async () => {
+            return await cohereCircuitBreaker.execute(async () => {
+                const response = await this.client.embed({
+                    texts: [query],
+                    model: 'embed-english-v3.0',
+                    inputType: 'search_query',
+                });
+                const embeddings = response.embeddings;
+                if (Array.isArray(embeddings)) {
+                    if (embeddings.length === 0) {
+                        throw new Error('No embedding returned for query');
+                    }
+                    return embeddings[0] || [];
+                }
+                else {
+                    const embeddingsArray = embeddings.float || [];
+                    if (embeddingsArray.length === 0) {
+                        throw new Error('No embedding returned for query');
+                    }
+                    return embeddingsArray[0] || [];
+                }
+            });
+        }, {
+            maxRetries: 5,
+            baseDelay: 2000,
+            maxDelay: 60000,
+            operationName: 'cohere-provider-embed-query',
+        });
+    }
+    async rerank(query, documents, options) {
+        if (documents.length === 0) {
+            return {
+                results: [],
+                model: 'rerank-english-v3.0',
+            };
+        }
+        // Cohere Rerank API has limits, so we cap at 100 documents
+        const documentsToRerank = documents.slice(0, 100);
+        const topN = Math.min(options?.topN ?? 10, documentsToRerank.length);
+        const model = options?.model || 'rerank-english-v3.0';
+        return await retryWithBackoff(async () => {
+            return await cohereCircuitBreaker.execute(async () => {
+                const response = await this.client.rerank({
+                    model,
+                    query,
+                    documents: documentsToRerank,
+                    topN,
+                });
+                const results = (response.results || []).map((result) => ({
+                    index: result.index,
+                    relevanceScore: result.relevanceScore || 0,
+                }));
+                return {
+                    results,
+                    model,
+                };
+            });
+        }, {
+            maxRetries: 3,
+            baseDelay: 2000,
+            maxDelay: 30000,
+            operationName: 'cohere-provider-rerank',
+        });
+    }
+    async countTokens(text, _model) {
+        // TODO: In Phase 4B, use Cohere-specific tokenizer if available
+        // For now, use same tiktoken approach as CohereAIService
+        return Promise.resolve(countTokens(text));
+    }
+    async isAvailable() {
+        try {
+            // Simple availability check - try to get models
+            await this.getModels();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    handleError(error) {
+        if (error && typeof error === 'object') {
+            const err = error;
+            // Check for rate limiting (429)
+            if (err.statusCode === 429 || err.status === 429) {
+                return {
+                    type: 'rate_limit',
+                    retryable: false,
+                    message: 'Rate limit exceeded',
+                };
+            }
+            // Check for trial key quota
+            const errorMsg = err.message || String(error);
+            if (errorMsg.includes('Trial key') && errorMsg.includes('1000 API calls')) {
+                return {
+                    type: 'quota_exceeded',
+                    retryable: false,
+                    message: 'Trial API key has reached monthly limit (1000 calls/month)',
+                };
+            }
+            // Check for authentication errors
+            if (err.statusCode === 401 || err.status === 401) {
+                return {
+                    type: 'auth_error',
+                    retryable: false,
+                    message: 'Authentication failed - check API key',
+                };
+            }
+        }
+        // Default to retryable error
+        return {
+            type: 'unknown',
+            retryable: true,
+            message: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+//# sourceMappingURL=cohere-provider.js.map

package/dist/infrastructure/providers/cohere-provider.js.map

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

package/dist/infrastructure/providers/fake-provider.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Provider Layer: FakeProvider
+ * Deterministic test provider implementing IModelProvider
+ *
+ * Phase 4D: FakeProvider Implementation
+ * Provides deterministic outputs for testing and local demos without external API calls
+ */
+import type { IModelProvider, ProviderCapabilities, ModelInfo, ChatOptions, ChatResponse, StreamEvent, RerankResponse } from './model-provider.interface.js';
+/**
+ * FakeProvider
+ * Deterministic provider for testing and demos
+ *
+ * Behavior:
+ * - Chat: Returns deterministic responses based on query
+ * - Streaming: Simulates streaming by sending words incrementally
+ * - Embeddings: Returns fixed-size zero vectors (768 dimensions)
+ * - Rerank: Returns documents in original order with fake scores
+ * - No external HTTP calls
+ */
+export declare class FakeProvider implements IModelProvider {
+    readonly id = "fake";
+    readonly name = "Fake Provider";
+    readonly capabilities: ProviderCapabilities;
+    private defaultModel;
+    getModels(): Promise<ModelInfo[]>;
+    getDefaultModel(): string;
+    chat(prompt: string, options?: ChatOptions): Promise<ChatResponse>;
+    chatStream(prompt: string, options?: ChatOptions, onEvent?: (event: StreamEvent) => void): Promise<ChatResponse>;
+    embed(text: string | string[]): Promise<number[] | number[][]>;
+    embedQuery(query: string): Promise<number[]>;
+    rerank(query: string, documents: string[], options?: {
+        topN?: number;
+        model?: string;
+    }): Promise<RerankResponse>;
+    countTokens(text: string, _model?: string): Promise<number>;
+    isAvailable(): Promise<boolean>;
+    handleError?(error: unknown): {
+        type: string;
+        retryable: boolean;
+        message: string;
+    };
+}
+//# sourceMappingURL=fake-provider.d.ts.map

package/dist/infrastructure/providers/fake-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-provider.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/providers/fake-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EACX,cAAc,EAEf,MAAM,+BAA+B,CAAC;AAEvC;;;;;;;;;;GAUG;AACH,qBAAa,YAAa,YAAW,cAAc;IACjD,QAAQ,CAAC,EAAE,UAAU;IACrB,QAAQ,CAAC,IAAI,mBAAmB;IAEhC,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAOzC;IAEF,OAAO,CAAC,YAAY,CAAmB;IAEjC,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAavC,eAAe,IAAI,MAAM;IAInB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAqBlE,UAAU,CACd,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GACrC,OAAO,CAAC,YAAY,CAAC;IA0BlB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC;IAY9D,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAM5C,MAAM,CACV,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1C,OAAO,CAAC,cAAc,CAAC;IAgBpB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM3D,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAKrC,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CASpF"}

package/dist/infrastructure/providers/fake-provider.js

@@ -0,0 +1,130 @@
+/**
+ * Provider Layer: FakeProvider
+ * Deterministic test provider implementing IModelProvider
+ *
+ * Phase 4D: FakeProvider Implementation
+ * Provides deterministic outputs for testing and local demos without external API calls
+ */
+/**
+ * FakeProvider
+ * Deterministic provider for testing and demos
+ *
+ * Behavior:
+ * - Chat: Returns deterministic responses based on query
+ * - Streaming: Simulates streaming by sending words incrementally
+ * - Embeddings: Returns fixed-size zero vectors (768 dimensions)
+ * - Rerank: Returns documents in original order with fake scores
+ * - No external HTTP calls
+ */
+export class FakeProvider {
+    id = 'fake';
+    name = 'Fake Provider';
+    capabilities = {
+        chat: true,
+        streaming: true,
+        embedding: true,
+        embeddingQuery: true,
+        rerank: true,
+        toolCalling: false,
+    };
+    defaultModel = 'fake-model-v1';
+    async getModels() {
+        return [
+            {
+                id: 'fake-model-v1',
+                name: 'Fake Model v1',
+                providerId: this.id,
+                providerModelId: 'fake-model-v1',
+                contextWindow: 4096,
+                capabilities: { ...this.capabilities },
+            },
+        ];
+    }
+    getDefaultModel() {
+        return this.defaultModel;
+    }
+    async chat(prompt, options) {
+        // Deterministic response based on prompt
+        // Truncate prompt to first 80 chars for consistency with FakeAIService
+        const promptPreview = prompt.length > 80 ? prompt.substring(0, 80) + '...' : prompt;
+        const text = `FAKE_RESPONSE: ${promptPreview}`;
+        // Simple token counting (character-based estimate)
+        const inputTokens = Math.ceil(prompt.length / 4);
+        const outputTokens = Math.ceil(text.length / 4);
+        return {
+            text,
+            model: options?.model || this.defaultModel,
+            usage: {
+                inputTokens,
+                outputTokens,
+            },
+            finishReason: 'stop',
+        };
+    }
+    async chatStream(prompt, options, onEvent) {
+        // Get the full response first
+        const response = await this.chat(prompt, options);
+        if (onEvent) {
+            onEvent({ type: 'start' });
+            // Simulate streaming by sending words incrementally
+            const words = response.text.split(' ');
+            for (let i = 0; i < words.length; i++) {
+                const word = words[i];
+                const isLast = i === words.length - 1;
+                const delta = isLast ? word : word + ' ';
+                // Small delay to simulate streaming
+                await new Promise(resolve => setTimeout(resolve, 10));
+                onEvent({ type: 'delta', text: delta });
+            }
+            onEvent({ type: 'complete', text: response.text });
+        }
+        return response;
+    }
+    async embed(text) {
+        // Return deterministic fake embeddings (all zeros, 768 dimensions)
+        // Matches FakeAIService behavior
+        const embeddingSize = 768;
+        if (Array.isArray(text)) {
+            return text.map(() => new Array(embeddingSize).fill(0));
+        }
+        return new Array(embeddingSize).fill(0);
+    }
+    async embedQuery(query) {
+        // Return deterministic fake query embedding (768 dimensions)
+        // Matches FakeAIService behavior
+        return new Array(768).fill(0);
+    }
+    async rerank(query, documents, options) {
+        // Return documents in original order with fake decreasing scores
+        // Matches FakeAIService behavior: 0.9, 0.8, 0.7, ...
+        const topN = Math.min(options?.topN || 10, documents.length);
+        const results = Array.from({ length: topN }, (_, i) => ({
+            index: i,
+            relevanceScore: 0.9 - (i * 0.1),
+            text: documents[i],
+        }));
+        return {
+            results,
+            model: options?.model || this.defaultModel,
+        };
+    }
+    async countTokens(text, _model) {
+        // Simple character-based token estimation (4 chars per token)
+        // Matches behavior used in other providers
+        return Math.ceil(text.length / 4);
+    }
+    async isAvailable() {
+        // Fake provider is always available (no external dependencies)
+        return true;
+    }
+    handleError(error) {
+        // Fake provider shouldn't have errors, but handle gracefully
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            type: 'unknown',
+            retryable: false,
+            message: `FakeProvider error: ${errorMessage}`,
+        };
+    }
+}
+//# sourceMappingURL=fake-provider.js.map

package/dist/infrastructure/providers/fake-provider.js.map

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

package/dist/infrastructure/providers/local-llm-provider.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Provider Layer: LocalLLMProvider
+ * OpenAI-compatible local LLM provider (Ollama, LM Studio, on-prem gateways)
+ *
+ * Phase 4E: Local LLM Provider Implementation
+ * Supports any OpenAI-compatible endpoint for chat and embeddings
+ */
+import type { IModelProvider, ProviderCapabilities, ModelInfo, ChatOptions, ChatResponse, StreamEvent, RerankResponse } from './model-provider.interface.js';
+/**
+ * LocalLLMProvider
+ * Implements IModelProvider for OpenAI-compatible local endpoints
+ *
+ * Designed for:
+ * - Ollama (http://localhost:11434)
+ * - LM Studio (http://localhost:1234)
+ * - On-prem OpenAI-compatible gateways
+ *
+ * API Assumptions:
+ * - POST {baseUrl}/v1/chat/completions (OpenAI-compatible)
+ * - POST {baseUrl}/v1/embeddings (OpenAI-compatible)
+ * - Streaming via Server-Sent Events (SSE) if supported
+ */
+export declare class LocalLLMProvider implements IModelProvider {
+    readonly id = "local";
+    readonly name = "Local LLM Provider";
+    readonly capabilities: ProviderCapabilities;
+    private baseUrl;
+    private defaultChatModel;
+    private defaultEmbedModel;
+    constructor(baseUrl?: string, defaultChatModel?: string, defaultEmbedModel?: string);
+    getModels(): Promise<ModelInfo[]>;
+    getDefaultModel(): string;
+    chat(prompt: string, options?: ChatOptions): Promise<ChatResponse>;
+    chatStream(prompt: string, options?: ChatOptions, onEvent?: (event: StreamEvent) => void): Promise<ChatResponse>;
+    embed(text: string | string[]): Promise<number[] | number[][]>;
+    embedQuery(query: string): Promise<number[]>;
+    rerank?(_query: string, _documents: string[], _options?: {
+        topN?: number;
+        model?: string;
+    }): Promise<RerankResponse>;
+    countTokens(text: string, _model?: string): Promise<number>;
+    isAvailable(): Promise<boolean>;
+    handleError?(error: unknown): {
+        type: string;
+        retryable: boolean;
+        message: string;
+    };
+}
+//# sourceMappingURL=local-llm-provider.d.ts.map

package/dist/infrastructure/providers/local-llm-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-llm-provider.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/providers/local-llm-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EACX,cAAc,EAEf,MAAM,+BAA+B,CAAC;AA2BvC;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAiB,YAAW,cAAc;IACrD,QAAQ,CAAC,EAAE,WAAW;IACtB,QAAQ,CAAC,IAAI,wBAAwB;IAErC,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAOzC;IAEF,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,iBAAiB,CAAS;gBAGhC,OAAO,CAAC,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,MAAM,EACzB,iBAAiB,CAAC,EAAE,MAAM;IActB,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAevC,eAAe,IAAI,MAAM;IAInB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAqDlE,UAAU,CACd,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GACrC,OAAO,CAAC,YAAY,CAAC;IA8FlB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC;IAuC9D,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAOlD,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAM9G,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3D,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IA6BrC,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAqCpF"}