Metadata-Version: 2.5
Name: smruti
Version: 0.1.0
Summary: A Biologically Inspired, Dual-Valence Cognitive Memory Engine for Autonomous AI Agents
License-Expression: Apache-2.0
Requires-Python: >=3.10
Requires-Dist: fastembed>=0.2.0
Requires-Dist: fastmcp>=0.1.0
Requires-Dist: numpy>=1.20.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: typer>=0.9.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.20.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# smruti (स्मृति)

> **Biologically Inspired, Dual-Valence Cognitive Memory for Autonomous AI Agents**

smruti equips autonomous coding and reasoning agents with an active, biological memory architecture:

1. **Tier 1 (Episodic Working Stream):** Sub-millisecond, append-only SQLite WAL stream. Zero LLM latency while acting.
2. **Tier 2 (The "Sleep" Consolidation Engine):** Periodic background distillation that strips 90% verbatim token noise into schemas and rules.
3. **Tier 3 (Dual-Valence Cortical Mesh):**
   - **Positive Heuristics (Tier 3A):** Verified solution paths with biological Ebbinghaus decay and Hebbian reinforcement.
   - **Inhibitory Anti-Memories (Tier 3B):** Active preflight interception gate that prevents agents from repeating known fatal mistakes and compiler errors.

---

## Quickstart

### Installation
```bash
pip install -e .
```

### CLI Inspection
```bash
smruti init      # Initialize .smruti/ database in your project
smruti status    # View positive rules, anti-memories, and decay health
smruti sleep     # Run offline consolidation over recent episodes
smruti audit     # Inspect chronological agent trajectories
```

### MCP (Model Context Protocol) Server for Cursor / Claude Code / Antigravity
Add to your MCP configuration (`mcpServers`):
```json
{
  "smruti": {
    "command": "smruti",
    "args": ["mcp"]
  }
}
```
