Skip to Content
Aionis v0.3.2 is the current Runtime baseline for SDK/API hosts, MCP clients, plugins, Substrate-backed recall, and self-managed agent loops.
API ReferenceEvidence & ReplayFlight Recorder

Flight Recorder

POST /v1/audit/flight-recorder

Replay what memory the Agent could see, what was blocked, what was used, and why.

Use Flight Recorder for debugging, incident review, admission analysis, and operator reporting.

Request body

Send a full product_trace or individual replay artifacts.

FieldTypeRequiredDescription
tenant_idstringNoTenant boundary.
scopestringNoProject or workspace boundary.
run_idstringNoExecution run identifier.
guide_trace_idstringNoGuide trace connected to the decision.
decision_timestringNoISO timestamp for the replay point.
product_traceobjectConditionalFull trace containing guide, feedback, and measurement inputs.
agent_contextobjectConditionalAgent context returned by guide.
memory_decision_traceobjectConditionalDecision trace from guide or measure.
memory_use_receiptobjectConditionalReceipt returned by guide.
operator_snapshotobjectConditionalSnapshot returned by /v1/operator/snapshot.
feedback_resultobjectConditionalFeedback result connected to the run.

At least one replay artifact is required when product_trace is absent.

Example

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-001",
    "guide_trace_id": "guide_trace:abc",
    "agent_context": {},
    "memory_decision_trace": {},
    "memory_use_receipt": {},
    "feedback_result": {},
    "decision_time": "2026-06-15T00:00:00.000Z"
  }'

SDK

const report = await aionis.flightRecorder({
  run_id: "run-001",
  guide_trace_id: guide.guide_trace_id,
  agent_context: guide.agent_context,
  memory_use_receipt: guide.memory_use_receipt,
  feedback_result: feedback,
});

Response

Important fields:

FieldMeaning
contract_versionaionis_agent_flight_recorder_result_v1.
agent_flight_recorder.agent_viewMemory visible to the Agent at decision time.
agent_flight_recorder.blocked_or_suppressedMemory blocked from action or suppressed.
agent_flight_recorder.attributionOutcome linkage to used, supported, or contradicted memory.
agent_flight_recorder.claimsBounded audit claims supported by the replay artifacts.
Operator SnapshotHealth