@spec budget_enforcement_span(atom(), map()) ::
  {:ok, AITrace.Span.t()} | {:error, term()}

@spec budget_exhaust_event(atom(), map()) ::
  {:ok, AITrace.Event.t()} | {:error, term()}

@spec budget_exhaustion_event(atom(), map()) ::
  {:ok, AITrace.Event.t()} | {:error, term()}

@spec context_packet_compile_span(map()) :: {:ok, AITrace.Span.t()} | {:error, term()}

@spec cost_attribution_event(map()) :: {:ok, AITrace.Event.t()} | {:error, term()}

@spec cost_span(map()) :: {:ok, AITrace.Span.t()} | {:error, term()}

@spec eval_span(map()) :: {:ok, AITrace.Span.t()} | {:error, term()}

@spec eval_verdict_event(map()) :: {:ok, AITrace.Event.t()} | {:error, term()}

@spec guard_evaluation_span(map()) :: {:ok, AITrace.Span.t()} | {:error, term()}

@spec guard_violation_event(map()) :: {:ok, AITrace.Event.t()} | {:error, term()}

@spec memory_span(atom(), map()) :: {:ok, AITrace.Span.t()} | {:error, term()}

@spec model_call_span(map()) :: {:ok, AITrace.Span.t()} | {:error, term()}

@spec promotion_event(map()) :: {:ok, AITrace.Event.t()} | {:error, term()}

@spec prompt_resolution_span(map()) :: {:ok, AITrace.Span.t()} | {:error, term()}

@spec replay_event(atom(), map()) :: {:ok, AITrace.Event.t()} | {:error, term()}

@spec replay_span(map()) :: {:ok, AITrace.Span.t()} | {:error, term()}

@spec rollback_event(map()) :: {:ok, AITrace.Event.t()} | {:error, term()}

@spec route_decision_span(map()) :: {:ok, AITrace.Span.t()} | {:error, term()}