@type result() :: {:ok, t()} | {:error, {:invalid_thread_goal, term()}}

@type status() :: :active | :paused | :budget_limited | :complete

@type t() :: %CodexEx.AppServer.ThreadGoal{
  created_at: CodexEx.AppServer.Types.timestamp(),
  objective: binary(),
  status: status(),
  thread_id: binary(),
  time_used_seconds: non_neg_integer(),
  token_budget: non_neg_integer() | nil,
  tokens_used: non_neg_integer(),
  updated_at: CodexEx.AppServer.Types.timestamp()
}