"""
_config.py — receipts kit stub.

The script in this folder was originally run with a vault-internal
_config module that wires up provider clients (xAI, Gemini), handles
proxy-routed API keys, and provides shared helpers for retry and
result formatting.

This file replaces that module with a documented stub. Importing it
will succeed; calling either function will raise NotImplementedError
with a pointer to the docstring describing what the function did. To
reproduce the experiment end-to-end, replace each NotImplementedError
body with a call to your own provider's SDK.

What the original module does is reconstructible from the function
signatures and the call sites in `trust_signals.py`. Nothing here
changes the regex-based signal-extraction logic in Phase 2, which
runs without any of the API helpers.
"""


def _stub(name, summary):
    raise NotImplementedError(
        f"_config.{name} is a stub. {summary} "
        f"Replace with a call to your provider's SDK to reproduce."
    )


def get_xai_client():
    """Return an xAI client. Original used a proxy-routed wrapper around
    the OpenAI SDK pointed at the xAI base URL with the XAI_API_KEY
    environment variable. Used by Phase 1 (generation).
    """
    _stub("get_xai_client",
          "Original returned an OpenAI-compatible client with "
          "base_url=https://api.x.ai/v1 and api_key=os.environ['XAI_API_KEY'].")


def get_gemini_client():
    """Return a Gemini client. Original used google.genai with the
    GEMINI_API_KEY environment variable. Used by Phase 3 (blinded LLM
    trust evaluation).
    """
    _stub("get_gemini_client",
          "Original returned a google.genai.Client(api_key="
          "os.environ['GEMINI_API_KEY']).")