family-ai-agent 1.0.0

package/dist/llm/openrouter-client.js

@@ -0,0 +1,155 @@
+import { ChatOpenAI } from '@langchain/openai';
+import { OpenAIEmbeddings } from '@langchain/openai';
+import { config } from '../config/index.js';
+import { getModelConfig } from '../config/models.js';
+import { LLMError } from '../utils/errors.js';
+import { createLogger } from '../utils/logger.js';
+const logger = createLogger('OpenRouterClient');
+export class OpenRouterClient {
+    defaultModel;
+    fastModel;
+    embeddingModel;
+    chatModels = new Map();
+    embeddings = null;
+    constructor() {
+        this.defaultModel = config.DEFAULT_MODEL;
+        this.fastModel = config.FAST_MODEL;
+        this.embeddingModel = config.EMBEDDING_MODEL;
+    }
+    getChatModel(modelId, options = {}) {
+        const cacheKey = `${modelId}-${JSON.stringify(options)}`;
+        if (!this.chatModels.has(cacheKey)) {
+            const modelConfig = getModelConfig(modelId);
+            const chatModel = new ChatOpenAI({
+                modelName: modelId,
+                openAIApiKey: config.OPENROUTER_API_KEY,
+                temperature: options.temperature ?? 0.7,
+                maxTokens: options.maxTokens ?? modelConfig?.maxOutput ?? 4096,
+                topP: options.topP,
+                frequencyPenalty: options.frequencyPenalty,
+                presencePenalty: options.presencePenalty,
+                stop: options.stop,
+                streaming: options.streaming ?? false,
+                configuration: {
+                    baseURL: config.OPENROUTER_BASE_URL,
+                    defaultHeaders: {
+                        'HTTP-Referer': 'https://family-ai-agent.local',
+                        'X-Title': 'Family AI Agent',
+                    },
+                },
+            });
+            this.chatModels.set(cacheKey, chatModel);
+        }
+        return this.chatModels.get(cacheKey);
+    }
+    getEmbeddings() {
+        if (!this.embeddings) {
+            this.embeddings = new OpenAIEmbeddings({
+                modelName: this.embeddingModel,
+                openAIApiKey: config.OPENROUTER_API_KEY,
+                configuration: {
+                    baseURL: config.OPENROUTER_BASE_URL,
+                },
+            });
+        }
+        return this.embeddings;
+    }
+    // Get a LangChain ChatModel for use with agents
+    getChatModelForAgent(options = {}) {
+        const modelId = options.model ?? this.defaultModel;
+        return this.getChatModel(modelId, {
+            ...options,
+            streaming: true, // Enable streaming for agents
+        });
+    }
+    // Get a fast model for quick operations
+    getFastModel(options = {}) {
+        return this.getChatModel(this.fastModel, options);
+    }
+    // Simple completion method
+    async complete(messages, options = {}) {
+        const modelId = options.model ?? this.defaultModel;
+        const model = this.getChatModel(modelId, options);
+        try {
+            logger.debug('Sending completion request', { model: modelId });
+            const startTime = Date.now();
+            const response = await model.invoke(messages);
+            const duration = Date.now() - startTime;
+            logger.debug('Completion received', { model: modelId, duration });
+            return {
+                content: typeof response.content === 'string'
+                    ? response.content
+                    : JSON.stringify(response.content),
+                model: modelId,
+                usage: {
+                    promptTokens: response.usage_metadata?.input_tokens ?? 0,
+                    completionTokens: response.usage_metadata?.output_tokens ?? 0,
+                    totalTokens: response.usage_metadata?.total_tokens ?? 0,
+                },
+                finishReason: response.response_metadata?.finish_reason ?? 'stop',
+            };
+        }
+        catch (error) {
+            logger.error('Completion failed', { model: modelId, error });
+            throw new LLMError(`Failed to get completion from ${modelId}: ${error instanceof Error ? error.message : 'Unknown error'}`, { model: modelId, originalError: String(error) });
+        }
+    }
+    // Stream completion
+    async *streamComplete(messages, options = {}) {
+        const modelId = options.model ?? this.defaultModel;
+        const model = this.getChatModel(modelId, { ...options, streaming: true });
+        try {
+            logger.debug('Starting stream completion', { model: modelId });
+            const stream = await model.stream(messages);
+            for await (const chunk of stream) {
+                if (typeof chunk.content === 'string') {
+                    yield chunk.content;
+                }
+            }
+        }
+        catch (error) {
+            logger.error('Stream completion failed', { model: modelId, error });
+            throw new LLMError(`Failed to stream completion from ${modelId}: ${error instanceof Error ? error.message : 'Unknown error'}`, { model: modelId, originalError: String(error) });
+        }
+    }
+    // Generate embeddings for text
+    async embed(texts) {
+        try {
+            const embeddings = this.getEmbeddings();
+            return await embeddings.embedDocuments(texts);
+        }
+        catch (error) {
+            logger.error('Embedding generation failed', { error });
+            throw new LLMError(`Failed to generate embeddings: ${error instanceof Error ? error.message : 'Unknown error'}`, { originalError: String(error) });
+        }
+    }
+    // Generate single embedding
+    async embedQuery(text) {
+        try {
+            const embeddings = this.getEmbeddings();
+            return await embeddings.embedQuery(text);
+        }
+        catch (error) {
+            logger.error('Query embedding failed', { error });
+            throw new LLMError(`Failed to generate query embedding: ${error instanceof Error ? error.message : 'Unknown error'}`, { originalError: String(error) });
+        }
+    }
+    // Get model info
+    getModelInfo(modelId) {
+        return getModelConfig(modelId ?? this.defaultModel);
+    }
+    // List available models
+    getAvailableModels() {
+        return [this.defaultModel, this.fastModel];
+    }
+}
+// Singleton instance
+let clientInstance = null;
+export function getOpenRouterClient() {
+    if (!clientInstance) {
+        clientInstance = new OpenRouterClient();
+    }
+    return clientInstance;
+}
+export default OpenRouterClient;
+//# sourceMappingURL=openrouter-client.js.map

package/dist/llm/openrouter-client.js.map

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

package/dist/memory/conversation/index.d.ts

@@ -0,0 +1,37 @@
+import type { BaseMessage } from '@langchain/core/messages';
+export interface Conversation {
+    id: string;
+    threadId: string;
+    userId?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface Message {
+    id: string;
+    conversationId: string;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+}
+export declare class ConversationMemory {
+    createConversation(threadId: string, userId?: string): Promise<string>;
+    getConversation(threadId: string): Promise<Conversation | null>;
+    getOrCreateConversation(threadId: string, userId?: string): Promise<string>;
+    addMessage(conversationId: string, role: 'user' | 'assistant' | 'system', content: string, metadata?: Record<string, unknown>): Promise<string>;
+    getMessages(conversationId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Message[]>;
+    getMessagesAsLangChain(conversationId: string): Promise<BaseMessage[]>;
+    getRecentMessages(conversationId: string, maxMessages?: number): Promise<Message[]>;
+    deleteConversation(conversationId: string): Promise<void>;
+    getConversationCount(userId: string): Promise<number>;
+    listConversations(userId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Conversation[]>;
+}
+export declare function getConversationMemory(): ConversationMemory;
+export default ConversationMemory;
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/conversation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/memory/conversation/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAK5D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,qBAAa,kBAAkB;IAEvB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6BtE,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAmC/D,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAS3E,UAAU,CACd,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,EACrC,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,OAAO,CAAC,MAAM,CAAC;IA8BZ,WAAW,CACf,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAChD,OAAO,CAAC,OAAO,EAAE,CAAC;IAqCf,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAkBtE,iBAAiB,CACrB,cAAc,EAAE,MAAM,EACtB,WAAW,GAAE,MAAW,GACvB,OAAO,CAAC,OAAO,EAAE,CAAC;IAoCf,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBzD,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBrD,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAChD,OAAO,CAAC,YAAY,EAAE,CAAC;CAiC3B;AAKD,wBAAgB,qBAAqB,IAAI,kBAAkB,CAK1D;AAED,eAAe,kBAAkB,CAAC"}

package/dist/memory/conversation/index.js

@@ -0,0 +1,196 @@
+import { query } from '../../database/client.js';
+import { createLogger, logMemoryOperation } from '../../utils/logger.js';
+import { MemoryError } from '../../utils/errors.js';
+import { HumanMessage, AIMessage, SystemMessage } from '@langchain/core/messages';
+const logger = createLogger('ConversationMemory');
+export class ConversationMemory {
+    // Create a new conversation
+    async createConversation(threadId, userId) {
+        try {
+            const result = await query(`INSERT INTO conversations (thread_id, user_id)
+         VALUES ($1, $2)
+         RETURNING id`, [threadId, userId ?? null]);
+            const conversationId = result.rows[0]?.id;
+            if (!conversationId) {
+                throw new MemoryError('Failed to create conversation');
+            }
+            logMemoryOperation('write', 'conversation', {
+                conversationId,
+                threadId,
+            });
+            return conversationId;
+        }
+        catch (error) {
+            logger.error('Failed to create conversation', { error });
+            throw new MemoryError(`Failed to create conversation: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // Get conversation by thread ID
+    async getConversation(threadId) {
+        try {
+            const result = await query(`SELECT id, thread_id, user_id, created_at, updated_at
+         FROM conversations WHERE thread_id = $1`, [threadId]);
+            if (result.rows.length === 0) {
+                return null;
+            }
+            const row = result.rows[0];
+            return {
+                id: row.id,
+                threadId: row.thread_id,
+                userId: row.user_id ?? undefined,
+                createdAt: row.created_at,
+                updatedAt: row.updated_at,
+            };
+        }
+        catch (error) {
+            logger.error('Failed to get conversation', { error });
+            throw new MemoryError(`Failed to get conversation: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // Get or create conversation
+    async getOrCreateConversation(threadId, userId) {
+        const existing = await this.getConversation(threadId);
+        if (existing) {
+            return existing.id;
+        }
+        return this.createConversation(threadId, userId);
+    }
+    // Add message to conversation
+    async addMessage(conversationId, role, content, metadata = {}) {
+        try {
+            const result = await query(`INSERT INTO messages (conversation_id, role, content, metadata)
+         VALUES ($1, $2, $3, $4)
+         RETURNING id`, [conversationId, role, content, JSON.stringify(metadata)]);
+            const messageId = result.rows[0]?.id;
+            if (!messageId) {
+                throw new MemoryError('Failed to add message');
+            }
+            // Update conversation timestamp
+            await query('UPDATE conversations SET updated_at = NOW() WHERE id = $1', [conversationId]);
+            return messageId;
+        }
+        catch (error) {
+            logger.error('Failed to add message', { error });
+            throw new MemoryError(`Failed to add message: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // Get messages for a conversation
+    async getMessages(conversationId, options = {}) {
+        const { limit = 50, offset = 0 } = options;
+        try {
+            const result = await query(`SELECT id, conversation_id, role, content, metadata, created_at
+         FROM messages
+         WHERE conversation_id = $1
+         ORDER BY created_at ASC
+         LIMIT $2 OFFSET $3`, [conversationId, limit, offset]);
+            return result.rows.map((row) => ({
+                id: row.id,
+                conversationId: row.conversation_id,
+                role: row.role,
+                content: row.content,
+                metadata: row.metadata,
+                createdAt: row.created_at,
+            }));
+        }
+        catch (error) {
+            logger.error('Failed to get messages', { error });
+            throw new MemoryError(`Failed to get messages: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // Convert messages to LangChain format
+    async getMessagesAsLangChain(conversationId) {
+        const messages = await this.getMessages(conversationId);
+        return messages.map((msg) => {
+            switch (msg.role) {
+                case 'user':
+                    return new HumanMessage({ content: msg.content });
+                case 'assistant':
+                    return new AIMessage({ content: msg.content });
+                case 'system':
+                    return new SystemMessage({ content: msg.content });
+                default:
+                    return new HumanMessage({ content: msg.content });
+            }
+        });
+    }
+    // Get recent messages (for context window)
+    async getRecentMessages(conversationId, maxMessages = 10) {
+        try {
+            const result = await query(`SELECT id, conversation_id, role, content, metadata, created_at
+         FROM messages
+         WHERE conversation_id = $1
+         ORDER BY created_at DESC
+         LIMIT $2`, [conversationId, maxMessages]);
+            // Reverse to get chronological order
+            return result.rows.reverse().map((row) => ({
+                id: row.id,
+                conversationId: row.conversation_id,
+                role: row.role,
+                content: row.content,
+                metadata: row.metadata,
+                createdAt: row.created_at,
+            }));
+        }
+        catch (error) {
+            logger.error('Failed to get recent messages', { error });
+            throw new MemoryError(`Failed to get recent messages: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // Delete conversation and all messages
+    async deleteConversation(conversationId) {
+        try {
+            await query('DELETE FROM conversations WHERE id = $1', [conversationId]);
+            logMemoryOperation('write', 'conversation', {
+                conversationId,
+                action: 'delete',
+            });
+        }
+        catch (error) {
+            logger.error('Failed to delete conversation', { error });
+            throw new MemoryError(`Failed to delete conversation: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // Get conversation count for user
+    async getConversationCount(userId) {
+        try {
+            const result = await query('SELECT COUNT(*) as count FROM conversations WHERE user_id = $1', [userId]);
+            return parseInt(result.rows[0]?.count ?? '0', 10);
+        }
+        catch (error) {
+            logger.error('Failed to get conversation count', { error });
+            throw new MemoryError(`Failed to get conversation count: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // List user's conversations
+    async listConversations(userId, options = {}) {
+        const { limit = 20, offset = 0 } = options;
+        try {
+            const result = await query(`SELECT id, thread_id, user_id, created_at, updated_at
+         FROM conversations
+         WHERE user_id = $1
+         ORDER BY updated_at DESC
+         LIMIT $2 OFFSET $3`, [userId, limit, offset]);
+            return result.rows.map((row) => ({
+                id: row.id,
+                threadId: row.thread_id,
+                userId: row.user_id ?? undefined,
+                createdAt: row.created_at,
+                updatedAt: row.updated_at,
+            }));
+        }
+        catch (error) {
+            logger.error('Failed to list conversations', { error });
+            throw new MemoryError(`Failed to list conversations: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}
+// Singleton instance
+let memoryInstance = null;
+export function getConversationMemory() {
+    if (!memoryInstance) {
+        memoryInstance = new ConversationMemory();
+    }
+    return memoryInstance;
+}
+export default ConversationMemory;
+//# sourceMappingURL=index.js.map

package/dist/memory/conversation/index.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,4 @@
+export { VectorStore, getVectorStore, type MemoryType, type MemoryEntry, type SearchOptions, } from './longterm/vector-store.js';
+export { ConversationMemory, getConversationMemory, type Conversation, type Message, } from './conversation/index.js';
+export { KnowledgeBase, getKnowledgeBase, type Document, type DocumentChunk, type SearchResult, } from './knowledge-base/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,cAAc,EACd,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,OAAO,GACb,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,2BAA2B,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,5 @@
+// Memory module exports
+export { VectorStore, getVectorStore, } from './longterm/vector-store.js';
+export { ConversationMemory, getConversationMemory, } from './conversation/index.js';
+export { KnowledgeBase, getKnowledgeBase, } from './knowledge-base/index.js';
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,EACL,WAAW,EACX,cAAc,GAIf,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GAGtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,aAAa,EACb,gBAAgB,GAIjB,MAAM,2BAA2B,CAAC"}

package/dist/memory/knowledge-base/index.d.ts

@@ -0,0 +1,51 @@
+export interface Document {
+    id: string;
+    userId?: string;
+    filename: string;
+    fileType?: string;
+    fileSize?: number;
+    content?: string;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+}
+export interface DocumentChunk {
+    id: string;
+    documentId: string;
+    chunkIndex: number;
+    content: string;
+    metadata: Record<string, unknown>;
+}
+export interface SearchResult {
+    documentId: string;
+    chunkId: string;
+    content: string;
+    similarity: number;
+    metadata: Record<string, unknown>;
+    filename: string;
+}
+export declare class KnowledgeBase {
+    private client;
+    private textSplitter;
+    addDocument(content: string, filename: string, options?: {
+        userId?: string;
+        fileType?: string;
+        fileSize?: number;
+        metadata?: Record<string, unknown>;
+    }): Promise<string>;
+    search(queryText: string, options?: {
+        userId?: string;
+        limit?: number;
+        minSimilarity?: number;
+    }): Promise<SearchResult[]>;
+    getDocument(id: string): Promise<Document | null>;
+    listDocuments(userId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Document[]>;
+    deleteDocument(id: string): Promise<void>;
+    getDocumentChunks(documentId: string): Promise<DocumentChunk[]>;
+    getDocumentCount(userId: string): Promise<number>;
+}
+export declare function getKnowledgeBase(): KnowledgeBase;
+export default KnowledgeBase;
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/knowledge-base/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/memory/knowledge-base/index.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,YAAY,CAIjB;IAGG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,GACL,OAAO,CAAC,MAAM,CAAC;IAuEZ,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;KACnB,GACL,OAAO,CAAC,YAAY,EAAE,CAAC;IAmEpB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAyCjD,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAChD,OAAO,CAAC,QAAQ,EAAE,CAAC;IAuChB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBzC,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAgC/D,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAcxD;AAKD,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAED,eAAe,aAAa,CAAC"}