ExAthena.Messages (ExAthena v0.3.0)

Canonical in-memory representation of a conversation.

Every provider normalises its wire format into this shape so the agent loop, tool-call parsers, and consumer code all speak the same dialect.

Summary

Build an assistant message (optionally with tool calls).

from_map(m)

Turn a loose map/keyword into a Message. Tolerant of both string and atom keys so provider JSON and user-constructed data both work.

system(content)

Build a system message.

Build a tool-result message replaying the output of a tool call.

user(content)

Build a user message.

@spec assistant(String.t() | nil, [ExAthena.Messages.ToolCall.t()] | nil) ::
  ExAthena.Messages.Message.t()

Build an assistant message (optionally with tool calls).

@spec from_map(map() | ExAthena.Messages.Message.t()) :: ExAthena.Messages.Message.t()

Turn a loose map/keyword into a Message. Tolerant of both string and atom keys so provider JSON and user-constructed data both work.

@spec system(String.t()) :: ExAthena.Messages.Message.t()

Build a system message.

@spec tool_result(String.t(), String.t(), boolean() | nil) ::
  ExAthena.Messages.Message.t()

Build a tool-result message replaying the output of a tool call.

@spec user(String.t()) :: ExAthena.Messages.Message.t()

Build a user message.