brainlayer 1.0.0__py3-none-any.whl

brainlayer-1.0.0.dist-info/METADATA

@@ -0,0 +1,313 @@
+Metadata-Version: 2.4
+Name: brainlayer
+Version: 1.0.0
+Summary: Persistent memory for AI agents — search, think, recall across every conversation
+Project-URL: Homepage, https://github.com/EtanHey/brainlayer
+Project-URL: Repository, https://github.com/EtanHey/brainlayer
+Project-URL: Documentation, https://etanhey.github.io/brainlayer
+Project-URL: Issues, https://github.com/EtanHey/brainlayer/issues
+Author: BrainLayer Contributors
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: ai,claude,embeddings,knowledge-graph,mcp,memory,sqlite-vec
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.11
+Requires-Dist: apsw>=3.45.0
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: numpy<3.0,>=1.22
+Requires-Dist: orjson>=3.9.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: scikit-learn>=1.0.0
+Requires-Dist: sentence-transformers>=2.2.0
+Requires-Dist: spacy<4.0,>=3.7
+Requires-Dist: sqlite-vec>=0.1.3
+Requires-Dist: tree-sitter>=0.21.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: uvicorn>=0.20.0
+Provides-Extra: ast
+Requires-Dist: tree-sitter-languages>=1.9.0; extra == 'ast'
+Provides-Extra: brain
+Requires-Dist: igraph>=0.11.0; extra == 'brain'
+Requires-Dist: leidenalg>=0.10.0; extra == 'brain'
+Requires-Dist: umap-learn>=0.5.0; extra == 'brain'
+Provides-Extra: cloud
+Requires-Dist: google-genai>=1.0.0; extra == 'cloud'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.5.0; extra == 'docs'
+Provides-Extra: youtube
+Requires-Dist: certifi; extra == 'youtube'
+Requires-Dist: youtube-transcript-api>=1.2.4; extra == 'youtube'
+Requires-Dist: yt-dlp>=2024.1.0; extra == 'youtube'
+Description-Content-Type: text/markdown
+
+# BrainLayer
+
+> Persistent memory for AI agents. Search, think, recall — across every conversation you've ever had.
+
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
+[![MCP](https://img.shields.io/badge/MCP-14%20tools-green.svg)](https://modelcontextprotocol.io)
+[![Tests](https://img.shields.io/badge/tests-266%20passing-brightgreen.svg)](#testing)
+[![Docs](https://img.shields.io/badge/docs-etanhey.github.io%2Fbrainlayer-blue.svg)](https://etanhey.github.io/brainlayer)
+
+---
+
+**Your AI agent forgets everything between sessions.** Every architecture decision, every debugging session, every preference you've expressed — gone. You repeat yourself constantly.
+
+BrainLayer fixes this. It's a **local-first memory layer** that gives any MCP-compatible AI agent the ability to remember, think, and recall across conversations.
+
+```
+"What approach did I use for auth last month?"     →  brainlayer_think
+"Show me everything about this file's history"     →  brainlayer_recall
+"What was I working on yesterday?"                 →  brainlayer_current_context
+"Remember this decision for later"                 →  brainlayer_store
+```
+
+## Quick Start
+
+```bash
+pip install brainlayer
+brainlayer init              # Interactive setup wizard
+brainlayer index             # Index your Claude Code conversations
+```
+
+Then add to your editor's MCP config:
+
+**Claude Code** (`~/.claude.json`):
+```json
+{
+  "mcpServers": {
+    "brainlayer": {
+      "command": "brainlayer-mcp"
+    }
+  }
+}
+```
+
+<details>
+<summary>Other editors (Cursor, Zed, VS Code)</summary>
+
+**Cursor** (MCP settings):
+```json
+{
+  "mcpServers": {
+    "brainlayer": {
+      "command": "brainlayer-mcp"
+    }
+  }
+}
+```
+
+**Zed** (`settings.json`):
+```json
+{
+  "context_servers": {
+    "brainlayer": {
+      "command": { "path": "brainlayer-mcp" }
+    }
+  }
+}
+```
+
+**VS Code** (`.vscode/mcp.json`):
+```json
+{
+  "servers": {
+    "brainlayer": {
+      "command": "brainlayer-mcp"
+    }
+  }
+}
+```
+
+</details>
+
+That's it. Your agent now has persistent memory across every conversation.
+
+## Architecture
+
+```mermaid
+graph LR
+    A["Claude Code / Cursor / Zed"] -->|MCP| B["BrainLayer MCP Server<br/>14 tools"]
+    B --> C["Hybrid Search<br/>semantic + keyword (RRF)"]
+    C --> D["SQLite + sqlite-vec<br/>single .db file"]
+
+    E["Claude Code JSONL<br/>conversations"] --> F["Pipeline"]
+    F -->|extract → classify → chunk → embed| D
+    G["Local LLM<br/>Ollama / MLX"] -->|enrich| D
+```
+
+**Everything runs locally.** No cloud accounts, no API keys, no Docker, no database servers.
+
+| Component | Implementation |
+|-----------|---------------|
+| Storage | SQLite + [sqlite-vec](https://github.com/asg017/sqlite-vec) (single `.db` file, WAL mode) |
+| Embeddings | `bge-large-en-v1.5` via sentence-transformers (1024 dims, runs on CPU/MPS) |
+| Search | Hybrid: vector similarity + FTS5 keyword, merged with Reciprocal Rank Fusion |
+| Enrichment | Local LLM via Ollama or MLX — 10-field metadata per chunk |
+| MCP Server | stdio-based, MCP SDK v1.26+, compatible with any MCP client |
+| Clustering | HDBSCAN + UMAP for brain graph visualization (optional) |
+
+## MCP Tools (14)
+
+### Intelligence Layer
+
+| Tool | Description |
+|------|-------------|
+| `brainlayer_think` | Given your current task context, retrieves relevant decisions, patterns, and bugs. Groups by intent. |
+| `brainlayer_recall` | File-based or topic-based recall. "What happened with this file?" or "What do I know about deployment?" |
+| `brainlayer_current_context` | Lightweight — recent projects, branches, files, and active plan. No embedding needed. |
+| `brainlayer_sessions` | Browse recent sessions by project and date range. |
+| `brainlayer_session_summary` | Session-level analysis: decisions made, corrections, learnings, quality scores. |
+| `brainlayer_store` | Persist a memory (idea, decision, learning, mistake, etc.) for future retrieval. |
+
+### Search & Context
+
+| Tool | Description |
+|------|-------------|
+| `brainlayer_search` | Hybrid semantic + keyword search with filters (project, type, source, tag, intent, importance, date range). |
+| `brainlayer_context` | Surrounding conversation chunks for a search result. |
+| `brainlayer_file_timeline` | Full interaction history of a file across all sessions. |
+| `brainlayer_operations` | Logical operation groups — read/edit/test cycles within a session. |
+| `brainlayer_regression` | What changed since a file last worked? Diff-based regression analysis. |
+| `brainlayer_plan_links` | Connect sessions to implementation plans and phases. |
+| `brainlayer_stats` | Knowledge base statistics (chunks, projects, content types). |
+| `brainlayer_list_projects` | List all indexed projects. |
+
+## Enrichment
+
+BrainLayer enriches each chunk with 10 structured metadata fields using a local LLM:
+
+| Field | Example |
+|-------|---------|
+| `summary` | "Debugging Telegram bot message drops under load" |
+| `tags` | "telegram, debugging, performance" |
+| `importance` | 8 (architectural decision) vs 2 (directory listing) |
+| `intent` | `debugging`, `designing`, `implementing`, `configuring`, `deciding`, `reviewing` |
+| `primary_symbols` | "TelegramBot, handleMessage, grammy" |
+| `resolved_query` | "How does the Telegram bot handle rate limiting?" |
+| `epistemic_level` | `hypothesis`, `substantiated`, `validated` |
+| `version_scope` | "grammy 1.32, Node 22" |
+| `debt_impact` | `introduction`, `resolution`, `none` |
+| `external_deps` | "grammy, Supabase, Railway" |
+
+Two local LLM backends:
+
+| Backend | Best for | Speed |
+|---------|----------|-------|
+| **MLX** (Apple Silicon) | M1/M2/M3 Macs | 21-87% faster than Ollama |
+| **Ollama** | Any platform | ~1s/chunk (short), ~13s (long) |
+
+```bash
+brainlayer enrich                              # Default backend (auto-detects)
+BRAINLAYER_ENRICH_BACKEND=mlx brainlayer enrich --batch-size=100
+```
+
+## Why BrainLayer?
+
+| | BrainLayer | Mem0 | Zep/Graphiti | Letta | LangChain Memory |
+|---|:---:|:---:|:---:|:---:|:---:|
+| **MCP native** | 14 tools | 1 server | 1 server | No | No |
+| **Think / Recall** | Yes | No | No | No | No |
+| **Local-first** | SQLite | Cloud-first | Cloud-only | Docker+PG | Framework |
+| **Zero infra** | `pip install` | API key | API key | Docker | Multiple deps |
+| **Multi-source** | 6 sources | API only | API only | API only | API only |
+| **Enrichment** | 10 fields | Basic | Temporal | Self-write | None |
+| **Session analysis** | Yes | No | No | No | No |
+| **Open source** | Apache 2.0 | Apache 2.0 | Source-available | Apache 2.0 | MIT |
+
+BrainLayer is the only memory layer that:
+1. **Thinks before answering** — categorizes past knowledge by intent (decisions, bugs, patterns) instead of raw search results
+2. **Runs on a single file** — no database servers, no Docker, no cloud accounts
+3. **Works with every MCP client** — 14 tools, instant integration, zero SDK
+
+## CLI Reference
+
+```bash
+brainlayer init               # Interactive setup wizard
+brainlayer index              # Index new conversations
+brainlayer search "query"     # Semantic + keyword search
+brainlayer enrich             # Run LLM enrichment on new chunks
+brainlayer enrich-sessions    # Session-level analysis (decisions, learnings)
+brainlayer stats              # Database statistics
+brainlayer brain-export       # Generate brain graph JSON
+brainlayer export-obsidian    # Export to Obsidian vault
+brainlayer dashboard          # Interactive TUI dashboard
+```
+
+## Configuration
+
+All configuration is via environment variables:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `BRAINLAYER_DB` | `~/.local/share/brainlayer/brainlayer.db` | Database file path |
+| `BRAINLAYER_ENRICH_BACKEND` | auto-detect (MLX on Apple Silicon, else Ollama) | Enrichment LLM backend |
+| `BRAINLAYER_ENRICH_MODEL` | `glm-4.7-flash` | Ollama model name |
+| `BRAINLAYER_MLX_MODEL` | `mlx-community/Qwen2.5-Coder-14B-Instruct-4bit` | MLX model identifier |
+| `BRAINLAYER_OLLAMA_URL` | `http://127.0.0.1:11434/api/generate` | Ollama API endpoint |
+| `BRAINLAYER_MLX_URL` | `http://127.0.0.1:8080/v1/chat/completions` | MLX server endpoint |
+| `BRAINLAYER_STALL_TIMEOUT` | `300` | Seconds before killing a stuck enrichment chunk |
+| `BRAINLAYER_HEARTBEAT_INTERVAL` | `25` | Log progress every N chunks during enrichment |
+| `BRAINLAYER_SANITIZE_EXTRA_NAMES` | (empty) | Comma-separated names to redact from indexed content |
+| `BRAINLAYER_SANITIZE_USE_SPACY` | `true` | Use spaCy NER for PII detection |
+
+## Optional Extras
+
+```bash
+pip install "brainlayer[brain]"     # Brain graph visualization (HDBSCAN + UMAP)
+pip install "brainlayer[cloud]"     # Cloud backfill (Gemini Batch API)
+pip install "brainlayer[youtube]"   # YouTube transcript indexing
+pip install "brainlayer[ast]"       # AST-aware code chunking (tree-sitter)
+pip install "brainlayer[dev]"       # Development: pytest, ruff
+```
+
+## Data Sources
+
+BrainLayer can index conversations from multiple sources:
+
+| Source | Format | Indexer |
+|--------|--------|---------|
+| Claude Code | JSONL (`~/.claude/projects/`) | `brainlayer index` |
+| Claude Desktop | JSON export | `brainlayer index --source desktop` |
+| WhatsApp | Exported `.txt` chat | `brainlayer index --source whatsapp` |
+| YouTube | Transcripts via yt-dlp | `brainlayer index --source youtube` |
+| Markdown | Any `.md` files | `brainlayer index --source markdown` |
+| Manual | Via MCP tool | `brainlayer_store` |
+
+## Testing
+
+```bash
+pip install -e ".[dev]"
+pytest tests/                           # Full suite (268 tests)
+pytest tests/ -m "not integration"      # Unit tests only (fast)
+ruff check src/                         # Linting
+```
+
+## Contributing
+
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for dev setup, testing, and PR guidelines.
+
+## License
+
+Apache 2.0 — see [LICENSE](LICENSE).
+
+## Origin
+
+BrainLayer was originally developed as "Zikaron" (Hebrew: memory) inside a personal AI agent ecosystem. It was extracted into a standalone project because **every developer deserves persistent AI memory** — not just the ones building their own agent systems.

brainlayer-1.0.0.dist-info/RECORD

@@ -0,0 +1,53 @@
+brainlayer/__init__.py,sha256=1QFPkIe1MCueOZ6nNAZxzvMDGW8jlH1bAsRxuJ8Qsjs,113
+brainlayer/cli_new.py,sha256=A5fQttltTpS9W4yFzFHsvPRMjf707JfOWEOvCKN_skU,5349
+brainlayer/client.py,sha256=8pdNgMRbFo1ZLF0WGCwvhT1CPauRMZ-6XOr6mu8rEcU,5131
+brainlayer/clustering.py,sha256=rFApGbYqPHz7dMNbdRJJfBHLMCD1zWgsw9uHkUQ-Ex8,24934
+brainlayer/daemon.py,sha256=7e_kKqo-ivcD8VeGVDPB_4q5zVVBhVlhVh0EiBqIOhQ,40295
+brainlayer/embeddings.py,sha256=UjH6gd0AmDtpoA11aO0w8cz9lSS2BcYSXsPJFif_z-Q,4354
+brainlayer/engine.py,sha256=rgkivregAkmglG-pCuc_1mTVabentiQOVLLP5pRIfsY,17834
+brainlayer/index_new.py,sha256=EC45TIBSbrNPwTzN_Osee_zLCN95vRMKrrZQscYEWj8,2388
+brainlayer/migrate.py,sha256=kMIYCo1kV_t4hkb2Dq8VPiP0KDINmgQBKTDBlaCa_xM,7524
+brainlayer/paths.py,sha256=cZmqoIHNk1AdxCag0i7uJlDC-jLna1h6AYkgZ9yZbU4,1349
+brainlayer/storage.py,sha256=UPWr7J5bb38vui-h6F36uc8JV_1fNl-Xa2OxMDiyMcA,2895
+brainlayer/store.py,sha256=A7zjsRjx2SnRnSgFo9A68NQAd-9qrAMZHU4nXc7XeTo,5083
+brainlayer/taxonomy.json,sha256=wUsSuDjjZ7Y50bp3BeXLmuPLJXXFG3CiVC2oYpiyaok,3750
+brainlayer/vector_store.py,sha256=C9AtPCogkgRE0uyQEJn7rjjgkIR7WCkaQY_RLHxcqnU,69840
+brainlayer/cli/__init__.py,sha256=POD5E5fI-6J0kuwVjLkkA7_4s8t1pft0Oh33ntErvvk,59839
+brainlayer/cli/wizard.py,sha256=2F--UDnN5fTx1W0-Zsf7ob77GqX8NiiUob2BxmuMRrE,4557
+brainlayer/dashboard/README.md,sha256=MlU6Auwf9hhqE2cC3WozTyar9_7kHux_hH28SfSXn_Q,4142
+brainlayer/dashboard/__init__.py,sha256=hSoDPh4FWYUQrAJB4iQaxzuAYDOT57Uz5qkjd_EyK1Q,138
+brainlayer/dashboard/app.py,sha256=553Tlh0ha_QsPa5oRKDA5nXvni7n1aKtoIGdGIq3kGc,5297
+brainlayer/dashboard/search.py,sha256=Geu3FmRDGkawuMNa3akCrMHlji7tHhkCQ8zen8Q4jzs,8198
+brainlayer/dashboard/views.py,sha256=vr8SYykQvuASyTGAxlz6xLu86WIo6J4cBCiCq6gsqr4,8695
+brainlayer/mcp/__init__.py,sha256=mAqA2tKjrDAKZQ4a723QKPG2ZeiPXND6RN5MqfZxjVE,59316
+brainlayer/pipeline/__init__.py,sha256=cn1o3Ayi6uww5Kw9LkyLPWKOAlGwmipdbtlU0MJOPtE,1117
+brainlayer/pipeline/analyze_communication.py,sha256=UGQp2Ucw2IK6ygNP3207PhQg0NH7-IIzs729ndUoEnU,18329
+brainlayer/pipeline/brain_graph.py,sha256=Vw61u2eyXzdDlvDiK_SsM8_EgwmlFG2o_TCFrrJ-5V0,20404
+brainlayer/pipeline/chat_tags.py,sha256=UJc5OzMyoARkjZzfXimdaU2M9B9Jl2ZJySn3NKjSBRk,1622
+brainlayer/pipeline/chunk.py,sha256=3DcLZWNufItt52PqBicONYYGOcDslVDtYJr03XeLE30,13191
+brainlayer/pipeline/classify.py,sha256=DjM7BnGZlQWiJELUgYB7JmFqSZm5Tdg0wxVcKUs2xJs,15270
+brainlayer/pipeline/cluster_sampling.py,sha256=1Qmjgp9fZYXcwRlLmvKqfBa2Di42SR9bXm6ko3L_yHA,2169
+brainlayer/pipeline/enrichment.py,sha256=7-S0jxQuqN38999IpLh5Ql5daxXdYl7pba5RwAk0cnI,32309
+brainlayer/pipeline/extract.py,sha256=2trzdkdWqQ_ADz-eywbncD-ZqjZ5MCnvnY7SSpek4oI,2216
+brainlayer/pipeline/extract_claude_desktop.py,sha256=ryY8awsunpuaANF4sr_Il0YXNCZB0PU5NUuV15uv5J4,4971
+brainlayer/pipeline/extract_corrections.py,sha256=VbuYvDdUrETSVMdppBcsg8yaxeApCTZiEpX7GpPo_uo,6939
+brainlayer/pipeline/extract_markdown.py,sha256=mB9EOpI99dVnPzbpphCRpqVa8OknjF6O8s1HlALaznQ,6459
+brainlayer/pipeline/extract_whatsapp.py,sha256=QJH33ajeBISMitWYrH4NGvWyVuIVFtcbm5po4fQlk8g,6950
+brainlayer/pipeline/git_overlay.py,sha256=MUYuKcJpaBA3o5lXisupwx7VqgJr4Ymj1nmys-CYFhU,9990
+brainlayer/pipeline/longitudinal_analyzer.py,sha256=_rezYzju45B6F_RhlPngzK9Mm6By841HM84DhvWjFkY,18421
+brainlayer/pipeline/obsidian_export.py,sha256=EMKg5H0EIK29hSKkIqlejYOt5Y_qiV3CD5RpKqPiqLc,13092
+brainlayer/pipeline/operation_grouping.py,sha256=LwShEMFGVY1QUgcGTu4PkVTxrq-LixPNmX9DisTIaeQ,14702
+brainlayer/pipeline/plan_linking.py,sha256=mWbFn5O2o9ZbhCzUf1AGMvtxA6y7EgPT620vgAkdOlI,10265
+brainlayer/pipeline/sanitize.py,sha256=7r2yVqU6FxFz7jCCWr5cOQg513ASdMjIt-s-blmNpb0,20957
+brainlayer/pipeline/semantic_style.py,sha256=BoTp0bGu849Pm4Mk6-B1Lzews23J6pZihaFJLpIjPik,19865
+brainlayer/pipeline/session_enrichment.py,sha256=phO5evcF1meg8u0Bf9eTqHbpBCfCViIg6pNcU-0PxYg,16550
+brainlayer/pipeline/style_embed.py,sha256=yIJQ4Xg8-sASEr7Ia7lvoePa9jsQc-PWk8k9AC1FFKo,2125
+brainlayer/pipeline/style_index.py,sha256=E1FXXBI5O6aGPTCjc6zWjLvTEK4LpaB_OB6dmc7D5jg,4238
+brainlayer/pipeline/temporal_chains.py,sha256=jC5kbJ8OGaqkI8TyqKm_TS-rDynBcoJly9XaWnM8Xk4,5870
+brainlayer/pipeline/time_batcher.py,sha256=KwpeJzg6ukJWs7xFaJJkf9XhbNdVyjiqHAhJX04q2wI,7721
+brainlayer/pipeline/unified_timeline.py,sha256=2kOnc8spe79yIeXcn41ekWzkEjuZdxSxyDQcjSEyrqA,18941
+brainlayer-1.0.0.dist-info/METADATA,sha256=NQKFkc5Qzd22P8ueg-_2jNtQ9IMjIXOypsyl_Eqk770,12554
+brainlayer-1.0.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+brainlayer-1.0.0.dist-info/entry_points.txt,sha256=KivokI18ZbQ0-IdSh8su5bneMCwcZ83oyEgOzQuHSQE,131
+brainlayer-1.0.0.dist-info/licenses/LICENSE,sha256=8-KXpK_PTTaufqqaX-lKBKSr1Uo9uWwQWboyLdP2VVs,10774
+brainlayer-1.0.0.dist-info/RECORD,,

brainlayer-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

brainlayer-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+brainlayer = brainlayer.cli:app
+brainlayer-daemon = brainlayer.daemon:main
+brainlayer-mcp = brainlayer.mcp:serve

brainlayer-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 BrainLayer Contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.