chore: import upstream snapshot with attribution

surfaces/cli/error_mapping.py

@@ -0,0 +1,68 @@
+"""Map low-level CLI runtime errors to user-facing CLI errors."""
+
+from __future__ import annotations
+
+from typing import NoReturn
+
+
+def reraise_cli_runtime_error(exc: BaseException) -> NoReturn:
+    """Convert CLI auth/setup failures to structured CLI UX errors."""
+    from core.llm.shared.llm_retry import LLMCreditExhaustedError
+    from core.llm_invoke_errors import classify_llm_invoke_failure
+    from integrations.llm_cli.errors import CLIAuthenticationRequired
+    from surfaces.interactive_shell.utils.error_handling.errors import OpenSREError
+
+    if isinstance(exc, LLMCreditExhaustedError):
+        raise OpenSREError(
+            str(exc),
+            suggestion=(
+                "Run `opensre auth login <provider>` to re-authenticate "
+                "or switch to a different provider."
+            ),
+        ) from exc
+
+    if isinstance(exc, CLIAuthenticationRequired):
+        raise OpenSREError(
+            f"{exc.provider} CLI is not authenticated.",
+            suggestion=f"{exc.auth_hint} ({exc.detail})",
+        ) from exc
+
+    classified = classify_llm_invoke_failure(exc)
+    if classified is not None:
+        suggestion = (
+            "\n".join(classified.remediation_steps) if classified.remediation_steps else None
+        )
+        raise OpenSREError(classified.user_message, suggestion=suggestion) from exc
+
+    if isinstance(exc, RuntimeError):
+        msg = str(exc).lower()
+        if "cli not found" in msg or "not found on path" in msg:
+            raise OpenSREError(
+                "CLI tool is not installed or not found.",
+                suggestion=str(exc),
+            ) from exc
+        if (
+            "prompt too long" in msg
+            and "auth status could not be verified before invocation" in msg
+        ):
+            raise OpenSREError(
+                "LLM invocation failed.",
+                suggestion=str(exc),
+            ) from exc
+        if "anthropic" in msg and "model" in msg and "was not found" in msg:
+            raise OpenSREError(
+                str(exc),
+                suggestion="Verify your model name in ANTHROPIC_REASONING_MODEL or ANTHROPIC_TOOLCALL_MODEL environment variables.",
+            ) from exc
+        if "bedrock model" in msg and "not available for your account" in msg:
+            raise OpenSREError(
+                str(exc),
+                suggestion=(
+                    "Enable access to the configured Bedrock model in the AWS region, "
+                    "verify the AWS Marketplace subscription/payment setup, and ensure "
+                    "the IAM user or role can use aws-marketplace:ViewSubscriptions "
+                    "and aws-marketplace:Subscribe."
+                ),
+            ) from exc
+
+    raise exc