Reference

Exact command, SDK, configuration, policy, and trace contracts. For a guided first run, begin with Getting started.

• CLI
  • Start and configure
  • Capture and import
  • Baseline and gate
• SDK
  • @trace
  • traced_run
  • has_active_run
  • record_llm_call
  • record_tool_call
  • record_state
  • Example: tracing a ReAct-style agent loop
  • Implicit runs (MAIDA_IMPLICIT_RUN=1)
  • Redaction and truncation
• Configuration
  • Precedence
  • Settings
  • Full YAML example
  • Safe-by-default local traces
• Policy v2
  • Metric kinds
  • Direction and reporting
  • Composition and stopping
  • Immutable baseline capture
  • Version streams
  • v1 migration
• Trace format
  • Run storage layout
  • Span envelope (all spans)
  • Event types
  • Payload schemas by event type
  • meta.json schema
  • Versioning note
• External emitter guide
  • Minimal completed trace
  • Required fields
  • Optional enrichments
  • Main thread and Subthreads
  • Validation and Exit codes
  • Versioning and Breaking changes
• Architecture
  • Span schema
  • Storage layout
  • Viewer API
  • UI overview
  • Guardrails
  • Live-refresh viewer
  • Integration architecture
  • Loop detection