@spec generate_object(String.t(), map() | keyword(), keyword()) ::
  {:ok, map()} | {:error, term()}

Generate a structured object adhering to schema.

Accepts a string prompt, a schema map/keyword expected by ReqLLM, and optional generation overrides.

Supports optional :model override (defaults to :fast). Returns {:ok, map} or {:error, reason}.

@spec llm_call(
  String.t(),
  keyword()
) :: {:ok, String.t()} | {:error, term()}

Generate free-form text from an LLM model alias.

Accepts a prompt string and optional overrides for generation opts (:max_tokens, :temperature, etc).

Supports optional :model override (defaults to :fast). Returns {:ok, text} or {:error, reason}.