System Integrity: Optimal
Architecture
Each layer maps onto a Pi package. Our custom code lives in the thin extension layer on top.
Core Interaction Matrix
v0.2.0
hub
Pi Engine
bolt
Sarvam AI
cloud_queue
Ollama Cloud Layer
Model Agnostic
Swap providers via environment variables. Sarvam showcased by default; Ollama Cloud for hard cross-file tasks.
SUPRATIM_PROVIDER
ollama-cloud
DEFAULT_MODEL
sarvam-105b
autorenew
Agentic Loop
pi-agent-core drives read → edit → bash cycles until the model synthesises a final answer or guards cut the loop.
verified_user
Verification Gates
ts-verify post-edit checks and turn-limit (30 turns) prevent infinite tool loops — shipped in Phase 0b.
Stack Layers
| Layer | Stack |
|---|---|
| CLI surface | supratim CLI + pi-tui (InteractiveMode) |
| Core engine | pi-agent-core — tool loop, state, sessions |
| Provider layer | pi-ai + Sarvam / Ollama via models.json |
| Extensions | sarvam-compat · usage-hud · api-debug · ts-verify · turn-limit |
| Security | API keys in OS credential manager — never plaintext on disk |
| Config dir | ~/.supratim/ (override with SUPRATIM_AGENT_DIR) |
| Model | Context | Input / 1M tokens | Output / 1M tokens |
|---|---|---|---|
| sarvam-105b Default | 128K | ₹4 | ₹16 |
| sarvam-30b | 64K | ₹2.5 | ₹10 |