Metadata-Version: 2.4
Name: meta-agents-db
Version: 0.2.0
Classifier: Development Status :: 3 - Alpha
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Rust
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Database
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Operating System :: OS Independent
Summary: Agent-native database with causal memory, composite-scored recall, and storage-layer policy enforcement
Keywords: database,agents,memory,ai,mcp,causal,vector,recall
Author-email: Pushkar Singh <01@meta-agents.ai>, Pushkar Singh <spshkar84@gmail.com>, Pushkar Singh <spshkar84@meta-agents.ai>
License: Meta-Agents.AI Proprietary License v1.0
Requires-Python: >=3.9
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Homepage, https://meta-agents.ai
Project-URL: Repository, https://github.com/spshkar84/meta-agents-db

# meta-agents-db

Agent-native database with causal memory, composite-scored recall, and storage-layer policy enforcement.

The first database designed for autonomous AI agents.

## Install

```bash
pip install meta-agents-db
```

## Quick start

```python
from meta_agents_db import MetaAgentsDB

db = MetaAgentsDB("./data")
event_id = db.write(content="SPY broke below 200-day MA", tags=["signal", "SPY"])
results = db.recall("SPY bearish signals", top_k=10)
chain = db.trace_cause(event_id, direction="backward", max_depth=5)
```

## Features

- **Causal DAG** — every memory links to its causes; trace full decision chains
- **5-signal composite recall** — vector similarity + recency + causal proximity + importance + tag overlap
- **Storage-layer policy** — risk caps, budget caps, rate limits enforced at write time
- **HNSW vector index** — sub-millisecond approximate nearest neighbor search
- **Session caching** — deduplicates repeated recalls within a pipeline cycle
- **MVCC** — snapshot isolation for concurrent readers/writers
- **WAL + SSTables** — crash-safe append-only log with background compaction

## License

Apache-2.0

