@project-ava-supernova/core 0.2.71

package/dist/memory/procedural.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Procedural Learning — learns tool-use patterns from observation.
+ *
+ * Watches tool-call sequences across sessions. When the same pattern
+ * appears 3+ times, it's "crystallised" into a ProceduralPattern that
+ * can influence the task classifier and directness discipline.
+ *
+ * Example: if Ava builds React components by always doing
+ * file_read → file_read → file_edit → bash (test) → git_commit,
+ * and this happens 3 times in the same project, the pattern is
+ * crystallised and future React component tasks get a directness
+ * hint: "you typically follow this sequence for this task type."
+ */
+import type { ProceduralPattern } from './types.js';
+/**
+ * ProceduralObserver — watches tool-call sequences and manages patterns.
+ */
+export declare class ProceduralObserver {
+    readonly baseDir: string;
+    private store;
+    private dirty;
+    private readonly storePath;
+    constructor(baseDir: string);
+    load(): Promise<void>;
+    save(): Promise<void>;
+    /**
+     * Observe a completed tool-call sequence from a session turn.
+     * Called after each successful agent run (no errors).
+     */
+    observe(opts: {
+        toolSequence: string[];
+        taskType?: string;
+        project?: string;
+        sessionId?: string;
+    }): ProceduralPattern | null;
+    /** Get all crystallised patterns. */
+    getCrystallised(): ProceduralPattern[];
+    /** Get patterns for a specific project. */
+    getForProject(project: string): ProceduralPattern[];
+    /** Get the most relevant pattern for a task type + project. */
+    findBestPattern(taskType: string, project?: string): ProceduralPattern | null;
+    /** Get all patterns (for export / brain synthesis). */
+    getAllPatterns(): ProceduralPattern[];
+    /** Compute a normalised signature from a tool sequence. */
+    private computeSignature;
+}
+//# sourceMappingURL=procedural.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"procedural.d.ts","sourceRoot":"","sources":["../../src/memory/procedural.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,YAAY,CAAC;AAcrE;;GAEG;AACH,qBAAa,kBAAkB;IAKjB,QAAQ,CAAC,OAAO,EAAE,MAAM;IAJpC,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,MAAM;IAK9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAarB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE;QACZ,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,iBAAiB,GAAG,IAAI;IA0D5B,qCAAqC;IACrC,eAAe,IAAI,iBAAiB,EAAE;IAItC,2CAA2C;IAC3C,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAInD,+DAA+D;IAC/D,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAS7E,uDAAuD;IACvD,cAAc,IAAI,iBAAiB,EAAE;IAIrC,2DAA2D;IAC3D,OAAO,CAAC,gBAAgB;CAUzB"}

package/dist/memory/procedural.js

@@ -0,0 +1,182 @@
+/**
+ * Procedural Learning — learns tool-use patterns from observation.
+ *
+ * Watches tool-call sequences across sessions. When the same pattern
+ * appears 3+ times, it's "crystallised" into a ProceduralPattern that
+ * can influence the task classifier and directness discipline.
+ *
+ * Example: if Ava builds React components by always doing
+ * file_read → file_read → file_edit → bash (test) → git_commit,
+ * and this happens 3 times in the same project, the pattern is
+ * crystallised and future React component tasks get a directness
+ * hint: "you typically follow this sequence for this task type."
+ */
+import { randomUUID } from 'node:crypto';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { logger } from '../core/logger.js';
+import { createEmptyProceduralStore, PROCEDURAL_MIN_OBSERVATIONS, PROCEDURAL_MIN_CONFIDENCE, } from './types.js';
+const PROCEDURES_FILENAME = 'procedures.json';
+/** Minimum tool calls in a sequence to be worth tracking. */
+const MIN_SEQUENCE_LENGTH = 3;
+/** Maximum tool calls to consider (longer runs are truncated). */
+const MAX_SEQUENCE_LENGTH = 20;
+/**
+ * ProceduralObserver — watches tool-call sequences and manages patterns.
+ */
+export class ProceduralObserver {
+    baseDir;
+    store;
+    dirty = false;
+    storePath;
+    constructor(baseDir) {
+        this.baseDir = baseDir;
+        this.storePath = join(baseDir, PROCEDURES_FILENAME);
+        this.store = createEmptyProceduralStore();
+    }
+    async load() {
+        if (!existsSync(this.storePath)) {
+            this.store = createEmptyProceduralStore();
+            return;
+        }
+        try {
+            const raw = await readFile(this.storePath, 'utf-8');
+            this.store = JSON.parse(raw);
+        }
+        catch {
+            this.store = createEmptyProceduralStore();
+        }
+    }
+    async save() {
+        if (!this.dirty)
+            return;
+        try {
+            this.store.lastModified = new Date().toISOString();
+            await mkdir(dirname(this.storePath), { recursive: true });
+            await writeFile(this.storePath, JSON.stringify(this.store, null, 2), 'utf-8');
+            this.dirty = false;
+        }
+        catch (err) {
+            logger.warn(`[procedural] Failed to save: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /**
+     * Observe a completed tool-call sequence from a session turn.
+     * Called after each successful agent run (no errors).
+     */
+    observe(opts) {
+        const { toolSequence, taskType, project } = opts;
+        // Ignore short sequences
+        if (toolSequence.length < MIN_SEQUENCE_LENGTH)
+            return null;
+        // Truncate long sequences
+        const sequence = toolSequence.slice(0, MAX_SEQUENCE_LENGTH);
+        // Generate a signature from the tool sequence
+        const signature = this.computeSignature(sequence);
+        // Look for existing pattern with the same signature
+        const existing = this.store.patterns.find(p => {
+            const existingSig = this.computeSignature(p.toolSequence);
+            return existingSig === signature && p.project === (project ?? null);
+        });
+        if (existing) {
+            // Reinforce existing pattern
+            existing.observationCount++;
+            existing.lastObservedAt = new Date().toISOString();
+            existing.confidence = Math.min(1.0, existing.confidence + 0.15);
+            // Check for crystallisation
+            if (!existing.crystallised &&
+                existing.observationCount >= PROCEDURAL_MIN_OBSERVATIONS &&
+                existing.confidence >= PROCEDURAL_MIN_CONFIDENCE) {
+                existing.crystallised = true;
+                logger.info(`[procedural] Pattern crystallised: ${existing.taskType} (${existing.toolSequence.join(' → ')})`);
+            }
+            this.dirty = true;
+            return existing;
+        }
+        // Create new pattern
+        const pattern = {
+            id: randomUUID(),
+            taskType: taskType ?? inferTaskType(sequence),
+            project: project ?? null,
+            toolSequence: sequence,
+            argPatterns: {},
+            observationCount: 1,
+            confidence: 0.3,
+            lastObservedAt: new Date().toISOString(),
+            createdAt: new Date().toISOString(),
+            linkedNodeIds: [],
+            crystallised: false,
+        };
+        this.store.patterns.push(pattern);
+        this.dirty = true;
+        logger.debug(`[procedural] New pattern observed: ${pattern.taskType} (${sequence.join(' → ')})`);
+        return pattern;
+    }
+    /** Get all crystallised patterns. */
+    getCrystallised() {
+        return this.store.patterns.filter(p => p.crystallised);
+    }
+    /** Get patterns for a specific project. */
+    getForProject(project) {
+        return this.store.patterns.filter(p => p.project === project || p.project === null);
+    }
+    /** Get the most relevant pattern for a task type + project. */
+    findBestPattern(taskType, project) {
+        const candidates = this.store.patterns
+            .filter(p => p.crystallised && p.taskType === taskType)
+            .filter(p => !project || p.project === project || p.project === null)
+            .sort((a, b) => b.confidence - a.confidence);
+        return candidates.length > 0 ? candidates[0] : null;
+    }
+    /** Get all patterns (for export / brain synthesis). */
+    getAllPatterns() {
+        return [...this.store.patterns];
+    }
+    /** Compute a normalised signature from a tool sequence. */
+    computeSignature(sequence) {
+        // Normalise: collapse consecutive identical tools into one
+        const collapsed = [];
+        for (const tool of sequence) {
+            if (collapsed.length === 0 || collapsed[collapsed.length - 1] !== tool) {
+                collapsed.push(tool);
+            }
+        }
+        return collapsed.join('|');
+    }
+}
+/**
+ * Infer a task type label from a tool-call sequence.
+ * Heuristic: look at which tools dominate the sequence.
+ */
+function inferTaskType(sequence) {
+    const counts = new Map();
+    for (const tool of sequence) {
+        counts.set(tool, (counts.get(tool) ?? 0) + 1);
+    }
+    const hasFileWrite = counts.has('file_write');
+    const hasFileEdit = counts.has('file_edit');
+    const hasBash = counts.has('bash');
+    const hasTestRun = counts.has('test_run');
+    const hasGitCommit = counts.has('git_commit');
+    const hasWebSearch = counts.has('web_search');
+    const hasGenerateImage = counts.has('generate_image');
+    if (hasGenerateImage)
+        return 'asset-generation';
+    if (hasWebSearch && !hasFileEdit && !hasFileWrite)
+        return 'research';
+    if (hasTestRun)
+        return 'test-driven';
+    if (hasFileWrite && !hasFileEdit)
+        return 'file-creation';
+    if (hasFileEdit && hasBash)
+        return 'edit-and-verify';
+    if (hasFileEdit && hasGitCommit)
+        return 'edit-and-commit';
+    if (hasFileEdit)
+        return 'editing';
+    if (hasBash)
+        return 'shell-task';
+    return 'general';
+}
+//# sourceMappingURL=procedural.js.map

package/dist/memory/procedural.js.map

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

package/dist/memory/project-brain.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Project Brain — pre-computed synthesis of all project knowledge.
+ *
+ * After each session, the project brain is regenerated from the project's
+ * memory subgraph. It produces a ~200-token brief that's injected at
+ * session start BEFORE any recall — guaranteeing warm starts regardless
+ * of the user's first message.
+ *
+ * The brief includes: stack, key decisions, active work, learned
+ * patterns, known issues, and confidence stats. It's cached to
+ * brain.json and only regenerated when the graph has changed.
+ */
+import type { MemoryGraph } from './graph-engine.js';
+import type { ProjectBrain, ProceduralPattern } from './types.js';
+/**
+ * Compute a project brain from a graph and optional procedural patterns.
+ */
+export declare function synthesiseProjectBrain(graph: MemoryGraph, projectRoot: string, procedures?: ProceduralPattern[]): ProjectBrain;
+/**
+ * Load a cached project brain from disk. Returns null if not found or stale.
+ */
+export declare function loadProjectBrain(brainDir: string, currentGraphHash?: string): Promise<ProjectBrain | null>;
+/**
+ * Save a project brain to disk.
+ */
+export declare function saveProjectBrain(brainDir: string, brain: ProjectBrain): Promise<void>;
+//# sourceMappingURL=project-brain.d.ts.map

package/dist/memory/project-brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-brain.d.ts","sourceRoot":"","sources":["../../src/memory/project-brain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAc,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAK9E;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,MAAM,EACnB,UAAU,GAAE,iBAAiB,EAAO,GACnC,YAAY,CAoHd;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAmBhH;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAK3F"}

package/dist/memory/project-brain.js

@@ -0,0 +1,158 @@
+/**
+ * Project Brain — pre-computed synthesis of all project knowledge.
+ *
+ * After each session, the project brain is regenerated from the project's
+ * memory subgraph. It produces a ~200-token brief that's injected at
+ * session start BEFORE any recall — guaranteeing warm starts regardless
+ * of the user's first message.
+ *
+ * The brief includes: stack, key decisions, active work, learned
+ * patterns, known issues, and confidence stats. It's cached to
+ * brain.json and only regenerated when the graph has changed.
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { localYmd, todayLocal } from '../core/dates.js';
+import { existsSync } from 'node:fs';
+import { join, dirname, basename } from 'node:path';
+import { logger } from '../core/logger.js';
+const BRAIN_FILENAME = 'brain.json';
+const MAX_BRIEF_CHARS = 800; // ~200 tokens at 4 chars/token
+/**
+ * Compute a project brain from a graph and optional procedural patterns.
+ */
+export function synthesiseProjectBrain(graph, projectRoot, procedures = []) {
+    const nodes = graph.getActiveNodes();
+    const stats = graph.getStats();
+    const projectName = basename(projectRoot) || 'Unknown Project';
+    // ── Group by category, take top 3 per by confidence ────────────────
+    const byCategory = new Map();
+    for (const node of nodes) {
+        const list = byCategory.get(node.category) || [];
+        list.push(node);
+        byCategory.set(node.category, list);
+    }
+    // Sort each group by effective confidence descending
+    for (const [, list] of byCategory) {
+        list.sort((a, b) => graph.getEffectiveConfidence(b) - graph.getEffectiveConfidence(a));
+    }
+    // ── Extract stack (from architecture nodes) ─────────────────────────
+    const archNodes = (byCategory.get('architecture') || []).slice(0, 5);
+    const stack = [];
+    for (const node of archNodes) {
+        // Extract technology names heuristically (capitalised words, known patterns)
+        const techs = node.content.match(/\b(?:React|Next\.?js|Vue|Svelte|Angular|Tailwind|Vite|esbuild|Tauri|Capacitor|Supabase|PostgreSQL|Redis|TypeScript|Rust|Python|Go|Node\.?js|Express|Django|Flask|pnpm|npm|yarn|Docker|Kubernetes|Vercel|AWS|GCP|Azure)\b/gi);
+        if (techs)
+            stack.push(...techs.map(t => t.trim()));
+    }
+    const uniqueStack = [...new Set(stack.map(s => s.toLowerCase()))].map(s => {
+        // Capitalise properly
+        const found = stack.find(t => t.toLowerCase() === s);
+        return found || s;
+    }).slice(0, 8);
+    // ── Extract key decisions ───────────────────────────────────────────
+    const decisionNodes = (byCategory.get('decision') || []).slice(0, 5);
+    const keyDecisions = decisionNodes.map(n => truncate(n.content, 100));
+    // ── Extract active work (most recent general/session nodes) ────────
+    const recentNodes = nodes
+        .filter(n => n.tags?.includes('session-context') || n.tags?.includes('compression'))
+        .sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime())
+        .slice(0, 3);
+    const activeWork = recentNodes.map(n => truncate(n.content, 100));
+    // ── Extract known patterns (crystallised procedures) ────────────────
+    const crystallised = procedures
+        .filter(p => p.crystallised)
+        .sort((a, b) => b.confidence - a.confidence)
+        .slice(0, 3);
+    const knownPatterns = crystallised.map(p => `${p.taskType}: ${p.toolSequence.join(' → ')} (observed ${p.observationCount}×)`);
+    // ── Extract known issues (bug-fix nodes not marked resolved) ────────
+    const bugNodes = (byCategory.get('bug-fix') || [])
+        .filter(n => {
+        const resolvedEdges = graph.getEdgesFrom(n.id, 'resolved-by');
+        return resolvedEdges.length === 0; // unresolved
+    })
+        .slice(0, 3);
+    // ── Build the brief ─────────────────────────────────────────────────
+    const parts = [];
+    parts.push(`[Project: ${projectName}]`);
+    if (uniqueStack.length > 0) {
+        parts.push(`Stack: ${uniqueStack.join(', ')}`);
+    }
+    if (keyDecisions.length > 0) {
+        parts.push(`Decisions: ${keyDecisions.join(' | ')}`);
+    }
+    if (activeWork.length > 0) {
+        parts.push(`Recent: ${activeWork.join(' | ')}`);
+    }
+    if (knownPatterns.length > 0) {
+        parts.push(`Patterns: ${knownPatterns.join(' | ')}`);
+    }
+    if (bugNodes.length > 0) {
+        parts.push(`Open issues: ${bugNodes.map(n => truncate(n.content, 60)).join(' | ')}`);
+    }
+    parts.push(`Nodes: ${stats.activeNodes} active, confidence avg ${stats.avgConfidence}`);
+    // Find last session date from most recent node.
+    //
+    // BOTH branches render locally. They used to agree only by both being UTC —
+    // one slicing a stored ISO string, the other calling toISOString — and
+    // converting a single branch would have made "last session" jump a day
+    // depending on which one produced it. This is shown to the user, so local is
+    // the right answer for both.
+    const lastSessionDate = nodes.length > 0
+        ? localYmd(new Date(nodes.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime())[0].updatedAt))
+        : todayLocal();
+    let brief = parts.join('\n');
+    if (brief.length > MAX_BRIEF_CHARS) {
+        // Trim from the bottom (patterns and issues are least critical)
+        brief = brief.slice(0, MAX_BRIEF_CHARS).trimEnd() + '…';
+    }
+    return {
+        projectRoot,
+        generatedAt: new Date().toISOString(),
+        nodeCount: nodes.length,
+        brief,
+        stack: uniqueStack,
+        keyDecisions,
+        activeWork,
+        knownPatterns,
+        confidenceAvg: stats.avgConfidence,
+        lastSessionDate,
+        graphHash: graph.getGraphHash(),
+    };
+}
+/**
+ * Load a cached project brain from disk. Returns null if not found or stale.
+ */
+export async function loadProjectBrain(brainDir, currentGraphHash) {
+    const brainPath = join(brainDir, BRAIN_FILENAME);
+    if (!existsSync(brainPath))
+        return null;
+    try {
+        const raw = await readFile(brainPath, 'utf-8');
+        const brain = JSON.parse(raw);
+        // Check staleness: if the graph has changed since the brain was generated,
+        // the brain is stale and should be regenerated
+        if (currentGraphHash && brain.graphHash !== currentGraphHash) {
+            logger.debug('[project-brain] Brain is stale — graph has changed since last generation');
+            return null;
+        }
+        return brain;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save a project brain to disk.
+ */
+export async function saveProjectBrain(brainDir, brain) {
+    const brainPath = join(brainDir, BRAIN_FILENAME);
+    await mkdir(dirname(brainPath), { recursive: true });
+    await writeFile(brainPath, JSON.stringify(brain, null, 2), 'utf-8');
+    logger.debug(`[project-brain] Saved brain for ${brain.projectRoot} (${brain.nodeCount} nodes, ${brain.brief.length} chars)`);
+}
+function truncate(text, maxLen) {
+    if (text.length <= maxLen)
+        return text;
+    return text.slice(0, maxLen - 1).trimEnd() + '…';
+}
+//# sourceMappingURL=project-brain.js.map

package/dist/memory/project-brain.js.map

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

package/dist/memory/self-improvement.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Self-Improvement Memory — Ava learns from her own experiences.
+ *
+ * Two pools:
+ * 1. Local — personal learnings per user (~/.ava/self-improvement.json)
+ * 2. Global — shared across all users (Supabase, sanitised)
+ *
+ * NEVER stores user code, messages, or personal data.
+ */
+export interface SelfImprovement {
+    id: string;
+    type: 'technique' | 'tool-fix' | 'error-recovery' | 'preference' | 'pattern';
+    category: string;
+    context: string;
+    learned: string;
+    confidence: number;
+    source: 'retry-success' | 'feedback-negative' | 'feedback-positive' | 'error-recovery' | 'observation';
+    confirmations: number;
+    lastConfirmedSession?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SelfImprovementStore {
+    version: number;
+    local: SelfImprovement[];
+    lastGlobalSync: string | null;
+}
+export declare function loadStore(avaHome: string): SelfImprovementStore;
+export declare function saveStore(avaHome: string, store: SelfImprovementStore): Promise<void>;
+/**
+ * Add a learning to the local store. Deduplicates against existing entries
+ * by similarity — if a similar learning exists, updates it instead.
+ */
+export declare function addLearning(avaHome: string, learning: Omit<SelfImprovement, 'id' | 'confirmations' | 'createdAt' | 'updatedAt'>, sessionId?: string): Promise<SelfImprovement>;
+/**
+ * Search for relevant learnings by category/context keywords.
+ * Returns the most relevant learnings sorted by relevance score.
+ */
+export declare function getRelevantLearnings(avaHome: string, context: string, limit?: number): SelfImprovement[];
+/**
+ * Build a concise prompt section with relevant learnings for injection
+ * into the system prompt. Max ~500 chars.
+ */
+export declare function buildSelfImprovementPrompt(avaHome: string, currentContext?: string): string;
+//# sourceMappingURL=self-improvement.d.ts.map

package/dist/memory/self-improvement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-improvement.d.ts","sourceRoot":"","sources":["../../src/memory/self-improvement.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,gBAAgB,GAAG,YAAY,GAAG,SAAS,CAAC;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,aAAa,CAAC;IACvG,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAaD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAe/D;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAS3F;AAkBD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,eAAe,GAAG,WAAW,GAAG,WAAW,CAAC,EACnF,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAmD1B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,KAAK,SAAK,GACT,eAAe,EAAE,CA+BnB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CA2BR"}