Agent Flight Recorder

Agent Flight Recorder answers the question production Agent teams eventually need to ask:


What did the Agent know when it made that decision?

It reconstructs direct-use memory, blocked memory, rehydrate hints, guide attribution, feedback, and operator snapshot signals without turning your raw prompt log into the audit system.

When To Use It

Use Flight Recorder when:

Situation	What Aionis reconstructs
An Agent repeated a failed branch	Whether the failed branch was admitted, blocked, or ignored.
An Agent ignored current state	Whether current state was present in `use_now` or only inspectable.
A memory caused harm	Which guide exposed it and what feedback was attributed.
A team needs incident review	A bounded report of context, decisions, reasons, and outcome.

Product Path


guide_trace_id + run_id + snapshot/effect evidence -> flight recorder report

The report is read-only. It does not mutate memory, change lifecycle state, or rerun the Agent.

SDK


const report = await aionis.flightRecorder({
  run_id: "run-20250615-001",
  guide_trace_id: "guide_trace:...",
  include_prompt_payload: false,
});

Prefer include_prompt_payload: false for operator workflows. You usually want the decision surfaces, not the full prompt.

API


curl -s http://127.0.0.1:3001/v1/audit/flight-recorder \
  -H 'content-type: application/json' \
  -d '{
    "tenant_id": "default",
    "scope": "checkout-migration",
    "run_id": "run-20250615-001",
    "guide_trace_id": "guide_trace:...",
    "include_prompt_payload": false
  }'

What The Report Should Contain

Surface	Why it matters
`guide_trace_id`	Which guide exposure is being replayed.
`agent_context_summary`	What the Agent could use without dumping prompt text.
`memory_use_receipt`	Why memory was used or suppressed.
`feedback_attribution`	Whether outcome was tied to specific exposed memory.
`operator_snapshot`	Active path, failed branches, and lifecycle state.

Run It Locally

Run the quickstart:


npm run -s runtime:quickstart:flight-recorder

Run the incident demo:


npm run -s runtime:e2e:flight-recorder-incident

Guide: AIONIS_AGENT_FLIGHT_RECORDER.md .