Behaviour and dispatcher for character renderers.

A renderer transforms a character map into:

• A system prompt string (to_system_prompt/2)
• A ReqLLM.Context struct (to_context/2)

Configuration Priority

Renderers are resolved in this order:

1. Per-call options (:renderer key)
2. Global application config
3. Built-in Markdown renderer (default)

Global Configuration

# config/config.exs
config :jido_character, Jido.Character.Renderer,
  renderer: MyApp.CustomRenderer,
  renderer_opts: [format: :json]

Implementing a Custom Renderer

defmodule MyApp.CustomRenderer do
  @behaviour Jido.Character.Renderer

  @impl true
  def to_system_prompt(character, opts) do
    # Return a string prompt
    "You are #{character.name}..."
  end

  @impl true
  def to_context(character, opts) do
    # Return a ReqLLM.Context
    prompt = to_system_prompt(character, opts)
    ReqLLM.Context.new([ReqLLM.Context.system(prompt)])
  end
end

The to_context/2 callback is optional. If not implemented, the dispatcher will wrap the result of to_system_prompt/2 in a ReqLLM.Context.