crbro-memory 1.0.0

package/README.md

@@ -0,0 +1,122 @@
+# 🧠 CRBRO — Persistent Neural Memory for AI
+
+**CRBRO** is a local MCP (Model Context Protocol) server that gives your AI assistant **persistent long-term memory** across sessions. It uses a biological neural architecture — cortex, synapses, hippocampus — to store, connect, and retrieve knowledge automatically.
+
+Part of the **[Synthetica Decks](https://synthetica-decks.web.app)** Zero Deck.
+
+## Features
+
+- **🧬 Biological Architecture** — Knowledge organized as neurons (cortex), connections (synapses), and session memory (hippocampus)
+- **🔍 Hybrid Search** — Powered by [Orama](https://orama.com/) for fast BM25 + fuzzy text search
+- **🔥 Heat Scores** — Automatic relevance tracking based on frequency, recency, and connectivity
+- **🗺️ Global Map** — Cluster detection and cross-domain bridge identification *(premium)*
+- **📦 Zero Dependencies** — Pure Node.js, no Python, no Docker, no external databases
+- **💾 File-Based** — All data stored as readable JSON files in `~/.crbro/`
+- **🔌 MCP Native** — Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client
+
+## Quick Start
+
+### 1. Initialize
+
+```bash
+npx crbro-memory init
+```
+
+### 2. Add to your MCP config
+
+**Claude Desktop** (`~/AppData/Roaming/Claude/claude_desktop_config.json`):
+```json
+{
+  "mcpServers": {
+    "crbro": {
+      "command": "npx",
+      "args": ["-y", "crbro-memory"]
+    }
+  }
+}
+```
+
+**Cursor** (`.cursor/mcp.json`):
+```json
+{
+  "mcpServers": {
+    "crbro": {
+      "command": "npx",
+      "args": ["-y", "crbro-memory"]
+    }
+  }
+}
+```
+
+### 3. Start using it
+
+Your AI will now have access to 15 memory tools. Start any session with `crbro_boot`.
+
+## Tools
+
+### Free (always available)
+
+| Tool | Description |
+|------|-------------|
+| `crbro_boot` | Boot the brain at session start — loads hot topics and context |
+| `crbro_status` | Brain status — neurons, synapses, sessions count |
+| `crbro_learn` | Store a fact, decision, pattern, or preference |
+| `crbro_neuron` | Read a specific neuron (topic) with all its knowledge |
+| `crbro_neurons` | List neurons with optional filters (domain, type, heat) |
+| `crbro_recall` | Search the brain using hybrid text search |
+| `crbro_connect` | Create or strengthen a connection between neurons |
+| `crbro_connections` | Get all connections for a neuron |
+| `crbro_session_log` | Log a session summary |
+| `crbro_sessions` | List recent sessions |
+| `crbro_context` | Read/update active working context |
+| `crbro_hot_topics` | Get the most active topics by heat score |
+| `crbro_consolidate` | End-of-session consolidation |
+
+### Premium (requires Synthetica Zero Deck license)
+
+| Tool | Description |
+|------|-------------|
+| `crbro_global_map` | View the neural network — clusters and cross-domain bridges |
+| `crbro_maintenance` | Full brain maintenance — archive, prune, rebuild |
+
+## Architecture
+
+```
+~/.crbro/
+├── manifest.json           ← Brain metadata
+├── cortex/                 ← One JSON per neuron (topic)
+│   ├── project_octochat.json
+│   └── tech_firebase.json
+├── synapses/               ← One JSON per connection
+│   └── syn_octochat__firebase.json
+├── hippocampus/            ← One JSON per session
+│   └── session_2026-05-06.json
+├── prefrontal/             ← Working memory
+│   ├── active_context.json
+│   ├── hot_topics.json
+│   └── global_map.json
+├── archives/               ← Cold neurons
+└── .search/                ← Orama search index
+    └── orama.index.json
+```
+
+## Heat Score Algorithm
+
+Each neuron has a heat score (0.0 - 1.0) calculated from:
+
+- **Frequency (35%)** — How often the neuron is accessed
+- **Recency (40%)** — When it was last accessed (today = 1.0, >3 months = 0.05)
+- **Connectivity (25%)** — How many synapses connect to it
+
+## CLI Commands
+
+```bash
+npx crbro-memory          # Start MCP server
+npx crbro-memory init     # Initialize brain
+npx crbro-memory status   # Show brain status
+npx crbro-memory --help   # Help
+```
+
+## License
+
+MIT — Part of [Synthetica Decks](https://synthetica-decks.web.app) by Octonove Agency.

package/bin/crbro.js

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+
+// ─── CRBRO CLI ───────────────────────────────────────────────────
+// Command-line interface for CRBRO memory system
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+if (command === 'init') {
+  // Initialize brain
+  import('../dist/engine/brain.js').then(async ({ Brain }) => {
+    const brain = new Brain();
+    const manifest = await brain.initialize();
+    console.log('🧠 CRBRO brain initialized!');
+    console.log(`   Path: ${manifest.brain_path}`);
+    console.log('');
+    console.log('Add CRBRO to your MCP config:');
+    console.log('');
+    console.log(JSON.stringify({
+      "mcpServers": {
+        "crbro": {
+          "command": "npx",
+          "args": ["-y", "crbro-memory"]
+        }
+      }
+    }, null, 2));
+  }).catch(console.error);
+
+} else if (command === 'status') {
+  // Show brain status
+  import('../dist/engine/brain.js').then(async ({ Brain }) => {
+    const brain = new Brain();
+    try {
+      const manifest = await brain.getManifest();
+      console.log('🧠 CRBRO Brain Status');
+      console.log(`   Version:  ${manifest.version}`);
+      console.log(`   Path:     ${manifest.brain_path}`);
+      console.log(`   Neurons:  ${manifest.total_neurons}`);
+      console.log(`   Synapses: ${manifest.total_synapses}`);
+      console.log(`   Sessions: ${manifest.total_sessions}`);
+      console.log(`   Last Boot: ${manifest.last_boot || 'never'}`);
+    } catch {
+      console.log('🧠 CRBRO brain not initialized. Run: npx crbro-memory init');
+    }
+  }).catch(console.error);
+
+} else if (command === 'activate') {
+  // Activate license key
+  const key = args[1];
+  if (!key) {
+    console.log('❌ Usage: npx crbro-memory activate SYNTH-ZERO-XXXX-XXXX-XXXX');
+    console.log('');
+    console.log('Get your license key at https://synthetica-decks.web.app');
+    process.exit(1);
+  }
+
+  import('../dist/engine/brain.js').then(async ({ Brain }) => {
+    const brain = new Brain();
+    try {
+      await brain.getManifest(); // Ensure brain exists
+    } catch {
+      console.log('🧠 Brain not initialized. Initializing now...');
+      await brain.initialize();
+    }
+
+    // Validate key format
+    if (!key.startsWith('SYNTH-ZERO-') || key.length < 20) {
+      console.log('❌ Invalid license key format.');
+      console.log('   Keys start with SYNTH-ZERO- and are at least 20 characters.');
+      process.exit(1);
+    }
+
+    // Persist key in manifest
+    await brain.updateManifest({ license_key: key });
+    console.log('✅ License key activated!');
+    console.log('');
+    console.log('   🔓 Premium features unlocked:');
+    console.log('      • crbro_global_map  — Neural cluster visualization');
+    console.log('      • crbro_maintenance — Automated brain optimization');
+    console.log('');
+    console.log('   Restart your IDE to apply changes.');
+  }).catch(console.error);
+
+} else if (command === '--help' || command === '-h') {
+  console.log('🧠 CRBRO — Persistent Neural Memory for AI');
+  console.log('');
+  console.log('Usage:');
+  console.log('  npx crbro-memory              Start MCP server (stdio)');
+  console.log('  npx crbro-memory init         Initialize brain directory');
+  console.log('  npx crbro-memory status       Show brain status');
+  console.log('  npx crbro-memory activate KEY Activate premium license');
+  console.log('  npx crbro-memory --help       Show this help');
+  console.log('');
+  console.log('Part of Synthetica Decks — https://synthetica-decks.web.app');
+
+} else {
+  // Default: start MCP server
+  import('../dist/index.js').catch(console.error);
+}

package/dist/engine/brain.d.ts

@@ -0,0 +1,43 @@
+import type { Manifest, BootResult } from '../types/index.js';
+export declare class BrainPaths {
+    readonly root: string;
+    readonly cortex: string;
+    readonly synapses: string;
+    readonly hippocampus: string;
+    readonly prefrontal: string;
+    readonly archives: string;
+    readonly search: string;
+    constructor(rootDir?: string);
+    manifest(): string;
+    neuron(id: string): string;
+    synapse(id: string): string;
+    session(id: string): string;
+    activeContext(): string;
+    hotTopics(): string;
+    globalMap(): string;
+    searchIndex(): string;
+}
+export declare class Brain {
+    private manifest;
+    readonly paths: BrainPaths;
+    constructor(rootDir?: string);
+    /**
+     * Initialize the brain directory structure.
+     * Creates all directories and a fresh manifest.
+     */
+    initialize(): Promise<Manifest>;
+    /**
+     * Boot sequence — load manifest, verify integrity, return brain state.
+     * If brain doesn't exist, initialize it first.
+     */
+    boot(): Promise<BootResult>;
+    /**
+     * Get the current manifest.
+     */
+    getManifest(): Promise<Manifest>;
+    /**
+     * Update the manifest counters.
+     */
+    updateManifest(updates: Partial<Manifest>): Promise<void>;
+}
+//# sourceMappingURL=brain.d.ts.map

package/dist/engine/brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../../src/engine/brain.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAA4B,MAAM,mBAAmB,CAAC;AAQxF,qBAAa,UAAU;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,OAAO,CAAC,EAAE,MAAM;IAU5B,QAAQ,IAAI,MAAM;IAIlB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAI1B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAI3B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAI3B,aAAa,IAAI,MAAM;IAIvB,SAAS,IAAI,MAAM;IAInB,SAAS,IAAI,MAAM;IAInB,WAAW,IAAI,MAAM;CAGtB;AAID,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAyB;IACzC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;gBAEf,OAAO,CAAC,EAAE,MAAM;IAI5B;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,QAAQ,CAAC;IAkDrC;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IA8CjC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC;IAUtC;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAMhE"}

package/dist/engine/brain.js

@@ -0,0 +1,179 @@
+"use strict";
+// ─── CRBRO Brain Manager ─────────────────────────────────────────
+// Core brain initialization, boot sequence, and path management
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Brain = exports.BrainPaths = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const node_fs_1 = require("node:fs");
+const fs_js_1 = require("../utils/fs.js");
+const CRBRO_DIR = process.env['CRBRO_PATH'] || node_path_1.default.join(process.env['HOME'] || process.env['USERPROFILE'] || '.', '.crbro');
+const MANIFEST_FILE = 'manifest.json';
+const CRBRO_VERSION = '1.0.0';
+// ─── Paths ───────────────────────────────────────────────────────
+class BrainPaths {
+    root;
+    cortex;
+    synapses;
+    hippocampus;
+    prefrontal;
+    archives;
+    search;
+    constructor(rootDir) {
+        this.root = rootDir || CRBRO_DIR;
+        this.cortex = node_path_1.default.join(this.root, 'cortex');
+        this.synapses = node_path_1.default.join(this.root, 'synapses');
+        this.hippocampus = node_path_1.default.join(this.root, 'hippocampus');
+        this.prefrontal = node_path_1.default.join(this.root, 'prefrontal');
+        this.archives = node_path_1.default.join(this.root, 'archives');
+        this.search = node_path_1.default.join(this.root, '.search');
+    }
+    manifest() {
+        return node_path_1.default.join(this.root, MANIFEST_FILE);
+    }
+    neuron(id) {
+        return node_path_1.default.join(this.cortex, `${id}.json`);
+    }
+    synapse(id) {
+        return node_path_1.default.join(this.synapses, `${id}.json`);
+    }
+    session(id) {
+        return node_path_1.default.join(this.hippocampus, `${id}.json`);
+    }
+    activeContext() {
+        return node_path_1.default.join(this.prefrontal, 'active_context.json');
+    }
+    hotTopics() {
+        return node_path_1.default.join(this.prefrontal, 'hot_topics.json');
+    }
+    globalMap() {
+        return node_path_1.default.join(this.prefrontal, 'global_map.json');
+    }
+    searchIndex() {
+        return node_path_1.default.join(this.search, 'orama.index.json');
+    }
+}
+exports.BrainPaths = BrainPaths;
+// ─── Brain Manager ───────────────────────────────────────────────
+class Brain {
+    manifest = null;
+    paths;
+    constructor(rootDir) {
+        this.paths = new BrainPaths(rootDir);
+    }
+    /**
+     * Initialize the brain directory structure.
+     * Creates all directories and a fresh manifest.
+     */
+    async initialize() {
+        // Create directories
+        const dirs = [
+            this.paths.cortex,
+            this.paths.synapses,
+            this.paths.hippocampus,
+            this.paths.prefrontal,
+            this.paths.archives,
+            this.paths.search,
+        ];
+        for (const dir of dirs) {
+            await node_fs_1.promises.mkdir(dir, { recursive: true });
+        }
+        // Create manifest
+        const manifest = {
+            version: CRBRO_VERSION,
+            created: (0, fs_js_1.now)(),
+            owner: 'user',
+            brain_path: this.paths.root,
+            total_neurons: 0,
+            total_synapses: 0,
+            total_sessions: 0,
+            last_boot: null,
+            last_consolidation: null,
+            license_key: null,
+        };
+        await (0, fs_js_1.writeJSON)(this.paths.manifest(), manifest);
+        this.manifest = manifest;
+        // Create empty prefrontal files
+        const emptyContext = {
+            last_session: '',
+            active_topics: [],
+            pending_tasks: [],
+            last_updated: (0, fs_js_1.now)(),
+        };
+        await (0, fs_js_1.writeJSON)(this.paths.activeContext(), emptyContext);
+        const emptyHotTopics = {
+            topics: [],
+            last_recalculated: (0, fs_js_1.now)(),
+        };
+        await (0, fs_js_1.writeJSON)(this.paths.hotTopics(), emptyHotTopics);
+        return manifest;
+    }
+    /**
+     * Boot sequence — load manifest, verify integrity, return brain state.
+     * If brain doesn't exist, initialize it first.
+     */
+    async boot() {
+        const exists = await (0, fs_js_1.fileExists)(this.paths.manifest());
+        if (!exists) {
+            // First boot — initialize
+            const manifest = await this.initialize();
+            return {
+                status: 'initialized',
+                total_neurons: 0,
+                total_synapses: 0,
+                total_sessions: 0,
+                hot_topics: [],
+                last_session: null,
+                active_context: null,
+                message: `CRBRO brain initialized at ${this.paths.root}. Ready for first session.`,
+            };
+        }
+        // Load manifest
+        this.manifest = await (0, fs_js_1.readJSON)(this.paths.manifest());
+        if (!this.manifest) {
+            throw new Error('CRBRO: Manifest exists but could not be read.');
+        }
+        // Load hot topics
+        const hotTopics = await (0, fs_js_1.readJSON)(this.paths.hotTopics());
+        // Load active context
+        const activeContext = await (0, fs_js_1.readJSON)(this.paths.activeContext());
+        // Update boot timestamp
+        this.manifest.last_boot = (0, fs_js_1.now)();
+        await (0, fs_js_1.writeJSON)(this.paths.manifest(), this.manifest);
+        return {
+            status: 'ok',
+            total_neurons: this.manifest.total_neurons,
+            total_synapses: this.manifest.total_synapses,
+            total_sessions: this.manifest.total_sessions,
+            hot_topics: hotTopics?.topics || [],
+            last_session: activeContext?.last_session || null,
+            active_context: activeContext,
+            message: `CRBRO boot complete. ${this.manifest.total_neurons} neurons, ${this.manifest.total_synapses} synapses, ${this.manifest.total_sessions} sessions.`,
+        };
+    }
+    /**
+     * Get the current manifest.
+     */
+    async getManifest() {
+        if (!this.manifest) {
+            this.manifest = await (0, fs_js_1.readJSON)(this.paths.manifest());
+            if (!this.manifest) {
+                throw new Error('CRBRO: Brain not initialized. Call boot() first.');
+            }
+        }
+        return this.manifest;
+    }
+    /**
+     * Update the manifest counters.
+     */
+    async updateManifest(updates) {
+        const manifest = await this.getManifest();
+        Object.assign(manifest, updates);
+        await (0, fs_js_1.writeJSON)(this.paths.manifest(), manifest);
+        this.manifest = manifest;
+    }
+}
+exports.Brain = Brain;
+//# sourceMappingURL=brain.js.map

package/dist/engine/brain.js.map

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

package/dist/engine/cortex.d.ts

@@ -0,0 +1,70 @@
+import type { Brain } from './brain.js';
+import type { Neuron, NeuronType } from '../types/index.js';
+export declare class Cortex {
+    private brain;
+    constructor(brain: Brain);
+    /**
+     * Get a neuron by ID.
+     */
+    get(id: string): Promise<Neuron | null>;
+    /**
+     * Get a neuron by ID without updating access stats.
+     */
+    peek(id: string): Promise<Neuron | null>;
+    /**
+     * Find a neuron by name (fuzzy match against existing neurons).
+     * Returns the best match or null.
+     */
+    findByName(name: string): Promise<Neuron | null>;
+    /**
+     * Create a new neuron.
+     */
+    create(name: string, type: NeuronType, domain: string, summary?: string): Promise<Neuron>;
+    /**
+     * Learn — add a fact, decision, or pattern to a neuron.
+     * If the neuron doesn't exist, creates it first.
+     */
+    learn(topic: string, type: 'fact' | 'decision' | 'pattern' | 'preference', content: string, options?: {
+        confidence?: number;
+        domain?: string;
+        rationale?: string;
+        neuronType?: NeuronType;
+    }): Promise<{
+        neuron: Neuron;
+        action: 'created' | 'updated';
+    }>;
+    /**
+     * List all neurons with optional filters.
+     */
+    list(options?: {
+        domain?: string;
+        type?: NeuronType;
+        min_heat?: number;
+        limit?: number;
+    }): Promise<Array<{
+        id: string;
+        name: string;
+        domain: string;
+        type: NeuronType;
+        heat: number;
+        last_accessed: string;
+        facts_count: number;
+    }>>;
+    /**
+     * Update a neuron's summary.
+     */
+    updateSummary(id: string, summary: string): Promise<Neuron | null>;
+    /**
+     * Add tags to a neuron.
+     */
+    addTags(id: string, tags: string[]): Promise<Neuron | null>;
+    /**
+     * Get all neuron IDs.
+     */
+    allIds(): Promise<string[]>;
+    /**
+     * Count total neurons.
+     */
+    count(): Promise<number>;
+}
+//# sourceMappingURL=cortex.d.ts.map

package/dist/engine/cortex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cortex.d.ts","sourceRoot":"","sources":["../../src/engine/cortex.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAkB,MAAM,mBAAmB,CAAC;AAE5E,qBAAa,MAAM;IACL,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,KAAK;IAEhC;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW7C;;OAEG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI9C;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqBtD;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA8B/F;;;OAGG;IACG,KAAK,CACT,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,EACpD,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,UAAU,CAAC;KACzB,GACA,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAA;KAAE,CAAC;IAmE7D;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,UAAU,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,KAAK,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,UAAU,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IAwCH;;OAEG;IACG,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAUxE;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAajE;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIjC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;CAI/B"}