"""
author: Yagnik Poshiya
organization: Webbrains Technologies Private Limited

Save-time check for a project's own AI settings: one tiny chat call and one embedding
call, made with exactly the clients a chat turn would use, so a typo in a key or model
name fails in the Connected Agents card instead of on a customer's website.
"""

from __future__ import annotations

import re

from embeddings.factory import build_query_embedder
from llm.base import GenerationConfig
from llm.factory import build_llm_client
from models.chat import (
    LlmConfigCheck,
    LlmConfigToValidate,
    LlmConfigValidateRequest,
    LlmConfigValidateResponse,
)

_MAX_ERROR_CHARS = 300


def provider_error_message(err: Exception, api_key: str) -> str:
    """A short, key-free description of a provider error for the card."""
    message = str(getattr(err, "message", "") or err).strip() or type(err).__name__
    # Prefer the provider's own `"message": "..."` text over the raw payload dump.
    m = re.search(r"""['"]message['"]\s*:\s*['"]([^'"]+)['"]""", message)
    if m:
        message = m.group(1)
    if len(api_key or "") >= 8 and api_key in message:  # real keys are long; never mask fragments
        message = message.replace(api_key, "••••")
    message = " ".join(message.split())
    return message[:_MAX_ERROR_CHARS]


def _check_llm(part: LlmConfigToValidate) -> LlmConfigCheck:
    try:
        client = build_llm_client(part.provider, part.model, api_key=part.api_key)
        client.generate(
            "Reply with the single word OK.",
            config=GenerationConfig(temperature=0.0, max_output_tokens=32),
        )
        return LlmConfigCheck(ok=True)
    except Exception as e:  # provider SDKs raise many types; all mean "unusable"
        return LlmConfigCheck(ok=False, error=provider_error_message(e, part.api_key))


def _check_embedding(part: LlmConfigToValidate, output_dimensionality: int) -> LlmConfigCheck:
    try:
        embedder = build_query_embedder(
            part.provider,
            part.model,
            api_key=part.api_key,
            output_dimensionality=output_dimensionality,
        )
        dims = len(embedder.embed_query("ping"))
    except Exception as e:
        return LlmConfigCheck(ok=False, error=provider_error_message(e, part.api_key))
    if dims != output_dimensionality:
        return LlmConfigCheck(
            ok=False,
            dimensions=dims,
            error=(
                f"This model returns {dims}-dimensional vectors; Agent Engine stores "
                f"{output_dimensionality}. Use gemini-embedding-001 (Google) or "
                "text-embedding-3-small / text-embedding-3-large (OpenAI)."
            ),
        )
    return LlmConfigCheck(ok=True, dimensions=dims)


def validate_llm_config(
    req: LlmConfigValidateRequest,
    *,
    output_dimensionality: int,
) -> LlmConfigValidateResponse:
    llm = _check_llm(req.llm) if req.llm else None
    embedding = _check_embedding(req.embedding, output_dimensionality) if req.embedding else None
    ok = all(c.ok for c in (llm, embedding) if c is not None)
    return LlmConfigValidateResponse(ok=ok, llm=llm, embedding=embedding)
