cmdr-agent 2.5.5 → 3.1.0

package/dist/src/memory/index-manager.js

@@ -0,0 +1,241 @@
+/**
+ * RAG / Document Indexing — semantic search over project files.
+ *
+ * Uses Ollama /api/embed with nomic-embed-text for embeddings.
+ * Stores index as JSON (no SQLite dependency).
+ * 512-token chunks with 64-token overlap.
+ * Cosine similarity search.
+ */
+import { readFile, readdir, writeFile, stat, mkdir } from 'node:fs/promises';
+import { join, relative, extname } from 'node:path';
+import { homedir } from 'node:os';
+// ── Chunking ────────────────────────────────────────────────────────
+const CHUNK_SIZE = 80; // lines (approximation of ~512 tokens)
+const CHUNK_OVERLAP = 10; // lines (~64 tokens)
+/** Text file extensions to index. */
+const INDEXABLE_EXTENSIONS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+    '.py', '.rb', '.go', '.rs', '.java', '.kt', '.swift', '.c', '.cpp', '.h', '.hpp',
+    '.cs', '.php', '.lua', '.sh', '.bash', '.zsh',
+    '.html', '.css', '.scss', '.less', '.vue', '.svelte',
+    '.json', '.yaml', '.yml', '.toml', '.xml',
+    '.md', '.mdx', '.txt', '.rst',
+    '.sql', '.graphql', '.proto',
+    '.env', '.gitignore', '.dockerignore',
+    '.dockerfile', 'Dockerfile',
+]);
+/** Directories to skip. */
+const SKIP_DIRS = new Set([
+    'node_modules', '.git', '.next', 'dist', 'build', 'out', 'target',
+    'coverage', '.vscode', '.idea', '__pycache__', '.tox', 'venv', '.venv',
+]);
+function chunkText(text, file) {
+    const lines = text.split('\n');
+    const chunks = [];
+    let start = 0;
+    while (start < lines.length) {
+        const end = Math.min(start + CHUNK_SIZE, lines.length);
+        const chunkLines = lines.slice(start, end);
+        chunks.push({
+            file,
+            startLine: start + 1,
+            endLine: end,
+            text: chunkLines.join('\n'),
+        });
+        start += CHUNK_SIZE - CHUNK_OVERLAP;
+        if (start >= lines.length)
+            break;
+    }
+    return chunks;
+}
+// ── Embedding ───────────────────────────────────────────────────────
+async function getEmbedding(text, ollamaUrl, model = 'nomic-embed-text') {
+    const response = await fetch(`${ollamaUrl}/api/embed`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ model, input: text }),
+    });
+    if (!response.ok) {
+        throw new Error(`Embedding failed: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    return data.embeddings[0];
+}
+// ── Similarity ──────────────────────────────────────────────────────
+function cosineSimilarity(a, b) {
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dotProduct / denom;
+}
+// ── File discovery ──────────────────────────────────────────────────
+async function discoverFiles(rootDir, paths) {
+    const files = [];
+    async function walkDir(dir) {
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') && SKIP_DIRS.has(entry.name))
+                continue;
+            if (SKIP_DIRS.has(entry.name))
+                continue;
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await walkDir(fullPath);
+            }
+            else if (entry.isFile()) {
+                const ext = extname(entry.name).toLowerCase();
+                if (INDEXABLE_EXTENSIONS.has(ext) || INDEXABLE_EXTENSIONS.has(entry.name)) {
+                    files.push(fullPath);
+                }
+            }
+        }
+    }
+    for (const p of paths) {
+        const fullPath = join(rootDir, p);
+        const s = await stat(fullPath).catch(() => null);
+        if (!s)
+            continue;
+        if (s.isDirectory()) {
+            await walkDir(fullPath);
+        }
+        else if (s.isFile()) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+// ── IndexManager ────────────────────────────────────────────────────
+export class IndexManager {
+    cwd;
+    ollamaUrl;
+    embedModel;
+    indexPath;
+    state = null;
+    constructor(cwd, ollamaUrl = 'http://localhost:11434', embedModel = 'nomic-embed-text') {
+        this.cwd = cwd;
+        this.ollamaUrl = ollamaUrl;
+        this.embedModel = embedModel;
+        const indexDir = join(homedir(), '.cmdr', 'index');
+        // Use cwd hash for unique index per project
+        const { createHash } = require('node:crypto');
+        const hash = createHash('sha256').update(cwd).digest('hex').slice(0, 12);
+        this.indexPath = join(indexDir, `${hash}.json`);
+    }
+    /** Load existing index from disk. */
+    async load() {
+        if (this.state)
+            return this.state;
+        try {
+            const raw = await readFile(this.indexPath, 'utf-8');
+            this.state = JSON.parse(raw);
+        }
+        catch {
+            this.state = {
+                version: 1,
+                model: this.embedModel,
+                chunks: [],
+                indexedFiles: {},
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+            };
+        }
+        return this.state;
+    }
+    /** Save index to disk. */
+    async save() {
+        if (!this.state)
+            return;
+        this.state.updatedAt = new Date().toISOString();
+        const dir = join(homedir(), '.cmdr', 'index');
+        await mkdir(dir, { recursive: true });
+        await writeFile(this.indexPath, JSON.stringify(this.state));
+    }
+    /**
+     * Index files at the given paths (relative to cwd).
+     * Returns number of chunks indexed.
+     */
+    async index(paths, onProgress) {
+        const state = await this.load();
+        const files = await discoverFiles(this.cwd, paths);
+        let totalNew = 0;
+        for (const file of files) {
+            const relPath = relative(this.cwd, file);
+            const fileStat = await stat(file);
+            const mtime = fileStat.mtimeMs;
+            // Skip if already indexed and not modified
+            const existing = state.indexedFiles[relPath];
+            if (existing && existing.mtime >= mtime)
+                continue;
+            onProgress?.(`Indexing: ${relPath}`);
+            // Remove old chunks for this file
+            state.chunks = state.chunks.filter(c => c.file !== relPath);
+            // Read and chunk
+            const content = await readFile(file, 'utf-8');
+            const textChunks = chunkText(content, relPath);
+            // Get embeddings
+            for (const chunk of textChunks) {
+                try {
+                    const embedding = await getEmbedding(chunk.text, this.ollamaUrl, this.embedModel);
+                    state.chunks.push({ ...chunk, embedding });
+                    totalNew++;
+                }
+                catch (err) {
+                    onProgress?.(`  ⚠ Embedding failed for ${relPath}:${chunk.startLine}: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            state.indexedFiles[relPath] = { mtime, chunkCount: textChunks.length };
+        }
+        await this.save();
+        onProgress?.(`Done: ${totalNew} new chunks indexed (${state.chunks.length} total)`);
+        return totalNew;
+    }
+    /**
+     * Semantic search across indexed documents.
+     * Returns top-k results sorted by similarity.
+     */
+    async search(query, topK = 5) {
+        const state = await this.load();
+        if (state.chunks.length === 0) {
+            return [];
+        }
+        const queryEmbedding = await getEmbedding(query, this.ollamaUrl, this.embedModel);
+        const scored = state.chunks.map(chunk => ({
+            file: chunk.file,
+            startLine: chunk.startLine,
+            endLine: chunk.endLine,
+            text: chunk.text,
+            score: cosineSimilarity(queryEmbedding, chunk.embedding),
+        }));
+        scored.sort((a, b) => b.score - a.score);
+        return scored.slice(0, topK);
+    }
+    /** Get index status/stats. */
+    async status() {
+        const state = await this.load();
+        return {
+            fileCount: Object.keys(state.indexedFiles).length,
+            chunkCount: state.chunks.length,
+            model: state.model,
+            updatedAt: state.updatedAt,
+        };
+    }
+    /** Clear the entire index. */
+    async clear() {
+        this.state = {
+            version: 1,
+            model: this.embedModel,
+            chunks: [],
+            indexedFiles: {},
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+        await this.save();
+    }
+}
+//# sourceMappingURL=index-manager.js.map

package/dist/src/memory/index-manager.js.map

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

package/dist/src/server/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * cmdr serve — HTTP/SSE server exposing the agent API.
+ *
+ * Endpoints:
+ *   POST /v1/chat     — JSON request/response
+ *   POST /v1/stream   — SSE streaming response
+ *   GET  /health      — health check
+ *   GET  /v1/models   — list available models
+ *
+ * Uses Node.js built-in http module (no Express).
+ */
+export interface ServeOptions {
+    port: number;
+    host: string;
+    model: string;
+    ollamaUrl: string;
+    provider?: string;
+}
+export declare function startServer(options: ServeOptions): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgBH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAgDD,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAwPtE"}

package/dist/src/server/index.js

@@ -0,0 +1,283 @@
+/**
+ * cmdr serve — HTTP/SSE server exposing the agent API.
+ *
+ * Endpoints:
+ *   POST /v1/chat     — JSON request/response
+ *   POST /v1/stream   — SSE streaming response
+ *   GET  /health      — health check
+ *   GET  /v1/models   — list available models
+ *
+ * Uses Node.js built-in http module (no Express).
+ */
+import { createServer } from 'node:http';
+import { Agent } from '../core/agent.js';
+import { createAdapter, detectProviderFromModel } from '../llm/provider-factory.js';
+import { ToolRegistry } from '../tools/registry.js';
+import { registerBuiltInTools } from '../tools/built-in/index.js';
+import { PermissionManager } from '../core/permissions.js';
+import { SOLO_CODER } from '../core/presets.js';
+import { discoverProject } from '../session/project-context.js';
+import { buildSystemPrompt } from '../session/prompt-builder.js';
+import { discoverOllamaModels } from '../llm/model-registry.js';
+import { MemoryManager } from '../memory/memory-manager.js';
+/** Read request body as JSON, with a size limit. */
+async function readBody(req, maxBytes = 10 * 1024 * 1024) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        req.on('data', (chunk) => {
+            size += chunk.length;
+            if (size > maxBytes) {
+                req.destroy();
+                reject(new Error('Request body too large'));
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on('end', () => {
+            try {
+                const body = Buffer.concat(chunks).toString('utf-8');
+                resolve(JSON.parse(body));
+            }
+            catch {
+                reject(new Error('Invalid JSON'));
+            }
+        });
+        req.on('error', reject);
+    });
+}
+function sendJson(res, status, data) {
+    const body = JSON.stringify(data);
+    res.writeHead(status, {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(body),
+    });
+    res.end(body);
+}
+function sendError(res, status, message) {
+    sendJson(res, status, { error: message });
+}
+/** Set CORS headers for development use. */
+function setCorsHeaders(res) {
+    res.setHeader('Access-Control-Allow-Origin', '*');
+    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+    res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+}
+export async function startServer(options) {
+    const cwd = process.cwd();
+    // Resolve provider
+    const provider = options.provider
+        ?? detectProviderFromModel(options.model)
+        ?? 'ollama';
+    const adapter = createAdapter({ provider, ollamaUrl: options.ollamaUrl });
+    // Discover project context
+    const projectContext = await discoverProject(cwd);
+    // Memory
+    const memoryManager = new MemoryManager(cwd);
+    const memoryPrompt = await memoryManager.getMemoryPrompt();
+    // System prompt
+    const systemPrompt = buildSystemPrompt({
+        basePrompt: SOLO_CODER.systemPrompt,
+        projectContext,
+        model: options.model,
+        memoryPrompt: memoryPrompt || undefined,
+    });
+    // Tools
+    const toolRegistry = new ToolRegistry();
+    registerBuiltInTools(toolRegistry);
+    // Permission manager (yolo for server mode — approvals aren't interactive)
+    const permissionManager = new PermissionManager('yolo');
+    // Discover models for Ollama
+    if (provider === 'ollama') {
+        const ollamaAdapter = adapter;
+        const healthy = await ollamaAdapter.healthCheck();
+        if (!healthy) {
+            console.error(`Cannot connect to Ollama at ${options.ollamaUrl}`);
+            process.exit(1);
+        }
+        await discoverOllamaModels(options.ollamaUrl);
+    }
+    /** Create a fresh agent for each request. */
+    function createAgent(model) {
+        const allowedToolNames = Array.from(new Set([
+            ...(SOLO_CODER.tools ?? []),
+            ...toolRegistry.list().map(t => t.name),
+        ]));
+        return new Agent({
+            ...SOLO_CODER,
+            model,
+            systemPrompt,
+            tools: allowedToolNames,
+        }, adapter, toolRegistry, cwd, permissionManager);
+    }
+    const server = createServer(async (req, res) => {
+        setCorsHeaders(res);
+        // Handle CORS preflight
+        if (req.method === 'OPTIONS') {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        const url = req.url ?? '/';
+        try {
+            // GET /health
+            if (req.method === 'GET' && url === '/health') {
+                sendJson(res, 200, {
+                    status: 'ok',
+                    model: options.model,
+                    provider,
+                    uptime: process.uptime(),
+                });
+                return;
+            }
+            // GET /v1/models
+            if (req.method === 'GET' && url === '/v1/models') {
+                if (provider === 'ollama') {
+                    const ollamaAdapter = adapter;
+                    const models = await ollamaAdapter.listModels();
+                    sendJson(res, 200, { models });
+                }
+                else {
+                    sendJson(res, 200, { models: [options.model] });
+                }
+                return;
+            }
+            // POST /v1/chat — non-streaming chat
+            if (req.method === 'POST' && url === '/v1/chat') {
+                const body = await readBody(req);
+                if (!body?.message) {
+                    sendError(res, 400, 'Missing "message" field');
+                    return;
+                }
+                const model = body.model ?? options.model;
+                const agent = createAgent(model);
+                const startTime = Date.now();
+                const toolsCalled = [];
+                let currentToolStart = 0;
+                let currentToolName = '';
+                let fullOutput = '';
+                for await (const event of agent.stream(body.message)) {
+                    switch (event.type) {
+                        case 'text':
+                            fullOutput += event.data;
+                            break;
+                        case 'tool_use': {
+                            const block = event.data;
+                            currentToolName = block.name;
+                            currentToolStart = Date.now();
+                            break;
+                        }
+                        case 'tool_result': {
+                            toolsCalled.push({ name: currentToolName, duration_ms: Date.now() - currentToolStart });
+                            currentToolName = '';
+                            break;
+                        }
+                    }
+                }
+                const state = agent.getState();
+                const tokens = state.tokenUsage;
+                sendJson(res, 200, {
+                    model,
+                    response: fullOutput,
+                    tools_called: toolsCalled,
+                    tokens: { input: tokens.input_tokens, output: tokens.output_tokens },
+                    duration_ms: Date.now() - startTime,
+                });
+                return;
+            }
+            // POST /v1/stream — SSE streaming
+            if (req.method === 'POST' && url === '/v1/stream') {
+                const body = await readBody(req);
+                if (!body?.message) {
+                    sendError(res, 400, 'Missing "message" field');
+                    return;
+                }
+                const model = body.model ?? options.model;
+                const agent = createAgent(model);
+                const startTime = Date.now();
+                const toolsCalled = [];
+                let currentToolStart = 0;
+                let currentToolName = '';
+                res.writeHead(200, {
+                    'Content-Type': 'text/event-stream',
+                    'Cache-Control': 'no-cache',
+                    'Connection': 'keep-alive',
+                    'Access-Control-Allow-Origin': '*',
+                });
+                const sendEvent = (data) => {
+                    res.write(`data: ${JSON.stringify(data)}\n\n`);
+                };
+                try {
+                    for await (const event of agent.stream(body.message)) {
+                        switch (event.type) {
+                            case 'text':
+                                sendEvent({ type: 'text', data: event.data, timestamp: Date.now() });
+                                break;
+                            case 'tool_use': {
+                                const block = event.data;
+                                currentToolName = block.name;
+                                currentToolStart = Date.now();
+                                sendEvent({ type: 'tool_use', tool: block.name, input: block.input, timestamp: Date.now() });
+                                break;
+                            }
+                            case 'tool_result': {
+                                const block = event.data;
+                                const duration_ms = Date.now() - currentToolStart;
+                                toolsCalled.push({ name: currentToolName, duration_ms });
+                                sendEvent({ type: 'tool_result', tool: currentToolName, output: block.content, is_error: block.is_error, duration_ms, timestamp: Date.now() });
+                                currentToolName = '';
+                                break;
+                            }
+                            case 'error': {
+                                const err = event.data;
+                                sendEvent({ type: 'error', message: err.message, timestamp: Date.now() });
+                                break;
+                            }
+                        }
+                    }
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    sendEvent({ type: 'error', message: msg, timestamp: Date.now() });
+                }
+                const state = agent.getState();
+                const tokens = state.tokenUsage;
+                sendEvent({
+                    type: 'done',
+                    tokens: { input: tokens.input_tokens, output: tokens.output_tokens },
+                    duration_ms: Date.now() - startTime,
+                });
+                res.end();
+                return;
+            }
+            // 404 for anything else
+            sendError(res, 404, `Not found: ${url}`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`[cmdr serve] Error:`, msg);
+            if (!res.headersSent) {
+                sendError(res, 500, msg);
+            }
+        }
+    });
+    server.listen(options.port, options.host, () => {
+        console.log(`cmdr serve running on http://${options.host}:${options.port}`);
+        console.log(`  Model:    ${options.model}`);
+        console.log(`  Provider: ${provider}`);
+        console.log(`  Endpoints:`);
+        console.log(`    GET  /health      — health check`);
+        console.log(`    GET  /v1/models   — list models`);
+        console.log(`    POST /v1/chat     — JSON chat`);
+        console.log(`    POST /v1/stream   — SSE streaming`);
+    });
+    // Graceful shutdown
+    const shutdown = () => {
+        console.log('\nShutting down cmdr serve...');
+        server.close();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/server/index.js.map

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

package/dist/src/session/branch-manager.d.ts

@@ -0,0 +1,39 @@
+/**
+ * BranchManager — fork, switch, and merge conversation branches.
+ *
+ * Branches are persisted as JSON files under:
+ *   ~/.cmdr/sessions/{sessionId}/branches/{branch-id}.json
+ *
+ * Each branch stores a snapshot of the conversation at fork time,
+ * plus any messages added after the fork.
+ */
+import type { LLMMessage } from '../core/types.js';
+export interface Branch {
+    readonly id: string;
+    readonly name: string;
+    readonly model: string;
+    readonly messages: LLMMessage[];
+    readonly messageCount: number;
+    readonly createdAt: string;
+    readonly parentBranch?: string;
+    readonly forkPoint: number;
+}
+export declare class BranchManager {
+    private sessionId;
+    private currentBranchId;
+    constructor(sessionId: string);
+    get activeBranch(): string | null;
+    /** Fork the conversation at the current point. */
+    fork(name: string, messages: LLMMessage[], model: string, parentBranch?: string): Promise<Branch>;
+    /** Switch to a branch by ID. Returns the branch data or null. */
+    switch(id: string): Promise<Branch | null>;
+    /** List all branches for this session, newest first. */
+    list(): Promise<Omit<Branch, 'messages'>[]>;
+    /** Merge branch messages onto a target (appends after fork point). */
+    merge(sourceId: string, targetMessages: LLMMessage[]): Promise<LLMMessage[] | null>;
+    /** Delete a branch by ID. */
+    delete(id: string): Promise<boolean>;
+    /** Save the current state of a branch (update messages). */
+    update(id: string, messages: LLMMessage[], model: string): Promise<boolean>;
+}
+//# sourceMappingURL=branch-manager.d.ts.map

package/dist/src/session/branch-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-manager.d.ts","sourceRoot":"","sources":["../../../src/session/branch-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAKlD,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAA;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAMD,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,eAAe,CAAsB;gBAEjC,SAAS,EAAE,MAAM;IAI7B,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAEhC;IAED,kDAAkD;IAC5C,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBvG,iEAAiE;IAC3D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAchD,wDAAwD;IAClD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC;IAmCjD,sEAAsE;IAChE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;IASzF,6BAA6B;IACvB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa1C,4DAA4D;IACtD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAmBlF"}