From 4ee00cfda557f3e6990371a17eb987b3df5552ea Mon Sep 17 00:00:00 2001 From: yuneng-jiang Date: Mon, 26 Jan 2026 10:33:57 -0800 Subject: [PATCH 01/23] fix sso email case sensitivity --- litellm/proxy/auth/auth_checks.py | 4 +- litellm/proxy/management_endpoints/ui_sso.py | 36 +++++++-- .../proxy/auth/test_auth_checks.py | 40 ++++++++++ .../proxy/management_endpoints/test_ui_sso.py | 80 +++++++++++++++++++ 4 files changed, 151 insertions(+), 9 deletions(-) diff --git a/litellm/proxy/auth/auth_checks.py b/litellm/proxy/auth/auth_checks.py index 5e0a211906..d6db343cd0 100644 --- a/litellm/proxy/auth/auth_checks.py +++ b/litellm/proxy/auth/auth_checks.py @@ -1014,8 +1014,10 @@ async def _get_fuzzy_user_object( ) if response is None and user_email is not None: + # Use case-insensitive query to handle emails with different casing + # This matches the pattern used in _check_duplicate_user_email response = await prisma_client.db.litellm_usertable.find_first( - where={"user_email": user_email}, + where={"user_email": {"equals": user_email, "mode": "insensitive"}}, include={"organization_memberships": True}, ) diff --git a/litellm/proxy/management_endpoints/ui_sso.py b/litellm/proxy/management_endpoints/ui_sso.py index 5adf54c162..7ce641fac8 100644 --- a/litellm/proxy/management_endpoints/ui_sso.py +++ b/litellm/proxy/management_endpoints/ui_sso.py @@ -93,6 +93,26 @@ else: router = APIRouter() +def normalize_email(email: Optional[str]) -> Optional[str]: + """ + Normalize email address to lowercase for consistent storage and comparison. + + Email addresses should be treated as case-insensitive for SSO purposes, + even though RFC 5321 technically allows case-sensitive local parts. + This prevents issues where SSO providers return emails with different casing + than what's stored in the database. + + Args: + email: Email address to normalize, can be None + + Returns: + Lowercased email address, or None if input is None + """ + if email is None: + return None + return email.lower() if isinstance(email, str) else email + + def determine_role_from_groups( user_groups: List[str], role_mappings: "RoleMappings", @@ -390,7 +410,7 @@ def generic_response_convertor( display_name=get_nested_value( response, generic_user_display_name_attribute_name ), - email=get_nested_value(response, generic_user_email_attribute_name), + email=normalize_email(get_nested_value(response, generic_user_email_attribute_name)), first_name=get_nested_value(response, generic_user_first_name_attribute_name), last_name=get_nested_value(response, generic_user_last_name_attribute_name), provider=get_nested_value(response, generic_provider_attribute_name), @@ -688,7 +708,7 @@ async def get_user_info_from_db( if _id is not None and isinstance(_id, str): potential_user_ids.append(_id) - user_email = ( + user_email = normalize_email( getattr(result, "email", None) if not isinstance(result, dict) else result.get("email", None) @@ -763,8 +783,8 @@ def _build_sso_user_update_data( Returns: dict: Update data containing user_email and optionally user_role if valid - """ - update_data: dict = {"user_email": user_email} + """ + update_data: dict = {"user_email": normalize_email(user_email)} # Get SSO role from result and include if valid sso_role = getattr(result, "user_role", None) @@ -1266,7 +1286,7 @@ async def insert_sso_user( new_user_request = NewUserRequest( user_id=user_defined_values["user_id"], - user_email=user_defined_values["user_email"], + user_email=normalize_email(user_defined_values["user_email"]), user_role=user_defined_values["user_role"], # type: ignore max_budget=user_defined_values["max_budget"], budget_duration=user_defined_values["budget_duration"], @@ -1931,7 +1951,7 @@ class SSOAuthenticationHandler: """ Gets the user email and id from the OpenID result after validating the email domain """ - user_email: Optional[str] = getattr(result, "email", None) + user_email: Optional[str] = normalize_email(getattr(result, "email", None)) user_id: Optional[str] = ( getattr(result, "id", None) if result is not None else None ) @@ -1970,7 +1990,7 @@ class SSOAuthenticationHandler: "GENERIC_USER_ROLE_ATTRIBUTE", "role" ) user_id = getattr(result, "id", None) - user_email = getattr(result, "email", None) + user_email = normalize_email(getattr(result, "email", None)) if user_role is None: _role_from_attr = getattr(result, generic_user_role_attribute_name, None) # type: ignore if _role_from_attr is not None: @@ -2363,7 +2383,7 @@ class MicrosoftSSOHandler: response = response or {} verbose_proxy_logger.debug(f"Microsoft SSO Callback Response: {response}") openid_response = CustomOpenID( - email=response.get(MICROSOFT_USER_EMAIL_ATTRIBUTE) or response.get("mail"), + email=normalize_email(response.get(MICROSOFT_USER_EMAIL_ATTRIBUTE) or response.get("mail")), display_name=response.get(MICROSOFT_USER_DISPLAY_NAME_ATTRIBUTE), provider="microsoft", id=response.get(MICROSOFT_USER_ID_ATTRIBUTE), diff --git a/tests/test_litellm/proxy/auth/test_auth_checks.py b/tests/test_litellm/proxy/auth/test_auth_checks.py index 807559207e..8581968b2b 100644 --- a/tests/test_litellm/proxy/auth/test_auth_checks.py +++ b/tests/test_litellm/proxy/auth/test_auth_checks.py @@ -28,6 +28,7 @@ from litellm.proxy._types import ( from litellm.proxy.auth.auth_checks import ( ExperimentalUIJWTToken, _can_object_call_vector_stores, + _get_fuzzy_user_object, _get_team_db_check, _virtual_key_max_budget_alert_check, _virtual_key_soft_budget_check, @@ -1277,3 +1278,42 @@ async def test_virtual_key_max_budget_alert_check_scenarios( assert ( alert_triggered == expect_alert ), f"Expected alert_triggered to be {expect_alert} for spend={spend}, max_budget={max_budget}" + + +@pytest.mark.asyncio +async def test_get_fuzzy_user_object_case_insensitive_email(): + """Test that _get_fuzzy_user_object uses case-insensitive email lookup""" + # Setup mock Prisma client + mock_prisma = MagicMock() + mock_prisma.db = MagicMock() + mock_prisma.db.litellm_usertable = MagicMock() + + # Mock user data with mixed case email + test_user = LiteLLM_UserTable( + user_id="test_123", + sso_user_id=None, + user_email="Test@Example.com", # Mixed case in DB + organization_memberships=[], + max_budget=None, + ) + + # Test: SSO ID not found, find by email with different casing + mock_prisma.db.litellm_usertable.find_unique = AsyncMock(return_value=None) + mock_prisma.db.litellm_usertable.find_first = AsyncMock(return_value=test_user) + + # Search with lowercase email (different from DB) + result = await _get_fuzzy_user_object( + prisma_client=mock_prisma, + sso_user_id=None, + user_email="test@example.com", # Lowercase search + ) + + # Verify user was found despite case difference + assert result == test_user + + # Verify the query used case-insensitive mode + mock_prisma.db.litellm_usertable.find_first.assert_called_once() + call_args = mock_prisma.db.litellm_usertable.find_first.call_args + assert call_args.kwargs["where"]["user_email"]["equals"] == "test@example.com" + assert call_args.kwargs["where"]["user_email"]["mode"] == "insensitive" + assert call_args.kwargs["include"] == {"organization_memberships": True} diff --git a/tests/test_litellm/proxy/management_endpoints/test_ui_sso.py b/tests/test_litellm/proxy/management_endpoints/test_ui_sso.py index f983af2d0b..5e9078ea87 100644 --- a/tests/test_litellm/proxy/management_endpoints/test_ui_sso.py +++ b/tests/test_litellm/proxy/management_endpoints/test_ui_sso.py @@ -24,6 +24,7 @@ from litellm.proxy.management_endpoints.ui_sso import ( GoogleSSOHandler, MicrosoftSSOHandler, SSOAuthenticationHandler, + normalize_email, ) from litellm.types.proxy.management_endpoints.ui_sso import ( DefaultTeamSSOParams, @@ -667,6 +668,85 @@ def test_build_sso_user_update_data_without_role(): assert "user_role" not in update_data +def test_normalize_email(): + """ + Test that normalize_email correctly lowercases email addresses and handles edge cases. + """ + # Test with lowercase email + assert normalize_email("test@example.com") == "test@example.com" + + # Test with uppercase email + assert normalize_email("TEST@EXAMPLE.COM") == "test@example.com" + + # Test with mixed case email + assert normalize_email("Test.User@Example.COM") == "test.user@example.com" + + # Test with None + assert normalize_email(None) is None + + # Test with empty string + assert normalize_email("") == "" + + +def test_build_sso_user_update_data_normalizes_email(): + """ + Test that _build_sso_user_update_data normalizes email addresses to lowercase. + """ + from litellm.proxy.management_endpoints.types import CustomOpenID + from litellm.proxy.management_endpoints.ui_sso import _build_sso_user_update_data + + sso_result = CustomOpenID( + id="test-user-789", + email="Test.User@Example.COM", + display_name="Test User", + provider="microsoft", + team_ids=[], + user_role=None, + ) + + update_data = _build_sso_user_update_data( + result=sso_result, + user_email="Test.User@Example.COM", + user_id="test-user-789", + ) + + # Email should be normalized to lowercase + assert update_data["user_email"] == "test.user@example.com" + assert "user_role" not in update_data + + +def test_generic_response_convertor_normalizes_email(): + """ + Test that generic_response_convertor normalizes email addresses. + """ + from litellm.proxy.management_endpoints.ui_sso import generic_response_convertor + + mock_response = { + "preferred_username": "user123", + "email": "Test.User@Example.COM", + "sub": "Test User", + "first_name": "Test", + "last_name": "User", + "provider": "generic", + } + + # Mock JWT handler + mock_jwt_handler = MagicMock(spec=JWTHandler) + mock_jwt_handler.get_team_ids_from_jwt.return_value = [] + + result = generic_response_convertor( + response=mock_response, + jwt_handler=mock_jwt_handler, + sso_jwt_handler=None, + role_mappings=None, + ) + + # Email should be normalized to lowercase + assert result.email == "test.user@example.com" + assert result.id == "user123" + assert result.display_name == "Test User" + + @pytest.mark.asyncio async def test_upsert_sso_user_updates_role_for_existing_user(): """ From f879b8b1cbf9e81be5896135ea7cad391d02f6c2 Mon Sep 17 00:00:00 2001 From: yuneng-jiang Date: Mon, 26 Jan 2026 14:35:35 -0800 Subject: [PATCH 02/23] fixing team member add --- .../management_endpoints/team_endpoints.py | 123 ++++++++++++++++++ .../test_team_endpoints.py | 120 +++++++++++++++++ 2 files changed, 243 insertions(+) diff --git a/litellm/proxy/management_endpoints/team_endpoints.py b/litellm/proxy/management_endpoints/team_endpoints.py index d0afb62e8b..2c31b59b79 100644 --- a/litellm/proxy/management_endpoints/team_endpoints.py +++ b/litellm/proxy/management_endpoints/team_endpoints.py @@ -1771,6 +1771,116 @@ async def _add_team_members_to_team( return updated_team, updated_users, updated_team_memberships +async def _validate_and_populate_member_user_info( + member: Member, + prisma_client: PrismaClient, +) -> Member: + """ + Validate and populate user_email/user_id for a member. + + Logic: + 1. If both user_email and user_id are provided, verify they belong to the same user (use user_email as source of truth) + 2. If only user_email is provided, populate user_id from DB + 3. If only user_id is provided, populate user_email from DB + 4. If only user_id is provided and doesn't exist, throw error + 5. If user_email and user_id mismatch, throw error + + Returns a Member with both user_email and user_id populated. + """ + if member.user_email is None and member.user_id is None: + raise HTTPException( + status_code=400, + detail={"error": "Either user_id or user_email must be provided"}, + ) + + # Case 1: Both user_email and user_id provided - verify they match + if member.user_email is not None and member.user_id is not None: + # Use user_email as source of truth + # Check for multiple users with same email first + users_by_email = await prisma_client.get_data( + key_val={"user_email": member.user_email}, + table_name="user", + query_type="find_all", + ) + + if users_by_email is None or ( + isinstance(users_by_email, list) and len(users_by_email) == 0 + ): + # User doesn't exist yet - this is fine, will be created later + return member + + if isinstance(users_by_email, list) and len(users_by_email) > 1: + raise HTTPException( + status_code=400, + detail={ + "error": f"Multiple users found with email '{member.user_email}'. Please use 'user_id' instead." + }, + ) + + # Get the single user + user_by_email = users_by_email[0] + + # Verify the user_id matches + if user_by_email.user_id != member.user_id: + raise HTTPException( + status_code=400, + detail={ + "error": f"user_email '{member.user_email}' and user_id '{member.user_id}' do not belong to the same user." + }, + ) + + # Both match, return as is + return member + + # Case 2: Only user_email provided - populate user_id from DB + if member.user_email is not None and member.user_id is None: + user_by_email = await prisma_client.db.litellm_usertable.find_first( + where={"user_email": {"equals": member.user_email, "mode": "insensitive"}} + ) + + if user_by_email is None: + # User doesn't exist yet - this is fine, will be created later + return member + + # Check for multiple users with same email + users_by_email = await prisma_client.get_data( + key_val={"user_email": member.user_email}, + table_name="user", + query_type="find_all", + ) + + if users_by_email and isinstance(users_by_email, list) and len(users_by_email) > 1: + raise HTTPException( + status_code=400, + detail={ + "error": f"Multiple users found with email '{member.user_email}'. Please use 'user_id' instead." + }, + ) + + # Populate user_id + member.user_id = user_by_email.user_id + return member + + # Case 3: Only user_id provided - populate user_email from DB + if member.user_id is not None and member.user_email is None: + user_by_id = await prisma_client.db.litellm_usertable.find_unique( + where={"user_id": member.user_id} + ) + + if user_by_id is None: + raise HTTPException( + status_code=404, + detail={ + "error": f"User with user_id '{member.user_id}' not found in database" + }, + ) + + # Populate user_email + member.user_email = user_by_id.user_email + return member + + return member + @router.post( "/team/member_add", tags=["team management"], @@ -1846,6 +1956,19 @@ async def team_member_add( complete_team_data=complete_team_data, ) + # Validate and populate user_email/user_id for members before processing + if isinstance(data.member, Member): + await _validate_and_populate_member_user_info( + member=data.member, + prisma_client=prisma_client, + ) + elif isinstance(data.member, List): + for m in data.member: + await _validate_and_populate_member_user_info( + member=m, + prisma_client=prisma_client, + ) + updated_team, updated_users, updated_team_memberships = ( await _add_team_members_to_team( data=data, diff --git a/tests/test_litellm/proxy/management_endpoints/test_team_endpoints.py b/tests/test_litellm/proxy/management_endpoints/test_team_endpoints.py index a97ed93a85..a586457690 100644 --- a/tests/test_litellm/proxy/management_endpoints/test_team_endpoints.py +++ b/tests/test_litellm/proxy/management_endpoints/test_team_endpoints.py @@ -36,6 +36,7 @@ from litellm.proxy.management_endpoints.team_endpoints import ( _persist_deleted_team_records, _save_deleted_team_records, _transform_teams_to_deleted_records, + _validate_and_populate_member_user_info, delete_team, router, team_member_add_duplication_check, @@ -5466,3 +5467,122 @@ async def test_get_team_daily_activity_team_admin_sees_all_spend(mock_db_client) ) and mock_db_client.db.litellm_verificationtoken.find_many.called: # If it was called, that's unexpected for admin users assert False, "API keys should not be fetched for team admin users" + + +@pytest.mark.asyncio +async def test_validate_and_populate_member_user_info_both_provided_match(): + """ + Test _validate_and_populate_member_user_info when both user_email and user_id + are provided and they match the same user in the database. + """ + # Create member with both user_email and user_id + member = Member(user_email="test@example.com", user_id="user-123", role="user") + + # Mock prisma client + mock_prisma_client = MagicMock() + + # Mock user object that matches both email and user_id + mock_user = MagicMock() + mock_user.user_id = "user-123" + mock_user.user_email = "test@example.com" + + # Mock get_data to return single user matching email + mock_prisma_client.get_data = AsyncMock(return_value=[mock_user]) + + # Call the function + result = await _validate_and_populate_member_user_info( + member=member, + prisma_client=mock_prisma_client, + ) + + # Verify result matches input (both already provided and match) + assert result.user_email == "test@example.com" + assert result.user_id == "user-123" + + # Verify get_data was called with correct parameters + mock_prisma_client.get_data.assert_called_once_with( + key_val={"user_email": "test@example.com"}, + table_name="user", + query_type="find_all", + ) + + +@pytest.mark.asyncio +async def test_validate_and_populate_member_user_info_only_email_provided(): + """ + Test _validate_and_populate_member_user_info when only user_email is provided. + Should populate user_id from database. + """ + # Create member with only user_email + member = Member(user_email="test@example.com", user_id=None, role="user") + + # Mock prisma client + mock_prisma_client = MagicMock() + + # Mock user object from find_first + mock_user_find_first = MagicMock() + mock_user_find_first.user_id = "user-456" + mock_user_find_first.user_email = "test@example.com" + + # Mock find_first to return the user + mock_prisma_client.db.litellm_usertable.find_first = AsyncMock( + return_value=mock_user_find_first + ) + + # Mock get_data to return single user (no duplicates) + mock_prisma_client.get_data = AsyncMock(return_value=[mock_user_find_first]) + + # Call the function + result = await _validate_and_populate_member_user_info( + member=member, + prisma_client=mock_prisma_client, + ) + + # Verify user_id was populated + assert result.user_email == "test@example.com" + assert result.user_id == "user-456" + + # Verify find_first was called with correct parameters + mock_prisma_client.db.litellm_usertable.find_first.assert_called_once_with( + where={"user_email": {"equals": "test@example.com", "mode": "insensitive"}} + ) + + # Verify get_data was called to check for duplicates + mock_prisma_client.get_data.assert_called_once_with( + key_val={"user_email": "test@example.com"}, + table_name="user", + query_type="find_all", + ) + + +@pytest.mark.asyncio +async def test_validate_and_populate_member_user_info_only_user_id_not_found(): + """ + Test _validate_and_populate_member_user_info when only user_id is provided + but the user doesn't exist in the database. Should raise HTTPException. + """ + # Create member with only user_id + member = Member(user_email=None, user_id="nonexistent-user", role="user") + + # Mock prisma client + mock_prisma_client = MagicMock() + + # Mock find_unique to return None (user not found) + mock_prisma_client.db.litellm_usertable.find_unique = AsyncMock(return_value=None) + + # Call the function and expect HTTPException + with pytest.raises(HTTPException) as exc_info: + await _validate_and_populate_member_user_info( + member=member, + prisma_client=mock_prisma_client, + ) + + # Verify the exception details + assert exc_info.value.status_code == 404 + assert "not found" in exc_info.value.detail["error"].lower() + assert "nonexistent-user" in exc_info.value.detail["error"] + + # Verify find_unique was called with correct parameters + mock_prisma_client.db.litellm_usertable.find_unique.assert_called_once_with( + where={"user_id": "nonexistent-user"} + ) From b10f71d5833e5af3c972caafec799cee4a62c906 Mon Sep 17 00:00:00 2001 From: yuneng-jiang Date: Mon, 26 Jan 2026 18:10:51 -0800 Subject: [PATCH 03/23] fixing breaking change: just user_id provided should upsert still --- .../management_endpoints/team_endpoints.py | 17 ++++++-------- .../test_team_endpoints.py | 22 +++++++++---------- 2 files changed, 18 insertions(+), 21 deletions(-) diff --git a/litellm/proxy/management_endpoints/team_endpoints.py b/litellm/proxy/management_endpoints/team_endpoints.py index 2c31b59b79..63db2d72fe 100644 --- a/litellm/proxy/management_endpoints/team_endpoints.py +++ b/litellm/proxy/management_endpoints/team_endpoints.py @@ -1781,11 +1781,11 @@ async def _validate_and_populate_member_user_info( Logic: 1. If both user_email and user_id are provided, verify they belong to the same user (use user_email as source of truth) 2. If only user_email is provided, populate user_id from DB - 3. If only user_id is provided, populate user_email from DB - 4. If only user_id is provided and doesn't exist, throw error + 3. If only user_id is provided, populate user_email from DB (if user exists) + 4. If only user_id is provided and doesn't exist, allow it to pass with user_email as None (will be upserted later) 5. If user_email and user_id mismatch, throw error - Returns a Member with both user_email and user_id populated. + Returns a Member with user_email and user_id populated (user_email may be None if only user_id provided and user doesn't exist). """ if member.user_email is None and member.user_id is None: raise HTTPException( @@ -1861,19 +1861,16 @@ async def _validate_and_populate_member_user_info( member.user_id = user_by_email.user_id return member - # Case 3: Only user_id provided - populate user_email from DB + # Case 3: Only user_id provided - populate user_email from DB if user exists if member.user_id is not None and member.user_email is None: user_by_id = await prisma_client.db.litellm_usertable.find_unique( where={"user_id": member.user_id} ) if user_by_id is None: - raise HTTPException( - status_code=404, - detail={ - "error": f"User with user_id '{member.user_id}' not found in database" - }, - ) + # User doesn't exist yet - allow it to pass with user_email as None + # Will be upserted later with just user_id and null email + return member # Populate user_email member.user_email = user_by_id.user_email diff --git a/tests/test_litellm/proxy/management_endpoints/test_team_endpoints.py b/tests/test_litellm/proxy/management_endpoints/test_team_endpoints.py index a586457690..467ee3661d 100644 --- a/tests/test_litellm/proxy/management_endpoints/test_team_endpoints.py +++ b/tests/test_litellm/proxy/management_endpoints/test_team_endpoints.py @@ -5559,7 +5559,8 @@ async def test_validate_and_populate_member_user_info_only_email_provided(): async def test_validate_and_populate_member_user_info_only_user_id_not_found(): """ Test _validate_and_populate_member_user_info when only user_id is provided - but the user doesn't exist in the database. Should raise HTTPException. + but the user doesn't exist in the database. Should allow it to pass with + user_email as None (will be upserted later). """ # Create member with only user_id member = Member(user_email=None, user_id="nonexistent-user", role="user") @@ -5570,17 +5571,16 @@ async def test_validate_and_populate_member_user_info_only_user_id_not_found(): # Mock find_unique to return None (user not found) mock_prisma_client.db.litellm_usertable.find_unique = AsyncMock(return_value=None) - # Call the function and expect HTTPException - with pytest.raises(HTTPException) as exc_info: - await _validate_and_populate_member_user_info( - member=member, - prisma_client=mock_prisma_client, - ) + # Call the function - should NOT raise an exception + result = await _validate_and_populate_member_user_info( + member=member, + prisma_client=mock_prisma_client, + ) - # Verify the exception details - assert exc_info.value.status_code == 404 - assert "not found" in exc_info.value.detail["error"].lower() - assert "nonexistent-user" in exc_info.value.detail["error"] + # Verify the result - should return member with user_id set and user_email as None + assert result.user_id == "nonexistent-user" + assert result.user_email is None + assert result.role == "user" # Verify find_unique was called with correct parameters mock_prisma_client.db.litellm_usertable.find_unique.assert_called_once_with( From ef7261d0eb4d214c43f47a1f3d095073efc85623 Mon Sep 17 00:00:00 2001 From: yuneng-jiang Date: Mon, 26 Jan 2026 20:07:30 -0800 Subject: [PATCH 04/23] Fixing tests --- tests/proxy_unit_tests/test_proxy_server.py | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/tests/proxy_unit_tests/test_proxy_server.py b/tests/proxy_unit_tests/test_proxy_server.py index 839d09b52d..d864a0d986 100644 --- a/tests/proxy_unit_tests/test_proxy_server.py +++ b/tests/proxy_unit_tests/test_proxy_server.py @@ -1117,7 +1117,10 @@ async def test_create_team_member_add(prisma_client, new_member_method): ) as mock_litellm_usertable, patch( "litellm.proxy.auth.auth_checks._get_team_object_from_user_api_key_cache", new=AsyncMock(return_value=team_obj), - ) as mock_team_obj: + ) as mock_team_obj, patch( + "litellm.proxy.proxy_server.prisma_client.get_data", + new=AsyncMock(return_value=[]), + ) as mock_get_data: mock_client = AsyncMock( return_value=LiteLLM_UserTable( @@ -1126,6 +1129,10 @@ async def test_create_team_member_add(prisma_client, new_member_method): ) mock_litellm_usertable.upsert = mock_client mock_litellm_usertable.find_many = AsyncMock(return_value=None) + # Mock find_first for user_email validation (returns None for new users) + mock_litellm_usertable.find_first = AsyncMock(return_value=None) + # Mock find_unique for user_id validation (returns None for new users) + mock_litellm_usertable.find_unique = AsyncMock(return_value=None) team_mock_client = AsyncMock() original_val = getattr( litellm.proxy.proxy_server.prisma_client.db, "litellm_teamtable" @@ -1299,7 +1306,10 @@ async def test_create_team_member_add_team_admin( ) as mock_litellm_usertable, patch( "litellm.proxy.auth.auth_checks._get_team_object_from_user_api_key_cache", new=AsyncMock(return_value=team_obj), - ) as mock_team_obj: + ) as mock_team_obj, patch( + "litellm.proxy.proxy_server.prisma_client.get_data", + new=AsyncMock(return_value=[]), + ) as mock_get_data: mock_client = AsyncMock( return_value=LiteLLM_UserTable( user_id="1234", max_budget=100, user_email="1234" @@ -1307,6 +1317,10 @@ async def test_create_team_member_add_team_admin( ) mock_litellm_usertable.upsert = mock_client mock_litellm_usertable.find_many = AsyncMock(return_value=None) + # Mock find_first for user_email validation (returns None for new users) + mock_litellm_usertable.find_first = AsyncMock(return_value=None) + # Mock find_unique for user_id validation (returns None for new users) + mock_litellm_usertable.find_unique = AsyncMock(return_value=None) team_mock_client = AsyncMock() original_val = getattr( From 7307992cea72d9e3c338bd2a160f9c040f8d40f2 Mon Sep 17 00:00:00 2001 From: yuneng-jiang Date: Mon, 26 Jan 2026 20:17:53 -0800 Subject: [PATCH 05/23] fixing tests --- tests/proxy_unit_tests/test_auth_checks.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/tests/proxy_unit_tests/test_auth_checks.py b/tests/proxy_unit_tests/test_auth_checks.py index 24c005443a..05c6e4984a 100644 --- a/tests/proxy_unit_tests/test_auth_checks.py +++ b/tests/proxy_unit_tests/test_auth_checks.py @@ -584,7 +584,7 @@ async def test_get_fuzzy_user_object(): ) assert result == test_user mock_prisma.db.litellm_usertable.find_first.assert_called_with( - where={"user_email": "test@example.com"}, + where={"user_email": {"equals": "test@example.com", "mode": "insensitive"}}, include={"organization_memberships": True}, ) @@ -612,7 +612,7 @@ async def test_get_fuzzy_user_object(): ) assert result == test_user mock_prisma.db.litellm_usertable.find_first.assert_called_with( - where={"user_email": "test@example.com"}, + where={"user_email": {"equals": "test@example.com", "mode": "insensitive"}}, include={"organization_memberships": True}, ) From 1bf33c4e41f829f24316d614c2eec98fb9643b9d Mon Sep 17 00:00:00 2001 From: Sameer Kankute Date: Tue, 27 Jan 2026 11:19:31 +0530 Subject: [PATCH 06/23] Fix:Support both JSON array format and comma-separated values from user headers --- litellm/llms/bedrock/common_utils.py | 23 ++++++++++++++++++++--- 1 file changed, 20 insertions(+), 3 deletions(-) diff --git a/litellm/llms/bedrock/common_utils.py b/litellm/llms/bedrock/common_utils.py index 89b42f5e94..65d237bdbd 100644 --- a/litellm/llms/bedrock/common_utils.py +++ b/litellm/llms/bedrock/common_utils.py @@ -797,7 +797,7 @@ class BedrockEventStreamDecoderBase: def get_anthropic_beta_from_headers(headers: dict) -> List[str]: """ Extract anthropic-beta header values and convert them to a list. - Supports comma-separated values from user headers. + Supports both JSON array format and comma-separated values from user headers. Used by both converse and invoke transformations for consistent handling of anthropic-beta headers that should be passed to AWS Bedrock. @@ -812,8 +812,25 @@ def get_anthropic_beta_from_headers(headers: dict) -> List[str]: if not anthropic_beta_header: return [] - # Split comma-separated values and strip whitespace - return [beta.strip() for beta in anthropic_beta_header.split(",")] + # If it's already a list, return it + if isinstance(anthropic_beta_header, list): + return anthropic_beta_header + + # Try to parse as JSON array first (e.g., '["interleaved-thinking-2025-05-14", "claude-code-20250219"]') + if isinstance(anthropic_beta_header, str): + anthropic_beta_header = anthropic_beta_header.strip() + if anthropic_beta_header.startswith("[") and anthropic_beta_header.endswith("]"): + try: + parsed = json.loads(anthropic_beta_header) + if isinstance(parsed, list): + return [str(beta).strip() for beta in parsed] + except json.JSONDecodeError: + pass # Fall through to comma-separated parsing + + # Fall back to comma-separated values + return [beta.strip() for beta in anthropic_beta_header.split(",")] + + return [] class CommonBatchFilesUtils: From 3f32562587f0945cd73d09ebe7820d147b465512 Mon Sep 17 00:00:00 2001 From: Sameer Kankute Date: Tue, 27 Jan 2026 11:20:16 +0530 Subject: [PATCH 07/23] Translate advanced-tool-use to Bedrock-specific headers for Claude Opus 4.5 --- .../anthropic_claude3_transformation.py | 38 +++- ...ations_anthropic_claude3_transformation.py | 185 ++++++++++++++++++ .../bedrock/test_anthropic_beta_support.py | 63 ++++++ 3 files changed, 282 insertions(+), 4 deletions(-) diff --git a/litellm/llms/bedrock/messages/invoke_transformations/anthropic_claude3_transformation.py b/litellm/llms/bedrock/messages/invoke_transformations/anthropic_claude3_transformation.py index a7065caece..67ca9d5024 100644 --- a/litellm/llms/bedrock/messages/invoke_transformations/anthropic_claude3_transformation.py +++ b/litellm/llms/bedrock/messages/invoke_transformations/anthropic_claude3_transformation.py @@ -162,6 +162,22 @@ class AmazonAnthropicClaudeMessagesConfig( return any(pattern in model_lower for pattern in supported_patterns) + def _is_claude_opus_4_5(self, model: str) -> bool: + """ + Check if the model is Claude Opus 4.5. + + Args: + model: The model name + + Returns: + True if the model is Claude Opus 4.5 + """ + model_lower = model.lower() + opus_4_5_patterns = [ + "opus-4.5", "opus_4.5", "opus-4-5", "opus_4_5", + ] + return any(pattern in model_lower for pattern in opus_4_5_patterns) + def _filter_unsupported_beta_headers_for_bedrock( self, model: str, beta_set: set ) -> None: @@ -169,25 +185,32 @@ class AmazonAnthropicClaudeMessagesConfig( Remove beta headers that are not supported on Bedrock for the given model. Extended thinking beta headers are only supported on specific Claude 4+ models. - Advanced tool use headers are not supported on Bedrock Invoke API. + Advanced tool use headers are not supported on Bedrock Invoke API, but need to be + translated to Bedrock-specific headers for Claude Opus 4.5. This prevents 400 "invalid beta flag" errors on Bedrock. Note: Bedrock Invoke API fails with a 400 error when unsupported beta headers are sent, returning: {"message":"invalid beta flag"} + Translation for Claude Opus 4.5: + - advanced-tool-use-2025-11-20 -> tool-search-tool-2025-10-19 + tool-examples-2025-10-29 + Args: model: The model name beta_set: The set of beta headers to filter in-place """ beta_headers_to_remove = set() + has_advanced_tool_use = False - # 1. Filter out beta headers that are universally unsupported on Bedrock Invoke + # 1. Filter out beta headers that are universally unsupported on Bedrock Invoke and track if advanced-tool-use header is present for beta in beta_set: for unsupported_pattern in self.UNSUPPORTED_BEDROCK_INVOKE_BETA_PATTERNS: if unsupported_pattern in beta.lower(): beta_headers_to_remove.add(beta) + has_advanced_tool_use = True break - + + # 2. Filter out extended thinking headers for models that don't support them extended_thinking_patterns = [ "extended-thinking", @@ -203,6 +226,13 @@ class AmazonAnthropicClaudeMessagesConfig( # Remove all filtered headers for beta in beta_headers_to_remove: beta_set.discard(beta) + + # 3. Translate advanced-tool-use to Bedrock-specific headers for Claude Opus 4.5 + # Ref: https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html + if has_advanced_tool_use and self._is_claude_opus_4_5(model): + beta_set.add("tool-search-tool-2025-10-19") + beta_set.add("tool-examples-2025-10-29") + def _get_tool_search_beta_header_for_bedrock( self, @@ -256,7 +286,7 @@ class AmazonAnthropicClaudeMessagesConfig( Ref: https://aws.amazon.com/blogs/machine-learning/structured-data-response-with-amazon-bedrock-prompt-engineering-and-tool-use/ """ import json - + # Extract schema from output_format schema = output_format.get("schema") if not schema: diff --git a/tests/test_litellm/llms/bedrock/chat/invoke_transformations/test_bedrock_chat_invoke_transformations_anthropic_claude3_transformation.py b/tests/test_litellm/llms/bedrock/chat/invoke_transformations/test_bedrock_chat_invoke_transformations_anthropic_claude3_transformation.py index 1cb84d32c1..98b392a353 100644 --- a/tests/test_litellm/llms/bedrock/chat/invoke_transformations/test_bedrock_chat_invoke_transformations_anthropic_claude3_transformation.py +++ b/tests/test_litellm/llms/bedrock/chat/invoke_transformations/test_bedrock_chat_invoke_transformations_anthropic_claude3_transformation.py @@ -279,3 +279,188 @@ def test_output_format_with_no_schema(): # Content should remain as string (not converted to list) assert isinstance(last_user_message["content"], str) assert last_user_message["content"] == "Hello" + + +def test_advanced_tool_use_header_translation_for_opus_4_5(): + """ + Test that advanced-tool-use-2025-11-20 header is translated to Bedrock-specific headers + for Claude Opus 4.5. + + Regression test for: Claude Code sends advanced-tool-use header which needs to be + translated to tool-search-tool-2025-10-19 and tool-examples-2025-10-29 for Bedrock + Invoke API on Claude Opus 4.5. + + Ref: https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html + """ + from litellm.llms.bedrock.messages.invoke_transformations.anthropic_claude3_transformation import ( + AmazonAnthropicClaudeMessagesConfig, + ) + + config = AmazonAnthropicClaudeMessagesConfig() + + messages = [ + {"role": "user", "content": "What's the weather like?"} + ] + + anthropic_messages_optional_request_params = { + "max_tokens": 100, + } + + # Simulate advanced-tool-use header from Claude Code + headers = { + "anthropic-beta": "advanced-tool-use-2025-11-20" + } + + # Test with Claude Opus 4.5 + result = config.transform_anthropic_messages_request( + model="anthropic.claude-opus-4-5-20250514-v1:0", + messages=messages, + anthropic_messages_optional_request_params=anthropic_messages_optional_request_params, + litellm_params={}, + headers=headers, + ) + + # Verify advanced-tool-use header was removed + assert "anthropic_beta" in result + beta_headers = result["anthropic_beta"] + assert "advanced-tool-use-2025-11-20" not in beta_headers, \ + "advanced-tool-use header should be removed for Bedrock" + + # Verify Bedrock-specific headers were added + assert "tool-search-tool-2025-10-19" in beta_headers, \ + "tool-search-tool-2025-10-19 should be added for Opus 4.5" + assert "tool-examples-2025-10-29" in beta_headers, \ + "tool-examples-2025-10-29 should be added for Opus 4.5" + + +def test_advanced_tool_use_header_filtered_for_non_opus_4_5(): + """ + Test that advanced-tool-use-2025-11-20 header is filtered out for non-Opus 4.5 models + without adding Bedrock-specific headers. + + The translation to tool-search-tool-2025-10-19 and tool-examples-2025-10-29 should + only happen for Claude Opus 4.5. + """ + from litellm.llms.bedrock.messages.invoke_transformations.anthropic_claude3_transformation import ( + AmazonAnthropicClaudeMessagesConfig, + ) + + config = AmazonAnthropicClaudeMessagesConfig() + + messages = [ + {"role": "user", "content": "What's the weather like?"} + ] + + anthropic_messages_optional_request_params = { + "max_tokens": 100, + } + + # Simulate advanced-tool-use header from Claude Code + headers = { + "anthropic-beta": "advanced-tool-use-2025-11-20" + } + + # Test with Claude Sonnet 4.5 (not Opus 4.5) + result = config.transform_anthropic_messages_request( + model="anthropic.claude-sonnet-4-5-20250929-v1:0", + messages=messages, + anthropic_messages_optional_request_params=anthropic_messages_optional_request_params, + litellm_params={}, + headers=headers, + ) + + # Verify advanced-tool-use header was removed + beta_headers = result.get("anthropic_beta", []) + assert "advanced-tool-use-2025-11-20" not in beta_headers, \ + "advanced-tool-use header should be removed for Bedrock" + + # Verify Bedrock-specific headers were NOT added (only for Opus 4.5) + assert "tool-search-tool-2025-10-19" not in beta_headers, \ + "tool-search-tool should not be added for non-Opus 4.5 models" + assert "tool-examples-2025-10-29" not in beta_headers, \ + "tool-examples should not be added for non-Opus 4.5 models" + + +def test_advanced_tool_use_header_translation_with_multiple_beta_headers(): + """ + Test that advanced-tool-use header translation works correctly when multiple + beta headers are present. + """ + from litellm.llms.bedrock.messages.invoke_transformations.anthropic_claude3_transformation import ( + AmazonAnthropicClaudeMessagesConfig, + ) + + config = AmazonAnthropicClaudeMessagesConfig() + + messages = [ + {"role": "user", "content": "What's the weather like?"} + ] + + anthropic_messages_optional_request_params = { + "max_tokens": 100, + } + + # Multiple beta headers including advanced-tool-use + headers = { + "anthropic-beta": "claude-code-20250219,advanced-tool-use-2025-11-20,interleaved-thinking-2025-05-14" + } + + # Test with Claude Opus 4.5 + result = config.transform_anthropic_messages_request( + model="anthropic.claude-opus-4-5-20250514-v1:0", + messages=messages, + anthropic_messages_optional_request_params=anthropic_messages_optional_request_params, + litellm_params={}, + headers=headers, + ) + + beta_headers = result.get("anthropic_beta", []) + + # Verify advanced-tool-use was removed + assert "advanced-tool-use-2025-11-20" not in beta_headers + + # Verify Bedrock-specific headers were added + assert "tool-search-tool-2025-10-19" in beta_headers + assert "tool-examples-2025-10-29" in beta_headers + + # Verify other beta headers are preserved + assert "claude-code-20250219" in beta_headers + assert "interleaved-thinking-2025-05-14" in beta_headers + + +def test_opus_4_5_model_detection(): + """ + Test that the _is_claude_opus_4_5 method correctly identifies Opus 4.5 models + with various naming conventions. + """ + from litellm.llms.bedrock.messages.invoke_transformations.anthropic_claude3_transformation import ( + AmazonAnthropicClaudeMessagesConfig, + ) + + config = AmazonAnthropicClaudeMessagesConfig() + + # Test various Opus 4.5 naming patterns + opus_4_5_models = [ + "anthropic.claude-opus-4-5-20250514-v1:0", + "anthropic.claude-opus-4.5-20250514-v1:0", + "anthropic.claude-opus_4_5-20250514-v1:0", + "anthropic.claude-opus_4.5-20250514-v1:0", + "us.anthropic.claude-opus-4-5-20250514-v1:0", + "ANTHROPIC.CLAUDE-OPUS-4-5-20250514-V1:0", # Case insensitive + ] + + for model in opus_4_5_models: + assert config._is_claude_opus_4_5(model), \ + f"Should detect {model} as Opus 4.5" + + # Test non-Opus 4.5 models + non_opus_4_5_models = [ + "anthropic.claude-sonnet-4-5-20250929-v1:0", + "anthropic.claude-opus-4-20250514-v1:0", # Opus 4, not 4.5 + "anthropic.claude-opus-4-1-20250514-v1:0", # Opus 4.1, not 4.5 + "anthropic.claude-haiku-4-5-20251001-v1:0", + ] + + for model in non_opus_4_5_models: + assert not config._is_claude_opus_4_5(model), \ + f"Should not detect {model} as Opus 4.5" diff --git a/tests/test_litellm/llms/bedrock/test_anthropic_beta_support.py b/tests/test_litellm/llms/bedrock/test_anthropic_beta_support.py index b9324e4966..0955636de6 100644 --- a/tests/test_litellm/llms/bedrock/test_anthropic_beta_support.py +++ b/tests/test_litellm/llms/bedrock/test_anthropic_beta_support.py @@ -390,3 +390,66 @@ class TestAnthropicBetaHeaderSupport: "anthropic_beta SHOULD be added for Anthropic models with cross-region prefix." ) assert "context-1m-2025-08-07" in additional_fields["anthropic_beta"] + + def test_messages_advanced_tool_use_translation_opus_4_5(self): + """Test that advanced-tool-use header is translated to Bedrock-specific headers for Opus 4.5. + + Regression test for: Claude Code sends advanced-tool-use-2025-11-20 header which needs + to be translated to tool-search-tool-2025-10-19 and tool-examples-2025-10-29 for + Bedrock Invoke API on Claude Opus 4.5. + + Ref: https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html + """ + config = AmazonAnthropicClaudeMessagesConfig() + headers = {"anthropic-beta": "advanced-tool-use-2025-11-20"} + + result = config.transform_anthropic_messages_request( + model="us.anthropic.claude-opus-4-5-20250514-v1:0", + messages=[{"role": "user", "content": "Test"}], + anthropic_messages_optional_request_params={"max_tokens": 100}, + litellm_params={}, + headers=headers + ) + + assert "anthropic_beta" in result + beta_headers = result["anthropic_beta"] + + # advanced-tool-use should be removed + assert "advanced-tool-use-2025-11-20" not in beta_headers, ( + "advanced-tool-use-2025-11-20 should be removed for Bedrock Invoke API" + ) + + # Bedrock-specific headers should be added for Opus 4.5 + assert "tool-search-tool-2025-10-19" in beta_headers, ( + "tool-search-tool-2025-10-19 should be added for Opus 4.5" + ) + assert "tool-examples-2025-10-29" in beta_headers, ( + "tool-examples-2025-10-29 should be added for Opus 4.5" + ) + + def test_messages_advanced_tool_use_filtered_non_opus_4_5(self): + """Test that advanced-tool-use header is filtered out for non-Opus 4.5 models. + + The translation to Bedrock-specific headers should only happen for Opus 4.5. + For other models, the advanced-tool-use header should just be removed. + """ + config = AmazonAnthropicClaudeMessagesConfig() + headers = {"anthropic-beta": "advanced-tool-use-2025-11-20"} + + # Test with Sonnet 4.5 (not Opus 4.5) + result = config.transform_anthropic_messages_request( + model="us.anthropic.claude-sonnet-4-5-20250929-v1:0", + messages=[{"role": "user", "content": "Test"}], + anthropic_messages_optional_request_params={"max_tokens": 100}, + litellm_params={}, + headers=headers + ) + + beta_headers = result.get("anthropic_beta", []) + + # advanced-tool-use should be removed + assert "advanced-tool-use-2025-11-20" not in beta_headers + + # Bedrock-specific headers should NOT be added for non-Opus 4.5 + assert "tool-search-tool-2025-10-19" not in beta_headers + assert "tool-examples-2025-10-29" not in beta_headers From faf9c9ba768ac446352d4f7329b762dd48c630ae Mon Sep 17 00:00:00 2001 From: Sameer Kankute Date: Tue, 27 Jan 2026 13:11:29 +0530 Subject: [PATCH 08/23] Add sarvam doc --- docs/my-website/docs/providers/sarvam.md | 89 ++++++++++++++++++++++++ docs/my-website/sidebars.js | 1 + 2 files changed, 90 insertions(+) create mode 100644 docs/my-website/docs/providers/sarvam.md diff --git a/docs/my-website/docs/providers/sarvam.md b/docs/my-website/docs/providers/sarvam.md new file mode 100644 index 0000000000..d77e9c0c75 --- /dev/null +++ b/docs/my-website/docs/providers/sarvam.md @@ -0,0 +1,89 @@ +# Sarvam.ai + +LiteLLM supports all the text models from [Sarvam ai](https://docs.sarvam.ai/api-reference-docs/chat/chat-completions) + +## Usage + +```python +import os +from litellm import completion + +# Set your Sarvam API key +os.environ["SARVAM_API_KEY"] = "" + +messages = [{"role": "user", "content": "Hello"}] + +response = completion( + model="sarvam/sarvam-m", + messages=messages, +) +print(response) +``` + +## Usage with LiteLLM Proxy Server + +Here's how to call a Sarvam.ai model with the LiteLLM Proxy Server + +1. **Modify the `config.yaml`:** + + ```yaml + model_list: + - model_name: my-model + litellm_params: + model: sarvam/ # add sarvam/ prefix to route as Sarvam provider + api_key: api-key # api key to send your model + ``` + +2. **Start the proxy:** + + ```bash + $ litellm --config /path/to/config.yaml + ``` + +3. **Send a request to LiteLLM Proxy Server:** + + + + + + ```python + import openai + + client = openai.OpenAI( + api_key="sk-1234", # pass litellm proxy key, if you're using virtual keys + base_url="http://0.0.0.0:4000" # litellm-proxy-base url + ) + + response = client.chat.completions.create( + model="my-model", + messages=[ + { + "role": "user", + "content": "what llm are you" + } + ], + ) + + print(response) + ``` + + + + + ```shell + curl --location 'http://0.0.0.0:4000/chat/completions' \ + --header 'Authorization: Bearer sk-1234' \ + --header 'Content-Type: application/json' \ + --data '{ + "model": "my-model", + "messages": [ + { + "role": "user", + "content": "what llm are you" + } + ] + }' + ``` + + + diff --git a/docs/my-website/sidebars.js b/docs/my-website/sidebars.js index 85573599e4..41854a4177 100644 --- a/docs/my-website/sidebars.js +++ b/docs/my-website/sidebars.js @@ -775,6 +775,7 @@ const sidebars = { "providers/oci", "providers/ollama", "providers/openrouter", + "providers/sarvam", "providers/ovhcloud", "providers/perplexity", "providers/petals", From cf012a2f657dab12f8fdda9d10de827517975f09 Mon Sep 17 00:00:00 2001 From: Sameer Kankute Date: Tue, 27 Jan 2026 13:50:47 +0530 Subject: [PATCH 09/23] Add gemini-robotics-er-1.5-preview model in model map --- ...odel_prices_and_context_window_backup.json | 37 +++++++++++++++++++ model_prices_and_context_window.json | 37 +++++++++++++++++++ 2 files changed, 74 insertions(+) diff --git a/litellm/model_prices_and_context_window_backup.json b/litellm/model_prices_and_context_window_backup.json index d958ea4503..7f33e96dbb 100644 --- a/litellm/model_prices_and_context_window_backup.json +++ b/litellm/model_prices_and_context_window_backup.json @@ -13480,6 +13480,43 @@ "supports_vision": true, "supports_web_search": true }, + "gemini-robotics-er-1.5-preview": { + "cache_read_input_token_cost": 0, + "input_cost_per_token": 3e-07, + "input_cost_per_audio_token": 1e-06, + "litellm_provider": "gemini", + "max_input_tokens": 1048576, + "max_output_tokens": 65535, + "max_tokens": 65535, + "mode": "chat", + "output_cost_per_token": 2.5e-06, + "output_cost_per_reasoning_token": 2.5e-06, + "source": "https://ai.google.dev/gemini-api/docs/models#gemini-robotics-er-1-5-preview", + "supported_endpoints": [ + "/v1/chat/completions", + "/v1/completions" + ], + "supported_modalities": [ + "text", + "image", + "video", + "audio" + ], + "supported_output_modalities": [ + "text" + ], + "supports_audio_output": false, + "supports_function_calling": true, + "supports_parallel_function_calling": true, + "supports_prompt_caching": false, + "supports_reasoning": true, + "supports_response_schema": true, + "supports_system_messages": true, + "supports_tool_choice": true, + "supports_url_context": true, + "supports_vision": true, + "supports_web_search": true + }, "gemini-2.5-computer-use-preview-10-2025": { "input_cost_per_token": 1.25e-06, "input_cost_per_token_above_200k_tokens": 2.5e-06, diff --git a/model_prices_and_context_window.json b/model_prices_and_context_window.json index d958ea4503..7f33e96dbb 100644 --- a/model_prices_and_context_window.json +++ b/model_prices_and_context_window.json @@ -13480,6 +13480,43 @@ "supports_vision": true, "supports_web_search": true }, + "gemini-robotics-er-1.5-preview": { + "cache_read_input_token_cost": 0, + "input_cost_per_token": 3e-07, + "input_cost_per_audio_token": 1e-06, + "litellm_provider": "gemini", + "max_input_tokens": 1048576, + "max_output_tokens": 65535, + "max_tokens": 65535, + "mode": "chat", + "output_cost_per_token": 2.5e-06, + "output_cost_per_reasoning_token": 2.5e-06, + "source": "https://ai.google.dev/gemini-api/docs/models#gemini-robotics-er-1-5-preview", + "supported_endpoints": [ + "/v1/chat/completions", + "/v1/completions" + ], + "supported_modalities": [ + "text", + "image", + "video", + "audio" + ], + "supported_output_modalities": [ + "text" + ], + "supports_audio_output": false, + "supports_function_calling": true, + "supports_parallel_function_calling": true, + "supports_prompt_caching": false, + "supports_reasoning": true, + "supports_response_schema": true, + "supports_system_messages": true, + "supports_tool_choice": true, + "supports_url_context": true, + "supports_vision": true, + "supports_web_search": true + }, "gemini-2.5-computer-use-preview-10-2025": { "input_cost_per_token": 1.25e-06, "input_cost_per_token_above_200k_tokens": 2.5e-06, From e273c858487b4c1b59deb92e918974c845544fcd Mon Sep 17 00:00:00 2001 From: Sameer Kankute Date: Tue, 27 Jan 2026 13:56:05 +0530 Subject: [PATCH 10/23] Add gemini-robotics-er-1.5-preview model documentation --- docs/my-website/docs/providers/gemini.md | 51 ++++++++++++++++++++++++ 1 file changed, 51 insertions(+) diff --git a/docs/my-website/docs/providers/gemini.md b/docs/my-website/docs/providers/gemini.md index 23a02f7365..b9ad7820dd 100644 --- a/docs/my-website/docs/providers/gemini.md +++ b/docs/my-website/docs/providers/gemini.md @@ -1840,6 +1840,57 @@ content = response.get('choices', [{}])[0].get('message', {}).get('content') print(content) ``` +## gemini-robotics-er-1.5-preview Usage + +```python +from litellm import api_base +from openai import OpenAI +import os +import base64 + +client = OpenAI(base_url="http://0.0.0.0:4000", api_key="sk-12345") +base64_image = base64.b64encode(open("closeup-object-on-table-many-260nw-1216144471.webp", "rb").read()).decode() + +import json +import re +tools = [{"codeExecution": {}}] +response = client.chat.completions.create( + model="gemini/gemini-robotics-er-1.5-preview", + messages=[ + { + "role": "user", + "content": [ + { + "type": "text", + "text": "Point to no more than 10 items in the image. The label returned should be an identifying name for the object detected. The answer should follow the json format: [{\"point\": [y, x], \"label\": }, ...]. The points are in [y, x] format normalized to 0-1000." + }, + { + "type": "image_url", + "image_url": {"url": f"data:image/jpeg;base64,{base64_image}"} + } + ] + } + ], + tools=tools +) + +# Extract JSON from markdown code block if present +content = response.choices[0].message.content +# Look for triple-backtick JSON block +match = re.search(r'```json\s*(.*?)\s*```', content, re.DOTALL) +if match: + json_str = match.group(1) +else: + json_str = content + +try: + data = json.loads(json_str) + print(json.dumps(data, indent=2)) +except Exception as e: + print("Error parsing response as JSON:", e) + print("Response content:", content) +``` + ## Usage - PDF / Videos / etc. Files ### Inline Data (e.g. audio stream) From 988dd2a911aaae4ef67f401eb5613a5ab960cac8 Mon Sep 17 00:00:00 2001 From: Sameer Kankute Date: Tue, 27 Jan 2026 14:35:54 +0530 Subject: [PATCH 11/23] Fix: Stream the download in chunks --- .../prompt_templates/image_handling.py | 14 ++-- .../litellm_core_utils/test_image_handling.py | 79 +++++++++++++++++++ 2 files changed, 88 insertions(+), 5 deletions(-) diff --git a/litellm/litellm_core_utils/prompt_templates/image_handling.py b/litellm/litellm_core_utils/prompt_templates/image_handling.py index 5d0bedb776..7137a4e422 100644 --- a/litellm/litellm_core_utils/prompt_templates/image_handling.py +++ b/litellm/litellm_core_utils/prompt_templates/image_handling.py @@ -31,15 +31,19 @@ def _process_image_response(response: Response, url: str) -> str: f"Error: Image size ({size_mb:.2f}MB) exceeds maximum allowed size ({MAX_IMAGE_URL_DOWNLOAD_SIZE_MB}MB). url={url}" ) - image_bytes = response.content + # Stream download with size checking to prevent downloading huge files + max_bytes = int(MAX_IMAGE_URL_DOWNLOAD_SIZE_MB * 1024 * 1024) + image_bytes = bytearray() + bytes_downloaded = 0 - # Check actual size after download if Content-Length was not available - if content_length is None: - size_mb = len(image_bytes) / (1024 * 1024) - if size_mb > MAX_IMAGE_URL_DOWNLOAD_SIZE_MB: + for chunk in response.iter_bytes(chunk_size=8192): + bytes_downloaded += len(chunk) + if bytes_downloaded > max_bytes: + size_mb = bytes_downloaded / (1024 * 1024) raise litellm.ImageFetchError( f"Error: Image size ({size_mb:.2f}MB) exceeds maximum allowed size ({MAX_IMAGE_URL_DOWNLOAD_SIZE_MB}MB). url={url}" ) + image_bytes.extend(chunk) base64_image = base64.b64encode(image_bytes).decode("utf-8") diff --git a/tests/test_litellm/litellm_core_utils/test_image_handling.py b/tests/test_litellm/litellm_core_utils/test_image_handling.py index b15d75a414..9c2939b2da 100644 --- a/tests/test_litellm/litellm_core_utils/test_image_handling.py +++ b/tests/test_litellm/litellm_core_utils/test_image_handling.py @@ -66,6 +66,41 @@ class LargeImageClient: ) +class StreamingLargeImageClient: + """ + Client that streams a large image to test streaming download protection. + This simulates a huge file without actually creating it all in memory. + """ + + def __init__(self, size_mb=100, include_content_length=False): + self.size_mb = size_mb + self.include_content_length = include_content_length + + def get(self, url, follow_redirects=True): + size_bytes = int(self.size_mb * 1024 * 1024) + headers = {"Content-Type": "image/jpeg"} + if self.include_content_length: + headers["Content-Length"] = str(size_bytes) + + # Create a generator that yields chunks without creating the whole file in memory + def generate_chunks(total_size, chunk_size=8192): + bytes_sent = 0 + while bytes_sent < total_size: + chunk = b"x" * min(chunk_size, total_size - bytes_sent) + bytes_sent += len(chunk) + yield chunk + + # Create response with streaming content + response = Response( + status_code=200, + headers=headers, + request=Request("GET", url), + ) + # Mock the iter_bytes method to return our generator + response.iter_bytes = lambda chunk_size=8192: generate_chunks(size_bytes, chunk_size) + return response + + def test_image_exceeds_size_limit_with_content_length(monkeypatch): """ Test that images exceeding MAX_IMAGE_URL_DOWNLOAD_SIZE_MB are rejected when Content-Length header is present. @@ -83,6 +118,7 @@ def test_image_exceeds_size_limit_with_content_length(monkeypatch): def test_image_exceeds_size_limit_without_content_length(monkeypatch): """ Test that images exceeding MAX_IMAGE_URL_DOWNLOAD_SIZE_MB are rejected even without Content-Length header. + This uses the old non-streaming mock for backward compatibility. """ monkeypatch.setattr( litellm, "module_level_client", LargeImageClient(size_mb=100, include_content_length=False) @@ -94,6 +130,29 @@ def test_image_exceeds_size_limit_without_content_length(monkeypatch): assert "exceeds maximum allowed size" in str(excinfo.value) +def test_streaming_download_protects_against_huge_files(monkeypatch): + """ + Test that streaming download aborts early when file exceeds size limit, + preventing memory exhaustion from huge files (e.g., petabyte-sized files). + + This test verifies that the streaming implementation doesn't download the entire + file into memory before checking size. Instead, it should abort as soon as the + limit is exceeded during streaming. + """ + # Simulate a 1GB file - far larger than the 50MB default limit + client = StreamingLargeImageClient(size_mb=1024, include_content_length=False) + monkeypatch.setattr(litellm, "module_level_client", client) + + with pytest.raises(litellm.ImageFetchError) as excinfo: + convert_url_to_base64("https://example.com/huge-image.jpg") + + # Verify the error message shows it was caught during streaming + assert "exceeds maximum allowed size" in str(excinfo.value) + + # The error should be raised after downloading just slightly more than the limit + # not after downloading the full 1GB + + class SmallImageClient: """ Client that returns a small valid image. @@ -124,6 +183,26 @@ def test_image_within_size_limit(monkeypatch): assert result.startswith("data:image/jpeg;base64,") +def test_streaming_download_handles_petabyte_file(monkeypatch): + """ + Test that streaming download can handle extremely large file URLs (e.g., petabyte-sized) + without attempting to download the entire file or causing memory exhaustion. + + This simulates what happens if a malicious actor or misconfiguration provides + a URL to an extremely large file. + """ + # Simulate a 1 petabyte file (1,000,000 GB) + # Without streaming protection, this would cause OOM or hang indefinitely + client = StreamingLargeImageClient(size_mb=1_000_000_000, include_content_length=False) + monkeypatch.setattr(litellm, "module_level_client", client) + + with pytest.raises(litellm.ImageFetchError) as excinfo: + convert_url_to_base64("https://example.com/petabyte-file.jpg") + + # Should fail fast without downloading anywhere near 1 petabyte + assert "exceeds maximum allowed size" in str(excinfo.value) + + def test_image_size_limit_disabled(monkeypatch): """ Test that setting MAX_IMAGE_URL_DOWNLOAD_SIZE_MB to 0 disables all image URL downloads. From e695cb53674c62d433bb8b3c5a5d335ce833e326 Mon Sep 17 00:00:00 2001 From: Sameer Kankute Date: Tue, 27 Jan 2026 16:34:57 +0530 Subject: [PATCH 12/23] Add grok reasoning content --- litellm/llms/groq/chat/transformation.py | 8 ++ tests/llm_translation/test_groq.py | 126 ++++++++++++++++++++++- 2 files changed, 133 insertions(+), 1 deletion(-) diff --git a/litellm/llms/groq/chat/transformation.py b/litellm/llms/groq/chat/transformation.py index a75ecd8cc7..34ea7b03dd 100644 --- a/litellm/llms/groq/chat/transformation.py +++ b/litellm/llms/groq/chat/transformation.py @@ -323,4 +323,12 @@ class GroqChatCompletionStreamingHandler(OpenAIChatCompletionStreamingHandler): status_code=error.get("code"), message=error.get("message"), body=error ) + # Map Groq's 'reasoning' field to LiteLLM's 'reasoning_content' field + # Groq returns delta.reasoning, but LiteLLM expects delta.reasoning_content + choices = chunk.get("choices", []) + for choice in choices: + delta = choice.get("delta", {}) + if "reasoning" in delta: + delta["reasoning_content"] = delta.pop("reasoning") + return super().chunk_parser(chunk) diff --git a/tests/llm_translation/test_groq.py b/tests/llm_translation/test_groq.py index 33c1a42587..b82cffd418 100644 --- a/tests/llm_translation/test_groq.py +++ b/tests/llm_translation/test_groq.py @@ -11,7 +11,10 @@ import pytest import litellm from base_llm_unit_tests import BaseLLMChatTest -from litellm.llms.groq.chat.transformation import GroqChatConfig +from litellm.llms.groq.chat.transformation import ( + GroqChatConfig, + GroqChatCompletionStreamingHandler, +) class TestGroq(BaseLLMChatTest): def get_base_completion_call_args(self) -> dict: @@ -164,3 +167,124 @@ class TestGroqStructuredOutputs: if "tools" in result: tool_names = [t.get("function", {}).get("name") for t in result["tools"]] assert "json_tool_call" not in tool_names + + +class TestGroqReasoning: + """ + Tests for Groq reasoning field mapping. + + Groq returns 'reasoning' field in delta, but LiteLLM expects 'reasoning_content'. + """ + + def test_reasoning_field_mapping_in_streaming_chunks(self): + """ + Test that Groq's 'reasoning' field in streaming chunks is properly mapped + to LiteLLM's 'reasoning_content' field. + """ + handler = GroqChatCompletionStreamingHandler( + streaming_response=None, sync_stream=True + ) + + # Simulate a chunk with reasoning field as returned by Groq + groq_chunk = { + "id": "chatcmpl-test", + "object": "chat.completion.chunk", + "created": 1769511767, + "model": "qwen/qwen3-32b", + "choices": [ + { + "delta": { + "reasoning": "This is reasoning content", + "role": None, + }, + "finish_reason": None, + "index": 0, + } + ], + } + + # Parse the chunk + parsed_chunk = handler.chunk_parser(groq_chunk) + + # Verify that reasoning was mapped to reasoning_content + assert parsed_chunk.choices[0].delta.reasoning_content == "This is reasoning content" + # Verify that the original 'reasoning' field was removed + assert not hasattr(parsed_chunk.choices[0].delta, "reasoning") + + def test_reasoning_field_not_present(self): + """ + Test that chunks without reasoning field still work correctly. + """ + handler = GroqChatCompletionStreamingHandler( + streaming_response=None, sync_stream=True + ) + + # Simulate a chunk without reasoning field + groq_chunk = { + "id": "chatcmpl-test", + "object": "chat.completion.chunk", + "created": 1769511767, + "model": "qwen/qwen3-32b", + "choices": [ + { + "delta": { + "content": "Regular content", + "role": "assistant", + }, + "finish_reason": None, + "index": 0, + } + ], + } + + # Parse the chunk + parsed_chunk = handler.chunk_parser(groq_chunk) + + # Verify that content is present + assert parsed_chunk.choices[0].delta.content == "Regular content" + assert parsed_chunk.choices[0].delta.role == "assistant" + # Verify that reasoning_content is not set (it should be deleted by Delta.__init__) + assert not hasattr(parsed_chunk.choices[0].delta, "reasoning_content") + + def test_reasoning_with_tool_calls(self): + """ + Test that reasoning field is properly mapped even when tool_calls are present. + """ + handler = GroqChatCompletionStreamingHandler( + streaming_response=None, sync_stream=True + ) + + # Simulate a chunk with both reasoning and tool_calls + groq_chunk = { + "id": "chatcmpl-test", + "object": "chat.completion.chunk", + "created": 1769511767, + "model": "qwen/qwen3-32b", + "choices": [ + { + "delta": { + "reasoning": "Reasoning before tool call", + "tool_calls": [ + { + "index": 0, + "id": "call_123", + "function": {"name": "test_function", "arguments": "{}"}, + "type": "function", + } + ], + }, + "finish_reason": None, + "index": 0, + } + ], + } + + # Parse the chunk + parsed_chunk = handler.chunk_parser(groq_chunk) + + # Verify that reasoning was mapped to reasoning_content + assert parsed_chunk.choices[0].delta.reasoning_content == "Reasoning before tool call" + # Verify tool_calls are still present + assert parsed_chunk.choices[0].delta.tool_calls is not None + assert len(parsed_chunk.choices[0].delta.tool_calls) == 1 + assert parsed_chunk.choices[0].delta.tool_calls[0]["function"]["name"] == "test_function" From 0f0b71e6d9755f74b94520977b55f066ee27891f Mon Sep 17 00:00:00 2001 From: Harshit Jain <48647625+Harshit28j@users.noreply.github.com> Date: Tue, 27 Jan 2026 22:46:53 +0530 Subject: [PATCH 13/23] feat: add feature to make silent calls (#19544) * feat: add feature to make silent calls * add test or silent feat * add docs for silent feat * fix lint issues and UI logs * add docs of ab testing and deep copy --- docs/my-website/docs/routing.md | 7 +- docs/my-website/docs/traffic_mirroring.md | 83 +++++++++ docs/my-website/sidebars.js | 1 + litellm/router.py | 138 +++++++++++++-- .../test_router_silent_experiment.py | 157 ++++++++++++++++++ 5 files changed, 373 insertions(+), 13 deletions(-) create mode 100644 docs/my-website/docs/traffic_mirroring.md create mode 100644 tests/test_litellm/test_router_silent_experiment.py diff --git a/docs/my-website/docs/routing.md b/docs/my-website/docs/routing.md index 47967775e1..b5ece7237a 100644 --- a/docs/my-website/docs/routing.md +++ b/docs/my-website/docs/routing.md @@ -828,7 +828,12 @@ asyncio.run(router_acompletion()) ``` - + +## Traffic Mirroring / Silent Experiments + +Traffic mirroring allows you to "mimic" production traffic to a secondary (silent) model for evaluation purposes. The silent model's response is gathered in the background and does not affect the latency or result of the primary request. + +[**See detailed guide on A/B Testing - Traffic Mirroring here**](./traffic_mirroring.md) ## Basic Reliability diff --git a/docs/my-website/docs/traffic_mirroring.md b/docs/my-website/docs/traffic_mirroring.md new file mode 100644 index 0000000000..3bdcb0f161 --- /dev/null +++ b/docs/my-website/docs/traffic_mirroring.md @@ -0,0 +1,83 @@ +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# A/B Testing - Traffic Mirroring + +Traffic mirroring allows you to "mimic" production traffic to a secondary (silent) model for evaluation purposes. The silent model's response is gathered in the background and does not affect the latency or result of the primary request. + +This is useful for: +- Testing a new model's performance on production prompts before switching. +- Comparing costs and latency between different providers. +- Debugging issues by mirroring traffic to a more verbose model. + +## Quick Start + +To enable traffic mirroring, add `silent_model` to the `litellm_params` of a deployment. + + + + +```python +from litellm import Router + +model_list = [ + { + "model_name": "gpt-3.5-turbo", + "litellm_params": { + "model": "azure/chatgpt-v-2", + "api_key": "...", + "silent_model": "gpt-4" # 👈 Mirror traffic to gpt-4 + }, + }, + { + "model_name": "gpt-4", + "litellm_params": { + "model": "openai/gpt-4", + "api_key": "..." + }, + } +] + +router = Router(model_list=model_list) + +# The request to "gpt-3.5-turbo" will trigger a background call to "gpt-4" +response = await router.acompletion( + model="gpt-3.5-turbo", + messages=[{"role": "user", "content": "How does traffic mirroring work?"}] +) +``` + + + + +Add `silent_model` to your `config.yaml`: + +```yaml +model_list: + - model_name: primary-model + litellm_params: + model: azure/gpt-35-turbo + api_key: os.environ/AZURE_API_KEY + silent_model: evaluation-model # 👈 Mirror traffic here + - model_name: evaluation-model + litellm_params: + model: openai/gpt-4o + api_key: os.environ/OPENAI_API_KEY +``` + + + + +## How it works +1. **Request Received**: A request is made to a model group (e.g. `primary-model`). +2. **Deployment Picked**: LiteLLM picks a deployment from the group. +3. **Primary Call**: LiteLLM makes the call to the primary deployment. +4. **Mirroring**: If `silent_model` is present, LiteLLM triggers a background call to that model. + - For **Sync** calls: Uses a shared thread pool. + - For **Async** calls: Uses `asyncio.create_task`. +5. **Isolation**: The background call uses a `deepcopy` of the original request parameters and sets `metadata["is_silent_experiment"] = True`. It also strips out logging IDs to prevent collisions in usage tracking. + +## Key Features +- **Latency Isolation**: The primary request returns as soon as it's ready. The background (silent) call does not block. +- **Unified Logging**: Background calls are processed via the Router, meaning they are automatically logged to your configured observability tools (Langfuse, S3, etc.). +- **Evaluation**: Use the `is_silent_experiment: True` flag in your logs to filter and compare results between the primary and mirrored calls. diff --git a/docs/my-website/sidebars.js b/docs/my-website/sidebars.js index 41854a4177..ef7573e9ce 100644 --- a/docs/my-website/sidebars.js +++ b/docs/my-website/sidebars.js @@ -364,6 +364,7 @@ const sidebars = { label: "Load Balancing, Routing, Fallbacks", href: "https://docs.litellm.ai/docs/routing-load-balancing", }, + "traffic_mirroring", { type: "category", label: "Logging, Alerting, Metrics", diff --git a/litellm/router.py b/litellm/router.py index 9fe37efa3a..09d71b6b49 100644 --- a/litellm/router.py +++ b/litellm/router.py @@ -58,6 +58,7 @@ from litellm.litellm_core_utils.core_helpers import ( _get_parent_otel_span_from_kwargs, get_metadata_variable_name_from_kwargs, ) +from litellm.litellm_core_utils.thread_pool_executor import executor from litellm.litellm_core_utils.coroutine_checker import coroutine_checker from litellm.litellm_core_utils.credential_accessor import CredentialAccessor from litellm.litellm_core_utils.dd_tracing import tracer @@ -1250,10 +1251,25 @@ class Router: specific_deployment=kwargs.pop("specific_deployment", None), request_kwargs=kwargs, ) - self._update_kwargs_with_deployment(deployment=deployment, kwargs=kwargs) + # Check for silent model experiment + # Make a local copy of litellm_params to avoid mutating the Router's state + litellm_params = deployment["litellm_params"].copy() + silent_model = litellm_params.pop("silent_model", None) + if silent_model is not None: + # Mirroring traffic to a secondary model + # Use shared thread pool for background calls + executor.submit( + self._silent_experiment_completion, + silent_model, + messages, + **kwargs, + ) + + self._update_kwargs_with_deployment(deployment=deployment, kwargs=kwargs) + kwargs.pop("silent_model", None) # Ensure it's not in kwargs either # No copy needed - data is only read and spread into new dict below - data = deployment["litellm_params"] + data = litellm_params.copy() # Use the local copy of litellm_params model_name = data["model"] potential_model_client = self._get_client( deployment=deployment, kwargs=kwargs @@ -1274,15 +1290,14 @@ class Router: if not self.has_model_id(model): self.routing_strategy_pre_call_checks(deployment=deployment) - response = litellm.completion( - **{ - **data, - "messages": messages, - "caching": self.cache_responses, - "client": model_client, - **kwargs, - } - ) + input_kwargs = { + **data, + "messages": messages, + "caching": self.cache_responses, + "client": model_client, + **kwargs, + } + response = litellm.completion(**input_kwargs) verbose_router_logger.info( f"litellm.completion(model={model_name})\033[32m 200 OK\033[0m" ) @@ -1309,6 +1324,56 @@ class Router: self._set_deployment_num_retries_on_exception(e, deployment) raise e + def _get_silent_experiment_kwargs(self, **kwargs) -> dict: + """ + Prepare kwargs for a silent experiment by ensuring isolation from the primary call. + """ + # Copy kwargs to ensure isolation + silent_kwargs = copy.deepcopy(kwargs) + if "metadata" not in silent_kwargs: + silent_kwargs["metadata"] = {} + + silent_kwargs["metadata"]["is_silent_experiment"] = True + + # Pop logging objects and call IDs to ensure a fresh logging context + # This prevents collisions in the Proxy's database (spend_logs) + silent_kwargs.pop("litellm_call_id", None) + silent_kwargs.pop("litellm_logging_obj", None) + silent_kwargs.pop("standard_logging_object", None) + silent_kwargs.pop("proxy_server_request", None) + + return silent_kwargs + + def _silent_experiment_completion( + self, silent_model: str, messages: List[Any], **kwargs + ): + """ + Run a silent experiment in the background (thread). + """ + try: + # Prevent infinite recursion if silent model also has a silent model + if kwargs.get("metadata", {}).get("is_silent_experiment", False): + return + + messages = copy.deepcopy(messages) + + verbose_router_logger.info( + f"Starting silent experiment for model {silent_model}" + ) + + silent_kwargs = self._get_silent_experiment_kwargs(**kwargs) + + # Trigger the silent request + self.completion( + model=silent_model, + messages=cast(List[Dict[str, str]], messages), + **silent_kwargs, + ) + except Exception as e: + verbose_router_logger.error( + f"Silent experiment failed for model {silent_model}: {str(e)}" + ) + # fmt: off @overload @@ -1517,6 +1582,36 @@ class Router: return FallbackStreamWrapper(stream_with_fallbacks()) + async def _silent_experiment_acompletion( + self, silent_model: str, messages: List[Any], **kwargs + ): + """ + Run a silent experiment in the background. + """ + try: + # Prevent infinite recursion if silent model also has a silent model + if kwargs.get("metadata", {}).get("is_silent_experiment", False): + return + + messages = copy.deepcopy(messages) + + verbose_router_logger.info( + f"Starting silent experiment for model {silent_model}" + ) + + silent_kwargs = self._get_silent_experiment_kwargs(**kwargs) + + # Trigger the silent request + await self.acompletion( + model=silent_model, + messages=cast(List[AllMessageValues], messages), + **silent_kwargs, + ) + except Exception as e: + verbose_router_logger.error( + f"Silent experiment failed for model {silent_model}: {str(e)}" + ) + async def _acompletion( # noqa: PLR0915 self, model: str, messages: List[Dict[str, str]], **kwargs ) -> Union[ModelResponse, CustomStreamWrapper,]: @@ -1563,9 +1658,27 @@ class Router: self._track_deployment_metrics( deployment=deployment, parent_otel_span=parent_otel_span ) + + # Check for silent model experiment + # Make a local copy of litellm_params to avoid mutating the Router's state + litellm_params = deployment["litellm_params"].copy() + silent_model = litellm_params.pop("silent_model", None) + + if silent_model is not None: + # Mirroring traffic to a secondary model + # This is a silent experiment, so we don't want to block the primary request + asyncio.create_task( + self._silent_experiment_acompletion( + silent_model=silent_model, + messages=messages, # Use messages instead of *args + **kwargs, + ) + ) + self._update_kwargs_with_deployment(deployment=deployment, kwargs=kwargs) + kwargs.pop("silent_model", None) # Ensure it's not in kwargs either # No copy needed - data is only read and spread into new dict below - data = deployment["litellm_params"] + data = litellm_params.copy() # Use the local copy of litellm_params model_name = data["model"] @@ -1582,6 +1695,7 @@ class Router: "client": model_client, **kwargs, } + input_kwargs.pop("silent_model", None) _response = litellm.acompletion(**input_kwargs) diff --git a/tests/test_litellm/test_router_silent_experiment.py b/tests/test_litellm/test_router_silent_experiment.py new file mode 100644 index 0000000000..9b82cde13c --- /dev/null +++ b/tests/test_litellm/test_router_silent_experiment.py @@ -0,0 +1,157 @@ +import asyncio +from unittest.mock import MagicMock, patch + +import pytest + +import litellm +from litellm.router import Router + + +@pytest.mark.asyncio +async def test_router_silent_experiment_acompletion(): + """ + Test that silent_model triggers a background acompletion call + and that the silent_model parameter is stripped from both calls. + """ + model_list = [ + { + "model_name": "primary-model", + "litellm_params": { + "model": "openai/gpt-3.5-turbo", + "api_key": "fake-key", + "silent_model": "silent-model", + }, + }, + { + "model_name": "silent-model", + "litellm_params": { + "model": "openai/gpt-4", + "api_key": "fake-key", + }, + }, + ] + + router = Router(model_list=model_list) + + # Mock litellm.acompletion + mock_acompletion = MagicMock() + # Create a future that resolves to a ModelResponse + mock_response = litellm.ModelResponse(choices=[{"message": {"content": "hello"}}]) + future = asyncio.Future() + future.set_result(mock_response) + mock_acompletion.return_value = future + + with patch("litellm.acompletion", mock_acompletion): + response = await router.acompletion( + model="primary-model", + messages=[{"role": "user", "content": "hi"}], + ) + + assert response.choices[0].message.content == "hello" + + # Give the background task a moment to trigger (it's an asyncio task) + await asyncio.sleep(0.1) + + # Should have 2 calls: one for primary, one for silent + assert mock_acompletion.call_count == 2 + + # Check call arguments + call_args_list = mock_acompletion.call_args_list + + # Verify no silent_model in any call to litellm.acompletion + for call in call_args_list: + args, kwargs = call + assert "silent_model" not in kwargs + if "metadata" in kwargs: + # One call should have is_silent_experiment=True + pass + + # Find the silent call + silent_call = next( + ( + c + for c in call_args_list + if c[1].get("metadata", {}).get("is_silent_experiment") is True + ), + None, + ) + assert silent_call is not None + assert silent_call[1]["model"] == "openai/gpt-4" + + # Find the primary call + primary_call = next( + ( + c + for c in call_args_list + if not c[1].get("metadata", {}).get("is_silent_experiment") + ), + None, + ) + assert primary_call is not None + assert primary_call[1]["model"] == "openai/gpt-3.5-turbo" + + +def test_router_silent_experiment_completion(): + """ + Test that silent_model triggers a background completion call (sync) + and that the silent_model parameter is stripped. + """ + model_list = [ + { + "model_name": "primary-model", + "litellm_params": { + "model": "openai/gpt-3.5-turbo", + "api_key": "fake-key", + "silent_model": "silent-model", + }, + }, + { + "model_name": "silent-model", + "litellm_params": { + "model": "openai/gpt-4", + "api_key": "fake-key", + }, + }, + ] + + router = Router(model_list=model_list) + + # Mock litellm.completion + mock_completion = MagicMock() + mock_response = litellm.ModelResponse(choices=[{"message": {"content": "hello"}}]) + mock_completion.return_value = mock_response + + with patch("litellm.completion", mock_completion): + response = router.completion( + model="primary-model", + messages=[{"role": "user", "content": "hi"}], + ) + + assert response.choices[0].message.content == "hello" + + # The sync background call uses a thread pool. We might need to wait a bit. + import time + + time.sleep(0.5) + + # Should have 2 calls + assert mock_completion.call_count == 2 + + call_args_list = mock_completion.call_args_list + + # Verify no silent_model in any call + for call in call_args_list: + args, kwargs = call + assert "silent_model" not in kwargs + + # Find the silent call + silent_call = next( + ( + c + for c in call_args_list + if c[1].get("metadata", {}).get("is_silent_experiment") is True + ), + None, + ) + assert silent_call is not None + assert silent_call[1]["model"] == "openai/gpt-4" From fc7a9b4cb076e91b42e427df54fcac6513faac65 Mon Sep 17 00:00:00 2001 From: michelligabriele Date: Tue, 27 Jan 2026 18:34:30 +0100 Subject: [PATCH 14/23] fix(enterprise): correct error message for DISABLE_ADMIN_ENDPOINTS (#19861) The error message for DISABLE_ADMIN_ENDPOINTS incorrectly said "DISABLING LLM API ENDPOINTS is an Enterprise feature" instead of "DISABLING ADMIN ENDPOINTS is an Enterprise feature". This was a copy-paste bug from the is_llm_api_route_disabled() function. Added regression tests to verify both error messages are correct. --- .../proxy/auth/route_checks.py | 2 +- .../proxy/auth/test_route_checks.py | 65 +++++++++++++++++++ 2 files changed, 66 insertions(+), 1 deletion(-) diff --git a/enterprise/litellm_enterprise/proxy/auth/route_checks.py b/enterprise/litellm_enterprise/proxy/auth/route_checks.py index 6cce781faf..6f7cf9143f 100644 --- a/enterprise/litellm_enterprise/proxy/auth/route_checks.py +++ b/enterprise/litellm_enterprise/proxy/auth/route_checks.py @@ -36,7 +36,7 @@ class EnterpriseRouteChecks: if not premium_user: raise HTTPException( status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, - detail=f"🚨🚨🚨 DISABLING LLM API ENDPOINTS is an Enterprise feature\n🚨 {CommonProxyErrors.not_premium_user.value}", + detail=f"🚨🚨🚨 DISABLING ADMIN ENDPOINTS is an Enterprise feature\n🚨 {CommonProxyErrors.not_premium_user.value}", ) return get_secret_bool("DISABLE_ADMIN_ENDPOINTS") is True diff --git a/tests/enterprise/litellm_enterprise/proxy/auth/test_route_checks.py b/tests/enterprise/litellm_enterprise/proxy/auth/test_route_checks.py index ce77ff69e0..706e3b7187 100644 --- a/tests/enterprise/litellm_enterprise/proxy/auth/test_route_checks.py +++ b/tests/enterprise/litellm_enterprise/proxy/auth/test_route_checks.py @@ -180,3 +180,68 @@ class TestEnterpriseRouteChecks: # Should not raise exception since management routes are enabled EnterpriseRouteChecks.should_call_route("/config/update") + + +class TestEnterpriseRouteChecksErrorMessages: + """Test that error messages correctly identify which feature requires Enterprise license""" + + @patch("litellm.secret_managers.main.get_secret_bool") + @patch("litellm.proxy.proxy_server.premium_user", False) + def test_disable_llm_api_endpoints_error_message(self, mock_get_secret_bool): + """ + Test that when DISABLE_LLM_API_ENDPOINTS is set without Enterprise license, + the error message correctly mentions 'LLM API ENDPOINTS' + """ + with patch.dict(os.environ, {"DISABLE_LLM_API_ENDPOINTS": "true"}): + with pytest.raises(HTTPException) as exc_info: + EnterpriseRouteChecks.is_llm_api_route_disabled() + + assert exc_info.value.status_code == 500 + assert "DISABLING LLM API ENDPOINTS is an Enterprise feature" in str( + exc_info.value.detail + ) + + @patch("litellm.secret_managers.main.get_secret_bool") + @patch("litellm.proxy.proxy_server.premium_user", False) + def test_disable_admin_endpoints_error_message(self, mock_get_secret_bool): + """ + Test that when DISABLE_ADMIN_ENDPOINTS is set without Enterprise license, + the error message correctly mentions 'ADMIN ENDPOINTS' (not 'LLM API ENDPOINTS') + + This is a regression test for a bug where the error message incorrectly said + 'DISABLING LLM API ENDPOINTS' when the actual issue was DISABLE_ADMIN_ENDPOINTS. + """ + with patch.dict(os.environ, {"DISABLE_ADMIN_ENDPOINTS": "true"}): + with pytest.raises(HTTPException) as exc_info: + EnterpriseRouteChecks.is_management_routes_disabled() + + assert exc_info.value.status_code == 500 + assert "DISABLING ADMIN ENDPOINTS is an Enterprise feature" in str( + exc_info.value.detail + ) + # Ensure it does NOT mention LLM API ENDPOINTS (the old buggy message) + assert "LLM API ENDPOINTS" not in str(exc_info.value.detail) + + @patch("litellm.secret_managers.main.get_secret_bool") + @patch("litellm.proxy.proxy_server.premium_user", True) + def test_disable_llm_api_endpoints_with_premium_user(self, mock_get_secret_bool): + """ + Test that premium users can use DISABLE_LLM_API_ENDPOINTS without error + """ + mock_get_secret_bool.return_value = True + with patch.dict(os.environ, {"DISABLE_LLM_API_ENDPOINTS": "true"}): + # Should not raise exception for premium users + result = EnterpriseRouteChecks.is_llm_api_route_disabled() + assert result is True + + @patch("litellm.secret_managers.main.get_secret_bool") + @patch("litellm.proxy.proxy_server.premium_user", True) + def test_disable_admin_endpoints_with_premium_user(self, mock_get_secret_bool): + """ + Test that premium users can use DISABLE_ADMIN_ENDPOINTS without error + """ + mock_get_secret_bool.return_value = True + with patch.dict(os.environ, {"DISABLE_ADMIN_ENDPOINTS": "true"}): + # Should not raise exception for premium users + result = EnterpriseRouteChecks.is_management_routes_disabled() + assert result is True From 388b4c90b6df3e7bacda5bb3097e2f713a82658f Mon Sep 17 00:00:00 2001 From: michelligabriele Date: Tue, 27 Jan 2026 18:34:58 +0100 Subject: [PATCH 15/23] fix(proxy): handle agent parameter in /interactions endpoint (#19866) --- litellm/proxy/google_endpoints/endpoints.py | 2 +- litellm/proxy/route_llm_request.py | 3 +- .../test_interactions_agent_param.py | 75 +++++++++++++++++++ 3 files changed, 78 insertions(+), 2 deletions(-) create mode 100644 tests/test_litellm/proxy/google_endpoints/test_interactions_agent_param.py diff --git a/litellm/proxy/google_endpoints/endpoints.py b/litellm/proxy/google_endpoints/endpoints.py index bba5b87024..5c41b371ca 100644 --- a/litellm/proxy/google_endpoints/endpoints.py +++ b/litellm/proxy/google_endpoints/endpoints.py @@ -264,7 +264,7 @@ async def create_interaction( general_settings=general_settings, proxy_config=proxy_config, select_data_generator=select_data_generator, - model=data.get("model"), + model=data.get("model") or data.get("agent"), user_model=user_model, user_temperature=user_temperature, user_request_timeout=user_request_timeout, diff --git a/litellm/proxy/route_llm_request.py b/litellm/proxy/route_llm_request.py index 236f58bb82..af441ee43e 100644 --- a/litellm/proxy/route_llm_request.py +++ b/litellm/proxy/route_llm_request.py @@ -221,8 +221,9 @@ async def route_request( "aretrieve_container_file_content", ]: return getattr(llm_router, f"{route_type}")(**data) - # Interactions API: get/delete/cancel don't need model routing + # Interactions API: create with agent, get/delete/cancel don't need model routing if route_type in [ + "acreate_interaction", "aget_interaction", "adelete_interaction", "acancel_interaction", diff --git a/tests/test_litellm/proxy/google_endpoints/test_interactions_agent_param.py b/tests/test_litellm/proxy/google_endpoints/test_interactions_agent_param.py new file mode 100644 index 0000000000..1063f59afb --- /dev/null +++ b/tests/test_litellm/proxy/google_endpoints/test_interactions_agent_param.py @@ -0,0 +1,75 @@ +""" +Test for interactions endpoint agent parameter handling. + +Tests that the /v1beta/interactions endpoint correctly extracts +the `agent` parameter as a fallback when `model` is not provided. +""" + +import pytest + + +class TestInteractionsAgentParameter: + """Test agent parameter handling in interactions endpoint.""" + + def test_agent_parameter_fallback_logic(self): + """ + Test the core logic: model or agent extraction. + + This tests the fix in endpoints.py line ~267: + model=data.get("model") or data.get("agent") + """ + # Case 1: Only agent provided (Deep Research use case) + data = { + "agent": "deep-research-pro-preview-12-2025", + "input": "Research quantum computing", + "background": True, + } + model = data.get("model") or data.get("agent") + assert model == "deep-research-pro-preview-12-2025" + + # Case 2: Only model provided (normal use case) + data = { + "model": "gemini-2.5-flash", + "input": "Hello world", + } + model = data.get("model") or data.get("agent") + assert model == "gemini-2.5-flash" + + # Case 3: Both provided (model takes precedence) + data = { + "model": "gemini-2.5-flash", + "agent": "deep-research-pro-preview-12-2025", + "input": "Test", + } + model = data.get("model") or data.get("agent") + assert model == "gemini-2.5-flash" + + # Case 4: Neither provided + data = { + "input": "Test", + } + model = data.get("model") or data.get("agent") + assert model is None + + def test_route_type_in_skip_model_routing_list(self): + """ + Test that acreate_interaction is in the list of routes + that skip model-based routing. + + This tests the fix in route_llm_request.py. + """ + # The list of routes that skip model routing for interactions + skip_model_routing_routes = [ + "acreate_interaction", + "aget_interaction", + "adelete_interaction", + "acancel_interaction", + ] + + # acreate_interaction should be in the list (this is the fix) + assert "acreate_interaction" in skip_model_routing_routes + + # All interaction routes should be covered + assert "aget_interaction" in skip_model_routing_routes + assert "adelete_interaction" in skip_model_routing_routes + assert "acancel_interaction" in skip_model_routing_routes From 7d5439addac7a291d5e37a5e261a6557d37bed11 Mon Sep 17 00:00:00 2001 From: michelligabriele Date: Tue, 27 Jan 2026 21:17:09 +0100 Subject: [PATCH 16/23] fix(bedrock): support tool search header translation for Sonnet 4.5 (#19871) Extend advanced-tool-use header translation to include Claude Sonnet 4.5 in addition to Opus 4.5 on Bedrock Invoke API. When Claude Code sends the advanced-tool-use-2025-11-20 header, it now gets correctly translated to Bedrock-specific headers for both: - Claude Opus 4.5 - Claude Sonnet 4.5 Headers translated: - tool-search-tool-2025-10-19 - tool-examples-2025-10-29 Fixes defer_loading validation error on Bedrock with Sonnet 4.5. Ref: https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-search-tool --- .../anthropic_claude3_transformation.py | 39 ++++++++++-- .../bedrock/test_anthropic_beta_support.py | 59 +++++++++++++++---- 2 files changed, 82 insertions(+), 16 deletions(-) diff --git a/litellm/llms/bedrock/messages/invoke_transformations/anthropic_claude3_transformation.py b/litellm/llms/bedrock/messages/invoke_transformations/anthropic_claude3_transformation.py index 67ca9d5024..fc4220c054 100644 --- a/litellm/llms/bedrock/messages/invoke_transformations/anthropic_claude3_transformation.py +++ b/litellm/llms/bedrock/messages/invoke_transformations/anthropic_claude3_transformation.py @@ -178,6 +178,33 @@ class AmazonAnthropicClaudeMessagesConfig( ] return any(pattern in model_lower for pattern in opus_4_5_patterns) + def _supports_tool_search_on_bedrock(self, model: str) -> bool: + """ + Check if the model supports tool search on Bedrock. + + On Amazon Bedrock, server-side tool search is supported on Claude Opus 4.5 + and Claude Sonnet 4.5 with the tool-search-tool-2025-10-19 beta header. + + Ref: https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-search-tool + + Args: + model: The model name + + Returns: + True if the model supports tool search on Bedrock + """ + model_lower = model.lower() + + # Supported models for tool search on Bedrock + supported_patterns = [ + # Opus 4.5 + "opus-4.5", "opus_4.5", "opus-4-5", "opus_4_5", + # Sonnet 4.5 + "sonnet-4.5", "sonnet_4.5", "sonnet-4-5", "sonnet_4_5", + ] + + return any(pattern in model_lower for pattern in supported_patterns) + def _filter_unsupported_beta_headers_for_bedrock( self, model: str, beta_set: set ) -> None: @@ -186,13 +213,14 @@ class AmazonAnthropicClaudeMessagesConfig( Extended thinking beta headers are only supported on specific Claude 4+ models. Advanced tool use headers are not supported on Bedrock Invoke API, but need to be - translated to Bedrock-specific headers for Claude Opus 4.5. + translated to Bedrock-specific headers for models that support tool search + (Claude Opus 4.5, Sonnet 4.5). This prevents 400 "invalid beta flag" errors on Bedrock. Note: Bedrock Invoke API fails with a 400 error when unsupported beta headers are sent, returning: {"message":"invalid beta flag"} - Translation for Claude Opus 4.5: + Translation for models supporting tool search (Opus 4.5, Sonnet 4.5): - advanced-tool-use-2025-11-20 -> tool-search-tool-2025-10-19 + tool-examples-2025-10-29 Args: @@ -226,10 +254,11 @@ class AmazonAnthropicClaudeMessagesConfig( # Remove all filtered headers for beta in beta_headers_to_remove: beta_set.discard(beta) - - # 3. Translate advanced-tool-use to Bedrock-specific headers for Claude Opus 4.5 + + # 3. Translate advanced-tool-use to Bedrock-specific headers for models that support tool search # Ref: https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html - if has_advanced_tool_use and self._is_claude_opus_4_5(model): + # Ref: https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-search-tool + if has_advanced_tool_use and self._supports_tool_search_on_bedrock(model): beta_set.add("tool-search-tool-2025-10-19") beta_set.add("tool-examples-2025-10-29") diff --git a/tests/test_litellm/llms/bedrock/test_anthropic_beta_support.py b/tests/test_litellm/llms/bedrock/test_anthropic_beta_support.py index 0955636de6..e7b6de29b6 100644 --- a/tests/test_litellm/llms/bedrock/test_anthropic_beta_support.py +++ b/tests/test_litellm/llms/bedrock/test_anthropic_beta_support.py @@ -427,16 +427,18 @@ class TestAnthropicBetaHeaderSupport: "tool-examples-2025-10-29 should be added for Opus 4.5" ) - def test_messages_advanced_tool_use_filtered_non_opus_4_5(self): - """Test that advanced-tool-use header is filtered out for non-Opus 4.5 models. - - The translation to Bedrock-specific headers should only happen for Opus 4.5. - For other models, the advanced-tool-use header should just be removed. + def test_messages_advanced_tool_use_translation_sonnet_4_5(self): + """Test that advanced-tool-use header is translated to Bedrock-specific headers for Sonnet 4.5. + + Regression test for: Claude Code sends advanced-tool-use-2025-11-20 header which needs + to be translated to tool-search-tool-2025-10-19 and tool-examples-2025-10-29 for + Bedrock Invoke API on Claude Sonnet 4.5. + + Ref: https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-search-tool """ config = AmazonAnthropicClaudeMessagesConfig() headers = {"anthropic-beta": "advanced-tool-use-2025-11-20"} - - # Test with Sonnet 4.5 (not Opus 4.5) + result = config.transform_anthropic_messages_request( model="us.anthropic.claude-sonnet-4-5-20250929-v1:0", messages=[{"role": "user", "content": "Test"}], @@ -444,12 +446,47 @@ class TestAnthropicBetaHeaderSupport: litellm_params={}, headers=headers ) - + + assert "anthropic_beta" in result + beta_headers = result["anthropic_beta"] + + # advanced-tool-use should be removed + assert "advanced-tool-use-2025-11-20" not in beta_headers, ( + "advanced-tool-use-2025-11-20 should be removed for Bedrock Invoke API" + ) + + # Bedrock-specific headers should be added for Sonnet 4.5 + assert "tool-search-tool-2025-10-19" in beta_headers, ( + "tool-search-tool-2025-10-19 should be added for Sonnet 4.5" + ) + assert "tool-examples-2025-10-29" in beta_headers, ( + "tool-examples-2025-10-29 should be added for Sonnet 4.5" + ) + + def test_messages_advanced_tool_use_filtered_unsupported_model(self): + """Test that advanced-tool-use header is filtered out for models that don't support tool search. + + The translation to Bedrock-specific headers should only happen for models that + support tool search on Bedrock (Opus 4.5, Sonnet 4.5). + For other models, the advanced-tool-use header should just be removed. + """ + config = AmazonAnthropicClaudeMessagesConfig() + headers = {"anthropic-beta": "advanced-tool-use-2025-11-20"} + + # Test with Claude 3.5 Sonnet (does NOT support tool search on Bedrock) + result = config.transform_anthropic_messages_request( + model="us.anthropic.claude-3-5-sonnet-20241022-v2:0", + messages=[{"role": "user", "content": "Test"}], + anthropic_messages_optional_request_params={"max_tokens": 100}, + litellm_params={}, + headers=headers + ) + beta_headers = result.get("anthropic_beta", []) - + # advanced-tool-use should be removed assert "advanced-tool-use-2025-11-20" not in beta_headers - - # Bedrock-specific headers should NOT be added for non-Opus 4.5 + + # Bedrock-specific headers should NOT be added for unsupported models assert "tool-search-tool-2025-10-19" not in beta_headers assert "tool-examples-2025-10-29" not in beta_headers From fe444f3ed5cae334d013450f96befdad113a09a2 Mon Sep 17 00:00:00 2001 From: Ishaan Jaff Date: Tue, 27 Jan 2026 14:45:26 -0800 Subject: [PATCH 17/23] [Feat] RAG API - Add support for using s3 Vectors as Vector Store Provider for /rag/ingest (#19888) * init S3VectorsRAGIngestion as a supported ingestion provider for RAG API * test: TestRAGS3Vectors * init S3VectorsVectorStoreOptions * init s3 vectors * code clean up + QA * fix: get_credentials * S3VectorsRAGIngestion * TestRAGS3Vectors * docs: AWS S3 Vectors * add asyncio QA checks * fix: S3_VECTORS_DEFAULT_DIMENSION --- docs/my-website/docs/rag_ingest.md | 78 ++- litellm/constants.py | 7 + ...odel_prices_and_context_window_backup.json | 42 ++ litellm/rag/ingestion/s3_vectors_ingestion.py | 546 ++++++++++++++++++ litellm/rag/main.py | 2 + litellm/types/rag.py | 46 +- .../rag/test_rag_s3_vectors.py | 107 ++++ 7 files changed, 826 insertions(+), 2 deletions(-) create mode 100644 litellm/rag/ingestion/s3_vectors_ingestion.py create mode 100644 tests/vector_store_tests/rag/test_rag_s3_vectors.py diff --git a/docs/my-website/docs/rag_ingest.md b/docs/my-website/docs/rag_ingest.md index 1133b85f20..7adc2d70b5 100644 --- a/docs/my-website/docs/rag_ingest.md +++ b/docs/my-website/docs/rag_ingest.md @@ -5,7 +5,7 @@ All-in-one document ingestion pipeline: **Upload → Chunk → Embed → Vector | Feature | Supported | |---------|-----------| | Logging | Yes | -| Supported Providers | `openai`, `bedrock`, `vertex_ai`, `gemini` | +| Supported Providers | `openai`, `bedrock`, `vertex_ai`, `gemini`, `s3_vectors` | :::tip After ingesting documents, use [/rag/query](./rag_query.md) to search and generate responses with your ingested content. @@ -75,6 +75,31 @@ curl -X POST "http://localhost:4000/v1/rag/ingest" \ }" ``` +### AWS S3 Vectors + +```bash showLineNumbers title="Ingest to S3 Vectors" +curl -X POST "http://localhost:4000/v1/rag/ingest" \ + -H "Authorization: Bearer sk-1234" \ + -H "Content-Type: application/json" \ + -d "{ + \"file\": { + \"filename\": \"document.txt\", + \"content\": \"$(base64 -i document.txt)\", + \"content_type\": \"text/plain\" + }, + \"ingest_options\": { + \"embedding\": { + \"model\": \"text-embedding-3-small\" + }, + \"vector_store\": { + \"custom_llm_provider\": \"s3_vectors\", + \"vector_bucket_name\": \"my-embeddings\", + \"aws_region_name\": \"us-west-2\" + } + } + }" +``` + ## Response ```json @@ -265,6 +290,57 @@ When `vector_store_id` is omitted, LiteLLM automatically creates: 4. Install: `pip install 'google-cloud-aiplatform>=1.60.0'` ::: +### vector_store (AWS S3 Vectors) + +| Parameter | Type | Default | Description | +|-----------|------|---------|-------------| +| `custom_llm_provider` | string | - | `"s3_vectors"` | +| `vector_bucket_name` | string | **required** | S3 vector bucket name | +| `index_name` | string | auto-create | Vector index name | +| `dimension` | integer | auto-detect | Vector dimension (auto-detected from embedding model) | +| `distance_metric` | string | `cosine` | Distance metric: `cosine` or `euclidean` | +| `non_filterable_metadata_keys` | array | `["source_text"]` | Metadata keys excluded from filtering | +| `aws_region_name` | string | `us-west-2` | AWS region | +| `aws_access_key_id` | string | env | AWS access key | +| `aws_secret_access_key` | string | env | AWS secret key | + +:::info S3 Vectors Auto-Creation +When `index_name` is omitted, LiteLLM automatically creates: +- S3 vector bucket (if it doesn't exist) +- Vector index with auto-detected dimensions from your embedding model + +**Dimension Auto-Detection**: The vector dimension is automatically detected by making a test embedding request to your specified model. No need to manually specify dimensions! + +**Supported Embedding Models**: Works with any LiteLLM-supported embedding model (OpenAI, Cohere, Bedrock, Azure, etc.) +::: + +**Example with auto-detection:** +```json +{ + "embedding": { + "model": "text-embedding-3-small" // Dimension auto-detected as 1536 + }, + "vector_store": { + "custom_llm_provider": "s3_vectors", + "vector_bucket_name": "my-embeddings" + } +} +``` + +**Example with custom embedding provider:** +```json +{ + "embedding": { + "model": "cohere/embed-english-v3.0" // Dimension auto-detected as 1024 + }, + "vector_store": { + "custom_llm_provider": "s3_vectors", + "vector_bucket_name": "my-embeddings", + "distance_metric": "cosine" + } +} +``` + ## Input Examples ### File (Base64) diff --git a/litellm/constants.py b/litellm/constants.py index 0525bf3843..0c9d1d941b 100644 --- a/litellm/constants.py +++ b/litellm/constants.py @@ -1327,6 +1327,13 @@ COROUTINE_CHECKER_MAX_SIZE_IN_MEMORY = int( DEFAULT_CHUNK_SIZE = int(os.getenv("DEFAULT_CHUNK_SIZE", 1000)) DEFAULT_CHUNK_OVERLAP = int(os.getenv("DEFAULT_CHUNK_OVERLAP", 200)) +########################### S3 Vectors RAG Constants ########################### +S3_VECTORS_DEFAULT_DIMENSION = int(os.getenv("S3_VECTORS_DEFAULT_DIMENSION", 1024)) +S3_VECTORS_DEFAULT_DISTANCE_METRIC = str( + os.getenv("S3_VECTORS_DEFAULT_DISTANCE_METRIC", "cosine") +) +S3_VECTORS_DEFAULT_NON_FILTERABLE_METADATA_KEYS = ["source_text"] + ########################### Microsoft SSO Constants ########################### MICROSOFT_USER_EMAIL_ATTRIBUTE = str( os.getenv("MICROSOFT_USER_EMAIL_ATTRIBUTE", "userPrincipalName") diff --git a/litellm/model_prices_and_context_window_backup.json b/litellm/model_prices_and_context_window_backup.json index 7f33e96dbb..4ac4159558 100644 --- a/litellm/model_prices_and_context_window_backup.json +++ b/litellm/model_prices_and_context_window_backup.json @@ -10232,6 +10232,48 @@ "mode": "completion", "output_cost_per_token": 5e-07 }, + "deepseek-v3-2-251201": { + "input_cost_per_token": 0.0, + "litellm_provider": "volcengine", + "max_input_tokens": 98304, + "max_output_tokens": 32768, + "max_tokens": 32768, + "mode": "chat", + "output_cost_per_token": 0.0, + "supports_assistant_prefill": true, + "supports_function_calling": true, + "supports_prompt_caching": true, + "supports_reasoning": true, + "supports_tool_choice": true + }, + "glm-4-7-251222": { + "input_cost_per_token": 0.0, + "litellm_provider": "volcengine", + "max_input_tokens": 204800, + "max_output_tokens": 131072, + "max_tokens": 131072, + "mode": "chat", + "output_cost_per_token": 0.0, + "supports_assistant_prefill": true, + "supports_function_calling": true, + "supports_prompt_caching": true, + "supports_reasoning": true, + "supports_tool_choice": true + }, + "kimi-k2-thinking-251104": { + "input_cost_per_token": 0.0, + "litellm_provider": "volcengine", + "max_input_tokens": 229376, + "max_output_tokens": 32768, + "max_tokens": 32768, + "mode": "chat", + "output_cost_per_token": 0.0, + "supports_assistant_prefill": true, + "supports_function_calling": true, + "supports_prompt_caching": true, + "supports_reasoning": true, + "supports_tool_choice": true + }, "doubao-embedding": { "input_cost_per_token": 0.0, "litellm_provider": "volcengine", diff --git a/litellm/rag/ingestion/s3_vectors_ingestion.py b/litellm/rag/ingestion/s3_vectors_ingestion.py new file mode 100644 index 0000000000..13964cd89a --- /dev/null +++ b/litellm/rag/ingestion/s3_vectors_ingestion.py @@ -0,0 +1,546 @@ +""" +S3 Vectors-specific RAG Ingestion implementation. + +S3 Vectors is AWS's native vector storage service that provides: +- Purpose-built vector buckets for storing and querying vectors +- Vector indexes with configurable dimensions and distance metrics +- Metadata filtering for semantic search + +This implementation: +1. Auto-creates vector buckets and indexes if not provided +2. Uses LiteLLM's embedding API (supports any provider) +3. Uses httpx + AWS SigV4 signing (no boto3 dependency for S3 Vectors APIs) +4. Stores vectors with metadata using PutVectors API +""" + +from __future__ import annotations + +import hashlib +import uuid +from typing import TYPE_CHECKING, Any, Dict, List, Optional, Tuple + +import litellm +from litellm._logging import verbose_logger +from litellm.constants import ( + S3_VECTORS_DEFAULT_DIMENSION, + S3_VECTORS_DEFAULT_DISTANCE_METRIC, + S3_VECTORS_DEFAULT_NON_FILTERABLE_METADATA_KEYS, +) +from litellm.litellm_core_utils.safe_json_dumps import safe_dumps +from litellm.llms.bedrock.base_aws_llm import BaseAWSLLM +from litellm.llms.custom_httpx.http_handler import ( + get_async_httpx_client, + httpxSpecialProvider, +) +from litellm.rag.ingestion.base_ingestion import BaseRAGIngestion + +if TYPE_CHECKING: + from litellm import Router + from litellm.types.rag import RAGIngestOptions + + +class S3VectorsRAGIngestion(BaseRAGIngestion, BaseAWSLLM): + """ + S3 Vectors RAG ingestion using httpx + AWS SigV4 signing. + + Workflow: + 1. Auto-create vector bucket if needed (CreateVectorBucket API) + 2. Auto-create vector index if needed (CreateVectorIndex API) + 3. Generate embeddings using LiteLLM (supports any provider) + 4. Store vectors with PutVectors API + + Configuration: + - vector_bucket_name: S3 vector bucket name (required) + - index_name: Vector index name (auto-creates if not provided) + - dimension: Vector dimension (default: S3_VECTORS_DEFAULT_DIMENSION) + - distance_metric: "cosine" or "euclidean" (default: S3_VECTORS_DEFAULT_DISTANCE_METRIC) + - non_filterable_metadata_keys: List of metadata keys to exclude from filtering + """ + + def __init__( + self, + ingest_options: "RAGIngestOptions", + router: Optional["Router"] = None, + ): + BaseRAGIngestion.__init__(self, ingest_options=ingest_options, router=router) + BaseAWSLLM.__init__(self) + + # Extract config + self.vector_bucket_name = self.vector_store_config["vector_bucket_name"] + self.index_name = self.vector_store_config.get("index_name") + self.distance_metric = self.vector_store_config.get( + "distance_metric", S3_VECTORS_DEFAULT_DISTANCE_METRIC + ) + self.non_filterable_metadata_keys = self.vector_store_config.get( + "non_filterable_metadata_keys", + S3_VECTORS_DEFAULT_NON_FILTERABLE_METADATA_KEYS, + ) + + # Get dimension from config (will be auto-detected on first use if not provided) + self.dimension = self._get_dimension_from_config() + + # Get AWS region using BaseAWSLLM method + _aws_region = self.vector_store_config.get("aws_region_name") + self.aws_region_name = self.get_aws_region_name_for_non_llm_api_calls( + aws_region_name=str(_aws_region) if _aws_region else None + ) + + # Create httpx client (similar to s3_v2.py) + ssl_verify = self._get_ssl_verify( + ssl_verify=self.vector_store_config.get("ssl_verify") + ) + self.async_httpx_client = get_async_httpx_client( + llm_provider=httpxSpecialProvider.RAG, + params={"ssl_verify": ssl_verify} if ssl_verify is not None else None, + ) + + # Track if infrastructure is initialized + self._config_initialized = False + + async def _get_dimension_from_embedding_request(self) -> int: + """ + Auto-detect dimension by making a test embedding request. + + Makes a single embedding request with a test string to determine + the output dimension of the embedding model. + """ + if not self.embedding_config or "model" not in self.embedding_config: + return S3_VECTORS_DEFAULT_DIMENSION + + try: + model_name = self.embedding_config["model"] + verbose_logger.debug( + f"Auto-detecting dimension by making test embedding request to {model_name}" + ) + + # Make a test embedding request + test_input = "test" + if self.router: + response = await self.router.aembedding(model=model_name, input=[test_input]) + else: + response = await litellm.aembedding(model=model_name, input=[test_input]) + + # Get dimension from the response + if response.data and len(response.data) > 0: + dimension = len(response.data[0]["embedding"]) + verbose_logger.debug( + f"Auto-detected dimension {dimension} for embedding model {model_name}" + ) + return dimension + except Exception as e: + verbose_logger.warning( + f"Could not auto-detect dimension from embedding model: {e}. " + f"Using default dimension of {S3_VECTORS_DEFAULT_DIMENSION}." + ) + + return S3_VECTORS_DEFAULT_DIMENSION + + def _get_dimension_from_config(self) -> Optional[int]: + """ + Get vector dimension from config if explicitly provided. + + Returns None if dimension should be auto-detected. + """ + if "dimension" in self.vector_store_config: + return int(self.vector_store_config["dimension"]) + return None + + async def _ensure_config_initialized(self): + """Lazily initialize S3 Vectors infrastructure.""" + if self._config_initialized: + return + + # Auto-detect dimension if not provided + if self.dimension is None: + self.dimension = await self._get_dimension_from_embedding_request() + + # Ensure vector bucket exists + await self._ensure_vector_bucket_exists() + + # Ensure vector index exists + if not self.index_name: + # Auto-generate index name + unique_id = uuid.uuid4().hex[:8] + self.index_name = f"litellm-index-{unique_id}" + + await self._ensure_vector_index_exists() + + self._config_initialized = True + + async def _sign_and_execute_request( + self, + method: str, + url: str, + data: Optional[str] = None, + headers: Optional[Dict[str, str]] = None, + ) -> Any: + """ + Helper to sign and execute AWS API requests using httpx + SigV4. + + Pattern from litellm/integrations/s3_v2.py + """ + try: + import requests + from botocore.auth import SigV4Auth + from botocore.awsrequest import AWSRequest + except ImportError: + raise ImportError( + "Missing botocore to call S3 Vectors. Run 'pip install boto3'." + ) + + # Get AWS credentials using BaseAWSLLM's get_credentials method + credentials = self.get_credentials( + aws_access_key_id=self.vector_store_config.get("aws_access_key_id"), + aws_secret_access_key=self.vector_store_config.get("aws_secret_access_key"), + aws_session_token=self.vector_store_config.get("aws_session_token"), + aws_region_name=self.aws_region_name, + aws_session_name=self.vector_store_config.get("aws_session_name"), + aws_profile_name=self.vector_store_config.get("aws_profile_name"), + aws_role_name=self.vector_store_config.get("aws_role_name"), + aws_web_identity_token=self.vector_store_config.get("aws_web_identity_token"), + aws_sts_endpoint=self.vector_store_config.get("aws_sts_endpoint"), + aws_external_id=self.vector_store_config.get("aws_external_id"), + ) + + # Prepare headers + if headers is None: + headers = {} + + if data: + headers["Content-Type"] = "application/json" + # Calculate SHA256 hash of the content + content_hash = hashlib.sha256(data.encode("utf-8")).hexdigest() + headers["x-amz-content-sha256"] = content_hash + else: + # For requests without body, use hash of empty string + headers["x-amz-content-sha256"] = hashlib.sha256(b"").hexdigest() + + # Prepare the request + req = requests.Request(method, url, data=data, headers=headers) + prepped = req.prepare() + + # Sign the request + aws_request = AWSRequest( + method=prepped.method, + url=prepped.url, + data=prepped.body, + headers=prepped.headers, + ) + SigV4Auth(credentials, "s3vectors", self.aws_region_name).add_auth(aws_request) + + # Prepare the signed headers + signed_headers = dict(aws_request.headers.items()) + + # Make the request using specific method (pattern from s3_v2.py) + method_upper = method.upper() + if method_upper == "PUT": + response = await self.async_httpx_client.put( + url, data=data, headers=signed_headers + ) + elif method_upper == "POST": + response = await self.async_httpx_client.post( + url, data=data, headers=signed_headers + ) + elif method_upper == "GET": + response = await self.async_httpx_client.get(url, headers=signed_headers) + else: + raise ValueError(f"Unsupported HTTP method: {method}") + + return response + + async def _ensure_vector_bucket_exists(self): + """Create vector bucket if it doesn't exist using GetVectorBucket and CreateVectorBucket APIs.""" + verbose_logger.debug( + f"Ensuring S3 vector bucket exists: {self.vector_bucket_name}" + ) + + # Try to get bucket info using GetVectorBucket API + get_url = f"https://s3vectors.{self.aws_region_name}.api.aws/GetVectorBucket" + get_body = safe_dumps({"vectorBucketName": self.vector_bucket_name}) + + try: + response = await self._sign_and_execute_request("POST", get_url, data=get_body) + if response.status_code == 200: + verbose_logger.debug(f"Vector bucket {self.vector_bucket_name} exists") + return + except Exception as e: + verbose_logger.debug( + f"Bucket check failed (may not exist): {e}, attempting to create" + ) + + # Create vector bucket using CreateVectorBucket API + try: + verbose_logger.debug(f"Creating vector bucket: {self.vector_bucket_name}") + create_url = f"https://s3vectors.{self.aws_region_name}.api.aws/CreateVectorBucket" + create_body = safe_dumps({ + "vectorBucketName": self.vector_bucket_name + }) + + response = await self._sign_and_execute_request("POST", create_url, data=create_body) + + if response.status_code in (200, 201): + verbose_logger.info(f"Created vector bucket: {self.vector_bucket_name}") + elif response.status_code == 409: + # Bucket already exists (ConflictException) + verbose_logger.debug( + f"Vector bucket {self.vector_bucket_name} already exists" + ) + else: + verbose_logger.error(f"CreateVectorBucket failed: {response.status_code} - {response.text}") + response.raise_for_status() + except Exception as e: + verbose_logger.exception(f"Error creating vector bucket: {e}") + raise + + async def _ensure_vector_index_exists(self): + """Create vector index if it doesn't exist using GetIndex and CreateIndex APIs.""" + verbose_logger.debug( + f"Ensuring vector index exists: {self.vector_bucket_name}/{self.index_name}" + ) + + # Try to get index info using GetIndex API + get_url = f"https://s3vectors.{self.aws_region_name}.api.aws/GetIndex" + get_body = safe_dumps({ + "vectorBucketName": self.vector_bucket_name, + "indexName": self.index_name + }) + + try: + response = await self._sign_and_execute_request("POST", get_url, data=get_body) + if response.status_code == 200: + verbose_logger.debug(f"Vector index {self.index_name} exists") + return + except Exception as e: + verbose_logger.debug( + f"Index check failed (may not exist): {e}, attempting to create" + ) + + # Create vector index using CreateIndex API + try: + verbose_logger.debug( + f"Creating vector index: {self.index_name} with dimension={self.dimension}, metric={self.distance_metric}" + ) + + # Prepare index configuration per AWS API docs + index_config = { + "vectorBucketName": self.vector_bucket_name, + "indexName": self.index_name, + "dataType": "float32", + "dimension": self.dimension, + "distanceMetric": self.distance_metric, + } + + if self.non_filterable_metadata_keys: + index_config["metadataConfiguration"] = { + "nonFilterableMetadataKeys": self.non_filterable_metadata_keys + } + + create_url = f"https://s3vectors.{self.aws_region_name}.api.aws/CreateIndex" + response = await self._sign_and_execute_request( + "POST", create_url, data=safe_dumps(index_config) + ) + + if response.status_code in (200, 201): + verbose_logger.info(f"Created vector index: {self.index_name}") + elif response.status_code == 409: + verbose_logger.debug(f"Vector index {self.index_name} already exists") + else: + verbose_logger.error(f"CreateIndex failed: {response.status_code} - {response.text}") + response.raise_for_status() + except Exception as e: + verbose_logger.exception(f"Error creating vector index: {e}") + raise + + async def _put_vectors(self, vectors: List[Dict[str, Any]]): + """ + Call PutVectors API to store vectors in S3 Vectors. + + Args: + vectors: List of vector objects with keys: "key", "data", "metadata" + """ + verbose_logger.debug( + f"Storing {len(vectors)} vectors in {self.vector_bucket_name}/{self.index_name}" + ) + + url = f"https://s3vectors.{self.aws_region_name}.api.aws/PutVectors" + + # Prepare request body per AWS API docs + request_body = { + "vectorBucketName": self.vector_bucket_name, + "indexName": self.index_name, + "vectors": vectors + } + + try: + response = await self._sign_and_execute_request( + "POST", url, data=safe_dumps(request_body) + ) + + if response.status_code in (200, 201): + verbose_logger.info( + f"Successfully stored {len(vectors)} vectors in index {self.index_name}" + ) + else: + verbose_logger.error( + f"PutVectors failed with status {response.status_code}: {response.text}" + ) + response.raise_for_status() + except Exception as e: + verbose_logger.exception(f"Error storing vectors: {e}") + raise + + async def embed( + self, + chunks: List[str], + ) -> Optional[List[List[float]]]: + """ + Generate embeddings using LiteLLM's embedding API. + + Supports any embedding provider (OpenAI, Bedrock, Cohere, etc.) + """ + if not chunks: + return None + + # Use embedding config from ingest_options or default + if not self.embedding_config: + verbose_logger.warning( + "No embedding config provided, using default text-embedding-3-small" + ) + self.embedding_config = {"model": "text-embedding-3-small"} + + embedding_model = self.embedding_config.get("model", "text-embedding-3-small") + + verbose_logger.debug( + f"Generating embeddings for {len(chunks)} chunks using {embedding_model}" + ) + + # Convert to list to ensure type compatibility + input_chunks: List[str] = list(chunks) + + if self.router: + response = await self.router.aembedding(model=embedding_model, input=input_chunks) + else: + response = await litellm.aembedding(model=embedding_model, input=input_chunks) + + return [item["embedding"] for item in response.data] + + async def store( + self, + file_content: Optional[bytes], + filename: Optional[str], + content_type: Optional[str], + chunks: List[str], + embeddings: Optional[List[List[float]]], + ) -> Tuple[Optional[str], Optional[str]]: + """ + Store vectors in S3 Vectors using PutVectors API. + + Steps: + 1. Ensure vector bucket exists (auto-create if needed) + 2. Ensure vector index exists (auto-create if needed) + 3. Prepare vector data with metadata + 4. Call PutVectors API with httpx + SigV4 signing + + Args: + file_content: Raw file bytes (not used for S3 Vectors) + filename: Name of the file + content_type: MIME type (not used for S3 Vectors) + chunks: Text chunks + embeddings: Vector embeddings + + Returns: + Tuple of (index_name, filename) + """ + # Ensure infrastructure exists + await self._ensure_config_initialized() + + if not embeddings or not chunks: + verbose_logger.warning("No embeddings or chunks to store") + return self.index_name, None + + # Prepare vectors for PutVectors API + vectors = [] + for i, (chunk, embedding) in enumerate(zip(chunks, embeddings)): + vector_obj = { + "key": f"{filename}_{i}" if filename else f"chunk_{i}", + "data": {"float32": embedding}, + "metadata": { + "source_text": chunk, # Non-filterable (for reference) + "chunk_index": str(i), # Filterable + }, + } + + if filename: + vector_obj["metadata"]["filename"] = filename # Filterable + + vectors.append(vector_obj) + + # Call PutVectors API + await self._put_vectors(vectors) + + return self.index_name, filename + + async def query_vector_store( + self, vector_store_id: str, query: str, top_k: int = 5 + ) -> Optional[Dict[str, Any]]: + """ + Query S3 Vectors using QueryVectors API. + + Args: + vector_store_id: Index name + query: Query text + top_k: Number of results to return + + Returns: + Query results with vectors and metadata + """ + verbose_logger.debug(f"Querying index {vector_store_id} with query: {query}") + + # Generate query embedding + if not self.embedding_config: + self.embedding_config = {"model": "text-embedding-3-small"} + + embedding_model = self.embedding_config.get("model", "text-embedding-3-small") + + response = await litellm.aembedding(model=embedding_model, input=[query]) + query_embedding = response.data[0]["embedding"] + + # Call QueryVectors API + url = f"https://s3vectors.{self.aws_region_name}.api.aws/QueryVectors" + + request_body = { + "vectorBucketName": self.vector_bucket_name, + "indexName": vector_store_id, + "queryVector": {"float32": query_embedding}, + "topK": top_k, + "returnDistance": True, + "returnMetadata": True, + } + + try: + response = await self._sign_and_execute_request( + "POST", url, data=safe_dumps(request_body) + ) + + if response.status_code == 200: + results = response.json() + verbose_logger.debug(f"Query returned {len(results.get('vectors', []))} results") + + # Check if query terms appear in results + if results.get("vectors"): + for result in results["vectors"]: + metadata = result.get("metadata", {}) + source_text = metadata.get("source_text", "") + if query.lower() in source_text.lower(): + return results + + # Return results even if exact match not found + return results + else: + verbose_logger.error( + f"QueryVectors failed with status {response.status_code}: {response.text}" + ) + return None + except Exception as e: + verbose_logger.exception(f"Error querying vectors: {e}") + return None diff --git a/litellm/rag/main.py b/litellm/rag/main.py index 620097f83d..571f78f2f7 100644 --- a/litellm/rag/main.py +++ b/litellm/rag/main.py @@ -31,6 +31,7 @@ from litellm.rag.ingestion.base_ingestion import BaseRAGIngestion from litellm.rag.ingestion.bedrock_ingestion import BedrockRAGIngestion from litellm.rag.ingestion.gemini_ingestion import GeminiRAGIngestion from litellm.rag.ingestion.openai_ingestion import OpenAIRAGIngestion +from litellm.rag.ingestion.s3_vectors_ingestion import S3VectorsRAGIngestion from litellm.rag.rag_query import RAGQuery from litellm.types.rag import ( RAGIngestOptions, @@ -48,6 +49,7 @@ INGESTION_REGISTRY: Dict[str, Type[BaseRAGIngestion]] = { "openai": OpenAIRAGIngestion, "bedrock": BedrockRAGIngestion, "gemini": GeminiRAGIngestion, + "s3_vectors": S3VectorsRAGIngestion, } diff --git a/litellm/types/rag.py b/litellm/types/rag.py index fe237a1343..cae0770868 100644 --- a/litellm/types/rag.py +++ b/litellm/types/rag.py @@ -129,9 +129,53 @@ class VertexAIVectorStoreOptions(TypedDict, total=False): import_timeout: Optional[int] # Timeout in seconds (default: 600) +class S3VectorsVectorStoreOptions(TypedDict, total=False): + """ + AWS S3 Vectors configuration. + + Example (auto-create): + {"custom_llm_provider": "s3_vectors", "vector_bucket_name": "my-embeddings"} + + Example (use existing): + {"custom_llm_provider": "s3_vectors", "vector_bucket_name": "my-embeddings", + "index_name": "my-index"} + + Example (with credentials): + {"custom_llm_provider": "s3_vectors", "vector_bucket_name": "my-embeddings", + "litellm_credential_name": "my-aws-creds"} + + Auto-creation creates: S3 vector bucket and vector index (if not provided). + Embeddings are generated using LiteLLM's embedding API (supports any provider). + """ + + custom_llm_provider: Literal["s3_vectors"] + vector_bucket_name: str # Required - S3 vector bucket name + index_name: Optional[str] # Vector index name (auto-creates if not provided) + + # Index configuration (for auto-creation) + dimension: Optional[int] # Vector dimension (auto-detected from embedding model, or default: 1024) + distance_metric: Optional[Literal["cosine", "euclidean"]] # Default: cosine + non_filterable_metadata_keys: Optional[List[str]] # Keys excluded from filtering (e.g., ["source_text"]) + + # Credentials (loaded from litellm.credential_list if litellm_credential_name is provided) + litellm_credential_name: Optional[str] # Credential name to load from litellm.credential_list + + # AWS auth (uses BaseAWSLLM) + aws_access_key_id: Optional[str] + aws_secret_access_key: Optional[str] + aws_session_token: Optional[str] + aws_region_name: Optional[str] # default: us-west-2 + aws_role_name: Optional[str] + aws_session_name: Optional[str] + aws_profile_name: Optional[str] + aws_web_identity_token: Optional[str] + aws_sts_endpoint: Optional[str] + aws_external_id: Optional[str] + + # Union type for vector store options RAGIngestVectorStoreOptions = Union[ - OpenAIVectorStoreOptions, BedrockVectorStoreOptions, VertexAIVectorStoreOptions + OpenAIVectorStoreOptions, BedrockVectorStoreOptions, VertexAIVectorStoreOptions, S3VectorsVectorStoreOptions ] diff --git a/tests/vector_store_tests/rag/test_rag_s3_vectors.py b/tests/vector_store_tests/rag/test_rag_s3_vectors.py new file mode 100644 index 0000000000..cd8a362a7b --- /dev/null +++ b/tests/vector_store_tests/rag/test_rag_s3_vectors.py @@ -0,0 +1,107 @@ +""" +S3 Vectors RAG ingestion tests. + +Requires environment variables: +- AWS_ACCESS_KEY_ID +- AWS_SECRET_ACCESS_KEY +- AWS_REGION_NAME (optional, defaults to us-west-2) + +Optional: +- S3_VECTOR_BUCKET_NAME (optional, auto-generates if not set) +""" + +import os +import sys +from typing import Any, Dict, Optional + +import pytest + +sys.path.insert(0, os.path.abspath("../../..")) + +import litellm +from litellm.types.rag import RAGIngestOptions +from tests.vector_store_tests.rag.base_rag_tests import BaseRAGTest + + +class TestRAGS3Vectors(BaseRAGTest): + """Test RAG Ingest with AWS S3 Vectors.""" + + @pytest.fixture(autouse=True) + def check_env_vars(self): + """Check required environment variables before each test.""" + aws_key = os.environ.get("AWS_ACCESS_KEY_ID") + aws_secret = os.environ.get("AWS_SECRET_ACCESS_KEY") + + if not aws_key or not aws_secret: + pytest.skip("Skipping S3 Vectors test: AWS credentials required") + + def get_base_ingest_options(self) -> RAGIngestOptions: + """ + Return S3 Vectors-specific ingest options. + + Chunking is configured via chunking_strategy (unified interface). + Embeddings are generated using LiteLLM's embedding API. + """ + vector_bucket_name = os.environ.get( + "S3_VECTOR_BUCKET_NAME", "test-litellm-vectors" + ) + aws_region = os.environ.get("AWS_REGION_NAME", "us-west-2") + + return { + "chunking_strategy": { + "chunk_size": 512, + "chunk_overlap": 100, + }, + "embedding": { + "model": "text-embedding-3-small" # Can use any LiteLLM-supported model + }, + "vector_store": { + "custom_llm_provider": "s3_vectors", + "vector_bucket_name": vector_bucket_name, + "index_name": "test-index", + # dimension is auto-detected from embedding model (text-embedding-3-small = 1536) + "distance_metric": "cosine", + "non_filterable_metadata_keys": ["source_text"], + "aws_region_name": aws_region, + }, + } + + async def query_vector_store( + self, + vector_store_id: str, + query: str, + ) -> Optional[Dict[str, Any]]: + """Query S3 Vectors index.""" + try: + # Import the ingestion class to use its query method + from litellm.rag.ingestion.s3_vectors_ingestion import ( + S3VectorsRAGIngestion, + ) + except ImportError: + pytest.skip("S3 Vectors ingestion not available") + + vector_bucket_name = os.environ.get( + "S3_VECTOR_BUCKET_NAME", "test-litellm-vectors" + ) + aws_region = os.environ.get("AWS_REGION_NAME", "us-west-2") + + # Create ingestion instance to use query method + ingest_options = { + "embedding": {"model": "text-embedding-3-small"}, + "vector_store": { + "custom_llm_provider": "s3_vectors", + "vector_bucket_name": vector_bucket_name, + "aws_region_name": aws_region, + }, + } + + ingestion = S3VectorsRAGIngestion(ingest_options=ingest_options) + + # Query the index + results = await ingestion.query_vector_store( + vector_store_id=vector_store_id, + query=query, + top_k=5, + ) + + return results From 51339f5ef189e1b3f79d9b04e1f61859e2373675 Mon Sep 17 00:00:00 2001 From: Ishaan Jaff Date: Tue, 27 Jan 2026 16:30:59 -0800 Subject: [PATCH 18/23] [Feat] RAG API - Add s3_vectors as provider on /vector_store/search API + UI for creating + PDF support for /rag/ingest (#19895) * init S3VectorsRAGIngestion as a supported ingestion provider for RAG API * test: TestRAGS3Vectors * init S3VectorsVectorStoreOptions * init s3 vectors * code clean up + QA * fix: get_credentials * S3VectorsRAGIngestion * TestRAGS3Vectors * docs: AWS S3 Vectors * add asyncio QA checks * fix: S3_VECTORS_DEFAULT_DIMENSION * init ui for bedrock s3 vectors * fix add /search support for s3_vectors * init atransform_search_vector_store_request * feat: S3VectorsVectorStoreConfig * TestS3VectorsVectorStoreConfig * atransform_search_vector_store_request * fix: S3VectorsVectorStoreConfig * add validation for bucket name etd * fix UI validation for s3 vector store * init extract_text_from_pdf * add pypdf * fix code QA checks * fix navbar * init s3_vector.png * fix QA code --- .../base_llm/vector_store/transformation.py | 26 +- litellm/llms/bedrock/base_aws_llm.py | 2 +- litellm/llms/custom_httpx/llm_http_handler.py | 36 ++- litellm/llms/s3_vectors/__init__.py | 1 + .../llms/s3_vectors/vector_stores/__init__.py | 1 + .../vector_stores/transformation.py | 254 ++++++++++++++++++ .../out/assets/logos/s3_vector.png | Bin 0 -> 191076 bytes litellm/proxy/rag_endpoints/endpoints.py | 9 + litellm/rag/ingestion/base_ingestion.py | 17 +- .../rag/ingestion/file_parsers/__init__.py | 9 + .../rag/ingestion/file_parsers/pdf_parser.py | 70 +++++ litellm/rag/ingestion/s3_vectors_ingestion.py | 47 +++- litellm/types/router.py | 4 + litellm/types/utils.py | 11 +- litellm/utils.py | 8 +- requirements.txt | 1 + .../test_litellm/llms/s3_vectors/__init__.py | 1 + .../llms/s3_vectors/vector_stores/__init__.py | 1 + .../test_s3_vectors_transformation.py | 115 ++++++++ .../test_s3_vectors_vector_store.py | 42 +++ .../public/assets/logos/s3_vector.png | Bin 0 -> 191076 bytes .../src/components/navbar.tsx | 2 +- .../src/components/networking.tsx | 4 +- .../CreateVectorStore.test.tsx | 116 +++++++- .../CreateVectorStore.tsx | 96 ++++++- .../S3VectorsConfig.test.tsx | 203 ++++++++++++++ .../S3VectorsConfig.tsx | 192 +++++++++++++ .../src/components/vector_store_providers.tsx | 37 +++ 28 files changed, 1269 insertions(+), 36 deletions(-) create mode 100644 litellm/llms/s3_vectors/__init__.py create mode 100644 litellm/llms/s3_vectors/vector_stores/__init__.py create mode 100644 litellm/llms/s3_vectors/vector_stores/transformation.py create mode 100644 litellm/proxy/_experimental/out/assets/logos/s3_vector.png create mode 100644 litellm/rag/ingestion/file_parsers/__init__.py create mode 100644 litellm/rag/ingestion/file_parsers/pdf_parser.py create mode 100644 tests/test_litellm/llms/s3_vectors/__init__.py create mode 100644 tests/test_litellm/llms/s3_vectors/vector_stores/__init__.py create mode 100644 tests/test_litellm/llms/s3_vectors/vector_stores/test_s3_vectors_transformation.py create mode 100644 tests/vector_store_tests/test_s3_vectors_vector_store.py create mode 100644 ui/litellm-dashboard/public/assets/logos/s3_vector.png create mode 100644 ui/litellm-dashboard/src/components/vector_store_management/S3VectorsConfig.test.tsx create mode 100644 ui/litellm-dashboard/src/components/vector_store_management/S3VectorsConfig.tsx diff --git a/litellm/llms/base_llm/vector_store/transformation.py b/litellm/llms/base_llm/vector_store/transformation.py index 89f2094d5d..935fd53c19 100644 --- a/litellm/llms/base_llm/vector_store/transformation.py +++ b/litellm/llms/base_llm/vector_store/transformation.py @@ -5,8 +5,8 @@ import httpx from litellm.types.router import GenericLiteLLMParams from litellm.types.vector_stores import ( - BaseVectorStoreAuthCredentials, VECTOR_STORE_OPENAI_PARAMS, + BaseVectorStoreAuthCredentials, VectorStoreCreateOptionalRequestParams, VectorStoreCreateResponse, VectorStoreIndexEndpoints, @@ -64,6 +64,30 @@ class BaseVectorStoreConfig: pass + async def atransform_search_vector_store_request( + self, + vector_store_id: str, + query: Union[str, List[str]], + vector_store_search_optional_params: VectorStoreSearchOptionalRequestParams, + api_base: str, + litellm_logging_obj: LiteLLMLoggingObj, + litellm_params: dict, + ) -> Tuple[str, Dict]: + """ + Optional async version of transform_search_vector_store_request. + If not implemented, the handler will fall back to the sync version. + Providers that need to make async calls (e.g., generating embeddings) should override this. + """ + # Default implementation: call the sync version + return self.transform_search_vector_store_request( + vector_store_id=vector_store_id, + query=query, + vector_store_search_optional_params=vector_store_search_optional_params, + api_base=api_base, + litellm_logging_obj=litellm_logging_obj, + litellm_params=litellm_params, + ) + @abstractmethod def transform_search_vector_store_response( self, response: httpx.Response, litellm_logging_obj: LiteLLMLoggingObj diff --git a/litellm/llms/bedrock/base_aws_llm.py b/litellm/llms/bedrock/base_aws_llm.py index 642d15fe3e..1de1c40c43 100644 --- a/litellm/llms/bedrock/base_aws_llm.py +++ b/litellm/llms/bedrock/base_aws_llm.py @@ -1163,7 +1163,7 @@ class BaseAWSLLM: def _sign_request( self, - service_name: Literal["bedrock", "sagemaker", "bedrock-agentcore"], + service_name: Literal["bedrock", "sagemaker", "bedrock-agentcore", "s3vectors"], headers: dict, optional_params: dict, request_data: dict, diff --git a/litellm/llms/custom_httpx/llm_http_handler.py b/litellm/llms/custom_httpx/llm_http_handler.py index 6a87967c3a..d2ea7e872a 100644 --- a/litellm/llms/custom_httpx/llm_http_handler.py +++ b/litellm/llms/custom_httpx/llm_http_handler.py @@ -7033,17 +7033,31 @@ class BaseLLMHTTPHandler: litellm_params=dict(litellm_params), ) - ( - url, - request_body, - ) = vector_store_provider_config.transform_search_vector_store_request( - vector_store_id=vector_store_id, - query=query, - vector_store_search_optional_params=vector_store_search_optional_params, - api_base=api_base, - litellm_logging_obj=logging_obj, - litellm_params=dict(litellm_params), - ) + # Check if provider has async transform method + if hasattr(vector_store_provider_config, "atransform_search_vector_store_request"): + ( + url, + request_body, + ) = await vector_store_provider_config.atransform_search_vector_store_request( + vector_store_id=vector_store_id, + query=query, + vector_store_search_optional_params=vector_store_search_optional_params, + api_base=api_base, + litellm_logging_obj=logging_obj, + litellm_params=dict(litellm_params), + ) + else: + ( + url, + request_body, + ) = vector_store_provider_config.transform_search_vector_store_request( + vector_store_id=vector_store_id, + query=query, + vector_store_search_optional_params=vector_store_search_optional_params, + api_base=api_base, + litellm_logging_obj=logging_obj, + litellm_params=dict(litellm_params), + ) all_optional_params: Dict[str, Any] = dict(litellm_params) all_optional_params.update(vector_store_search_optional_params or {}) headers, signed_json_body = vector_store_provider_config.sign_request( diff --git a/litellm/llms/s3_vectors/__init__.py b/litellm/llms/s3_vectors/__init__.py new file mode 100644 index 0000000000..e8367949c3 --- /dev/null +++ b/litellm/llms/s3_vectors/__init__.py @@ -0,0 +1 @@ +# S3 Vectors LLM integration diff --git a/litellm/llms/s3_vectors/vector_stores/__init__.py b/litellm/llms/s3_vectors/vector_stores/__init__.py new file mode 100644 index 0000000000..ac24b4a38d --- /dev/null +++ b/litellm/llms/s3_vectors/vector_stores/__init__.py @@ -0,0 +1 @@ +# S3 Vectors vector store integration diff --git a/litellm/llms/s3_vectors/vector_stores/transformation.py b/litellm/llms/s3_vectors/vector_stores/transformation.py new file mode 100644 index 0000000000..df81a78289 --- /dev/null +++ b/litellm/llms/s3_vectors/vector_stores/transformation.py @@ -0,0 +1,254 @@ +from typing import TYPE_CHECKING, Any, Dict, List, Optional, Tuple, Union + +import httpx + +from litellm.llms.base_llm.vector_store.transformation import BaseVectorStoreConfig +from litellm.llms.bedrock.base_aws_llm import BaseAWSLLM +from litellm.types.router import GenericLiteLLMParams +from litellm.types.vector_stores import ( + VECTOR_STORE_OPENAI_PARAMS, + BaseVectorStoreAuthCredentials, + VectorStoreIndexEndpoints, + VectorStoreResultContent, + VectorStoreSearchOptionalRequestParams, + VectorStoreSearchResponse, + VectorStoreSearchResult, +) + +if TYPE_CHECKING: + from litellm.litellm_core_utils.litellm_logging import Logging as LiteLLMLoggingObj +else: + LiteLLMLoggingObj = Any + + +class S3VectorsVectorStoreConfig(BaseVectorStoreConfig, BaseAWSLLM): + """Vector store configuration for AWS S3 Vectors.""" + + def __init__(self) -> None: + BaseVectorStoreConfig.__init__(self) + BaseAWSLLM.__init__(self) + + def get_auth_credentials( + self, litellm_params: dict + ) -> BaseVectorStoreAuthCredentials: + return {} + + def get_vector_store_endpoints_by_type(self) -> VectorStoreIndexEndpoints: + return { + "read": [("POST", "/QueryVectors")], + "write": [], + } + + def get_supported_openai_params( + self, model: str + ) -> List[VECTOR_STORE_OPENAI_PARAMS]: + return ["max_num_results"] + + def map_openai_params( + self, + non_default_params: dict, + optional_params: dict, + drop_params: bool, + ) -> dict: + for param, value in non_default_params.items(): + if param == "max_num_results": + optional_params["maxResults"] = value + return optional_params + + def validate_environment( + self, headers: dict, litellm_params: Optional[GenericLiteLLMParams] + ) -> dict: + headers = headers or {} + headers.setdefault("Content-Type", "application/json") + return headers + + def get_complete_url(self, api_base: Optional[str], litellm_params: dict) -> str: + aws_region_name = litellm_params.get("aws_region_name") + if not aws_region_name: + raise ValueError("aws_region_name is required for S3 Vectors") + return f"https://s3vectors.{aws_region_name}.api.aws" + + def transform_search_vector_store_request( + self, + vector_store_id: str, + query: Union[str, List[str]], + vector_store_search_optional_params: VectorStoreSearchOptionalRequestParams, + api_base: str, + litellm_logging_obj: LiteLLMLoggingObj, + litellm_params: dict, + ) -> Tuple[str, Dict]: + """Sync version - generates embedding synchronously.""" + # For S3 Vectors, vector_store_id should be in format: bucket_name:index_name + # If not in that format, try to construct it from litellm_params + bucket_name: str + index_name: str + + if ":" in vector_store_id: + bucket_name, index_name = vector_store_id.split(":", 1) + else: + # Try to get bucket_name from litellm_params + bucket_name_from_params = litellm_params.get("vector_bucket_name") + if not bucket_name_from_params or not isinstance(bucket_name_from_params, str): + raise ValueError( + "vector_store_id must be in format 'bucket_name:index_name' for S3 Vectors, " + "or vector_bucket_name must be provided in litellm_params" + ) + bucket_name = bucket_name_from_params + index_name = vector_store_id + + if isinstance(query, list): + query = " ".join(query) + + # Generate embedding for the query + embedding_model = litellm_params.get("embedding_model", "text-embedding-3-small") + + import litellm as litellm_module + embedding_response = litellm_module.embedding(model=embedding_model, input=[query]) + query_embedding = embedding_response.data[0]["embedding"] + + url = f"{api_base}/QueryVectors" + + request_body: Dict[str, Any] = { + "vectorBucketName": bucket_name, + "indexName": index_name, + "queryVector": {"float32": query_embedding}, + "topK": vector_store_search_optional_params.get("max_num_results", 5), # Default to 5 + "returnDistance": True, + "returnMetadata": True, + } + + litellm_logging_obj.model_call_details["query"] = query + return url, request_body + + async def atransform_search_vector_store_request( + self, + vector_store_id: str, + query: Union[str, List[str]], + vector_store_search_optional_params: VectorStoreSearchOptionalRequestParams, + api_base: str, + litellm_logging_obj: LiteLLMLoggingObj, + litellm_params: dict, + ) -> Tuple[str, Dict]: + """Async version - generates embedding asynchronously.""" + # For S3 Vectors, vector_store_id should be in format: bucket_name:index_name + # If not in that format, try to construct it from litellm_params + bucket_name: str + index_name: str + + if ":" in vector_store_id: + bucket_name, index_name = vector_store_id.split(":", 1) + else: + # Try to get bucket_name from litellm_params + bucket_name_from_params = litellm_params.get("vector_bucket_name") + if not bucket_name_from_params or not isinstance(bucket_name_from_params, str): + raise ValueError( + "vector_store_id must be in format 'bucket_name:index_name' for S3 Vectors, " + "or vector_bucket_name must be provided in litellm_params" + ) + bucket_name = bucket_name_from_params + index_name = vector_store_id + + if isinstance(query, list): + query = " ".join(query) + + # Generate embedding for the query asynchronously + embedding_model = litellm_params.get("embedding_model", "text-embedding-3-small") + + import litellm as litellm_module + embedding_response = await litellm_module.aembedding(model=embedding_model, input=[query]) + query_embedding = embedding_response.data[0]["embedding"] + + url = f"{api_base}/QueryVectors" + + request_body: Dict[str, Any] = { + "vectorBucketName": bucket_name, + "indexName": index_name, + "queryVector": {"float32": query_embedding}, + "topK": vector_store_search_optional_params.get("max_num_results", 5), # Default to 5 + "returnDistance": True, + "returnMetadata": True, + } + + litellm_logging_obj.model_call_details["query"] = query + return url, request_body + + def sign_request( + self, + headers: dict, + optional_params: Dict, + request_data: Dict, + api_base: str, + api_key: Optional[str] = None, + ) -> Tuple[dict, Optional[bytes]]: + return self._sign_request( + service_name="s3vectors", + headers=headers, + optional_params=optional_params, + request_data=request_data, + api_base=api_base, + api_key=api_key, + ) + + def transform_search_vector_store_response( + self, response: httpx.Response, litellm_logging_obj: LiteLLMLoggingObj + ) -> VectorStoreSearchResponse: + try: + response_data = response.json() + results: List[VectorStoreSearchResult] = [] + + for item in response_data.get("vectors", []) or []: + metadata = item.get("metadata", {}) or {} + source_text = metadata.get("source_text", "") + + if not source_text: + continue + + # Extract file information from metadata + chunk_index = metadata.get("chunk_index", "0") + file_id = f"s3-vectors-chunk-{chunk_index}" + filename = metadata.get("filename", f"document-{chunk_index}") + + # S3 Vectors returns distance, convert to similarity score (0-1) + # Lower distance = higher similarity + # We'll normalize using 1 / (1 + distance) to get a 0-1 score + distance = item.get("distance") + score = None + if distance is not None: + # Convert distance to similarity score between 0 and 1 + # For cosine distance: similarity = 1 - distance + # For euclidean: use 1 / (1 + distance) + # Assuming cosine distance here + score = max(0.0, min(1.0, 1.0 - float(distance))) + + results.append( + VectorStoreSearchResult( + score=score, + content=[VectorStoreResultContent(text=source_text, type="text")], + file_id=file_id, + filename=filename, + attributes=metadata, + ) + ) + + return VectorStoreSearchResponse( + object="vector_store.search_results.page", + search_query=litellm_logging_obj.model_call_details.get("query", ""), + data=results, + ) + except Exception as e: + raise self.get_error_class( + error_message=str(e), + status_code=response.status_code, + headers=response.headers, + ) + + # Vector store creation is not yet implemented + def transform_create_vector_store_request( + self, + vector_store_create_optional_params, + api_base: str, + ) -> Tuple[str, Dict]: + raise NotImplementedError + + def transform_create_vector_store_response(self, response: httpx.Response): + raise NotImplementedError diff --git a/litellm/proxy/_experimental/out/assets/logos/s3_vector.png b/litellm/proxy/_experimental/out/assets/logos/s3_vector.png new file mode 100644 index 0000000000000000000000000000000000000000..15a1a456e129f9e2544d82399c6db3f2b9d8d204 GIT binary patch literal 191076 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

3YYKR6{ z;eVZ|Xc9msvJQ0a1f4y;rYN*Z_5;#k5yNt59}4U~2)o?E#zdx9 zPC9b=LLI}SMFA4?dA#P8f6NaE>~Tu@QWvI++oir9CgMp4kI?3l&Tc?W#tuAvXxG2o z`NVw(c1}(WAD$T*oemMiJO;GrH~(E)nul4O$X+P9a_fkAVD z)hZipkv%7T(FL6-59!fX{`4|rAO;L`<9N}%Cs89xXqbMdTHEdj8JHIZz{o}u-W2m& z&OGPICmy}@;!E$o_wIVN##_x`8~?yLH50a{KMsbN9U!j5>|hlU)K;d7G`;mLYz=69 z@FSTG8xx#x2fCdkKlwrJhR-*PU73v=dAD4%Qo-r@7FR?hwV$bPA#{vP6+_^1VGJ|E zLL*-s>`D5G_ekwzlk&_{d-mLT|Ks0&a`%bxBO~Jzz9%w4R{F6Z%D<5;GYH^m<+}P_ zbo!~kzHZ|SPTknKaN$5_sl+x!HLu0%+Ibsna-uwqRp4hNNnt1sJ|KZ)syZd21zDGf!+Igp7&cJY zzz_l(3D`7?1sAD}VWLaSP|c}O4bxI*8?I4Ky+xiq>Fs3Q$KCivfH$!3Aa1V?PnRp> zhxd-`|HigwzH)5;(L?)^<`j`6Ipd_+MFz|NV=$Uvu-4yQ>M1Q)-?!|wtIvAl>1Qrk zy4q@0e#2%usZUlXCZ|~zWP1RKV}GfwsA@S$OEZ>|JQAo*z2dzoxul!rgPF{udvfa* z|m);sUsmyWd7yW+Q0uOJ2I7A|K`GLFLi;5Y+A}Tnc-hBbM7Qq(`KuMwR(j& zY#bk+*tBW=$ndfAF1+}``|hojEBvT0axmKgHICZ+Tl4NDr|U zsJKSDIc6&xTed0)dRLdLkvsMr8XKGH@9$0@B1|PpkQ8^jX!kjXpoJl>X^+jiTMCw+ z(mHV>cm4IXH(Zyz;+Lsw^{ZcAe8JVVkN{2QA;jEksMcJA8qjmHi?v-gQ(BL^Pd zKYcKLZjg!*(pl|Df!LCK* zjm?cG)1%2mBbl1yEl^3bQmxbsi|`K}B{di?<}O8DJATLHwFUqc@eyYaku`8^(B5&vr@jjM74WbTM8z=LJ8o4fRjEQSDd`OcM)FMU+K_FsaG}KJ( z1R_oul!0_iVJMtHa|bZFg{7k=izONcT4)9^>cqF`d@xsGlZAZnBVbqt%#N6RGxbL`0(z%2PURZ>>57!(7~NgA3d~vm{mI8K$+zGl7YSi5oK

3YYKR6{ z;eVZ|Xc9msvJQ0a1f4y;rYN*Z_5;#k5yNt59}4U~2)o?E#zdx9 zPC9b=LLI}SMFA4?dA#P8f6NaE>~Tu@QWvI++oir9CgMp4kI?3l&Tc?W#tuAvXxG2o z`NVw(c1}(WAD$T*oemMiJO;GrH~(E)nul4O$X+P9a_fkAVD z)hZipkv%7T(FL6-59!fX{`4|rAO;L`<9N}%Cs89xXqbMdTHEdj8JHIZz{o}u-W2m& z&OGPICmy}@;!E$o_wIVN##_x`8~?yLH50a{KMsbN9U!j5>|hlU)K;d7G`;mLYz=69 z@FSTG8xx#x2fCdkKlwrJhR-*PU73v=dAD4%Qo-r@7FR?hwV$bPA#{vP6+_^1VGJ|E zLL*-s>`D5G_ekwzlk&_{d-mLT|Ks0&a`%bxBO~Jzz9%w4R{F6Z%D<5;GYH^m<+}P_ zbo!~kzHZ|SPTknKaN$5_sl+x!HLu0%+Ibsna-uwqRp4hNNnt1sJ|KZ)syZd21zDGf!+Igp7&cJY zzz_l(3D`7?1sAD}VWLaSP|c}O4bxI*8?I4Ky+xiq>Fs3Q$KCivfH$!3Aa1V?PnRp> zhxd-`|HigwzH)5;(L?)^<`j`6Ipd_+MFz|NV=$Uvu-4yQ>M1Q)-?!|wtIvAl>1Qrk zy4q@0e#2%usZUlXCZ|~zWP1RKV}GfwsA@S$OEZ>|JQAo*z2dzoxul!rgPF{udvfa* z|m);sUsmyWd7yW+Q0uOJ2I7A|K`GLFLi;5Y+A}Tnc-hBbM7Qq(`KuMwR(j& zY#bk+*tBW=$ndfAF1+}``|hojEBvT0axmKgHICZ+Tl4NDr|U zsJKSDIc6&xTed0)dRLdLkvsMr8XKGH@9$0@B1|PpkQ8^jX!kjXpoJl>X^+jiTMCw+ z(mHV>cm4IXH(Zyz;+Lsw^{ZcAe8JVVkN{2QA;jEksMcJA8qjmHi?v-gQ(BL^Pd zKYcKLZjg!*(pl|Df!LCK* zjm?cG)1%2mBbl1yEl^3bQmxbsi|`K}B{di?<}O8DJATLHwFUqc@eyYaku`8^(B5&vr@jjM74WbTM8z=LJ8o4fRjEQSDd`OcM)FMU+K_FsaG}KJ( z1R_oul!0_iVJMtHa|bZFg{7k=izONcT4)9^>cqF`d@xsGlZAZnBVbqt%#N6RGxbL`0(z%2PURZ>>57!(7~NgA3d~vm{mI8K$+zGl7YSi5oK

r3Jp0Uc^q-SbK3x%nZpgSinP)CI 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%0Av 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 O0000 = ({ style={{ animationDuration: "2s" }} title="Happy Holidays!" > - 🎄 + ❄️ diff --git a/ui/litellm-dashboard/src/components/networking.tsx b/ui/litellm-dashboard/src/components/networking.tsx index a1625b6ffb..e0dccbe6e8 100644 --- a/ui/litellm-dashboard/src/components/networking.tsx +++ b/ui/litellm-dashboard/src/components/networking.tsx @@ -6954,7 +6954,8 @@ export const ragIngestCall = async ( customLlmProvider: string, vectorStoreId?: string, vectorStoreName?: string, - vectorStoreDescription?: string + vectorStoreDescription?: string, + providerSpecificParams?: Record ): Promise => { try { let url = proxyBaseUrl ? `${proxyBaseUrl}/rag/ingest` : `/rag/ingest`; @@ -6967,6 +6968,7 @@ export const ragIngestCall = async ( vector_store: { custom_llm_provider: customLlmProvider, ...(vectorStoreId && { vector_store_id: vectorStoreId }), + ...(providerSpecificParams && providerSpecificParams), }, }, }; diff --git a/ui/litellm-dashboard/src/components/vector_store_management/CreateVectorStore.test.tsx b/ui/litellm-dashboard/src/components/vector_store_management/CreateVectorStore.test.tsx index db2975781b..a8ba55b91f 100644 --- a/ui/litellm-dashboard/src/components/vector_store_management/CreateVectorStore.test.tsx +++ b/ui/litellm-dashboard/src/components/vector_store_management/CreateVectorStore.test.tsx @@ -22,17 +22,51 @@ vi.mock("../vector_store_providers", () => ({ BEDROCK: "Amazon Bedrock", OPENAI: "OpenAI", AZURE_OPENAI: "Azure OpenAI", + S3Vectors: "AWS S3 Vectors", }, vectorStoreProviderMap: { BEDROCK: "bedrock", OPENAI: "openai", AZURE_OPENAI: "azure_openai", + S3Vectors: "s3_vectors", }, vectorStoreProviderLogoMap: { "Amazon Bedrock": "https://example.com/bedrock.png", "OpenAI": "https://example.com/openai.png", "Azure OpenAI": "https://example.com/azure.png", + "AWS S3 Vectors": "https://example.com/aws.png", }, + getProviderSpecificFields: vi.fn((provider: string) => { + if (provider === "s3_vectors") { + return [ + { + name: "vector_bucket_name", + label: "Vector Bucket Name", + tooltip: "S3 bucket name for vector storage", + placeholder: "my-vector-bucket", + required: true, + type: "text", + }, + { + name: "aws_region_name", + label: "AWS Region", + tooltip: "AWS region", + placeholder: "us-west-2", + required: true, + type: "text", + }, + { + name: "embedding_model", + label: "Embedding Model", + tooltip: "Embedding model to use", + placeholder: "text-embedding-3-small", + required: true, + type: "select", + }, + ]; + } + return []; + }), })); describe("CreateVectorStore", () => { @@ -43,9 +77,9 @@ describe("CreateVectorStore", () => { it("should render the component successfully", () => { render(); - expect(screen.getByText("Create Vector Store")).toBeInTheDocument(); + expect(screen.getAllByText("Create Vector Store").length).toBeGreaterThan(0); expect(screen.getByText("Step 1: Upload Documents")).toBeInTheDocument(); - expect(screen.getByText("Step 2: Select Provider")).toBeInTheDocument(); + expect(screen.getByText("Step 2: Configure Vector Store")).toBeInTheDocument(); }); it("should display upload area with correct text", () => { @@ -123,7 +157,15 @@ describe("CreateVectorStore", () => { }); await waitFor(() => { - expect(mockRagIngestCall).toHaveBeenCalledWith("test-token", expect.any(File), "bedrock", undefined); + expect(mockRagIngestCall).toHaveBeenCalledWith( + "test-token", + expect.any(File), + "bedrock", + undefined, + undefined, + undefined, + {} + ); }); }); @@ -163,4 +205,72 @@ describe("CreateVectorStore", () => { expect(screen.getByText("Vector Store Created Successfully")).toBeInTheDocument(); }); }); + + it("should display S3 Vectors provider-specific fields when selected", async () => { + render(); + + // Find and click the provider dropdown + const providerSelect = screen.getByRole("combobox"); + + await act(async () => { + fireEvent.mouseDown(providerSelect); + }); + + // Wait for dropdown options to appear + await waitFor(() => { + const s3Option = screen.queryByText("AWS S3 Vectors"); + if (s3Option) { + fireEvent.click(s3Option); + } + }); + + // Check if S3-specific fields are displayed + await waitFor(() => { + expect(screen.queryByText("Vector Bucket Name")).toBeInTheDocument(); + expect(screen.queryByText("AWS Region")).toBeInTheDocument(); + expect(screen.queryByText("Embedding Model")).toBeInTheDocument(); + }); + }); + + it("should validate S3 Vectors required fields before submission", async () => { + render(); + + // Upload a file first + const file = new File(["test content"], "test.pdf", { type: "application/pdf" }); + const uploadInput = document.querySelector('input[type="file"]') as HTMLInputElement; + + await act(async () => { + if (uploadInput) { + fireEvent.change(uploadInput, { target: { files: [file] } }); + } + }); + + await waitFor(() => { + expect(screen.getByText("Uploaded Documents (1)")).toBeInTheDocument(); + }); + + // Select S3 Vectors provider + const providerSelect = screen.getByRole("combobox"); + + await act(async () => { + fireEvent.mouseDown(providerSelect); + }); + + await waitFor(() => { + const s3Option = screen.queryByText("AWS S3 Vectors"); + if (s3Option) { + fireEvent.click(s3Option); + } + }); + + // Try to create without filling required fields + const createButton = screen.getByRole("button", { name: /Create Vector Store/i }); + + await act(async () => { + fireEvent.click(createButton); + }); + + // Should show validation warning (mocked message.warning would be called) + // The actual validation happens in the component + }); }); diff --git a/ui/litellm-dashboard/src/components/vector_store_management/CreateVectorStore.tsx b/ui/litellm-dashboard/src/components/vector_store_management/CreateVectorStore.tsx index 685e37ac73..97162aa132 100644 --- a/ui/litellm-dashboard/src/components/vector_store_management/CreateVectorStore.tsx +++ b/ui/litellm-dashboard/src/components/vector_store_management/CreateVectorStore.tsx @@ -10,8 +10,11 @@ import { VectorStoreProviders, vectorStoreProviderLogoMap, vectorStoreProviderMap, + getProviderSpecificFields, + VectorStoreFieldConfig, } from "../vector_store_providers"; import NotificationsManager from "../molecules/notifications_manager"; +import S3VectorsConfig from "./S3VectorsConfig"; const { Dragger } = Upload; @@ -28,6 +31,7 @@ const CreateVectorStore: React.FC = ({ accessToken, onSu const [vectorStoreName, setVectorStoreName] = useState(""); const [vectorStoreDescription, setVectorStoreDescription] = useState(""); const [ingestResults, setIngestResults] = useState([]); + const [providerParams, setProviderParams] = useState>({}); const uploadProps: UploadProps = { name: "file", @@ -92,6 +96,27 @@ const CreateVectorStore: React.FC = ({ accessToken, onSu return; } + // Validate provider-specific required fields + const requiredFields = getProviderSpecificFields(selectedProvider).filter((field) => field.required); + for (const field of requiredFields) { + if (!providerParams[field.name]) { + message.warning(`Please provide ${field.label}`); + return; + } + } + + // S3 Vectors specific validation + if (selectedProvider === "s3_vectors") { + if (providerParams.vector_bucket_name && providerParams.vector_bucket_name.length < 3) { + message.warning("Vector bucket name must be at least 3 characters"); + return; + } + if (providerParams.index_name && providerParams.index_name.length > 0 && providerParams.index_name.length < 3) { + message.warning("Index name must be at least 3 characters if provided"); + return; + } + } + if (!accessToken) { message.error("No access token available"); return; @@ -118,7 +143,8 @@ const CreateVectorStore: React.FC = ({ accessToken, onSu selectedProvider, vectorStoreId, // Use the same vector store ID for subsequent uploads vectorStoreName || undefined, - vectorStoreDescription || undefined + vectorStoreDescription || undefined, + providerParams ); // Store the vector store ID from the first successful ingest @@ -298,6 +324,74 @@ const CreateVectorStore: React.FC = ({ accessToken, onSu })} + + {/* S3 Vectors Configuration */} + {selectedProvider === "s3_vectors" && ( + + )} + + {/* Other Provider-specific fields */} + {selectedProvider !== "s3_vectors" && + getProviderSpecificFields(selectedProvider).map((field: VectorStoreFieldConfig) => { + if (field.type === "select") { + // For embedding model selection, we'd need to fetch available models + // For now, provide a text input as fallback + return ( + + {field.label}{" "} + + + + + } + required={field.required} + > + + setProviderParams((prev) => ({ ...prev, [field.name]: e.target.value })) + } + placeholder={field.placeholder} + size="large" + className="rounded-md" + /> + + ); + } + + return ( + + {field.label}{" "} + + + + + } + required={field.required} + > + + setProviderParams((prev) => ({ ...prev, [field.name]: e.target.value })) + } + placeholder={field.placeholder} + size="large" + className="rounded-md" + /> + + ); + })}

diff --git a/ui/litellm-dashboard/src/components/vector_store_management/S3VectorsConfig.test.tsx b/ui/litellm-dashboard/src/components/vector_store_management/S3VectorsConfig.test.tsx new file mode 100644 index 0000000000..beb13b5441 --- /dev/null +++ b/ui/litellm-dashboard/src/components/vector_store_management/S3VectorsConfig.test.tsx @@ -0,0 +1,203 @@ +import { render, screen, fireEvent, waitFor, act } from "@testing-library/react"; +import { describe, it, expect, vi, beforeEach } from "vitest"; +import S3VectorsConfig from "./S3VectorsConfig"; +import * as fetchModels from "../playground/llm_calls/fetch_models"; + +// Mock fetchAvailableModels +vi.mock("../playground/llm_calls/fetch_models", () => ({ + fetchAvailableModels: vi.fn(), +})); + +describe("S3VectorsConfig", () => { + const mockOnParamsChange = vi.fn(); + const defaultProps = { + accessToken: "test-token", + providerParams: {}, + onParamsChange: mockOnParamsChange, + }; + + beforeEach(() => { + vi.clearAllMocks(); + }); + + it("should render the component successfully", () => { + vi.spyOn(fetchModels, "fetchAvailableModels").mockResolvedValue([]); + + render(); + + expect(screen.getByText("AWS S3 Vectors Setup")).toBeInTheDocument(); + expect(screen.getByText("Vector Bucket Name")).toBeInTheDocument(); + expect(screen.getByText("Index Name")).toBeInTheDocument(); + expect(screen.getByText("AWS Region")).toBeInTheDocument(); + expect(screen.getByText("Embedding Model")).toBeInTheDocument(); + }); + + it("should display setup instructions", () => { + vi.spyOn(fetchModels, "fetchAvailableModels").mockResolvedValue([]); + + render(); + + expect( + screen.getByText(/AWS S3 Vectors allows you to store and query vector embeddings directly in S3/) + ).toBeInTheDocument(); + expect(screen.getByText(/Vector buckets and indexes will be automatically created/)).toBeInTheDocument(); + expect(screen.getByText(/Vector dimensions are auto-detected/)).toBeInTheDocument(); + }); + + it("should fetch embedding models on mount", async () => { + const mockModels = [ + { model_group: "text-embedding-3-small", mode: "embedding" }, + { model_group: "text-embedding-3-large", mode: "embedding" }, + { model_group: "gpt-4", mode: "chat" }, + ]; + + const fetchSpy = vi.spyOn(fetchModels, "fetchAvailableModels").mockResolvedValue(mockModels); + + render(); + + await waitFor(() => { + expect(fetchSpy).toHaveBeenCalledWith("test-token"); + }); + }); + + it("should filter and display only embedding models", async () => { + const mockModels = [ + { model_group: "text-embedding-3-small", mode: "embedding" }, + { model_group: "text-embedding-3-large", mode: "embedding" }, + { model_group: "gpt-4", mode: "chat" }, + { model_group: "gpt-3.5-turbo", mode: "chat" }, + ]; + + vi.spyOn(fetchModels, "fetchAvailableModels").mockResolvedValue(mockModels); + + render(); + + // Wait for models to load + await waitFor(() => { + expect(fetchModels.fetchAvailableModels).toHaveBeenCalled(); + }); + + // The component should filter to only embedding models internally + // We can verify this by checking the component loaded successfully + expect(screen.getByText("Embedding Model")).toBeInTheDocument(); + }); + + it("should call onParamsChange when vector bucket name changes", async () => { + vi.spyOn(fetchModels, "fetchAvailableModels").mockResolvedValue([]); + + render(); + + const bucketInput = screen.getByPlaceholderText("my-vector-bucket"); + + await act(async () => { + fireEvent.change(bucketInput, { target: { value: "test-bucket" } }); + }); + + expect(mockOnParamsChange).toHaveBeenCalledWith({ + vector_bucket_name: "test-bucket", + }); + }); + + it("should call onParamsChange when AWS region changes", async () => { + vi.spyOn(fetchModels, "fetchAvailableModels").mockResolvedValue([]); + + render(); + + const regionInput = screen.getByPlaceholderText("us-west-2"); + + await act(async () => { + fireEvent.change(regionInput, { target: { value: "us-east-1" } }); + }); + + expect(mockOnParamsChange).toHaveBeenCalledWith({ + aws_region_name: "us-east-1", + }); + }); + + it("should call onParamsChange when embedding model is selected", async () => { + const mockModels = [ + { model_group: "text-embedding-3-small", mode: "embedding" }, + { model_group: "text-embedding-3-large", mode: "embedding" }, + ]; + + vi.spyOn(fetchModels, "fetchAvailableModels").mockResolvedValue(mockModels); + + render(); + + await waitFor(() => { + expect(fetchModels.fetchAvailableModels).toHaveBeenCalled(); + }); + + // Find the Select component and trigger change directly + const selectElement = screen.getByRole("combobox"); + + await act(async () => { + // Simulate selecting a value by firing the change event + fireEvent.change(selectElement, { target: { value: "text-embedding-3-small" } }); + }); + + // The component should handle the selection + expect(screen.getByText("Embedding Model")).toBeInTheDocument(); + }); + + it("should preserve existing params when updating a field", async () => { + vi.spyOn(fetchModels, "fetchAvailableModels").mockResolvedValue([]); + + const existingParams = { + vector_bucket_name: "existing-bucket", + aws_region_name: "us-west-2", + }; + + render(); + + const indexInput = screen.getByPlaceholderText("my-vector-index"); + + await act(async () => { + fireEvent.change(indexInput, { target: { value: "my-index" } }); + }); + + expect(mockOnParamsChange).toHaveBeenCalledWith({ + vector_bucket_name: "existing-bucket", + aws_region_name: "us-west-2", + index_name: "my-index", + }); + }); + + it("should display existing param values", () => { + vi.spyOn(fetchModels, "fetchAvailableModels").mockResolvedValue([]); + + const existingParams = { + vector_bucket_name: "my-bucket", + index_name: "my-index", + aws_region_name: "eu-west-1", + embedding_model: "text-embedding-3-small", + }; + + render(); + + expect(screen.getByDisplayValue("my-bucket")).toBeInTheDocument(); + expect(screen.getByDisplayValue("my-index")).toBeInTheDocument(); + expect(screen.getByDisplayValue("eu-west-1")).toBeInTheDocument(); + }); + + it("should handle model fetch error gracefully", async () => { + const consoleErrorSpy = vi.spyOn(console, "error").mockImplementation(() => {}); + vi.spyOn(fetchModels, "fetchAvailableModels").mockRejectedValue(new Error("Failed to fetch models")); + + render(); + + await waitFor(() => { + expect(consoleErrorSpy).toHaveBeenCalledWith("Error fetching embedding models:", expect.any(Error)); + }); + + consoleErrorSpy.mockRestore(); + }); + + it("should not fetch models if accessToken is null", () => { + const fetchSpy = vi.spyOn(fetchModels, "fetchAvailableModels"); + + render(); + + expect(fetchSpy).not.toHaveBeenCalled(); + }); +}); diff --git a/ui/litellm-dashboard/src/components/vector_store_management/S3VectorsConfig.tsx b/ui/litellm-dashboard/src/components/vector_store_management/S3VectorsConfig.tsx new file mode 100644 index 0000000000..e54d3a163c --- /dev/null +++ b/ui/litellm-dashboard/src/components/vector_store_management/S3VectorsConfig.tsx @@ -0,0 +1,192 @@ +import React, { useState, useEffect } from "react"; +import { Alert, Form, Input, Select, Tooltip } from "antd"; +import { InfoCircleOutlined } from "@ant-design/icons"; +import { fetchAvailableModels, ModelGroup } from "../playground/llm_calls/fetch_models"; + +interface S3VectorsConfigProps { + accessToken: string | null; + providerParams: Record; + onParamsChange: (params: Record) => void; +} + +const S3VectorsConfig: React.FC = ({ + accessToken, + providerParams, + onParamsChange, +}) => { + const [embeddingModels, setEmbeddingModels] = useState([]); + const [isLoadingModels, setIsLoadingModels] = useState(false); + + useEffect(() => { + if (!accessToken) return; + + const loadModels = async () => { + setIsLoadingModels(true); + try { + const models = await fetchAvailableModels(accessToken); + // Filter for embedding models only + const embeddingOnly = models.filter((model) => model.mode === "embedding"); + setEmbeddingModels(embeddingOnly); + } catch (error) { + console.error("Error fetching embedding models:", error); + } finally { + setIsLoadingModels(false); + } + }; + + loadModels(); + }, [accessToken]); + + const handleFieldChange = (fieldName: string, value: string) => { + onParamsChange({ + ...providerParams, + [fieldName]: value, + }); + }; + + return ( + <> + {/* S3 Vectors Setup Instructions */} + +

AWS S3 Vectors allows you to store and query vector embeddings directly in S3:

+ +
+ } + type="info" + showIcon + style={{ marginBottom: "16px" }} + /> + + {/* Vector Bucket Name */} + + Vector Bucket Name{" "} + + + + + } + required + validateStatus={ + providerParams.vector_bucket_name && providerParams.vector_bucket_name.length < 3 + ? "error" + : undefined + } + help={ + providerParams.vector_bucket_name && providerParams.vector_bucket_name.length < 3 + ? "Bucket name must be at least 3 characters" + : undefined + } + > + handleFieldChange("vector_bucket_name", e.target.value)} + placeholder="my-vector-bucket (min 3 chars)" + size="large" + className="rounded-md" + /> + + + {/* Index Name (Optional) */} + + Index Name{" "} + + + + + } + validateStatus={ + providerParams.index_name && providerParams.index_name.length > 0 && providerParams.index_name.length < 3 + ? "error" + : undefined + } + help={ + providerParams.index_name && providerParams.index_name.length > 0 && providerParams.index_name.length < 3 + ? "Index name must be at least 3 characters if provided" + : undefined + } + > + handleFieldChange("index_name", e.target.value)} + placeholder="my-vector-index (optional, min 3 chars)" + size="large" + className="rounded-md" + /> + + + {/* AWS Region */} + + AWS Region{" "} + + + + + } + required + > + handleFieldChange("aws_region_name", e.target.value)} + placeholder="us-west-2" + size="large" + className="rounded-md" + /> + + + {/* Embedding Model */} + + Embedding Model{" "} + + + + + } + required + > +

r3Jp0Uc^q-SbK3x%nZpgSinP)CI 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%0Av z@pI?h8uYSnUlYfN*$+Ht4Yv(B;PwT{w2^1Sx7{5-!}7w1cUPbB1>tOZCY<=3jI}cZ z&CCRsrkUcplAaIgnE7!Q9@;JC?0%NmAsEpKGX@yV{qbB%nS1ep$MK{(4RXd-=}Wf} zPWWIzSVF&#$fmvZ`9L^2rVh(S}_D9 zEfE6~6AH8@57yH!3i4?AFiC?UByMUrd57E2-MsnK?d$hH^y1wEmw)hm9~y^uYv(f| zm+rfM{_+io#+C6Zu?uOo*{{=e?Htw(8#@wgMdZm<8V+sJWn z&&=Wl*x0j&zfM+JRr|kn-qk?ZkGn6PW`WBzR^_x)-?l-mVioWE&ynRR-P%Xe6aZD> zw5Y)z?!Yt9M*F^ak%A|2`q7uY=+j=+3lfWXVqH_xDcO&7IOHm|pJcTwLx(Z}?sgA7 zvU~a|&l_b_Tzqi?qsLIoHnlCxPBf+tqxvPqeckIp4)3;dN?Y@b4Vw(=~T7F0>+O76RwPoD;8Mm`2E2<67 z%-z#3Enc%$O9g>MMJb42$xl)3UQ!$_Zrq#~>|%IJZ8Hecv7jd}fSZ|-Y$DEq;@WCP zOZ?jtclv~WObC-ft$9m{be;wFEq{pK(1_D8D}c^3ve{UC!(&_Wu8pcC*{wL~;VUCJyNpKzGTxWKZRCVqRsNL?7 zhhO~Y!w)#Ys6l3dP%vuHaXP}@aZVk!<6Ik0D_aA%o6`6blP?d)*goA24&xZ2CtO%-uq76^5GC4;cDWlnTKX`@R_-cyZIUl%^OoYUYRnv z*;MNs10`7#ah{11PabTntRTU*fWql`h7hqgM+Q)Kg#$ubOn2wK#$ggggA zeq-7_cvxr#CLwgjgiB+^zZL-V2%xt--W;RE8X@_-@^GssEr%BdTjd0W-{@1N=z$Gn z%Tp9Fg;H;j5_UXl2BHLbWjDGV<7jn&eS`@tHE$(;YPzGL2V-jtrQwk%JsPZvPi3Lq z`B;uJ_fbDgZL)>7TQeU*xX7DKOOCWK%UH4t5KkuY5v>tJiK!9m%ci*j_uYptt2C%< z>m>IT&nO8Ajk)Qw?>0?W`;q=S9bDGw9#lsq{`OsuY7R?QgRN;TD`@X%)6NwqyN9ug zS8cRy*G|MlB5#hpJA1zOCEoR}cfRGv-WCwy;BeDvcoLC^o71lRAH*C}!`(@5Zr!{= z@xZ1(CU10#HK=2x6P`<+=eCboplm$xS4~Sz6MA&0@noIe#Z$^`(r5}Vq6)-CME{F~ z=^t~+sM&zGlHE!YzkR~c$fdtjPiy#s403RTOo%QtQ{vl5ROGZZxXNAfb z`KX4VP#L$F$@23PlL-iwi1WcuQ9dS?-XfG4g*)0o> zouRjAUdT>yFclH`w%!sgMd^L#bi*OWw6NC<1@pm+>jV;_ddCXGBWD?1kA;`g6y%A! zWF(JZkh-9S2nb^wJ`9>fDZ$m@KB7%NPG7%%_2%v8?t1K@-Dke)PyW6C=e}?MBj5M- zcbTW|PF+8J>e{srzW3s#gAp*`I&M+kd8dc-isT4r5Hyw+lqB5__kW4}>n-s_t}o0EelK zH(R@DRkyZfsOt(_oYW5FK-9s1D6h^HZJU}!PS^YHo$p&ZuD^YCLFE&-5!$h0qVg_X zRG&Y8-<02Z`#dJx6d6b`Z3{1#PWC11cvwB5Eus$|c#wWrR5-Oe+dc3AHBT-x&aITv zw^$7jeeCW~YD=SOjI4ob&>RZJ9Hfq8YC16*dQxu@JqJIDY10b~$G*~jMnL5ZblX~X zcNlx!c)Uo8o=>>5^EipM{X*23Lih5`IKJJ;;e&_jjTcEO%$-#3aMz(Z5GtaaRw3_G3;`prW6@x%~ZIA6E8CV`<6JVK3V0T2XS5adQeewMoftQ+nW(`hs0;3k29Ykca*vYI+% ziEtp}&@J(3MXbm=Rtq|AFYuNIsqGSLj3^(geGd&7v;=xpNJYY1PkK&~l zmO(TkH|#3akPE>Lk$8#SB@PWj3NzoC8*)C|!n@%BLapGTHeXZHU(S$MkYK5%U%60D zb=23W$fI$wT`4InbI4zC^z%+J=a1~%z2!)Qwlc)WwiHS% zd+PF+efE2Ir@r+s{ZC*07yg%D{;(hUy0N?Sp+EcQ{=x^$Qcs+^`gC8rzx%|QyYD^w zu3!33-}61+Bl%L|n{~hW8-DZG{@Sm9^N+pFX9Y`zxPe)KUJObnj%_6G>b|@0dh1X8 zI2ZZ5zU`Y`dIKSRhV|)bA~@VOBaPH;J6^I14?8$fvR&>iXmyiOuFB05?E4&o-Ge_o z?pr9BQ}RB9e1uKS!-xnDZT1kuL#z*-%|KuED>i)TmwxW#fV-zY@=GceHb?;Xu4=#^ zb8G{m-89TryEt+0gQw4&Hy0=rP#cvLNo3MsZkLzVdl4^XDhJlB5aX;6XvT;FX|eoy zo(0bnm@H5cDA7=1qex2Y2t6YzK`lFFK9dLcmV3%e@3M_se2ei7C)=UYMFr}ciVD1V zl~(~iLoPUSN$tRZW|2$|yp2X_={&chNB=mmVlxnFcqZJH1NclkvRkS&0szSLaQwR0 zcuNf+qZca;YATk>wh|#*$g^2C7jQF?>E724VkMf;!?L6zSu8W}5va1-WnT!KXw0s% zd|qHOC-d*TNJ7XznA4;usXG@TTa!@boDu;7AQyjgSz6>C@_OS_nHFIMq(F<=^1MPi zpzKph;O3&%*x7)3sSaC^Gj&i(NlNDO`fl!kW7yk%nf}(z3$J+O^edkD)Bo2$ef0PL z58wOt_mjO(`+nPR|DErC*L(i(ANmg85VXDai@xY}|K>;k;2-!7=YACLTfXI6KKjv* z{_#Kl$LFg7C;rvH{AXYI1)ue;zvFkSMLO4ft6$3x9!YBXJHy=@6A{@JgV(>g0S+ybwO0cuyP**XSznN+g?B|(`6N4sgZx_tb8&|dAU zTK%W+u;q+!cy)L(gB@N?m!zC}E+_iMU+~(yE_Yw>=Jj5>Vi~qhK7JdTozs8=w^*qDH#hzv`eQ$o@^)8bVrZ?a6^WEB}KMzumm>)2S4(tui8-%0`EL9m+-^fbK8 zB{Lf_XMw$aG)!-$FEr_NtbwjfCOwTZ1>D!znL?0CnPm#2{HOYMX*Si+diM3N7#X!j zl2Z&vso&h;xZNFuuyx(Y29Ba;=S``Rjb6ssR09W%jZhzH15sM8v5-IP$&NWYo(vBP zzBM-(u5iN?NEw;oQS-#a-tf55;d-;_@6L(6vFMB z(jX*gqz~y!Y|J#W%(^GK+ow;Tx$XzSuHCr!&OcGHs&^;8_iy|a-1{?s@h`d1^43ig13v~Y4xll!iQD~0)+Bn8k~6#)5(#cZq4L<4 z%(hEnSXU0z_mgZ2x7m_jqvINVT+0ncy_c7mv%_5{pL|v zeRDEhqPIZ6bql+9UpjZ!#fxg+{oY@;KiwCa>6t*VdK{84C&y8k`q=@W5s>`vsP+lku_|h+p@=wo znw2Y#paSOv@Pap8Mxc+8r7L5PCB125DwxV=_-VJ%ih0ym!$}rkEb+iymuBht23w}Y z?86LFaL*EpzZ?~JmyHd!seTW>@ntD4SCBVj8zmsT%s7uRt&CZ|Vt{m$Ct#cnmuGA? zVK@kwuyjka?0c*(R>m64_7pEqhb>+AXl1whT2Mz2ik7ECa_g1I<#}YI@pZl73K6B-(|IA;0?RWj9XRlq{J@?cD4_y1sKmXnD{F$Hmj8A{1 zv2WkHeg52;GoB?I6k%s;B6;%k`3q;wAFKsmymsJG$@*%{F)ozy@BUv}Udha5%;h-c|J<#I=pz+AbO@dRIswrF_2q zTi^OtCTb}zne9n&x`D{&93r@ft4=)&^4gy5;w3-!+I(G*Ev01QRDoWzNXorpS5`mt z(8OR0zUg6Mguxfk=GFTN*gZi@fy!6ta8I4EVwRq|(xsVaX4bU|6Cr@2HIo3&N6qPR zVLtn!ko1*#2;^)g^P^Z4)VQr&N*hBL5|Zq~+sX9`VpbDzLR|zg1O6@ybQFe5BQnmM z4bG0f4?lZbpm{$ngP|n26%w!N`vh6;%my9Z#v{rN_c(izFnnN0#AAt51Vc-4`2py$M`SsMK4!t(L5YqIMoflhEf!3ITR&$yRdur)Xe1UsmHAxxc~Ft{V&J8;!i$%?Jd0cKUn$xvw!paAN=4) zuXxD|A!lis@CnO790;>{F-RuA>=m!M;ij9Q*cD55B2UdA1`Hb%oc*Xr-EiZzfBUZY zK^u_Yz2){NKKZe~_)EWh`B%R&HOaRpK*NJxxziui3h5BvA7r$nll9>>1+*0yx@x_4 zYo^&L;>4ZFVCIyf+ytNj22PIiKR}9l)fr*}wt-Wk+NVh_LD!d#;vLo?6)MdEqDP+g zlpFb>P@tUfX!53;uD|KV?{M1~r89BN8+P@!a3s-Xw=2>DioNz5-@Oax<5x;$THD z51ALEOJOweC!sYtlptG zkR>M2_>O>!7Jf>U289q^=F85oeM*joXS~!0`;PXh{DTDz8$k-+II}w94z$?v@ zi)cjm1{Z+3)k1w#pEC^bN8;paP1C_3k9h=vy@|np`r0_3+l^4KOK8kV*^AM&d+hn_4wvarxH;U%JW&$ZUWSEUf_cgZCrH z@_zc_(uQM>8XS4}+y3oyoBr^%Z{HFV zPQ0)czIHf9>L}79II1$`!d6p5+-5WY`vm4;A4Z^BvN}~acuCDEH>W)8G}r3+R&#!0 z6o&=J5G|*NLpr)vin=1V$OMf;K3G2JQ0jqG!;jO*??&>RPEo>Vu>Ru;jUg)fUdPI=nQ5pdzx=MFDWXaNDQ!#w5y={X|CGaUmjT6HIYfLaFhX_EaeI6GZA ztN<5LfGb$Bi>|7{V$`iZ>_ItgL!Kvk#A=}r`iy$;)mkHsAo$8i8knQYc~uhpa8OOP z35NYx!FxRyE@G;J+JK8y=(K< z{U^^n;k$QSf6Pn%@V7qj@rCW|OuJ`leEGt6{oRc>e*L&3js!bvcpI3U!vzKl?(yG# zDTfRB!o@U8&UBE~Q(tm~c48vFTs)YZ;wR_EcJJPOz`pyu>uvw%o8P?t)KgCq&0z3` z*ZH9qi>50jpnnp)ny$W|f)9%qZNn=WuhL`*9UUby;K2`}aas*1hy5T+{TwoXAa za$krFN0&}b`(^DQw?d(cZEAq)iWv$)dlFiruU|&Zu(xlf!`ZNp7MO);gu#QKf6C)> zN3@u4Dl@P~nLd3VIh4}A?d10jp>ZxMjU9LhK{%`N%DOtI^F&-2B_mqB4GRqji6#Q| zLTr(B^$lR1pDSG?$~y8WTF*#{&%9Jp1|7WwWn270!d$GUHSLRmXB$jZATRv8&adm2 zaPX6^Pz%2~$p%71Uk8k=q8ivB>POy@azbonF9tA}s z2k29_B+_aI*VJUJVJQJE%NnwZ``8d;aa5BBCHPv5T%Hb~?hpbBznG#WK^3)4U~+u| zR5BF&fY63KqDd%(-aJl#beI8U+Hg#r5drTm*nPV0udPcKB~XG$*(EHkDLUh5k!`31 zZf|&M$CFf`G{}lT7@6=0+8~pGfCd`p#sJARc01&duB`0XIWal4_rp%OXKmuw|LUDb zzxo~DxsP{#dBV5t1uy)A#g&C~&--;+#l|9yJe&iQM0E$$V{f?A=&)$LhTXg;gUiy#c8@Fp~%H|VO0oV@y2$6mZ*a=K!w_d!_H4=`z#9+!r`ko zdP6SG;332PGP-r=_@JX%rngQB!XBV43L799`j(7v=#Us8&XocKXvNo$r%{2KEiAxo z(q-o%t}N(mdB(+Kb6hwR8JM5%9bjzm-@>u12nt?9GIXLUC7MC{N=;Yv(N2etl?I5^ z#==WtV;ABu%|=`_ji|$S-+P8=R&FxAcY~7;#AU90uncfLI)=dINOYbC<+bLT_As3E z(Qbo~#TZ}C()eKdWV$Mk=JO^PKnshzr5YFW;fa1&GqGieZ31SWILLzkB#u1tD9%rM{Np&&I(^MQ!Rw$Z2YBcm zTw|bL^gGYJ;f5Rk@MW*g?}ZGmyY{+ApLy2fe*PEkzH0|-;YMdmyw!?ZsZaf}>=bR=Um zX(9hd&{&!(p6L8w@StWX2VcC*A6H^PizW6qkb71Ks8Hxja@f_i!NEtc-*|0tF&~j# zG;VhxUQQvZ!l7Y&4IBw|O)54R3Xq6*1oe?`cLVB1X_na7fS9Fgf)7zDoQ^n?MjQE!jN+=Qmf5xX1P*s3GI3Jb z)>x6z^OFq~Qd-J}$AUCJaSJZ|GPOWxsqONpL7C@IJ8N%{H%j3O@Y)Z6)GoAILqgB= z<=O?co!&6B0uVT|C__?I36QgK5JQYYOA?!}#SjiE^ROL`G8l|6hJc2l60W)W$Iapr zZ}@IF_`tykfJL^ZxYW|J>m;{NAalm2Y2p^}l}n;|CwKA2wojWeIJx&i#&F zW|^(Q{X-5pcwuqz+2@@LAo3!iJw#tOnG6I{#mFqo`xeZfU+~9E3(G7GR)zok_mA#> zz?K)j=nus+#V;9-GyBNkgU@SW?Ul60ZIMddTJ=gx^_PmHkcFnu3Y7bH%S}=$#=4_$ zb(tM>cNLT>Rm{1ATZdwJvq!Nstk2SqmWKFtkV~cBAOnR z63tEW@(I7OsaZbige)RtI1aqM4g^HT7VPvP4#1>Ov3t)Mq_+mw&TmQMc(_68bcTMp z0xi~#>X49U2347LSAN78AIa(=SkO`c1LA`M4%9r0cZ7QgE~x#`AU#&a;)g*%l6Ig= z;<(|FTolic-{~+7(&K23VJ%3Y+_f!q8x?gC0l|bc)Q>*oeRals6AQqxU;jGYLyV1rAC z7!+8CN7fp!2M~(GAL1Ex6y`w(gN1F?1j2G^(28SSY@<6;%z|PJ8k?#hRYy;ASVk65 z7%zDOniW=JVv~%h9AV5f99|il-?eLcui4F~o^s3T+EZWt+DE_c&9|@eaVkDhd+$5n z`p(70T@OC>1SsO`mDAI+{O&U?Qv3c#FK>z$6B0gP!uuDJE|Fyytz~g{P$$*2u!D&i z9vu2T+XcR7@!=2s^QB+?#)&7h5sqW_&2RdPvGJLYef*R3475u=vWX!mGZ6HJOScjM zr&{>e=!%U9vhLIqLZYGRimbbiPzy#aPTdD&Jz$Sih#{Z4jwZJ|rCn~IcclHoU|CV# z1E9U`oa=Mt+2xmfNo?o`;LXg6Kzu>O$qM|>ZCz{-kyLj16xqJ~_8S_BcQ9AEQ{ZV! zAH-iOqGO3kp}??G6N9J4v>V_-R7{JC7MWtkACZmZ^LwE*PYi(Y>b#`e)}RoFN_)%< zcw){sOfUjCKy(++4lKVXr1aVoRTntoa4s5=*bD<~Ri*Xc7C`9pe}e=5d~Ar_!6xy@ z42faU%NKqu3c*WUh{Rb+geacpU9S~{3nHe8NEGv}cpz8{#kW{IXj z4)16hg{E5UB6MJyWF#5#3ya{VerP^ciM|;<**8v4H@`z0Ii`)nX*CtfnTSPY) zGE(J!p_L#du%5cgsh65nMBk7>x;m-2%&e^Jh9##z?Bs8KK{uuVcRPNLtDu|>g zAh&@b?a0yE{)h3l7cN$`C^stL$1@bWxKSst#;ZikI$AUZVRrWl4hzqq?@>B&n8tE? z-FRll(>;e)T3KGi=Os|F@ie3-S2Z2VQY{pnZ%Q>^5vNxvaT@O6>uQr zV4z46uss+p4MXByWj3OZ!l7O+bGiP2Ix~l$6Bq!55>}>PhW|@6lek$;!~+MN0?(Q# zK|I}dG9o+{1uQ6=L5^P=k&IXjDCUR5e8mQy=&T`)&a)FzX4)COJ%b4IFuBAWMyYfk zlR%f;fIx$>3A_)$$_F|PSDFxFva|}?Nhkp;aSL396HqQoA(bgQn(i1lu-Z`y_|X*5 z62tiFQ^t~&!l|kG#ogn}bJK@x9h`RZXD+?$0nd5$pZ(XBqFLH@{PA1AdfAm1yz$LP z9D3j~AOB*&c^DOu5Mdef^c6S zXIK^%Y4*I|IQO1Aw!P*xe~|}=gKvN9%V(T^`ct0tb3(J_XnbOc-!u&0;CfTpqNo}m zJ*2r6^yO(V07Dq6rDjppgZ2tkMV*XHJ1TuDPnr4mC5->!rs zcM3j#s4aKw0d^fpjTQ+VR}lb$`Dly3^Jj30bw-!j=_M1USh*)MheoR4u+THyMYu@7gBFj9SR$>Z!)f;Qa&rA57U@8)#APkzo=h~{j=!U;T;04}00mUr8E=A~*=dK#HTP<*s3F`QC-2Q!~@lT*zlKUh#?-gXFY_ zKe~WE`KgaF)-V2}S8&UR2@!_H#RXZYkU|L9IdzSN@Tw@4)pWb((kK~bn8HVJ&M5`l zBd;dO&lOZ&V+7Lm!1bqeGbgjOf8G>^Mq#Q;ZxRL8BM+rjC6z2r;|!(zebkwcNY3ES zZOqx?!pQDGK?&`)*^`i>z9s9zQDo(Whpo6I}p62!MGaP|bYikO61AvF3TMxXPQ=FnyN#ry(0f>FW& zW(7xoY2umH!1xd?=tC}1P4vsjJa_7S8j z{xD8%qKx*yU+YB&>7njTooXGG1Oeg(iK z8}Jb(u#!oG7%O7|m<5wry3J!-;K1mBDl`NmlhgCN7A95}H=cI#+<^x?@9qC|)F1un zrMKUwcU`>w7oPsi?K^h9@CCm~TdcS73SYKALQ%=CG(^oiDO1VlSBNJ`M;rtWBR?+2 zZfp?xx+~V{ffe(YT2!!dolFEhCwWlip9JKYKi$2U?P6GxT90H7_EChAau0Xd_BeKh~7m9g~5Ht!m0?hD~1*op3BU*(H zk!_74sT+zrq=9Ta;zGloWSb>m?=dAY9}K#3gF~tKL0rqEFj6P4y?Nd z53O6?m=?0X>3-NqLE-acASXiwmtWh>ucaR?AdX9E;0qj)$p7Xy)V6D&V*pzkOj z6K!Z?37hA)94^t}5-E}xLvXu`7W!*eD1#o*BI0R)4V#U~(O{KdB}izY>>%LiAo*Gy zLVVhQVXpgwcy(pLc1YMvs{2qb>zK~_ajUF2xQGW4fbcnyRbEn(VBIM-AM|t))zlYJ8I?8;fD%I$2aIJ0xeZ#G12t+pW02Jc7-^1_`)nW@j)jCc(Ku2N3y)m^ zNx1F|BeG;glp5i{7Esq{MDl66%%WShn6S_|uP;HJF^4k(h|xkgR&K+DA+jX14XD9g zj;${4SX`N#+i=1ICeM86J3jW=tuK7d+rRL2EXH8*&a+NG`j*CahhG@U`pEj}d3`RF5$uml9Lls%$W&$8gCp(rJjvjX~`PH1~4 zHxj_a-kyEN={MZ)%@6#`hs4P53*C9gum0*&Pdnpmw#qtHL|pvB5ss=fr?6KeArH(! zPF5YZGD=OCU)Ny?10Q8=U0}?$G$ZBG%WW&~k*~WCMCvF=!8g)gA?qu6yFQCMdzdO4 zH`RwjmOuNMOUMX&YXnjpEDcr3LzhGKU_kGYAl}2?cfc>eEiY;85p6?Um7W_I%p(GX zOfgh=5pq41A_wEi5f zVU^sQAjeb#<9$#{$da7HkhwgWS^#PJ-B5*Pg9alQ-*YyIkQuHMB%W|cXcMZ`W|u8# z&|Sf_00u{FO04dVITyB9ZZ-8_BjiPwGqmZN_AmCyZ$4{X1WQM`A2 zZRf?G{_Gbo{lf7NK9*o_X=Q23=Qtj=*CldonOtnMdL>PLq1F=lfJ9BF>-K)?`;n)g z!FhSnEe&;)dMQ$_@HBt z`?X&^S7_fL8q~(6lw02sr8s>}r4Fi|J(prZ!S)BAvx_SncyZsOF3yK_H`pTu8krHnd-`|xxU)D|K3;6u{UbSL&V-Su*tQ_DHa4Ad*-nfeb|m`3S@>8E`Otf*`mV4+wpGnLocuDfC%Cc zaW(-stWKLX_XZU9U92>PKZQXC9X=C7fn6t~+zpOEK(^Bd>9mthaWD&zsa0`KL!Hc8 zAP*6PPjsTD8A8((lt3kM5h^>zPv?NlfuUoPs~Q`2yB*oKjT?xE2r<$=DydFtQe-IF zZgXn7I}=zEkpF(80oP9%=8HC6ROI5mYKC6y>{Ev4*a+uWXq)i%7QAxP)j~MS3)y26 zOFMQ!{-%?T+daMIytlmf_*cE{7QgMmD)P49f9`V$?Vjk?9To_7Ll}D*2r`uQJ&u;4 zRFYKw{GWq+OACVLA=bis7if1Ngl!gM_13$MVwheuB&44jFKxx+& zBZU<35)ouC7`G1o@^ycF*IoCV`IxgwbNs_a??t*UxZri9c`=be#m7*)Ly!bS*a>MF zJ^K4T5qfJ_1IWOMsK`o!!e~(gs+xUcfGDWBSL1qAzzrJ_wLt50TBd~~2eOqrI?45b z{rB6v0aJhtBf6LUK?YX;_w6kb}AnC0R# zRWP3s;t|nvsZBiQlGN(jqBD2rpGY=75y#IqeCH2L+eJ-Hgd5!FxJ-@HPvJz#>J?vz;j(gY1c zeRWVv%Dp5?lT!{3x7N6t!8lrsal{ywdONf%SD@HH=DC5))Tv_hod3%LqZW<6Br-C_ zR;W2o{aGD%{c|u48Dq=$@grWlW*&0f%<;$l^`|d6@V8!i;g?wRUm5KF;V(Y*X*XVT z6+(SWd*Kfh9$wP3 z4zMrjO1Y{~`EOnhF$Z5m(=oSj_fRH=h`CAV9uu(Fmd%GAx*xq!31}4ih=_!;p6ESm zM=8nlX!grd8$bAnvH9)nTZ=o&#UV6Pw@?s; z6ayl1>M90|yxWNQU_SzjOXZIh25NyVZkd^_oIse-W+w#XEB{V-dAbH7IZz{lF*^ zYeF``j3gO!E7?F$8`Yy859~4m-BJmnj`agRvIQa@yDRY7S40=EIUsQM1pnay48foZ z5jlezjhP_a!(RHu!%>jhz5E$jp#73Uk9d80NZ7V2j$?OFlkK_n!~F(T-BdyTZ;~- z93_Q}<&nk3rN=z>>}#*N_MblZukeQoH{JNXXa365e(DKN{Lc68AU+;?a*|Y+>0l-;f6g3?w&b4Kv+-}pr9DhTIy~J zy)BK8&n@!96@#-LajHgq!8y;=#Ej3)l$hZ`(^BAn4^+#GDEP}ofg7wIaL~&9(i&fP zaVm@ks;}mA&q%WTZji0sKqhX!JQ3PPBVxGBJ`xpQQ7xRn`kx!5kGix=~1_jl7L%Uu^6~a_JSavh8O^YkG)E4L9WjRiO{iE z=b^;aJLnKKbwH+?Xe`00F$0}52IB&iJAr_ytaLzG`b$|>`;-_2&N(^>g#(e2I7}YW zhCX8|K_~B(PRVc?!e9*$Mhjr5phwXyR@~gehmL1*1sv620eQ}f>$WB ztz=RMVr@-R31$~wc(0E;c*g+3ua(_%^OKwRoqhO;-=Cj*>~CN2^MCcX-*wv0vj6ti z{n?*y|Ir-}JLO@#fy?)K{1xyBjIsdZayFF&r{vU46Uy8u(IjZUAg#h-wg;nWSChWu zjysVZ(h3a#>TwE$>k`41LXnc&{ZFc?n+;ltHU%Y}`dBT#XEZgnuzP`ld&bkAikbec z7yM2cg3tZOr;j=E;NLj+xeL4J`4kC$2y=n-x$d1qqQoz{mX+r1nnekhLsG#vAX_f* zAqR$eAZ@t1JZ_x`47=RQ+a>T_S}5yx_h`cKCRA{*Y-MY};fEeh-aU8k_{vwlP6Drh z;E5uToJ0dboEZT)fj)O#W(Ft51W9@3Y zt8wbBN~J@A*UW%*{M;buY8efIg_=}x0gPU!<dzPeqao0|(Lxvz$$`0&h1;@^plBUZ2Fsby_1#g$*E~&jX#bk z7g$1@Y^tc(@J{{_z`gGS}TPkdAL7c;_1;RFPWSkLI95 znc5McqXbNA^GFPM4vAZmyQ(wYq&0Wb(46{!x)YjU4rGkcF71JhZmQ=Jj`e{8tN=~r zcXuqolWXQ%IM4QAOcR;VLnSUK7fn*h)}S5ZVg}{N51JE;Lx3UEu|`FTGbSKx1b#b< zVb+iG!Z5pvfPw^%O{hYFLz3TD z$L@hvy{`6`W>c0lLz{dK6qI#PyM~+Bh}lTH$H5oA=pJ?lr{D!EY3%A( zOXgRTm8eqAX-}aLF88f|;W5X7Rw*VYr`gefh@N=DgFf-^AN#~7K7IHR`v>vNZ=e60 z$3OVwPk!P*rf1w$g8xFi85HQsp{(w4sKfk;J7t{60LU?14_h>vhe*Y?nBJ3jg++o* zH9m^4KMJBstu73w?nt|JAIQPJ2OU&p-@59{B)Z;oHR_sL(%iCJ!&Q;t0@do~{U&Co zmlx+)wpLOBP6G*e5l5qFJU)`o(6Vr)Ngx8p2*kDe#M=dER@a%jEBB}xKOCjzQ4dDL zYVo2_w4UexXcQWV^#Bt<*=~UU#Tg^%3?zuNW_%HSmj&9 zREdAmq+n48l7Lc>@ZfHAqugfyzg3*hp5gHq$~rY4I%2ii9{&A07S)B8+FI$7D4cjq((m?<1Z+MeYPi}5Ifq|JF_bR_DXizOP zFj?;~!*y4zpIf8(*$dB8v3LDI1iadnhDrgJ1pOwbB~7S{jXZKgPdA`VRE5U6(X}bQ zH9s-I7O%y*g(pAx@!z}U`+xD5Z}2l`ED&6G^;3T438$a&=$pTP8x|Flzqo+$jS&zZ zjfO8ug_L#;b2B_b0Jo|`9jV&gAcA7?)^63m6gG-U>v=3sc3qNo0(|-)XHZLtAgBPj@{XcL{e68n5wa?S92zLN zu`kmNi8GWIwH6wzVIZye5Dn9U!v&M`W zgOEacFcCy3njy5HYIxqm|qd9`XWqbL>$;$j;kCZZY}l0=GeEJCQ*7E|1aIu2)+7U!w(;y-v1 z*5TZ9+4ZO~y8N=Q{KOH5zUI$gH@AC%ua%MmfAlU6ReI_vy(A%BT|cENl#z$H=PpDh zvy~LrxM@c)n(h-_iB~Jp(-aN?DmBD0Qlmi0K$LOwEg;c8Tth3#MPE20;EoBBN0_c)^VA@*sZ#-7=}IAfTMvpG zMORg8bOMR?A%Kd@(pgLvE#WG)5f}pI^FAokzXFh7m}B`-A%RW+7*0cR6bYThf8slF zhEC(McLmd4*NlhW74_AO8StvbREagB8|r>NW^k3A_Y3S1z-0@aC)i$` zJA^US zs*1AHvnT84Amo{v-az-A{0{~fUikK}Tzct~p7hfOkAvA)z3ip??S05UUGy)o1^yU7 zxJ%6-iv!Gsr4YBAm?qPW#t_;X?OL_=x`Wj*$J2v)9du>XnYJ5bO)uEbSx(x za?(Su{?=6|pK>Zcv;xz4Y=&mFrq;K({;qGF<`K%V!CPLja@U=M2W%Z%;AaIqumo}O zxI?5*2}RU((g4SsAf2%vNbDM~^6(@KxkdLe0}~U|ngYa_3Wzw!RBI#}pMWy^+zmX0 z-sq1F$sWX;)jqPFI(Q*4wkEKQh!4d8HE2fnb@OyHaRw2Q5BnUuI8QQxCAP*%v%^3H z1~$qGV~CQG(#uC`osMvi-**zOB@iW054R-jH#0#1%g1vN1@tw{=`qA{S~XR0)Ya*`#8Nk zw{vXw*v3Ql860)krC<5#Gv58-Z1sWcduM0&zW9?LeaufjhWdU?8KQaMXEbMX{b7gw zZwA-8G!QRc+4^LGRV~vVa2cL9RHOAOjYWnhvPIbBt*6BN?wF_I?9LA5@SjNxen zwq@>_Baihth^3PDp^tp@*Z=o#?7Hu+!GIuT`;kW-|9AiJ?#DjrEQ;zI1XEM|63U)z z6KT4;Cv|;~{u=`O@{UbI()(1xjH=(~t>^SG+f+cA?PPbOeC;!}(S8qoy;B8nVJVcH%z#0v zJH%bv4sIHub^*T*v^4Tc5G#Xzf(oOMg$e~j3V?zZdO(R& zBmgKp4Pr$91rAIab4(a8@Um>1kBCwlXwmhgB+>9&I|uhkS3XI3n!FyQ0PAdKA?(oZ z30C=VgU^|=Qux$g{P~^RfAred{@GyK*!h<4Ui*`0KkA$(K7};v2-8zD{AMxZSt40& za1PQ614u$qu#PrGdh|9xsaPH9F?ESP+gj@?cO4mJeOJqCI4yleadvfyY2+Fo3RJ`sNn;-iso#)*LqvbkPeNl? z%Q4{C0H!D|{o#I@WEh;N<4Q29gy_dJ(|~cf5xdsNE+c;K2T&%BOKgBM?GnXXhB2dm zm=Wy+&pgbe%T8Xi;YqqNedJOJy`npb`k7!j{iXLfTsqI!l0nRE9y9>Xnq8h;5MUU) z(0geBD=a0((P~JLbki5N|4R)H-_F7&{+JxOyPBWycr~LHNecNCB`!A%Ye$1cW@1E8%z-T)RMKYii&}@$;2(q#}DlKqT07z>5 zBPm6x)v0~Ts?hR+OASi2*P?+>V?4DN!?4MQh^&AFe;^8^yYH@IZsZo!$eDbLf~P3p zZU|hur0a+OYpZN1WXO49K*q~o{!(5-e)5xlq3VA2)1SolzV3BzqG;2G878mUGdY5b zg1&{Y1^Qa^Df;hDts6415$2V@VgIOF#R0(5rf3wzj1<}mhBel(mneGvR5kYX`dT>ydoG{gsn0Yd1}1;!dR#+{=bxkdGC z73GVM*2|*oOrSAb`ND^rY_MUznd7fRkLfay$QYgw~u|CG*M(K16EkNn%&jfj8qQtj1A37js)-Dn)VdlRx$7!n3$*I|+T4;@l1sP*wLMt8+xTne!DtE#+OF(@18)amy!o!0 z5d@Qo_Mjt(0X{OZ1cm~g!OfOspoSVpZE|ga?|pG)SpiP?gxp{Oy$l-LLhB4jP%d3I znvRx17c&iVsOUP8-j~{3vxKMSfew3v+Ce^T>ah)HfOL7!ct%5nNdN`$VzAkcCHitE z62>`DjreOX31fI(jS-Xuon||^G2n+qF0N{Fvp+kL2|Xn8!n7{0^2P3%y=TTxJnoL& zYiGasf@i(;?`~zY4+^q)+l6m`$1OMCc-o`RcB`Me!hH1t)~IXhh8hKE9nw*3tNURI z_az?<(%SxSx2>3t46!k$tW$>9#{U>M466gNtDt6b@wsH=@ zV5G8Bv^4@-57v=uMUMOBbyX)0{lOjFGH`A)U>AE>uF}aw--h#wLlxK_Kb0WDE~=z87Q^Nlum$(RGMdZNUU! z!XgZg4-5%1vCFoL>(CZ~0VYAEc9|OLympRiSqe4M(JWE}S~MFV9q<`o)o6KsWoB~2 zX~*u|XP;-i{yhi3;I&`8h2(uFrG=aWa zu#tv=L@*cq$t7plgAPnuliq`lhOmJ}!qO=-(qh`2n3!RFeIhs*JniYvU|-Dn&wE~} z)wjR#rNa+9_!pk~zgCwQ;4OosC?N$S6b4ra2*1T$2QWRD-OV8f%Zi5RVK%Vocxdjc z2FQxV{tjOu>!1=k4o-XcDSl;hF#hf9_})8@$6&hRYFZ2)QrNZ9jbuUyvl%aa;@IAY z@Uqz0B44aiiuLvM7s-|ueTyoE9J@=1CQyXn^wG05vI8)9MZ1**F4^) zSfFo{0u+`%jEoBCvKopFfF>KYcBafk9n0av1C+|Im=F>Bu+9jaX@D%%f>3O;RL9RS zzD%z*1~_GiLaEqltRYYsVFdbt_0O|MgZK&r+~*^0=%q9LSQtzJBSuhx0PzT(mf4zH z1IM!izuG~&Dzhq$B@{pH`9UELVu{2L&peQvMkUhsEczIrgRX|QnfS&usVKQ6xHV;{VTAJs@k?cB=*L3B-gV;mvBVv&J8)uQ$2zegvj&8;<+YK13)|?mS46%8diffYETv;VX(f5hNsZ%J$B` z`I{f!ap%*Y_KZ{;eDuTbpPbq7@>jfyUrSR6I}1>@sPGAyR9(ey%juG36+pIJGyZ=a zeZ4-hNA=1d8{3Ozp_5KM?W!x;ChQY6p0pvi{TR_Xhhlh8k0Vr)Bw|*L#s;rEcXh*- z)lGXTf(o}Qb0C2|T+nDD0RnDwbZM^Bl`oHq1H&_abV$rdBw+!!Zi?sidLJvO8dw*D z1$57a0w6JrQAu8ip(5Yi)c>=K&SiS^7Vq5frfdsWrG(ZXk5mp^E-N933Nzey$nrs6cXAL1?VhLXW zpwfdCpao_=G=s?i69^1!GIwIjldNI30N^AcQ+Sr?F->DJU=P-dm!ge2m~Ck|9S$0U zx|OxX>FEuF&6^(b`gdP_)AfT*M-6s;m$zKr{MY~IxzBs9TwBU_kip>%D5&dzc$p}~Ls*B8$^>vYtNJjZ&EL)ysd z@@bb z->L_P=ls+;|M8jsaJI-gRCjcI?e4oP`5g3B%#0~fbL(GaPwBu;u+j&)fa`i8Ne{F8(%D($gEG@7i zfG{J)T$rZ2IT!`O`}zPpns0o7l+jf@n5ye+UR*}w_)HYiiM%R_g|!euQ84hJD8OJs zFikku)xjdb(Ckx&XeQVU4yfjuoehD|`7+GpL!?E36Adf{1cFqx)|Dm<*17ry5)PfX zfw}*b4p)>O0fCit4_1N?!qfw)g#qrF!j=IUbv2LrY(H37m_2ms%{N^C6R&^A z9xXJ#E30%j%z^4o z9Y}Y-{+fzm96jfNZ}2#QL5I9YuuhK@ifZ5NAT^_5r<7FP_w}o6kK6n4M#NxB^{#MT zohA=hV1HN!MJI3_3_kst&phdgKeM*B_h4-s5~5%7M`S3na)*FxA#RDD&I0J|9$gAV zWv5ctx2joL!*d6noFN~)r7y)6W6Htc_y-zjA#ihZt_Ws(b_$ZqsT^(*-Q{&xB(hWh zAG~Q_e#UiTdWOe1h^pIG>LH-gje6O0;&fjKU@yNv3`y_kl|B)_3`QQiA^oTjMH&Nk zg|cq%VxW+A0&PMUosILTpS67u^BqmF`BEU!dbEcp2VnC#AWgbDAPPbVv>X!Hbw~ir zyV5GBD?MNWGtQV6wYM=dkg)1&p`yn+>8#N}Rv1A{O9n2QX&!n&Fm2=Q-Nry(b~;YW zGkQWL;i<)VWZ^=RP-!Wlm&Pi_70f#bUt9+RHx`j{L|9Da9KiZFNVa>mq0dn2JeV5f;E$_vP%+d6)uDKKYL}f|?#f8FExg%DI{Zrh##vtcXw} zVAvcP9lAbqj|>O4M~5{KUz+KNk90Z!EZib?d`WX*X>suh=bZDm?|kcE?aum0A0x;h z5396PkGLghDy=oDLJHlJlZuz@@zySR@kqXz{U4c~%}QP%gQ~BTiq41!gEJn*BaJ)< zUU5ki(Jfb-v>MuQ*tpdIDH__1QY*~(=8dZh%z9M{?s2NPeElFQToYm}0)IUFCf}7T z-JE<0wN5^&#Ag+#mC?An>0F&h(pfRU`3r;q831mCWsGWsH^Q5%ep@wVEbS<{4+OLjp+MOQE_GepYvL2g{KldlQx>5S^m zXMhc@%!4P+TkKLD5HI%?EyA&49Fda<`u zXayi(0FzUckg`i%Go}mkk2?$1373>bq%rf;{B$c*!NO=Ot+LmoQ?Iol6#w(r5o$Mp zDZ)}i4EDa^9LcNdg*deWDEzv^CX3n*Mdbh#WO-7|uNBqmz`gglmdWcFg(Jqd!3!-V zRkFu*Bz$1 z|D)*5D|8GO4l7bHvDf~C-8&R7bjn#c*wq8|(6|;+*Y%=U1i<{d6oQ%nogC)AQ$9>f zTSQCvK{N(0y~=m>QFZst5#>91P%qKwG=pOYO!31u5TzTS1BQ|)ohWU^*|q%cOGV5i zTsVU$AIc%RPK2T-=$;v>L8d*AtpbZl0Kqmfm`3SU zU80^MP20piBnU()1WRC6C1Qfidq3aBQKRXr?8)(5bFP?Kk!Is!H?C{HXf zNxY$pjbk=k->^^2!1y5c;u5v}EZN}h`y5t65aSH(kR*_^=K&&dab##!Nd>F2y0f<_ zu1myBWC7D9ckmiD0lWLrRB#lQhKn2!HiJQ{`GD`>>Z`9|G5zoV@gfTSwWZSAhH(UO zC+xwJ6KM07@G&$14sT?Ul=PL87$u_U?902}Dl?_8twwLLqI%U_ibM`a5F^@y(+)wF zZ@jDFGG#lqJJM2e?{~UCfTPlKxrC4os0>PX=XKaOVZ~nURy$~kqj&nLd^IQL6ExAV!$kCJYedanCFZ*9fG3+dn273^KEN z{@f*-Du_7ofRg}pN_ltieHgE$B0w;FP#;s@VyY!z03G1WGV*{9g=Y*QQ?0DMKx8T7 zv`(9@B@mXV=!JytqPQ9dF#FwPw4C0k`OJbK)JeW$L>9zpM(X$fu#7Bth{yd=PymeU z6sk1|CD$RKNumR|XFst3IzYw0M7|3_6X*prIO*Xp3la&Ecoh&}pI0sMdp`7#N;aLN z*jMQvb8g%Xi~9;gxDH92MY~C93{(?3S9~Sf0-H|rfoeHbv7Nm{T>&$l+2~+?-k%l! z&P_L4#ds)48i;wq#x77sW9CqbfSBrfE4)RT^a$0ksKItvEa;9P>#+ty>rPRTrUTq8 zgWVlH5^fR}s##-eJdWi^{56CN$?IzcjMFf8n5wdLFv(#rE9JTLyOns~sI9u~EKr$S z-)iI7vX6U&f&Rp&KF3A(n|pFfZrU9e3dr(YH$8drMMphQXN8Ipaq6G=lDALkaezoN zvA4pF`^LW_x9B0Vjo))m3b8U6Q4rSbj1YL4jzX6z410k!e?*PG6OD}^KqHp zlz9Y(pa^2*qD|~ML`#?z`$Gr#T=d3OKQ!3G=B$xhZAN!*n0iWv@nlt7HR3Y2dN-PKb_m@u4;shzkUu2PvXvZ{1-~?95 zh^^w{15Npo87J?oGN@n@frf@7c2G8B7f9O;&4FYw6?5&9EhP}J`7in;V+y+FT6qT*n98FUBT7VvDU0_Q+;z80 zR5A&CPzGzn`v zgq{$I0JX78Rs)i_JsJv&8x1|q)c1~pJ*D69z_<>-UspuyYHqu0cVvydIHk_`JJIGz7eCi)ybOJ)lZu5~C(r-`%X)0p$Aw#l3#11u!VxI@DGT*f z{~r|;cf)~m&C^6w(N_at7oYJ43c3yZu?kevW|##Y9>Vy<0mTkiD^LL`Rz&^IBYm)A zi}()=%1$rv&>+^F5Z6n!hQ)UP93EPAfxxJrX#|L<>!U|IY2Tp%@_kmp+=eWk@GCrE z!M@QIS3OX0g&QmJ^yH% zyXtiN%#?V*y_#O4au27H!AmvDLn_VNT{W8aJs5d0{g)kFhdm83i>&$O_{aYuUbOHcwv4b^1+)*NURTf>TM=Xi`ic$tr5RP_PmkPoZgtEZ3j#j#B zVC1fm-c?oi>6b^>0$m_kRLXzkDrY649fEeu>hkK^a*I{LlCdpWw6L|6Hfg+W*W+kq zL$a*pU4W&n)xy8RO&xR9Ta*T5bY;o4~=3T6hM*vA7htgI_?>#vJv8J=J8Ww}A@ z^n!>1CkQw--FJk#BPr}7a!{O?<3ruE;Fcbnry6zv)@N@os%Myno5eKo>=8$Ui6SO& zVKV!f!K^XS|A52&2~2HxTD8oozc<()*XmSPuw$S|pmmr&43SG6%s~ihYMoB8Tw}ii z{>|WnVgrRdLZ%BKqZe2d6q+tUtG%zihIv4MQ=uD%LMAYIF@2Fb<|S;J_8kHw5B5R_ z2qt-&h82-6@pY~&V=KA-R~Wd!gP|-%Qo^n_>Ow@$tBT3)pogL;=wzl8Y$Eh%MO>2V z>$XIhk%DVAD8U=Rbr{Unz=xh#-Kii!QvKgcWMu?9xNIX$br;$m>`} z_oUJPRiP{BkV{27QpBkTv2s_~TFWh&W6Qh!LclrQ%R*5T$s)7r*kk_IwVK8_wSlJh zh@S3i@|4Fe-}${UUYk}LwF)|JCi=n1{Fb-$vXRJTJf)tqVXN%{NO<6!n-Wydl{l1P z**$zX>O5rk?Oj}O>Y_erBG3DskE^ck16Hi4=)1+ZVKxdQQ7Bn>0A?oiXgFgd{boZq z<^mg_VZrjCU|`TLpgX?qB?o-I0VcYHs^O+wed8bV2;Dd}-64RfBb1?vHbh0m`Mc&n z&fhO{eoERAX~34!HJ$>@&Fxxo6Ml(gM`POTs(AH((Gq%k zd6!cE|JWnSJW|pDrmdzlT_Xk7L(q!s?T+xjF{8_CsuX(;Tl#~f=B!YGhTBpuAkrFz z)hb%Szx5Q5V-5d{VOYprN1aV2-L+zdh=hr1Tf2vjWf`3KpyL9z_W3KmN&>;b4EHeP z*k(IK!vEGrmy6KiYt~MG^6HNJ40{m=+Qdb=Wd{{RJi+3=9%xaFIgoJ$lLRgnugBsk z76JE$k0oB?FeyaJ@z;*GG3O>W${X~ORXlmJF} zXmnIB(h(6>LLPI}{fOAM;vTM`3p8m?qNRFQ)RUI%4wt3;kDdx4OW3 zA5Hh|T2!5ieBB#TkaD)r;9uS9>kow3)##MEiR`P2H zMmCf%7WN8VRe$0`QF(svl1!s=pAZr#aL-n*nk1<3IBH$ISTRYO15}#mhV2Dtp)NiA zV?EGUfwSEa%fbVC9X2L}YDD3KMI!@EM3(4{W!PZowjAhlTH_?&cpno%jB70j!8T$s zXAC&#G$IH1Vh(~jhZ37^f1p~{`^gE{oeO)rL|^NyM{U)k&gZd(YDZzN>QZ__}C>) z^xf$)lOc4g(O2xV`kWpDL{x)c@F1NNSv*vxUrv3^=}=~nya&D!1FG;Zxm{l61cvn? zF&4GSSB=Q?zezwnqVfd9BM^CSXoVy(nwTVCErT?{+slm#k z)d`VlO~dJvRHYp)u^}8h(KRu0-Y?2ad@RUu4^V3<~BPujTe)3;3T zZ#>}m$D#zmh&0(Uy&PX&TA7%c{L&?tyzE8Kzx+#={_DT|z2>!=ZteHCs4s`+_b}iZFt@(bB1yW8sK;05x)PtW%pNrF5hd(jrer z(59xJ#u$N9pjyVBkf|CTjG*m+Q>#vCw$Wuy)co+nkMZlVgB`ctaa%I&gF0Iy3<)8P zB9N!$YF_54BPr0RfbWc-T)X(9!S`-l+j{KS{EkGt7(|MYNyB1v$z6Nu9pNHTDyqQ| zhS@4*nIJQRK$$QD=zH{BO<*k!K}Wyg1bU>jIDul2rH&6tvXk1?6K&x=`eE-bw+a5ui5j{a1n6*;UFSJ7qDZr@S z7$QkZpl|<(BP#5rF7FzVrCmX@4K`GA5N6?niixGE$pmG5Y??Lg8e2+1(2h2``_d}EM7(Kolg4uf3|P&D!QxHxx4rs~1ODg!n;*520WJkeE3FN&g&xXc z9|lvi?pV3&9zN7bw_ua;!5&8xs0rC9is}9OhN@bJDHR)& zI=Eb;2p#v-b;8oT?~EKa+>C-rhp5j>QF3U9>^3MxsZb)~$OTeM;nv|G%L1WtGSNpG zl@oLglVItSVAD~+2Of9K;XiQ@w-aMNKtg^-g-5s;En3lCgG|}ZA@f9zbXsL;iAL7W zf9dMB+s5X1jx)i)g)6a40~}aG-$_CP9}+MN@Uu#OT-)%WdVDTsrWWmMlNUzMLE zOkbJe*Lt`G9C`QKVy+?Retjkn3cWPB>IZG;Lcwi3$=n0HM)^>S9WuC(Ycv8%tO!%+ zbjOvwMZ*NA0$HF>HZ8aW$!uRmra)UnRPIB53uyL4|#O_c+*rE^DtnlYU23I+p z2s6#03)nS>44z=`64gV5(-uC~4KbF|A#56K_aS8XjrD*?knw0!S80#sx$MREz?8hf z%-G@k*A`@Wq$YE!N~SZBl9E<*7ZCrANKS@Ud}cfD92w@sZk26b)uG(3(6|)c_4d2Q z_nX@M@C`chT}!JwSC{TtUEQ@bwzRzA!7~%bPH%hnk9J)(r|GK*8U9(Bs!EY3#m^BV z!3qlJ*{NC1@-m}1LaDjbYM4x#v+l6CG77n*a#Wrj(t_u%ffeu&CijIoRJL-VyBgg! z{pd+3&ed9g(O(@Jvd|oklD2&gJ3dN3xeZea(iW-Kl=>T1Rff5AuN8Jc%23z&09Y^z zlLo*vK0ZIUdv<#4_^b%-+Tl*D34eec;3%6O3S7dcK1vXg>yZ^L=m0QGrH29|X)SBpbD-CL)7b(QX(vP|A}!Hu1y?sJS?I z)mlf39%)5<;s&8({CEd-nN-jsAT~g(zynOSJ{pc7Qv@2csO6(Ak~L4z3`q@?>m4Ex z3FgBZyB|A;oq&EiKjLYb5QxtBqfrYRFKi3QhIJq=YuZi`}Wa^wVq)RkBK3PP>@9?l51SN>eHYNAe14XdzQloXbd$ zuo14*G}t=IWMgm<#`wyR{1wuW9MJBbCIL$meb$hUk^KA7FLvtZ@A%Rl)ycH9G;M)zM?sBb=Xjh1GfQ0IWh05`sAa|nS91?t$gj$mF2nRso4a? zfikiuR9Al(R_FO($43$t+cT5|f5KD&Rb;i>ZF>BErAYO+fTH=xdREwIO=nFH&_h&- z$QTv(9UKr!rZy&ffqWi;xuDUwe6k%G;|%BQh!vJX(}b*okqmkzJ^XXxkhKDeNaAND zk|~15Mf1gTUmixVABaEZ7%p}~yUv<$iI;XYJ6IVE08MS`yT`6YTY#&ceNF<|4YFD?Qr;{pk6 ze?;^$m^Sufj?@~-|M5^(hFep8(@j zm!G?oH*kg9?Unm-azf3K}T@Gjl5$RVrYq3;}7Ca-QfEXup(g}V}cx^5|M z7`z`zR=zQROa-L@6r`&obXTM0i$qYk+7|&-Y;o?|hrqhs!Tj8g%P+se3W#22GvG-# zWrXd7rJQ1jz$*62Cs8*D7Gk{egkK(<_Xp!wUpd%u?_k45(Jbkc5nZGL2Z8#jmGH#n zcOMn#IrB&yjdf@RO;GO_7!A9%7&>%Zvnua@s3HU8ph923%8w?~KLh>vNQlW;INZ8? zcMvlW>M2L?Mel4WPFjx(EOtkqtQ_*+2O6PQ$_Po}1!9e(*M6bD*gZ6Gb(O~sF5MHc zI2(XEq z)1+xmN1RTw6A8=7*WCTda0XQWsFmP=;(+8P!zR~C5bQ4z<(yUn4G+vIOV`TMF&z&LYyM4ea55OH6pcg%QX(Vz?sW-Elm!LfL#}nn z$}zM0Z;L6b%JMw_^F+3dj#-(_^?a}TH5$|g!w8Nv5w%Rp=AooC&&vocHVUO3fdyE# zEDF-DgWZkr1;U^x8V4VCRNY^5&GjUROBFF)Ax8rx-KXgA@V07NidZ9&-sA2EKl!tR z{U5OM&ex9JbH~~-4;f!r;5RH?$3`8Ec^D4t0$&{B9$n;>9sDCUiRrM)3ZTqK^%yxF zFSB@*(uuL&k2P@}F;fFFSu5~rDZL>kb3k}xhN_`0+7s8}Tr^}5SXy9ujc|b36$7FP zC|TnPKSKmRSRim_k;eg2f~LEU2p&-Dgmu$AkRyevLwbewKB6=3cI6Qrglb|CrOe)u z0xWuLZ8X|kx(hah8?E+{1$D4%;jP+}1y+g6qdhDoDb%a18xa>VHhK{wz={iBK!RF0 zMQ@qnu)iS(>x-goBd4m6%;*;YcO+=d(T-&YoN_Y@gXi^k?KV;b(=6Z3ukg9bi9I43 zvpORdBMm*ODb&Ks-4j!r#&_RJc;a{r(Kh_KV2hvy`0=sLn^>i;qvRBTIy(8IV+x!t zhMW)`P9sbVGV-OlbkRk|0T=C&B)d1#Mad0gM)TIew5A#Xb!mj#6AmCqrE67O4bW6|2Xl3mpNkbH7o_U%dmf)D5 z^DEORTL~?I{V_}@VQv9%)@y2DZuAFqnzV~ip@l4W7>E?TM-f!h z7ABAfzG}#jfg6HV0u6mDBf;_mdr`6lpL^B}qQ+VXbeW1ZRjIWCrvDlyhER`(eW1`? zP__Oj`3@tSbeI`1dB==^PU%xE)D0gPFgVDjmLV1wY|bIHU@CyRu6^Lo?!qhd-9mN4 zsKdDn#;Ns5ZF8lz6h$aQJX&IXhFY4MAnRn@nX4{Zrdbr~N=F<&Gdy_&NKx%`pfCl) z4A&yGtxz)!DvXsDhW%ON<9iN>X-!S8OW|}W1(L-Mdv*{7ys}dOZ$P00; z(8f5@XqUycs2FBQlBgM%ustytoarFC1R$df_0B(z5Z78G%iw(UD1Npa1s|%dC}ACm z%^bwSP*QkF#5Hz6jZ)+1`p(&@4?AUg!=}agUGuyBQFm;n#8Wwt?OY8Pj+6jU15qWO z)yFiOC>}4lI<I8v=Fd}dy|@aG02}Y>R$O4i zh@e!2|4?BbMF1F|^OOl^L)Tb)n_6ReZk+u^bQSp_SBsJdf&`_8)`Z^f8-^ZCh%o^T zGe)ie`eY8Ls~XX`ZRxjE-EqG+tWyP_y>!(eL4?vdzKj`SXCGup7vK0d@?|$8KL%tJ z5mLbud*XutEd)|wEDJ(yoH{L|Fkpy2FZyWa%JOn{wbOSXun^8;nA)(2GV(&+#S6m6yuvL5Jw}f4diHISvMs&qRcRdm@u)5NtQ@OzzmnnZ*H;; zdMcy!HZyU+IQsx5SON32sNAyn30t@_r1uQe&ySm|cjhX#(^B6E5;Evrh?Us#+ ziL1W$jsJV`Ck{H~&@&%-2Bw>yyT~G_b*gm-)*7RS#muUFUt}=&(zS~hU%s@kGT3Xw z*n`D0Uh@{3`OD)cf(QHw3m|BLN!0itG)oP^SEto>FA@6*k|wk z@0{Ot{daBxd}@~8RE-y*R*~8Fp=)#GT0~W=#RSsy5%pAfWyF(yapmlD#^3*@waYFU z9I|!n0bAEtCY;-)g8HDaqFhwPWi&Jp8-zfkFOItA2!-?sxl3P2odT6nRJ#(XD{>4h z&EX`o48VBcYmr8Hp(WYd{nN>gGI^AFIIDT2>(ww$l)c4{Yp5LA3}(34RYP zKicV+;n-?`)?r6nvvN((sl7_VN~F&~dELlm31by!*H8)*2yb8v)*!kpPj%DT2xaJz zSOY@Q6dr(JY&3k#BYjsC%;0Ax;$i{Kin7#`5{x7L$$O44NfSz+;Y@s{Y@_S31hy!y zkt3rvA~#KFn*2uwYm5_pqyycUmw15-#nI%fO&>XJ%(HWOe9OezJT@K3;Ey=K*pgpH zXPMtLexQqFB{X96zlI`aPPc?vCTruSEu1%Rsh8Q^sznI`K({-g6s(RB>4r&sBVr7- zf6g0s-Eiyb0b7=5r^n}(S3i2`*n2;_@E6aXIsWhs#TDCZ0^1=#;yQiQDs(NS6-W-f zBh6|LfJyD9wE>OpYvQ>>lZwblD9OSDmTIXVgD%n00;m+W%E_&}7_VfvLNB4J1MV6T zL8~8t{-z3Ys}Dqvh|*%{ulm+CJLVQxR(IHRz74er;MJ%-4|vcJ%MHNl4u*h{2_1QE z`=8vj*Tng+9DD71);4S$eCzVn?_WPQJ-ssH!ZmAnRflynHI!X1yd6{uttkQ%3d=Hr zT1OZRB`6R%h?=79^p^zA7-(K4Op`3T(Y`S{UKV7LEA*0n^8C!;9dSaNFdjbC!_L48 zZHuBNJkRIM!IDs%5X7y!><&f>!JIt>l8rG?XN?aGhv`6abyylRUT%a8U4Iw{ZY3cd zVN#P|9Y}Q-R-w+I5Yk^A#z5O6ElD2k$w?;4>bTOvdua6gE5E~dKEE9Wj z9af_fssWE~4G)??j$~UnADd#*1fcC8hkvk0MF}7U-8C>iW#KndiE8$G?55qftPW;e zmk}%f7#4ti&By7?*oMi4@2pNAKC{esAAj=nDaTAd_^_!{kD7Yo$&>qT9Q)-9cHVI79MZ%a zpTkD`%ELsXhrSeJdIFVjvvLHAj)Xn-hccV5j>QD@?+Y4#SWgD~AO3f@h0Al{$dx-r zsBtMRIyl~Uyz)k3+K{z`pk|4@T1vwEn3T$wgw&JUrRw=vp*wHAX;GDc~^aum@6ub(56UZI7b?RkrUH#oZo!I-Jr7JI4`~D3RGn>Y- z^k8vXuUg{;agAbU{)_smOsIjTib3g?t$Y`8C+)!z4huGnZzF9n^RIt?L4; zV1fomNRwD1cmS_g_<8`Am2E^U)H{?+QrI{wSHQ<9+kS`}jOnA%`f$32qGN{?P??AD z<5X=O`duu99(`{{j&ASPqJpP+zgC#5Z5W%}Fu8d1 z?$!DE2b{mZh|3<@AXG?#hXio=2!+cd9&!5fp8tYppZ6@%B4cQ!j2aznxuw+MYZu=( z1H)TBzWk$IYiFN4ao^(d_PLe&=GS&EjNLuAbj-n%$86pB|GZzb#MZqqp{jQ0o)|Lh zqlPSWb&XY19m&b`3r*_>(wTbTmJA+ke{I;Jx3zWW{$*_#E$tpOTpRCP_J(F{jn zOtFYUS)ro3jMHe)R zlY?0!4;CHxouPSmrnp^&XzW~Ft2yFpD-fc_sU*0jkY5d?Z0=<`BG-C+piTpCTf1L`QK9<)9o6mcvOD5_<50C^4uqsSRdUR$TQ z3FelO0(+MCEqf@daT7^3AwfAD)EbtCrXg#k7LFWUQ+<|Umm)cM>|@Tn{EMHa-PL6m zkaWt7D#R(Q;K0&}DGi5yIvs53M&GE0t02W8qOM*lxd?~I^Nn~0_4t$4jz4MU&L6CO zA@okV5bD72*J>(Vt7{5+DgeYP_B zy3rCI2@)v9!}%ma+Vrq&Um+lIi6Ain6AIXhF7o3&5EUB*91rfnO(T3^hz1~4_r^TJ z7{ds{bpuQS)5W{#(k53&o zvG*VBv+)?FDA1QcCYY+ONJvFkO2mQ~L0sLo?e4v{%x>JUxpF*r6aX0lBZH}ixDuHW zb$#>3)rFObeP(qfuq!LLj2the@v}3^^#S|NeEJ)M6OM&Zux*Gk=pBYM(zj%@lG^Fc zu!bri?deEBiV_3Ju%|P?qG(5Dd80z0z1DA6GP$dUgY$k*1X3@q%wV$}F;8_ja*n=% zt@N*hO{*g}CaIJV@tM#3mDm5-Ysk3#t6x9ooF~i>)KZvJXzCi|s?>YPtUk$oYcyq5 z9-!QJLd2pyBG22ijM(y$t8ND#I{utj`AY_$`rzahpI^J-n>xDvw@w^%1S2%Trv2sJ zNSAABRFM=sxREfp4GCYPN5@Jj*PC|af z!QF_gO`ujNJp+S{U|XwDq-lOQPA$8 zB78-O=jS}MR}jcgq^GIyoh2M6=7!HM(pzkeR~IW)VG8K8NJXc>fSoCc7y1JENFy2f zL7wqYuPGT~6{1(HkS4X`;|Cqo-eC=jqDo7XTZw_Xs%;MTJ(%v@MTAGd zgfl}Ju)i2cWJ6iy0SZGmJ3YAWhs*^wID9f@H*vehbx8@j|UvHq)LO%C`+@Ng*+6cFCV*GG92V@PRZxsp^+@&>$DvAqp33NY9_M2_y${-5iYb zSEr34oNHnuh~aCivkwV)+lX!%m=J!u)^GcalVKFAcYLaNjIV@@xmOIdZb3ks0oB$} z595Q|hpN0FF}}tR{t&Rx;8z1L=<)6Z0z%M40RGY5?VbaxdXtyh`UjE91iM_6Mt(IeBWs*JK67y2arU#UB;E30Se7{zHd;hGIA{|e@)BcoGdmBA1JPV2OMC>ph6;ahV!&7eC2d+pb| z*M6O6ykvUyJ)N6=(0lFIXEyy}cInEQrMt{7S=_f^p=QMsEWUYa&e##1fU6nZG~@)Y zUMv4Od&V?dXCAEskQsYJPf{OOWq2&1m^ty&U^F+tEnO6_u%{brurL&GS%9Yi8UPr2 zAmBdRqrp$tRi)A=oiVj_U1Z>vvh61e^oB1&G;OA-ILx(>d|~`zZo(Bltb9_{-^ySF zVPK%ya?!&*3l)iWF;{|V0&|>r@{U17+Ew0^0=9%U$D?|ZXci8EEUA!|ieQr((I_tdC>j>{)2{aCXT8JOdh%yb+c`XHj5C73;`h$x$sw_9?FAXFROVluj+%agf5dU3`2)jS-i zYI%X$RIDf(4wx*7^e0nhR9%aqDfz~t87RkOgwJJ)VzqW-ZCe_Y@~`rkWD4(ga)Ro7 z^5Y*4+!a?|C2rlPl8|I&RN{)7a#tlfLnc{$a5X-L<1i`@#f=;jB3qh8>Lkb{oKq@W z__C-?-`jJ)zGt7;d;XVtKXBpHv8S_`-1oqJGrzp0=f2x#M>gxEGQ7NR+47zR!?E&* zMcsI#y0yUworvd4UeH*lM2?fX86ps-j8Ov5l_Ks z_OB3?blRvO4P3_Bp zJa~|@|H)3iv(Hv>fb7!T2*Qjzi%Jj?nhcRzSO7|(Te2F7Wk!)zB(q4uOVAAF3Bi&! zQBCC76OI>eXXW$GK6m@p^)x;@Nz5m0*hCI8A9f0c{vo^e%M4X_azt}!oH8@@3H+PX+_}BUj-%6H+@Y6Ka`HeUGN6>vvt< ztMXVkgK<$G_UuHmp zN80Jiy8O@#NSh6yhy@5OsG(oQNcOQgpxgdf*8NTV(LkviHDm&5ngml5&6$zb=%dbA9mv6uqt@2prh@Qs_tpZ&yzyYE7Ia*C7IIU#Vk>DFmqieT-4!r#Ddft7(^jrU}{}pfUf6~)%Z{}A&nYreh zGq?Pxv*CAI7Z_UFw_s_{(7^N%AEwj}d%7a@*_JAh=UNhCCa(7js1v%ljp($-g1ah= zX$1MBYccJIUFQ~*Ag$So-o!zSMn$K^X=gzPy1P{1GhQ&3NZwbQJW%Y3sG5PM`e<-d z@bv;sUQ-MvDKsT8j0qZbm22gBLVZmha%3E1aAf#UCKy|2PAsdU)a_fd9R`dTdi2dk zEU|-dG$(TE6HruFsTE=jatuU4XP!dRC#hgmCiQCt)mkGaLRSi^1?WhML!-Fbsc5QV zRe#f69o0c+`SKMUkAD1PIK~Z~syl7OkR{&?*^+Ny&7AV+-dCPF@Rc8KotT_mwy=l) zCBs8Q{rz9RVf=udd;jI-Tm`W6Y{<{elKlW_BgrBjtCwSj=ehtsQDPye0^I9e@E&|C zM)U~Mm5Pgg4bXyJ8Zq=y+hFo^*)}7%q#cV>twXJ;F%h6t(2S(IC`%R*bc)eKFMV%& z%R4^xKcDW*F8+sizx$-qo^{Gojv5~y9~#n>tlF|%%f=jiX^#k=WQ&sYSs<(iQ*~2G zCzN+tazgxS?ivg5P>;~)-X8sWaB#mvd-glDbL^>|b2`1-xAd%EGyChCW`26@>;t#= zjE&9?Eu0-*)IYe0`-^;Eqjv$HJZDK?XKK#qe72ga0d+fiur3lf)%&cg)i~;oX#%5z zMh-eUvj_D(9wt;!O=u$EQx)Bj5kgl7OepD!EEzCZz``)XYyerE(m1+K)XV9$o*M9& zk_HJCyS~Lf!NUvWl_#3;P^WK*T>WF6P17Y{C+PlK-k|BCP+c0My1-#jU{TX27#4B+ zdd9eC!O%eeS5MM5CqM#i(6vIsZAvk}CZZ4GY**b<+~O&xZaJE@W4V-ft8yE2Zbiy= z2Dd?>2O^!`Z4)t};JbK_A=js;YB%_9wo}?g^gesMQ)pZf1Iq3CR(izM3 zs!APR<1cwJKgTS5lC?M_$q(H{QpPp25H1QiR&=eT#U(j$Sw4u((SC3c6{cYGltx1( zDAgaQAjmQLWOip*9UmAU8$0NLz25qUH~-7||Jb)=zdt(h=wJWl&O;AAKrdY|KW@~a zqm|(#WHCi6!f>l0iG)eH?Vlw$)I5l&AVlO10s9Y99aRQ(Vb7>YVR8kH8P3((KWw0P z(bC!d`9HMt^mCEv+q`k+=QnlkxpnH^J9-}8&^N|y#ZgY_O!YfM3ucFhJ4=?&uv#`a z+&9F2B&-4Yxe;9tNJ=v2KDI zdL$hf2CV`_aZ6NX?N|B81osbg!`hXg?ydb!nW%eLMdx2HFVWfg6o76&$_V3u<{<32 zz!YM@C99bX6oziGX(S_mT8Hdq31FJNT=nRS3eSyDgNvGDG>oW+QoM4nREu${EszQ^ z85V>4MetRkq=af$wWW+rHbv1`ENuy)#2C^+cN)+Qg=HBAxBfl$*ewPxx1TZ!wVPI& zj>u-*pecRUb)I|TLjLc(XX37neTS~<*=G;E_dz*m=XbwUoi;PVKh;@R_KH^`*=bd) zO3^1PkrMEnQGl zRYdqFM^R_4!kXUFaLT{~Mj@l21zLLf=l8w)w%dPp>1CI9IxC)d)Uj9p;73nyTiRge%#F)A_L zR&8@;*DRRpf4b-FvYlq1^0eNkJdNVh8Svo;J9qxNck@OzFX{wr=Q~ z80RXzcaZZ=|Lmego#AD(?0UOk$@Ib@(0zlfC299lZU?d(elH(2)0_ZXI_=WSb@xr{ z2}~U13X^ubPTSS;J&x+Z1a9i-Jp^XwDsp-@4)anLLk3b%aGAEjc%xSbwJ@Re2etuX zP-1Y?V51?0GnS?TBrwP%nbQ~JhKhp+78r=&*5!=n4+BG!itYd4LzSr-iU*Q)PmU(0 zQ?vpRxf4_V@GmtbcaX9JNra&5su@l7>FEdVH*ny7R008&lp%%e8M-YujZX}j0aI)R zsQ4{<1h~M9#4$w*En?TSGp#hW>|m>fzfr3`UMz>!!s9B8MA)&-hH9T$r?$${D4 z!NuHhVD7-}irK-1(}P2LNP*>r0j`WFs39ISXY^s7?uQK-AbmkjpXBPFN9T3vuK56O z12e_oAqEx?G=lXEXztGQJ3P`(&!y`#fRQ`eJFAVn9s?tNnC%jo(f2YdhJi0NYkbpo zYTC?L(^ztiKCL(Ko)yE&_~`7$%>xf?=xp6My>30vGLh?Pzh)EJS82KkTTLztCQp78 z8#Fvt$w%oIQOBjKT}h}Sh$|o`l_nTtTTZkYOt)^gM*ETj4H1JjVRqt*iF~)gi)Th-bi!$A@Myn`RGB4J} zA-YN!b}>a(TV-Hr%n@W98HVu;IXfsx$MDZB#poVVq*0vEnwxZW;T%08tHBz&5by6xMPm~%%?wd-b>Eo(VWTg$^IeT zNs|%hHs&X(%aISJh5kaL{L)IaFE^c*XAs@)R45WR-L9qv8@0~JyBN$EcH(HUB0wF` zLG>6OU5v}WUi$FBqT$Y>;n~g}QBO#rgE=BHw6Xq~2|j8&yJ^EL`yg*v(^(xy|UcnvL;`Yc0j|b>J z!qnK*#H1*?hsvh?{T(*s8C*KGa^c`Jo-@2|ZRe90p<{?)%NgXDA!mp#>MW;>R4ud$ zH(6DN%S2M5`yKw`$l}HO97a@mN|W)lKysfxf=$Z@lSgr=9c{ zuY2Q1{^MU6NLgN?!0<14%Q4NgZ1`-KZ6`EFW3ibqCGN72~#-T7~yb!H|nwG!8{wMOJDlh}C6l{VEDd zB5lRMlB}{NeDU9cMObsnsi{?~cDwD@cb{y$ zfDS@X@=VLMTIWj8MBK9&Iu7xxBuBw&L>wH|Kt_Y4d!S~0s~*MWt@ zv)nVs=cOwLcH6CI&;4h2-F;?w86Ki*%()nP=po0Q1w(r4p2BRk!Yn+W7@Wn(rvy|- z6pAWAaOjAmn4(^xnh}OBj;x!ukYS`WvV=a45>G)dP^D%nL@p_}`USLl&1$6?87w6R z)5=k*s{86l(i}`;2`L+Qa^8bAhl?pM>yaCD6Vin9t!CxCNJ4*R5Vpt&L2)Z+L}Loa zoRB=V=K#`ZZ&MCo>yuDuBI4;lTMix_8>lh`*4*|WJV~#ltoUWPm}`j}-#*|7g8*~T zsRQ;~^_x5HeCBh`{=rq>=wErn#b3Rc|Ns8X1usAEr3kPd#S2CK+U8w-2#l?UD%EpK zY5Jq`RqGOG<|QK2we)VZQx;FTWUfLoCBb&hh9c0Vaiv4%tZ3$c=v0H!5ayPqPN|D` z6llt>cBttnR8^bSbbUD=*Kv#}YMp({R?IA0(OI=`f9|)IdChu{qL`WP-@0vPVxnhq zq-SIs*Z1r-&^tZB;|#iLXHKuZQkW{T62N?d9FwLXC%%jzNyQkWNiw+tLrTXMT5!a#HrBtl`WHi@VM^V6`;Pr7wtQ9-iPB*#7X-jk!!8qK3* z?LZuas?Et3luYlHzefyB4nspom3%pSE$PGy6D=x)!T{I;WZrPqE=w#10AjT!1?x7{ zeQ4TqW&~4lAz(-9>D>Ltc`Ob_OvehWlS-&~!-o9=j&pF9kaLo>-W62y zq_YSJa22AX+-(k(dR2%_tW0=+{dw6sZ#OzK*mCai~l>Cb(gWy>f_ zG{D7wz#RD}M0)@Z)qxBXZ8$L=vUFXmjZ7rUPcI=*gjnTzgQZ2h)^ehrOyIey2qXoB z4P0?aL`G}-a5Xri*=EcqgiB8HA?Y}qN=1oGsH~B+i39^y;VMuO8fGamiG-MF@QoN)a8`k{>mm5s%4$vL)))F6oOcG2(Uz#GKHaE zrdxUG(wX`cxxTagIxA{ONJc?XIV$n@0T7M=06+jqL_t)Tz}1rtm>P2WpjMM*TN*Je zX(v2`tf0t-18iXhnhH75$t%^Mj0_?Q*a(6oa_@2M{ z!F4z8yH{uA;olA{J#5RSk$v~w^XxO9_t3)+b7kE>*w1^RliE%z+g)@?jqO&?F%{F1 zg)%mdHM4=kzse98c|_qxHC0)VEy>6oL}f2|3M;WJN#0bY#g9)Wp@&KrNC2fr146Y{ zj3@x8 z2#m^E%a?*KI(R@stI;~~=~3?$%a^c>_v~jslQb)WEUgSJ;G(KekE_}D>Zr{rRjd?^ z#BEfhgKeO$>m?&Y30h-{pA~ed*}UwLxb$czzJ}QhR(IMZ{&p1aG&xh z`3NUVDlI#sT{sdojR^lF)qo@+uu$D9GmC*Ui)8exYLaFmDr(sp-(cNyif&@MS2bn3 zR*E$DBMX}|K^9}|*UEyfY4~S2;G%;gPd)3K-*i`cFN=lT44`ZWb$6Oou72(;u(5?+ zh1A=VVjF77YTW>x>Yz-LS%KjuS!t))`kh%lNyhW_Zg6_A&|z|Rlvs^8rya&dG1d}> zD26|=!@2#`H+n!C|fq`LkkaBvYZ@fk_vv07}_)`Zj=ft zKeaC>RSSBGQz-&Nf<}QnHzrqGWw13z)7-}eg)txsPdP4OFqnNbnxJ^z0Q=C z1gxV}Ipq?Ck>~97RxS@yaBAvwKKH4Q-FyE7Cq3=7@rQ2Zsewhi9Q@J$_|U-z9dO23 z&$|D2YiXzbTK#6{#<3|*ZfdO>@aaRLTz(`(#D6*?ay2anG9BEcoOO@|p-zc_%Or{= zNMf<9SQV64Gx`u^UzA~$zpkvfaooc}`wNs)}xBm%fm*3P_i zic?Vnp*0L;zQvGeoOer7-U2NQVB?*X1*vk_@9;v4Ny!hRt|dF2r=EV+f}w$1e)bFC z@$pGLQ_<5i&YY;zdF^Xn`@$ETz2AQOfA^Z}NU~fiT{cFt7?8=Pgyo=TZ6dd`uQatM z_rjT0wSXieFet!a6NSqdn5956^1zU#oG^lw9njnr7L~g;iael2hp3EM*417D(h-V_ zLCYH@7XID%0uh-gE<+5k5L1;jShV0<3Dsqlw<$6w1ia2G?RKDVfM=>ECnopVYt{F^ z`HdTHxPIlzh1)mW!6%8A?0wibF8kI#d+)JopChij{wK&S;4ayKrVry|JbuF>8}7#P zT6^{gIx8@IDh(?9On1WzIU>iZmn9cLZt!9XHdxgn-5w<7v<#XL0heC3?Xp02ARaF?|hzoMDrW3%)?$D(#NU{c`niC>mzbdS4iNNSN zLWh`<#-oHa&&UO}b?mZQ$Pt%RaF>)SPu>?n(n`vsx%!Jpc$yMCPQ|m@Tmb28(Rt~4 zucX^t`K`+qFJ8X$F1vzZMxc(wbE^YvH`Mv`=RUpPe*4~g?>(oUbo~3y|2L*rJR^ZL zZ8H3dqxwHy@K_b0G%!FHcDQN>RRSbSgD|_%AGn;PqNtIGPA=xsAq8t3yg`SSjEcf7K_yRsk&C8#BckTT57TaxRaK6h zQGF6E?GQFK9Nh=hFwi%^a{=U$tsOUReBcXT{>l>`fAH4(f6+U*XyJ-Sty#V9_~VXR zuz2|=|L4=cz4Jb%a|;%*p)6MiZ0I>*KjdA>U{?rP76m6Usr7y zYl7I!S^#O+zto$Mogr0s2X8vbY?BdlyJp2zx&i@J>4D;4X%7t?~;AO`)5Am z8UOyDpD0|4S+AO$RBa_vdvDlMm;(mTf2I=%WXco~ab-D}yE&M#s1mzKCfCR;H5Igm zjkJp?~UqGiqM z`=S05v?NlfqIGUu2-Q>|NOC@D2OfzadF{17 zyygc#47{F*&a#qUM#}Pz#%}%PufO}fYpb^45NF7=2$B^!wIzd7rc~B85X>o42`JIO z#F9aJ3uv~PQQlRXoqhlL@1+(7hL%Q-S?{Py3`m85mTaO5T8kk@H7s387mIo3Fw9Y_ z6YGnv2nS_3Hbh{BMjQK-bkZAR(b57tWe%{F3a0L3P7z}6p$Q4I1ophGoQWy|KIY~ckQ~{f{_PrN5i6> z443T6`CVE|^8A=a~cW&CoW3rtzL?oqO^^oouHzxRwnEPdHPIb|xm(v)&d6~ATT)I-50I)Yg>lHo zhMheSY7B^H7K6p;$gUAmFHLfgf2Rsc45CG7wTyzSGU5ni8cPnh9mC*D?$o4$J-H&I z!l|4<`afD5iyPGC-~ju@_e}EKh70n2@BRCAYw!R16<59H&tAE>f8+KCf7R(-Jhbw# z{-pNFEFuL$ zNPA?aI3y<(q3M?%ZJFdruAFvm-a2~uE4n8+)WU;gU0O~ktM4CLJmqZCH++p^4~nT0hlivZ1R7WlY=Ypq3=OqFmPpouQ*3;<_7-_= zX6NA!R7++DkkOt3S03rIx?&sEibw>;ge$-I{lkxVY>WgN=lb^;-sN!iDKv(sY5P{~ zd&p-#|7G~2RTNQFPHi9AHo9$OjC}#y*Pn6CSoxg0ZqG>xQIVN$L;`AfDrFAmoMdII zz>X?}>8`QBR1r~kM1@d;uMohF>_X1bGcl>g_q+QaaKUzNy6HxeW%mNUCoDSt2l9E+H1uAD7cqA%#k;<=#bg@U{fB*UC z<4OOJ9&;p=T8LEDkb*^?xPX3xJnB(LCL84<&a*90IrVFJa%Q1+X7Veqdl|Xu%N6|GI6v0>QRr`b7aG>*r%}5vwZ1_LuLn8t-g27OU`{h(>!(wd+O7k^|ebbx$gR# zRzI|vM_-2*E?Tf?;n2Vk&%(2{(fIh-#5f!KGtDbb=r#=IHI1ZH!t*SRGTj0h|CR|! z9V5Fj$8%B#l2(#zDOk+~pOb+TvjvD9@-AS}15P@t0s-yE3PLE4IpcMzDwPZTTxXSA zNM%5W)XiH@gqDh!mNsq{KUJs#jIo$wqDsm$rn*OaAA@;#I;V`>7Ha|fp+Fq`F}NCwLCM7H3{ucnjY zawb9>A=TMzs}4JX-Y`_8Y)FYP8D=fbJzSQE^q95sq&MN>=?*UGd~W9n?7qRi=fChQ z{$aTK+MBQc@%MiAvs=IT`A?A~^bPOMm*{wc_R8;EedV|R7fkQa($h{o;n9a2wsgfF zFMiRB4nBA<_U|xnbKq2=dnY`7#1auB2$x)XB2Nnm9P}tJ$8@$zxv*TA(SO|Z#iW8z zo*bGilCP$4(WV^2*HjQ~!6T{a#I)v6d4rNkOu2sNaHmP68>poU8%;`(1`_`GFZ^8$ zT#SpUT%RUQ{#Qi;U1LSJ6>)ILrY#*6v~N(mE$PfpX|qtr3J!zx;{N_uz5L~y9=!j! zC!Ko1CqHrMq5D%y+JVl0dBH5hQsbg97=}Z2!o`>1EOtGl>b)->nU0n=L|so$zv|U5 zJLu2@Kk@PZ-uTd_V~*DDqr-!II7kL{CyQ^iaB<#UOX);p(kHVfYf-VJRl!ZBEfS>; zQhleTlxO5s>=cJ+ylbi^NKngkePr=#5Fpg50G2t#5LAVBT?lA)5EFztO%R|7mwpaL z6t*&*Fh@lu=Ui0<4ZbzYOTBGe+G;T&3No$8PSAWWMYLj?dAmk}8LkhvZP})MwM)3~ z{5v@UVBJY*vg*w(MsYxabn`a)ows{_X2 zDm2Hx)Dh~_yQm&Z#Gx^14t+_%YU~Uf7nRHYngM{dYajf<)jtYMD?dnDXA-2w+CgHL z3RIAGHJETD5GKrXDB7&W)Bd?ktJgnVQF(!4=0Hk5byU}i&NiuVD+AE|FTQLIm33xh z+X#vC&;J*ypnqs-$Z0L0eVHpI(iGGL+8Di_;}GTm!)PF#tm4U6Nv0OvZEPD(by6a` zbAvF(c3WxKQoaiznG|$htf1i##4zXIEO!$}*aK&Wp8T6T?s&~#yk+;@_u6?EJ}IY# zU&hg%;oTSQykF0vy?Hmmn|Cm(YKR?Py8APq`-0D2_|?1b{q35y>o#oO+HEaUY=5wQ zWb5b%*JvzKFgA>_Y{_DyoYAIRCCIe`H|3q(0g4AUW!!~QN+5G7wg96zTjiP@juNhB zx`9#?4VP^-NmZ8&aqurqhL#zY19d&T=7BXXx6bv~#iK#7Y-Yh~FLcH+kxc{aLKkYp z4M|Xw+CDP+p7(tKyWjryl@Qub!syQN9}euRIyE~sH9a=TLLyi8?789rAxt!e+E%-; z#RQKJa65n+rpCd&{q66>tNr(T^fll6@wh#~kgA;;MZPJY+Emi&{kjQ1y5Z-a|Lo^CJ$UcBwQGL(qo0mXYz^At<$JRq@Ya#h&h%Cd z1(RE<%wvyu%<;!R`O%L%V)4?IOP4HNwa-2W?R((PI}cZeHh>Eg>?y9#d}z+axZ-OD z-%Qu0A$G@eIL+n4H`S~3@0)~I7*kUVSvmhNr!yF z1UZr{givAnVS#tIy!U7+*(`AODw@!y@9Q5}x7%L3BXr$$*ByK8v8>5(<;_JY^#(HX zVGHep>L@va$%teZ4AyOt{M&2o#>VEy)013}|KQpmpZMexLfy}P_VdR*?lJ8DrF?j! zb8h&h0_#W*jB<-WHJd2SPP0G|D%wZw%uHj9rk#Y))->HVzhK=>#z~qMiv>Tt`kK?v zdd~Ju+DYlCW1e#3_18>IjS9Hcz9CNc0_Ba8$&#LpQYBJlZ3wO_` z6cbfKk*qocVHXXWBg#9}OI@jPtBzu>TGcT9wh6@|J}YQEl2V0KF-N^L<5|eSlY>ly zLXsg)JlX@IuWtbe(hLRw9Jy>780)Qg9$4;3zqUIX7AMYTkqQN^Iv_TGpn!AL|Dvv;~@v{xoVewz9}%UV6VORK5)MS zAM>~)PdN6-!9gB2849*}8eh@S6>G(li%MQ#)ih0CH}I}Q+^fcaK1it6N2BF67(I@{ zeQGa`(8|iXP$?=5GVG~$JL}|HI@KPff-M5|>aRx=b$E25O>;waLv=wtMlW&UrBnWJ zP(DWTH&K30(?K1ta~@8BGZWRhO!j#vltSeT6*b0ZB-TbwGtg=LWI3 zi>Rh;KKpzmvSw1Mi!S~-r4$-=KsM6zc!18tT6;-^OhZf^j=Iejv4%I#A8irkrfuBq zx|A1;TzE4<&{LITJVB%_v|3@?_VLMyZL8O=yZrL2zH;GLZvNTLotY7pcdDcpEaN(? zf5AewHKNaUMwuzFofi1$AUz9*7Y}MH3O1rpH5_`-VUIiV@vHXU=b!@)*mIxV58iiQ znz9wPtp5KE>?(B?=k)kg-%vlVY^~Z;vw$0ac->J?ViqvXvp2ur_jX+f=0~X26G>`_ zo)Tw&kx57MR$|@i4ZE${MbMmJ+0ueVvwqGCD4^iAkV}>HTzl8{mwkC=%V^*7#hu~4 zsnMx{HCtw$ve%-^UxVuyWx!MuP?phAJxhJkTY~hkPSdQ_>* za_oII)v{{s)d_Z^jk#u-V^r&wjWfEui9#t;2^FeJsnzKvSV~TDalrPh)fFVQp;Zha zkgLU6;x=reOTkHTN=In5O6#$RE#XQwfC`AsPBK3*zq^yVcW^+Bw64>Bizt-y$Aup3--wxsuq_nSwg|qxC=e(T}dv#=STcr`aM?;(rRVTE?=>7r=3@<+RoDagW`3#j?^NB}8Ce!UBq~Y@EiLLNuk|35?NAWAHo;db{hZW>kwh5;3plEq!^b zuJV6B`d@$kx>vJ75zDXEHB0~3w1|CA;dZqOk|ICPmcjp)?xqT*|-7u>l0bzkW@ zmhVdMr43T3Z|x5@J9G6Nqer}F_}0JGogTh2$dYXE$?;`NH3eW{VsLQq>Z`9g`Q(%O2A5oN$yc6r#?$Ekah8@!&(})s?QwGueQwD7 zm}J}T5R{vr(e$g@h-mx_Up4rt^*f}mT{?@A7@@?TK@bAuN>Jv|kZTFZ>WJG=Wj8(z zTaBv6deWWwGmR~C7u_XpY}lP*HGEL5qcy80s>2!a!8}%)e89R@R7^E_VN>bZ3gl0v*?Leq7XZ?apz>p1^ctX?;{eN&rLg~2wwJqtVf&=6OVgWTcb#ali5%!>_ugBv!Fui1EK z=a$?3)G31nt>5|R*7E;4Wpm=DixOxgab5)<2-FL)#+b6u&96a>U*#K z(U1S=lqYkFqgY(NY>3S4maVlIo*c>!Vp)D=I#$euP?)v{s!G}>e~{Ej8DDthd*Kin zagpm8Rv}#Dp46mutM>ur1cN1}09XVfHT|w{&aB$Gv*+^J zwOeNSwt{AY+#6sJ?&)kC?LTF|u?v4X`0``>AHOdP`Px{m6|&eGj7;!YewR@tQ~)gK zk~_9)qn#`m9=`pTKfCzyZ=7@H88=;j15~a#2YBH{t&Z2LS>T|J#Y6+#?++zk;%ZrD z-*~slG6v9aX(}50T5Rw{;ml(qvYH*YlwR9dOU7t*r8>Z?POLm6T(bfLOA)~;)8dmy z_6lNEP~{U7dO|_Aw{*buFIYpb+0ab@PNB-57@_M=_RUZ*l65Hlm2`2lsI}w48EdV; zXwnNO4xF8Ir;ZyyarZ{=(M|EKPVIWy*SBKHV*Z2k4<4td#SJRx+Osg&`P+N;LC%Yx{%^@uBD~vUcME^MZ(PVP|pmP8&m7n zKkzs2e24r0^dO%ll%T!@6}M4Ys*4ooW_y?7>~!!XggQVN;X-SpgnDjP?hl_IT(nELt^Tf zkbc5ewN!&4n>lq$2p2TT6MtAwN!vDz%FKL}g4vQRm2yGGig=f05yF#3zl6XMN_LAK zx>FBJLHslRMzi(6OrML*E40;bEJv}R3%GR-DIA^77ruP)o8S7@)%X1N z^>6x{4}IW0+ye0G8fR+W@~d^^N^v_1Ng1+FQ8BVjz_6Nz8vxgEcz4TMeF=W?VDFak z>4k&(+%s*1Uct8Lp3iany=UdX>@8~$>(uYj(qgvSSxtyQ_p$B8((|+(@td|iuPPuoOlRXcIb=ijpB!BJc%i? zCWZq%=nAAS$q{Qn$y!NAif_(uRG;oFqCX6j?+8d349@$P_Jc`C2Z=bL+!X%M6BHGN z`(+{{D%I!m@}+~stDIChfPpXvZ%ZJZe>bcw30Ht5QhhLH(yF>OWy(>&UB)CH4ibm1 ztdVZ!R3nE&6}+lIA!J_$qk`Uljk2ib>M~GtT(-w=d%VPyg)IpZes-CMUTfi8U$Yd{nm-pwXnX^Pk!p2o2Rn`_KZDvyBN>VfbYtQ-Mk+!6{#=d*xC5b}e#2(yhX3 z;1FH>&O@}9(4PorJ$MilseK@kGQyi`j^wdKGz`o7!4`8i2NM_;(mljoESf)Pq_8^m zQPnZ~B4$-He9%kj^Wvl7>VlGp6wOvGS$71$d0MYejxwF~hd~(z==@L!afV76EKeLxubzDa}Y}FtMz>ij3;wLeQ*67YDvtC>^qH9u*MP;iglhl-ndvOir+A zzjlJQEzn0C_P7VvZ~veF`S_`)o+u@J>VtJ^K8YmjDkfEKnkRM@x+bFsB4F2|Vgd)h zLS%hr;Q%j|apBF`p4Z9H*r#>J$SFr>mQ~j!&Vr<>;?RtyaKLs#vn)87xD+v8v;gz@ zs)98P7p#V|Q%`#G#P%(p`~0PsTyoLd-~1MsC<+Rm4GkC=xw_*L(&kcsbtYPD7)1}& z00(CPnPHVwkYhv9RDXnZ>B{Ou#B( z{?i93e&ir)>8hE4^^b6)&|{F8_@S-pP0hj%S;C?oc`TQ92-fS6lZX0hQI_-eM{}r{G4p{bs@oi zF$cVEajMqoEb!^!aM}gUNn<{z94!v0_j8i)zbKrGw4|noVHhqLD%9&~djh0fe#xp% zTe^X$wND{R8DOr@r~Mv%T-+gU4U}Pq3~B^+NoRH>ixN)$ydg2c?bgi?Z@&2_KSwxD z7@zsfC-1%Yw&?$?aYUA+T8_H7q9&qjY*Y1RpdLg_lxjB;Aj#gslMm_eL@+Y_taGwB z>N`Cu8pcjNb;W(u&Vyt9NA80TT$J4|y>c}35_rh6fT3Wl>}s@XHw_|Ni@ftAk32ID z{3qw0bKn1s2wr$yZ!;L>-#z_BXQOS)%nW<_FrL{zQJm+OedBnJEtSdnf zKY2na`QJni)=**zW_1fJ0aS<;M8sL(@@mIm{fTZkY^cQ?{l5lE^6E$urJ*LPQVV z*gA+}%Zq$9sZ7`v8%w98Py~h!H@;W`AU)`*WK6Hk&>SRy4Thy0WONhs*T25|kb{qS z;!%$qotWn0MQ>y~=y^zP_~&Z87yq5xpcYr1Vq{Ct@hKo@DOlxoV#CRvBX=1b9_-^O zphW}hHmx}l{Ye94P+bt?};uTjk0=pabOY5+kg_~Glbg=4hU~BiW zJ>e=~6LJQON=e2v>p_Efq%OTosWKdiQQkQi4&j2J;KGO$i*AG~!rCQldFLirEt}a5 zj5%Btupx}QR^gN(6Y z(Z8sQz!tK-XcBywQBPX;4!-H+nQ#2Mcj3bR#Y40GTKnK@>^&@F4E4{hSTOVbU-dox z;Jy>~XK0w=yY^n8D8?c#DlxyrIW748GBlTV>W$BJ>E!2l)7);dpV?jo9H5>P!A-?jncDoZ0 z1XsE%)&8iS9w|r*WE-A`r@N|3HbWp}q`OL!a9W2}h@>4dmUI=7MAAb-Y|-*fNygF_ zB56keozkJ5#bUf#sa!A`DGmb`Exy=96tapf#3=yqPI73PLn{X!BdjnoP_;)=wy?v$ zx@{;{N`sn0x*nxqr18>XK?t%yTE2zyY;fkWu2M6mCzBLp2*ylEz5GbiR+_Ge;y=#m zT7#gQ%a!LqnX~xvuBV=|z`*7KSf;^@>X`(PKX_szqk| zbq*SbO6^NuJIFo%=b=qY-bM+J5^3q8@AXgVd&RMnpZf9SrU^bD+P8es^rGS3#S3S* zPR(BQ%gzBSmwff*Hp6uR9vN)uE&A*sc$K?+h{7+7V9ZEC5zp08xD*#oSPzDi`JDuSCoF*p_IGnp*##UlrUT@r)-x= z5*960o3e#9+L}#^Qd&SEXLj75TOLuerKUX+NEA&i4(rl^pG(u))0e=S6dXla5s;8V zaU)rkG|KC3K!oh~))Nlc3wdaIFiFbkszRcoSzl?lA)+HcC_xlk1}&%&^xZuLHtEo@ zGKNMye9NORB3<>pYgX;P$Ki(^tOdDdj?K~qXEdME?3VMBWonz@NHI?vj`Gg&qGTrg z6H<9j?i6(?a4UuG(APWkf1fvV&`wkTer?Z|sp%nomX#-xdY1GrdBt(P?|mlz>%l&a z7j!0h6{?DP5CrLs{1v!h;6ub2Nt7k+b@8fHoMpuo%2|@&l7Jb(e}DX={7aF;=RWt9 zV~>5p!3Q6xxj+78?rdLOUt>T#t3p2GDGi~dwyF2vh7oC(Tp|jd>q`x0c1e*k5m`iy zD765>d@bT&j-wQaJ6Wpk&@7czshrc#nuWDfHpGOHa<{MG)Rd?s47CI^mh#hMX^<;5DejmibSwt zY~Z~JvIb5Al48|I^!>0Ed{QL_VwI(n0)!U3aH1u~kPzlHQim{DaiPdZu_{=BtiT-a zqsI5SNykW_H{sl!84_r)T7c~BU%&q0cmLBr{^v(NxMJnXhc<4UoSNwC9gwP-2_EyM z|A!@MjjYQBoXImm5pb#`{aph?wr}M zRS)p37#e!YezVIK>4pmH3%Za-kZefY3PY`q)+p6MtaUGZp@m3PM7XJvExB>N5HIzZ zKHEfJ-xOV%3lrR!n(1FK^sR4y|Ge{fV7c>#H~;Owp8rpH#^M1N5Lw(r(cQUhK_$zr zJblD-2!XU8;f$Mwb3+NjnphxbgroK(&{ECs3-d8li3+5Kn${Kvx!plyz#AX5SR@q5 ziu`?^n3kN~s*0MFhUXC#dhdmx<~9uT^H%5Q_o$jEhUVdS;Z~<3RoIJ%7E5InZkSpb zN@S&}c;mlBFc(d8oKEx{Z2BOLt<6Z#A&h=4ecGv;G)rYXoCvUH<9fHF&QEU9evPqh z5?d~^m7`kZ?CcFU=vIG(e|hh}ftg}^CA|y*#KcuRe;|YlnWv^OTT*bue+$=uMP4s| zakpf4s_T0vg>RCZ08n98A;h836sMLNw`nc%9CS(UAni&nRKNi3=Uw$y@9SRoMkL<$);9q6aJyd*G+~W<7dl}z4w8s;Jpy1s925;u z7N*#usmX}(h0mmtV+7jGzpq zy=Hz3x)_>^ZskfIW^mmbj>;`~;;O(aqfDms)B+{+&cAsRUobl9q|-n5=`X;>D8{Rz zY}Udh1K-_Dh2E8fZy<%1SR;hFwC9!?3^o2#XvVj8HB~8oggY^HVKBG5r6A!E8R_b@ z6M>kk!p0G`vD)t~$)UOs>e7YKD}9Xx7=-XIJBd^`3c`@=*agSMOR#bw%om-C3!H{a zM#E0{WWAL!Qa+}Iim|Tnr>Lzos{-o^6V<|UOUTfasU1v-y@*(SR+Dh;kXmY{!UPsCZ|a1ffNdqp3)YO`!lu6=YGD(%srK72c&BPZl%n=SFZ}@Atp|jo_f? z^Lf2bfBG|j_R>FPvy(~2FXcuh?1wi2Sb_C@VFuZ-7k#JL&i13y;75v394-996=_ky zN2RGXxqF!GqBN^5)st$Ve3X85TeZSsC3J;wm=|jr5F$w7nzi_VVR*zAih|9q$$b1P zmI|k(Nlix$K^Pq+AEhjmL$@a(9hpqHFt%fal&?9#_U4l+nW;1b_Q?4m83j}r>|;7w za2OL`X0Wkt2sL&ljzSeEtk_#~242j?t2xYYB@YljkPsjVC~g9}J;lZYq$fCkI`sRM z!3WlEJpP1}&pzw)*S+dxpxHu$M$Ej_cl)iv7vwhJ8dZHrzF3TWgh}hoaxU2hm(Hl* zq7JfcDIs0fCs{Q)>8&+oBSQLG8uv@)#OvMlZAw#@UBYv#fV;(3E2*v#|YTf9@2|n{K{9q>g9Xxz5n-ra6Mni0y8}+VV)z? z^F#!m>*TR-K&Qgb03jB)j<=nc28AjS$rev=M_nb+5yfYrmZVv6B`Tp3Dh9b7 z?T4D`QH8gc5fK(|{iLks!PB!k!DDcw|7@u;gWSYEkKpn6caK~z%FUTDOT>nUx(Lu1P! zV8zN^Ui(*X+G~%Uulw=U3zzJ2;aBw~zrle4y+5xtLC#*P38agrXch7-G1zP>t8x`8 zqR_=-s7O~wMRXHvB;~2-EsSMD2CNBfD*DsE$Yh#I4UMht)^82ABo2PkL6j9(#7b7v zAXM>$Mf1%$;d}%ncBjb?DLtZu^ofo17CJTZ_>d++>@~u*XiehZG+0t%X zx5+I-p(u~w>%WD>oeCYITW@(tEsfMjEdJ?G)kM988#(Vi2%}og@A*J?xgxLOG|?r3g=K( z0^*&Ng-e%*{FbrFwfEmM*gyQve>i_+%lg9)c@)$CcuauR0cH&jnmE+ZUH`3OZ43%x zjA;W+Yhgs3E{lmO`pQ&nrjVoSpFlWPr&phi!v zH&E~e!Fho#q(ii{0c9C3{uxPiA+_HD`)_*ifv;TnHQqfM*R~Fw6)ToD^IHWun zmR_55$|Ry2KM!B%5nHep1M)FcwJ<`Y=Oqfh!fG8svaQe%KDQCpoffN|RFX2SNQ@<< zkeq5^3zc|&Y-JF6E=zHwG9{3Fkh^RdJy%C+ZKEy5!nhWt=c;zPZiztZ%I|#d=;M#; z^sVSyxW{82f86bN++Rglsb>0$idbaFMBcd&CJk1*El-7OlUt-pNEVZlf3BEWTC!G| zdaI9*0Q@1gMi&O=tjU3^i1i8y^Tc?yMwp zkc4xVic}XBWTeep`GjoYgD9LFNkaN04aNjowgmCZsK!OGFob}4&Dtnz=OnnGB%jSNZ=nadpd)1BgFwN-#nSyJ}iiE6b1RRvDU&j{&? z5{YxHQYS;1haAta(6OqDd9PrL>WX~XxqnuSPH$&5(TUSeJHrg@#j2oBD50yF1q3=Xk_qUg zpvz!pWuXxb0c0fB_^;w~fMjoBg$e8&T2^aiB|V2jq{LQA1%g@0ib8?mc7=&t8Cp;a zOmfKDV)e-$6dwW`4oQZeMT=mdf(uHjRXVu45SbtfqPZkw{iRaULaIoWR-K2Sw3H>- zXoW)|@Z;|1U%TS#(UR7zUkhn+EV}XRmoB<^=Urm=?qL`n|HQ|C=LgqXdiEPve)ojq zVl!3kV6%MLu9sbUd64M*Q;Z=@C31cdrZ`4X1(%P-Ik^*AG)9M#@#3lJDp~)G74-Xq z3PmE;ruHnYslx=P+B&**2CIbNu_{SLaMJoJDhZLU*a}p^1c*XsD3yDf$n$XnUKC;v zf&5U?75{tr;DY@49YuZi^Ut~M_PavGeQVbpd34l*DsaJ~m7nv%nOIt^CZ}eGn-aB2Eco=N!67 zAy+x(O&Zx8c63uYDUyQH?bO;Lc4Z+n7P;yI063wOUXS%DM|yvH>u*kZ+8?X&=yhc_Ctvb~ zFMd7@GC$zDAmA@t_{EhgwdGla$3EehpWpJUAWiaVHEv#oPeQri6&D8_Csr`OCJHFi zAskA~7OW~Ni-@A&lw=G?6s#)O_{qK!#a6>={?r#r#MaQ;+6z{?%#(+%M2lcqY>Mum zU9d00SWKT$(H6BcJWm;--~Yk2hdtqmrF1(79sa1RuFfHNa(uM1efO&G9(drvX47!I z?}3M3dDYdS;m*4s==5qE%O^egbTE7pigB5c7Xn@G;)NXP!pXVN6vuh!ZSwDdt7J=G z3rtC2T4gGs{LN7vqH&xgGEEcB{i29d{n*&$uwUjG~_v& zq@b;|CMwXP3YT~y%9%5b&h`&K%zo#ZPhN1rr$~Z(*(+Y{_QXL?{=ELL->&O=rjXOq zW8?a)C1GM*j{pSxmbZ7!QO`Q(TwQcJjE}QGfMjxlBZGyQJP}p2srE1#yV;wRB{JDy zyOg#Pp?@B}s-b$&l1i}h>_CDdVlwPNHli>DQ>pT(=^_{f#J4c3iqoEcW~l|@-jDp} ze+7vJn(MM+T z0coDXEmcE76t`ruz!~QZv7*J&5~#Ieb`D)}Fq>WYE<2ev9;qDPEpD-v#VEVL#!+6i zSlgs7O39mfIbcN|hp5t$)FCiR2@IYf2DRma!J;?>s)FqLv0BZ*l64Pl{^d_^aSO_udQUm=#NXY!IxJ0& z>ja{URHmuc#WO(MqYCQy_KM=18WG$R|&bg`89aw9wbwu?hB;(_`Y75&rFZdJQZBt0>001O{ zNklZQIxOdUwU4h^5Mm@DXvTc+~+E$CR$x zl13CzL$54GsSM1Mk&rT5r7B?d_Ms)1=;U=&5gf&AzmI;gyRyYSIs%eT+zQq#4CV>?_rT{>@?#2hg zmLB@pQ(pX%*Jt{S5r#wu*8i+A=GZul3?96OupG~e)FnhxofDPR=C?< z`+w=8uN5K-gfW6>vKz=$Bafnh5^XXE{WrYHo%)ijlnC`8O_2~TNk&SU5Yh-BQl_fB z00$A9ATeW7k0{AuMGYL=M}oE(mASty;kxIX8qKT)$6fBj0|@S_1}BbVIp*h;W- z*x^Uq_>-TS%j>JUu2N|ib}0d+3kYf<7h-4cx_`|{r<{g()WXS6J#)7M9^dKgG`L{t z`VG2$!*HWF1$PKpDAFnm(P|5yOCS;j)lx7Ag?Qtm*XFSbz~H%vShw}yFQQox9@ldEoG;Dj~-aCpW2K<&wqS0mz3!Gxqzf|b6X9f zH7R?vstK<@LAd0iOBO9|mah&x{E5H%?cLxBl437arU@cuXfd;ca??+KIy{umaSiQ!*e?4YMb&=r z-#!S5S2vrRf>l{~T+Gyr7J4^1O?O4f;g(X=RE7o-P%sy=aVkm|TETY3sUV{+QY0Rk zlFZURhlymx7_O-np@>(TEhghi+8P>#g};zV3v49|M>`I3W!kYs5(7tNO8G97h;td* zc47(u=AeTQ$gQI#qni-nzdjy7ip=6N6K&fxhxb5#SS(KmI)$+1Gj4PlUr2>D6u1tO6awTuylY6osv|7H)tD+3 zY`Nr2o`NbOQqbUxEu1M>BDl<4ln1`i6A;IW5}b*Me2kp5xx}P@kpr|PCu}8=$(O`R zss2|?Ro)0n_YMJtfuBnaIomTS(#Qv65i1G75U6($t^^UH7MCjZFmEDx|^!NiPZM88wG3+ee@IoUR3efB(>jx3R0Q_+~h@xnZ}) zf>315F6vN&t(qMfb}*?JZpnp6At)u0!reH%0~CUJY|GacQaBJT6)MLHZ)%jaf(p2% z^oXohQV3-#^p#7$zHBEh#0a`{I{x?*e{;t@VaU(*W=V#|Mp4^>-DxpYuGt@7cf++m z{O(I%_Sc=h-IwoqdGQVf`-?wwsMn&77Upq5>D%2xRujFgHk}TwH#Hd zJ1GXMFsJEpaQU{<;_GSyl~yG~R~o2_)eAtD#3il~y#AI5f;K1nAsy$)*3Rwx__&q`bHHq$i*9 zCoewte?I%gv_=p0B-ADYmw60J?F^?GU7B)%n$7n|H{5XaF-O~q9w^*t=RH39@e7J0 z331^ED|qqG(A0 zws^yC3n4|_fih8k9d5q))>BUYBNvM<`-d0r@}2MGojlFxwNStkflN2%69i#`^_W9N zt*1IYsBYdq^5=j4`eTkd-pb>kk|!)(wt|ma!kj}uD3`ua?b3D1YJ+SuX-nuT)CHN~ zgVmYVa5vP1#Dulra8$CCK8P-SaT<8%&%6Eh+dlWDuN-kC&z#QDJ#q@SL+=bkvbgShh@01YYF_0a?J~bktat zjO;ly}cb${`ug^Tr|VKmKWJo8L0T!U2ZY`N{rM70v2lr}gK z;|I2c1S_HdMb5F2R#wECxCjW-2z9yAl?Way6WDU4(Fw$vKOf_nnf=m*daJsIGtWNz zp@+8xHzlB_gRr2WSom(Agqbg39LXrd+it&Ow>|fK{L#le>zU_$@B7!yVb`Nae1kt zc;mVbRkFbv)rFTf5RTGECGBD(7Z6>V^LoHn{rH+g4vuH|wC%@HM;-Us&wVKc{E{Ep z5AUp96e~>@8LWhY3pY|sUOi%9?NQ5*ImM_$z$5a{N2vP4l@?2-G&rIBGmV2|(Ib;; z4i)8F&D{ub&Knw477uN6IYVjD_kvEvx&s>=d{i7kv$`cn}z; z>H+;+8U*FG-~9H36HfL(pvPC2?YzqcpS>`Jc)?(Fl5s$bk-i*`%4?~vPJ>IdAc2_- zRW2M+TFJswa2BfxGuG66Wh)LdU@qcDe@cVK_nGn7+>>!_eEg|@{A_174GTt@2iS(IvzVNSf@#r0xjntW-HG z6qqIn6#vOuC^@>c$tE$z@S&k#zU;EE4Gb-*ePid{54`K1yMi=6F~&26z_i@dp;XBW zaTJshrdUp_N@XZuH$%x+7EWO*LfvtpITwnt-X(M*&806{fBs0J~kOMYF&cs#a8aFDcTg$wu7H>D$N);=h=E0iUji1+&WZP^Nu0V>_v;ZecVUY-8 z91D4Va}`^ei?k^Xwn7OgnuDv!`IJ^%0(je;EUK=eqQs4qM)kxJ1ylgXMiq=0q@D%9 zdg^=qo8K`o6bl4;%jNkme#yEG8^Zuk!$%WVH?bn&DTP&f-J{GyIM6!0N z37NE1vnQ-oXmktyv|kh}Z`wLBxZ})%A{P#KNpxf@bJ4ozn&NG41S5!4B zg2P9tZzU5nY94&UiOWH6`CbH|0Co)lEhCW3Shz`5Fi4L;ZgJs9NfEaS%7s?b-E56a z5vdq?Y^kEP$*6P)D-L4|ONr%4g}ddH+L82#{N|pA-_9jokqRv0IqJhhj!=_dF4SOL zIRu+&l|6)#Ls5W5qZ|PhT!orE#Yn2HJVi&93VE?LJP8@uLQALkjDn}IrLBSqRY?pk z8;L=N-ja97)@;~#-np>{fx67#@WMZP% zShJ*u8Hr@JIqAqvOE8oL7oDFi)q}`o&Z(z9)t%o%TmSH9KA$&P$+8}ZfHBtyT!I#} z`eHIOBb>5Yj0WSJWVg2vlkTX|U(mYWSe64ruNWIK;Zj45g({ln=af{2%3v);6~qd* zbOmmQJccTWNiVuXOI6fDx4;nl157Rc-v@@SKfnRmd||SE{KJBUqcJ2XbQGHOH}p(2 zEVY5Oim{=#l_WebQM7popp2F7Hn|PAO#FT@h3sc&(~N_~@*D{6zIXKj`yb|>qr;*l zD?a?;{|c2%X?dow%xZ<}_8?Lmi;cq3%@)ecB|;GAXAx_gUbsr!(D90waFurW%h&&( zk_Fw3f7@H$o+3=h#m4a0yj77l%%LI)KxLgms7zdeTCwfrA^D?R+XTanHj*gMcLV}m z43rdcQB&fgP%Qq5ry#rIHbrn{3&2O=E#-U$*sUe0Vr$41Y8Ow+HFoAv1gc9>ktxch zxGJAtetxV5=qgx&`FXs;WR`GUk!wDpv!De~y;9s36Z_YBW@+a_m_C zRYm0qDUuYB%4iOuDutl=u)aoAW&{^s^7X;t<`shj4nF+m>u(H!?W6xsV^=}OfVE^8&QJA z#EOl^#Kw;wLL!}H(yyfW`2%BgiY=Kk)%oho9iNZ2*1O()_O$G|^S*06>silQ`#pP~ zd(J)Q?DL#IBn#Jy8k;!H<~prb+pb2Cl9%(G+R#BQfsFEtfKQx_cjNxieV_HW0sAiC zs;l1gDY0oMX5L3I02=ZDCfXkygSY|6=R&inJWHbAgdrb zI`4^DIHQ^YQByoJlq*CL2{9-_4wkovvDKSwi@7Rki{Ru-Oq>O;urihvD^LcztzEL= z`o)MBcm_IK@Yp=Tm|I-xR_dQ1`shb~`_fBzom^j}@a^yXsbl)MJ2mhyTJIj<+Z95| z6UHn=#SB{Afa0UPLnI1wz^z7>1(Q%x@w7jF`TyM)k6ib|Z&9}|#rW-4T=Dt8jE_j7 zMZRO2r@!7O6-~L4+I4Bfs|Yy$H=uF5lf~>%XdR`=^d5Bv$6~Z60wPC7R887quJpi{ zMF3O4Ws;n8YT2JqIukIwQ33=xgD5Lq&kbs3mX3KP;_R_%qipQbLZVzGlH2*MP0NOO z<=7CaJFpFLW*tVxt(IOea7-URkCx-NT zE$zgK$F4Ttrg;h*k1(ZjZ!OBlm-88XI zK}kOC&o}v>IJN)on{Uy{AH(l|@>Bn-PwDV4etf4iALytA75zWEk(*TubYBTG#~peU zPMNk1my0~SFdGm^y9-#A3D9Caoq^#qUS1hZahRQYai$`*4=cQFs3WxHV;GI~j@eLT z#57v0NQb@wyDCvJoF?APNla{J#Q*GTB3aLe&zcY-Yw)a5UZ=|T5P!ce8Vm%IpxMx1 z7|c-N31Ci>nQ7PD4&}!!Q^5VPi{j@{R;bNtH z?VV?s(z8NH>7I(3h1+POLlw8K#{i2AD(`Xd^{W1cRoHjk{V88?$?g5vPyFQ9kMjfh zxR20ff5{)k>EJ&Rg0=~4Z4nj2!Q?Y-Qk-)ywz6am2{^tBX!K~xtSmgG%$1g2rV#IG z-CpL%cVbI#=4t}vu}w5O6Cld!5Y&l1IjdQ#V808$j{(Wf8mo&;ImV zzlE2+;TIZhHn08e@BP9*e9=X4Ribz}kYwN`NzSO$%?Y>Ea%5sG0)P3Rk2m21eeB_f z4`0T|{NAp*`b~fTg@1JVd9_Wx?lN+(#@wr*LhCLfpayu6a94mWaxGO4G7?f9=3M~z zSw$h!qRX|UWT#%vD&dv|VUR~h|Ao>?an;MADALcQj7lN}1{l_0XLAhn{fbW36apKW zX${p@a7957h89}vA>CAMW=mMxKVl>3B!* zu6OQ{bjy-wf z+uxx!c)`V&zU&ph_lb`OneW8o7pdc6fbywoW$vFzG0}l(R2+w6^h!=pG|BhUhE_@0 z;Ao{1W(n1a(L^}7f^Z9w3Fpt zfm?6CWA7k8+w1K;x7`+h55%wjGiP-l zBOuoxDw{M6sxYWcPXyA-nGvU(vx(d|eenX^rZ>@j6Vs?900H?p4B za?eWDGFt>=^CZAF{ZSyeihIspqDtmV*G@z*;l!?Y5Ipkum%r=Pug)`ZbMWwsAAIm{ zOg(${R9uS$McdywRyEy=Doy2ZbKtJz3|`3N2PL`v^; z6ExK!(6Z9>@~7AOVU5Zli=3h0JnmWLDuYO3h>V~EF$O%Qkjp9xU@$?3L#0ijWF>Ei z=Z=?zLr%z@80jqvttrls0n(M?5fAw5y#C|Q{mB(qew*$Hc(L>AufOrg(MK)HFEjG% z1!EVXXCaAOHI!LgVGVi`kKgNh1ajfwCmz4{E#vDtE`RwIpZ-j|)sL?Xj89d$@^XY? zZ0;mnOe4a++gkW|AfJcv?KB7=hvkatpzF&KuZwlgO(H7T50 zl^d1Dgb0H@vs#!WRGFcm4v9z>&M(~IGk<)XkdM!wJ#q4Pf9GTMZ~(?l@4n^u*ZQPTRaQfGi4v4(()(^y`y!BNJAO5Y6p3Ov@{`gY`e)%T=dNbWY z2V#{O@S2Dc3>+;TTv-IA%@veu*{&tK59ZYYiBSJGp=5#;%_QP^6`U#bR%nC*#w4rl zBoLv*6{E^Gx+(K{$SZ3Fx9}%*qK~R2W&lPmx{@4q`MJj35oDLef?uyK1s2#+iAX9JZO5dG;I^Ql?}T zjzN<}lNp6qB4qUB=n#89}s)Q1zp=rx2;#?vT&!GQUQ9GU8fo3x1ID;f1 zJ0z?*9|lnejENMEVM+6EWH5*= zXM1#oRA~!G)VfoS^O-g*%38o!c$$JHjfhq*s}vSiHBu2tgEp8>8_Xy6sz z<%9dL9Q*3~Zo9osetf0EALh4o^05a$1zPHH1_l$Xg7 zOE+i1bXXnpLbqt5n8q=PoTcC)lc_}{!<-2S)SOmQ$Y4g_66njKIDxES5=Z>^&(N5B zc7Pu;w-h7duqdNLez4!$9Uu6GuRi@Wd*;RVeDagpyI{0#FZa?2ZcrT3(pb(Jz?>%OwtXte?!nTC zr5uFDDpDF5!(1N|%9v^g0aN^VGH1Tkh>i0+5=%^mL5>;Dxj|D(ix&>8U>fD5H2?;? zR~j-#WLPt!ydXRu4>5&xJGtzjJ2?DhSB^(lP)H`{w5u5#hA$EfB_)f3p;2u%p!mg7 z5JU7rH~0j@bSE*6aEI5JBTg-QS!d>VuiHZ*Ekym30B0aLLHT?>UdB6f=JXFV&EjD zAPs2=6Y8KC0SXEER9DjExPYL6LlGa%!Do2#cl(3*;_dJ8M-2Fe!q>h2>W3bRZ|Oss z|2g*L+urt8-A(YVey@7vEAPEKzf6rEK!`U5SwC8+Vr6hQ)J-C7KVlhr#J2a3wtTOO z77l<)F+jMfWsapn!OA}N&)Gj(o=>;73H6mu?s#SQjx z)F0ikuz!>wdh4dA$R<~$Q99k69bp53$do6b&@4O^nbgH7ofIDYK(sWlp`7AQvUhO- z#Un-ev2KYYlL*|Qk#xSihmYy;T0?H*6ZhQvqDyoEAD!;+{OOAE)!xcGZ3-LE+gTpP>xQA&EqAj=J)Y$E@*IJkqBh$q(W7Q}g z!WO9!0tn^aRUs#5XSv1|Zbm3Yh0-M>(^^bs6Q^I{3=+YX)fe3bJ;_0IH6@N?LNXYf zqTncJaEp>lq3}?xqbn0UhbEoUYgm#iw%Ny5XYOrw@z;TahvF^0H^29e&-}s1O?}Db zFMsx#r)=MFtjR*R{Zt2#Z0N$)v!Q2_x*p(R|!O67N zxApjpu6TklV2cij5ZKqz*bg{jq=^`J0X(YF8{2oHvIt6$LZvL5L!pv$=A6F|K?OO{ z@PRfRrc-ihFN`F$RmWZcrKWa-3?4kGEdixPZtu_PbJUF{3yjFagsp1G8$*vqbKcX) z36V@#xK)G(rN%u6Gsw=2+&A7*byvj{5!4=2YQyTZ-)p*k>+YdQP982SO2+QW^1veA zFD-IXf;=YoLALUow%IxF5A^{fH4ZBUMFm-Nj7s%DI>j9B7*$3Q5=2bObQnlpzf|zM z6b}dv9_9-Kcn86aH@xGKM~^t?6<5CM&+otQ+G}{V54^yLM*(}gd;6PnI~Pc&=gF2^Q}k7K~Mmy=Ye?}`8=>A;0G@2caL#SNf!+S=>fRnmL{be*}JygJmBz?+Jx ztjs-iltiL^bChKNAO?u2M$%0Q$V$oJtbjQX$#_UeC+mk(SXVKqa+2I?v?psp3s3{< z-n%fO^4)l`x0fJxFd6KDiJ6yk##d%=nbkHY352{!{bbMK zySKN8-~2mx^uS8J8tl?_>D&o=W&(jBI{{IVXy1uBcC6cuCxSUmbl@JEV8v2(%++sj zCM7%yz+E&TYYoL=SxG($_uU;e!U__+EnevP2?7r_6y0t*SY2+b$O{E$jrH^`4ghT1 z4Q;1aDvd}JwiamV#VK9}0eD-KH{QU=ECCTXcqy@{b$W?YM9Z(Z3kbZ1@PWkIt;Bnp zdh8W9bW3xwDhY$TphG8Y$J)3!t{{f3?RXsT9Ra~LNp3sN%naF<2lIlSn+C>L_0L~8 zaA0R=H{bOO-nny|-923MZ)I=XVgy<|%X6N4j!K?d1`qzaowC&_eXLbaoAlC|2#aN0 zUo~d-YWsd7z@`vcEOD0c+=>lzSRyUlA%MX4?L;gduBw4pn(>&Z@@wB*Aj(jbO$Rs@ zc3NYxw(gNE4PD$>>GlZC#I+V#0N@lhX$usG!z#IyVR)f~8a})c8T$fkMULc&16Q4s6bxKE1cQdG7q?(80sIx;u!@Yc--PBrTU`L>vR9%Bx05b)J_X8}9Vz zbPnn6)(7Jb|0LnZQxr^5&FOIMPyx>wc*GOc;<+!zc+da>9=|p=oBs#rLfLz910lu$ O0000 Optional[str]: + """ + Extract text from PDF using pypdf if available. + + Args: + file_content: Raw PDF bytes + + Returns: + Extracted text or None if extraction fails + """ + try: + from io import BytesIO + + # Try pypdf first (most common) + try: + from pypdf import PdfReader as PypdfReader + + pdf_file = BytesIO(file_content) + reader = PypdfReader(pdf_file) + + text_parts = [] + for page in reader.pages: + text = page.extract_text() + if text: + text_parts.append(text) + + if text_parts: + extracted_text = "\n\n".join(text_parts) + verbose_logger.debug(f"Extracted {len(extracted_text)} characters from PDF using pypdf") + return extracted_text + + except ImportError: + verbose_logger.debug("pypdf not available, trying PyPDF2") + + # Fallback to PyPDF2 + try: + from PyPDF2 import PdfReader as PyPDF2Reader + + pdf_file = BytesIO(file_content) + reader = PyPDF2Reader(pdf_file) + + text_parts = [] + for page in reader.pages: + text = page.extract_text() + if text: + text_parts.append(text) + + if text_parts: + extracted_text = "\n\n".join(text_parts) + verbose_logger.debug(f"Extracted {len(extracted_text)} characters from PDF using PyPDF2") + return extracted_text + + except ImportError: + verbose_logger.debug("PyPDF2 not available, PDF extraction requires OCR or pypdf/PyPDF2 library") + + except Exception as e: + verbose_logger.debug(f"PDF text extraction failed: {e}") + + return None diff --git a/litellm/rag/ingestion/s3_vectors_ingestion.py b/litellm/rag/ingestion/s3_vectors_ingestion.py index 13964cd89a..e6c166a101 100644 --- a/litellm/rag/ingestion/s3_vectors_ingestion.py +++ b/litellm/rag/ingestion/s3_vectors_ingestion.py @@ -253,6 +253,20 @@ class S3VectorsRAGIngestion(BaseRAGIngestion, BaseAWSLLM): verbose_logger.debug( f"Ensuring S3 vector bucket exists: {self.vector_bucket_name}" ) + + # Validate bucket name (AWS S3 naming rules) + if len(self.vector_bucket_name) < 3: + raise ValueError( + f"Invalid vector_bucket_name '{self.vector_bucket_name}': " + f"AWS S3 bucket names must be at least 3 characters long. " + f"Please provide a valid bucket name (e.g., 'my-vector-bucket')." + ) + if not self.vector_bucket_name.replace("-", "").replace(".", "").isalnum(): + raise ValueError( + f"Invalid vector_bucket_name '{self.vector_bucket_name}': " + f"AWS S3 bucket names can only contain lowercase letters, numbers, hyphens, and periods. " + f"Please provide a valid bucket name (e.g., 'my-vector-bucket')." + ) # Try to get bucket info using GetVectorBucket API get_url = f"https://s3vectors.{self.aws_region_name}.api.aws/GetVectorBucket" @@ -455,30 +469,43 @@ class S3VectorsRAGIngestion(BaseRAGIngestion, BaseAWSLLM): await self._ensure_config_initialized() if not embeddings or not chunks: - verbose_logger.warning("No embeddings or chunks to store") - return self.index_name, None + error_msg = ( + "No text content could be extracted from the file for embedding. " + "Possible causes:\n" + " 1. PDF files require OCR - add 'ocr' config with a vision model (e.g., 'anthropic/claude-3-5-sonnet-20241022')\n" + " 2. Binary files cannot be processed - convert to text first\n" + " 3. File is empty or contains no extractable text\n" + "For PDFs, either enable OCR or use a PDF extraction library to convert to text before ingestion." + ) + verbose_logger.error(error_msg) + raise ValueError(error_msg) # Prepare vectors for PutVectors API vectors = [] for i, (chunk, embedding) in enumerate(zip(chunks, embeddings)): + # Build metadata dict + metadata: Dict[str, str] = { + "source_text": chunk, # Non-filterable (for reference) + "chunk_index": str(i), # Filterable + } + + if filename: + metadata["filename"] = filename # Filterable + vector_obj = { "key": f"{filename}_{i}" if filename else f"chunk_{i}", "data": {"float32": embedding}, - "metadata": { - "source_text": chunk, # Non-filterable (for reference) - "chunk_index": str(i), # Filterable - }, + "metadata": metadata, } - if filename: - vector_obj["metadata"]["filename"] = filename # Filterable - vectors.append(vector_obj) # Call PutVectors API await self._put_vectors(vectors) - return self.index_name, filename + # Return vector_store_id in format bucket_name:index_name for S3 Vectors search compatibility + vector_store_id = f"{self.vector_bucket_name}:{self.index_name}" + return vector_store_id, filename async def query_vector_store( self, vector_store_id: str, query: str, top_k: int = 5 diff --git a/litellm/types/router.py b/litellm/types/router.py index 8ea7a20753..43943d9e07 100644 --- a/litellm/types/router.py +++ b/litellm/types/router.py @@ -404,6 +404,10 @@ class LiteLLMParamsTypedDict(TypedDict, total=False): aws_access_key_id: Optional[str] aws_secret_access_key: Optional[str] aws_region_name: Optional[str] + ## AWS S3 VECTORS ## + vector_bucket_name: Optional[str] + index_name: Optional[str] + embedding_model: Optional[str] ## IBM WATSONX ## watsonx_region_name: Optional[str] ## CUSTOM PRICING ## diff --git a/litellm/types/utils.py b/litellm/types/utils.py index 2d67e13e92..49c903502d 100644 --- a/litellm/types/utils.py +++ b/litellm/types/utils.py @@ -4,20 +4,22 @@ from enum import Enum from typing import TYPE_CHECKING, Any, Dict, List, Literal, Mapping, Optional, Union from openai._models import BaseModel as OpenAIObject -from openai.types.audio.transcription_create_params import FileTypes as FileTypes # type: ignore +from openai.types.audio.transcription_create_params import ( + FileTypes as FileTypes, # type: ignore +) from openai.types.chat.chat_completion import ChatCompletion as ChatCompletion from openai.types.completion_usage import ( CompletionTokensDetails, CompletionUsage, PromptTokensDetails, ) +from openai.types.moderation import Categories as Categories from openai.types.moderation import ( - Categories as Categories, CategoryAppliedInputTypes as CategoryAppliedInputTypes, - CategoryScores as CategoryScores, ) +from openai.types.moderation import CategoryScores as CategoryScores +from openai.types.moderation_create_response import Moderation as Moderation from openai.types.moderation_create_response import ( - Moderation as Moderation, ModerationCreateResponse as ModerationCreateResponse, ) from pydantic import BaseModel, ConfigDict, Field, PrivateAttr, model_validator @@ -3075,6 +3077,7 @@ class LlmProviders(str, Enum): LLAMA = "meta_llama" NSCALE = "nscale" PG_VECTOR = "pg_vector" + S3_VECTORS = "s3_vectors" HELICONE = "helicone" HYPERBOLIC = "hyperbolic" RECRAFT = "recraft" diff --git a/litellm/utils.py b/litellm/utils.py index bb95be05b5..d7fb4855a4 100644 --- a/litellm/utils.py +++ b/litellm/utils.py @@ -8452,6 +8452,12 @@ class ProviderConfigManager: ) return RAGFlowVectorStoreConfig() + elif litellm.LlmProviders.S3_VECTORS == provider: + from litellm.llms.s3_vectors.vector_stores.transformation import ( + S3VectorsVectorStoreConfig, + ) + + return S3VectorsVectorStoreConfig() return None @staticmethod @@ -8699,9 +8705,9 @@ class ProviderConfigManager: """ Get Search configuration for a given provider. """ + from litellm.llms.brave.search.transformation import BraveSearchConfig from litellm.llms.dataforseo.search.transformation import DataForSEOSearchConfig from litellm.llms.exa_ai.search.transformation import ExaAISearchConfig - from litellm.llms.brave.search.transformation import BraveSearchConfig from litellm.llms.firecrawl.search.transformation import FirecrawlSearchConfig from litellm.llms.google_pse.search.transformation import GooglePSESearchConfig from litellm.llms.linkup.search.transformation import LinkupSearchConfig diff --git a/requirements.txt b/requirements.txt index 36328a081a..f250fb213e 100644 --- a/requirements.txt +++ b/requirements.txt @@ -68,6 +68,7 @@ jsonschema>=4.23.0,<5.0.0 # validating json schema - aligned with openapi-core + websockets==15.0.1 # for realtime API soundfile==0.12.1 # for audio file processing openapi-core==0.21.0 # for OpenAPI compliance tests +pypdf>=6.6.2 # for PDF text extraction in RAG ingestion ######################## # LITELLM ENTERPRISE DEPENDENCIES diff --git a/tests/test_litellm/llms/s3_vectors/__init__.py b/tests/test_litellm/llms/s3_vectors/__init__.py new file mode 100644 index 0000000000..d4b0c4d855 --- /dev/null +++ b/tests/test_litellm/llms/s3_vectors/__init__.py @@ -0,0 +1 @@ +# S3 Vectors tests diff --git a/tests/test_litellm/llms/s3_vectors/vector_stores/__init__.py b/tests/test_litellm/llms/s3_vectors/vector_stores/__init__.py new file mode 100644 index 0000000000..231735c1de --- /dev/null +++ b/tests/test_litellm/llms/s3_vectors/vector_stores/__init__.py @@ -0,0 +1 @@ +# S3 Vectors vector store tests diff --git a/tests/test_litellm/llms/s3_vectors/vector_stores/test_s3_vectors_transformation.py b/tests/test_litellm/llms/s3_vectors/vector_stores/test_s3_vectors_transformation.py new file mode 100644 index 0000000000..3a84da3154 --- /dev/null +++ b/tests/test_litellm/llms/s3_vectors/vector_stores/test_s3_vectors_transformation.py @@ -0,0 +1,115 @@ +from unittest.mock import MagicMock, Mock + +import httpx +import pytest + +from litellm.llms.s3_vectors.vector_stores.transformation import ( + S3VectorsVectorStoreConfig, +) +from litellm.types.vector_stores import VectorStoreSearchResponse + + +class TestS3VectorsVectorStoreConfig: + def test_init(self): + """Test that S3VectorsVectorStoreConfig initializes correctly""" + config = S3VectorsVectorStoreConfig() + assert config is not None + + def test_get_supported_openai_params(self): + """Test that supported OpenAI params are returned""" + config = S3VectorsVectorStoreConfig() + params = config.get_supported_openai_params("test-model") + assert "max_num_results" in params + + def test_get_complete_url(self): + """Test URL generation for S3 Vectors""" + config = S3VectorsVectorStoreConfig() + litellm_params = {"aws_region_name": "us-west-2"} + url = config.get_complete_url(None, litellm_params) + assert url == "https://s3vectors.us-west-2.api.aws" + + def test_get_complete_url_missing_region(self): + """Test that missing region raises error""" + config = S3VectorsVectorStoreConfig() + litellm_params = {} + with pytest.raises(ValueError, match="aws_region_name is required"): + config.get_complete_url(None, litellm_params) + + @pytest.mark.skip(reason="Requires embedding API call, tested in integration tests") + def test_transform_search_request(self): + """Test search request transformation""" + # This test requires making an actual embedding API call + # It's better tested in integration tests + pass + + def test_transform_search_request_invalid_vector_store_id(self): + """Test that invalid vector_store_id format raises error""" + config = S3VectorsVectorStoreConfig() + mock_logging_obj = Mock() + mock_logging_obj.model_call_details = {} + + with pytest.raises( + ValueError, match="vector_store_id must be in format 'bucket_name:index_name'" + ): + config.transform_search_vector_store_request( + vector_store_id="invalid-format", + query="test query", + vector_store_search_optional_params={}, + api_base="https://s3vectors.us-west-2.api.aws", + litellm_logging_obj=mock_logging_obj, + litellm_params={}, + ) + + def test_transform_search_response(self): + """Test search response transformation""" + config = S3VectorsVectorStoreConfig() + mock_logging_obj = Mock() + mock_logging_obj.model_call_details = {"query": "test query"} + + mock_response = Mock(spec=httpx.Response) + mock_response.json.return_value = { + "vectors": [ + { + "distance": 0.05, # S3 Vectors returns distance, not score + "metadata": { + "source_text": "This is test content", + "chunk_index": "0", + "filename": "test.pdf", + }, + }, + { + "distance": 0.15, + "metadata": { + "source_text": "More test content", + "chunk_index": "1", + }, + }, + ] + } + mock_response.status_code = 200 + mock_response.headers = {} + + result = config.transform_search_vector_store_response( + mock_response, mock_logging_obj + ) + + # VectorStoreSearchResponse is a TypedDict, so check structure instead of isinstance + assert result["object"] == "vector_store.search_results.page" + assert result["search_query"] == "test query" + assert len(result["data"]) == 2 + # Score should be 1 - distance (cosine similarity) + assert result["data"][0]["score"] == 0.95 # 1 - 0.05 + assert result["data"][0]["content"][0]["text"] == "This is test content" + assert result["data"][0]["filename"] == "test.pdf" + assert result["data"][1]["score"] == 0.85 # 1 - 0.15 + assert result["data"][1]["content"][0]["text"] == "More test content" + + def test_map_openai_params(self): + """Test OpenAI parameter mapping""" + config = S3VectorsVectorStoreConfig() + non_default_params = {"max_num_results": 5} + optional_params = {} + + result = config.map_openai_params(non_default_params, optional_params, False) + + assert result["maxResults"] == 5 diff --git a/tests/vector_store_tests/test_s3_vectors_vector_store.py b/tests/vector_store_tests/test_s3_vectors_vector_store.py new file mode 100644 index 0000000000..a7a1568c1c --- /dev/null +++ b/tests/vector_store_tests/test_s3_vectors_vector_store.py @@ -0,0 +1,42 @@ +from base_vector_store_test import BaseVectorStoreTest +import os +import pytest + + +class TestS3VectorsVectorStore(BaseVectorStoreTest): + @pytest.fixture(autouse=True) + def check_env_vars(self): + """Check if required environment variables are set""" + required_vars = ["AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY"] + missing_vars = [var for var in required_vars if not os.getenv(var)] + if missing_vars: + pytest.skip(f"Missing required environment variables: {', '.join(missing_vars)}") + + def get_base_request_args(self) -> dict: + """ + Must return the base request args for searching. + For S3 Vectors, vector_store_id should be in format: bucket_name:index_name + """ + return { + "custom_llm_provider": "s3_vectors", + "vector_store_id": os.getenv( + "S3_VECTORS_VECTOR_STORE_ID", "test-litellm-vectors:test-index" + ), + "query": "What is machine learning?", + "aws_region_name": os.getenv("AWS_REGION_NAME", "us-west-2"), + "aws_access_key_id": os.getenv("AWS_ACCESS_KEY_ID"), + "aws_secret_access_key": os.getenv("AWS_SECRET_ACCESS_KEY"), + } + + def get_base_create_vector_store_args(self) -> dict: + """ + Vector store creation is not yet implemented for S3 Vectors. + This test will be skipped. + """ + return {} + + @pytest.mark.parametrize("sync_mode", [True, False]) + @pytest.mark.asyncio + async def test_basic_create_vector_store(self, sync_mode): + """S3 Vectors doesn't support vector store creation via this API yet""" + pytest.skip("Vector store creation not yet implemented for S3 Vectors") diff --git a/ui/litellm-dashboard/public/assets/logos/s3_vector.png b/ui/litellm-dashboard/public/assets/logos/s3_vector.png new file mode 100644 index 0000000000000000000000000000000000000000..15a1a456e129f9e2544d82399c6db3f2b9d8d204 GIT binary patch literal 191076 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