Planck.Agent.Message (Planck.Agent v0.2.2)

An agent-side message with metadata.

Wraps Planck.AI.Message content parts with an id, timestamp, and metadata map. Messages with a {:custom, atom()} role are UI-only and filtered out before the context is sent to the LLM.

Summary

Types

role()

t()

Functions

new(role, content, metadata \\ %{})

Build a new message with a generated id and current UTC timestamp.

to_ai_messages(messages)

Convert a list of agent messages to Planck.AI.Message structs.

Types

role()

@type role() :: :user | :assistant | :tool_result | {:custom, atom()}

t()

@type t() :: %Planck.Agent.Message{
  content: [Planck.AI.Message.content_part()],
  id: non_neg_integer() | String.t(),
  metadata: map(),
  role: role(),
  timestamp: DateTime.t()
}

Functions

new(role, content, metadata \\ %{})

@spec new(role(), [Planck.AI.Message.content_part()], map()) :: t()

Build a new message with a generated id and current UTC timestamp.

to_ai_messages(messages)

@spec to_ai_messages([t()]) :: [Planck.AI.Message.t()]

Convert a list of agent messages to Planck.AI.Message structs.

{:custom, :summary} messages are converted to :user so the LLM sees compacted context. All other {:custom, _} messages are dropped.