How waterbottles792/anzenna works
Anzenna is a prompt-injection and sensitive-data scanning product, exposed through an HTTP API and an MCP server. Its principal workflow accepts text at an entry point, runs layered detection and scoring, then returns a structured risk result; the API also handles keys, usage limits, scan logs, and subscription billing. Detection includes deterministic heuristics, PII/secrets and encoding checks, an optional ML classifier, LLM judging, and OWASP tagging. The graph reflects sampled source and SOURCE INDEX references; unsampled subsystem details and their internal links are limited accordingly.
Main entry points: main.py API Service · pipeline.py Scan Pipeline · layer1.py Deterministic Layer · scan_text.py Text Scanner
Components 19
HTTP API
- API Service
api/main.py
Detection Engine
- Scan Pipeline
engine/pipeline.py - Text Scanner
engine/scan_text.py - Deterministic Layer
engine/layer1.py - Phrase Rules
engine/heuristics.py - Encoding Checks
engine/encoding.py - PII and Secrets
engine/pii.py - ML Classifier
engine/classifier.py - LLM Judge
engine/llm_judge.py - OWASP Tags
engine/owasp.py
MCP Integration
- MCP Server
sdks/mcp/server.py - Tool Scanner
engine/mcp_tools.py
Billing and Storage
- Billing Logic
api/billing.py - Database CRUD
api/db.py - Data Models
api/models.py
Other components
- API Client
- Application Database
- Dodo Payments
- MCP Host
Connections 23
- API Client → API Service: submits scans
api/main.py - API Service → Scan Pipeline: scans text
api/main.py - Scan Pipeline → Deterministic Layer: runs first
engine/pipeline.py - Scan Pipeline → ML Classifier: runs conditionally
engine/pipeline.py - Scan Pipeline → LLM Judge: escalates ambiguities
engine/pipeline.py - Scan Pipeline → OWASP Tags: maps categories
engine/pipeline.py - Deterministic Layer → Phrase Rules: matches rules
engine/layer1.py - Deterministic Layer → Encoding Checks: checks obfuscation
engine/layer1.py - Deterministic Layer → PII and Secrets: detects sensitive data
engine/layer1.py - Text Scanner → Deterministic Layer: scans text
engine/scan_text.py - Text Scanner → LLM Judge: escalates findings
engine/scan_text.py - Text Scanner → OWASP Tags: tags results
engine/scan_text.py - MCP Host → MCP Server: invokes tools
sdks/mcp/server.py - MCP Server → Text Scanner: scans text
sdks/mcp/server.py - MCP Server → Tool Scanner: checks tool descriptions
sdks/mcp/server.py - Tool Scanner → Text Scanner: shares scan logic
engine/mcp_tools.py - API Service → Database CRUD: reads and writes
api/main.py - Database CRUD → Data Models: uses entities
api/db.py - Database CRUD → Application Database: persists records
api/db.py - API Service → Billing Logic: starts checkout
api/main.py - Billing Logic → Database CRUD: updates plans
api/billing.py - Billing Logic → Dodo Payments: creates sessions
api/billing.py - API Service → Dodo Payments: verifies webhooks
api/main.py