@project-ava-supernova/core 0.2.71

package/dist/learning/progression.js

@@ -0,0 +1,186 @@
+// Learner Progression — derives the honest, earned half of the learner profile
+// from the existing LearningStore (~/.ava/learning.json). Pure + dependency-free:
+// given the store, compute skills, certificates, achievements and stats. Nothing
+// here is persisted as truth — it's recomputed from graded performance every load,
+// which is exactly what keeps the credential honest (it can't be hand-edited).
+//
+// The editable half (bio, self-added skills/achievements) lives separately in
+// learner.json; the host merges the two for the Progression page. Self-added
+// skills carry source:'self' and "graduate" to verified when their name matches
+// an earned subject here.
+import { localYmd } from '../core/dates.js';
+/** Days without practice after which an earned skill is flagged stale. */
+const STALE_DAYS = 30;
+const allLessons = (c) => c.modules.flatMap((m) => m.lessons);
+const isMastered = (l) => l.status === 'completed';
+/** The LOCAL day a stored timestamp fell on.
+ *
+ *  Was `iso.slice(0, 10)`, which takes the UTC day straight off the string. The
+ *  heatmap that consumes this built its lookup keys the same way, so the two
+ *  agreed — by both being wrong. Practise at 23:00 in New York and the square
+ *  lit up on tomorrow; practise at 00:30 in British Summer Time and it lit up
+ *  on yesterday. Both sides moved together, because changing either alone
+ *  stops the keys matching and empties the heatmap. */
+const dayOf = (iso) => (iso ? localYmd(new Date(iso)) : null);
+/** Most recent of completed_at / last_reviewed_at / started_at for a lesson. */
+function lastTouch(l) {
+    const dates = [l.completed_at, l.last_reviewed_at, l.started_at].filter(Boolean);
+    if (!dates.length)
+        return null;
+    return dates.reduce((a, b) => (a > b ? a : b));
+}
+/** Stable, dependency-free djb2 hash → base36. A verify stamp, not a secret. */
+function stampHash(input) {
+    let h = 5381;
+    for (let i = 0; i < input.length; i++)
+        h = ((h << 5) + h + input.charCodeAt(i)) >>> 0;
+    return h.toString(36);
+}
+function avg(nums) {
+    if (!nums.length)
+        return null;
+    return Math.round(nums.reduce((a, b) => a + b, 0) / nums.length);
+}
+/** Blend mastery ratio + avg score into an honest tier. Completion alone never
+ *  reads as "mastered" if the scores are weak; strong scores nudge up a tier. */
+function skillLevel(masteryRatio, avgScore) {
+    let level = masteryRatio >= 0.85 ? 'mastered'
+        : masteryRatio >= 0.6 ? 'proficient'
+            : masteryRatio >= 0.25 ? 'familiar'
+                : 'novice';
+    if (avgScore !== null) {
+        if (level === 'mastered' && avgScore < 70)
+            level = 'proficient'; // high completion, weak grades ≠ mastery
+        else if (level === 'proficient' && avgScore >= 90 && masteryRatio >= 0.75)
+            level = 'mastered';
+    }
+    return level;
+}
+function deriveSkills(curriculums, now) {
+    // Group lessons by subject across all curriculums.
+    const bySubject = new Map();
+    for (const c of curriculums) {
+        const subject = (c.subject || 'General').trim() || 'General';
+        const entry = bySubject.get(subject) ?? { lessons: [], provenance: new Set() };
+        entry.lessons.push(...allLessons(c));
+        entry.provenance.add(c.id);
+        bySubject.set(subject, entry);
+    }
+    const skills = [];
+    for (const [name, { lessons, provenance }] of bySubject) {
+        const lessonsTotal = lessons.length;
+        const lessonsMastered = lessons.filter(isMastered).length;
+        if (lessonsMastered < 1 || lessonsTotal === 0)
+            continue; // not a skill yet — just an active course
+        const scores = lessons.map((l) => l.best_score).filter((s) => s !== null && s !== undefined);
+        const avgScore = avg(scores);
+        const masteryRatio = lessonsMastered / lessonsTotal;
+        const lastPracticed = lessons.map(lastTouch).filter(Boolean).sort().reverse()[0] ?? null;
+        const stale = lastPracticed ? (now - new Date(lastPracticed).getTime()) / 86_400_000 > STALE_DAYS : false;
+        skills.push({
+            name,
+            level: skillLevel(masteryRatio, avgScore),
+            source: 'earned',
+            provenance: [...provenance],
+            lessonsMastered,
+            lessonsTotal,
+            avgScore,
+            lastPracticed,
+            stale,
+        });
+    }
+    // Strongest first.
+    const order = ['mastered', 'proficient', 'familiar', 'novice'];
+    return skills.sort((a, b) => order.indexOf(a.level) - order.indexOf(b.level) || b.lessonsMastered - a.lessonsMastered);
+}
+function deriveCertificates(curriculums) {
+    return curriculums
+        .filter((c) => c.status === 'completed')
+        .map((c) => {
+        const lessons = allLessons(c);
+        const scores = lessons.map((l) => l.best_score).filter((s) => s !== null && s !== undefined);
+        const score = avg(scores) ?? 0;
+        const totalMinutes = lessons.reduce((s, l) => s + (l.time_spent_minutes || 0), 0);
+        return {
+            id: c.id,
+            title: c.title,
+            subject: c.subject,
+            level: c.level,
+            completedAt: c.completed_at,
+            score,
+            lessons: lessons.length,
+            hours: Math.round((totalMinutes / 60) * 10) / 10,
+            hash: stampHash(`${c.id}|${c.completed_at ?? ''}|${score}`),
+        };
+    })
+        .sort((a, b) => (b.completedAt ?? '').localeCompare(a.completedAt ?? ''));
+}
+function deriveAchievements(curriculums, store, lessonsMastered) {
+    const out = [];
+    const completed = curriculums.filter((c) => c.status === 'completed');
+    // Per completed course.
+    for (const c of completed) {
+        out.push({ id: `course:${c.id}`, title: `Completed “${c.title}”`, detail: c.subject, source: 'earned', earnedAt: c.completed_at, icon: '🎓' });
+    }
+    // First-course milestone.
+    if (completed.length >= 1) {
+        const first = [...completed].sort((a, b) => (a.completed_at ?? '').localeCompare(b.completed_at ?? ''))[0];
+        out.push({ id: 'first-course', title: 'First course completed', source: 'earned', earnedAt: first?.completed_at ?? null, icon: '🌱' });
+    }
+    // Lessons-mastered tiers.
+    for (const tier of [100, 50, 10]) {
+        if (lessonsMastered >= tier) {
+            out.push({ id: `lessons:${tier}`, title: `${tier} lessons mastered`, source: 'earned', earnedAt: null, icon: '📚' });
+            break;
+        }
+    }
+    // Streak badges (from the highest reached).
+    for (const tier of [100, 30, 7]) {
+        if (store.streaks.longest >= tier) {
+            out.push({ id: `streak:${tier}`, title: `${tier}-day learning streak`, source: 'earned', earnedAt: null, icon: '🔥' });
+            break;
+        }
+    }
+    return out;
+}
+function deriveStats(curriculums, store) {
+    const lessons = curriculums.flatMap(allLessons);
+    const lessonsMastered = lessons.filter(isMastered).length;
+    const scores = lessons.map((l) => l.best_score).filter((s) => s !== null && s !== undefined);
+    const totalMinutes = lessons.reduce((s, l) => s + (l.time_spent_minutes || 0), 0);
+    // Activity heatmap — count practice events per day.
+    const activity = {};
+    for (const l of lessons) {
+        for (const d of [dayOf(l.completed_at), dayOf(l.last_reviewed_at)]) {
+            if (d)
+                activity[d] = (activity[d] ?? 0) + 1;
+        }
+    }
+    return {
+        coursesTotal: curriculums.length,
+        coursesCompleted: curriculums.filter((c) => c.status === 'completed').length,
+        coursesActive: curriculums.filter((c) => c.status === 'active').length,
+        lessonsMastered,
+        avgScore: avg(scores),
+        totalHours: Math.round((totalMinutes / 60) * 10) / 10,
+        currentStreak: store.streaks.current,
+        longestStreak: store.streaks.longest,
+        activity,
+    };
+}
+/**
+ * Derive the earned half of the learner profile from the LearningStore.
+ * `nowMs` is injectable for deterministic tests (defaults to Date.now()).
+ */
+export function deriveProgression(store, nowMs) {
+    const now = nowMs ?? Date.now();
+    const curriculums = store.curriculums ?? [];
+    const stats = deriveStats(curriculums, store);
+    return {
+        skills: deriveSkills(curriculums, now),
+        certificates: deriveCertificates(curriculums),
+        achievements: deriveAchievements(curriculums, store, stats.lessonsMastered),
+        stats,
+    };
+}
+//# sourceMappingURL=progression.js.map

package/dist/learning/progression.js.map

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

package/dist/memory/ambient-capture.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Ambient Capture — always-on memory candidate scoring.
+ *
+ * Replaces the regex-pattern-only extraction system with a model that
+ * evaluates EVERY turn as a potential memory. A lightweight scoring
+ * model (Qwen Flash) rates each turn on novelty, relevance, and
+ * confidence. Candidates above threshold are promoted to real nodes.
+ *
+ * Fallback: when no LLM is available (BYOK without a cheap model),
+ * falls back to heuristic scoring. Zero-cost, lower recall, but never breaks.
+ */
+import type { MemoryGraph } from './graph-engine.js';
+import type { CaptureCandidate, CandidateScore } from './types.js';
+export declare function heuristicScore(candidate: CaptureCandidate, graph: MemoryGraph): CandidateScore;
+export declare function buildScoringPrompt(candidate: CaptureCandidate): string;
+export declare function parseScoringResponse(response: string): CandidateScore | null;
+export declare class AmbientCaptureManager {
+    private readonly graph;
+    private heldCandidates;
+    private readonly MAX_HELD;
+    constructor(graph: MemoryGraph);
+    evaluate(candidate: CaptureCandidate, llmScore?: CandidateScore | null, scope?: 'global' | 'project'): Promise<string | null>;
+    private promote;
+    private quickSimilarity;
+}
+//# sourceMappingURL=ambient-capture.d.ts.map

package/dist/memory/ambient-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambient-capture.d.ts","sourceRoot":"","sources":["../../src/memory/ambient-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EAGf,MAAM,YAAY,CAAC;AAMpB,wBAAgB,cAAc,CAC5B,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,WAAW,GACjB,cAAc,CA2ChB;AAID,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAatE;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAa5E;AAUD,qBAAa,qBAAqB;IAIpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAHlC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAM;gBAEF,KAAK,EAAE,WAAW;IAEzC,QAAQ,CACZ,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,EAChC,KAAK,GAAE,QAAQ,GAAG,SAAqB,GACtC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA6BzB,OAAO,CAAC,OAAO;IAkCf,OAAO,CAAC,eAAe;CAGxB"}

package/dist/memory/ambient-capture.js

@@ -0,0 +1,174 @@
+/**
+ * Ambient Capture — always-on memory candidate scoring.
+ *
+ * Replaces the regex-pattern-only extraction system with a model that
+ * evaluates EVERY turn as a potential memory. A lightweight scoring
+ * model (Qwen Flash) rates each turn on novelty, relevance, and
+ * confidence. Candidates above threshold are promoted to real nodes.
+ *
+ * Fallback: when no LLM is available (BYOK without a cheap model),
+ * falls back to heuristic scoring. Zero-cost, lower recall, but never breaks.
+ */
+import { logger } from '../core/logger.js';
+import { AMBIENT_PROMOTE_THRESHOLD, AMBIENT_HOLD_THRESHOLD } from './types.js';
+import { tokenize, buildTermVector, cosineSimilarity } from './tfidf.js';
+// ── Heuristic Scorer (zero-cost fallback) ───────────────────────────────────
+export function heuristicScore(candidate, graph) {
+    const text = `${candidate.userMessage} ${candidate.assistantMessage}`;
+    const lower = text.toLowerCase();
+    // Novelty
+    const similar = graph.findSimilar(text, { minSimilarity: 0.5 });
+    const maxSimilarity = similar.length > 0 ? similar[0].similarity : 0;
+    const novelty = 1 - maxSimilarity;
+    // Relevance — includes both technical AND personal signals so Chat
+    // mode turns get scored properly alongside coding conversations
+    let relevance = 0.3;
+    const relevanceKeywords = [
+        // Technical signals
+        'decided', 'decision', 'chose', 'use', 'architecture', 'convention',
+        'pattern', 'always', 'never', 'remember', 'important', 'prefer',
+        'go for it', 'sounds good', 'agreed', 'approved', 'perfect',
+        'the fix', 'the solution', 'the issue', 'we use', 'we chose', 'our stack',
+        // Personal / Chat mode signals
+        'my name', 'i live', 'i work', 'my family', 'my partner', 'my wife',
+        'my husband', 'my daughter', 'my son', 'my birthday', 'i love',
+        'i enjoy', 'i hate', 'i deal with', 'i struggle', 'my background',
+        'i have been', 'years experience', 'my dog', 'my cat',
+    ];
+    const matchCount = relevanceKeywords.filter(kw => lower.includes(kw)).length;
+    relevance = Math.min(1.0, relevance + matchCount * 0.08);
+    const importantTools = ['file_write', 'file_edit', 'git_commit', 'present_plan'];
+    const toolRelevance = candidate.toolsUsed.filter(t => importantTools.includes(t)).length;
+    relevance = Math.min(1.0, relevance + toolRelevance * 0.1);
+    // Confidence
+    let confidence = 0.4;
+    const explicitMarkers = [
+        'remember', 'keep in mind', 'note that', 'important:',
+        'don\'t forget', 'make sure', 'always', 'never',
+        'i decided', 'we decided', 'let\'s go with', 'approved',
+    ];
+    const explicitCount = explicitMarkers.filter(m => lower.includes(m)).length;
+    confidence = Math.min(1.0, confidence + explicitCount * 0.15);
+    const composite = (novelty * 0.35) + (relevance * 0.40) + (confidence * 0.25);
+    return { novelty, relevance, confidence, composite };
+}
+// ── LLM Scorer ──────────────────────────────────────────────────────────────
+export function buildScoringPrompt(candidate) {
+    return `Rate this conversation turn for memory extraction.
+
+USER: ${candidate.userMessage.slice(0, 300)}
+ASSISTANT: ${candidate.assistantMessage.slice(0, 300)}
+TOOLS: ${candidate.toolsUsed.join(', ') || 'none'}
+
+Rate on three dimensions (0.0-1.0):
+- novelty: How different from typical coding conversation? (0=routine, 1=unique)
+- relevance: How likely useful in future sessions? (0=throwaway, 1=persistent)
+- confidence: How clearly stated/decided? (0=vague, 1=explicit)
+
+Return JSON only: {"novelty": 0.0, "relevance": 0.0, "confidence": 0.0}`;
+}
+export function parseScoringResponse(response) {
+    try {
+        const jsonMatch = response.match(/\{[^}]+\}/);
+        if (!jsonMatch)
+            return null;
+        const parsed = JSON.parse(jsonMatch[0]);
+        const novelty = Math.max(0, Math.min(1, Number(parsed.novelty) || 0));
+        const relevance = Math.max(0, Math.min(1, Number(parsed.relevance) || 0));
+        const confidence = Math.max(0, Math.min(1, Number(parsed.confidence) || 0));
+        const composite = (novelty * 0.35) + (relevance * 0.40) + (confidence * 0.25);
+        return { novelty, relevance, confidence, composite };
+    }
+    catch {
+        return null;
+    }
+}
+export class AmbientCaptureManager {
+    graph;
+    heldCandidates = [];
+    MAX_HELD = 20;
+    constructor(graph) {
+        this.graph = graph;
+    }
+    async evaluate(candidate, llmScore, scope = 'project') {
+        const score = llmScore ?? heuristicScore(candidate, this.graph);
+        logger.debug(`[ambient] Scored: n=${score.novelty.toFixed(2)} r=${score.relevance.toFixed(2)} c=${score.confidence.toFixed(2)} composite=${score.composite.toFixed(2)}`);
+        if (score.composite >= AMBIENT_PROMOTE_THRESHOLD) {
+            return this.promote(candidate, score, scope);
+        }
+        if (score.composite >= AMBIENT_HOLD_THRESHOLD) {
+            const similarHeld = this.heldCandidates.find(h => {
+                const combinedText = `${h.candidate.userMessage} ${h.candidate.assistantMessage}`;
+                const currentText = `${candidate.userMessage} ${candidate.assistantMessage}`;
+                return this.quickSimilarity(combinedText, currentText) > 0.5;
+            });
+            if (similarHeld) {
+                this.heldCandidates = this.heldCandidates.filter(h => h !== similarHeld);
+                return this.promote(candidate, score, scope);
+            }
+            this.heldCandidates.push({ candidate, score, heldAt: new Date().toISOString() });
+            if (this.heldCandidates.length > this.MAX_HELD)
+                this.heldCandidates.shift();
+            return null;
+        }
+        return null;
+    }
+    promote(candidate, score, scope) {
+        const category = inferCategory(candidate);
+        const confidenceSource = score.confidence >= 0.8 ? 'stated' : 'ambient';
+        const content = distilCandidate(candidate);
+        const node = this.graph.addNode({
+            content,
+            category,
+            scope,
+            confidence: score.confidence,
+            confidenceSource,
+            source: 'ambient',
+            tags: ['ambient-captured'],
+            sourceSessionId: candidate.sessionId ?? null,
+        });
+        const contradiction = this.graph.detectContradiction(content, category);
+        if (contradiction) {
+            this.graph.addEdge({
+                fromNodeId: node.id,
+                toNodeId: contradiction.id,
+                type: 'contradicts',
+                weight: 0.8,
+                metadata: { source: 'ambient-contradiction-detection' },
+            });
+        }
+        return node.id;
+    }
+    quickSimilarity(a, b) {
+        return cosineSimilarity(buildTermVector(tokenize(a)), buildTermVector(tokenize(b)));
+    }
+}
+function inferCategory(candidate) {
+    const text = `${candidate.userMessage} ${candidate.assistantMessage}`.toLowerCase();
+    if (/\b(?:bug|fix|error|issue|crash|broken)\b/.test(text))
+        return 'bug-fix';
+    if (/\b(?:architecture|stack|framework|deploy|infrastructure)\b/.test(text))
+        return 'architecture';
+    if (/\b(?:decided|decision|chose|approved|go for it|sounds good)\b/.test(text))
+        return 'decision';
+    if (/\b(?:prefer|always|never|don't like|i want)\b/.test(text))
+        return 'preference';
+    if (/\b(?:convention|naming|style|format|indent)\b/.test(text))
+        return 'convention';
+    if (/\b(?:pattern|approach|technique|method)\b/.test(text))
+        return 'pattern';
+    if (/\b(?:config|env|setup|install|version)\b/.test(text))
+        return 'tool-config';
+    return 'general';
+}
+function distilCandidate(candidate) {
+    const userText = candidate.userMessage.trim();
+    const assistantText = candidate.assistantMessage.trim();
+    if (userText.length < 50 && assistantText.length > 0) {
+        return `User: "${userText.slice(0, 100)}" → ${assistantText.slice(0, 200)}`;
+    }
+    if (assistantText.length > userText.length)
+        return assistantText.slice(0, 300);
+    return userText.slice(0, 300);
+}
+//# sourceMappingURL=ambient-capture.js.map

package/dist/memory/ambient-capture.js.map

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

package/dist/memory/auto-extract.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Auto Memory Extraction — Two-Layer System
+ *
+ * Layer 1: Rule-based pattern matching (instant, zero cost)
+ *   Runs after EVERY agent turn. Catches explicit signals like
+ *   "I prefer", "remember that", corrections, decisions, etc.
+ *   Distills raw messages into concise, standalone summaries.
+ *
+ * Layer 2: LLM-powered reflection (smart, one cheap API call)
+ *   Runs at END of meaningful conversations (>= 2 user turns).
+ *   Asks the model to reflect on what was learned and extract
+ *   structured memories. Catches nuance, solutions, context,
+ *   and emotional context for future approach adjustments.
+ *
+ * Together: fast pattern matching catches the obvious stuff instantly,
+ * LLM reflection catches everything the regex missed.
+ */
+import type { Message } from '../core/types.js';
+import type { MemoryManager } from './memory-manager.js';
+import type { MemoryCategory, MemoryLayer } from './types.js';
+import type { Provider } from '../providers/types.js';
+import type { ModelDefinition } from '../core/types.js';
+interface ExtractedMemory {
+    content: string;
+    category: MemoryCategory;
+    scope: 'global' | 'project';
+    layer: MemoryLayer;
+    tags?: string[];
+}
+/**
+ * Layer 1: Extract memorable information from recent messages using regex patterns.
+ * Scans both user AND assistant messages for signals worth remembering.
+ * Distills raw messages into concise, standalone summaries.
+ */
+export declare function extractMemories(messages: Message[]): ExtractedMemory[];
+/**
+ * Layer 2: Use the LLM to reflect on the conversation and extract structured memories.
+ * Only runs for meaningful conversations (>= 2 user turns).
+ * Even short sessions can contain critical decisions or corrections.
+ */
+export declare function reflectAndExtract(messages: Message[], provider: Provider, model: ModelDefinition, maxTranscript?: number): Promise<ExtractedMemory[]>;
+/**
+ * Run Layer 1 (pattern-based) extraction and save any new memories.
+ * Designed to be called fire-and-forget after each agent turn.
+ * Deduplication is handled by the memory manager's TF-IDF similarity check.
+ */
+export declare function autoExtractAndSave(messages: Message[], memoryManager: MemoryManager, conversationId?: string): Promise<number>;
+/**
+ * Run Layer 2 (LLM reflection) and save extracted memories.
+ * Should only be called at end of conversation, not after every turn.
+ */
+export declare function reflectAndSave(messages: Message[], memoryManager: MemoryManager, provider: Provider, model: ModelDefinition, conversationId?: string, maxTranscript?: number): Promise<number>;
+export {};
+//# sourceMappingURL=auto-extract.d.ts.map

package/dist/memory/auto-extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-extract.d.ts","sourceRoot":"","sources":["../../src/memory/auto-extract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAsQD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,eAAe,EAAE,CAqDtE;AAwDD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,eAAe,EACtB,aAAa,SAAO,GACnB,OAAO,CAAC,eAAe,EAAE,CAAC,CAoE5B;AAMD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,OAAO,EAAE,EACnB,aAAa,EAAE,aAAa,EAC5B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,CAmCjB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,OAAO,EAAE,EACnB,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,eAAe,EACtB,cAAc,CAAC,EAAE,MAAM,EACvB,aAAa,SAAO,GACnB,OAAO,CAAC,MAAM,CAAC,CAgCjB"}