@theihtisham/agent-shadow-brain 5.2.0 → 6.0.2

package/dist/brain/subagent-bridge.js

@@ -0,0 +1,364 @@
+// src/brain/subagent-bridge.ts — Sub-Agent Brain Bridge (SABB)
+// v6.0.0 — Hive Mind Edition
+//
+// When a parent agent (Claude Code Task, Cursor Composer, CrewAI, LangGraph, AutoGen)
+// spawns a sub-agent, SABB:
+//   1. Detects the spawn (via MCP handshake or CLI call)
+//   2. Computes a context sliver — the 3–5% of the global brain relevant to THIS task
+//   3. Formats it for injection into the sub-agent's spawn prompt
+//   4. Quarantines new memories from the sub-agent until confidence ≥ 0.7
+//   5. Graduates verified memories back into the global brain
+//
+// No other AI tool syncs memory to sub-agents. Every sub-agent framework today
+// (Claude Task tool, CrewAI, LangGraph, AutoGen) starts sub-agents with zero
+// shared memory. SABB is the first cross-framework brain bridge.
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as crypto from 'crypto';
+import { GlobalBrain, getGlobalBrain } from './global-brain.js';
+const SABB_DIR = path.join(os.homedir(), '.shadow-brain', 'sabb');
+const QUARANTINE_PATH = path.join(SABB_DIR, 'quarantine.json');
+const SPAWN_LOG_PATH = path.join(SABB_DIR, 'spawns.jsonl');
+const DEFAULT_SLIVER_TOKEN_BUDGET = 300;
+const DEFAULT_GRADUATION_THRESHOLD = 0.7;
+function emptyStats() {
+    return {
+        totalSpawns: 0,
+        totalSlivers: 0,
+        quarantined: 0,
+        graduated: 0,
+        rejected: 0,
+        avgSliverTokens: 0,
+        avgGraduationMs: 0,
+        byFramework: {
+            'claude-code-task': 0,
+            'cursor-composer': 0,
+            'cline-substep': 0,
+            'crewai': 0,
+            'langgraph': 0,
+            'autogen': 0,
+            'generic': 0,
+        },
+        byParent: {},
+    };
+}
+export class SubAgentBridge {
+    constructor(brain, opts = {}) {
+        this.quarantine = new Map();
+        this.stats = emptyStats();
+        this.initialized = false;
+        this.brain = brain ?? getGlobalBrain();
+        this.graduationThreshold = opts.graduationThreshold ?? DEFAULT_GRADUATION_THRESHOLD;
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        fs.mkdirSync(SABB_DIR, { recursive: true });
+        await this.brain.init();
+        if (fs.existsSync(QUARANTINE_PATH)) {
+            try {
+                const raw = fs.readFileSync(QUARANTINE_PATH, 'utf-8');
+                const parsed = JSON.parse(raw);
+                if (Array.isArray(parsed.quarantine)) {
+                    for (const q of parsed.quarantine) {
+                        this.quarantine.set(q.id, {
+                            ...q,
+                            createdAt: new Date(q.createdAt),
+                            graduatedAt: q.graduatedAt ? new Date(q.graduatedAt) : null,
+                        });
+                    }
+                }
+                if (parsed.stats)
+                    this.stats = { ...emptyStats(), ...parsed.stats };
+            }
+            catch {
+                // Corrupt file — start fresh
+            }
+        }
+        this.initialized = true;
+    }
+    /** Register a sub-agent spawn. Returns a spawn ID used for later memory quarantine. */
+    async registerSpawn(req) {
+        await this.init();
+        const spawn = {
+            ...req,
+            spawnTime: req.spawnTime ?? new Date(),
+        };
+        this.stats.totalSpawns++;
+        this.stats.byFramework[spawn.framework]++;
+        this.stats.byParent[spawn.parentAgent] = (this.stats.byParent[spawn.parentAgent] ?? 0) + 1;
+        // Append to spawn log
+        try {
+            fs.appendFileSync(SPAWN_LOG_PATH, JSON.stringify(spawn) + '\n');
+        }
+        catch {
+            // Log failures are non-fatal
+        }
+        await this.flush();
+        return spawn;
+    }
+    /**
+     * Compute a context sliver for a sub-agent. Returns a concise, task-focused
+     * briefing (default budget: 300 tokens) extracted from the global brain.
+     */
+    async computeSliver(req, opts = {}) {
+        await this.init();
+        const budget = opts.tokenBudget ?? req.tokenBudget ?? DEFAULT_SLIVER_TOKEN_BUDGET;
+        const projectId = GlobalBrain.projectIdFor(req.projectDir);
+        const taskTerms = this.extractKeyTerms(req.taskDescription);
+        // Pull recent project memories + keyword-match anything with high importance
+        const candidates = this.brain.recall({
+            projectId,
+            keywords: taskTerms,
+            limit: 40,
+            minImportance: 0.4,
+        });
+        const scored = candidates
+            .map(entry => ({
+            entry,
+            score: this.scoreRelevance(entry, taskTerms, req.taskDescription),
+        }))
+            .filter(x => x.score > 0)
+            .sort((a, b) => b.score - a.score);
+        const selected = [];
+        let tokenCount = 0;
+        for (const { entry, score } of scored) {
+            const tokens = this.estimateTokens(entry.content);
+            if (tokenCount + tokens > budget)
+                continue;
+            selected.push({
+                id: entry.id,
+                content: entry.content,
+                category: entry.category,
+                relevance: Math.min(1, score / 10),
+            });
+            tokenCount += tokens;
+            if (selected.length >= 12)
+                break;
+        }
+        const warnings = this.extractWarnings(candidates);
+        const markdown = this.formatSliverMarkdown(req, selected, warnings);
+        this.stats.totalSlivers++;
+        this.stats.avgSliverTokens = this.rollingAvg(this.stats.avgSliverTokens, tokenCount, this.stats.totalSlivers);
+        return {
+            subAgentId: req.subAgentId,
+            parentAgent: req.parentAgent,
+            taskDescription: req.taskDescription,
+            memories: selected,
+            warnings,
+            tokenCount,
+            markdown,
+            generatedAt: new Date(),
+        };
+    }
+    /** Store a memory from a sub-agent in quarantine. */
+    async quarantineMemory(subAgentId, parentAgent, content, category, confidence, evidence = []) {
+        await this.init();
+        const entry = {
+            id: `quar-${crypto.randomBytes(6).toString('hex')}`,
+            subAgentId,
+            parentAgent,
+            content,
+            category,
+            confidence,
+            graduatedAt: null,
+            verdict: 'pending',
+            evidence,
+            createdAt: new Date(),
+        };
+        this.quarantine.set(entry.id, entry);
+        this.stats.quarantined++;
+        await this.flush();
+        // Auto-graduate if confidence already passes threshold
+        if (confidence >= this.graduationThreshold) {
+            await this.graduate(entry.id);
+        }
+        return entry;
+    }
+    /** Graduate a quarantined memory into the global brain. */
+    async graduate(memoryId, overrides = {}) {
+        await this.init();
+        const entry = this.quarantine.get(memoryId);
+        if (!entry)
+            return false;
+        if (entry.verdict !== 'pending')
+            return false;
+        const start = Date.now();
+        const projectMatch = await this.findProjectForSubAgent(entry.subAgentId);
+        this.brain.writeSync({
+            projectId: projectMatch?.projectId ?? 'unknown-project',
+            projectName: projectMatch?.projectName ?? 'unknown',
+            agentTool: overrides.agentTool ?? entry.parentAgent,
+            category: entry.category,
+            content: entry.content,
+            importance: Math.min(1, entry.confidence),
+            metadata: {
+                ...(overrides.metadata ?? {}),
+                origin: 'subagent',
+                subAgentId: entry.subAgentId,
+                parentAgent: entry.parentAgent,
+                quarantineId: entry.id,
+            },
+        });
+        entry.verdict = 'graduated';
+        entry.graduatedAt = new Date();
+        this.stats.graduated++;
+        this.stats.quarantined = Math.max(0, this.stats.quarantined - 1);
+        this.stats.avgGraduationMs = this.rollingAvg(this.stats.avgGraduationMs, Date.now() - start, this.stats.graduated);
+        await this.flush();
+        return true;
+    }
+    /** Reject a quarantined memory (hallucination, low confidence). */
+    async reject(memoryId, reason = 'rejected') {
+        await this.init();
+        const entry = this.quarantine.get(memoryId);
+        if (!entry)
+            return false;
+        entry.verdict = 'rejected';
+        entry.evidence = [...entry.evidence, reason];
+        this.stats.rejected++;
+        this.stats.quarantined = Math.max(0, this.stats.quarantined - 1);
+        await this.flush();
+        return true;
+    }
+    /** List pending quarantined memories. */
+    listQuarantine(subAgentId) {
+        return Array.from(this.quarantine.values())
+            .filter(q => q.verdict === 'pending' && (!subAgentId || q.subAgentId === subAgentId))
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    }
+    getStats() {
+        return JSON.parse(JSON.stringify(this.stats));
+    }
+    /** Parse a spawn log into an array of SubAgentSpawnRequest. Useful for auditing. */
+    readSpawnLog(limit = 50) {
+        if (!fs.existsSync(SPAWN_LOG_PATH))
+            return [];
+        try {
+            const raw = fs.readFileSync(SPAWN_LOG_PATH, 'utf-8');
+            return raw
+                .split('\n')
+                .filter(Boolean)
+                .slice(-limit)
+                .map(line => {
+                const parsed = JSON.parse(line);
+                return { ...parsed, spawnTime: new Date(parsed.spawnTime) };
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+    // ── Internals ─────────────────────────────────────────────────────────────
+    extractKeyTerms(task) {
+        const stopwords = new Set(['the', 'a', 'an', 'and', 'or', 'of', 'to', 'for', 'in', 'on', 'is', 'it', 'this', 'that', 'with', 'as', 'from', 'by', 'be', 'do', 'can', 'will', 'should', 'would', 'could', 'i', 'you', 'we', 'they', 'my', 'your']);
+        return task
+            .toLowerCase()
+            .replace(/[^a-z0-9\s-]/g, ' ')
+            .split(/\s+/)
+            .filter(w => w.length > 2 && !stopwords.has(w))
+            .slice(0, 12);
+    }
+    scoreRelevance(entry, terms, task) {
+        let score = 0;
+        const content = entry.content.toLowerCase();
+        for (const term of terms) {
+            if (content.includes(term))
+                score += 2;
+        }
+        // Recency boost: newer entries up-ranked slightly
+        const ageDays = (Date.now() - new Date(entry.createdAt).getTime()) / (1000 * 60 * 60 * 24);
+        score += Math.max(0, 2 - ageDays / 30);
+        // Importance
+        score += entry.importance * 3;
+        // Category match boost
+        const taskLower = task.toLowerCase();
+        if (taskLower.includes(entry.category.toLowerCase()))
+            score += 2;
+        return score;
+    }
+    extractWarnings(entries) {
+        const warningCategories = new Set(['warning', 'pitfall', 'security', 'bug', 'incident', 'failure']);
+        const warnings = [];
+        for (const e of entries) {
+            if (warningCategories.has(e.category.toLowerCase())) {
+                warnings.push(`[${e.category}] ${e.content.slice(0, 140)}`);
+            }
+            if (warnings.length >= 5)
+                break;
+        }
+        return warnings;
+    }
+    estimateTokens(text) {
+        // Rough tokens-per-char heuristic for English: ~4 chars per token
+        return Math.ceil(text.length / 4);
+    }
+    formatSliverMarkdown(req, memories, warnings) {
+        const lines = [
+            `## Shadow Brain Context Sliver`,
+            ``,
+            `**Parent:** ${req.parentAgent} · **Framework:** ${req.framework}`,
+            `**Task:** ${req.taskDescription}`,
+            ``,
+            `### What you should know before starting`,
+        ];
+        if (memories.length === 0) {
+            lines.push('_No relevant project memories found. Proceed with general best practices._');
+        }
+        else {
+            for (const m of memories) {
+                lines.push(`- **[${m.category}]** ${m.content.slice(0, 220)}${m.content.length > 220 ? '…' : ''}`);
+            }
+        }
+        if (warnings.length) {
+            lines.push('', `### Warnings from past work`);
+            for (const w of warnings)
+                lines.push(`- ${w}`);
+        }
+        lines.push('', `### Rules for this sub-agent`, '- Use project-specific memory over generic assumptions.', '- Any new learning will be quarantined until confidence ≥ 0.7.', '- Do not access secrets or run destructive commands without explicit approval.', '');
+        return lines.join('\n');
+    }
+    async findProjectForSubAgent(_subAgentId) {
+        // Derive project from most recent spawn record for this sub-agent
+        const spawns = this.readSpawnLog(200).reverse();
+        const match = spawns.find(s => s.subAgentId === _subAgentId);
+        if (!match)
+            return null;
+        return {
+            projectId: GlobalBrain.projectIdFor(match.projectDir),
+            projectName: path.basename(match.projectDir),
+        };
+    }
+    rollingAvg(currentAvg, newValue, count) {
+        if (count <= 1)
+            return newValue;
+        return currentAvg + (newValue - currentAvg) / count;
+    }
+    async flush() {
+        try {
+            const payload = {
+                schemaVersion: 1,
+                quarantine: Array.from(this.quarantine.values()),
+                stats: this.stats,
+            };
+            const tmp = QUARANTINE_PATH + '.tmp';
+            fs.writeFileSync(tmp, JSON.stringify(payload, null, 2));
+            fs.renameSync(tmp, QUARANTINE_PATH);
+        }
+        catch {
+            // Persistence failures are non-fatal in v6.0; quarantine lives in-memory
+        }
+    }
+}
+// Singleton helper — consistent with other v5.2 brain modules
+let _instance = null;
+export function getSubAgentBridge() {
+    if (!_instance)
+        _instance = new SubAgentBridge();
+    return _instance;
+}
+export function resetSubAgentBridgeForTests() {
+    _instance = null;
+}
+//# sourceMappingURL=subagent-bridge.js.map

package/dist/brain/subagent-bridge.js.map

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

package/dist/brain/swarm-debate.d.ts

@@ -0,0 +1,22 @@
+import { DebateTranscript } from '../types.js';
+export declare class SwarmDebate {
+    private llm;
+    private debates;
+    private initialized;
+    constructor();
+    init(): Promise<void>;
+    /** Run a debate. Returns a transcript with verdict. */
+    debate(question: string, context: string, opts?: {
+        turns?: number;
+        proLabel?: string;
+        conLabel?: string;
+    }): Promise<DebateTranscript>;
+    listDebates(limit?: number): DebateTranscript[];
+    private generateTurn;
+    private generateArbiter;
+    private fallbackStatement;
+    private persist;
+}
+export declare function getSwarmDebate(): SwarmDebate;
+export declare function resetSwarmDebateForTests(): void;
+//# sourceMappingURL=swarm-debate.d.ts.map

package/dist/brain/swarm-debate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-debate.d.ts","sourceRoot":"","sources":["../../src/brain/swarm-debate.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,gBAAgB,EAAc,MAAM,aAAa,CAAC;AAU3D,qBAAa,WAAW;IACtB,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,OAAO,CAA4C;IAC3D,OAAO,CAAC,WAAW,CAAS;;IAMtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,uDAAuD;IACjD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsC/I,WAAW,CAAC,KAAK,SAAK,GAAG,gBAAgB,EAAE;YAQ7B,YAAY;YAeZ,eAAe;IAgB7B,OAAO,CAAC,iBAAiB;YAMX,OAAO;CAUtB;AAID,wBAAgB,cAAc,IAAI,WAAW,CAG5C;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/brain/swarm-debate.js

@@ -0,0 +1,134 @@
+// src/brain/swarm-debate.ts — Swarm Debate Protocol
+// v6.0.0 — Hive Mind Edition
+//
+// For critical decisions, spawn 2–N sub-agents that DEBATE a question.
+// An arbiter agent reads the transcript and picks a winner with reasoning.
+// Uses Local LLM (Ollama) by default; remote providers opt-in.
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as crypto from 'crypto';
+import { getLocalLLM } from './local-llm.js';
+const DEBATE_PATH = path.join(os.homedir(), '.shadow-brain', 'debates.json');
+export class SwarmDebate {
+    constructor() {
+        this.debates = new Map();
+        this.initialized = false;
+        this.llm = getLocalLLM();
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        fs.mkdirSync(path.dirname(DEBATE_PATH), { recursive: true });
+        if (fs.existsSync(DEBATE_PATH)) {
+            try {
+                const parsed = JSON.parse(fs.readFileSync(DEBATE_PATH, 'utf-8'));
+                for (const d of parsed.debates ?? []) {
+                    this.debates.set(d.id, {
+                        ...d,
+                        createdAt: new Date(d.createdAt),
+                        turns: d.turns.map(t => ({ ...t, timestamp: new Date(t.timestamp) })),
+                    });
+                }
+            }
+            catch {
+                /* skip */
+            }
+        }
+        this.initialized = true;
+    }
+    /** Run a debate. Returns a transcript with verdict. */
+    async debate(question, context, opts = {}) {
+        await this.init();
+        const turnCount = opts.turns ?? 2;
+        const proLabel = opts.proLabel ?? 'pro';
+        const conLabel = opts.conLabel ?? 'con';
+        const start = Date.now();
+        const turns = [];
+        let turnId = 1;
+        // Alternate pro/con turns
+        for (let i = 0; i < turnCount; i++) {
+            const proTurn = await this.generateTurn(turnId++, proLabel, 'pro', question, context, turns);
+            turns.push(proTurn);
+            const conTurn = await this.generateTurn(turnId++, conLabel, 'con', question, context, turns);
+            turns.push(conTurn);
+        }
+        // Arbiter
+        const arbiter = await this.generateArbiter(turnId, question, context, turns);
+        turns.push(arbiter);
+        const transcript = {
+            id: `deb-${crypto.randomBytes(6).toString('hex')}`,
+            question,
+            context,
+            turns,
+            verdict: arbiter.statement,
+            arbiterConfidence: arbiter.confidence,
+            durationMs: Date.now() - start,
+            createdAt: new Date(),
+        };
+        this.debates.set(transcript.id, transcript);
+        await this.persist();
+        return transcript;
+    }
+    listDebates(limit = 20) {
+        return Array.from(this.debates.values())
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime())
+            .slice(0, limit);
+    }
+    // ── Internals ─────────────────────────────────────────────────────────────
+    async generateTurn(turnId, agentLabel, position, question, context, prior) {
+        const transcript = prior.map(t => `${t.agentLabel} (${t.position}): ${t.statement}`).join('\n');
+        const prompt = `Question: ${question}\nContext: ${context}\n\nPrior turns:\n${transcript || '(no prior turns)'}\n\nYou are arguing ${position}. Respond in 2 short sentences max.`;
+        const res = await this.llm.generate(prompt, `You are a terse debater taking the ${position} position.`);
+        const statement = res.text.trim() || this.fallbackStatement(position, question);
+        return {
+            turnId,
+            agentLabel,
+            position,
+            statement: statement.slice(0, 340),
+            confidence: res.provider === 'none' ? 0.5 : 0.7,
+            timestamp: new Date(),
+        };
+    }
+    async generateArbiter(turnId, question, context, turns) {
+        const transcript = turns.map(t => `${t.agentLabel} (${t.position}): ${t.statement}`).join('\n');
+        const prompt = `You are an arbiter reading this debate. Pick the stronger side and give a one-sentence verdict.\n\nQuestion: ${question}\nContext: ${context}\n\nTranscript:\n${transcript}\n\nReply: "Winner: <pro|con>. Reason: <one sentence>."`;
+        const res = await this.llm.generate(prompt, 'You are a fair, terse arbiter.');
+        const text = res.text.trim() || 'Winner: pro. Reason: no clear evidence presented by con side.';
+        const confidence = res.provider === 'none' ? 0.5 : 0.75;
+        return {
+            turnId,
+            agentLabel: 'arbiter',
+            position: 'arbiter',
+            statement: text.slice(0, 340),
+            confidence,
+            timestamp: new Date(),
+        };
+    }
+    fallbackStatement(position, question) {
+        return position === 'pro'
+            ? `Proceeding with the proposal for "${question.slice(0, 60)}" is the safer default given existing conventions.`
+            : `There is no evidence base for "${question.slice(0, 60)}" — defaulting to the status quo is safer.`;
+    }
+    async persist() {
+        try {
+            const payload = { schemaVersion: 1, debates: Array.from(this.debates.values()) };
+            const tmp = DEBATE_PATH + '.tmp';
+            fs.writeFileSync(tmp, JSON.stringify(payload, null, 2));
+            fs.renameSync(tmp, DEBATE_PATH);
+        }
+        catch {
+            /* non-fatal */
+        }
+    }
+}
+let _instance = null;
+export function getSwarmDebate() {
+    if (!_instance)
+        _instance = new SwarmDebate();
+    return _instance;
+}
+export function resetSwarmDebateForTests() {
+    _instance = null;
+}
+//# sourceMappingURL=swarm-debate.js.map

package/dist/brain/swarm-debate.js.map

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

package/dist/brain/team-brain-sync.d.ts

@@ -0,0 +1,22 @@
+import { TeamPeerInfo, TeamSyncMessage, AgentTool } from '../types.js';
+export declare class TeamBrainSync {
+    private peerId;
+    private displayName;
+    private peers;
+    private outbox;
+    private initialized;
+    constructor();
+    init(): Promise<void>;
+    setDisplayName(name: string): void;
+    selfInfo(): TeamPeerInfo;
+    registerPeer(peer: Omit<TeamPeerInfo, 'connectedAt' | 'lastSeenAt'>): Promise<TeamPeerInfo>;
+    heartbeat(peerId: string, agentTools?: AgentTool[]): Promise<boolean>;
+    enqueue(message: Omit<TeamSyncMessage, 'timestamp'>): Promise<TeamSyncMessage>;
+    drainOutbox(): TeamSyncMessage[];
+    listPeers(): TeamPeerInfo[];
+    getPeerId(): string;
+    private persist;
+}
+export declare function getTeamBrainSync(): TeamBrainSync;
+export declare function resetTeamBrainSyncForTests(): void;
+//# sourceMappingURL=team-brain-sync.d.ts.map

package/dist/brain/team-brain-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-brain-sync.d.ts","sourceRoot":"","sources":["../../src/brain/team-brain-sync.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,YAAY,EACZ,eAAe,EACf,SAAS,EACV,MAAM,aAAa,CAAC;AAYrB,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,WAAW,CAAS;;IAOtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIlC,QAAQ,IAAI,YAAY;IAWlB,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,GAAG,YAAY,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAY3F,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAUrE,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IASpF,WAAW,IAAI,eAAe,EAAE;IAOhC,SAAS,IAAI,YAAY,EAAE;IAI3B,SAAS,IAAI,MAAM;YAIL,OAAO;CAgBtB;AAID,wBAAgB,gBAAgB,IAAI,aAAa,CAGhD;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD"}