helixmind 0.1.0

package/LICENSE

@@ -0,0 +1,20 @@
+GNU AFFERO GENERAL PUBLIC LICENSE
+Version 3, 19 November 2007
+
+Copyright (C) 2025 HelixMind
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published
+by the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+For the full license text, see:
+https://www.gnu.org/licenses/agpl-3.0.txt

package/README.md

@@ -0,0 +1,207 @@
+<div align="center">
+
+# 🧠 HelixMind
+
+**AI Coding Assistant with Persistent Spiral Memory**
+
+[![npm version](https://img.shields.io/npm/v/helixmind?color=blue&logo=npm)](https://www.npmjs.com/package/helixmind)
+[![License](https://img.shields.io/badge/License-AGPL_3.0-blue?logo=gnu)](LICENSE)
+[![Node](https://img.shields.io/badge/Node-18%2B-green?logo=node.js)](https://nodejs.org)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0%2B-blue?logo=typescript)](https://www.typescriptlang.org/)
+
+*Remembers context across sessions. Learns from every interaction.*
+
+[Installation](#-installation) • [Features](#-features) • [Quick Start](#-quick-start) • [Documentation](#-documentation)
+
+</div>
+
+---
+
+## ✨ Features
+
+<table>
+<tr>
+<td width="50%">
+
+### 🔄 Spiral Memory
+**5-level hierarchical memory** that persists across sessions. Context flows between levels based on relevance and recency.
+
+</td>
+<td width="50%">
+
+### 🤖 Multi-Provider
+**Claude, GPT-4, Ollama** and more. Switch seamlessly between AI providers.
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+### ⚡ Autonomous Mode
+AI can **edit files, run commands, and commit changes** — fully autonomous when needed.
+
+</td>
+<td width="50%">
+
+### 🎯 Smart Context
+**Auto-assembles relevant code** from your project. Understands dependencies and patterns.
+
+</td>
+</tr>
+</table>
+
+---
+
+## 🚀 Installation
+
+```bash
+# Run directly (no install needed)
+npx helixmind
+
+# Or install globally
+npm install -g helixmind
+helixmind
+```
+
+---
+
+## 🎮 Quick Start
+
+```bash
+# Start interactive chat
+npx helixmind
+
+# Initialize in current project
+npx helixmind init
+
+# Run autonomous task
+npx helixmind "fix all lint errors in src/"
+
+# Continue last session
+npx helixmind --continue
+
+# Use specific model
+npx helixmind --model claude-sonnet-4-20250514
+```
+
+---
+
+## 📋 Commands
+
+| Command | Description |
+|:--------|:------------|
+| `helixmind` | 🎯 Start interactive chat |
+| `helixmind init` | ⚙️ Initialize HelixMind in project |
+| `helixmind --continue` | ▶️ Resume last session |
+| `helixmind --model <name>` | 🤖 Use specific model |
+| `helixmind --help` | ❓ Show all options |
+
+### ⌨️ Keyboard Shortcuts
+
+| Key | Action |
+|:----|:-------|
+| `Ctrl+C` | 🛑 Exit |
+| `Ctrl+L` | 🧹 Clear screen |
+| `Ctrl+D` | 🐛 Toggle debug mode |
+| `Tab` | ✨ Autocomplete command |
+
+---
+
+## 🧠 Memory Architecture
+
+```
+┌─────────────────────────────────────────────────────┐
+│  Level 1 — 🔍 Focus                                 │
+│  Most relevant, recent context                      │
+├─────────────────────────────────────────────────────┤
+│  Level 2 — ⚡ Active                                │
+│  Related files, dependencies                        │
+├─────────────────────────────────────────────────────┤
+│  Level 3 — 📚 Reference                             │
+│  Decisions, patterns, code structure                │
+├─────────────────────────────────────────────────────┤
+│  Level 4 — 📦 Archive                               │
+│  Compressed summaries, old sessions                 │
+├─────────────────────────────────────────────────────┤
+│  Level 5 — 🗄️ Deep Archive                          │
+│  Long-term knowledge, project history               │
+└─────────────────────────────────────────────────────┘
+```
+
+Context automatically flows between levels based on relevance and recency.
+
+---
+
+## ⚙️ Configuration
+
+Create `.helixmind/config.json` in your project:
+
+```json
+{
+  "provider": "anthropic",
+  "model": "claude-sonnet-4-20250514",
+  "brainEnabled": true,
+  "permissions": {
+    "writeFiles": true,
+    "runCommands": true,
+    "gitCommit": true
+  }
+}
+```
+
+### 🔑 Environment Variables
+
+```bash
+ANTHROPIC_API_KEY=sk-ant-...    # For Claude
+OPENAI_API_KEY=sk-...           # For OpenAI/GPT
+```
+
+---
+
+## 🛠️ Tech Stack
+
+| Category | Technology |
+|:---------|:-----------|
+| Language | ![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue) |
+| AI SDKs | ![Anthropic](https://img.shields.io/badge/Anthropic-SDK-orange) ![OpenAI](https://img.shields.io/badge/OpenAI-SDK-green) |
+| Database | ![SQLite](https://img.shields.io/badge/SQLite-better--sqlite3-lightgrey) |
+| Embeddings | ![Transformers](https://img.shields.io/badge/HuggingFace-Transformers-yellow) |
+| Testing | ![Vitest](https://img.shields.io/badge/Vitest-testing-yellowgreen) |
+
+---
+
+## 🏗️ Development
+
+```bash
+# Clone repo
+git clone https://github.com/DancingTedDanson011/HelixMind.git
+cd HelixMind
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run in dev mode
+npm run dev
+
+# Run tests
+npm test
+```
+
+---
+
+## 📄 License
+
+[AGPL-3.0](LICENSE) — Free for open-source use. Commercial licenses available.
+
+---
+
+<div align="center">
+
+**Made with ❤️ by [HelixMind](https://github.com/DancingTedDanson011)**
+
+[⬆ Back to Top](#-helixmind)
+
+</div>

package/dist/cli/agent/autonomous.d.ts

@@ -0,0 +1,10 @@
+export declare const SECURITY_PROMPT = "Perform a comprehensive SECURITY AUDIT of this codebase.\n\nCheck every file systematically for:\n1. **Command Injection** \u2014 user input passed to shell commands without sanitization\n2. **Path Traversal** \u2014 user-controlled paths that could escape the project root\n3. **XSS / Injection** \u2014 unsanitized output in HTML/templates\n4. **Hardcoded Secrets** \u2014 API keys, passwords, tokens in source code\n5. **Insecure Dependencies** \u2014 check package.json for known vulnerable packages\n6. **Missing Input Validation** \u2014 unvalidated user input at boundaries\n7. **Unsafe File Operations** \u2014 writing to arbitrary paths, following symlinks\n8. **Information Disclosure** \u2014 verbose error messages, debug endpoints\n9. **Authentication Issues** \u2014 missing auth checks, weak token generation\n10. **Race Conditions** \u2014 TOCTOU, concurrent access without locks\n\nFor EACH finding, report:\n- **Severity**: CRITICAL / HIGH / MEDIUM / LOW\n- **File**: exact file path and line number\n- **Issue**: what's wrong and why it's dangerous\n- **Fix**: specific code change needed\n\nAfter the report, automatically fix all CRITICAL and HIGH severity issues.";
+export interface AutonomousCallbacks {
+    sendMessage: (prompt: string) => Promise<string>;
+    isAborted: () => boolean;
+    onRoundStart: (round: number) => void;
+    onRoundEnd: (round: number, summary: string) => void;
+    updateStatus: () => void;
+}
+export declare function runAutonomousLoop(callbacks: AutonomousCallbacks, initialGoal?: string): Promise<number>;
+//# sourceMappingURL=autonomous.d.ts.map

package/dist/cli/agent/autonomous.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autonomous.d.ts","sourceRoot":"","sources":["../../../src/cli/agent/autonomous.ts"],"names":[],"mappings":"AAqCA,eAAO,MAAM,eAAe,sqCAoB+C,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AA+BD,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,mBAAmB,EAC9B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAiFjB"}

package/dist/cli/agent/autonomous.js

@@ -0,0 +1,172 @@
+/**
+ * Autonomous work mode — HelixMind continuously scans and fixes issues.
+ * Runs until nothing more to optimize or /stop is called.
+ */
+import chalk from 'chalk';
+import { renderInfo } from '../ui/chat-view.js';
+const SCAN_PROMPT = `You are in AUTONOMOUS MODE. Scan this repository thoroughly for the most impactful issue to fix.
+
+Priority order:
+1. CRITICAL bugs or logic errors that cause crashes or wrong behavior
+2. Security vulnerabilities (injection, path traversal, hardcoded secrets)
+3. Missing error handling that could cause unhandled exceptions
+4. Broken or missing tests for important functionality
+5. Performance bottlenecks
+6. Dead code, unused imports, inconsistent patterns
+7. Code quality improvements
+
+RULES:
+- Pick ONE issue — the most impactful one
+- Fix it completely (code + test if applicable)
+- End with a single-line summary starting with "DONE:" describing what you fixed
+- If you genuinely cannot find ANY issue worth fixing, respond with exactly: ALL_TASKS_COMPLETE`;
+function continuePrompt(completed) {
+    return `You are in AUTONOMOUS MODE (round ${completed.length + 1}).
+
+Already completed:
+${completed.map((t, i) => `  ${i + 1}. ${t}`).join('\n')}
+
+Continue scanning for MORE issues in DIFFERENT areas of the codebase.
+Pick the next most impactful issue and fix it completely.
+
+End with a single-line summary starting with "DONE:" describing what you fixed.
+If you genuinely cannot find anything more to improve: ALL_TASKS_COMPLETE`;
+}
+export const SECURITY_PROMPT = `Perform a comprehensive SECURITY AUDIT of this codebase.
+
+Check every file systematically for:
+1. **Command Injection** — user input passed to shell commands without sanitization
+2. **Path Traversal** — user-controlled paths that could escape the project root
+3. **XSS / Injection** — unsanitized output in HTML/templates
+4. **Hardcoded Secrets** — API keys, passwords, tokens in source code
+5. **Insecure Dependencies** — check package.json for known vulnerable packages
+6. **Missing Input Validation** — unvalidated user input at boundaries
+7. **Unsafe File Operations** — writing to arbitrary paths, following symlinks
+8. **Information Disclosure** — verbose error messages, debug endpoints
+9. **Authentication Issues** — missing auth checks, weak token generation
+10. **Race Conditions** — TOCTOU, concurrent access without locks
+
+For EACH finding, report:
+- **Severity**: CRITICAL / HIGH / MEDIUM / LOW
+- **File**: exact file path and line number
+- **Issue**: what's wrong and why it's dangerous
+- **Fix**: specific code change needed
+
+After the report, automatically fix all CRITICAL and HIGH severity issues.`;
+function goalPrompt(goal) {
+    return `You are in AUTONOMOUS MODE with a specific goal.
+
+GOAL: ${goal}
+
+Work on this goal step by step. Break it down into subtasks if needed.
+Fix, implement, or change whatever is necessary to achieve the goal.
+
+RULES:
+- Focus exclusively on the given goal
+- Work methodically — one subtask at a time
+- End each round with a single-line summary starting with "DONE:" describing what you accomplished
+- When the goal is fully achieved, respond with exactly: ALL_TASKS_COMPLETE`;
+}
+function continueGoalPrompt(goal, completed) {
+    return `You are in AUTONOMOUS MODE (round ${completed.length + 1}).
+
+GOAL: ${goal}
+
+Already completed:
+${completed.map((t, i) => `  ${i + 1}. ${t}`).join('\n')}
+
+Continue working towards the goal. Pick the next subtask and complete it.
+
+End with a single-line summary starting with "DONE:" describing what you accomplished.
+When the goal is fully achieved: ALL_TASKS_COMPLETE`;
+}
+export async function runAutonomousLoop(callbacks, initialGoal) {
+    const completed = [];
+    let round = 0;
+    let goal = initialGoal;
+    const d = chalk.dim;
+    const c = chalk.hex('#00d4ff');
+    process.stdout.write('\n');
+    process.stdout.write(d('\u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E') + '\n');
+    process.stdout.write(d('\u2502  ') + c('\u{1F504} AUTONOMOUS MODE') + d('                        \u2502') + '\n');
+    if (goal) {
+        process.stdout.write(d('\u2502') + d('                                             \u2502') + '\n');
+        // Truncate goal to fit in the box (39 chars max)
+        const goalDisplay = goal.length > 39 ? goal.slice(0, 36) + '...' : goal;
+        const padding = ' '.repeat(Math.max(0, 39 - goalDisplay.length));
+        process.stdout.write(d('\u2502  ') + chalk.white.bold('Goal: ') + goalDisplay + padding + d('\u2502') + '\n');
+    }
+    else {
+        process.stdout.write(d('\u2502') + d('                                             \u2502') + '\n');
+        process.stdout.write(d('\u2502  ') + 'HelixMind will continuously scan and fix' + d('    \u2502') + '\n');
+        process.stdout.write(d('\u2502  ') + 'issues until nothing remains.' + d('               \u2502') + '\n');
+    }
+    process.stdout.write(d('\u2502') + d('                                             \u2502') + '\n');
+    process.stdout.write(d('\u2502  ') + d('/stop or ESC to stop') + d('                    \u2502') + '\n');
+    process.stdout.write(d('\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F') + '\n\n');
+    while (!callbacks.isAborted()) {
+        round++;
+        callbacks.onRoundStart(round);
+        callbacks.updateStatus();
+        let prompt;
+        if (goal) {
+            prompt = round === 1 ? goalPrompt(goal) : continueGoalPrompt(goal, completed);
+        }
+        else {
+            prompt = round === 1 ? SCAN_PROMPT : continuePrompt(completed);
+        }
+        process.stdout.write(chalk.dim(`  \u2500\u2500 Round ${round} `) + chalk.dim('\u2500'.repeat(35)) + '\n');
+        try {
+            const resultText = await callbacks.sendMessage(prompt);
+            if (callbacks.isAborted())
+                break;
+            // Check if agent says it's done
+            if (resultText.includes('ALL_TASKS_COMPLETE')) {
+                if (goal) {
+                    // Goal achieved — transition to general scan mode
+                    process.stdout.write('\n');
+                    renderInfo(chalk.green(`  \u2705 Goal achieved (${completed.length} tasks). Switching to general scan mode...`));
+                    process.stdout.write('\n');
+                    goal = undefined; // switch to scan mode for subsequent rounds
+                    continue;
+                }
+                else {
+                    // General scan found nothing — truly done
+                    process.stdout.write('\n');
+                    renderInfo(chalk.green(`  \u2705 Autonomous mode complete \u2014 ${completed.length} tasks finished.`));
+                    process.stdout.write('\n');
+                    break;
+                }
+            }
+            // Extract summary from "DONE: ..." line or last line
+            const summary = extractSummary(resultText);
+            completed.push(summary);
+            callbacks.onRoundEnd(round, summary);
+            renderInfo(chalk.green(`  \u2713 Round ${round}: ${summary}`));
+        }
+        catch (err) {
+            if (callbacks.isAborted())
+                break;
+            renderInfo(chalk.red(`  \u2717 Round ${round} error: ${err}`));
+        }
+    }
+    if (callbacks.isAborted()) {
+        process.stdout.write('\n');
+        renderInfo(chalk.yellow(`  \u23F9 Autonomous mode stopped after ${completed.length} tasks.`));
+        process.stdout.write('\n');
+    }
+    return completed.length;
+}
+function extractSummary(text) {
+    // Look for "DONE: ..." line
+    const doneMatch = text.match(/DONE:\s*(.+)/i);
+    if (doneMatch) {
+        const s = doneMatch[1].trim();
+        return s.length > 120 ? s.slice(0, 117) + '...' : s;
+    }
+    // Fallback: last non-empty line
+    const lines = text.trim().split('\n').filter(l => l.trim());
+    const last = lines[lines.length - 1]?.trim() || text.slice(0, 100);
+    return last.length > 120 ? last.slice(0, 117) + '...' : last;
+}
+//# sourceMappingURL=autonomous.js.map

package/dist/cli/agent/autonomous.js.map

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

package/dist/cli/agent/loop.d.ts

@@ -0,0 +1,76 @@
+import type { LLMProvider, ToolMessage } from '../providers/types.js';
+import { type ToolContext } from './tools/registry.js';
+import { PermissionManager } from './permissions.js';
+import type { CheckpointStore } from '../checkpoints/store.js';
+import type { TaskStep } from '../ui/activity.js';
+import type { SessionBuffer } from '../context/session-buffer.js';
+export declare class AgentAbortError extends Error {
+    constructor(message?: string);
+}
+export interface AgentLoopOptions {
+    provider: LLMProvider;
+    systemPrompt: string;
+    permissions: PermissionManager;
+    toolContext: ToolContext;
+    checkpointStore?: CheckpointStore;
+    sessionBuffer?: SessionBuffer;
+    onTokensUsed?: (input: number, output: number) => void;
+    onToolCall?: (name: string) => void;
+    onStepStart?: (num: number, tool: string, label: string) => void;
+    onStepEnd?: (num: number, tool: string, status: 'done' | 'error', error?: string) => void;
+    /** Called before each LLM API call — use to restart activity indicator */
+    onThinking?: () => void;
+    /** Called before rendering the final answer — use to stop activity */
+    onBeforeAnswer?: () => void;
+    maxIterations?: number;
+}
+export interface AgentLoopResult {
+    text: string;
+    toolCalls: number;
+    tokensUsed: {
+        input: number;
+        output: number;
+    };
+    aborted: boolean;
+    steps: TaskStep[];
+    errors: string[];
+    /** The full conversation history after this loop — caller must adopt this */
+    updatedHistory: ToolMessage[];
+}
+/**
+ * The agent loop: sends messages to the LLM, executes tool calls,
+ * feeds results back, and repeats until the model is done.
+ *
+ * Supports pause/resume/abort via the AgentController.
+ * AbortController cancels in-flight HTTP requests on emergency stop.
+ */
+export declare function runAgentLoop(userMessage: string, conversationHistory: ToolMessage[], options: AgentLoopOptions, controller?: AgentController): Promise<AgentLoopResult>;
+/**
+ * Controller for pausing/resuming/aborting the agent loop.
+ *
+ * Uses an AbortController for hard cancellation of in-flight HTTP requests.
+ * ESC → abort() → AbortController.abort() → HTTP request cancelled immediately.
+ */
+export declare class AgentController {
+    private _paused;
+    private _aborted;
+    private _abortController;
+    private pauseResolve;
+    get isPaused(): boolean;
+    get isAborted(): boolean;
+    /** AbortSignal to pass to HTTP requests for hard cancellation */
+    get signal(): AbortSignal;
+    pause(): void;
+    resume(): void;
+    /**
+     * EMERGENCY STOP — aborts immediately:
+     * 1. Sets abort flag (checked between steps)
+     * 2. Cancels AbortController (kills in-flight HTTP requests)
+     * 3. Resolves any pending pause promise
+     */
+    abort(): void;
+    checkPause(): Promise<void>;
+    /** Reset state for a new round — creates fresh AbortController */
+    reset(): void;
+}
+//# sourceMappingURL=loop.d.ts.map

package/dist/cli/agent/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../../src/cli/agent/loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EAIZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAkC,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,GAAE,MAAwB;CAI9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,WAAW,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1F,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6EAA6E;IAC7E,cAAc,EAAE,WAAW,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,WAAW,EAAE,EAClC,OAAO,EAAE,gBAAgB,EACzB,UAAU,CAAC,EAAE,eAAe,GAC3B,OAAO,CAAC,eAAe,CAAC,CAoR1B;AA2BD;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAA0C;IAClE,OAAO,CAAC,YAAY,CAA6B;IAEjD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,iEAAiE;IACjE,IAAI,MAAM,IAAI,WAAW,CAExB;IAED,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,IAAI;IASd;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAUP,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAcjC,kEAAkE;IAClE,KAAK,IAAI,IAAI;CAMd"}