hints.py

"""Helpful hints for common error conditions."""

MULTICELL_HINT = (
    "Hint: If you are on a multi-cell dbt platform instance, you may need to set "
    "the MULTICELL_ACCOUNT_PREFIX environment variable. "
    "See https://docs.getdbt.com/docs/dbt-ai/setup-local-mcp#api-and-sql-tool-settings"
)


def looks_like_ssl_error(error: Exception) -> bool:
    """Check if an exception looks like an SSL/certificate error."""
    error_str = str(error).lower()
    return any(kw in error_str for kw in ["ssl", "certificate"])


def with_multicell_hint(message: str) -> str:
    """Add multicell hint to a message if it looks like an SSL error."""
    if any(kw in message.lower() for kw in ["ssl", "certificate"]):
        return f"{message}\n\n{MULTICELL_HINT}"
    return message