"""
Tests for the Rubrik LiteLLM plugin.

Covers initialization, apply_guardrail (prompt moderation + response/tool
blocking), batch logging, and Anthropic format handling.
"""

import os
from typing import Any, Dict
from unittest.mock import AsyncMock, Mock, patch

import httpx
import pytest

from litellm.integrations.custom_guardrail import ModifyResponseException
from litellm.integrations.rubrik import (
    RubrikLogger,
    _MalformedToolBlockingResponseError,
)
from litellm.proxy._types import UserAPIKeyAuth

from tests.test_litellm.integrations.rubrik_test_helpers import (
    make_inputs_with_tools,
    make_tool_call_dict,
)


@pytest.fixture
def mock_env():
    """Set up environment variables for testing."""
    with patch.dict(
        os.environ,
        {
            "RUBRIK_WEBHOOK_URL": "http://localhost:8080",
            "RUBRIK_API_KEY": "test-api-key",
        },
    ):
        yield


@pytest.fixture
def handler(mock_env):
    """Create a RubrikLogger instance for testing."""
    with patch("asyncio.create_task", Mock()):
        return RubrikLogger()


@pytest.fixture
def user_api_key_dict():
    """The authenticated caller the proxy hands to async_post_call_failure_hook."""
    return UserAPIKeyAuth(
        api_key="sk-block-attribution-test",
        key_alias="rubrik-probe-key",
        user_id="probe-user-1",
        team_id="probe-team-1",
        org_id="probe-org-1",
    )


# -- Initialization -----------------------------------------------------------


class TestInitialization:
    def test_init_success(self, mock_env):
        with patch("asyncio.create_task", Mock()):
            handler = RubrikLogger()
            assert (
                handler.response_moderation_endpoint
                == "http://localhost:8080/v1/after_completion/openai/v1"
            )
            assert handler.logging_endpoint == "http://localhost:8080/v1/litellm/batch"
            assert handler.key == "test-api-key"
            assert handler.moderation_client is not None

    def test_init_with_constructor_params(self):
        with patch("asyncio.create_task", Mock()):
            handler = RubrikLogger(api_key="ctor-key", api_base="http://ctor-host:9090")
            assert handler.key == "ctor-key"
            assert (
                handler.response_moderation_endpoint
                == "http://ctor-host:9090/v1/after_completion/openai/v1"
            )

    def test_init_without_url(self):
        with patch.dict(os.environ, {}, clear=True):
            with pytest.raises(ValueError, match="Rubrik webhook URL not configured"):
                RubrikLogger()

    def test_init_without_api_key(self):
        with patch.dict(
            os.environ, {"RUBRIK_WEBHOOK_URL": "http://localhost:8080"}, clear=True
        ):
            with patch("asyncio.create_task", Mock()):
                assert RubrikLogger().key is None

    def test_trailing_slash_removed(self):
        with patch.dict(os.environ, {"RUBRIK_WEBHOOK_URL": "http://localhost:8080/"}):
            with patch("asyncio.create_task", Mock()):
                assert (
                    RubrikLogger().response_moderation_endpoint
                    == "http://localhost:8080/v1/after_completion/openai/v1"
                )

    def test_v1_suffix_stripped_as_substring_not_charset(self):
        with patch("asyncio.create_task", Mock()):
            with patch.dict(os.environ, {"RUBRIK_WEBHOOK_URL": "http://host/v1"}):
                assert (
                    RubrikLogger().response_moderation_endpoint
                    == "http://host/v1/after_completion/openai/v1"
                )

            with patch.dict(os.environ, {"RUBRIK_WEBHOOK_URL": "http://host/v11"}):
                assert (
                    RubrikLogger().response_moderation_endpoint
                    == "http://host/v11/v1/after_completion/openai/v1"
                )

    def test_sampling_rate_fractional(self):
        with patch("asyncio.create_task", Mock()):
            with patch.dict(
                os.environ,
                {"RUBRIK_WEBHOOK_URL": "http://host", "RUBRIK_SAMPLING_RATE": "0.5"},
            ):
                assert RubrikLogger().sampling_rate == 0.5

    def test_sampling_rate_invalid_ignored(self):
        with patch("asyncio.create_task", Mock()):
            with patch.dict(
                os.environ,
                {"RUBRIK_WEBHOOK_URL": "http://host", "RUBRIK_SAMPLING_RATE": "abc"},
            ):
                assert RubrikLogger().sampling_rate == 1.0

    def test_sampling_rate_clamped(self):
        with patch("asyncio.create_task", Mock()):
            with patch.dict(
                os.environ,
                {"RUBRIK_WEBHOOK_URL": "http://host", "RUBRIK_SAMPLING_RATE": "2.0"},
            ):
                assert RubrikLogger().sampling_rate == 1.0
            with patch.dict(
                os.environ,
                {"RUBRIK_WEBHOOK_URL": "http://host", "RUBRIK_SAMPLING_RATE": "-0.5"},
            ):
                assert RubrikLogger().sampling_rate == 0.0

    def test_batch_size_invalid_ignored(self):
        with patch("asyncio.create_task", Mock()):
            with patch.dict(
                os.environ,
                {"RUBRIK_WEBHOOK_URL": "http://host", "RUBRIK_BATCH_SIZE": "abc"},
            ):
                # Should use default without crashing
                assert isinstance(RubrikLogger().batch_size, int)

    def test_batch_size_valid(self):
        with patch("asyncio.create_task", Mock()):
            with patch.dict(
                os.environ,
                {"RUBRIK_WEBHOOK_URL": "http://host", "RUBRIK_BATCH_SIZE": "256"},
            ):
                assert RubrikLogger().batch_size == 256

    def test_init_outside_event_loop_does_not_raise(self):
        """Instantiation without a running event loop must not raise RuntimeError."""
        with patch.dict(
            os.environ,
            {"RUBRIK_WEBHOOK_URL": "http://localhost:8080", "RUBRIK_API_KEY": "k"},
        ):
            # Do NOT patch asyncio.create_task — the real call should be
            # guarded and fall back gracefully when there is no event loop.
            handler = RubrikLogger()
            assert handler.response_moderation_endpoint.startswith("http://localhost:8080")
            # Without a running loop at init, the periodic flush task should be
            # deferred so batches still get drained once a log event arrives.
            assert handler._periodic_flush_task is None

    @pytest.mark.asyncio
    async def test_periodic_flush_task_started_lazily_on_first_log(self, mock_env):
        """Loggers instantiated outside an event loop must still start the
        periodic flush task on first use to drain low-traffic batches."""
        # Simulate sync-init by hiding the running loop from the constructor.
        with patch(
            "litellm.integrations.rubrik.asyncio.get_running_loop",
            side_effect=RuntimeError("no running loop"),
        ):
            handler = RubrikLogger()
        assert handler._periodic_flush_task is None

        kwargs = {
            "standard_logging_object": {
                "messages": [{"role": "user", "content": "hi"}],
                "id": "litellm-id",
            },
            "litellm_call_id": "litellm-id",
            "litellm_params": {},
        }
        with patch.object(handler, "_log_batch_to_rubrik", AsyncMock()):
            await handler.async_log_success_event(kwargs, None, None, None)

        assert handler._periodic_flush_task is not None
        handler._periodic_flush_task.cancel()

    def test_event_hook_defaults_to_post_call_when_none_passed(self, mock_env):
        """`initialize_guardrail` always passes ``event_hook=litellm_params.mode``
        (which is ``None`` when the user omits ``mode``). The logger must coerce
        a None ``event_hook`` to ``post_call`` rather than leaving it as None,
        which would otherwise cause the guardrail to run on every event hook."""
        from litellm.types.guardrails import GuardrailEventHooks

        with patch("asyncio.create_task", Mock()):
            handler = RubrikLogger(event_hook=None)
            assert handler.event_hook == GuardrailEventHooks.post_call

    def test_explicit_event_hook_preserved(self, mock_env):
        from litellm.types.guardrails import GuardrailEventHooks

        with patch("asyncio.create_task", Mock()):
            handler = RubrikLogger(event_hook=GuardrailEventHooks.pre_call)
            assert handler.event_hook == GuardrailEventHooks.pre_call

    def test_default_on_defaults_to_false_when_none_passed(self, mock_env):
        """Follows the standard litellm pattern: omitted ``default_on`` resolves
        to ``False`` (off by default). Users must explicitly set
        ``default_on: true`` to enable the guardrail for all requests."""
        with patch("asyncio.create_task", Mock()):
            handler = RubrikLogger(default_on=None)
            assert handler.default_on is False

    def test_explicit_default_on_false_preserved(self, mock_env):
        """A user explicitly setting ``default_on: false`` in their guardrail
        config must NOT be silently overridden to True."""
        with patch("asyncio.create_task", Mock()):
            handler = RubrikLogger(default_on=False)
            assert handler.default_on is False

    def test_explicit_default_on_true_preserved(self, mock_env):
        with patch("asyncio.create_task", Mock()):
            handler = RubrikLogger(default_on=True)
            assert handler.default_on is True

    def test_headers_with_api_key(self, handler):
        assert handler._headers["Authorization"] == "Bearer test-api-key"
        assert handler._headers["Content-Type"] == "application/json"

    def test_headers_without_api_key(self):
        with patch.dict(os.environ, {"RUBRIK_WEBHOOK_URL": "http://host"}, clear=True):
            with patch("asyncio.create_task", Mock()):
                h = RubrikLogger()
                assert "Authorization" not in h._headers


# -- Batch Logging ------------------------------------------------------------


@pytest.mark.asyncio
class TestBatchLogging:
    async def test_log_success_event_appends_to_queue(self, handler):
        kwargs = {
            "standard_logging_object": {
                "messages": [{"role": "user", "content": "hi"}],
                "response": "hello",
            },
        }
        await handler.async_log_success_event(
            kwargs=kwargs, response_obj=None, start_time=None, end_time=None
        )
        assert len(handler.log_queue) == 1

    async def test_log_failure_event_appends_to_queue(self, handler):
        kwargs = {
            "standard_logging_object": {
                "messages": [{"role": "user", "content": "hi"}],
                "response": "error",
            },
        }
        await handler.async_log_failure_event(
            kwargs=kwargs, response_obj=None, start_time=None, end_time=None
        )
        assert len(handler.log_queue) == 1

    async def test_log_success_event_sampling_skips(self, handler):
        handler.sampling_rate = 0.0
        kwargs = {
            "standard_logging_object": {
                "messages": [{"role": "user", "content": "hi"}],
                "response": "hello",
            },
        }
        await handler.async_log_success_event(
            kwargs=kwargs, response_obj=None, start_time=None, end_time=None
        )
        assert len(handler.log_queue) == 0

    async def test_flush_queue_sends_batch(self, handler):
        handler.log_queue = [{"msg": "a"}, {"msg": "b"}]
        mock_response = Mock()
        mock_response.status_code = 200
        handler.async_httpx_client = AsyncMock()
        handler.async_httpx_client.post = AsyncMock(return_value=mock_response)
        await handler.flush_queue()
        handler.async_httpx_client.post.assert_called_once()
        assert len(handler.log_queue) == 0

    async def test_flush_queue_preserves_events_added_during_send(self, handler):
        handler.log_queue = [{"msg": "a"}, {"msg": "b"}]

        async def mock_post(*_args, **_kwargs):
            handler.log_queue.append({"msg": "c"})
            mock_response = Mock()
            mock_response.raise_for_status = Mock()
            return mock_response

        handler.async_httpx_client = AsyncMock()
        handler.async_httpx_client.post = mock_post

        await handler.flush_queue()

        assert handler.log_queue == [{"msg": "c"}]

    async def test_async_send_batch_does_not_drain_events(self, handler):
        handler.log_queue = [{"msg": "a"}, {"msg": "b"}]

        async def mock_post(*_args, **_kwargs):
            handler.log_queue.append({"msg": "c"})
            mock_response = Mock()
            mock_response.raise_for_status = Mock()
            return mock_response

        handler.async_httpx_client = AsyncMock()
        handler.async_httpx_client.post = mock_post

        await handler.async_send_batch()

        assert handler.log_queue == [{"msg": "a"}, {"msg": "b"}, {"msg": "c"}]

    async def test_log_batch_error_does_not_crash_and_preserves_events(self, handler):
        """A failed batch send must not crash the caller AND must preserve the
        original events in the queue so they can be retried on the next flush.
        Previously the events were silently dropped on HTTP 5xx / network errors.
        """
        handler.log_queue = [{"msg": "a"}]
        mock_response = Mock()
        mock_response.status_code = 500
        mock_response.text = "Internal Server Error"
        mock_response.raise_for_status = Mock(
            side_effect=httpx.HTTPStatusError(
                "err", request=Mock(), response=mock_response
            )
        )
        handler.async_httpx_client = AsyncMock()
        handler.async_httpx_client.post = AsyncMock(return_value=mock_response)
        await handler.flush_queue()
        assert handler.log_queue == [{"msg": "a"}]

    async def test_log_batch_network_error_preserves_events(self, handler):
        """Network/timeout errors must also preserve the in-flight events."""
        handler.log_queue = [{"msg": "a"}, {"msg": "b"}]
        handler.async_httpx_client = AsyncMock()
        handler.async_httpx_client.post = AsyncMock(
            side_effect=httpx.TimeoutException("timeout")
        )
        await handler.flush_queue()
        assert handler.log_queue == [{"msg": "a"}, {"msg": "b"}]

    async def test_enqueue_drops_oldest_when_queue_exceeds_max_size(self, handler):
        """A sustained Rubrik webhook outage must not let the in-memory retry
        queue grow without bound. Once max_queue_size is exceeded, the oldest
        events are dropped to make room for new ones."""
        handler.max_queue_size = 3
        handler.batch_size = 10**6  # disable size-triggered flush
        handler.flush_queue = AsyncMock()
        for i in range(5):
            await handler._enqueue_log_event(
                kwargs={
                    "standard_logging_object": {
                        "messages": [{"role": "user", "content": f"hi-{i}"}],
                        "response": "hello",
                    },
                },
                event_type="success",
            )
        assert len(handler.log_queue) == 3
        retained = [item["messages"][0]["content"] for item in handler.log_queue]
        assert retained == ["hi-2", "hi-3", "hi-4"]

    async def test_log_batch_failure_preserves_events_added_during_send(self, handler):
        """Failure must preserve both the snapshot AND events appended mid-flush."""
        handler.log_queue = [{"msg": "a"}, {"msg": "b"}]

        async def mock_post(*_args, **_kwargs):
            handler.log_queue.append({"msg": "c"})
            mock_response = Mock()
            mock_response.status_code = 500
            mock_response.text = "boom"
            mock_response.raise_for_status = Mock(
                side_effect=httpx.HTTPStatusError(
                    "err", request=Mock(), response=mock_response
                )
            )
            return mock_response

        handler.async_httpx_client = AsyncMock()
        handler.async_httpx_client.post = mock_post

        await handler.flush_queue()
        assert handler.log_queue == [{"msg": "a"}, {"msg": "b"}, {"msg": "c"}]

    async def test_system_prompt_prepended_to_messages(self, handler):
        kwargs = {
            "standard_logging_object": {
                "messages": [{"role": "user", "content": "hi"}],
                "response": "hello",
            },
            "system": "You are a helpful assistant.",
        }
        await handler.async_log_success_event(
            kwargs=kwargs, response_obj=None, start_time=None, end_time=None
        )
        assert len(handler.log_queue) == 1
        msgs = handler.log_queue[0]["messages"]
        assert msgs[0]["role"] == "system"
        assert msgs[0]["content"] == "You are a helpful assistant."

    async def test_system_prompt_with_dict_messages(self, handler):
        kwargs = {
            "standard_logging_object": {
                "messages": {"role": "user", "content": "hi"},
                "response": "hello",
            },
            "system": "Be concise.",
        }
        await handler.async_log_success_event(
            kwargs=kwargs, response_obj=None, start_time=None, end_time=None
        )
        assert len(handler.log_queue) == 1
        msgs = handler.log_queue[0]["messages"]
        assert isinstance(msgs, tuple)
        assert msgs[0]["role"] == "system"
        assert msgs[1] == {"role": "user", "content": "hi"}

    async def test_anthropic_id_normalization(self, handler):
        kwargs = {
            "standard_logging_object": {
                "id": "chatcmpl-original",
                "messages": [{"role": "user", "content": "hi"}],
                "response": "hello",
            },
            "litellm_params": {
                "proxy_server_request": {
                    "url": "http://proxy/v1/messages",
                },
            },
            "litellm_call_id": "litellm-call-123",
        }
        await handler.async_log_success_event(
            kwargs=kwargs, response_obj=None, start_time=None, end_time=None
        )
        assert handler.log_queue[0]["id"] == "litellm-call-123"

    async def test_litellm_call_id_always_used_as_correlation_key(self, handler):
        """The merged plugin always uses litellm_call_id as the log ID for all
        providers (not just Anthropic) so that logs correlate with the
        moderation (_blocking) and failure logs for the same request."""
        kwargs = {
            "standard_logging_object": {
                "id": "chatcmpl-original",
                "messages": [{"role": "user", "content": "hi"}],
                "response": "hello",
            },
            "litellm_params": {
                "proxy_server_request": {
                    "url": "http://proxy/v1/chat/completions",
                },
            },
            "litellm_call_id": "litellm-call-123",
        }
        await handler.async_log_success_event(
            kwargs=kwargs, response_obj=None, start_time=None, end_time=None
        )
        assert handler.log_queue[0]["id"] == "litellm-call-123"

    async def test_payload_deep_copied_not_mutated(self, handler):
        """Verify the shared standard_logging_object is not mutated."""
        original_payload = {
            "id": "original-id",
            "messages": [{"role": "user", "content": "hi"}],
            "response": "hello",
        }
        kwargs = {
            "standard_logging_object": original_payload,
            "system": "System prompt.",
        }
        await handler.async_log_success_event(
            kwargs=kwargs, response_obj=None, start_time=None, end_time=None
        )
        # Original payload should NOT have been mutated
        assert original_payload["id"] == "original-id"
        assert len(original_payload["messages"]) == 1


# -- Tool Blocking (apply_guardrail) ------------------------------------------


def _mock_service_response(response_json):
    """Create a mock tool blocking client that returns the given JSON."""

    async def mock_post(*_args, **kwargs):
        mock_resp = Mock()
        mock_resp.json.return_value = response_json
        mock_resp.raise_for_status = Mock()
        return mock_resp

    mock_client = AsyncMock()
    mock_client.post = mock_post
    return mock_client


def _echo_service():
    """Create a mock tool blocking client that echoes the payload back."""

    async def mock_post(*_args, **kwargs):
        mock_resp = Mock()
        mock_resp.json.return_value = kwargs.get("json", {}).get("response", {})
        mock_resp.raise_for_status = Mock()
        return mock_resp

    mock_client = AsyncMock()
    mock_client.post = mock_post
    return mock_client


@pytest.mark.asyncio
class TestApplyGuardrail:
    async def test_skips_requests(self, handler):
        inputs = make_inputs_with_tools([make_tool_call_dict("call_1", "test_tool")])
        result = await handler.apply_guardrail(
            inputs=inputs, request_data={}, input_type="request"
        )
        assert result is inputs

    async def test_no_tool_calls(self, handler):
        from litellm.types.utils import GenericGuardrailAPIInputs

        inputs = GenericGuardrailAPIInputs(texts=["hello"])
        result = await handler.apply_guardrail(
            inputs=inputs, request_data={}, input_type="response"
        )
        assert result is inputs

    async def test_all_allowed(self, handler):
        tc1 = make_tool_call_dict("call_1", "get_weather")
        tc2 = make_tool_call_dict("call_2", "get_time")
        inputs = make_inputs_with_tools([tc1, tc2])

        handler.moderation_client = _echo_service()

        result = await handler.apply_guardrail(
            inputs=inputs, request_data={}, input_type="response"
        )
        assert result is inputs

    async def test_all_blocked(self, handler):
        tc1 = make_tool_call_dict("call_1", "delete_table")
        tc2 = make_tool_call_dict("call_2", "drop_database")
        inputs = make_inputs_with_tools([tc1, tc2])

        handler.moderation_client = _mock_service_response(
            {
                "choices": [
                    {
                        "message": {
                            "role": "assistant",
                            "content": "Tool blocked by policy",
                            "tool_calls": [],
                        }
                    }
                ],
            }
        )

        with pytest.raises(ModifyResponseException) as exc_info:
            await handler.apply_guardrail(
                inputs=inputs, request_data={}, input_type="response"
            )
        assert "Tool blocked by policy" in exc_info.value.message

    async def test_partial_blocking(self, handler):
        tc_blocked = make_tool_call_dict("call_A", "blocked_tool")
        tc_allowed = make_tool_call_dict("call_B", "allowed_tool")
        inputs = make_inputs_with_tools([tc_blocked, tc_allowed])

        async def mock_post(*_args, **kwargs):
            payload = kwargs.get("json", {}).get("response", {})
            all_tcs = payload["choices"][0]["message"]["tool_calls"]
            allowed = [tc for tc in all_tcs if tc.get("id") == "call_B"]
            mock_resp = Mock()
            mock_resp.json.return_value = {
                "choices": [
                    {
                        "message": {
                            "role": "assistant",
                            "content": "blocked",
                            "tool_calls": allowed,
                        }
                    }
                ],
            }
            mock_resp.raise_for_status = Mock()
            return mock_resp

        mock_client = AsyncMock()
        mock_client.post = mock_post
        handler.moderation_client = mock_client

        with pytest.raises(ModifyResponseException):
            await handler.apply_guardrail(
                inputs=inputs, request_data={}, input_type="response"
            )

    async def test_service_failure_fail_open(self, handler):
        tc1 = make_tool_call_dict("call_1", "test_tool")
        inputs = make_inputs_with_tools([tc1])

        mock_client = AsyncMock()
        mock_client.post = AsyncMock(side_effect=httpx.TimeoutException("Timeout"))
        handler.moderation_client = mock_client

        result = await handler.apply_guardrail(
            inputs=inputs, request_data={}, input_type="response"
        )
        assert result is inputs

    async def test_service_empty_choices_fail_open(self, handler):
        tc1 = make_tool_call_dict("call_1", "test_tool")
        inputs = make_inputs_with_tools([tc1])

        handler.moderation_client = _mock_service_response({"choices": []})

        result = await handler.apply_guardrail(
            inputs=inputs, request_data={}, input_type="response"
        )
        assert result is inputs

    async def test_blocking_service_payload_format(self, handler):
        tc1 = make_tool_call_dict("call_1", "get_weather", '{"location": "SF"}')
        tc2 = make_tool_call_dict("call_2", "send_email", '{"to": "user@example.com"}')
        inputs = make_inputs_with_tools([tc1, tc2])

        captured_payload: Dict[str, Any] = {}

        async def mock_post(*_args, **kwargs):
            captured_payload.update(kwargs.get("json", {}))
            mock_resp = Mock()
            mock_resp.json.return_value = captured_payload.get("response", {})
            mock_resp.raise_for_status = Mock()
            return mock_resp

        mock_client = AsyncMock()
        mock_client.post = mock_post
        handler.moderation_client = mock_client

        await handler.apply_guardrail(
            inputs=inputs, request_data={}, input_type="response"
        )

        # Verify envelope structure
        assert "request" in captured_payload
        assert "response" in captured_payload

        response_data = captured_payload["response"]
        message = response_data["choices"][0]["message"]
        assert message["role"] == "assistant"
        assert len(message["tool_calls"]) == 2
        assert message["tool_calls"][0]["id"] == "call_1"
        assert message["tool_calls"][0]["function"]["name"] == "get_weather"
        assert message["tool_calls"][1]["id"] == "call_2"
        assert message["tool_calls"][1]["function"]["name"] == "send_email"

    async def test_request_data_included_in_envelope(self, handler):
        tc = make_tool_call_dict("call_1", "test_tool")
        inputs = make_inputs_with_tools([tc])

        captured_payload: Dict[str, Any] = {}

        async def mock_post(*_args, **kwargs):
            captured_payload.update(kwargs.get("json", {}))
            mock_resp = Mock()
            mock_resp.json.return_value = captured_payload.get("response", {})
            mock_resp.raise_for_status = Mock()
            return mock_resp

        mock_client = AsyncMock()
        mock_client.post = mock_post
        handler.moderation_client = mock_client

        logging_obj = Mock()
        logging_obj.model_call_details = {
            "messages": [{"role": "user", "content": "hi"}],
            "model": "gpt-4",
            "litellm_params": {
                "proxy_server_request": {"url": "/chat/completions"},
            },
        }

        await handler.apply_guardrail(
            inputs=inputs,
            request_data={},
            input_type="response",
            logging_obj=logging_obj,
        )

        req = captured_payload["request"]
        assert req["model"] == "gpt-4"
        assert req["messages"] == [{"role": "user", "content": "hi"}]

    async def test_proxy_server_request_not_forwarded(self, handler):
        """proxy_server_request is intentionally NOT included in the request
        envelope: in litellm >=1.83 its ``body`` carries a UserAPIKeyAuth
        instance that breaks json.dumps, silently fail-opening the guardrail."""
        tc = make_tool_call_dict("call_1", "test_tool")
        inputs = make_inputs_with_tools([tc])

        captured_payload: Dict[str, Any] = {}

        async def mock_post(*_args, **kwargs):
            captured_payload.update(kwargs.get("json", {}))
            mock_resp = Mock()
            mock_resp.json.return_value = captured_payload.get("response", {})
            mock_resp.raise_for_status = Mock()
            return mock_resp

        mock_client = AsyncMock()
        mock_client.post = mock_post
        handler.moderation_client = mock_client

        logging_obj = Mock()
        logging_obj.model_call_details = {
            "messages": [{"role": "user", "content": "hi"}],
            "model": "gpt-4",
            "litellm_params": {
                "proxy_server_request": {
                    "url": "/chat/completions",
                    "method": "POST",
                    "headers": {
                        "authorization": "Bearer sk-litellm-secret",
                        "cookie": "session=abc",
                        "x-api-key": "leaked-key",
                    },
                    "body": {"api_key": "sk-upstream-secret"},
                },
            },
        }

        await handler.apply_guardrail(
            inputs=inputs,
            request_data={},
            input_type="response",
            logging_obj=logging_obj,
        )

        # proxy_server_request is deliberately excluded from the forwarded envelope
        assert "proxy_server_request" not in captured_payload["request"]


# -- Anthropic format ----------------------------------------------------------


@pytest.mark.asyncio
class TestApplyGuardrailAnthropicFormat:
    """Verify blocking works correctly regardless of original provider format.

    The framework converts Anthropic tool_use blocks to OpenAI-format
    tool_calls before calling apply_guardrail.
    """

    async def test_single_tool_allowed(self, handler):
        tc = make_tool_call_dict(
            "toolu_123", "get_weather", '{"location": "Portland, OR"}'
        )
        inputs = make_inputs_with_tools([tc], texts=["I'll check the weather."])

        handler.moderation_client = _echo_service()

        result = await handler.apply_guardrail(
            inputs=inputs, request_data={}, input_type="response"
        )
        assert result is inputs

    async def test_single_tool_blocked(self, handler):
        tc = make_tool_call_dict("toolu_123", "dangerous_tool", '{"arg": "value"}')
        inputs = make_inputs_with_tools([tc])

        handler.moderation_client = _mock_service_response(
            {
                "choices": [
                    {
                        "message": {
                            "role": "assistant",
                            "content": "blocked",
                            "tool_calls": [],
                        }
                    }
                ],
            }
        )

        with pytest.raises(ModifyResponseException):
            await handler.apply_guardrail(
                inputs=inputs, request_data={}, input_type="response"
            )

    async def test_text_only_response_sent_to_moderation(self, handler):
        """Text-only responses (no tool calls) are sent to the response
        moderation service to check the assistant's text content."""
        from litellm.types.utils import GenericGuardrailAPIInputs

        inputs = GenericGuardrailAPIInputs(texts=["Hello! I'm Claude."])

        # Service allows the response (returns the content unchanged)
        handler.moderation_client = _echo_service()

        result = await handler.apply_guardrail(
            inputs=inputs, request_data={}, input_type="response"
        )

        assert result is inputs

    async def test_service_failure_preserves_tools(self, handler):
        tc = make_tool_call_dict("toolu_123", "get_weather", '{"location": "SF"}')
        inputs = make_inputs_with_tools([tc])

        mock_client = AsyncMock()
        mock_client.post = AsyncMock(side_effect=httpx.TimeoutException("Timeout"))
        handler.moderation_client = mock_client

        result = await handler.apply_guardrail(
            inputs=inputs, request_data={}, input_type="response"
        )
        assert result is inputs


# -- Normalize tool calls ------------------------------------------------------


class TestNormalizeToolCalls:
    def test_dict_input(self):
        tc = make_tool_call_dict("call_1", "test", '{"a": 1}')
        result = RubrikLogger._normalize_tool_calls([tc])
        assert len(result) == 1
        assert result[0].id == "call_1"
        assert result[0].function.name == "test"
        assert result[0].function.arguments == '{"a": 1}'

    def test_typed_object_input(self):
        from litellm.types.utils import ChatCompletionMessageToolCall, Function

        tc = ChatCompletionMessageToolCall(
            id="call_2",
            type="function",
            function=Function(name="fn", arguments="{}"),
        )
        result = RubrikLogger._normalize_tool_calls([tc])
        assert len(result) == 1
        assert result[0].id == "call_2"
        assert result[0].function.name == "fn"

    def test_unsupported_type_raises(self):
        with pytest.raises(TypeError, match="Cannot normalize"):
            RubrikLogger._normalize_tool_calls(["not_a_tool_call"])


# -- Extract response block ----------------------------------------------------


class TestExtractResponseBlock:
    """Tests for _extract_response_block, which replaces the upstream
    _extract_blocked_tools and handles both text blocks and tool blocks."""

    def test_all_allowed_returns_none(self):
        from litellm.types.utils import ChatCompletionMessageToolCall, Function

        tc = ChatCompletionMessageToolCall(
            id="call_1", type="function", function=Function(name="fn", arguments="{}")
        )
        service_resp = {
            "choices": [
                {
                    "message": {
                        "tool_calls": [{"id": "call_1"}],
                        "content": "",
                    }
                }
            ]
        }
        result = RubrikLogger._extract_response_block(service_resp, [tc], "")
        assert result is None

    def test_some_blocked_returns_explanation(self):
        from litellm.types.utils import ChatCompletionMessageToolCall, Function

        tc1 = ChatCompletionMessageToolCall(
            id="call_1",
            type="function",
            function=Function(name="fn1", arguments="{}"),
        )
        tc2 = ChatCompletionMessageToolCall(
            id="call_2",
            type="function",
            function=Function(name="fn2", arguments="{}"),
        )
        service_resp = {
            "choices": [
                {
                    "message": {
                        "tool_calls": [{"id": "call_1"}],
                        "content": "blocked fn2",
                    }
                }
            ]
        }
        result = RubrikLogger._extract_response_block(service_resp, [tc1, tc2], "")
        assert result is not None
        assert "blocked fn2" in result.explanation

    def test_empty_choices_raises(self):
        with pytest.raises(_MalformedToolBlockingResponseError):
            RubrikLogger._extract_response_block({"choices": []}, [], "")

    def test_null_tool_calls_treated_as_all_blocked(self):
        from litellm.types.utils import ChatCompletionMessageToolCall, Function

        tc = ChatCompletionMessageToolCall(
            id="call_1", type="function", function=Function(name="fn", arguments="{}")
        )
        service_resp = {
            "choices": [
                {
                    "message": {
                        "tool_calls": None,
                        "content": "blocked everything",
                    }
                }
            ]
        }
        result = RubrikLogger._extract_response_block(service_resp, [tc], "")
        assert result is not None
        assert "blocked everything" in result.explanation

    def test_text_block_detected(self):
        """When the service replaces the response text wholesale, it's a text block."""
        from litellm.types.utils import ChatCompletionMessageToolCall, Function

        service_resp = {
            "choices": [
                {
                    "message": {
                        "tool_calls": [],
                        "content": "This content violates policy.",
                    }
                }
            ]
        }
        result = RubrikLogger._extract_response_block(
            service_resp, [], "Original assistant text."
        )
        assert result is not None
        assert "violates policy" in result.explanation

    def test_tool_block_with_appended_explanation(self):
        """When the service appends an explanation to the original text, only the
        appended part is returned as the explanation."""
        from litellm.types.utils import ChatCompletionMessageToolCall, Function

        tc = ChatCompletionMessageToolCall(
            id="call_1", type="function", function=Function(name="fn", arguments="{}")
        )
        original_text = "Here is my response."
        appended_explanation = "Tool call was blocked."
        service_resp = {
            "choices": [
                {
                    "message": {
                        "tool_calls": [],
                        "content": original_text + "\n\n" + appended_explanation,
                    }
                }
            ]
        }
        result = RubrikLogger._extract_response_block(
            service_resp, [tc], original_text
        )
        assert result is not None
        assert appended_explanation in result.explanation


# -- Sanitize proxy server request -------------------------------------------


class TestSanitizeProxyServerRequest:
    def test_drops_headers_and_body(self):
        proxy_request = {
            "url": "/chat/completions",
            "method": "POST",
            "headers": {
                "authorization": "Bearer sk-litellm-secret",
                "cookie": "session=abc",
                "content-type": "application/json",
            },
            "body": {"api_key": "sk-upstream-secret", "model": "gpt-4"},
        }
        result = RubrikLogger._sanitize_proxy_server_request(proxy_request)
        assert result == {"url": "/chat/completions", "method": "POST"}

    def test_none_passthrough(self):
        assert RubrikLogger._sanitize_proxy_server_request(None) is None

    def test_non_dict_passthrough(self):
        assert RubrikLogger._sanitize_proxy_server_request("not a dict") == "not a dict"

    def test_partial_dict(self):
        result = RubrikLogger._sanitize_proxy_server_request({"url": "/v1/messages"})
        assert result == {"url": "/v1/messages"}


# -- Resolve model -------------------------------------------------------------


class TestResolveModel:
    def test_model_from_response(self):
        from unittest.mock import Mock

        response = Mock()
        response.model = "gpt-4"
        result = RubrikLogger._resolve_model({"response": response}, {})
        assert result == "gpt-4"

    def test_model_from_call_details(self):
        result = RubrikLogger._resolve_model({}, {"model": "claude-3"})
        assert result == "claude-3"

    def test_fallback_to_unknown(self):
        result = RubrikLogger._resolve_model({}, {})
        assert result == "unknown"

    def test_empty_model_on_response_returns_unknown(self):
        from unittest.mock import Mock

        response = Mock()
        response.model = ""
        result = RubrikLogger._resolve_model(
            {"response": response}, {"model": "fallback"}
        )
        assert result == "unknown"


# -- Additional Initialization edge cases ------------------------------------


class TestInitializationEdgeCases:
    def test_batch_size_zero_uses_default(self):
        """RUBRIK_BATCH_SIZE=0 must warn and fall back to the default."""
        with patch("asyncio.create_task", Mock()):
            with patch.dict(
                os.environ,
                {"RUBRIK_WEBHOOK_URL": "http://host", "RUBRIK_BATCH_SIZE": "0"},
            ):
                h = RubrikLogger()
                # Should use default, not 0
                assert h.batch_size > 0

    def test_batch_size_negative_uses_default(self):
        """RUBRIK_BATCH_SIZE=-1 must warn and fall back to the default."""
        with patch("asyncio.create_task", Mock()):
            with patch.dict(
                os.environ,
                {"RUBRIK_WEBHOOK_URL": "http://host", "RUBRIK_BATCH_SIZE": "-5"},
            ):
                h = RubrikLogger()
                assert h.batch_size > 0


# -- aclose() -----------------------------------------------------------------


@pytest.mark.asyncio
class TestAclose:
    async def test_aclose_cancels_task_does_not_close_shared_client(self, mock_env):
        """aclose() cancels the periodic flush task but does NOT close the shared
        moderation_client — closing a shared cached client would break other
        RubrikLogger instances that share the same connection pool."""
        with patch("asyncio.create_task", Mock()):
            handler = RubrikLogger()

        mock_task = Mock()
        mock_task.cancel = Mock()
        handler._periodic_flush_task = mock_task

        handler.moderation_client = AsyncMock()
        handler.moderation_client.close = AsyncMock()

        await handler.aclose()

        mock_task.cancel.assert_called_once()
        handler.moderation_client.close.assert_not_awaited()

    async def test_aclose_with_none_task_does_not_close_client(self, mock_env):
        """aclose() with no flush task still does not close the shared client."""
        with patch("asyncio.create_task", Mock()):
            handler = RubrikLogger()

        handler._periodic_flush_task = None
        handler.moderation_client = AsyncMock()
        handler.moderation_client.close = AsyncMock()

        await handler.aclose()

        handler.moderation_client.close.assert_not_awaited()


# -- apply_guardrail edge cases -----------------------------------------------


@pytest.mark.asyncio
class TestApplyGuardrailEdgeCases:
    async def test_unknown_input_type_returns_inputs_unchanged(self, handler):
        """When input_type is not 'request' or 'response', inputs are returned as-is."""
        inputs = make_inputs_with_tools([make_tool_call_dict("call_1", "tool")])
        result = await handler.apply_guardrail(
            inputs=inputs, request_data={}, input_type="unknown"
        )
        assert result is inputs

    async def test_response_with_no_texts_and_no_tool_calls_returns_inputs(self, handler):
        """_moderate_response early-returns when both texts and tool_calls are empty."""
        from litellm.types.utils import GenericGuardrailAPIInputs

        inputs = GenericGuardrailAPIInputs()
        result = await handler.apply_guardrail(
            inputs=inputs, request_data={}, input_type="response"
        )
        assert result is inputs

    async def test_moderate_response_empty_call_details_emits_warning(self, handler):
        """When logging_obj is present but model_call_details is empty, a warning is
        logged and moderation proceeds (fail-open on HTTP error)."""
        tc = make_tool_call_dict("call_1", "test_tool")
        inputs = make_inputs_with_tools([tc])

        logging_obj = Mock()
        logging_obj.model_call_details = {}

        handler.moderation_client = _echo_service()

        result = await handler.apply_guardrail(
            inputs=inputs,
            request_data={},
            input_type="response",
            logging_obj=logging_obj,
        )
        assert result is inputs


# -- Prompt moderation --------------------------------------------------------


@pytest.mark.asyncio
class TestPromptModeration:
    async def test_prompt_moderation_passthrough(self, handler):
        """Webhook returns {} (empty dict) → inputs returned unchanged."""
        inputs = {"structured_messages": [{"role": "user", "content": "Hello"}]}

        handler.moderation_client = _mock_service_response({})

        result = await handler.apply_guardrail(
            inputs=inputs, request_data={}, input_type="request"
        )
        assert result is inputs

    async def test_prompt_moderation_blocked_raises(self, handler):
        """Webhook returns synthetic chat.completion → raises ModifyResponseException."""
        inputs = {
            "structured_messages": [{"role": "user", "content": "Harmful prompt"}],
            "model": "gpt-4",
        }

        handler.moderation_client = _mock_service_response(
            {
                "choices": [
                    {
                        "message": {
                            "role": "assistant",
                            "content": "This request violates our policy.",
                        }
                    }
                ]
            }
        )

        with pytest.raises(ModifyResponseException) as exc_info:
            await handler.apply_guardrail(
                inputs=inputs, request_data={"model": "gpt-4"}, input_type="request"
            )
        assert "violates our policy" in exc_info.value.message

    async def test_prompt_moderation_no_messages_skips_moderation(self, handler):
        """When structured_messages is absent/empty, moderation is skipped."""
        inputs = {"model": "gpt-4"}

        result = await handler.apply_guardrail(
            inputs=inputs, request_data={}, input_type="request"
        )
        assert result is inputs

    async def test_prompt_moderation_stashes_logging_obj_on_block(self, handler):
        """On a prompt block, _stash_block_context must set the blocked flag."""
        inputs = {
            "structured_messages": [{"role": "user", "content": "bad prompt"}],
        }

        handler.moderation_client = _mock_service_response(
            {
                "choices": [
                    {"message": {"role": "assistant", "content": "Blocked."}}
                ]
            }
        )

        logging_obj = Mock()
        logging_obj.model_call_details = {}
        request_data: dict = {}

        with pytest.raises(ModifyResponseException):
            await handler.apply_guardrail(
                inputs=inputs,
                request_data=request_data,
                input_type="request",
                logging_obj=logging_obj,
            )

        assert logging_obj.model_call_details.get("_rubrik_blocked") is True
        assert request_data.get("_rubrik_logging_obj") is logging_obj


# -- _stash_block_context -----------------------------------------------------


class TestStashBlockContext:
    def test_with_non_none_logging_obj_sets_flag_and_stashes(self):
        """Sets _rubrik_blocked flag and stores logging_obj on request_data."""
        logging_obj = Mock()
        logging_obj.model_call_details = {}
        request_data: dict = {}

        RubrikLogger._stash_block_context(logging_obj, request_data)

        assert logging_obj.model_call_details["_rubrik_blocked"] is True
        assert request_data["_rubrik_logging_obj"] is logging_obj

    def test_with_none_logging_obj_stores_none_on_request_data(self):
        """When logging_obj is None, stores None on request_data (logged as error)."""
        request_data: dict = {"litellm_call_id": "test-id"}

        RubrikLogger._stash_block_context(None, request_data)

        assert request_data["_rubrik_logging_obj"] is None


# -- _normalize_tool_calls duck-typed -----------------------------------------


class TestNormalizeToolCallsDuckTyped:
    def test_duck_typed_object_with_id_and_function_attrs(self):
        """Objects that have .id and .function attrs but are not
        ChatCompletionMessageToolCall are handled by the third branch."""
        from litellm.types.utils import Function

        tc = Mock()
        tc.id = "call_duck"
        tc.type = "function"
        tc.function = Function(name="duck_tool", arguments='{"x": 1}')
        # Make isinstance(..., ChatCompletionMessageToolCall) return False
        # by using a plain Mock (not a ChatCompletionMessageToolCall subclass)

        result = RubrikLogger._normalize_tool_calls([tc])
        assert len(result) == 1
        assert result[0].id == "call_duck"
        assert result[0].function.name == "duck_tool"

    def test_duck_typed_without_type_defaults_to_function(self):
        """getattr(tc, "type", None) falls back to "function" when absent."""
        from litellm.types.utils import Function

        tc = Mock(spec=["id", "function"])  # no .type attr
        tc.id = "call_no_type"
        tc.function = Function(name="fn", arguments="{}")

        result = RubrikLogger._normalize_tool_calls([tc])
        assert result[0].type == "function"


# -- _flatten_messages_for_moderation -----------------------------------------


class TestFlattenMessagesForModeration:
    def test_plain_string_content_preserved(self):
        messages = [{"role": "user", "content": "Hello world"}]
        result = RubrikLogger._flatten_messages_for_moderation(messages)
        assert len(result) == 1
        assert result[0]["role"] == "user"
        assert result[0]["content"] == "Hello world"

    def test_content_list_flattened_to_string(self):
        """Content as a list of parts (e.g. Anthropic multi-part) is flattened."""
        messages = [
            {
                "role": "user",
                "content": [
                    {"type": "text", "text": "Hello from parts"},
                ],
            }
        ]
        result = RubrikLogger._flatten_messages_for_moderation(messages)
        assert len(result) == 1
        assert result[0]["role"] == "user"
        assert "Hello from parts" in result[0]["content"]

    def test_non_dict_messages_skipped(self):
        """Non-dict entries in the messages list are silently skipped."""
        messages = [
            "raw string message",
            {"role": "user", "content": "valid"},
        ]
        result = RubrikLogger._flatten_messages_for_moderation(messages)
        assert len(result) == 1
        assert result[0]["content"] == "valid"

    def test_none_messages_returns_empty(self):
        result = RubrikLogger._flatten_messages_for_moderation(None)
        assert result == ()

    def test_multiple_messages_preserved_in_order(self):
        messages = [
            {"role": "system", "content": "You are helpful."},
            {"role": "user", "content": "Question?"},
        ]
        result = RubrikLogger._flatten_messages_for_moderation(messages)
        assert len(result) == 2
        assert result[0]["role"] == "system"
        assert result[1]["role"] == "user"


# -- _build_prompt_moderation_payload -----------------------------------------


class TestBuildPromptModerationPayload:
    def test_payload_includes_tools_when_present(self):
        inputs = {
            "model": "gpt-4",
            "structured_messages": [{"role": "user", "content": "hi"}],
            "tools": [{"type": "function", "function": {"name": "fn"}}],
        }
        payload = RubrikLogger._build_prompt_moderation_payload(inputs, {})
        assert payload["tools"] == [{"type": "function", "function": {"name": "fn"}}]

    def test_payload_includes_user_when_present(self):
        inputs = {
            "structured_messages": [{"role": "user", "content": "hi"}],
        }
        request_data = {"user": "alice"}
        payload = RubrikLogger._build_prompt_moderation_payload(inputs, request_data)
        assert payload["user"] == "alice"

    def test_payload_uses_explicit_correlation_key(self):
        inputs = {"structured_messages": [{"role": "user", "content": "hi"}]}
        request_data = {
            "correlation_key": "corr-123",
            "litellm_call_id": "litellm-456",
        }
        payload = RubrikLogger._build_prompt_moderation_payload(inputs, request_data)
        assert payload["correlation_key"] == "corr-123"

    def test_payload_falls_back_to_litellm_call_id(self):
        """When correlation_key is absent, litellm_call_id is used."""
        inputs = {"structured_messages": [{"role": "user", "content": "hi"}]}
        request_data = {"litellm_call_id": "litellm-789"}
        payload = RubrikLogger._build_prompt_moderation_payload(inputs, request_data)
        assert payload["correlation_key"] == "litellm-789"

    def test_payload_omits_optional_fields_when_absent(self):
        inputs = {"structured_messages": [{"role": "user", "content": "hi"}]}
        payload = RubrikLogger._build_prompt_moderation_payload(inputs, {})
        assert "tools" not in payload
        assert "user" not in payload
        assert "correlation_key" not in payload


# -- _extract_request_data tools preference -----------------------------------


class TestExtractRequestDataToolsPreference:
    def test_prefers_tools_from_request_data_over_optional_params(self):
        """When 'tools' key exists in request_data, it wins over optional_params."""
        call_details = {
            "messages": [{"role": "user", "content": "hi"}],
            "model": "gpt-4",
            "optional_params": {
                "tools": [{"type": "function", "function": {"name": "from_optional"}}]
            },
        }
        request_data = {
            "tools": [{"type": "function", "function": {"name": "from_request"}}]
        }
        result = RubrikLogger._extract_request_data(call_details, request_data)
        assert result["tools"] == [
            {"type": "function", "function": {"name": "from_request"}}
        ]

    def test_falls_back_to_optional_params_when_not_in_request_data(self):
        call_details = {
            "optional_params": {
                "tools": [{"type": "function", "function": {"name": "from_optional"}}]
            }
        }
        result = RubrikLogger._extract_request_data(call_details, {})
        assert result["tools"] == [
            {"type": "function", "function": {"name": "from_optional"}}
        ]

    def test_explicit_empty_list_in_request_data_is_forwarded(self):
        """An explicit empty tools list signals 'no tools' to the moderation service."""
        call_details = {
            "optional_params": {
                "tools": [{"type": "function", "function": {"name": "from_optional"}}]
            }
        }
        request_data = {"tools": []}
        result = RubrikLogger._extract_request_data(call_details, request_data)
        assert result["tools"] == []


# -- _extract_prompt_refusal --------------------------------------------------


class TestExtractPromptRefusal:
    def test_passthrough_response_returns_none(self):
        """Empty dict (passthrough) → None."""
        assert RubrikLogger._extract_prompt_refusal({}) is None

    def test_no_choices_returns_none(self):
        assert RubrikLogger._extract_prompt_refusal({"choices": []}) is None

    def test_block_response_returns_content(self):
        service_response = {
            "choices": [{"message": {"content": "Request blocked by Rubrik."}}]
        }
        result = RubrikLogger._extract_prompt_refusal(service_response)
        assert result == "Request blocked by Rubrik."

    def test_empty_content_falls_back_to_default_message(self):
        """When content is empty string or falsy, falls back to default refusal."""
        service_response = {"choices": [{"message": {"content": ""}}]}
        result = RubrikLogger._extract_prompt_refusal(service_response)
        assert result == "Request blocked by policy."

    def test_none_content_falls_back_to_default_message(self):
        service_response = {"choices": [{"message": {"content": None}}]}
        result = RubrikLogger._extract_prompt_refusal(service_response)
        assert result == "Request blocked by policy."


# -- _prepend_system_prompt exception path ------------------------------------


class TestPrependSystemPromptException:
    def test_exception_during_unpack_is_caught_and_logged(self):
        """When an exception is raised inside _prepend_system_prompt, it is swallowed."""

        class ExplodingList(list):
            def __iter__(self):
                raise RuntimeError("iteration error!")

        payload = {"messages": ExplodingList()}
        source = {"system": "You are an assistant."}

        # Must not raise
        RubrikLogger._prepend_system_prompt(payload, source)


# -- _append_and_maybe_flush batch trigger ------------------------------------


@pytest.mark.asyncio
class TestAppendAndMaybeFlush:
    async def test_flush_triggered_when_queue_reaches_batch_size(self, handler):
        """flush_queue is called when the queue length reaches batch_size."""
        handler.batch_size = 2
        handler.flush_queue = AsyncMock()

        await handler._append_and_maybe_flush({"msg": "a"})
        handler.flush_queue.assert_not_called()

        await handler._append_and_maybe_flush({"msg": "b"})
        handler.flush_queue.assert_called_once()

    async def test_no_flush_before_batch_size(self, handler):
        handler.batch_size = 5
        handler.flush_queue = AsyncMock()

        for i in range(4):
            await handler._append_and_maybe_flush({"msg": str(i)})

        handler.flush_queue.assert_not_called()


# -- _enqueue_log_event exception handling ------------------------------------


@pytest.mark.asyncio
class TestEnqueueLogEventExceptions:
    async def test_exception_from_prepare_log_payload_is_caught(self, handler):
        """Exceptions raised by _prepare_log_payload are caught and logged."""
        handler._prepare_log_payload = AsyncMock(
            side_effect=RuntimeError("payload error")
        )

        # Must not raise
        await handler._enqueue_log_event(
            {"standard_logging_object": {"messages": [], "response": ""}}, "test"
        )
        assert len(handler.log_queue) == 0


# -- async_log_success_event skip when _rubrik_blocked ------------------------


@pytest.mark.asyncio
class TestSuccessEventBlockedSkip:
    async def test_skips_enqueue_when_rubrik_blocked_flag_set(self, handler):
        """When kwargs['_rubrik_blocked'] is True, the event is not enqueued."""
        kwargs = {
            "_rubrik_blocked": True,
            "litellm_call_id": "blocked-call-123",
            "standard_logging_object": {
                "messages": [{"role": "user", "content": "hi"}],
                "response": "hello",
            },
        }
        await handler.async_log_success_event(
            kwargs=kwargs, response_obj=None, start_time=None, end_time=None
        )
        assert len(handler.log_queue) == 0


# -- async_post_call_failure_hook ---------------------------------------------


@pytest.mark.asyncio
class TestPostCallFailureHook:
    async def test_non_modify_exception_returns_immediately(self, handler, user_api_key_dict):
        """Non-ModifyResponseException causes a no-op."""
        await handler.async_post_call_failure_hook(
            request_data={"litellm_call_id": "test"},
            original_exception=ValueError("unrelated error"),
            user_api_key_dict=user_api_key_dict,
        )
        assert len(handler.log_queue) == 0

    async def test_modify_exception_without_stashed_logging_obj_emits_warning(
        self, handler, user_api_key_dict
    ):
        """ModifyResponseException with no _rubrik_logging_obj → warning, no enqueue."""
        request_data = {"litellm_call_id": "test-123", "model": "gpt-4"}
        exc = ModifyResponseException(
            message="blocked",
            model="gpt-4",
            request_data=request_data,
            guardrail_name="rubrik",
        )

        await handler.async_post_call_failure_hook(
            request_data=request_data,
            original_exception=exc,
            user_api_key_dict=user_api_key_dict,
        )
        assert len(handler.log_queue) == 0

    async def test_modify_exception_with_valid_logging_obj_enqueues_payload(
        self, handler, user_api_key_dict
    ):
        """ModifyResponseException + stashed logging_obj → builds and enqueues."""
        logging_obj = Mock()
        logging_obj.model_call_details = {
            "litellm_call_id": "call-abc",
            "model": "gpt-4",
            "messages": [{"role": "user", "content": "hi"}],
            "standard_logging_object": {
                "id": "chatcmpl-original",
                "model": "gpt-4",
                "response": "original",
                "messages": [{"role": "user", "content": "hi"}],
            },
            "metadata": {},
        }

        request_data = {"_rubrik_logging_obj": logging_obj}
        exc = ModifyResponseException(
            message="blocked by policy",
            model="gpt-4",
            request_data=request_data,
            guardrail_name="rubrik",
        )

        handler.batch_size = 10**6  # disable auto-flush
        await handler.async_post_call_failure_hook(
            request_data=request_data,
            original_exception=exc,
            user_api_key_dict=user_api_key_dict,
        )
        assert len(handler.log_queue) == 1
        assert "ModifyResponseException" in handler.log_queue[0]["response"]

    async def test_logging_obj_popped_from_request_data(self, handler, user_api_key_dict):
        """_rubrik_logging_obj must be popped from request_data so it is not
        forwarded downstream."""
        logging_obj = Mock()
        logging_obj.model_call_details = {
            "litellm_call_id": "call-pop",
            "model": "gpt-4",
            "messages": [],
            "standard_logging_object": {
                "id": "chatcmpl-pop",
                "model": "gpt-4",
                "response": "text",
                "messages": [],
            },
            "metadata": {},
        }

        request_data = {"_rubrik_logging_obj": logging_obj}
        exc = ModifyResponseException(
            message="popped",
            model="gpt-4",
            request_data=request_data,
            guardrail_name="rubrik",
        )

        handler.batch_size = 10**6
        await handler.async_post_call_failure_hook(
            request_data=request_data,
            original_exception=exc,
            user_api_key_dict=user_api_key_dict,
        )
        assert "_rubrik_logging_obj" not in request_data

    async def test_build_and_enqueue_swallows_attribute_error_from_prepare_payload(
        self, handler, user_api_key_dict
    ):
        """When _prepare_block_failure_payload raises AttributeError/KeyError/TypeError,
        the error is logged and the event is silently dropped (lines 806-812)."""
        logging_obj = Mock()
        # Make model_call_details.get() raise TypeError
        logging_obj.model_call_details = None  # .get() will raise AttributeError

        exc = ModifyResponseException(
            message="blocked",
            model="gpt-4",
            request_data={},
            guardrail_name="rubrik",
        )

        # Must not raise
        await handler._build_and_enqueue_block_event(logging_obj, exc, None, user_api_key_dict)
        assert len(handler.log_queue) == 0

    async def test_build_and_enqueue_swallows_flush_exception(self, handler, user_api_key_dict):
        """When _append_and_maybe_flush raises, the error is logged (lines 816-817)."""
        logging_obj = Mock()
        logging_obj.model_call_details = {
            "litellm_call_id": "call-flush-err",
            "model": "gpt-4",
            "messages": [],
            "standard_logging_object": {
                "id": "id-flush-err",
                "model": "gpt-4",
                "response": "text",
                "messages": [],
            },
            "metadata": {},
        }

        exc = ModifyResponseException(
            message="blocked",
            model="gpt-4",
            request_data={},
            guardrail_name="rubrik",
        )

        handler._append_and_maybe_flush = AsyncMock(
            side_effect=RuntimeError("flush failed")
        )

        # Must not raise
        await handler._build_and_enqueue_block_event(logging_obj, exc, None, user_api_key_dict)


# -- _prepare_block_failure_payload and _build_fallback_payload ---------------


class TestPrepareBlockFailurePayload:
    def test_uses_standard_logging_object_when_present(self, handler, user_api_key_dict):
        """When standard_logging_object is on model_call_details, it is used as base."""
        logging_obj = Mock()
        logging_obj.model_call_details = {
            "litellm_call_id": "call-slo",
            "model": "gpt-4",
            "standard_logging_object": {
                "id": "chatcmpl-original",
                "model": "gpt-4",
                "response": "original response",
                "messages": [{"role": "user", "content": "hi"}],
            },
            "metadata": {},
        }
        exc = ModifyResponseException(
            message="blocked",
            model="gpt-4",
            request_data={},
            guardrail_name="rubrik",
        )

        payload = handler._prepare_block_failure_payload(logging_obj, exc, user_api_key_dict)

        assert "ModifyResponseException: blocked" in payload["response"]
        assert payload["id"] == "call-slo"

    def test_standard_logging_object_identity_is_not_overwritten(self, handler, user_api_key_dict):
        """A streamed block can arrive with the object populated; it keeps its own identity."""
        logging_obj = Mock()
        logging_obj.model_call_details = {
            "litellm_call_id": "call-slo-identity",
            "model": "gpt-4",
            "standard_logging_object": {
                "id": "chatcmpl-original",
                "model": "gpt-4",
                "response": "original response",
                "messages": [],
                "metadata": {"user_api_key_hash": "hash-from-standard-logging-object"},
            },
        }
        exc = ModifyResponseException(
            message="blocked",
            model="gpt-4",
            request_data={},
            guardrail_name="rubrik",
        )

        payload = handler._prepare_block_failure_payload(logging_obj, exc, user_api_key_dict)

        assert payload["metadata"]["user_api_key_hash"] == "hash-from-standard-logging-object"

    def test_uses_fallback_when_standard_logging_object_absent(self, handler, user_api_key_dict):
        """When standard_logging_object is absent, _build_fallback_payload is used."""
        from datetime import datetime

        logging_obj = Mock()
        logging_obj.model_call_details = {
            "litellm_call_id": "call-fallback",
            "model": "claude-3",
            "messages": [{"role": "user", "content": "question"}],
            "optional_params": {"temperature": 0.5},
            "metadata": {"headers": {"host": "127.0.0.1:4000", "user-agent": "curl/8.7.1"}},
            "start_time": datetime(2024, 6, 1),
        }
        exc = ModifyResponseException(
            message="prompt blocked",
            model="claude-3",
            request_data={},
            guardrail_name="rubrik",
        )

        payload = handler._prepare_block_failure_payload(logging_obj, exc, user_api_key_dict)

        assert payload["id"] == "call-fallback"
        assert payload["model"] == "claude-3"
        assert payload["model_group"] == "claude-3"
        assert "ModifyResponseException: prompt blocked" in payload["response"]
        assert payload["status"] == "failure"

    def test_fallback_payload_without_start_time(self, handler, user_api_key_dict):
        """_build_fallback_payload handles missing start_time gracefully."""
        logging_obj = Mock()
        logging_obj.model_call_details = {
            "litellm_call_id": "call-notime",
            "model": "gpt-4",
            "messages": [],
            "optional_params": {},
            "metadata": {},
        }
        exc = ModifyResponseException(
            message="blocked",
            model="gpt-4",
            request_data={},
            guardrail_name="rubrik",
        )

        payload = handler._prepare_block_failure_payload(logging_obj, exc, user_api_key_dict)
        assert payload["startTime"] is None


class TestBlockPayloadCallerAttribution:
    """A block log must identify the caller that triggered it.

    The enriched litellm metadata lives under
    ``model_call_details["litellm_params"]["metadata"]``, never at the top
    level, so sourcing identity from ``call_details["metadata"]`` yielded an
    empty string for every block. Identity comes from the authenticated
    ``user_api_key_dict`` the failure hook is handed.
    """

    def _blocked_call_details(self):
        return {
            "litellm_call_id": "call-attr",
            "model": "claude-3",
            "messages": [{"role": "user", "content": "question"}],
            "optional_params": {},
            "metadata": {"headers": {"host": "127.0.0.1:4000", "user-agent": "curl/8.7.1"}},
        }

    def test_fallback_payload_identifies_the_caller(self, handler, user_api_key_dict):
        payload = handler._build_fallback_payload(self._blocked_call_details(), user_api_key_dict)

        metadata = payload["metadata"]
        assert metadata["user_api_key_hash"] == user_api_key_dict.api_key
        assert metadata["user_api_key_alias"] == "rubrik-probe-key"
        assert metadata["user_api_key_user_id"] == "probe-user-1"
        assert metadata["user_api_key_team_id"] == "probe-team-1"
        assert metadata["user_api_key_org_id"] == "probe-org-1"

    def test_metadata_covers_the_full_caller_key_set(self, handler, user_api_key_dict):
        """A block log and a success log agree on the caller key set."""
        from litellm.types.utils import StandardLoggingUserAPIKeyMetadata

        payload = handler._build_fallback_payload(self._blocked_call_details(), user_api_key_dict)

        expected = StandardLoggingUserAPIKeyMetadata.__required_keys__ | StandardLoggingUserAPIKeyMetadata.__optional_keys__
        assert set(payload["metadata"]) == set(expected)

    def test_virtual_key_is_logged_hashed(self, handler):
        """A virtual key reaches the webhook as its hash, never as the raw token."""
        raw = "sk-block-attribution-test"
        payload = handler._build_fallback_payload(
            self._blocked_call_details(), UserAPIKeyAuth(api_key=raw)
        )

        assert payload["metadata"]["user_api_key_hash"] not in (raw, "")

    def test_request_header_metadata_is_not_used_as_identity(self, handler, user_api_key_dict):
        """The pre-fix source is present and misleading; it must not win."""
        call_details = self._blocked_call_details()
        call_details["metadata"]["user_api_key_hash"] = "stale-hash-from-request-metadata"

        payload = handler._build_fallback_payload(call_details, user_api_key_dict)

        assert payload["metadata"]["user_api_key_hash"] == user_api_key_dict.api_key

    async def test_enqueued_block_event_carries_attribution(self, handler, user_api_key_dict):
        """End of the real hook chain: what actually lands on the Rubrik queue."""
        logging_obj = Mock()
        logging_obj.model_call_details = self._blocked_call_details()
        request_data = {"litellm_call_id": "call-attr", "_rubrik_logging_obj": logging_obj}
        exc = ModifyResponseException(
            message="prompt blocked",
            model="claude-3",
            request_data=request_data,
            guardrail_name="rubrik",
        )

        await handler.async_post_call_failure_hook(
            request_data=request_data,
            original_exception=exc,
            user_api_key_dict=user_api_key_dict,
        )

        assert len(handler.log_queue) == 1
        metadata = handler.log_queue[0]["metadata"]
        assert metadata["user_api_key_hash"] == user_api_key_dict.api_key
        assert metadata["user_api_key_user_id"] == "probe-user-1"


# -- async_send_batch empty queue and flush_queue edge cases ------------------


@pytest.mark.asyncio
class TestQueueEdgeCases:
    async def test_async_send_batch_returns_early_on_empty_queue(self, handler):
        """async_send_batch is a no-op when the queue is empty."""
        handler.async_httpx_client = AsyncMock()
        await handler.async_send_batch()
        handler.async_httpx_client.post.assert_not_called()

    async def test_flush_queue_returns_early_when_flush_lock_is_none(self, handler):
        """flush_queue is a no-op when flush_lock is None."""
        handler.flush_lock = None
        handler.log_queue = [{"msg": "a"}]
        handler.async_httpx_client = AsyncMock()

        await handler.flush_queue()
        handler.async_httpx_client.post.assert_not_called()

    async def test_flush_queue_returns_early_when_queue_empty_inside_lock(self, handler):
        """flush_queue acquires the lock then no-ops when the queue is empty."""
        handler.log_queue = []
        handler.async_httpx_client = AsyncMock()

        await handler.flush_queue()
        handler.async_httpx_client.post.assert_not_called()


# -- _post_json non-dict response ---------------------------------------------


@pytest.mark.asyncio
class TestPostJson:
    async def test_raises_type_error_for_list_response(self, handler):
        """When the service returns a JSON array instead of a dict, TypeError is raised."""
        mock_client = AsyncMock()
        mock_resp = Mock()
        mock_resp.json.return_value = ["not", "a", "dict"]
        mock_resp.raise_for_status = Mock()
        mock_client.post = AsyncMock(return_value=mock_resp)
        handler.moderation_client = mock_client

        with pytest.raises(TypeError, match="non-dict JSON"):
            await handler._post_json(
                handler.prompt_moderation_endpoint, {}, "Test service"
            )

    async def test_raises_type_error_for_string_response(self, handler):
        """A bare string response also raises TypeError."""
        mock_client = AsyncMock()
        mock_resp = Mock()
        mock_resp.json.return_value = "blocked"
        mock_resp.raise_for_status = Mock()
        mock_client.post = AsyncMock(return_value=mock_resp)
        handler.moderation_client = mock_client

        with pytest.raises(TypeError, match="non-dict JSON"):
            await handler._post_json(
                handler.response_moderation_endpoint, {}, "Test service"
            )
