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 as a compact 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 and keeps lifecycle changes and Agent reruns on their dedicated product paths.

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 instead of 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 in compact form.
`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 .