System boundary

AgentRail Architecture

AgentRail records AI-agent traces through a TypeScript SDK, accepts spans through an ingestion API, processes them asynchronously, and presents a forensic dashboard for investigation.

Current local stack

M1 runs locally with the SDK, ingestion service, worker, PostgreSQL, Redis, MinIO-compatible object storage, and the Next.js dashboard. Payload evidence stays behind backend API routes.

AWS reference mapping

The planned AWS path maps ingestion to API Gateway and Lambda, buffering to SQS, metadata to RDS/PostgreSQL, evidence blobs to S3, and operational signals to CloudWatch. This is a deployment plan, not a claim that hosted production is active.

Privacy modes

Local-only mode is current. Metrics-only reporting and evidence sync are planned modes that require explicit controls before hosted beta.

Read the full architecture document