c79d94fd16
* feat(realtime): add guardrail hook for voice transcription in Realtime API Adds a new `realtime_input_transcription` guardrail event hook that fires after Whisper transcription completes, before the LLM generates a response. When a guardrail blocks, a synthetic warning is sent to the client and `response.create` is never forwarded — the LLM never responds. Also rewrites `create_response: true` → `false` in client `session.update` so the proxy controls when responses are triggered. * feat(realtime): speak guardrail block message as audio via TTS Instead of sending synthetic text events when a guardrail blocks, send response.create with forced instructions so OpenAI's TTS speaks the warning message — user hears the block instead of just seeing text. * fix(realtime): speak exact content filter error message via TTS Extract the human-readable error string from HTTPException.detail so the spoken warning says e.g. "Content blocked: keyword 'system update' detected" instead of the raw str(e) repr. * fix(realtime): reliably enforce create_response=false for guardrails - Proxy now injects session.update with create_response=false immediately on session.created (when guardrails are active), instead of rewriting the client's session.update — works regardless of what the client sends - Add response.cancel before the warning response.create to kill any in-flight LLM response that snuck through before the guardrail fired * refactor(realtime): call apply_guardrail directly, remove dedicated hook method The async_realtime_input_transcription_hook in CustomGuardrail and ContentFilterGuardrail was just a thin wrapper that called apply_guardrail — the same interface used by /chat and /messages. Remove the wrapper and call apply_guardrail directly from run_realtime_guardrails, keeping the pattern consistent across all endpoints. * docs: add Realtime API guardrails tutorial and flow diagram * fix: address Greptile review comments - Forward user_api_key_dict through realtime_api/main.py (_arealtime) so it actually reaches RealTimeStreaming instead of always being None - Run guardrail interception in provider_config path too (e.g. Gemini), not only the OpenAI direct path - Narrow exception catch to HTTPException/ValueError only; re-raise unexpected errors so programming bugs surface in logs rather than silently appearing as guardrail blocks - Update tests: mock apply_guardrail directly (hook method was removed), replace session.update client-rewrite test with session.created injection test matching the new server-side approach * fix: address latest Greptile review comments - Remove fastapi import from SDK-layer file; check for status_code/detail attrs instead to identify guardrail-block exceptions vs programming errors - Add store_message() before continue in transcription interception so transcription events are logged in the non-provider_config path - Inject create_response=false on session.created in provider_config path (Gemini etc.) to match the OpenAI path — prevents LLM auto-responding before guardrail runs on VAD-detected turns |
||
|---|---|---|
| .. | ||
| agent_tests | ||
| audio_tests | ||
| basic_proxy_startup_tests | ||
| batches_tests | ||
| code_coverage_tests | ||
| documentation_tests | ||
| enterprise | ||
| guardrails_tests | ||
| image_gen_tests | ||
| litellm | ||
| litellm_core_utils | ||
| litellm_utils_tests | ||
| litellm-proxy-extras | ||
| llm_responses_api_testing | ||
| llm_translation | ||
| load_tests | ||
| local_testing | ||
| logging_callback_tests | ||
| mcp_tests | ||
| multi_instance_e2e_tests | ||
| ocr_tests | ||
| old_proxy_tests/tests | ||
| openai_endpoints_tests | ||
| otel_tests | ||
| pass_through_tests | ||
| pass_through_unit_tests | ||
| proxy_admin_ui_tests | ||
| proxy_e2e_anthropic_messages_tests | ||
| proxy_security_tests | ||
| proxy_unit_tests | ||
| router_unit_tests | ||
| scim_tests | ||
| search_tests | ||
| spend_tracking_tests | ||
| store_model_in_db_tests | ||
| test_litellm | ||
| unified_google_tests | ||
| vector_store_tests | ||
| windows_tests | ||
| __init__.py | ||
| gettysburg.wav | ||
| large_text.py | ||
| openai_batch_completions.jsonl | ||
| README.MD | ||
| test_budget_management.py | ||
| test_callbacks_on_proxy.py | ||
| test_config.py | ||
| test_debug_warning.py | ||
| test_default_encoding_non_root.py | ||
| test_end_users.py | ||
| test_entrypoint.py | ||
| test_fallbacks.py | ||
| test_gpt5_azure_temperature_support.py | ||
| test_health.py | ||
| test_keys.py | ||
| test_litellm_proxy_responses_config.py | ||
| test_logging.conf | ||
| test_models.py | ||
| test_openai_endpoints.py | ||
| test_organizations.py | ||
| test_otel_thread_leak.py | ||
| test_passthrough_endpoints.py | ||
| test_presidio_latency.py | ||
| test_proxy_server_non_root.py | ||
| test_ratelimit.py | ||
| test_resource_cleanup.py | ||
| test_service_logger_otel.py | ||
| test_spend_logs.py | ||
| test_team_logging.py | ||
| test_team_members.py | ||
| test_team.py | ||
| test_users.py | ||
In total litellm runs 1000+ tests
[02/20/2025] Update:
To make it easier to contribute and map what behavior is tested,
we've started mapping the litellm directory in tests/test_litellm
This folder can only run mock tests.