@theihtisham/agent-shadow-brain 5.2.0 → 6.0.2

package/dist/brain/brain-exchange.js

@@ -0,0 +1,106 @@
+// src/brain/brain-exchange.ts — Curated shareable brain slices
+// v6.0.0 — Hive Mind Edition
+//
+// Export a curated subset of your brain as a shareable JSON package. Import
+// someone else's package to instantly get expert knowledge for a domain.
+// Zero-server design: packages are plain JSON files on disk (or shared via
+// gist/HTTP/IPFS — transport is up to the user).
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as crypto from 'crypto';
+import { getGlobalBrain, GlobalBrain } from './global-brain.js';
+const EXCHANGE_DIR = path.join(os.homedir(), '.shadow-brain', 'exchange');
+export class BrainExchange {
+    constructor() {
+        this.brain = getGlobalBrain();
+    }
+    async export(opts) {
+        await this.brain.init();
+        fs.mkdirSync(EXCHANGE_DIR, { recursive: true });
+        const categories = opts.categories ?? [];
+        const keywords = opts.tags ?? [];
+        const limit = opts.limit ?? 500;
+        const minImportance = opts.minImportance ?? 0.5;
+        let entries = this.brain.recall({ keywords: keywords.length ? keywords : undefined, minImportance, limit });
+        if (categories.length) {
+            const allowed = new Set(categories.map(c => c.toLowerCase()));
+            entries = entries.filter(e => allowed.has(e.category.toLowerCase()));
+        }
+        const pkg = {
+            id: `pkg-${crypto.randomBytes(6).toString('hex')}`,
+            name: opts.name,
+            description: opts.description,
+            author: opts.author,
+            version: '1.0.0',
+            tags: opts.tags ?? [],
+            categories: Array.from(new Set(entries.map(e => e.category))),
+            memoryCount: entries.length,
+            memories: entries.map(e => ({
+                content: this.redact(e.content),
+                category: e.category,
+                importance: e.importance,
+            })),
+            createdAt: new Date(),
+            license: opts.license ?? 'MIT',
+        };
+        const safeName = opts.name.toLowerCase().replace(/[^a-z0-9_-]+/g, '-');
+        const filePath = path.join(EXCHANGE_DIR, `${safeName}-${pkg.id.slice(-6)}.json`);
+        fs.writeFileSync(filePath, JSON.stringify(pkg, null, 2));
+        return { filePath, package: pkg };
+    }
+    async import(filePath, opts = { projectDir: process.cwd() }) {
+        await this.brain.init();
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        const pkg = JSON.parse(raw);
+        const projectId = GlobalBrain.projectIdFor(opts.projectDir);
+        const projectName = path.basename(opts.projectDir);
+        let imported = 0;
+        for (const m of pkg.memories) {
+            this.brain.writeSync({
+                projectId,
+                projectName,
+                agentTool: opts.agentTool ?? 'claude-code',
+                category: m.category,
+                content: m.content,
+                importance: m.importance,
+                metadata: { origin: 'brain-exchange', packageId: pkg.id, packageName: pkg.name, author: pkg.author },
+            });
+            imported++;
+        }
+        return { imported, pkg };
+    }
+    listLocal() {
+        fs.mkdirSync(EXCHANGE_DIR, { recursive: true });
+        const files = fs.readdirSync(EXCHANGE_DIR).filter(f => f.endsWith('.json'));
+        const out = [];
+        for (const f of files) {
+            try {
+                const raw = fs.readFileSync(path.join(EXCHANGE_DIR, f), 'utf-8');
+                const pkg = JSON.parse(raw);
+                out.push({ ...pkg, createdAt: new Date(pkg.createdAt) });
+            }
+            catch {
+                /* skip */
+            }
+        }
+        return out.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    }
+    redact(content) {
+        return content
+            .replace(/(api[_-]?key|secret|token|password|passwd|pwd)\s*[:=]\s*["'][^"']{8,}["']/gi, '$1: [REDACTED]')
+            .replace(/[A-Za-z0-9+/=]{40,}/g, '[REDACTED_BLOB]')
+            .replace(/\b[\w.+-]+@[\w.-]+\.\w{2,}\b/g, '[REDACTED_EMAIL]')
+            .replace(/\b(?:\d{1,3}\.){3}\d{1,3}\b/g, '[REDACTED_IP]');
+    }
+}
+let _instance = null;
+export function getBrainExchange() {
+    if (!_instance)
+        _instance = new BrainExchange();
+    return _instance;
+}
+export function resetBrainExchangeForTests() {
+    _instance = null;
+}
+//# sourceMappingURL=brain-exchange.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brain-exchange.js","sourceRoot":"","sources":["../../src/brain/brain-exchange.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,6BAA6B;AAC7B,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,2EAA2E;AAC3E,iDAAiD;AAEjD,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;AAE1E,MAAM,OAAO,aAAa;IAGxB;QACE,IAAI,CAAC,KAAK,GAAG,cAAc,EAAE,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IASZ;QACC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC;QAChC,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,GAAG,CAAC;QAEhD,IAAI,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5G,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YAC9D,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,GAAG,GAAsB;YAC7B,EAAE,EAAE,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;YAClD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;YACrB,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC7D,WAAW,EAAE,OAAO,CAAC,MAAM;YAC3B,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC1B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;gBAC/B,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,UAAU,EAAE,CAAC,CAAC,UAAU;aACzB,CAAC,CAAC;YACH,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,KAAK;SAC/B,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,QAAQ,IAAI,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACjF,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACzD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,OAAmD,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE;QAC7G,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;QACjD,MAAM,SAAS,GAAG,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnD,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;gBACnB,SAAS;gBACT,WAAW;gBACX,SAAS,EAAG,IAAI,CAAC,SAAiB,IAAI,aAAa;gBACnD,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,QAAQ,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE;aACrG,CAAC,CAAC;YACH,QAAQ,EAAE,CAAC;QACb,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,SAAS;QACP,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5E,MAAM,GAAG,GAAwB,EAAE,CAAC;QACpC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;gBACjE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;gBACjD,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC3D,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU;YACZ,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IAEO,MAAM,CAAC,OAAe;QAC5B,OAAO,OAAO;aACX,OAAO,CAAC,6EAA6E,EAAE,gBAAgB,CAAC;aACxG,OAAO,CAAC,sBAAsB,EAAE,iBAAiB,CAAC;aAClD,OAAO,CAAC,+BAA+B,EAAE,kBAAkB,CAAC;aAC5D,OAAO,CAAC,8BAA8B,EAAE,eAAe,CAAC,CAAC;IAC9D,CAAC;CACF;AAED,IAAI,SAAS,GAAyB,IAAI,CAAC;AAE3C,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC,SAAS;QAAE,SAAS,GAAG,IAAI,aAAa,EAAE,CAAC;IAChD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,SAAS,GAAG,IAAI,CAAC;AACnB,CAAC"}

package/dist/brain/brain-garden.d.ts

@@ -0,0 +1,18 @@
+import { GardenNode } from '../types.js';
+export declare class BrainGarden {
+    private brain;
+    private forgetting;
+    private causal;
+    constructor();
+    snapshot(limit?: number): Promise<GardenNode[]>;
+    /** Compact stats used by the dashboard widget. */
+    stats(): Promise<{
+        nodes: number;
+        avgBloom: number;
+        linkedFraction: number;
+    }>;
+    private kindFromCategory;
+}
+export declare function getBrainGarden(): BrainGarden;
+export declare function resetBrainGardenForTests(): void;
+//# sourceMappingURL=brain-garden.d.ts.map

package/dist/brain/brain-garden.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-garden.d.ts","sourceRoot":"","sources":["../../src/brain/brain-garden.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,UAAU,EACX,MAAM,aAAa,CAAC;AAKrB,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,MAAM,CAAe;;IAQvB,QAAQ,CAAC,KAAK,SAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAyClD,kDAAkD;IAC5C,KAAK,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAUnF,OAAO,CAAC,gBAAgB;CAMzB;AAID,wBAAgB,cAAc,IAAI,WAAW,CAG5C;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/brain/brain-garden.js

@@ -0,0 +1,81 @@
+// src/brain/brain-garden.ts — Aesthetic brain-as-garden visualizer data source
+// v6.0.0 — Hive Mind Edition
+//
+// Returns a GardenNode[] snapshot of the brain state formatted for a D3 /
+// three.js / Canvas visualization. Memories "bloom" based on strength; links
+// become "vines" between them. Decaying memories dim. It's a living
+// constellation.
+import { getGlobalBrain } from './global-brain.js';
+import { getForgettingCurve } from './forgetting-curve.js';
+import { getCausalChains } from './causal-chains.js';
+export class BrainGarden {
+    constructor() {
+        this.brain = getGlobalBrain();
+        this.forgetting = getForgettingCurve();
+        this.causal = getCausalChains();
+    }
+    async snapshot(limit = 200) {
+        await this.brain.init();
+        await this.forgetting.init();
+        await this.causal.init();
+        const timeline = this.brain.timeline({ limit });
+        const nodes = [];
+        for (const event of timeline) {
+            const state = this.forgetting.getState(event.id);
+            const strength = state?.currentStrength ?? event.importance;
+            const ageMs = Date.now() - event.createdAt.getTime();
+            const ageDays = ageMs / (1000 * 60 * 60 * 24);
+            nodes.push({
+                id: event.id,
+                kind: this.kindFromCategory(event.category),
+                label: event.content.slice(0, 80),
+                age: +ageDays.toFixed(1),
+                strength: +strength.toFixed(3),
+                connections: [],
+                bloom: Math.max(0.1, Math.min(1, strength * (1 - Math.min(1, ageDays / 90)))),
+            });
+        }
+        // Enrich connections from causal chains (fire-and-forget — keep cheap)
+        for (const node of nodes) {
+            try {
+                const chain = await this.causal.trace(node.id, { maxDepth: 2 });
+                node.connections = chain.nodes
+                    .filter(n => n.id !== node.id)
+                    .slice(0, 6)
+                    .map(n => n.id);
+            }
+            catch {
+                node.connections = [];
+            }
+        }
+        return nodes;
+    }
+    /** Compact stats used by the dashboard widget. */
+    async stats() {
+        const nodes = await this.snapshot(150);
+        if (!nodes.length)
+            return { nodes: 0, avgBloom: 0, linkedFraction: 0 };
+        const avg = nodes.reduce((a, n) => a + n.bloom, 0) / nodes.length;
+        const linked = nodes.filter(n => n.connections.length > 0).length / nodes.length;
+        return { nodes: nodes.length, avgBloom: +avg.toFixed(3), linkedFraction: +linked.toFixed(3) };
+    }
+    // ── Internals ─────────────────────────────────────────────────────────────
+    kindFromCategory(category) {
+        const c = category.toLowerCase();
+        if (c.includes('decision') || c.includes('adr'))
+            return 'decision';
+        if (c.includes('pattern'))
+            return 'pattern';
+        return 'memory';
+    }
+}
+let _instance = null;
+export function getBrainGarden() {
+    if (!_instance)
+        _instance = new BrainGarden();
+    return _instance;
+}
+export function resetBrainGardenForTests() {
+    _instance = null;
+}
+//# sourceMappingURL=brain-garden.js.map

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

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

package/dist/brain/brain-graph-walker.d.ts

@@ -0,0 +1,54 @@
+import { GlobalBrain } from './global-brain.js';
+export type EdgeType = 'similarity' | 'causal' | 'temporal' | 'agent-handoff' | 'co-occurrence';
+export interface WalkOptions {
+    maxHops?: number;
+    maxNodes?: number;
+    scoreDecayPerHop?: number;
+    edgeTypes?: EdgeType[];
+}
+export interface WalkEdgeRef {
+    from: string;
+    type: EdgeType;
+    weight: number;
+}
+export interface WalkNode {
+    memoryId: string;
+    hopsFromSeed: number;
+    scoreFromSeed: number;
+    edgesIn: WalkEdgeRef[];
+}
+export interface WalkPath {
+    seed: string;
+    target: string;
+    hops: Array<{
+        memoryId: string;
+        edgeType: EdgeType;
+    }>;
+    totalScore: number;
+}
+export interface WalkResult {
+    seeds: string[];
+    visited: WalkNode[];
+    paths: WalkPath[];
+    durationMs: number;
+    hopHistogram: number[];
+}
+export declare class BrainGraphWalker {
+    private readonly brain;
+    private memoryCache;
+    constructor(brain?: GlobalBrain);
+    /** Walk the graph starting from seedMemoryIds. */
+    walk(seedMemoryIds: string[], opts?: WalkOptions): Promise<WalkResult>;
+    /** Embed the query, pick the top-3 ANN seeds, then walk. */
+    relevantToQuery(query: string, opts?: WalkOptions): Promise<WalkResult>;
+    private edgesFrom;
+    private similarityEdges;
+    private causalEdges;
+    private temporalEdges;
+    private handoffEdges;
+    private coOccurrenceEdges;
+    private memories;
+}
+export declare function getBrainGraphWalker(): BrainGraphWalker;
+export declare function resetBrainGraphWalkerForTests(): void;
+//# sourceMappingURL=brain-graph-walker.d.ts.map

package/dist/brain/brain-graph-walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-graph-walker.d.ts","sourceRoot":"","sources":["../../src/brain/brain-graph-walker.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAkB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,eAAe,GAAG,eAAe,CAAC;AAahG,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAC;IACtD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAiBD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,WAAW,CAAyC;gBAEhD,KAAK,CAAC,EAAE,WAAW;IAI/B,kDAAkD;IAC5C,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IA0FhF,4DAA4D;IACtD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;YAwBnE,SAAS;YAYT,eAAe;YAef,WAAW;IAwBzB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,iBAAiB;IAwBzB,OAAO,CAAC,QAAQ;CAcjB;AAiGD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAGtD;AACD,wBAAgB,6BAA6B,IAAI,IAAI,CAAsB"}