@type error() :: {:error, binary() | atom() | :testing}

@type input_opts() :: %{
  :agent => AI.Agent.t(),
  :conversation_pid => pid(),
  :edit => boolean(),
  :question => binary(),
  :replay => boolean(),
  :smart => binary(),
  optional(:reasoning) => AI.Model.reasoning_level(),
  optional(:verbosity) => AI.Model.verbosity_level(),
  optional(:fonz) => boolean()
}

@type state() :: t() | error()

@type t() :: %AI.Agent.Coordinator{
  agent: AI.Agent.t(),
  context: non_neg_integer(),
  conversation_pid: pid(),
  edit?: boolean(),
  editing_tools_used: boolean(),
  followup?: boolean(),
  fonz: boolean(),
  interrupts: AI.Agent.Coordinator.Interrupts.t(),
  intuition: binary() | nil,
  last_response: binary() | nil,
  model: AI.Model.t(),
  project: binary(),
  question: binary(),
  replay: boolean(),
  steps: [atom()],
  usage: non_neg_integer()
}