Behaviour for realtime model implementations.

This behaviour defines the interface for connecting to a realtime model and sending/receiving events. Implementations can include WebSocket-based connections to OpenAI's Realtime API or mock implementations for testing.

Implementing a Model

To implement a custom realtime model, use this behaviour and implement all callbacks:

defmodule MyCustomModel do
  @behaviour Codex.Realtime.Model

  @impl true
  def connect(config) do
    # Establish connection
    :ok
  end

  @impl true
  def add_listener(listener) do
    # Add event listener
    :ok
  end

  # ... implement other callbacks
end

Listeners

Listeners can be either a pid or a function. When an event is received, it is forwarded to all registered listeners:

• If the listener is a pid, the event is sent as {:model_event, event}
• If the listener is a function, it is called with the event