@type message() :: %{
  role: role(),
  content: String.t() | nil,
  tool_call_id: String.t() | nil,
  tool_name: String.t() | nil,
  tool_input: map() | nil,
  tool_output: map() | String.t() | nil,
  metadata: map()
}

@type role() :: :system | :user | :assistant | :tool

@type t() :: %AgentSessionManager.Core.Transcript{
  last_sequence: non_neg_integer() | nil,
  last_timestamp: DateTime.t() | nil,
  messages: [message()],
  metadata: map(),
  session_id: String.t()
}