@callback request(url_or_spec :: term(), payload :: term(), opts :: keyword()) ::
  {:ok, term()} | {:error, term()}

Performs an HTTP operation.

Parameters and return values are intentionally generic to support different use cases (LLM calls, REST APIs, webhooks, etc.).

Implementations should document their specific contracts.