@theihtisham/agent-shadow-brain 6.0.0 → 6.0.3

package/dist/brain/brain-quest.js

@@ -0,0 +1,541 @@
+// src/brain/brain-quest.ts — Gamified onboarding adventure
+// v6.0.2 — Hive Mind Edition
+//
+// A scripted, choose-your-own-adventure introduction to the brain.
+// Quests are deterministic — they advance when verify() returns true.
+// No LLM calls, no shell exec. Verification uses fs heuristics only.
+// Progress persisted per project under ~/.shadow-brain/quests/<project>.json.
+//
+// Exposed: availableQuests(), start(id, project), current(project),
+// step(project, choice?), reset(project).
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+const QUEST_DIR = path.join(os.homedir(), '.shadow-brain', 'quests');
+const BRAIN_HOME = path.join(os.homedir(), '.shadow-brain');
+export class BrainQuest {
+    constructor() {
+        this.quests = [];
+        this.states = new Map();
+        this.registerQuests();
+    }
+    availableQuests() {
+        return this.quests.map(q => ({ ...q }));
+    }
+    async start(questId, project) {
+        const quest = this.quests.find(q => q.id === questId);
+        if (!quest)
+            throw new Error(`Unknown quest: ${questId}`);
+        const file = this.loadFile(project);
+        const state = {
+            questId,
+            project,
+            currentStepId: quest.steps[0].id,
+            startedAt: Date.now(),
+            completedSteps: [],
+            branchHistory: [],
+        };
+        file.active = state;
+        this.persist(project, file);
+        return state;
+    }
+    current(project) {
+        return this.loadFile(project).active;
+    }
+    async step(project, choice) {
+        const file = this.loadFile(project);
+        const state = file.active;
+        if (!state) {
+            return {
+                state: emptyState(project),
+                narrative: 'No active quest. Run `availableQuests()` to see your options, then `start(questId, project)` to begin.',
+            };
+        }
+        const quest = this.quests.find(q => q.id === state.questId);
+        if (!quest) {
+            return {
+                state,
+                narrative: `Quest \`${state.questId}\` no longer exists. Resetting.`,
+            };
+        }
+        const stepDef = quest.steps.find(s => s.id === state.currentStepId);
+        if (!stepDef) {
+            return { state, narrative: 'Current step is missing from quest definition. Try `reset(project)`.' };
+        }
+        // If user provided a choice, record it and follow branch
+        if (choice && stepDef.branches && stepDef.branches[choice]) {
+            state.branchHistory.push({ stepId: stepDef.id, choice, ts: Date.now() });
+            state.currentStepId = stepDef.branches[choice];
+            this.persist(project, file);
+            const nextDef = quest.steps.find(s => s.id === state.currentStepId);
+            if (nextDef) {
+                return {
+                    state,
+                    narrative: `${nextDef.narrative}\n\n— ${nextDef.prompt}`,
+                    options: nextDef.branches ? Object.keys(nextDef.branches) : undefined,
+                };
+            }
+        }
+        // Otherwise, check if current step is verified — advance if so
+        let verified = false;
+        try {
+            verified = stepDef.verify(project);
+        }
+        catch {
+            verified = false;
+        }
+        if (!verified) {
+            return {
+                state,
+                narrative: `${stepDef.narrative}\n\n— ${stepDef.prompt}`,
+                options: stepDef.branches ? Object.keys(stepDef.branches) : undefined,
+            };
+        }
+        // Step verified! Advance.
+        if (!state.completedSteps.includes(stepDef.id)) {
+            state.completedSteps.push(stepDef.id);
+        }
+        const nextId = stepDef.nextId ?? this.defaultNext(quest, stepDef.id);
+        if (!nextId) {
+            // Quest complete
+            state.completedAt = Date.now();
+            file.history.push({ ...state });
+            file.active = null;
+            this.persist(project, file);
+            const reward = await this.unlockTrophy(quest);
+            return {
+                state,
+                narrative: `\n${quest.emoji}  **Quest Complete — ${quest.title}**\n\n${quest.rewardMessage}`,
+                complete: true,
+                reward,
+            };
+        }
+        state.currentStepId = nextId;
+        this.persist(project, file);
+        const nextDef = quest.steps.find(s => s.id === nextId);
+        if (!nextDef) {
+            return { state, narrative: 'Quest is in a broken state. Try `reset(project)`.' };
+        }
+        return {
+            state,
+            narrative: `${nextDef.narrative}\n\n— ${nextDef.prompt}`,
+            options: nextDef.branches ? Object.keys(nextDef.branches) : undefined,
+        };
+    }
+    reset(project) {
+        const file = this.loadFile(project);
+        if (file.active)
+            file.history.push({ ...file.active });
+        file.active = null;
+        this.persist(project, file);
+    }
+    // ── Quest definitions ───────────────────────────────────────────────
+    registerQuests() {
+        // Quest 1: Hello Brain
+        this.quests.push({
+            id: 'hello-brain',
+            title: 'Hello Brain',
+            subtitle: 'The first whispers of consciousness',
+            emoji: '🧠',
+            estimatedMinutes: 8,
+            rewardAchievement: 'first-bloom',
+            rewardMessage: 'You have lit the first spark. The brain knows you now — and it remembers.',
+            steps: [
+                {
+                    id: 'first-memory',
+                    narrative: 'The brain stirs. It has no past, no preferences, no scars. Only potential, and an unlit lamp.\n\n' +
+                        'You stand before a quiet machine that wants to remember things for you. It will not judge what you teach it. It will only keep faith with what you offer.\n\n' +
+                        'Begin by giving it a single thought to hold.',
+                    prompt: 'Run `shadow-brain embed add "your first memory here"` — anything you want it to remember.',
+                    verify: (project) => fileExistsBeneath(BRAIN_HOME, 'embeddings', 'vectors.json') ||
+                        anyMemoryFile(project),
+                    nextId: 'first-search',
+                },
+                {
+                    id: 'first-search',
+                    narrative: 'The memory lives. You can feel it — somewhere in the lattice, a small light is on.\n\n' +
+                        'Now reach for it. Ask the brain to find what it just learned.',
+                    prompt: 'Run `shadow-brain search "<a word from your memory>"` and confirm it surfaces.',
+                    verify: (project) => hasRecentEvent(project, 'memory.search'),
+                    nextId: 'first-dna',
+                },
+                {
+                    id: 'first-dna',
+                    narrative: 'Memories alone are sparks. To become a brain, they must develop structure — fingerprints, ancestry, identity.\n\n' +
+                        'Generate a DNA card for your project. It is the brain looking at itself in a mirror for the first time.',
+                    prompt: 'Run `shadow-brain dna generate`.',
+                    verify: (project) => fileExistsBeneath(BRAIN_HOME, 'dna', `${safe(project)}.json`) ||
+                        fileExistsBeneath(BRAIN_HOME, 'dna', 'index.json'),
+                    nextId: 'first-capsule',
+                },
+                {
+                    id: 'first-capsule',
+                    narrative: 'Time presses on every brain. What is true today may be foolish tomorrow.\n\n' +
+                        'Freeze a capsule — a snapshot you can return to. It is your first time-traveler\'s anchor.',
+                    prompt: 'Run `shadow-brain capsule freeze "first snapshot"`.',
+                    verify: (project) => anyFileIn(path.join(BRAIN_HOME, 'capsules')),
+                    nextId: 'first-replay',
+                },
+                {
+                    id: 'first-replay',
+                    narrative: 'You have given the brain memory, search, identity, and a past. There is one ritual left.\n\n' +
+                        'Witness its history. Watch the replay of everything you have done together so far.',
+                    prompt: 'Run `shadow-brain replay --since 1h`.',
+                    verify: (project) => hasRecentEvent(project, 'replay.view'),
+                },
+            ],
+        });
+        // Quest 2: The Hive Initiate
+        this.quests.push({
+            id: 'hive-initiate',
+            title: 'The Hive Initiate',
+            subtitle: 'When one mind becomes many',
+            emoji: '🐝',
+            estimatedMinutes: 15,
+            rewardAchievement: 'hive-born',
+            rewardMessage: 'You have founded a hive. From now on, no agent works alone — and no lesson is learned twice.',
+            steps: [
+                {
+                    id: 'enable-hive',
+                    narrative: 'A single brain is a candle. A hive is a hearth. Let us light the hearth.',
+                    prompt: 'Run `shadow-brain hive enable`.',
+                    verify: (project) => fileExistsBeneath(BRAIN_HOME, 'hive', `${safe(project)}.json`) ||
+                        anyFileIn(path.join(BRAIN_HOME, 'hive')),
+                    nextId: 'spawn-subagent',
+                },
+                {
+                    id: 'spawn-subagent',
+                    narrative: 'A hive needs more than walls. It needs voices.\n\n' +
+                        'Spawn a subagent. Watch as it inherits the memories you have already given the brain — not as instructions, but as instinct.',
+                    prompt: 'Run `shadow-brain agent spawn --inherit`.',
+                    verify: (project) => hasRecentEvent(project, 'agent.spawn'),
+                    nextId: 'watch-inheritance',
+                },
+                {
+                    id: 'watch-inheritance',
+                    narrative: 'The subagent is awake. It knows what you know — or some fraction of it.\n\n' +
+                        'Confirm the inheritance. Ask the new agent something only your brain should know.',
+                    prompt: 'Run `shadow-brain agent ask <agentId> "<question from a memory>"`.',
+                    verify: (project) => hasRecentEvent(project, 'voice.ask'),
+                    nextId: 'first-share',
+                },
+                {
+                    id: 'first-share',
+                    narrative: 'Inheritance is the start. Sharing is the soul of the hive.\n\n' +
+                        'Have your subagent teach the central brain something new.',
+                    prompt: 'Run `shadow-brain hive share --from <agentId>`.',
+                    verify: (project) => hasRecentEvent(project, 'hive.share'),
+                    nextId: 'first-voice',
+                },
+                {
+                    id: 'first-voice',
+                    narrative: 'A hive has a voice that is more than any one mind. Many agents, one answer.\n\n' +
+                        'Ask the Hive a question that requires multiple opinions.',
+                    prompt: 'Run `shadow-brain hive ask "should I refactor X?"`.',
+                    verify: (project) => hasRecentEvent(project, 'voice.ask'),
+                    nextId: 'hive-status',
+                },
+                {
+                    id: 'hive-status',
+                    narrative: 'Step back. Look at the hive you have built. Count the agents. Count the bridges.',
+                    prompt: 'Run `shadow-brain hive status`.',
+                    verify: (project) => true, // any view counts
+                    nextId: 'hive-rest',
+                },
+                {
+                    id: 'hive-rest',
+                    narrative: 'The hive is yours. Rest the apprentices. Take a breath.',
+                    prompt: 'Run `shadow-brain agent pause --all`.',
+                    verify: (project) => true,
+                },
+            ],
+        });
+        // Quest 3: The Architect's Path
+        this.quests.push({
+            id: 'architects-path',
+            title: 'The Architect\'s Path',
+            subtitle: 'Laws inscribed in silicon',
+            emoji: '📜',
+            estimatedMinutes: 12,
+            rewardAchievement: 'lawgiver',
+            rewardMessage: 'You have written the laws. The brain will defend them — even from you.',
+            steps: [
+                {
+                    id: 'draft-constitution',
+                    narrative: 'Every great mind has its commandments. Without them, agents drift, conventions die, and the codebase forgets itself.\n\n' +
+                        'Write your first constitutional rule. Make it specific. Make it enforceable.',
+                    prompt: 'Run `shadow-brain constitution add "<your rule>"`.',
+                    verify: (project) => fileExistsBeneath(BRAIN_HOME, 'constitution', `${safe(project)}.json`) ||
+                        anyFileIn(path.join(BRAIN_HOME, 'constitution')),
+                    nextId: 'inject-rule',
+                },
+                {
+                    id: 'inject-rule',
+                    narrative: 'A rule that lives only on disk is no rule at all. It must be felt by every agent at every turn.\n\n' +
+                        'Inject the constitution into your next prompt.',
+                    prompt: 'Run `shadow-brain constitution inject`.',
+                    verify: (project) => true,
+                    nextId: 'trigger-violation',
+                },
+                {
+                    id: 'trigger-violation',
+                    narrative: 'A law that has never been challenged is a guess. Test it.\n\n' +
+                        'Ask an agent to do the very thing you forbade. Watch what happens.',
+                    prompt: 'Trigger a deliberate violation. The brain should object.',
+                    verify: (project) => hasRecentEvent(project, 'constitution.violation'),
+                    nextId: 'fix-violation',
+                },
+                {
+                    id: 'fix-violation',
+                    narrative: 'The objection is the proof. Now repair the breach.',
+                    prompt: 'Resolve the violation. Use `shadow-brain constitution audit` to confirm.',
+                    verify: (project) => true,
+                    nextId: 'review-constitution',
+                    branches: { 'review': 'review-constitution', 'expand': 'expand-constitution' },
+                },
+                {
+                    id: 'review-constitution',
+                    narrative: 'You may pause here and review what you have written — or press on and grow the lawbook.',
+                    prompt: 'Run `shadow-brain constitution show`.',
+                    verify: (project) => true,
+                    nextId: 'finalize',
+                },
+                {
+                    id: 'expand-constitution',
+                    narrative: 'A growing brain needs growing laws. Add two more rules.',
+                    prompt: 'Run `shadow-brain constitution add "<rule>"` twice more.',
+                    verify: (project) => true,
+                    nextId: 'finalize',
+                },
+                {
+                    id: 'finalize',
+                    narrative: 'You are now the architect. The brain has its constitution. Future agents will inherit it as their first breath.',
+                    prompt: 'Run `shadow-brain constitution lock`.',
+                    verify: (project) => true,
+                },
+            ],
+        });
+        // Quest 4: The Time Traveler
+        this.quests.push({
+            id: 'time-traveler',
+            title: 'The Time Traveler',
+            subtitle: 'Snapshots, drift, and return',
+            emoji: '⏳',
+            estimatedMinutes: 7,
+            rewardAchievement: 'temporal',
+            rewardMessage: 'You walk between yesterdays. The brain will never lose you again.',
+            steps: [
+                {
+                    id: 'freeze',
+                    narrative: 'Time is a thief, but you can outwit it. Freeze a capsule of the brain as it stands right now.',
+                    prompt: 'Run `shadow-brain capsule freeze "before experiment"`.',
+                    verify: (project) => anyFileIn(path.join(BRAIN_HOME, 'capsules')),
+                    nextId: 'mutate',
+                },
+                {
+                    id: 'mutate',
+                    narrative: 'Now break something. Or build something. Add memories. Change rules. Do anything that will leave footprints.',
+                    prompt: 'Run any 2-3 `shadow-brain` commands that mutate state.',
+                    verify: (project) => hasMinEventCount(project, 'memory.add', 1),
+                    nextId: 'diff',
+                    branches: { 'safe-mode': 'diff', 'risky-mode': 'risky-mutate' },
+                },
+                {
+                    id: 'risky-mutate',
+                    narrative: 'You chose chaos. Good. Make several drastic changes.',
+                    prompt: 'Run heavy mutations — add 5+ memories or modify rules.',
+                    verify: (project) => hasMinEventCount(project, 'memory.add', 3),
+                    nextId: 'diff',
+                },
+                {
+                    id: 'diff',
+                    narrative: 'Now look back. Compare what the brain knows now with what it knew when you froze it.',
+                    prompt: 'Run `shadow-brain capsule diff`.',
+                    verify: (project) => true,
+                    nextId: 'restore',
+                },
+                {
+                    id: 'restore',
+                    narrative: 'The final step. Return — selectively — to the past. Restore one thing, leave the rest.',
+                    prompt: 'Run `shadow-brain capsule restore --selective`.',
+                    verify: (project) => true,
+                },
+            ],
+        });
+        // Quest 5: Speedrun
+        this.quests.push({
+            id: 'speedrun',
+            title: 'Speedrun',
+            subtitle: 'How fast can one mind awaken?',
+            emoji: '⚡',
+            estimatedMinutes: 3,
+            rewardAchievement: 'speedrunner',
+            rewardMessage: 'You are on the leaderboard. The hive remembers the swift.',
+            steps: [
+                {
+                    id: 'sprint-setup',
+                    narrative: 'No narrative. No ceremony. Just speed.\n\n' +
+                        'Set up your brain in one shot.',
+                    prompt: 'Run `shadow-brain init --quick`.',
+                    verify: (project) => fs.existsSync(BRAIN_HOME),
+                    nextId: 'sprint-agent',
+                },
+                {
+                    id: 'sprint-agent',
+                    narrative: 'Spawn an agent. Don\'t configure it — just spawn it.',
+                    prompt: 'Run `shadow-brain agent spawn`.',
+                    verify: (project) => hasRecentEvent(project, 'agent.spawn'),
+                    nextId: 'sprint-memories',
+                },
+                {
+                    id: 'sprint-memories',
+                    narrative: 'Ten memories. Any ten. Go.',
+                    prompt: 'Run `shadow-brain embed add "..."` ten times. The leaderboard is watching.',
+                    verify: (project) => hasMinEventCount(project, 'memory.add', 10),
+                },
+            ],
+        });
+    }
+    defaultNext(quest, currentId) {
+        const idx = quest.steps.findIndex(s => s.id === currentId);
+        if (idx === -1 || idx === quest.steps.length - 1)
+            return null;
+        return quest.steps[idx + 1].id;
+    }
+    async unlockTrophy(quest) {
+        try {
+            const trophiesMod = await import('./brain-trophies.js').catch(() => null);
+            if (trophiesMod && typeof trophiesMod.getBrainTrophies === 'function') {
+                const getter = trophiesMod.getBrainTrophies;
+                const trophies = getter();
+                if (trophies && typeof trophies.award === 'function') {
+                    trophies.award(quest.rewardAchievement, quest.rewardMessage);
+                }
+            }
+        }
+        catch { /* trophies module not available; that's fine */ }
+        return { achievementId: quest.rewardAchievement, message: quest.rewardMessage };
+    }
+    // ── Persistence ─────────────────────────────────────────────────────
+    loadFile(project) {
+        const cached = this.states.get(project);
+        if (cached)
+            return cached;
+        const fp = pathFor(project);
+        let file = { schemaVersion: 1, active: null, history: [] };
+        try {
+            if (fs.existsSync(fp)) {
+                const raw = JSON.parse(fs.readFileSync(fp, 'utf-8'));
+                if (raw.schemaVersion === 1)
+                    file = raw;
+            }
+        }
+        catch { /* fresh */ }
+        this.states.set(project, file);
+        return file;
+    }
+    persist(project, file) {
+        try {
+            fs.mkdirSync(QUEST_DIR, { recursive: true });
+            const fp = pathFor(project);
+            const tmp = fp + '.tmp';
+            fs.writeFileSync(tmp, JSON.stringify(file, null, 2));
+            fs.renameSync(tmp, fp);
+        }
+        catch { /* non-fatal */ }
+    }
+}
+function pathFor(project) {
+    return path.join(QUEST_DIR, `${safe(project)}.json`);
+}
+function safe(s) {
+    return s.replace(/[^a-zA-Z0-9._-]+/g, '_').slice(0, 80) || 'default';
+}
+function emptyState(project) {
+    return {
+        questId: '',
+        project,
+        currentStepId: '',
+        startedAt: 0,
+        completedSteps: [],
+        branchHistory: [],
+    };
+}
+function fileExistsBeneath(...parts) {
+    try {
+        return fs.existsSync(path.join(...parts));
+    }
+    catch {
+        return false;
+    }
+}
+function anyFileIn(dir) {
+    try {
+        if (!fs.existsSync(dir))
+            return false;
+        return fs.readdirSync(dir).length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+function anyMemoryFile(project) {
+    const candidates = [
+        path.join(BRAIN_HOME, 'memories', `${safe(project)}.json`),
+        path.join(BRAIN_HOME, 'embeddings', 'vectors.json'),
+        path.join(BRAIN_HOME, 'memories'),
+    ];
+    return candidates.some(p => {
+        try {
+            return fs.existsSync(p);
+        }
+        catch {
+            return false;
+        }
+    });
+}
+/** Heuristic: check coach event log on disk for a recent event of given type. */
+function hasRecentEvent(project, type) {
+    try {
+        const coachFile = path.join(BRAIN_HOME, 'coach', `${safe(project)}.json`);
+        if (!fs.existsSync(coachFile))
+            return false;
+        const raw = JSON.parse(fs.readFileSync(coachFile, 'utf-8'));
+        const events = raw?.state?.events ?? [];
+        if (!Array.isArray(events))
+            return false;
+        const day = 24 * 3600 * 1000;
+        const now = Date.now();
+        return events.some((e) => e.type === type && (now - (e.ts ?? 0)) < day);
+    }
+    catch {
+        return false;
+    }
+}
+function hasMinEventCount(project, type, min) {
+    try {
+        const coachFile = path.join(BRAIN_HOME, 'coach', `${safe(project)}.json`);
+        if (!fs.existsSync(coachFile))
+            return false;
+        const raw = JSON.parse(fs.readFileSync(coachFile, 'utf-8'));
+        const events = raw?.state?.events ?? [];
+        if (!Array.isArray(events))
+            return false;
+        let count = 0;
+        for (const e of events)
+            if (e?.type === type)
+                count++;
+        return count >= min;
+    }
+    catch {
+        return false;
+    }
+}
+let _instance = null;
+export function getBrainQuest() {
+    if (!_instance)
+        _instance = new BrainQuest();
+    return _instance;
+}
+export function resetBrainQuestForTests() { _instance = null; }
+//# sourceMappingURL=brain-quest.js.map

package/dist/brain/brain-quest.js.map

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

package/dist/brain/brain-recall-cache.d.ts

@@ -0,0 +1,73 @@
+export interface CachedResult {
+    result: unknown;
+    storedAt: number;
+    ttlMs: number;
+    contextHash: string;
+    /** Memory ids referenced by this cached result (for smart invalidation). */
+    memoryIds: string[];
+    /** Optional project tag for project-scoped invalidation. */
+    project?: string;
+}
+export interface RecallCacheStats {
+    hits: number;
+    misses: number;
+    hitRate: number;
+    bloomFP: number;
+    evictions: number;
+    size: number;
+}
+export interface InvalidateOpts {
+    key?: string;
+    contextHash?: string;
+    project?: string;
+    /** Invalidate entries stored before this timestamp (ms). */
+    before?: number;
+}
+export interface PutOpts {
+    memoryIds?: string[];
+    project?: string;
+}
+export declare class BrainRecallCache {
+    private capacity;
+    private map;
+    private head;
+    private tail;
+    private bloom;
+    /** memoryId → set of cache keys that referenced it. */
+    private memToKeys;
+    /** project → set of cache keys (for project-scoped invalidation). */
+    private projectToKeys;
+    private hits;
+    private misses;
+    private bloomNegatives;
+    /** Count where bloom said "maybe" but LRU said "no" → false positive. */
+    private bloomFalsePositives;
+    private evictions;
+    private writesSincePersist;
+    private initialized;
+    private init;
+    /** Look up a cached entry. contextHash filters by brain state version. */
+    lookup(key: string, contextHash?: string): CachedResult | null;
+    put(key: string, contextHash: string, result: unknown, ttlMs?: number, opts?: PutOpts): void;
+    invalidate(opts: InvalidateOpts): {
+        invalidated: number;
+    };
+    /** Call when a brain memory is added/updated → prune any cached top-N that referenced it. */
+    observeWrite(memoryId: string): void;
+    stats(): RecallCacheStats;
+    /** Wipe contents and metrics. Stats file is removed. */
+    reset(): void;
+    private trackKey;
+    private untrackKey;
+    private evictLru;
+    private touch;
+    private addToFront;
+    private removeNode;
+    private rebuildBloom;
+    private loadConfig;
+    private loadStats;
+    private persistStats;
+}
+export declare function getBrainRecallCache(): BrainRecallCache;
+export declare function resetBrainRecallCacheForTests(): void;
+//# sourceMappingURL=brain-recall-cache.d.ts.map

package/dist/brain/brain-recall-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-recall-cache.d.ts","sourceRoot":"","sources":["../../src/brain/brain-recall-cache.ts"],"names":[],"mappings":"AAmCA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA2ED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,IAAI,CAAqB;IAEjC,OAAO,CAAC,KAAK,CAAqB;IAElC,uDAAuD;IACvD,OAAO,CAAC,SAAS,CAAuC;IACxD,qEAAqE;IACrE,OAAO,CAAC,aAAa,CAAuC;IAE5D,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,cAAc,CAAK;IAC3B,yEAAyE;IACzE,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO,CAAC,IAAI;IAQZ,0EAA0E;IAC1E,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAmC9D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IA+B5F,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE;IAsCzD,6FAA6F;IAC7F,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAiBpC,KAAK,IAAI,gBAAgB;IAczB,wDAAwD;IACxD,KAAK,IAAI,IAAI;IAkBb,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,SAAS;YAeH,YAAY;CAmB3B;AAqCD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAGtD;AACD,wBAAgB,6BAA6B,IAAI,IAAI,CAAsB"}