Flight Recorder Overview

Cryptographically signed agent audit trail — standalone or platform-integrated

Flight Recorder is a lightweight, standalone action recorder for AI agents. It records every action an agent takes, signs records with Ed25519, and exports them in OCSF format for SIEM integration and compliance reporting.

Install

pip install pramiti-flight-recorder

Quick Start

from pramiti_flight_recorder import FlightRecorder
 
fr = FlightRecorder()  # SQLite by default
fr.record("my-agent", "salesforce.create_lead", "create", {"email": "[email protected]"}, "allow")
 
# Export to OCSF for SIEM
ocsf_events = fr.export_ocsf()
 
# Generate compliance report
report = fr.compliance_report("eu_ai_act", "2026-01-01", "2026-12-31")

Standalone vs Platform

Flight Recorder works in two modes:

Mode	Database	Signing	Platform
Standalone	SQLite (auto-init)	Optional Ed25519	No Pramiti platform needed
Platform	PostgreSQL (shared)	Ed25519 via Aegis	Full Pramiti platform integration

In standalone mode, Flight Recorder requires zero external dependencies beyond SQLAlchemy. It creates a local SQLite database and starts recording immediately.

In platform mode, Flight Recorder uses the Aegis attestation store and inherits all platform features (workspace isolation, SIEM delivery, delegation).

Components

Standalone Usage — pip install, SQLite, record and query actions
OCSF Export — OCSF schema mapping for SIEM integration
Compliance Reports — EU AI Act, SOC 2, and custom compliance reports

Architecture

AI Agent → FlightRecorder.record()
               ↓
          Store (SQLite or PostgreSQL)
               ↓
         ┌─────┴─────┐
    OCSF Export   Compliance Reports
         ↓              ↓
    SIEM (Splunk,   PDF/JSON reports
    Sentinel, etc.)