From a17efa1c8e13d28d5f00d6a4fc5ba515d845313f Mon Sep 17 00:00:00 2001
From: yuneng-jiang <yuneng.jiang@gmail.com>
Date: Thu, 5 Feb 2026 14:43:48 -0800
Subject: [PATCH 1/3] Add soft_budget to team table and create update endpoints

---
 .../litellm_proxy_extras/schema.prisma        |   1 +
 litellm/proxy/_types.py                       |   2 +
 .../management_endpoints/team_endpoints.py    |  46 +++
 litellm/proxy/schema.prisma                   |   1 +
 schema.prisma                                 |   1 +
 .../test_team_endpoints.py                    | 285 ++++++++++++++++++
 6 files changed, 336 insertions(+)

diff --git a/litellm-proxy-extras/litellm_proxy_extras/schema.prisma b/litellm-proxy-extras/litellm_proxy_extras/schema.prisma
index dc49036cb1..e713e6ca87 100644
--- a/litellm-proxy-extras/litellm_proxy_extras/schema.prisma
+++ b/litellm-proxy-extras/litellm_proxy_extras/schema.prisma
@@ -113,6 +113,7 @@ model LiteLLM_TeamTable {
     members_with_roles Json @default("{}")
     metadata  Json  @default("{}")
     max_budget Float?
+    soft_budget Float?
     spend      Float    @default(0.0)
     models     String[]
     max_parallel_requests Int?
diff --git a/litellm/proxy/_types.py b/litellm/proxy/_types.py
index 131a6caab0..5b697249a4 100644
--- a/litellm/proxy/_types.py
+++ b/litellm/proxy/_types.py
@@ -1488,6 +1488,7 @@ class TeamBase(LiteLLMPydanticObjectBase):
 
     # Budget fields
     max_budget: Optional[float] = None
+    soft_budget: Optional[float] = None
     budget_duration: Optional[str] = None
 
     models: list = []
@@ -1559,6 +1560,7 @@ class UpdateTeamRequest(LiteLLMPydanticObjectBase):
     tpm_limit: Optional[int] = None
     rpm_limit: Optional[int] = None
     max_budget: Optional[float] = None
+    soft_budget: Optional[float] = None
     models: Optional[list] = None
     blocked: Optional[bool] = None
     budget_duration: Optional[str] = None
diff --git a/litellm/proxy/management_endpoints/team_endpoints.py b/litellm/proxy/management_endpoints/team_endpoints.py
index 63db2d72fe..8e903180ac 100644
--- a/litellm/proxy/management_endpoints/team_endpoints.py
+++ b/litellm/proxy/management_endpoints/team_endpoints.py
@@ -685,6 +685,7 @@ async def new_team(  # noqa: PLR0915
     - rpm_limit_type: Optional[Literal["guaranteed_throughput", "best_effort_throughput"]] - The type of RPM limit enforcement. Use "guaranteed_throughput" to raise an error if overallocating RPM, or "best_effort_throughput" for best effort enforcement.
     - tpm_limit_type: Optional[Literal["guaranteed_throughput", "best_effort_throughput"]] - The type of TPM limit enforcement. Use "guaranteed_throughput" to raise an error if overallocating TPM, or "best_effort_throughput" for best effort enforcement.
     - max_budget: Optional[float] - The maximum budget allocated to the team - all keys for this team_id will have at max this max_budget
+    - soft_budget: Optional[float] - The soft budget threshold for the team. If max_budget is set, soft_budget must be strictly lower than max_budget. Can be set independently if max_budget is not set.
     - budget_duration: Optional[str] - The duration of the budget for the team. Doc [here](https://docs.litellm.ai/docs/proxy/team_budgets)
     - models: Optional[list] - A list of models associated with the team - all keys for this team_id will have at most, these models. If empty, assumes all models are allowed.
     - blocked: bool - Flag indicating if the team is blocked or not - will stop all calls from keys with this team_id.
@@ -760,6 +761,22 @@ async def new_team(  # noqa: PLR0915
                 status_code=400,
                 detail={"error": f"team_member_budget cannot be negative. Received: {data.team_member_budget}"}
             )
+        if data.soft_budget is not None and data.soft_budget < 0:
+            raise HTTPException(
+                status_code=400,
+                detail={"error": f"soft_budget cannot be negative. Received: {data.soft_budget}"}
+            )
+        
+        if data.soft_budget is not None:
+            if data.max_budget is not None:
+                # If max_budget is set, soft_budget must be strictly lower than max_budget
+                if data.soft_budget >= data.max_budget:
+                    raise HTTPException(
+                        status_code=400,
+                        detail={
+                            "error": f"soft_budget ({data.soft_budget}) must be strictly lower than max_budget ({data.max_budget})"
+                        }
+                    )
 
         # Check if license is over limit
         total_teams = await prisma_client.db.litellm_teamtable.count()
@@ -1226,6 +1243,7 @@ async def update_team(   # noqa: PLR0915
     - tpm_limit: Optional[int] - The TPM (Tokens Per Minute) limit for this team - all keys with this team_id will have at max this TPM limit
     - rpm_limit: Optional[int] - The RPM (Requests Per Minute) limit for this team - all keys associated with this team_id will have at max this RPM limit
     - max_budget: Optional[float] - The maximum budget allocated to the team - all keys for this team_id will have at max this max_budget
+    - soft_budget: Optional[float] - The soft budget threshold for the team. If max_budget is set (either in the request or existing), soft_budget must be strictly lower than max_budget. Can be set independently if max_budget is not set.
     - budget_duration: Optional[str] - The duration of the budget for the team. Doc [here](https://docs.litellm.ai/docs/proxy/team_budgets)
     - models: Optional[list] - A list of models associated with the team - all keys for this team_id will have at most, these models. If empty, assumes all models are allowed.
     - prompts: Optional[List[str]] - List of prompts that the team is allowed to use.
@@ -1302,6 +1320,11 @@ async def update_team(   # noqa: PLR0915
                 status_code=400,
                 detail={"error": f"team_member_budget cannot be negative. Received: {data.team_member_budget}"}
             )
+        if data.soft_budget is not None and data.soft_budget < 0:
+            raise HTTPException(
+                status_code=400,
+                detail={"error": f"soft_budget cannot be negative. Received: {data.soft_budget}"}
+            )
 
         existing_team_row = await prisma_client.db.litellm_teamtable.find_unique(
             where={"team_id": data.team_id}
@@ -1312,6 +1335,29 @@ async def update_team(   # noqa: PLR0915
                 status_code=404,
                 detail={"error": f"Team not found, passed team_id={data.team_id}"},
             )
+        
+        if data.soft_budget is not None:
+            max_budget_to_check = data.max_budget if data.max_budget is not None else existing_team_row.max_budget
+            if max_budget_to_check is not None:
+                if data.soft_budget >= max_budget_to_check:
+                    raise HTTPException(
+                        status_code=400,
+                        detail={
+                            "error": f"soft_budget ({data.soft_budget}) must be strictly lower than max_budget ({max_budget_to_check})"
+                        }
+                    )
+        
+        if data.max_budget is not None:
+            existing_soft_budget = getattr(existing_team_row, 'soft_budget', None)
+            soft_budget_to_check = data.soft_budget if data.soft_budget is not None else existing_soft_budget
+            if soft_budget_to_check is not None and isinstance(soft_budget_to_check, (int, float)):
+                if data.max_budget <= soft_budget_to_check:
+                    raise HTTPException(
+                        status_code=400,
+                        detail={
+                            "error": f"max_budget ({data.max_budget}) must be strictly greater than soft_budget ({soft_budget_to_check})"
+                        }
+                    )
 
         if (
             data.organization_id is not None and len(data.organization_id) > 0
diff --git a/litellm/proxy/schema.prisma b/litellm/proxy/schema.prisma
index b118400b62..a6a573836b 100644
--- a/litellm/proxy/schema.prisma
+++ b/litellm/proxy/schema.prisma
@@ -113,6 +113,7 @@ model LiteLLM_TeamTable {
     members_with_roles Json @default("{}")
     metadata  Json  @default("{}")
     max_budget Float?
+    soft_budget Float?
     spend      Float    @default(0.0)
     models     String[]
     max_parallel_requests Int?
diff --git a/schema.prisma b/schema.prisma
index 03b910db85..240e0dfea4 100644
--- a/schema.prisma
+++ b/schema.prisma
@@ -113,6 +113,7 @@ model LiteLLM_TeamTable {
     members_with_roles Json @default("{}")
     metadata  Json  @default("{}")
     max_budget Float?
+    soft_budget Float?
     spend      Float    @default(0.0)
     models     String[]
     max_parallel_requests Int?
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 467ee3661d..7e351e2916 100644
--- a/tests/test_litellm/proxy/management_endpoints/test_team_endpoints.py
+++ b/tests/test_litellm/proxy/management_endpoints/test_team_endpoints.py
@@ -4931,6 +4931,291 @@ async def test_update_team_negative_team_member_budget():
     assert request.team_member_budget == -15.0
 
 
+# Parametrized tests for soft_budget in create endpoint
+@pytest.mark.parametrize(
+    "soft_budget,max_budget,should_succeed,expected_soft_budget,expected_max_budget,error_message",
+    [
+        # Test 1: Soft budget only - success + soft budget set
+        (50.0, None, True, 50.0, None, None),
+        # Test 2: Soft budget with higher max budget, success with both set
+        (50.0, 100.0, True, 50.0, 100.0, None),
+        # Test 3: Soft budget with lower max budget, fail
+        (100.0, 50.0, False, None, None, "soft_budget (100.0) must be strictly lower than max_budget (50.0)"),
+        # Test 4: Soft budget equal to max budget, fail
+        (100.0, 100.0, False, None, None, "soft_budget (100.0) must be strictly lower than max_budget (100.0)"),
+    ],
+)
+@pytest.mark.asyncio
+async def test_new_team_soft_budget_validation(
+    soft_budget, max_budget, should_succeed, expected_soft_budget, expected_max_budget, error_message
+):
+    """
+    Test soft_budget validation in /team/new endpoint.
+    
+    Covers:
+    - Soft budget only - success + soft budget set
+    - Soft budget with higher max budget, success with both set
+    - Soft budget with lower max budget, fail
+    """
+    from fastapi import Request
+
+    from litellm.proxy._types import NewTeamRequest, ProxyException, UserAPIKeyAuth
+    from litellm.proxy.management_endpoints.team_endpoints import new_team
+
+    # Create admin user to bypass user budget checks
+    admin_user = UserAPIKeyAuth(
+        user_role=LitellmUserRoles.PROXY_ADMIN,
+        user_id="admin-user",
+        models=[],
+    )
+
+    # Create team request with soft_budget and optionally max_budget
+    team_request = NewTeamRequest(
+        team_alias="test-soft-budget-team",
+        soft_budget=soft_budget,
+        max_budget=max_budget,
+    )
+
+    dummy_request = MagicMock(spec=Request)
+
+    with patch("litellm.proxy.proxy_server.prisma_client") as mock_prisma, patch(
+        "litellm.proxy.proxy_server.user_api_key_cache"
+    ) as mock_cache, patch(
+        "litellm.proxy.proxy_server._license_check"
+    ) as mock_license, patch(
+        "litellm.proxy.proxy_server.litellm_proxy_admin_name", "admin"
+    ), patch(
+        "litellm.proxy.proxy_server.create_audit_log_for_update", new=AsyncMock()
+    ) as mock_audit:
+
+        # Setup mocks
+        mock_prisma.db.litellm_teamtable.count = AsyncMock(return_value=0)
+        mock_license.is_team_count_over_limit.return_value = False
+        mock_prisma.jsonify_team_object = lambda db_data: db_data
+        mock_prisma.get_data = AsyncMock(return_value=None)
+        mock_prisma.update_data = AsyncMock()
+        
+        # Mock user cache
+        from litellm.proxy._types import LiteLLM_UserTable
+        mock_user_obj = LiteLLM_UserTable(
+            user_id="admin-user",
+            max_budget=None,  # Admin has no budget limit
+        )
+        mock_cache.async_get_cache = AsyncMock(return_value=mock_user_obj)
+        
+        # Mock team creation
+        mock_created_team = MagicMock()
+        mock_created_team.team_id = "test-team-123"
+        mock_created_team.team_alias = "test-soft-budget-team"
+        mock_created_team.soft_budget = expected_soft_budget
+        mock_created_team.max_budget = expected_max_budget
+        mock_created_team.members_with_roles = []
+        mock_created_team.metadata = None
+        mock_created_team.model_dump.return_value = {
+            "team_id": "test-team-123",
+            "team_alias": "test-soft-budget-team",
+            "soft_budget": expected_soft_budget,
+            "max_budget": expected_max_budget,
+            "members_with_roles": [],
+        }
+        mock_prisma.db.litellm_teamtable.create = AsyncMock(return_value=mock_created_team)
+        mock_prisma.db.litellm_teamtable.update = AsyncMock(return_value=mock_created_team)
+        
+        # Mock model table
+        mock_prisma.db.litellm_modeltable = MagicMock()
+        mock_prisma.db.litellm_modeltable.create = AsyncMock(return_value=MagicMock(id="model123"))
+        
+        # Mock user table operations
+        mock_user = MagicMock()
+        mock_user.user_id = "admin-user"
+        mock_user.model_dump.return_value = {"user_id": "admin-user", "teams": ["test-team-123"]}
+        mock_prisma.db.litellm_usertable = MagicMock()
+        mock_prisma.db.litellm_usertable.upsert = AsyncMock(return_value=mock_user)
+        mock_prisma.db.litellm_usertable.update = AsyncMock(return_value=mock_user)
+        
+        # Mock team membership table
+        mock_membership = MagicMock()
+        mock_membership.model_dump.return_value = {
+            "team_id": "test-team-123",
+            "user_id": "admin-user",
+            "budget_id": None,
+        }
+        mock_prisma.db.litellm_teammembership = MagicMock()
+        mock_prisma.db.litellm_teammembership.create = AsyncMock(return_value=mock_membership)
+
+        if should_succeed:
+            # Should NOT raise an exception
+            result = await new_team(
+                data=team_request,
+                http_request=dummy_request,
+                user_api_key_dict=admin_user,
+            )
+
+            # Verify the team was created successfully with correct values
+            assert result is not None
+            assert result["team_id"] == "test-team-123"
+            if expected_soft_budget is not None:
+                assert result["soft_budget"] == expected_soft_budget
+            if expected_max_budget is not None:
+                assert result["max_budget"] == expected_max_budget
+        else:
+            # Should raise ProxyException
+            with pytest.raises(ProxyException) as exc_info:
+                await new_team(
+                    data=team_request,
+                    http_request=dummy_request,
+                    user_api_key_dict=admin_user,
+                )
+
+            # Verify exception details
+            assert exc_info.value.code == '400'
+            if error_message:
+                assert error_message in str(exc_info.value.message)
+
+
+# Parametrized tests for soft_budget in update endpoint
+@pytest.mark.parametrize(
+    "existing_soft_budget,existing_max_budget,update_soft_budget,update_max_budget,should_succeed,expected_soft_budget,expected_max_budget,error_message",
+    [
+        # Test 1: Soft budget only (no previous max_budget) - success with soft budget set
+        (None, None, 50.0, None, True, 50.0, None, None),
+        # Test 2: Soft budget with max budget - success if soft budget is strictly lower than max budget
+        (None, None, 50.0, 100.0, True, 50.0, 100.0, None),
+        # Test 3: Soft budget with max budget - fail if soft budget >= max budget
+        (None, None, 100.0, 50.0, False, None, None, "soft_budget (100.0) must be strictly lower than max_budget (50.0)"),
+        # Test 4: Only max budget with existing soft_budget, success with max_budget strictly greater
+        (50.0, None, None, 100.0, True, 50.0, 100.0, None),
+        # Test 5: Only max budget with existing soft_budget, fail if max_budget <= soft_budget
+        (50.0, None, None, 50.0, False, None, None, "max_budget (50.0) must be strictly greater than soft_budget (50.0)"),
+        # Test 6: Update both soft_budget and max_budget - success if soft < max
+        (30.0, 100.0, 40.0, 80.0, True, 40.0, 80.0, None),
+        # Test 7: Update both soft_budget and max_budget - fail if soft >= max
+        (30.0, 100.0, 80.0, 40.0, False, None, None, "soft_budget (80.0) must be strictly lower than max_budget (40.0)"),
+    ],
+)
+@pytest.mark.asyncio
+async def test_update_team_soft_budget_validation(
+    existing_soft_budget, existing_max_budget, update_soft_budget, update_max_budget,
+    should_succeed, expected_soft_budget, expected_max_budget, error_message
+):
+    """
+    Test soft_budget validation in /team/update endpoint.
+    
+    Covers:
+    - Soft budget only (no previous max_budget) - success with soft budget set
+    - Soft budget with max budget - success if soft budget is strictly lower than max budget, fail otherwise
+    - Only max budget with existing soft_budget, success with max_budget strictly greater, fail otherwise
+    """
+    from fastapi import Request
+
+    from litellm.proxy._types import (
+        LiteLLM_UserTable,
+        ProxyException,
+        UpdateTeamRequest,
+        UserAPIKeyAuth,
+    )
+    from litellm.proxy.management_endpoints.team_endpoints import update_team
+
+    # Create admin user to bypass user budget checks
+    admin_user = UserAPIKeyAuth(
+        user_role=LitellmUserRoles.PROXY_ADMIN,
+        user_id="admin-user",
+        models=[],
+    )
+
+    # Create update request
+    update_request = UpdateTeamRequest(
+        team_id="test-team-123",
+        soft_budget=update_soft_budget,
+        max_budget=update_max_budget,
+    )
+
+    dummy_request = MagicMock(spec=Request)
+
+    with patch("litellm.proxy.proxy_server.prisma_client") as mock_prisma, patch(
+        "litellm.proxy.proxy_server.user_api_key_cache"
+    ) as mock_cache, patch(
+        "litellm.proxy.proxy_server.litellm_proxy_admin_name", "admin"
+    ), patch(
+        "litellm.proxy.proxy_server.create_audit_log_for_update", new=AsyncMock()
+    ) as mock_audit:
+
+        # Mock existing team with existing budgets
+        mock_existing_team = MagicMock()
+        mock_existing_team.team_id = "test-team-123"
+        mock_existing_team.organization_id = None
+        mock_existing_team.soft_budget = existing_soft_budget
+        mock_existing_team.max_budget = existing_max_budget
+        mock_existing_team.model_dump.return_value = {
+            "team_id": "test-team-123",
+            "organization_id": None,
+            "soft_budget": existing_soft_budget,
+            "max_budget": existing_max_budget,
+        }
+        mock_prisma.db.litellm_teamtable.find_unique = AsyncMock(return_value=mock_existing_team)
+
+        # Mock user cache
+        mock_user_obj = LiteLLM_UserTable(
+            user_id="admin-user",
+            max_budget=None,  # Admin has no budget limit
+        )
+        mock_cache.async_get_cache = AsyncMock(return_value=mock_user_obj)
+
+        # Mock updated team - preserve existing values if not being updated
+        final_soft_budget = update_soft_budget if update_soft_budget is not None else existing_soft_budget
+        final_max_budget = update_max_budget if update_max_budget is not None else existing_max_budget
+        
+        mock_updated_team = MagicMock()
+        mock_updated_team.team_id = "test-team-123"
+        mock_updated_team.organization_id = None
+        mock_updated_team.soft_budget = final_soft_budget
+        mock_updated_team.max_budget = final_max_budget
+        mock_updated_team.model_dump.return_value = {
+            "team_id": "test-team-123",
+            "organization_id": None,
+            "soft_budget": final_soft_budget,
+            "max_budget": final_max_budget,
+        }
+        mock_prisma.db.litellm_teamtable.update = AsyncMock(return_value=mock_updated_team)
+        mock_prisma.jsonify_team_object = lambda db_data: db_data
+        mock_cache.async_set_cache = AsyncMock()  # Mock cache set for _cache_team_object
+
+        if should_succeed:
+            # Should NOT raise an exception
+            result = await update_team(
+                data=update_request,
+                http_request=dummy_request,
+                user_api_key_dict=admin_user,
+            )
+
+            # Verify the team was updated successfully with correct values
+            assert result is not None
+            assert result["data"].team_id == "test-team-123"
+            # Verify soft_budget matches expected value (or final computed value if expected is None)
+            if expected_soft_budget is not None:
+                assert result["data"].soft_budget == expected_soft_budget
+            else:
+                assert result["data"].soft_budget == final_soft_budget
+            # Verify max_budget matches expected value (or final computed value if expected is None)
+            if expected_max_budget is not None:
+                assert result["data"].max_budget == expected_max_budget
+            else:
+                assert result["data"].max_budget == final_max_budget
+        else:
+            # Should raise ProxyException
+            with pytest.raises(ProxyException) as exc_info:
+                await update_team(
+                    data=update_request,
+                    http_request=dummy_request,
+                    user_api_key_dict=admin_user,
+                )
+
+            # Verify exception details
+            assert exc_info.value.code == '400'
+            if error_message:
+                assert error_message in str(exc_info.value.message)
+
+
 @pytest.mark.asyncio
 async def test_new_team_positive_budgets_accepted():
     """

From 8b0d0b2610ec880d367569693f192faeae79c089 Mon Sep 17 00:00:00 2001
From: yuneng-jiang <yuneng.jiang@gmail.com>
Date: Thu, 5 Feb 2026 14:46:38 -0800
Subject: [PATCH 2/3] =?UTF-8?q?bump:=20version=200.4.30=20=E2=86=92=200.4.?=
 =?UTF-8?q?31?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 litellm-proxy-extras/pyproject.toml | 4 ++--
 pyproject.toml                      | 2 +-
 requirements.txt                    | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/litellm-proxy-extras/pyproject.toml b/litellm-proxy-extras/pyproject.toml
index d43b591686..0e72cd9081 100644
--- a/litellm-proxy-extras/pyproject.toml
+++ b/litellm-proxy-extras/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "litellm-proxy-extras"
-version = "0.4.30"
+version = "0.4.31"
 description = "Additional files for the LiteLLM Proxy. Reduces the size of the main litellm package."
 authors = ["BerriAI"]
 readme = "README.md"
@@ -22,7 +22,7 @@ requires = ["poetry-core"]
 build-backend = "poetry.core.masonry.api"
 
 [tool.commitizen]
-version = "0.4.30"
+version = "0.4.31"
 version_files = [
     "pyproject.toml:version",
     "../requirements.txt:litellm-proxy-extras==",
diff --git a/pyproject.toml b/pyproject.toml
index 40ca400401..768a41d2e8 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -61,7 +61,7 @@ boto3 = { version = "1.40.76", optional = true }
 redisvl = {version = "^0.4.1", optional = true, markers = "python_version >= '3.9' and python_version < '3.14'"}
 mcp = {version = ">=1.25.0,<2.0.0", optional = true, python = ">=3.10"}
 a2a-sdk = {version = "^0.3.22", optional = true, python = ">=3.10"}
-litellm-proxy-extras = {version = "0.4.30", optional = true}
+litellm-proxy-extras = {version = "0.4.31", optional = true}
 rich = {version = "13.7.1", optional = true}
 litellm-enterprise = {version = "0.1.27", optional = true}
 diskcache = {version = "^5.6.1", optional = true}
diff --git a/requirements.txt b/requirements.txt
index aca27bf284..1fb8a22cc9 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -50,7 +50,7 @@ sentry_sdk==2.21.0 # for sentry error handling
 detect-secrets==1.5.0 # Enterprise - secret detection / masking in LLM requests
 cryptography==44.0.1
 tzdata==2025.1 # IANA time zone database
-litellm-proxy-extras==0.4.30 # for proxy extras - e.g. prisma migrations
+litellm-proxy-extras==0.4.31 # for proxy extras - e.g. prisma migrations
 llm-sandbox==0.3.31 # for skill execution in sandbox
 ### LITELLM PACKAGE DEPENDENCIES
 python-dotenv==1.0.1 # for env

From 45c638266741076b4ec29b37731a56a10799c547 Mon Sep 17 00:00:00 2001
From: yuneng-jiang <yuneng.jiang@gmail.com>
Date: Thu, 5 Feb 2026 14:47:11 -0800
Subject: [PATCH 3/3] cz bump + builds

---
 ...litellm_proxy_extras-0.4.31-py3-none-any.whl | Bin 0 -> 51624 bytes
 .../dist/litellm_proxy_extras-0.4.31.tar.gz     | Bin 0 -> 23846 bytes
 .../migration.sql                               |   3 +++
 3 files changed, 3 insertions(+)
 create mode 100644 litellm-proxy-extras/dist/litellm_proxy_extras-0.4.31-py3-none-any.whl
 create mode 100644 litellm-proxy-extras/dist/litellm_proxy_extras-0.4.31.tar.gz
 create mode 100644 litellm-proxy-extras/litellm_proxy_extras/migrations/20260205144610_add_soft_budget_to_team_table/migration.sql

diff --git a/litellm-proxy-extras/dist/litellm_proxy_extras-0.4.31-py3-none-any.whl b/litellm-proxy-extras/dist/litellm_proxy_extras-0.4.31-py3-none-any.whl
new file mode 100644
index 0000000000000000000000000000000000000000..90b36bd78ac19e1f00a49ce5fb3d9c35cb9ad625
GIT binary patch
literal 51624
zcmcG$1yq%5*EUL*2nYx$DJ9LKK|~q>>6FezcSuW1Bi$k0ol18%(g;!l(v5(eXQ_LC
zAH4fLKl}XSIL5skGGvT3=RM<^*PQc~c?AoH4Fv^-1e_<Lzy}lz<OBFa0vt1AJFuCV
zxt5iUrK6J;*wM~L$Cgn`%h<x$PD_iy$_W-q=Em<+rV2WrLqkEmhx>o~eKSi#Lt_g=
z;P-vyCEw4IU^HAPlVpC@?O8<>>P_<-c%y7=BWkG#E<2gZT5W?VAIRTy-_<VFGgOSm
zVgc<AJSUPvpMXDTQ<LwmRIc95+Q=FHk#4ILsRV~42itQ_%@CL_+v;)<jK}@G5(%21
zkIHp0D$#4vB#mr7?!v31-+Pm0=|fp@kx0Lk-*(I6?$fRWzG@cY_w(%`=mO|;(FdK-
zDK)F=%Opw3EpiMEl0JoW7OJmD7?Cmv?0ZQMce#jhg$)>;KP0Mmxge#=hem(?QS7BG
zGnuGo<nu1k^pMk$t-2i-Wp%Ciq5E3$7NvGAYZYtqe4!Pto@<u>!X>H{D__%BnR^L-
zuV4kkCQ9)u9ZW>{zN8#4PQ&1X>C>~Tj*jCH$TYDl>1ZF%%~qB4=reoB{fL3e5~}#%
zGHNZn^OBD>vZ<t7iV8iC8qbAt%h<=oYVcE_YrEXJ4H~F3=(K-*qN@hxuy_4%!!h@?
zs|%|LX`7UR{$qL5@JEVii+!=VM^tDyZm4MRiKrn+7ffA7JLN=44fUU``0aUw+4eMo
zC5e#<t{Ef>n$O3jLUBBDJidHRl}pLmUupWR?qP-g^~dtWbxHrTulm<{E~oO38uVH@
zMxwHw5_b~@#SF|&w{i_OrM0(U>7}SvZnMf6Xb|clUih<C@Djf1DnGk-(`@`-Arwv_
zKta7^g@O|PZ)Rt1Y-ponXKZO<%g793W&^P>voo<XGcmDf>FU^m&5SL;jDP<Z23u>h
zRn>XRS#}KfA+0AXS!iLX@Fx>I)YWp1idzyfeh9)(hB3EG!-Yc96ZPAEp2{wyi>gK~
zS6btcK$8+V)t4*~zOSzZb;7}*Xq2LS?U^c*m}FKz9IXzP$Covlo&2)OKE;<HpY%8b
z%lj&+_`s3~Me6?KkFCcQTo)QMCr(TRo-a#CxY#HU!PRpidLcPM8?H(bnU0bdM&)2k
zK0dtGVY0mvdI@7^6A8oO;}IKi(gYz*f714tk4bO!^;R9y&xpQy6is~jx*K%9b&!Nb
zH-*XfAoSk;854~B32te?&e4o&?b`9c`ea2!=g{XzNNrW`f&=Wq4Ca$~jD%eYA2lUE
ztLPk)Pj0g#r}U($^0z*DiZ^6<Z;~m#H&ben;xufa-a30S+t$>z+#*D_@5!Ll;9G94
zkHh<PA`hD5NHMbOUCxg^Mmto=nf$dGM;tJiPpLy1ywN&L`|H}(*o>7g<mwJ$@U&;~
zy@*qbD_$>4s`;d1avsQ5@e5Wv<B4$52+^3v(Ea3ix0S1E(xti$E5Z2`A0wm5mSiQw
zUyV#$%|?hsh$MRKcokC=dJK8}ah=j?o%>I>$!gc0wZ2K3F>(-EI{_KP(a+e^B*bW}
zi|IziE=&TxO;rs;yhR;M*X}uO9WME?olO#lw8yOrwVN)jPH_nuNTiy5QEsv#>My2H
zUaLG;wxykgdk|RXiQ8fXAFxz#>am{u(u#@_Y^;yY4;`{;D=mTH;}n2${E=;)ru`?6
z{*uPvw`#C>rfNkJIyw&j(EBh?#{#OaY-{=!YWOc7x!Tu@>Xig0Lqpd}JoyT1)z?S`
z3nIpb4ZAnf8!o?PZE6f>3Nv~H9m)5){$xkhGkZC%Myv7dS+kSdAn2Zkg>Ni!T@r3E
z6pE9<s1X4YW(kAMw8b855IOOg!|<WCM0|{W(E+TNXuv}k!S>LA-o3&MvBxQjtf)vs
zyifQ|S8(mo8vU#zp9Wp)^Y^~4L8B>pue(_7OxT~xiMl6P7%=D}gz74R(Nmt^-jb=)
zhO1OZ2-Rg;Ig%FT8G+i2DM}iZEpg~<?;$mX*5YYVK37vPj{eq?kl@)j&JdwWjwCzN
z6T=Uv9Azrf$S+`&x=nouI1u>49wNd9!6Emfb_Mq4ptxYwZag!9n$*T0_2OGACyX?i
zOc95#VY8<4AdW3%%SRz;^$?v0({vt&>bT7))QlWdWpSJDKPsITHW0zL9CdD@7|e4?
z>klS!6UScifO9(EscoV3S=ip?#g=b=ZTRKOhf;lktk+%{KAU3~!OwlT?2LxQs7c0!
zKbnL6!f9T0^7G2Jxj)gWx*yx{W4rRj!)1K0nt;Ieg>38!)Tk;x<e#B1q6(SupOxuK
z3OXx5ayyxkeBfxl6yKe4q1-7Gso}F^J{c!A_(TQmqg7L3O4`S9`}GFbm(Gtk$%&9)
zVkDeggQpNnJxMD>XxN|XL?cB-QZao%Q=vw!Y;_P7A%TnJ2U&>@?K(=Q%GV?-NvhfJ
zMr-{15+{qL)cesLN<TwUy!9n9C49C2Fg3GLx4gJa{f3`B$~rsPSGCmE+McwKV9`S=
z8a(kR+a5k+SDoAR!A98<ep`M*_^4id;89(A>j`>pLg9w3#u4SNOuDl7wpqqbxRh^#
ziD6Lw^!DJh4cF9A#kyl&1zOb_!2_ZQal^;?G!cUZMl#*elX{tk>KPKtyZ&of=GY6i
z%GBP1kFtpNSTe^fNR(IdZB3`&%hdSU<BtTkEiB%{??{tI^l+3UUNq^PL-1z~+vS+4
zNZk5K=+D9IL{X(Cxw%0^<Wcg@DIs-r{2P7!4+J;+O_dfl%2HdR<)~JkohhA0@!5oT
ziJj1{g{U=2lGm?Qw=S8=UhFywjX1^1t%p8|`!Uid>e$C@hc)0PtjG{xmdM?FqUYfm
zoZ#*B{R{ufXFFz*Ie6a$4L@ml=}9*F#OrQb<H4Q`rHwko_nWL`iNbDcc=@ct?75Yb
zEpD=jfeLfIgu1=-r$z`Z5AP9H2Jp7zV2!<*Zuxi}?#C5x^a3$Avb1Kf#*NLPaHA{!
zjI!UVkTxi7bV{|G80TQzsk4SYTh5O^j)kypI%jo&eC%LKJ$N7>i(cpZi5i6p7N3S`
z_X=hdeYBK9p_u{MMk`I)F`}5Npsz$b!jsJMsxRi)wN9_ORFh?*3GQPOR&|hbNYey#
zbRPD-To{Vk%Qf$-IZ_m`-QLM4H9GxJf6qkqe1}S3p3uc!E}gulkGv@8NnX<SXkOZL
zqZiM^f_WL)wcewJw&v8$Lq`WES8NxYeB}X~s3OXhsV4jCMHU(xbl;yidZx)&etipZ
zu~jV6>H&x=5kOqB|0Z>EFo8hKS~~jrTKYQ1W=>l6wqP4AI~`rKTWK^|Ud_}Sgy(ju
z43|nb#Wb~?l4L+eXM#&sDcwS^BiaC0m2q_%)XCXd8HoaYZt<-ysbU_c>4C~qqZ3V}
zzNf<(7&5!ag4)aVSa^PP-3Ln%)#+lHxwZER?&S^*erEJ_K}mnzfUT!ID@_wY&-Jl2
z;Z&d5@TGOULkt^k$3xr;v(3nH=!~o7@i+E8f$93?c}+G930iN#bl|Q}KdAC25UA4k
z;3M*$AuU$K>Z0sO@;ub^XDBH+<|@*BjgfOD-~ji7ir<<w(u$)6_1hxdcZC`%ALQfK
z<ipbQ#N`~HX8&^P-Yu<z?+?{Yk&c$B(%R((>5>zAzLIcz3A`t0rhN{T!+X&=^IUae
z!U|DQJ?XxK40iLCZc8IeM@Yr}ahw>WHKUlhK&Asr_+XvQB2hB1GRY&Gg}_X)pS+<H
zJ<Q^d(`xLtVf^&sAK4>D=2j{wn@<ud?*25IV+(xq&3*=b@BU3N1fnq0HwJFf0ysK%
zzfle*P7o6_=+}+vSQ%^CfUWJpwsy8!c9#E#8-CbdhSCbcKv?9F-j8e;ZWuGxeNarj
z4rX{@i3FD?_U!Cr^Au_U<RLyuvmrZ<5!A%L-cA%_tGoubrH++0Q{Am=Ou<<p7^Ll@
zSRBgcu~b~}tNub)%zt_Ls+9&Q{L!EmRk?Oj@Hxy)In@=J0~Z1Lq5$iazPp@UAWl|J
z5Sx|-*g;Fr#?nH|#8UU4?AAVv-_!?$;k$eOP>_LUJ+CWe)DFiivar2uJkn@DN3E{+
zG5Xc%K=lqO9XCdt&X)_vcsf`on<58C^~U&0DkRTM7|*6)jSaP?egYw6Bbxix<m9WC
zcv%>$2HTM@JIn9Ao3XG`4t11+&P4k{orUl8_&s#*69bGucb{|Htpvd#&%Na4t+s+F
z@$1vEsfGCg({l6PAh;Ckr!>Ne!3Cy9h6{A^#9k>MKXyj=Ff944OwiGqj>y<57NPF?
zaZf~DQLlW7(igT^U;93AwEC74n|-o%VlR-beU^oM%e7zYrZO%2y9u2DC6)sRVmSX;
zxcv=}|3c6#Ow3GdtZeLBKwYP2s%2}hrw6vR)zY!h*D?Tt0$Bfltmt=;&@nXpCtZgG
z|FR&yQ`e60X|K95<8-7+>?7vb8O=0|z_o~$rkY}@#^Zg>F{o_Pc)ypJ-t9jTf?pnJ
z8&eC6pIE#e<<4KZke}#*d4`x1s*ArEl+3{>pSr3j9Hd%{a1y(X_3Rx+K=V0^i0;&G
zzh$94fv|n?MoCLc9QsWqBq-rCp8>*K10}5dU6sJf^h*gWOuszGT*pGk5Rlsdkp7<}
zO%7+W1boHU;W{ufM~GDZB_&qy$`a@JM^TUp0{#lSPp%}zkKIHBUr(BF)mNIXsS7U7
zvE*TmF0;;+7rl`Rw(khS=*baj1ixqXOBk5C99TTe#}|1*I!ySO0DeUcF500c%I1yB
zbzvKmqhaVgIt#*aTi?&m#HuJm!o@i6+s~I=!GqPt0&YL>Jki`-4b5`ANSEQu&9Hbn
z9MEE1JH!LRVpMH?*QD+n<8u^&$avz`^7#gQTK7#P4%eEf%qqL%zO*FllKjY{rrb{o
z(>GEZAJp=zenp`vjwV2V{zl+DO<@dw)kIfvq(nH_@2tSZYSR6qJM2wGXSDG-nE?uR
z1dhVp70nFdWa40B(Xs>Um}{AX&2@o{V+FP`H@3C?Ro4A&pOEs6qK6+6l|;U}N$p3v
zG0G_GVJXY|g5a~FhFj@iLc}93GCtS1YE62cWD8H2D+|)S;9Kt}ijkLJV+t%j?*anS
zJACQohcBz$s0{`ZW6mZb<cl_r3vrfqnHjBq3Six%f^+VFwQzmibK8tK@sexb0#daC
z$NKKlu`#hRv9oggG9x`5JtHvSJUaSX4mJRX0t8`Gu!ZfPKx}IT20RS#ISX4Iz26n>
z4bemT%g|a$FrbE$OKL&0?eoa+AwAKQ&i!y36cLy+G6a_{-**--JSOcw*er{G4OgKe
zw}q8^$x6b+CbHFlM%^^ud)#RCh=Qu<E9-~v^sYU4OObAc1gZ%^(qJdHg|&b_ny)53
z>eXXta1&3w*bP_1w41P+GPWOGOQ8w4-oh8pbNq+AfC$YD|1a<bE1(K4CN5_7U&{C$
zI(}XHKj8}n2)@96`x{@#Lh!|aNL(y~h*7E+%SM=UV&}-u3*n6U&dQ31Fg6woJw2z%
ztC&*{-@`o}QR`*H7YyR#D}0FvGcN|`KoDD;LC*7l2+ZGOn++=ndoYG|{%SD>YAE)p
z9fAC`Z*Zo(6lGZ_k8J!fEN=*Rh1dR(S5Tv}uzbG97b1=-D&~ajNAv|tEIRc+R%1I0
zu@$fpQzoDB5qS<_q!xIyxt0s~d3=_UewU+8F8qQwM+sK#LWg_!{yTP*u-y>yxuUnh
zX-mZSOFHO$C_|kzb`y^h3L9Ky2a9|Bxnn?&k-3CcT0LIxbk=HJ4wMQ8r@dU~$}bs?
z+OmO{{|;lma1W_k|D`-?Cb%o|zDTjJ!y^2S$4I$#8a)xKIhV}i)nH;oaWc#MHIeYM
zgXG}%&%)lbbhrqHpDG1w;;?8VK+gw`(;6d;e)y;s9(D4wOZFgH1exdP@gSl0>FYK^
zMMT4*g8R&-pA4FU`*%O<p#^mkXc2G2H{QDNWg^p89l(Xx0(^|j-L0RUiHVKn5B#vx
z`I9AnVGrG#v`m(Qq-6#Oqv4RYFbOlDkY?Ljn!!=o=)QhH_)O&Lk}*zn34DdgwOfef
zj0gp?7}t}bewVi?@im%c>QqMYj#SMpQQ>e*uCI_)ht;98o}3D6)`Kust3AaTFizZ7
zI#}<MvAPCH=(~Fw(j!GrJ{&5@R#yKkEn|NVTPXN)G)}f(CQ2^Q^#Cg;Dh+=!9$}Qz
zhP@lTOQj^7!^%5)kphl|xrl#D1o>4L#@dhAaPAX?tr=U2H)GIw#@S@)J?B{U5{P}O
z0@kGM4(9V5>^jefen@?$U<{1lFu&rB9VTi&)|u{iF$l^Ty9c_Tpk?dCi$+s|hb%uo
zO?htp?8qt-gK-MMnpJjhd#&xTX0OCgYCw0r0`=2Q86!iU^SB_~K?KSn%qJnL`Fav^
zwRdd;2N#>RzOj_Z0eJ3xk01OHNfEIkj9l*+iJ^GCu--j<*ctqd5?LT=E@NSZh~5wW
zHCMs=SJ(=eDW|WZL|Rg#jN)H><VGlP=s;_<7!J2rOYnUrWsB(^He`G5n$S$Q7LDrd
zRRO0Z15#~s3T^OH@6jt-p$lTmDB+lAH7FUdAx@a6FSB~7Y`?%WKF^)az3tsLuLXTG
z9mFQC(L4uC<r#3)|BcD8F|n|4Y3bWoS^>G%P|M!J7{II+5C{T6uf{fDbFhWoP4gN1
ztY}5u%edG7N~~zn2KfM8X79+>Iz&e1podQEcz-{{L9D+&4^>P8ok4WqRRE)y#QPzs
zB8Bp`C74@={(S=A41sU!034Hl^Q}4Am{@;DHXSoFO9u!_vb47Y+iLv<y54|oj17$S
zevy^GBmYeqD7t^8Huzy6we>XO<`#^!e^z)RAxxbmMEC^nvHyb-#wE4JV%XJe#U-|a
zCpg3;m0<L~JnF;Jq{{4<pE_cCX;$+J;JN(f!@ItE5aZi25H~PZ)h9O6wWop;zFww?
z;K(4^#jiD9Uw6ha-n=W%m?mZjPz(ajt2;~0%*MpY%*4#~E1uf|7X;*MEo1$gVrlgK
zLV-}jJX+TJ8@f%+)NIyaruR-zEciE`c#e+OQ3amuE^W?gX?Q2zyO+$!g71eN%2(V1
zg(I)i&W=XQh_zOrYW1b9xT|b?v8y;DwIr7gJ%-A)t^((tU)t{DJ)K<<^4u?}CVD?}
z%1wG-Nkqb<Je_%b2!B&Tmsk7H2Y_S?KoC>9vxF=lCN37%KN9|h0^fl3>@01xY=IB3
z?M-2Q!v{>-Ko~x|&Vj;D@e}0V^H3L~SWs|x+Zam;RK<{P@|sZ$*OV+}dJb2rOpUoF
z%&QbBg-II0np}J#?ZGxo@HQ}Q@kAk(K{C$V-bVbSY}N`=EVI_MLP7R?ZP!F)@Ithc
z8zrI1n5uWG3d7-L?zC_Ni}`H4_2ZK-U+oC%t-hQ4z1&LJw6dV&Mc_Sh7bHaZZdQt&
zQc(W-y0D`CP3OBa=GgjC35$q}qx$>L51uOByRTA&%~;7L|I}}O{ig$`wfXbqC-zC}
zrRZO(ar1DfXoJLQV{m_*Ob?s|XkoL{#7dZd^|gF*ehg17MvQcha8t`Aw9~Q>Enfp#
zzH^#j19331GqL@_1?GAXw+9G^e@YX{vXT(mq49!NvtB_*pv){bxttDGr4o~@FehyD
zUZfa)gx#<^ub~>pD+d*l*l*vj#4$hMRK3ir;XzOUkv<YVXn*8Wf7tC*Y@@1V#5)q2
zj*$-a4)@aoc@2CoeM`*1<2}>CU8%|)?ro{@N5&&;)hvy(y9Q@1CpBdCpScZBCbUNO
z`ZYxdDCm;fI#jk$*-ebPCHFawHkccvV+zRKYNw7`nrPiwIZg8(#g5WkX*}ywp%Bv)
zDR2}|ufiw{Ga)Sro?Uho8vDt(t9#jlZ~cjZhFVmqyJ;}99}z7@PM_-mz9Sgl|7|iI
z+EN$E*{$mMn&N(Z9H3u9K)-r-wc@|@`x}HBfpyI6jI;nG3e<K6#$Yr3Ut|D8?Eu#U
z1gTplojh2E<^{qN{yLvitHX~-`7#@YjmbD#RBSE*rO9)cZxqMP?E#MRymVs{Ikf5H
zN_{gU*&2mYM>~D|_aFfS_~##=a>3cwRO$%q(_(WYg^JpF`h+<b_fp8EQo{7v>f_4x
zu#gf<#JR$CSfX(8mWxxhj}4<QoBEF}@SD00e=pX2V|YRClov-=eKAkG#F5?eaipk@
z`pZqjBWjrEe+4MTAHXLX|3)zYZNS9&D}X^XU<!8nU5ETn0itDYXnrf(%twuww1TkT
z?OtH}X;QD>t1Y18A=H(ikn9p7w|h(>uO`;l%yVTzt4a4sYKp-ijbkJA`tlpM*o7O(
ztejeWqea!rI3ehW=ge@a@p3HeO5qwg@#mtiA`Pqh5i#NT$YO%I2#9&z-Nu6CwyWmj
z({t^5>D<E3NQs}9ENBXB+MT|f5VQVqc`-3GlMt=Ks(lbLXu-%|B=u^3`~ysYkl)*F
z5Ep)u^M)h+&*qFxNxbiDz4N*yG}yZ{I3e2Xeo%rDAY>sV=HvlHZ-a(!pVf@o^{BhU
z`eIm3nnn<bDRnt1by3KY1ismn7f<q}X)v_SnN$pl{IFUss|(vKP|(OPR<iF0VRE`I
zEp)<pK0#T*Ual5Xukv^7h}B^m!Ale)h>Z}lB4DOqqJaL1_s*7I9m%j~o^4lMr{=t3
zWhbHON2K)=&QW)`WvrXGm^Ohg2uVMZz`1h;$p+#CaWFH1SbnD=I~_awUl#qVo&uW6
zx9k}L75b^g=uyNZdc{_4j*zYI%OP3Y9at;=4HkZZg#8|AMkP5bJ8N01lT+m5V|gg(
ztfh$d2)PfA{-#3yY`D0$kVD+JlC@6Yi?aYVk=ET!kc$bZi&)tpOskfzu_4e!x6?8J
z(#!Aq=uc4yiHEo3_#Dvy_$9WlL(0-Sm6YZ@Bqs8QAyF*><2ECmFwrqBHL;5;<P@E$
zS8q?rzj5<J38`%1@zNY2f%l2<kd0AaMB`A;V?T)9>^!3$n~Hkz+(Jn$!BTF|esW?4
zr@BE~&$U|@;eig^ln$<7Tw!DseZ8R&s*eEeZ0G&urC?#ddOH0Km#+Q?IIuixpLiEl
z(WWPfLXt(}G?7@dH>1g3-*?kHhf#Ib1St|8{OH?xThvf9)MlK7wqxTxzwj|JOS^jS
zeO=ux1|jH)!3pH<4S;iJ$jHV7Vq#@xV`aSsLjX<cgB`VgYw(}#fI(amfQP?9Bbtpp
zs<q-R*!Z_4gfdFeGYs|*1r13+r=w87yYtfJN3lj>Y(}vbeXPA@3F)sfrN09r`~U*d
zo!NH)J_2Ge1C{_`-wo|`Z1imawhb`l|773Y!ucU-@EyQn5_3_HkA-q)vEy&(ZY@2n
z%n7642oruf(R#A`P3Rtdg{OLi->GB@qZr9{{Wi}`&7xR7mmpgAL<DTK;%-)d|KaqT
z;tEC15Nu!n=F;^pR|}e#(C0+_t8ENf>hqW(MOW7nc&Y-qlBV2hsZ?e`>P4~M`D<rv
z{A2SMXV8Xbyx9K1xZUL%M;Kbn+HI+?sUM8WnHCSL=Td*2`*eX!%j{)bj501kr5>d>
zBYiEXlOx=D1g&`noo*`26hMqDX0V@b{nG_Ui)LTd2E(N7wC~}h(!lGuf>kHs8rw6M
z=36-RyRvS!GN9G8f791sV+Q`PfPgaeF9c_)YXV@nf6{D`+=vC>Rc_yCEgV~gQcl)V
zXvTetu$5n>GiCFu;j(87F<HCwn&n8rt>Gjdt**`44)J{Z#PFd|20x{r1^lFy2{!Zx
zoVVntzyr)ckP1bKINGR$an$|p)0QAn0y)m-E@iS}X_;~EGtK*P4n;J&@f5yiuU|z6
zfP2W~KC%sOpt?TiWBTfWCm6X=ILUHs8ll0!*!f&F=DSypAO00loB#4V`1JEcRqO>?
z&X{b8tTdR%(Y%zIrkiz&pCtNZP3OrHv<)(}_?&gT%f1?8kG!QPT`)g5R{Cs9Kqw`S
zLgeGvF3V|0^z7+ek1(SFsyu^KE=n6$#yx5L0NPsHx?-0Hgx2q1dS|zA&g*C{-q9gF
zNNi?F@vtpz)U$tUfLE9~L(CFvyoafWl>5G`XiixcnTIaD2yt;-$Q6+(+PhX({5Uwl
z_p&QgVQ1H@Yr(BnQZO0)7A=iC;zDEz_y_X8@(*CJ18{N>z{o=CD=iCqGczrq5Hz-P
z`j4994l({lK`1Ndk!$@s%FED*Nhr%%{VE|3(Pj7U9q*T|Esau443D>~Z)L+!EV0OU
zb8uC1Rv{JiWbq*vQr@0+`ZVq5Zv{x_3><yn{8j(mn3npR+51DfvoQlOgpHNuHx#*1
zVL)*3AA|iLRB|gB+(F<|>0WV324qqC-T^vDB!i_@yp`RUKcru#pXri>s}^QrEIodJ
zNm#JBw7G`2iIu*HhrNRLh|m-a|DfhSYi9rPeAyg8QVHNb@652X1EV^S$jzdqr(>(9
zqYq?1dwoN&9e_-AEDUdFyX5zOXS?i3wCA4k#*FV|ROL1og-F!PWPM1`>Kk~y+gtc2
zcaxGBpQ7@IUSXV)ou5RE5?HMcdo70xX!lBIDkwe6{}lWwq4WC)I%*~x7gEMOL#Ool
z8eNrzgqZA6j@7S1EVFR@crca;T5jsSymlD)K|M->fiADh9C|0TnM8tAwabEqOXd`h
z<EIQ~jlyz=pCD->G3<-I`M7e=N&R*@qhAUmf`HO-*nguJpr&SK<7EDA2{+LCKV*U|
z`94U&S${$6BaKEbvtIVJOIEF_oIw9kM5N487W+Qg6f?QIR!7+(Ns*YmCqrEYOTqkz
zzE?d;6hfNPqt`@T#m%C%@`2%!^7o^D91tpGV=;OjXZucfmxXb?8KqqL5f*N2M&^kN
zQ`S7^Kf3=QDwavVT!ssE^<tCZwP{x3k8fTXo0`Ra*~9Fl5{n%D(p0Q%B^E;P&YOFZ
z`;#cS`Q;H@<5fSr3L0s0YrwMJ<Hl&r9E5{j>!3oeE+S;H=4aZds#)<p?mp0oZ(82S
zVDx?d8CZ!<JC;cD0?qgPQ1Z7Cb8pRdE(3uS86Ls9wrddUtYe&xSrs3ncG_a`qp!O^
z!)EWt;SO@`YcvX_ItC=+mjoA%1c4=;ufs{-Y3%a08aOgFyH`i)%uG{h!y4E#5T4bp
zIf*$KYi=D`4=gj*zACu@Ar@KQgrc<4L_?E+O&0<8XLMIDW(OD%RyJl3`)!+s^v=vI
zEp5RTf9IfIy(AM`ON*NfLh}1EDd0lioj&jA!9sO{p`2{|kdIquljPYWzQ=|)nk_z-
zW+`n%gMo=!`tv&HdZ*8Jc-e~XUAVl%)E-6T%7|wytpG+8B_)mbHv_GM#?}3!h)|fy
z3N@Jtg)co-`%Ru{JYAtVVY*Wd`@+xlRZ_gSo)Wo@om?K4m2<HYc99;tX2H?Ll`F&|
zv|BK=4mTbg+Fi82M$e}FwB2>4Oq_SjYxkiPZSp+=`x%_WQpLm5#Zo>$5uIbU>Q5&@
zqYg8Vheg*P(5OqiNOvw+C7@QJ&a-~wf_PK8!X%3da)44HM9iI`GN4>$CKllH7S8`a
zC-u8TN6G$I64H|Uzk(!mf&8t|2m$`1x)i<`ll~Z{3=FsM-m$rjAOx=J0_V=Kl><_=
z0QT~`Du)!G#uf&aT6&gd_U3?<{I_!aF0$C8AxY8Gc<0OBl45Sf>#V=N(v<?fMBAPB
zDLk$+N0&@02K@1+s{MaTMW5FUFAP}!3q&X=6+p5(<uQm<EFci*Hzx>@!a~O!Y-^>X
z2N0rmmX>C}{(aNrJEDe6fS!Ek?hE1WJl|tv=kiVdZWB|oE&9x7{;W*=^W_&OA?}}E
zp=T$S3p2)JT&^ZEvMgUvZAMAWph#&(88T9dWt@3{j1frmhe*Hpv#cH`zN^-SEm7$}
z)K=%%f*q8|M}eb#fAxVJOMrPkZy$=+Da9QhzgB&bQdbh(&>W(1G(51C5kN5IiT5Gn
zQo{om<MB6tgduWGYxoS3K$*C3-PH8`w({}9RZQoBSD*lDifkSc))&L`t?ECUBT<91
z=|+RoD@odgJ8L}gzt_e!B!_M|r*D2yYz;=|2CXtpD#Ud`hiuQ6cCz}uX{CBKxw)#N
zF|eE;K`N;kqy;zsB}K^|!P^1peWtaBwjL*M2=ZG}-b9p78*@C27ZO%gXQTHVPN&=?
zrdR3X%tIQ{L|<l<47|0>xCT{hAK>)6<6YfiJD-v}9X11Z<_6rK_?_<#=y?ON>rcDJ
z)=uBp5@LrpFUwb^4=6h^>JJ|#YSwn6FXq7z^$Q?J2?-*3&S0RTkHO$BHx-0ig<+g>
za#wJ(#K2cR%3Knj7WF1QC0#u7Ai^j_3|Rlxh}9`4$>IlPuVIBp`4%emiElnD^iHx<
zg6DTaV=n?D?2%Uq(<itKkD6#kYRpG8np%%l-(Y#l_j|S3jJiG_U@LogT8|-MlB}Fh
zyc-lfpJYH8Da!^o=kJRFLgV+U<v{)J?yB@96Hg#-M)murU3S%}qcX*wi;G($#zg*)
zsx$%pfPtfZcRg_ej?2OHyWsrWEp%*j%zqINH_+Qn?GXmmp?H8$p-$flukYY;DsGeJ
zc_}FeJQngtH@PM*K&+VuKf((jcs|hD`=N%=QT_vbh>N}u2iG&>W&0Hh%{1wQ!^y`I
ziu}_{i;vHSBhbS2K2Z<v8|7Y9Q`=-|-VCxk`vQ4OfK2Ux4T#-UHck*TFh0$~0)h<p
zn_K;3jRdJa+eolIc7F!?<-jEX)#vol{kh<teyo|u+75n|QSq3TligSYvFWt<#g5Z`
z>Qog3C*n(t?xsr5RRs7aVN*14#i4>S`BsYVJ4>Jk1egfROI`0^zoziTE?0}2za3g`
z|5RnoO*30<J9651vAFj-*12wtvmx0~m#AJ!+B}I^q>iqXQdXfy!}(z|8nKTe+($M9
zwvV)I_%HMhn{?VJL5%j2BBGKUEVXAuja&*MIIRSW$mn6}5t(!ihIDG_z4BO%F}X^8
zhCw99Xs5KJS;>i8S&dilJ*nNX-{0N}@3e#?vrvE%M}Pwf@qgd=|6YH%4d^*R>>w_n
zlf?=&tso%~s9KD5e)CelSk_;0@K>1s2UHglCJjs}VYlzT4Sa%Bjd-s?$=T|7`e8bb
z<i;0rjfz<h_dx4cyl>gw#NwcA*TEeyA0`Ixl8trAN;$7v<B8;=n^VpcGxfwO#d8Pe
z$0mE3Rk6k);ITCplvT(6@EDsdv@r0*!nM*c6ht@P(N1B7-X0ZKsLl76C$|d9q+?!x
zi(rqVl6Y0Hxiaw9NLs^kuRbe6=}5fRuj@FIb7+&!xsXnc&J<mTNbj>o%1qc7w)U6_
z)IJ||8RQ2RoSs(}oicJn20poq(kf^MA$UU2C)-VQrP-|BW8_vbWA?CJ``2``>;uZ)
zrc0><SF}2KUEdsSE1aGTZfmxVO2M7M-8AG)0gjvxfZo3W=gtKc7clt7$-=_+r;!M-
zKzdpbavRd3`jcY~01N+bH((wLVZEV*PTzK9ks+6U_vu#hA?f7g_Y_GSkEs-PUl1q2
zOJaz1_*lnE+8nJ$e>}e}3SzP_fUbdY1qJzW#1+PWC5Fk6?UT=NsKBd>EtPsa-?skn
zM8dh{^>nn88xH$o47&Kyo|ae`b=4Z>4p-(EoJO#=w+Hj!Qy(GffaS2$CX|S>YNKHT
zL?w@(scD?-iXrv7u?KLU+(b`TZt-R=$k-2a0qsx%7Agh&eJ2YA1~HhpSUG@kPkRf9
zh3aelZNoQ%R&-bkFmr?YZr3GnIMNHYB_n50@lj=>5#<*V!befjIMq^n+eQ9F*l@N#
z8&|F)vzyI7Kp%I=wNeDak_=@+QA(0fE83>F*kyliarA3^+U4<$%Zx^)0F$Wg2-}tA
z>;o)QcfL4^rT{~AeGF1^H5q+`bWYB!e1IuFA)a<x`-6`&LrRC1bDK<;ZA~K+(hQ@*
z0lK(-4RZAERGl5~)vH1{+8<4d+1$dIs&PYwkby~C;3(cvC&2J43llql;eU_7{?*8Z
z;Fe#m`ybix{|1e<Cna4Tj7ObCTwW&qhL&OLum8qmT^~rgy4PRR()!o_C)G@uE~)dE
zY|8&eHZCA0vHsrJ(gI3LeZV0g^a2E@{X-b~zmaY{Fe1JEEO@*<YCQd4N{6DMWD0@N
zkh1Gv+#EZ=C2+C+PcP>e+WfDK2~TesiU(wxYQBVX?#hd@D5jRR*C4O9r4;-4I^ePM
zAr_2&Zq#-)qAsR6uXi+x%i=oilhDDfr-b(DuIF;D^-aC}ZwM<9CS}`#v|ie<buNzb
z-t*I8Qe_L~xf#A%SJJn*0LKi0xjPmEh!G}WqLt+jj{bXe=B8sN%Z-=-LsD+1v|iE=
z*QmCvrHyR}i<!hRb-=;ei3<8f;-<tuPG2d`d@Sdo3yZb280_IWefNYEQO!>2;rHZY
zf2cwz>UwPtS0($HGNFR>Eo0(==PRKL53`Dc8ep;OsoUipY&(e%CZ?9xWU4eij|;Z=
z@8at@bU`~`pP_B$e_?;&98Ikid{$Ofwf{i!uuqv8nmoq3w?xxlz{fUw_|p2t3zbv}
zV{VQ3fbZFsL+k0bR!JTToIM88Ee)7GzEH(SRhxdTKb}8$QMGp6+5ji^Q30k)ecrHW
zR{HxT^Mj|a3x_e4jNbI|?0Fdu-4pZ)2}tlR>UB0AA~HZ}-yLg<`nl~SDP!q!O7#$<
zX>a5z#?k{$XwjLJ#F9BEg}6TZvxNmVUhO~x$YA-y^Nd(9*=tORmgC!_0r|)Gf9wFZ
zh5}p=q$<5j^kf1tvjBuW=N}Mg3)ZpGGx}ZN{DUL8h4Wapk>L3_yzQW+R13@rP4*Y0
zPz{#9R28Qb(#=;rjx|#ThMTBun8}O6<90>}=O~afGb$<sT}%kX*bKX&r<H6zl&2&|
z#ZxB{4((2z4q$^&9zeUVW5cnybc{cQUqOV6zEBhY_|fp$?5C!@&X;VGrU=|KZ_@YF
zS4`>*6df$Dyy!Q%E;E?loILn78cNL5u8cdi|5Qobr*b@jmQ~rr`ivmo-tRuLc0vIR
z8y3p-ZZ|6NPGYNOQ1Av>{T`W6javu#TXOP`5+t8`-83kvq8;hEkgAsbqN8TtNQw@8
z?sXiwB5xWxyEO)cb5=1s1!z?p(C%HyL7<t(1ko)3Lm|zO-*c0CmKFv;f9xOBI}j!r
z1Pp~j+984r)!Nc7M^Of3c9LTe5;`s@RRbm}vSs_F*KaSLknWHY5q5(e514ncgqx*{
z56}vZ2Oku}3qp76QhW4Ha8t{hN_3)Ml)MpqLNbhQj*mk1;(@|MlYqD*?kgoxAC*Z$
zGoI0kb2#+GL8pZs4nkk_$h@;3yI$kV_d|+YQxh{=NnRZ;(qASH-7E4HaLHmo{-$@x
zsUsy4X4w0|AfVO#$MkZ|MOxT*a_}dgXsRc8pWczHV_@<u2Pz*=@K_cQ?Qv_3?PP__
zSGsO(;ogiRrwr_i=YS$P0Y&QE)l4CQ1Y)SaNt3^*lK)+y{ArW@gIYsmhafYUjo(Tf
z9p&P32pz=D5mX|lI`n}i(}Z33c%W@5u;USL{*t<*xz6?c?ej0O*<r_nXj0P}+cK2M
zN^sbkAeaXQ2wiv_bJZvF(Uumx1Q)IEGt4&{y~(}sJl$m#MLu+kcy?bIbrMm!W+qIq
z@0_@A3vPa5O5Qd<eAMzPJgCDwGM|UwX{*m}+fG)QH%CqqHp-#>Wn9v6Df!TA7Wnv>
z2qf@eA+6v1(1J78<>%<rkP=5+r{)TEY;j$h@p{^Xoi-=Gs!W1D`oeCUrTuhd@e~Yk
zX$tt3JaYQ=0!qG)2s49h^-rKDjJPbXLa!$|i;r&Ai1klbXS4x*8v^I98wo)4W&xNG
zpr7|QS!JyESH`^=#OZs>(D*>u@Wb=Ub9PMUFk=~P-LwJ&a`is#3L(Omb)re<`j6KA
zF_Ti!#r%^uzUFGfcDP_0a8H-xldE6Lk`&2SKc7J$wih8j1<$mXU`qKq8zsWbD6p0b
zI`bN*)Za8B`{|=;NWlxi(Q3fCQ><eG0fK-)09F6X8*RY)kiLt~-<as12S@&I(8Egl
zc+_}(M1MPgjQ)|Vx>cfCJVKR%1Q!TgfQWZDu>il|U}0nV&A|QHi~)K{5JdE6IvE&0
z{MA3cd1ZHy>{ff}<`_Zxc<bo+QpB0W2lam*B~XC19cTa`!`i=?wq;_1<RgH-Vb$UX
zVy2}HFga-pY%Tm#z|2zAkcI$<Z_2FC&5>DNxgG_SnLIv^D<t2^%d=7>C5}d4zC4a$
zR<N@zrB`8|adEbA*x~9o=%(>d<~tXJNm$j3)D;@=4GFjCdN@_x7V})HT64d>;>=sw
zI;99+KRlH3aRf0>3@>$KPWSN&N2z&+#*jP7Yvsz>AoA6>*tkqCp4&eMSl^Ru5N0Y(
z$%jv-*APvBqjTuQ<R}9#=|exPFAKCVrwC9xB0VTLcrH8CKpG$+Ou?Z=LTg`1!qI-U
zgG|3)^=JxvfLlr>+2hlWHWGTOrx-jbj$t}cOO}UDM)D7rm!5q}O<B0C&q`d)!rAuc
zcszp6(N$0!i_!|;VT|h_fzMw*CF6T<)1Qgm2EBQL*+QH5*m^G^VbH{e>nf-eW}%A#
ztfg3oW%A(4-776mpwD)4oFma9wAKrmt)4cOGrNhu#?hNHL@;~iNPNs7d0rH!#l?_g
ziDCb0#5++cE98qkdGxcj0kQ9;wp{Kij&N6&hpDqY3^*co!|**H`^{TXznQaanoYo-
zvu1}2K5(e5X{K;!$!kkPs2mgfxR@!%^u`i#`9ee6uE%l<{mpXfb4!K`<eLu7Nc-k+
z8?bm5AS>LJ<@s$Yz^nma`G$Zi12w>Z&KP9L{_ZS&r^QJ&%a!Ii$>da%q3z3~<F~;S
zCl}8(4_+3yI8{U)yf^=;G&XrU9-Kq<fxtV_>&*pwnB0>wq=X_kn1@}|NU|y?kA7^h
zvQX*6>B>5!OlRbLurA=AC=0=mt})vE6xKPLJ6D}dIJf=@%eN*wrl4-#8~=*uGS@n8
z_hdqH#9MjFNXfkX+hwaaTO%_WYm^9e)Qsk9bd-yQqv!?i>zuaqFsnFZFg<<|UhK1T
zb8c7P+K;mJx+aLbwccAl&XZOceXw77)t`Pf6dM-(se@6gzRXVV7ScUPStWs(GXKtr
z{qj~heWLqGx&hEBWC!iefRG8;Z2&f>n14r;KkV5b#sPTN;${R134_oJK$qu5M^+>`
zGbf9ps$^sZRV6Zh%W&EQPX*nhZ3<DlmhLw_^QpUayr`ZR)sd25VxOFz2boKxh#z6Y
z`y>qcMvigzWeD6{ww*OnOx5g`)ob%>r=Er&Aq#5TTVB;tqE?CWSI`GeKc@(`^~YjG
zgg>&l8mPKYIIOzm_d%SM${R_2D~|tuBFB@H>aFcrHYxZq-SVsD^?XEMp@D+tz_$#>
zdszBW&*OdTH`2-y!E?toz9i1K@ZCEvl{HA%h4gan9(tJ}y$=>3Jp!?c1c+5S7RJuM
zC!>w^N$f01ennl9f1cX;|2n;OnSRt>-=E(e(SKQg){p()x;gt$sE<DZHy;fI-#eF|
z%pg`KW>!vsZi1vp$Rf|L&DmdK{G)d%Xh5*lul-ro(u~qB9+kupkSRC5jvLD0oP``O
zGaF=qR&_GQSQZ;ja_8gIo*u4>N9D|W_dfi5374>{`&R(=gP%GHq`v|^`|9JurLP8!
zJUJpHxH%$tEVj=rJgC}`Vvc`Yo3A6MSdqQ>eDI+>cPs7_?&dr<W+^Tqj*$EZC-GTw
zbHRwrjH7YFvi(9aKYa+w)znE|FLj08<AoXwWDUu`P9*gW7EYr?4_kSr8iu>1KH(E{
zHhp9kxOP7$KlB6ASSD{fdZS04_cuBTAA)8@Xm7dl2unQ9k}9?02DvXGLG<MmraAC?
zpr!~4Z%bsS5kEcz=#_I#5m-JK`?@IXE9lQV4_g_dO!R$g#?{R!-;Z4*_1S7{$($(L
z?~uSZEwl{h3z%-3<(bA5Y_P*(eQubq)dzp#J_>X&l6$O|FPX|}K7kiZP7oT>;$P9e
zd+HqXU4D&gQ*^_&%Rh2Pjx4UYaOVBq%q*GX(7WBP>C85y#%D~<WuL8C-W8C6oktzO
z3a5e3{py`yJBo{6X9&1G^DJa>?0yIu%(GBuo-@LnHA2^4mO_hlxxCeAsh)l3mIqk=
z#J>p@5MyCw23B)_8OyH_{NFd;ioym^y!fzvfl#4y(&$lS!Q}-qUPpT8f5y_|lgD}T
z(^CLXsM5-XEA}vXsG48WyIk=qSXL6<JebINu5$CSx0A<k1?G~v&u5L#hpU9);Lp@S
zJ}VE%3E>eh9)U?FJE*aHxIA{BAW=AOb}=KUZQl1@$?LbNoy!msmBAii>mxL5AU-jp
z?fs<GiM`GGyo)!V-bHWo&?&mgUbrs>9_~!4Az*9h$E``_E7ujK3P3Ro|4uPnkRH^Z
zJqmkc09e}D0m1Vh6O`Ng7C<pT)pvp2rl~M2-z8OGURqUL9vYU@VS`L9V8eZM5+4sI
z3~T$S@!a4imDh@isbSfdRC+O1prTfx<C2+vMhi9(mwo+hrmrk#5eqM{`ab*$H(d06
z4RK`JMuRM&J&U4^r*rqTj=KC?v%3|Z?@G4oxTZ5z;n$O{!k4q2;<nWA0`x7)fJB3(
z-GIBGs0gS>!7~Bbw+SX;M}HUFhF&h4cIp7-(s0TH?v()1&D8A*Mgf}wDyjpH4sh-S
zS|KwtkVg3L${4bP0Ks^=z@qN2?LmOc`(L}N{~xA=e)qwx`})P;3*`QH|9H<%eh(Ok
zvI^NlMMGASp<(D@grNzQ7MB>58h9lOjL?Q4m1U=V%o64Tv3$G*&(Y3(pgseJ&<KRo
z*Z)FNW)K?)^gE&c2IRke<-bPNWCbnDL=b`NH~H7kDKO)IZ;@f;dj{j>xs~JnWD{O}
zk7!`hbY%u>Uf~-^j)~6HRLAmSVfzh|GRm`<>wL%-88&2#%*Hs+W7MCRoYkwk>x(ca
zQdsIRU10e6$MXk|J6?Sy71^2Q=$hURTi`F&UOANadUPHO>h9Zoh@YGFW~8&sj0HUq
z>q<Y$dGJxRv8++JueHj7p(D?Axdpt!Q=vD$#C31No__BbE~s8pRJ5J0au<i5r!Eew
z?=f8mYkDl^o6}xg>x+_^<{kAJ8XcX_zvFE^bCaebS+Ev)^eLY0*bYA5Eb%z3-VvsF
zNPVw7ybWFz=QUnU@E7pnTUG{9=H;yy6mK1oBF|74`vwrzo}KaVl}sR^3PZbHb1L9^
z5FK}nDitD5l}!4p8&9_S6X1oOB$muxKX@CHO>S^$Zla5qd6v{-yY(Tp9Wh3?A~B1=
z%Gh%I#eK4*7azC}JlH9*)C@0}RCLG|!BR?ih%0a7N46vpzjX-DBz9bycY-vEn7`SE
zjH<<yDB~|Th?|*s6;yRvyiQ}C=skXRPorGiInOV~A+qD^kXb{~3C=**3!)x{P`#mI
zySYU1S(g$cO9uU2*9GU)@xt@^rkhS9VE9S_VnUFK1jxf=cXS${AO|{|%v!d<-h;Ug
zuz+WwcN3Apx9~&wVEEyNoU__fxS~Q-pFEPMR!`pv!pX{hN&Uita8h_+^F>NFW{O^W
zHo`kQ17#$xl}tI!<(k!OAtTY4@aY-!SijW>BHFN1Y(aL0QEAW|)$uK4IhR$2j0;SI
z@nZZQa=zoY2cjZ~>(4H_KG+Ow2Q+JdRfXR>`G5TYvP%0WP~P(U&q`{RGr%(KH)Wyv
zDDm$K#+I}49)-O)0uNiq^YiH<338R64iXrG6HgWlZM@ZuP^XFBdHC7xe>`(t*#8{O
z{?!A%)=^joWQ{t{#;Q!L_Kv;MAF3}Qjamj{vChML+$=W)A>k4=fOlMddGPbr$4h$p
z?~;_bqnHi(?NN)IW8ZW;IXKCA%Sh<x-0sb9(mKKjH^X9f(IZTui^ip%?#11MMN(>h
zFFJDXfwVsh%IM;luEqPl=T&+8vRbOeZ}z{R3U5%9zK2&T?@+50zr63C#-7aRP*iUp
z9PknJ?TrQION<|q=7&??YbHDL`VnWSMBW90x}so&2^uLd?iuUN6kF?Y3b$oI$zo!}
z4^GvGe^MWO-(4{mp1OC$OcOF_PoR7LJ}bv`Fxa<X$l~QL!#(`odc&~QkZ-nq!)p1e
zdXL+5G^i~71#IOH+i)B%GO=RkFIrHe8|XCbx<+=1i58klPB=qq@oP=g8n8KjmNAfr
zUnk5Afj-M{+>56p>?+kzQ2i|R`YLyBSTop4XqZLevx08ID3p^l=bS>l{FS~1qx#F(
zXd*w}z)?X<LfdTa(;35MP5kZLMH{Pg9Z>BvPuWJOr>09;dTZr|NOkcP6(;gMnKJ&c
zxlwgk>>nu&Ov8uJ5AZTxxFA35I!0Y-WhZrg$wIF;9JtA<!=`!gx|S0EVIO(Sm{!IB
ziuAW~6u$B9;z&;^ouOwgNn*Mv<a4p#^ar+t1-je5V0Ck$_^Ln6FO=i7jX~lJ3H(W|
zyyiQJYn8e>#~<bUsZ)>eQYF_^Gbw;h>^(&q)i<m6z3Ep0+Ei@sc=l%ZG>Jq7pf9<z
z71=w=__BJ!6&wi0!H3sH-Utq~#qcagI%<XRV=0dvO3V_HKCC!!kCXQixkrSGGjsFK
z{KSlcA)1>$XEN=ULs5UJH}o_6yGTRF^fMmbwG^}{U82&iJf=jlgcro2@62Dk6gl_K
zaM$;pHo3Q;*O|bzBJB~0NtJTnJ?)h6wZ-<&_&5s@<qj1!9Jl?6{%qHnl&G$sOtZYO
z@YvN^GJ?y*Hv<a|x<v{mkfTI_Li(;FGmv>1CRSE9Hqc*z#okI^$L`i!Ia#u0768_t
zI}dysLoUZ+zonl`JM!4SIlNb&t24R~gYQfhS@G%=hCVCItZHR-=ga)GWfNl42qs%>
zjsW*t0py(KfG(=q{tpIp*c;Q>zJw1M%m~-tn<7fY&B04)aS2(wzYm^wtN2)E|AgBU
z!7rYlnQ11!bKEH3#xrqLcPt;e=3c9kdBzb90?`H*7c(0EXVpT6L}KfaruKBl$q)_1
z`gnnRiqW~R>{|LbDcs}bG>@u?>YM{KS$oyf?Y?q_kXi2R?{nG9EW57>oG?8{GVT>~
zocgj`+;`DMp7sE@DL=X`PffqZ{-^YEj}AMLHE*a~N*Ku!hXccA#SS8x7)AuSH*P}9
zn=jXc(>$Dmw}@>@8T3>L4$2139e20bK|lirQf{;T>Gy%{bO6QcXxZER|Hw+Vk46Mv
zrvFtzj;0g*E+GjS?0kjuHsU)dgyB9%uNdZ#QkVYckaV*yRy1Ux*bX>%tdk*9Lf(&H
z1J<D-W##X|ci{7P@c+}e{l~36`riNjPKNZN$xQoa^6+OWen@2gumWl{4Gk!b9W~Bv
zQ00=i8yxa4>8#%kcRxrWPGruB$?j8(y}EXkL5f3}jN0#WsF<vCGneL3dS8Ye8WkQy
zqHN&fnBD8;Qllt6=ynU~aWaakrvY9hk9y}>8Hkj?Xg?eKAF>?4u~wFlEvUa~Sjcl2
zZy<C2zi6sk$!#EJ0n!BR+;s~KE4V-LbSk<)6T8qNSzuQ{2^|v$t8ByQ^oXTu=FO5j
zHIBHR&jQ!g*+DWLPPaI?9P<gmebeQJjA+woH6Oz4X6uRe^x)KfB%dD=d_F##6gp3k
z^I!z9L>j*e={|yaTGyu86Sq!yX@VCdWv1rSLNuCG+~l{FSIx&;9V?<xs+Avy?F8*q
zAx}LTv^_@klIAg+e~Xhugu;nFYzX6?+2=y`Z&y>wW%$0u<&woD#~ZkaZFa6M-mZrO
zWv0nq;l?UP8(b|j!auw#285W?KnL4J3$V_n;mBnV9VEIL=9nnTK^;E*Ddi0E-SrXp
zW*^HW7c7E;yduuG{KLOZ%&u;z?tiRST`Yd#HIc5tlAo0d<E@1;L4M`pxv?6bgM0e)
z%Fj0}WnmYS)Cl#$XNQElNABRT;_c+uk~clQl*YSg1Fx+See7aGQTko6i=~2b;tQTI
zD}9F+EKpOs1|2?VAjqOujZJ%|v;<vISC)v%LdMqDCzzPD%J-<q@cKgBmK(R<RcM=_
zZVbHR5u|F%jgB(Qdo#@97~|x;0bF4C-?;$?z*&NTM?E2K@N2Ig*uVa}HnjZX4-f!!
z6V=^;sYe%+?1z6vOU?PImWuP@!so{iY7Y-N*|*d(maf(&VqylG&Seo^%B4-IkzPRs
ziF&!x{$9@ZMW5JkV;OX~Tjhe7$Cx9rUNIjY3LI3(A9h#WyX6v+kKEE911?bloICc9
zATIGcu>E3@0K{r+2F#B;059Vh>pR{Q(L9V_8iomY(dsfV*4eY2?a99Op1zf0#6xUW
z$JwYIC@k@yS*5)NZeQ;>M<Z_Ii$<rzK$x}|yUcLY^<iq1=X;(oZ^jwi>OK!*aQcwf
z37Svnv)f0$i3u^<#Lg`;E|}JhPYT%55TR@2mtv%=dl>Uf2#+vV8@C%i^ir79xbQTw
z@}9Cv<YdzFOpbr;8p&1rFvSb3D!O+k2k(k3jiBsB<XUlXN57~FZHOU>)M2q4{%qEC
z^)HAqD2eVSD3=LcUXNSFkAD<dd`w&W#R=h2Y=C?@vja;rSyxVF^E%#u@b%iKg<aH~
z)p@mmk+a52k9<x!MV`ssh!HjRH!(`)SDGdkXeg2UyzYuM3H^P>%2y@|B@VOaw|Gi$
zbG4%@V02%AV-B1<KyTn0fW>rxsR7=?`kmOd{sP;-(D(mB+`o(xU@HE$%A1#z9KwYL
zbf}?RnsiqwqqX=}wdFrZlD52KXD%h7?Tksv61YrWhWF2V$<pZ|*&5x-R8}tf7ExdA
z=mQf9*_+7a_Ey6ss|(e~g|?+cR$I<zA51?sVU4wtGHK!7pS>EcS-k8F6&-$_G9XTU
zc(~cjrny8dN*CYTf4;DKtDA}Kqg)XSSmJk}6xX@48h~L3po{#c6t}W8GuHbn82@?}
z?AK3>fwwMx?UUaWeO{ptvd~cfjkZwJh{AaZ;b|lu^&)47J;uX)QY=R8@K{XmT#Rd}
z(MoD+VfrE1aM$VN`Tea>76MWNd@7&%(3VyOj8M22*>K0X?0k8+&oI29DflRD70`9M
z_^YL1->3cfzN%74b{~w6Y(rg~-TmY#=LZ;_!Tl8zXUD1b_jIPUEDP}1KSW-RuG2l7
z=E-atxG;qAwh8}fo=!}hrs2Ul44O&O=AWQ`Y2P$0ps}E8-7iq|7_<Fy6E14UVKh%d
zn}sjOAsS<h9G3|mtgv3MG!d}yqFdmhTo;%sdM10*O%_`01c`e>SS8=i)_1IIC{*q2
z%VFOaOcvsJ6tJ87B$=LPgY32TaG+VxmWOSt&{X=wGxeco;>0$`1D$<n1)Ybr+ZAPt
zQ()a?)wWBbe6I%%JpE7CgC%6H2Lcf%7Hu_KI=j~yJjd-c{vXcXDM*wc+7@ivwr$(C
z-KTBa?mlgtwr$(CZQHgneeXlWyE8B1#(d;=)vn6inYs2_YZGt0u4E~TX~JcdrJcvw
zv3>w)pKYS18$<2u^!<z>S#4~X$6S-G!0Z=8Wha9{rh4Ha95RLe@zw8M8Xw?Hnqm9#
ze#doNOsx4ov+{Az&0PBLY;gab8UM|)@bBXIC29PMum2|n=0BaB{)b(p-7nMf|7wv@
z^b6blE(MXBw+K>l&<D_L!+2pr$vm+$T9F2cJT(d8#|N9D=UveugA*2LyAZ}*o8iO$
zGSU7fWmJyt1*lS6CQF-6NS#)Fo_)@pd0&?289S&yQV2zS7|;pk!}d?Ig}W+OY=^wv
zFR97y(hx=jNFh<8=ne$=N}H4vl`2nW?KuVquqaX=qB~1U_FwEi+xN&{O@8_O|0QiZ
z<^FK}N51&^9sf<titSfp%F4jW$i)0hxA;$y;(vaW|E=ZyC7%8Vh2{TTA5AgbPy-Aw
z0&Y1%?k|vBoK4)6Y$zUVmIWX|>jL}p7cWi$ay}11FPXqKI&Axq5qA=IFo)n#`gJaX
zI93QrbjXl9-N~T%Kse0FjD6q}<rfXlEea{%b_>I@7cN~hHgyb#QFG)HX#}Vu5O;^r
zNRyQvI8hEg=-<n}|0P4xQ+kK}N2LF8I@S6e|E&!98}aWAi0yyjk#?re|4YaBdwl!P
z@c%z*i~qm3Wd~m^NpB?!DNoDr_`pa%3JE=d*op?T+LE4}|2IqW1s1Xi>o*RJ-@*Lf
zi06OPUw^k+BP%**I~!|iigEf08A)2DT2%$AQF=N_dMR4ENyYz{YY-92UqQa#=j?|8
z01*A(9`!%4Cpvpa3nv?cD_$$RO^*1S5<k#6J?ot{x#MU1UfS9dj_{LV?rGq<gbrZ@
z2<OPHWer-3$Jzzv)E{5fA$HNSjei_tz5Ryd$q}OU8kOv8ly)A<u1_+xn%Uv`CVny)
z73cR<(xOw}eZ{J4jgeX`Jx9u~^GlosC-^cb>Kh9wp=O~o@bdrSUvA`zxfA%w6M`v3
zrZ(#FL^RB%;%~-kyq2Kmvduti)Xh3|!<qqe|1AWztR<yh*IQ6cGwWU^B~hf4?R+@=
zjC{?+z4&eTQSF>)&iQO>yUJewpbGf*_wjl3XS-24k7w7qb)sI9Xqz$wa>C@GS5~4Y
zn50GEY`5$m9;y=M&AfWhnH!!wy2Te=HdZwl_GS0+=M))EcXV!Dx6^EGuK~7_{$xsM
zJS*$oKLc#D9(7)IiS$OS@XUy2FYdR<u`pyG1oAa6F^xI=Z3LNV2=>&2?<}b!m)rTV
z9^dbU<G#`_s;^fF;@5vhuH^XSw_B4Yn9yuSS+!P!ex)8-xjm(y^qahlyvHJ&$)@#a
z;%$;G;f5=INIJ*%sF1P?&}rhbRuxBsb}9UE<_<JD5`FH-Y}Z|5pO)6z`Im!HJA(8+
zPNiXEzF3RNFa+9zRM~}4xyQgINhjb*sTM8xEV#JFlObt*R73$}48jvAgJLnyn%|7^
zFXEB6Gb|d$|ApihVmO(erk=SwjF2dm5hsv7p-3ZJSPxy(WUlW+{kTbl3Y)buv*CrM
z`J%FG6lxe#s6ijqP-6>p4X0xxqKx(%ss#`Log$R4CXn_kAB|EXKk6iUYlZp2@oU>v
zAG$Cl<T?VTxdz^T$Z2)15k5#a!h^Df{G-CUQ8w%cZ3i)|s4G$HLX;|?4J9;%b9d^2
zG<>!wuc7}ng@keb6(P}<Tf*pVX+Gs(=i-dIZyyJj@FBp0>A(ex#{aX|jCqb_ET68U
zTv5V+AAIoj)#8M{k>^|KF%gDl6rSHb-u|i`BtGE;(=IhjYlkc^MS9K=1JA6HWcsk!
z?~^mhJjJnOzhEU~n_Zv1D4xW)*uBxC{b$i4i=%c?zA)qdQ=QQ&L27ZL(xQ_RAEEb)
z*2nv<XZC)?2DU?evA(hK64C1(;G<GhZlaxcMkJff&kTRc(s$jYDK%0Hr8cq?zTRzd
zI=UpGDJCW8VG?pAIk)Db5`9RxFnGnvoIAQ~<gO?f%MdIwv%8ZOf7l$ws4Vu6Vk)k>
zB%>07`8zVD+ggpzLLlv;#I|YU!e3`NfAZ&`E?jd)eaqVZFWJeC=1HjCG14$$^+=0F
zC2q-QrJG_uObZIl#+f{DvFN^b8i~-Nc*2c%Ns~Hg5IX~(d6>;nI2u+ogdGCn0I3km
zWGzWH8fnPIggo#{dShV7CbhqJ&S|L8^kPrf;axJbzOv^`>O2UjGuRThVZVRJY+IsI
zJh8tthwHKo?xVaw?yOZCO7FqZl~U=s69maI)Z1wnb+01uLxEaPBEY&*xFE&{2EkRH
z`Wz%|8Hg6Um{bOT-r*W&*mbh8SHP%}>cKiWd|1XEV=?uyb#*;PL>x{xk0W|?w(G}G
zR=eMGVf5M20d!*vdC;-s$ipLRb{8ENBb#;R-dGLo!J2UpcJU^&$%WjtNFx7AD!ayd
zZ7C4bT4^`Pi&A|5%voOIHNDI19QKS(Z~Adj?bc)DLT`TQW_A9SU^z!OqLw)516y${
zR0oPlNDdYqK#W$ufr8l#z7ZrW@Ez(^_!?bz)UI&oq6md>6#)(I6=E_CCpmM5P7(EO
z{GdqW>KuVYB)R^yKm|&>K!s>ZRyuVjgG<{O6iy20rBShGPf&$X)W8sm%3qPoQa?6e
zejQ{~)$mb*cWA$S+?@Fb)5hp1>t!%W3x7};d%>PqIjWqSt?>4ex$=FVArI+M+zDYR
z_&xk$@ODm#v7E#UOM<sx0*R^scAckG7YfZ;gclUvg4(+~zBpY*<wQ-R_nwVbPc1j;
z+>w$LFO6Ivk$gVaoap%X2P9aVZosf#YSMewlE}rmJ>iwWOZmd*<JNasb1y~v0>+3M
zdr0DXz|N>EE4`iG*Iz`=TgF2hu(k)wxhIkC`c@8<?~yzYw2YiK<aW3NrWz#oR+fgT
zh?fyXlysY+cWQ7bLvmjXj7|IY7pddFEROIBI1+M@t@XAlLbfc@O*WYA@`cZA;3st}
zR@&)mbA{^dlZE~Jhr#=4s5xQ&#Jt$6Bo)NykI9Y{)*)3qX6~DtEn6Ar%^hX*=*^A1
zr!c<YgzLGTtAr|>W^RnNEyi(k3ZT|$Q9Z%+)REW>jg2hILbRCId<4%A^Xh`lY5!M&
zMsW2n2!`_&n-fb9?#(|E>f5!b89I=NMKlQan(PUmcH=z#X2&Hz+oOnWfUQ#Ya+5Z;
z%M9)|-aRKh+gSl92cN%6>n}s9%j0XL5tYSzb#Jcms42b@55a$Zx|OJR_Z3ApA!fWF
zu}6Z&p|YcI0WKZhVL?@bGQ}(P9P9RVBOKyUYG90iOjU)xb51g&P7-UQbAr|@WuceT
z%)F?qmUv260mRaL=}6L}YIHkIEK5Hw$?s)<roU6i)ftW`5uBua^y_Kg5GT|wbAH&q
z9?7E)peR%W`)FXNrj92}v>4pk%ohsg-LVUnJIUk2b3Il!fe@aRVxhURJ?vXN76$Ms
zH&aiYM`lwuA46GWeCYxn#*`W+O!5WG(+R>}dfdIF^po?Z;<dPH4vd!m&R52`J{tl&
zyHKTTW~t6IH`d6iCc|$ncbb>i+ZqipMwD5AjKOUOylhuf?Gen)BDbjJ&HV7vo}9G`
z5O1-_?#V8yx?bGcX6M>>^uo%A6L>FAHP9>KNK0jqwx$d?yVV8_nrT#sq~GwF1FYsE
zrD96hd3VhbYC~tYpu=1ev2^4)tWeNonbzo+(I!{7f+(T=r8<#~>;kG6A###sco8N#
z$NHO1N)ff+DBIu&A61HZZA-QUQ|;LH$I(WEbMjx28Xq@&IG*C4wIj_It<gP`sw>cS
zmT6N#hXk0*LM@v5;;O8WZC%k3yl?)z!lhVx`lCs|iF=8@>B384&^tDz#<_&QR1}f}
z&Y>fz4*t1bq!K*b_<B|z`<w!7^dMr)qx>3|b*Y@Yidb-O;`(in?&;&}M{T8oD=0u;
zTk%=YAryP?gPy={qTba^MSI@FexurRWy);()uj{@6fzibSTGV#I0_dVqPiW!y}1_*
z*Rq^>^L=yRkhL2f2E6LXdVH-x#n`j??qH)WM-#!no(T|N(L~@cmw3<jU*LMPR?dvz
zxXVS(diqZtK-{c#s_Ia&nI2nt1tCpYC|8RHtg(~?ZxH_?tPD6siS#5y(m!-E)qKBZ
zf&o6{itZ6CoD^L>BI=<Sui8qd>>Gdz`%!0bStXbES)*!#@BAy3iC57+B7GRPex6xG
zp}+ZaEK{PKO9W4C;fh04R~dB%MCt<A6%%*q0u^B_)j(HKI9SnVgp-JTt{zWYc0v9X
zGK|TDnK3v3+GX|P)MH-9jy5ifbrz*$5bWAS`A0gFH%bs)eH@P=$SkTDSUGC8jDm74
zhrYn16U8CETp`_HPDF6Jjt|@5I2p%!AH1D*=ha*6ST*FgjNMm{X>Z%Ly96cPf0-DA
zPv&N<3hM5>q<wxSD|IiIM@;ScRuC+gNa`S#Fjuj`V`FL70WvR(D=jN>)2x3%t^*^@
zyTY{NCJM)DJQ`vN1IL{@v#E$z8l8HIWq4Lz9jDqlB*^eCGet_CcQ-BRO=hE_DpA=|
zism`H9(awb3`_zQ`n`#;t|MoZlqC^G6_<R}tdKNCE7sGMTwxntQ}Qx(e}XhbEMi!R
zCm>RYE@^l<@d+~krCOsg%~1(O7{jP=c5|BC`d;)F3v#rbMQ4Mpfa;oCktx&t4WE}(
zL2)jIGl8eGw4QoE0*gx0v!-TCtn&GDlyCeQVa7RUQWkNg3g6KVjDr9h0Psxi@bYfp
zo$3NQWXlSSn?V9~Y7}lhwy++odVao1S_j7RAg_*S*NW&%PC>ge%E;g)zJ5zUUW27Q
z0kYUAeh9-X$p@8oYWugFHx2j7s_^0}h7n{fz`(iy5T>m%(Ktc;EK#z%XMci+hn*_g
zg=;$|bc-mGa%Uk;-bGB#^_CEMr5z$9_L_-yg1SRE=vxl)yAVY8BZz1o<N#ArcZV59
z;=(xw++S#53CGt;n6a5RN$Ate@l?VgR=sUTH-+{LiqDE$VHv+Z{re+Q<Enueft|sK
z=M5gGRaD3udNkE-0*L)f-`@-AWfcrm589Hig;K;bCMjt@gS0k&qWnqlAeI>*@q9*T
zgs=~+Vk7r-harn+VxBfG8zeP%ZCIeu0b0Z>SP8@8=2id&84n7-&uGNga`-qc4one-
zDMr~b_h+><pl-9|nIyrkk=r#8I4Vf+Suuhj37byzIyOVjS7HWMO{&_)zv+Cs@5|vI
z7{3D}K@!&~%%>1fXE}Wl#&C%-fn__(vWiWS)9vGmymlHeAZKWR(R72X!;@3>p{lO?
z^)-Pl<YlD4pgygY#9TDY;Xz3m9XLc5JGmyp!)7JS3Ol|C)<#^etSTvwY~P;kA67`e
z`(NZVMgc}k-DHn`3&NfF4>=P~dW!Ou&yWb?y^-==niOQmdmx0-w23(5?6d+YJ=Zc5
zo0d@>mgLizR~6({Pm>di;-ofZ1+ff}U4CT<G;ud4Ab012CIP3|ks5@|j9C2y|I<No
z6wF>?WZ+OK6Kw@Ul+*>`pAmXSQlqGs-D5DbB>EZ~AU_TQ622J`Qr0R)r4W_KU>h0K
z353ec&@mV>Ha<q5A9xAPX7VixO}UzxPJK)9D`w4u0K3*gfkF|?C?ca-Yx9C3!xkug
zBzR_SJb-LDHeAmf@ghXd3{)xxKy0oltPk+(I~rG;0KY!yDcKOp#X1g0*jcZHZ-mlk
zBbY<|T4>4!P^NSm?jN{RKa-Mt)fal!4vgxgq22f1ECoTTwb8QW8<Sn~xW|u>>xUI5
zM#1A^GRwLN>rBJP<*=!gK5ZaJ$*v9u>$Xe256#0}&hta0%72yF1x(Ierok&b{hc9~
zcaJZF6*g{KI3h59+MW!Zx`Z)avYCE$<>$G@=^UMYvxNPsT%D-5iP%r;m%0_vwq~m)
zZezWClVJTnPcMqrJTr@JF^aX@%@0=9Pp%hW&Dg4T2M)>m^?=HVnZplBTpCgPl}IL}
zeSWk_ED3H;3ZAZ6jEA9!b+W=Pp{m@Tr#eBeqTmeSR+SjNdHH3`6CNRRJ2r;H#l$-7
zH}~E{<NKY5F6*@wQOKQ(!-*tMP>7>N6Zd}%!3zI=Mw~FAAwoW!Di$)(x_qbShOw-2
zp&i9lNqzMNM}zt~<7=qoEsIl%f%1kgR-E!V8~(i(OsHzM$d#A59;68nsb+uWHVZn5
zNc-(KW#ZZN<+>qW{+<=x8UPaZh?Z>~_F_82!hx%Gzf(JNi!#^?GxY}U7H`TK@-cWJ
z6i8iNI}fx8>+>M>TDhh7#j>dYg1E*s8d7Vppa~U)H3(~^w%bZ)M2XI)OtnPB)|Q1h
z2*8v+#%O-TzYh{udMI^6#dTRuf(%;bz}tlslS@ee*5a=QB*Is9Z{_U#G7|&W=g8yj
z>zLTd=k3yn4d~(L`DhC}y5VN`{qhs9Zl{Zv)f$VOuoeBDD1*N?M8rf8{MY0pa1z@X
zE$+I38RfwJVxVo7lC4;l@g1C2r}#@(tX}3=QdL2n&vuK^nVP>W+v=7I2Tb|p$7Via
zMw=&4fM)LqTPZuhJh?ypvbf0KV+PA{WU0+aQwk*+(m;4KavlqRl^UD6z!w|JsL<d#
zg|m52V|VS9XKwhJZy`W`*WKPO2qOvxRV6ojAOevdY5|&b!V~H3=4tN`(L7?TPfjMG
zvXrYP#ih#GAaKXAbt#(Ys?}W1WhNa^6S$uZD<m6O-Y_6C($}~?&N3QN5VxYbc6V4M
zXHZsz5(;%BeO3MMh%30J)rx&0zNzryH@12~dP=$74{0>9JL{|u{eDU4JUV&yjXiYT
zz9*6!GX25bp7_~4g-*BG8It`Auyk6h)939x*jf-wstu>2;?1VmX{lpI#~5}NM7TO4
z-*|?&$3xZ_w)!T=<X3P0@Y!2MIOcfiwpi_K(wZAG^}*Vvc-=jPTDMVMe%eQXNyPPY
z1tdxY%$88Le)ogzzHwpcv0^4qM8b`Hru)5!!wYaE@{4(|8>#H;zHPs8D?_kt|LzxY
zSTozL;yRC1#*NPU?U1lER<}C`<w2%QUD<^rTp=y=vz5noZ96rT{)^9Zu>gIz)Xun2
zZFwP;;H!)*U^1WqCob3Jm!+EKCvx`${sa}YKW-(NbMUMT6d~20_?BM$9+oHFrqm=>
z+)RoEUycyQ5>>Gj#VO|1pLW(5Jmsv^{RDN7Bj-tLq~w9VR{0}n=E{SWQ2OZ@ew?e(
ziwKr6gm5zK4Y5P@S8011>cbw&pJ;Gomtn6|&9it8CwJw4oNh6$Azzr5jaAePTjyZ!
zH%*=2g7R(^eSR!LD;5OOVforz3&Wxb55az?WiQbBx_3Y{*N^0@J=-_wt60P4p0&Lu
zk_ntFPXD^sq<?1gD>WoO@PFX2A)r~6x59oYY!E2etACDcrXWj{U1pdF+=1_}ZZSs4
zZk$tBmB&<*&ak}^6sMQgSb0faLTFz&Sh6%g%#+P(sft&Vh7*gl-OYfjH!_Vtxq`+P
zsWa26B4qFA%<ZTWnT8Kw1x62Xo=KogP9V0*J_jGk=hfcH5Wl_DBSo5qxkb?$#J=xI
zVKtLFq&D3tlY(9*v!@jiF26dEjgz#F+mBAMTps(;JB^CqyPVXmne1=JpKyp%`dja*
z_0u#MllMj2mLsqo@>>Z`IzeIAc84>~g3Y;6Y?bD9^o$#zRU1fGWmi{{(Kq7*NGGE6
z`Uv|%vBdtMyMuU%*09j;22dLvintEG!wS-tS67b@XUYVL5fymZH;373OEl9KZr~xv
zS!-IH)h2Y_!`glHlj%Q|;)~@|dz5~|n(W}Vp1R5m=KnF4z?-Yy9w8+A5OA}Rn%C+(
z+3sEAp69ks384k{TKquc|2zvw6&8GFe_<<l)!I)--kig4aIVM?+WA}vfHWigl5Qd&
z#5j;kQQrt|Ib6fnt6MplrR5NCaPsQ@^>KE$X&o|Hnbqy=QG?T%jrIeYyXnQ5ibguq
zO_oKvp!J|Z6p~ao&6KLYgI(;n|F>zV(z%AFne2Nb)AH(I7At`jES=|-7ixBt5paDD
z_|9Y2Jwg)D$^HNu!7Gh@lRlC0!*@2w>9WAhZYp3*PVI6OB0gWD#9tMZ3(bM-f;N37
ziSJgxEC)#w+IC0=niuFbMFTd?kT~;xWSakVeQ_Fo)jeYrikzuW?1?4mNaYTTbrE%~
ze`OaZ<}21?>766N^LM!G23=38#+sJDwU-@{QkVRt+XN*^ZU-a<7r9IbE3?}Ht_xnq
zJ))<Az(Eoi_4|=-sdFT*W?_3|6p207W>AP-3ukQ~ZNgEHELN)*9fNpX9}?0wNR&lg
z<;*0JzI#z9U(YXUq>tqJ>A~I4+JB^Y&ct-|UPJzww8Y*s?MRWbK&-1J5oa6=2*wS)
z%lR+#H!hwt)Bt6&+d^fTV>i&=_VKpr{&v>hb!esedV9v1_L6L>DksNc5BQ@9Cd$U+
zf^bO>PEO_}{aJBO@#Xp2sfV-$fzcUP?uuXD1>=#Zmtu-4TZR%t(NJ$=GsUI;SW+ML
z0>}_-P7Q$Eme~^zwYx04%d9x6SlqyfDeT5KZ-pxhlJ?~F^y=nxFvIyU3J|<}iPWw7
zNKFie57V@#>d`sFal+2h%?23xtL%{5&t*6M)258=YXzo=5cq(C@crOW@ugI!lr5{J
z|Ha0!P(i$wmKs@Y67pO_@Vl^Du{B~fY7+wyC$Ms<>kW6UCRC>w+6EA_f3H|`>7upN
z0!&+L5C5O^^&S7g39!i$2HQj7WkXF}NN6kppp4=)FFd1D7=BryssM{cbKe9Iy?k!C
zEfM0A5YXj@ISAtDZ7;TdY2eMl4K$Xq`07vxI<YJ>l!mxFN~ci5>oNvlvO63smg$@I
z47V;l{Z`HtP8brSiF7YxdWr{A6IT0+P_CqoCwgs`E>YcVBLX;V86y4^Mucb*K^cDe
z@@k|ZqrbCVrDw*NTSOg%>3V~f0Ma+HZxCo)SMr482ovm+UO({vXY~$cP^*9k834fb
z*Gmoe|5kl)asD-v{cWzhgtKA0!ST$iCrCjtoL!gXN*B2WfNM=A%MF;$mSI|};S3c`
zqu5MVe~4JrDi$~5vmw9w)%F$78(K&bpHC;Zo<@g{q)h}54?mL?8nco?LqEzih6Y~u
znpt<Qd|hJDT-`Hwj;x&|nz^_$K14PHG=A<N+F1;)m|Z1#ijLBQ_*VQ*w{81rm^2u9
zenjexN*}RBCYQ4Gu#!PEt;ElXK%dZ>D_Q@nKmWr0ubbX6r%gAWHf0>+Q|cioC@5C!
zFKU~*@ix&!{8&{^;$v&b8`^ePM*Q0g$POMpg1Li;J3SKfZwaK#J%YAGG_B;YEr-D~
zmuGiti)3Ton~BsxicBspWibu$1oE5mb|&U0Z!%4)v6GZmAC*!215ehD94DFq4vI1F
zfP>y#a91|d>@2+)bTVP&n<y_zL{pCLZ5C6rkBzkTnI>YFpY(#Jur-1}y1-rYn8g_o
z1AJXZJiA}61F0R`IAhCLi&l>m!x@MNk^kiW{Bvq3{N?@aA?2iIx-)WRW;*k%k#L5v
zO;=G2(L^Mv&-xMV4lNa_+s9XNmQ?}&7Pi4A-Pm{35(3uKE=xTHef#V}eP%|_Jw@GY
zW~RD4Jj>0$gWz_ycOhW`U-ZWm^9e)lP|a+$kl3$*(-D|oW3Irt!PYdbJY!qNVr_;%
zyT(9!FdK-oiI!HaktqC9JR&MFYI@YL<qlJL|Ic-VYI3{{+~_P$n$*^|r!aoKw*SET
zj2i(>z`uQgX6p2nQb`atU;6|4fE*>YSIK^k=MwrED~?*{9vLWl2}5{NEOzmt+}u&`
zfj(T?eU#MH`T`WSy*?!={S#tzyos3UfWW=82r%}{q+cO@bbujby&rZc3kfpHUy8h&
z15ua=1NJKLNJJ_%oAq9%&WVHz{47%qUUg=q7x3YIGjuXT&<qS6lyXDl@sa2SiVTry
zd2j9`AQBq`Lj;ifK7XeYf_(e*xe8f=O{6y1C)09jrdoD4Ynb=eq`dHM$WmaxhKzRq
zhp<9T!1qd-0ZcjBX5Z}nM2Tkzju;w$V0f5AV{)BTV)4G35X+H8(wJ%pfifr3h=x24
ztb2CNj}9p})(ETe^AO;={1en^h~UU}KnrZ)P@Ci(`#d?TwB^P~W$6LISbr&i`JguL
zgXQZrcywPVCd#I9Jwb*@4h`j0GM-qXGK&I+X;|68luMRXb<1$(&Ot9+dZ%eAm`WwN
zAfgGkspYP`U_*gzF8Z088Qt#ATe@kzKUsfrdVG&~xqE<?pnE?fK5P)oR)dnTZJW{g
z3IyP7anK~PGvD`c%o~XjovKo$_sj(jEL|*G3YKfnk4-IbXH3Ali@ww4c<3XL&pp^w
z^Wc|@!W&uvbw>B1a+gG@Va?HGu$R!ZE>uDeBi`gxOaIsbBldZ+u#h_dI>%@kDW(Ow
zH62HdZGw=AEn6&%FwwImgGbaKt^TABm4Ws~%`i6!L24QV8x{%R69k7b4g{;by5!EJ
z^!jLD!=rK*J;iE9FT<RT@^sVcx;{K&;UIo|qHGQ-GW*!1iGf>y4|!CqEin|(eB~ot
zf^LHLEBo)!wNf2*f?aFCtwS7EfKL2rwVAo(Sv9JE%#OY<{ZqP(1MY(*OEa1v704z`
z4pWJI%2~L<NX0o&FapMPpn@=1vlx}X&vEflMu4l%@4IKjuDZmsj-s(p{BJ9HzA388
z9eW^4@<C&c+Tzcs<fNkbpvCFY?#c+B>q-_`-DL4W+-ae?gA<jT&j9GwjG~!+ayDYn
z0CuQ+{4n){h<f9UT(!I}hlkVgm-Ca-OW7<|#X%(=_|yZ<O5SZi6q@TuKIGuw_#9ah
zHmz~L&s9t$%^h%MDQYUK75#ly*>+B=KCg1R6$`oD_j7!1AHYAnEbm+zM^sOE?!Zmi
zxl2%!7!YyoksOzHgP2S~4hph|_G+uy65pX{G@7#G--F_xXYG71L0OucV-qe5%J3F7
z8&g<s)8%SMM~LXFngNc8_U)+?41sA**p3gBHJsOqgRb$wECh|%k&J$zJ)I9kjL}M(
zY*XxXIp=&~oHiF46^L0Qbfjg^&@x1jm#KqiZvDX$So!lCRInjeiEf9n;GCUPTbw&g
zKy;SyzBup_zTINN5`;qLYf6<(j@}4})#=c25S!%B0Zr)SG}4x=niHpRPj&Dz3-P+4
zo7yoY(0!aIr+2<wY*ykE-N>=&Z99RNP_-&6*rL}6`txYf%)Ve6XeRW&;zZ)j57gGH
zM1fq;x~YiwmQ?v$;T6W%mfh-#8@Brr1j)HuC2wxw1AiQ`7j4nQu((Z++J`H~H-Q_|
z+YwL)Fk%(I5YU~c>VbcZTT2&>1i<X+fWnY$jQhdsMuMT*4;l<K1NQZZb;BD6xgv5?
zVaxe60Vbu{(m??2h%hifrrtWAz=Yr6xH%ofLoToP671-(fR8MFPI#7n5-hx<<Qdy#
ztp*IXG9|r<QFm&uV#?|qBy@C1+V`+xWMH3eU57IbBzFv0>YbuK+#qkP^-f!7$jy0z
zI70!|dk91j!2K$cpO9Vu%C&Q#Y$|5r${WOOo=asEQUc+e<U(D+vxeWjgbmc7?&L#+
zE|u~FdI0J2@S@gwYh6R>Xt}OVQ0g>l)}Q_jGbHI)h$F$T+kbpheUx41m~KaPz45pa
zn{J03U!*b)DvN-9)_`mM6RcfAK3U4Scx0rK;7cE!%N6hE0AT8SW?8OGQ+#yAPVlnm
zG(=!9GeL@1uc?{)t_lDapk~?N9hgZsv;`{VICO}{M<F$LgP7P^$o(7Zp9E;@s?slP
za-HBk=3HQ=u;1RqV~b|Yrotowd=p`%2~1K#<VFtCXBZOh+9R5f#;`#W)O56=!MKYR
z#O~G7S4k-Yo>@&@w&|gUs7rwFAHqYn<NLK`#KSrO91(>&k!eVST2dJ$&}gVq(JR-o
zYe-)PXs5$;9c8Q?mdtRVx@(b^m*ps~sU)H79I7ZEiPJwi?b=)Qrp>U!+R=NJmJ6%J
z3O)1)8>lnZN1f-3=Wm0eW6DK7Sv&F;`5WN09HD=6VVkvX!ErR~s4<SvYm$NK-NHCY
zY+-h|fHP@R8D-LmEIDOT0!eq?AY^^vpP*-1hJellNOdzPWkB-|mFn4+D5BfyeQhWq
z&1fBkbT*+Wrm*yGfU_53y#AWDW4rzA8DUG-`zylc@#p8TDnV6cD3Yr!dfEF7+yNx>
z5NtWyQ@QN6ong&Dn%VQr1(DlchCjEp{_tNI%X~oLFt4ypjD9<wKIcYatdkA0He>+D
zfndI4?f_M!I^vS;!K1$pGwR(48swyc8yp150H$J-B$rXp;Gu*?2dNL#_A1d!i`69A
zt%r%^QxxdST=Hsbkz7G!$IiiieGi)xROlzzYdUx>!-|VI#6DN?74=-BH6U;hwUYI?
z{4GG0g7Agh3e&mi1g_T0TLNW{v=}8zXGX01iitrsRXMU;s$;i6X~tk$Zd@LJmQ%i0
zkQaxk!&oYS2-v5Z6DS8)J^t#E>+!sg6g(B&&i(sGhu8IH=($4j<{_rwfK?%1C1V}@
znEJ<+RqPmN`j!8zdLfyCE2S8IHx~!^9@#RkGcO9HxfC{Gk`eaKNvrr&o8V_DEy8~9
z{&e0m)}jglX{36C=Qt)Jp4I<EMJD&Qexbk4CzsSi#EWDBe;uxNC;t3zfoXy3ye4FZ
z*ZoPvV&FJ!vw3*VSMSgt2w!$~XOo#F87Xv?GP!lmNgJ4p{We{jGNPr(PUNOG1B#pQ
zsqBxzX7O+24FR}Bw=>DQhZm-)?JSWIwoHkX+6Zg9Fs>28RNyn<iqu%$(kx0(>tt`5
z=I%_I=IY*-VcEiW;t%a8N9_Rb4lC&=9)>MU&Y3Ta1x13DiDr~NU3}_r*%G^NUdJIR
z%hbrYOf6~Df?Enhyi#Akpgpu?ifNY&XAP5G70ilpg3Bf;9d|-!5K^<+3|`=58FQ>y
z5)eh1LL%1^dgT|&eo@?wmG8g2@2Bee0P*NUQJ~Z~S;^l(EpXC<+23%XjC=VPIHHEz
zPUGk;LKo$EV@stwtY6-?uqRd=KAyw*{O``fIl7oKF%G+rJ}VW7S|;mbtZ@sb=y`(z
zq!4PQ@SN>=96w(#{NaQ!Pn7xbHRr0d@TxX}Lw<f;!{}I#)ND&XE$v^$x>lm1K2l>G
zT<5erXZ)t;Ty1Upb$FKO2ah4Zb8>blOa*quZcG16U-f-VXi--}BRx4vgjv&2H_T3q
zpYYip=!C(iSKs9n%a`}AVcM95uV*QihRDy=^j4o;qsqxRi3=kgH5<SrcHO62OYr(b
z6!FRCjjti{OK9MmKKbf9JW;N>{<Q8{6eV32`5EO4TbI8lY!*@oI31-kHTGZf+8X3K
zv*|V^N{*H9b7_@WyU&{wv{1_nG(iQ#ul!rUc!)7AC!Ik3XR2JU3VTKl)-K08uV(u_
z`8Ji)*7~NrC4V~6LA9JM^SXvBZ@l=l1_U}6iEd+2fNB^ES&bX=<0Ja!IoJg2q-i-;
z^+z4nK?E(u4$Msl`-6+lr-IJeI+*A!f<s(ubEEe_G_L*_H?r=_S(1DQi_SfHWP;-f
zx$2s0H6$S>p2f8XNQw{DDF~I1jdr6p3$VTX&lY*QT8j1zoR*Bj$)qYWC{Qz!`w^S^
z$?05m$NF$4;smIRMx3V!@N%K0uv*bI`*Qmt#G`gvd2}P2YJ(jyTLrOAVOU4jnW8>-
zu3?k8kZ9xjfDDES6MuAM7EG0g=|4b4#<ZqqX!r3+7EO9C))BMHRQ6)AtU_F+@+rDG
zVKc~PQ?%@gJFN*n-}05XG@DJl2Zob+ucP&5XTZj+w$dv=xNulA+TMY>5iMA3UbTtU
z_PS%tYdbvt??~p$E|sg;TOYW=syqpID%c~DJ~h?!VqC|V4Yz;H45b~%1eI<C&6{r~
z_fD@#C%&9tMFAjO)mlpQe{J9OBZ-k)eBbqvRV>``)Qo!VQ#{mc$>iTpk{>pTCOpaL
zS2mocL~W>~qp^C?Oa6}IPbO`v;vgpT2%F%EAqzO1?SGL^P<}a+ed+i@)>7tR1+O!Z
z*11spUI};IJuygLA6H#dDtzE1b`r`SjT3_F4(q4h_d^M}3tN_!{mP_mUPuB;3t3gq
z>w+=*QKT3ZCzSY!EZ{OCL1<}fX1Jg>`L-+8+Y{KEo6Uqqmc>XsDhEQ4`IilZj~acZ
z4kPahz%zZDqG16R+1M~<hcB@)%q3!=krtcHdUKok)ezZ0OCn$b{bI&xb^?^#OVM&6
zIdH!yoLcU<r)(~-{)u18DGw4O(bduP?60(o1z_D;J?FbC2U!Z5ExTC_lAf%8Id__m
zxK`#~U<OD81Pxwbmvspopj$DH(0`!X#-{9Iml$UWF0zwX<geBq6cjK(-`=yyC%5@d
z_Tb+YVt&KITNS=3Zu}wGnxXsZw0%(!(^<I!@7z)Qp6!k!`)9+NqQqVD_Bzom-x*m&
ze(VDfQ-$#&!e4CpS?0@O^oOLHQGuN2?LjxMPzh;M)g`9PkU0VaYLyGP_<1Ps4sc=b
zn;lTBw=&RzIWR<Z0>2q+hVKP3tL{ijguJ><W$tkm0c)dHkwp%63TYtj0vn&p$SU-v
zASACwK9i|SvcZPSTHfp4MRh@nS$q$my4UZ!s2yl{>>sA3)eDKGn#u9amb1JYrFF`v
zC*=so{;Sw#2Y|hqY5!Tltau1^yZXQv*gGGc2;g?@tx<>kFqpO-+>Uh)L7czr&i<V6
z$QV$w7iZCGW8=TEaJ3X?oQ-Jl9ku$%1qaVan$vD$44%j))+g^|J)pCQ$UAR=0lUA2
zDmICOf9Bds2W=dy{FR?JykKGnGfMqw234&QvH@IFi!tu9t_n)9re{@^F4S~#*sv>#
zZrxE}ZB@183)g|nYu6JEBLMw2rX5@UIr#Js6e4OCmW>)Md}r-e&ybJJ;%U)wHrX*Y
z+0vJ_BoAv9-JRz;)x1nS#%$Q0_(JX(1n1)$@qB&)ZTv(NyXrx&Iqu>erf)IxJ0?-`
zudL{xKcwYgZ4S)(X_Yr$+^kczYrKh)J|D<x9!j7p?!?7IrdZ!mn^y%0bXxj7hL7FU
z8;IT8S%>jm8}G+{lI&yl1G|)M9)Fgw2kRtmgY+O@i8roBH{pA|DaI8{%P$ZBrvx3J
zvLu17LPwQ)obi3Xo8VlDd4XvlFT3L;clNz1oa!=8E5OTbsnuLhaSs}D6v)Ye2suQY
z(T4Dqj!tWj{Nr^zqe1Ie^4;HUybmP-a_)Nb$@Yk6Tvq31IbPL2P3@JNul~E}`?RzA
z7$1SGdGnk{<^2)C(`FUXL(4RJ!(9J&eoExius!leq;AuV`TnruOq^OeiGz_o4-qZM
z2RM*Ar|I1hd_}v##4Li;u@)x|A8og<?=T4LyE;31ccm=rr7wIo?me5Q*%hTNk&zwt
z>8n@!K3*<qZcps*j+y-!vsSP0uwVb!mqN{&+D-kh552}xszyDa3ueC7`)W44-&lul
zsZQ7Te^HF$gB)ty{u1Wxej9$#{a;`=S_V26I%Y;XV+$u|+W#>4r<WB~5fl+r5zJE2
zv0D&8@b1y83u8yo+b2<|RVj=`QyimJ)p8dsZClTHExjplGgExH=#X<v%thPlj_zb`
zXgJy69wLxJ6uC#uN)a<-I97HgLorpD@OP;~x|r0-*wwM`Z`kQX%(<5wr^71xYsH+J
zR0N}f$XaO}ji)v&Sc>3SKlY%^abwLvQ)>-H<wi>HN0_<<Mos8q4XK90ZWx_;R4?#*
zr;<p<JS2ZOXoxgovl24-1BO4#$;oX1-Dy)OoRit2l52khPyTrYpo<gp2I#jG0EsUe
zE5;C`kJQH!xPsUj?(e<YiMBnFByui$P?@D5b<TPyRD(SZjp?%^aynZ`pVM<uB_aMr
zYT-B5+Ee)Rc$SEG1&&7eRzJ$j!6aIs06wQv0jNT#kpmlAM9H(GgF<)MeVm|ZKK2pt
zjp7ur?2Z{_h2Lt0S$>?3E(YtSPCfq8bi^F5`ja*JB<=dQ+kW0vF}`gsz>zeis>lVh
zu|ar!I%EEGF^ab>@0l}W>^RzKv7$IpY=zccs#BR-lE1@h=<6zH>RA`1zLkZb2|m9X
zd>1Q=vH1^OO>j+W5?eB!Uuf7UAN_7lgdO&fn>!}-w<0}4JBV=G)-y@2NMyT+j>IP0
zc_16!i`j#pS&Voh$zWH#oF{2@v-9S9t=Inv*{*7IGyaET(tq&nssGz^M_ocxR0j4}
z+W9}73T}ajO}Ob1u88uN(Q=TC$;fovKRhp5b_9xH-^up$y;jl?VWLG@R>c(>=P02r
zvfR2fMWAHqr&Qw>5UuB+8ip@sYzWZ6L~W1%i%&r<@v#8-uTMeb@6=}dZ@=EJEa<nL
z`ETnU8A)MLIb~53Wof$&2AJ*(bp+0;pbWST8}=bZEQ1)E(dl+PTy0wxj$}g0i~Ae#
zbq^Md*<1wtouERei@>@r@C~6=?B52YdtHuLrz>e%FS_gs9_BVHYi>VTbu+ykaF!e3
zTi}=FKpa=H1-v*PV%#tmsRnW#eV8>lrn49&7y4Ug;|GuWU3m&1#aRlrs_!*-eMZAO
zESt46gyzmxo|CEHF?4Zt63~np1@o_!^LW6NnWuA`)8BLUy)fzGf1w)$;g{pGc4c^F
zP0K||mvY9Pm#P==3$2Ykl7fWWDb_7Amoj<z_?XHiilK%Lxid38Ho#w1_<L9A^?Le*
zxXt{fhaIorhP_Bgo4Z^+-2&Ow^Mc3%m(LV^yJ|KwVhA)!-;rU~J*;ax6w<aI?G*M*
zLy$lGa(JueHr7=Fa5mm0zNwiYtIlTMN*o-9+KiqV;#u0yG2~JmQ&2iHYDeOHaZu<g
zYC4RBvFOgGaVFCO*2Pb<2~Xz=fafv$`q+w#emomlaon=*J|NVEW;={}b4zwP`op|=
z_98m3xk4ZghS#}Wj9?}4&2#s7h~(p5x_CFa8MB+jSBQ)7ys#pPu`&G)L>2yymmH8=
zxj#o^!UOmGz4w%Qa;fWrrErNCfX1-Z<}LZ`?!PfBnE}p#Ykk)rLF|HWbys#_*!0O~
zKXW?NgQloged|vG&=jby&vB&uy~Bfcn;~|NI%e5O_d*RV+@sc`-aexGjyhuoye3gA
zqQp{?v3n4K4jW^UZxqSo7zFrOgsf2Cg&;Og`a{epD4~EfBU0%eB+wfZO{|1f8K)r~
zQz`cno|GrvvF$<KSB*Ca5qu#TD5q7U)Q3e&OmNm4!VJoL3)CG;3aLcdDRvS0Aeg;X
z#LrwHEo;`JVElnl8AcCJEuB@#v~LU7A7lU2jMBl(rw}tq;Bwc5hC;+2>1j>Wlw#Yb
zp+)5*b}k#Yx`?C^0r@i)2v)DOMrOz&cR4DCa49|XSEwMQBU&G_t0lM<s9)(8qz=lG
zEHY)E^W(qxlBbioUaKGi0Qgb@0MPummzI*Ku)LB;lGa*s{(8L+zg```z<KSdM=Lx<
z6|PjlDRhvW$XQ`%O%L=`rB0LEFEWcW5SJFrz-%}jhFKR?Koxc{I2~Deag|#ERq|P5
zBW|Ix_WZ9iCrKTgxa^16TzB<^T`c<o&JbJ5QDpRpsPrYkRetn}Ob>4c$#=<WE;H{Z
zyr<JDGuR+8q-S%9{Ug>^<iT}Un#k<q-c?4knplHTDL~G~wP^$xF3F`a6Hs7IZ-*ni
zzrQS>hV~~i4<mdZ1C#;=VAC~=DXf6y^&=kti1^!^>%x4*__~_D(cT#yo4Wm$k+V`W
z#cIyejP?S`e%V#^G=u?|V|sT1Umh4`$a>_(W+!}qyLuwGmU<+5N8nCAtVgG^;XYMk
zgQNf0`lB}Nf^+5$>1d^O9;#!U0S$m$pTOLe3JHsWqIZ@YiTvLsk^7>cW|C`?tVl9y
z;T}YujJsn+oLe{N=5+MPmj61On44E46_T5pf8;VQkypaIAFz>Ph`z$ST+s4!1Wl7&
z+6QjbZs*a4p@ypXE5Sit^&i(V<dr-*{~7}D0ZX=jds>ev(;0{qjEG=x3<5|bCIdgu
z*RGmgx(dn73GdIKV&u0!aI4f>au~j$_2)rP;pJ&bt1T>}<3rv-zh2hmf1@+QBT)z3
zrAA(bT6m`breuUA{mG?pcp6eU%8-Th(IIZQDN3-k_a3uFS3aAlhbD`|l*HVUYi{n8
z=pY@xFxtT?tYNYgF*s47LYVx?96F#f2jv0>gD=N|h{DJ3J=Rh*usZj+nOrG-x-cq5
z^_^Cqy$eDK%Xp{ObE6t+l(p;G-6&YBi9#U+`spKba}4fqZm@c-IlH&eZm(i@UkJWr
zw9~*Dif-8~&fJ&0a@$OFqg}SOFDedi%K|{!Ht^#TuF0t|BsOjql^EQS)D3tI$?L5_
z#(~fZe9ORRZhaEEU<V?-nv`AH$F#Mi)^rbj!mCa~PU%0scvd$5uu90rCAiYaCJ2iG
z3hd)Q<vQ}Ue$s$luL#8V-q%0bt6>~!Wz3UmxH>IAsW{lsVDN-5cuQAjBwQ>&89zR5
zDl$-TOt1UK9m$ipU<no#6?}?KiHgR8SUeSDz;qahKJ(?@3A5;_Ck9UjU%E>*ldn~7
zae!2&w<+mBA4O$WGC?tr5a?<;?sHg)znQt9CO)6w{xZGj;$FOWA`SF_8w<1bq^G|a
zYwQ~<NO9+2>bZ1po~iOH2qZc>HSgR=2MG511})|EN%R@~>*W8M+^S^azS(g__%e@m
zEsSQs1}7`Z>sUt|&9t@dhOKtuys?g_^~;skA~2a#f#87B$axFA(um6Ls%jdf+>*Kz
z)9}^-`ML1mZXmmL2TSNQLqx`xEj^J{RM?EE1&m_$={qtTT6z&HdLGV&)*{jWFlV8&
zVWlO8X%yS$KI~SX1yk6>pje$;c~@OLR+Alxt<zc9i2>dA?76GvTkQ@mErlFGxF$-Y
z41PCk#N6sv1jBeD6PeVe<3{2^!m_;NZ|;ewEF^a~qKTC71p+*P5p!~XN^VUum>Txs
z<@Jd{r{)m0gX1rq+?3mp8{CUoAT_JDa9KHEZ}&_<XdO+{NvVl2B+@u^wW#J+2?&|t
z_`^o$*OirGBn|^a^rZgb{B^3EYmgC6c_kA9CsM4|{97Vp0S7+Jm!%QYu;I13Ny$Vw
zLuIzlre|V0Jb4<f8z-VE5QV4DBGil>Jo~Qp3_AbTGR=5@4ol^9Vy~w8sN}?f-JD&H
z4)W+I+g_37Kv8QS3Qrz^ppKOlUF1ns0sxh}3%QSP7<&7e`{Dn@r-I!<-tK}W{Rb~i
zYPk}-@!-^5He}-MO~c(#pyN=CeF>tS&DnBYzYqc@s1A!UxJmgH6h`SyhgiD(ZD|~+
zr-R$pLH=xkPOB))Q-bM2%A$x)gM3*K@vggPMj|mC0wn0i9_6`i1}U+PUE^;zaDK<O
zi!Rjrya8Jwlqec+y0k_zTA8|Mov8%#9b>nDG9VMC%rg4pJA)*Jy9*3=)xm0r4|Vx_
zOOmDudaI2Mjwbn=xXpvs5;@F;?nGuJkPrUVgDoiA@Hfu283rpR1PUihIDOuaTAa9v
z&)~^FIh(q%bAtFpJYj3CwuKkVShV$P$E*nu-~5H6EUVlhz9J~7taXuXh1r{b&ck`q
z)Vw31ToqporTWp%^S4>m%h*nYMbwtL$LidgqA!_^iWQB)jgzj}=y%b`N^~b>E)ZrM
ze5g>Dxfo;mlReT;?3;)WF381Mo#S^!k*S`c5aOy(aL|!6PlQRw4$oo#{`9x+MVXL!
z5}3CG3K~*8&6IM;o0yrze%n6VnLH2M+OuD64kqH;IX)Mf6wMVx94MTO4DWmD@yr?W
zlyVy8Rx$-mc`@<9?A|`%i+Z*n(#RjWP_m*l!3kVeh8|&UyDTV#2ez?FRijyIz)U&x
z7@AIsoGlm~_{SCau{Bb388@d4xx|0BjTwSop*u8Jf_95@Eq5n+S;+x@HWm)Vo+mlV
z+E(Y!5^Qi!9y&{KMC4z}OOz#mm|VLvNU0_d&E)LFW)|J?wsFU{ogO`ToGuX-;5c*$
zG46E=sbzZKy=ylepg6Iedl3<FFbWy^ynfc-7nJ<CGdJwt#yC-4g+#S!e<-h8p=|uk
zYT?#d?VgN5J#~?lOUYvxNDIG$Zih=H#p+yNnQ7q&PT-Mb>0^36k!C;$>vWt6Xr_k@
zSl5e$6>o9Tn|v9vV2B{D0B(EI?-L{6H&lR8z`#izo{0a{en&G&+ZZx5mp4WZJ7$V?
zW=&We?l>4vqg{b1TDq^*BO>Jr63T}17t-W-N3b8qv;h1NJM5gCNobL;{=72j5o3b~
z-sCN(aY3#L?duss)4Xrwqgl34%w&Vlh}buvbo46ELR994fW}DdbGSDm3xXTKKFKP%
zd5v8G9ln%bt%g+3b7^S6yKF9_qaovOv?9dZ?nE9m+9+#L>IXAY3?78ZI1kyqg&DEI
z8rn_e0D~C6e28G*_!nGrqtv;R1W0OTb~ZYke|rkqtV}PWM{n|>_$RehgQ_1UgJbmf
z7yt+w$@aVv#zFPDu;&LGVpiYUL6J#qzG<&Tt#XMC(#~|krdt;&0BuAx<Q_y|MB&Il
zt0T`qQ;2leu77F5H@SRLdM6tKLnxF6%yH93^RzU*l7!o|Cu1#M?2>yDdaOn2TP)4F
z|3z<4vAV0de<OIH`Sxwj!J;_#5Io&>IcBlZ#q%qkowj^HSwnN8Z__ngI-N4X-4QF`
zVpRmlg~?Q1+j+s!BgW_@Wm47MvOe+2wF5K3OKwHT^`4r6zjEwGnf?GqwyqlR5sO=J
z?VVLRn5ALfUFhZxcJmQE#3uQ;9vt1!27~bRLusO#K2creG%ZJX5I88?V%v|Y7PO(8
zjLJ0c-i-wn!{K<J_;tLPmwvQS;Ak<cAQL;2c7nmLO571g4jHFgL4&q+Q*n#1-?&#H
z31)`MTBhhrO<|-t+_>r+aejbhAT(M-3U?wVpJdS<TxE-GEUe@rw6=4NPF%g8l_K{c
z?gh+Fhk*&@#ff3#uaZ0TfjYOsaQBr3Zd*f^^W<Bl)jiDjK~=mC)0RdGXKCAQo|=O6
zu(Xy#mIQu--C&dI95$?h_;iT3-?#V(N~q39`UP5~XzvO8@UFCWD~EVT-7T=`==Y>_
zkK2!zx&R1enacoro#!~hdoGtpn7na>{j%|+&OPM{^a?x`PBwKVo<yrXlayVYJb3mA
zCO&cIiU3Mty$U?U>VkaD*c?th0|R|fh^^rQ$0HD?uVbZlv=sN<6;^%lcWT`aimp4C
zyrG-Qt}u5@xDpCB^mmf4GB<9_{ELgz=Fky15C%^FGN|sr^{ZRbd!)D4WUA&|xQVzR
zJvYa$H8m>h`yif%BG_syOLf7LT&oNNpix16tn&D1r2i|%E!ta=m{xUIyCiY-E%5Y7
z*;t39FTyI2En)}A#y<+G=SZEcaQYY%r!3g}8v-AS6v+7oeLN^xu-8N${n=A~Swk-V
z?b%bOfd87e2ejYFD`q{M69x3|h)i@s+GAOhbrZT6EpgFkI#D?k)IS;=4Me#6y|<Oo
zBir?>e!;^DM!*`o!6eJK#M+hT)S2nlIWtz+T2^)5cP(Oktdg_#$RM<^c-~b+IEvhn
z{)2((c;@R4tNb&o4HZ<^=+oqyn9^;AhTG~*JR)&L`GEpLtk@(WMD1U8sU=K0Z))v7
z9XH&*ekIjd`W>X!_`YJ6FQ^-p#no$BHYR%bAO<D!BYa7eEkv0$M$Ek1L71FYC7=Uc
z{Y++l@}x?P;7hLUueAKj7RXoGFtx6Cjiukc-yl~jkl=)yk<4M9?0~cu%EMP<Fiq9G
zt*;l;a$VORBqWa{V!j7wy;JE~{JHjul)UN*DbtIVGD1MApvhTJr;sB~Hl|ZiXTa;+
z(yw&j?*D1+O2e8u)-beM70^B+ij+m*vb3NSvJor-il~TeidCx^LkJKdi6le?sy67Y
z2*^?|YKs=6k;Ou>in!G(Ahs1P*B!-$2dh-2v@Te+wcc-%oE$S!n9w`VGamUf?|Z(P
z`DV_XocH}c)@{p<)=2J=CCi5`T-nhoEKcLS-kK3-Y4ZNrE%QTbs=jp0%3E(bzPLQa
z@<??+Mr2e`OjCW4*SR|5-|pu#-u@$b=$#?S5%pD9*Z!sW;Mvpc<h_elANE+)x^6;n
z=ce`_7!N9DOga(n9lBdGzxkK2;fF8$t8IP>`<+5&!sxPw#t0*3cxmyOO8Je->rUU_
zGk0uV^p2IlW?7fxC5IpD3T8AbHdI8Gdu*<ZuP(~(ENO{x869Bq?+>j)yq@wuT6<Dy
zWS<)o^T*=t)g@n#wmE)8!HUeuPV_xADQ$w^-II+9w>Dp6lezD*ZOqHq6(i5DoHnzg
z>&B?&C(ll{Sws!3ljOPkHe^+7zMbbdvU%bW@zs42>$HvURp<CzT05qz`o4W4!_6e$
zsfWM6<g*7!iw?c0wYWJ_%#=hNy%~8l+BVC2)jmnsREuk6tGH9A%(x;pjh+0-pL4F<
z3I1wwT_MxPPvXW(J8!je!S2pGy!#=FQ+|%#d;Z+$_0z4~10KINC+^&v;#@W6%H>B*
zdq3J*x5lNKk!ZPmQq8TyjK(sn&XE_g=eBeYzHHm{n43Ok_rB%4#>|C^uq>N#)7@Vm
zdysc^-ih6Xqs_jYpuBJ`ESk5$^w;PaG1F!hH8_|BY#g4W@;l#?ZuKPSS<A8d%;z~*
zizYwHHEsCpMpxb){zCTV+C?2(b{*`lYCLAMb#Cf<wsB>LqbR<$Hg!nGx=ofg3_p_<
zpEni!9;}Mrnf8}UhQDv#?d#h{`)15JeDv$A11Xm2xhKRkgMKk~*jbl7#Kd2+dEpm%
ziGlC(2bY(B{AO5;(=(q@el6{b$9?;0?TAe!$q^09^QApyS<yeL-rC=FC}FOhuj{n!
zIga1VzFeIY=ihi|!_4EKck;$|71mt&ZBWm{C7pt>5BHAxPT2UBN6!z}#p%fhVf(Wn
zI_%3b=ZSYc7F))*<kv4)lk&4!k(+;#ufVY){Js3>T`fDgW@n52n3305TkeLtj+`_2
zVOHD37G70-!qqxXhkUlU+bN+Uuq3S^so`X2=l+Pq>(8ebI{Ozp9d=Z-6@|rZt9`oc
zjl_ZjQ@N`a^P{FETZ==z3nZs+JwADQw|972PvyAOk%b!`rV1{dJ{0iQC$)!n4iO}7
zw{3P$cP|;c>CV#Pq;s{Ses6LZ(Prhh+Ohp!df@%0TQ%eMCQkgsPqn`BR-LKrTtLFP
z##+unv+Qj*a~}m{k4S$MeAL{2@oO&*jd%F@&5j`>RzHbc;BfQe^P|@F@cy=aHRodc
z%;|p`o!Xu-=uDR7<{hO*YyB5>#^3$fbt}KR+w}Jlt2&;1y0%8~@YnBbg!5fif0Zap
zDLC6a`_%Xxrd!VkJ{`du2AMr}$#spA%BxSMAGb-CpP2PLa7pmcv*t6U)#KMydwl3u
zRr^E`7;*CA^m=ED+#Ng*$=m<UEQ=Z!67-F+_kTnehMzla_G1RGsBn#c*r+kPPPD|m
zc)BJc#P~If*Dc^AW++q#q$z6z5|HX*uf3v+N{RmMRTG5=9y+2F9uIz9i?`-d9GLbL
z-Vx*tGBUD94QPu>836z5y){t1j|VBKURuixd84Wogqx<bjEsV)rr@elt^mrtwx$y`
z(HhM&!S#>B08=2)jFt<NL=sG_62AfV-gb8Z+&~fBK%^ezo?!++dL#W^wR)RI$XO#4
z^s4Iw4)5ul6e|K)2~@rw{5n%&cu-mg(QJ)kHh-B2966H}LOHU%pp0Hf=`5Pd$Z7`~
z$Qc4@xlu)>Oaj3}!Vd5OXE&}Vn<o*j;0a{lN4ZoQ)0;;C9t-KI?`=~7aSv1!52~n?
z2Zxh_gJh-`n+1AiDKd}@=gAcUfl#i|5sm|qInWi>1&31H?$vS&=l0qA){G}WC>h2f
zGUB0%O8M;wLT)UOeg|$^nd6sb%t?atMPoo}5}>Yx8bzVQRi$(Vt!1K~0S5<Av+`y$
zHM&J&p*RKv_x{#F5Dx)&?Dhkz0kHvUvL1uMaNJAC0LguFkS`199BOROWMI?CTOkvr
zfRm3DMBe3EZz8P-x{NQ8BYjM%1d~3*>G_stwq(GtWxy*P{fTUDZU8+WFYpb0X(Fe9
z=psq~+_Xy!X#)5IkiH`HqJwfTVRSekIL6dYWSu9XdKSm%i)!IFzoqE5n=hbFgo>;s
zsiIPH#u$JOe!d{Z8Y`0`yG-y`l87LYNYDgAvqmHnios2%ZzlIHLe2&F6;P2JELBv>
zE<>1bL3K;h4Qin=G;gJf6j0!!A_>kjqBxO2<Ef$^IDPX{Za&ID$t4?V2t^96DrJWy
zX@tPdo(m%D8nIe<52!ZV6~*=qoE~!D_yGXjfWd*@h*CwRJU*5bnCa=|!(?fJsm#%b
z1|2>;YTPeJA`UNrgZ|)j0|7BAq~PhZGF4-q`qEs}uB&WMZ_tWlYv+c}P?cnGzHlD?
z=~h6u1#|&*`*2k$v#bq7*CY;bc1=o2;DOXVq<FO?qk5@Bq<R$##=~KE<l5vAAd?Am
z6$vs^MWy`0#sEUF%4sc55HcucYVs<bP<i5baX-^#$3^QvG#o>r>Zf&)9WfOySn+`&
zpE_&FQ}`(gbvV=s^i_u;JQ!O$Yi^$abSC6Y_`XV4R7#g|#0-3p1tW`%Oo4bYU}A~n
zjpL*;{Zx*2LoW?14|#GDPA1zS?lB5Q98~>0CbB0b13J1a2AidEucv3J)(29vtn?q2
z()s4$_khJS7$^G6iKhcG6J&$KfUuy|PN$Lxozwrm@ZP+bvUvc#<CSe`mLn-V0}2x)
z8+Dc`(wL>7TS)?Mc_!UX3U@#3mAj8{B8G=_!D4xOX{9113efdNzKWo8-Cxc;ba{Q|
zGJsEm8Vi*wDy4@rF+5C8*llTKhV^nK%30b_&~vq)fth)JS7bTRm<0jR-~ZXW5HjL;
zGLg9rxJ(N8ashZ#Q$mu01imD`znL+iBi|0?tn=`z6@3C+S5gA7dV!!kLlY9cBuX$M
z-NWr#E<psUfkXn;A#hbGAH7XV02WXdo8ig9Bftkgu_UQfE|loTY8-6Vc}wL|N#Cn$
zkbQg9Y+!*_R{iW1=|;{9r1m)s%`~O+C$-L!&zc^wED&X_7^wQ$%if)kj5kW<5GKt+
zht?JJqdE{)O;U&<IHW7wgvw)sgP^1QhG?8*fRMVVl#dNz!u0giI&>ps312LfFXIbf
zGp6<)M}PO-JFZTt503%xDxiWqC#a%Q?wLRu5M-DIuAh`2RIEsC=iWE2U8dDOr1C0+
zx`YCSt4evrgBX_!{ot(?|J7}g_%gK#O`i(D_@dT*e@bNspdW`Q1naS>dzX+67u+B?
z3?}$RYmFC4Camq5HY0#M0~L)(s;HDNJc(gBo<8tUz=Hih>TO8nBEDvGA(X)mTs<Vz
zqmqEn-6`JXB|xGRs(w;m!yx420|y;kCKFr;)z2ufmJ2|NS*G5HYo|z@Oe!X2ls?R2
zbOo?+fe3}cl`1Ob4kjrhIBxP`dBfR{LV_X`%hMf5^*uyC*xFKs4u0fNkqaYLRLXsD
z_@x_feQe3$#EI#}fsCp-ccPw?(A1>1!+le5DGlXQ6y{O*a8)S_*alGWfg!@uJT_1c
z&}fB48G~R{m_)yyh;k)bQuN~><q(qq5qqW&OS7)2aUlle2OAAPm3H~S5ZL${o~8V}
zNhyGP0~hSvHIIh6NB6$tzpH2Xvu?O;6Tn4l7*$lt8(dOc5UvMTWNns`3;8lZf+jf=
zgdTUUr|~DjIRe=bG|0yuPmH+ZJ5Au@_Xr8Vh6*Y756J%=r-K`z({%pwC8k4ai;jci
z#^p44^CV*Mf!LViL~yHdnn<Z1DG}(90U3|uTyURonoF|30bB@O!*O)ndYVSxHrWvL
zevGJbSlpeNhW%{{F{}Yz%{V@8cueElP9?=3sQod{1@|hZxpb3qG1R#jr+_=)(iE(x
z6NbYeKU^FiH=3pKSu=?74X~ZX@o^Vd8h;*aW{Fmbf8yzi)4{D)X*!eP34@f5p~kB?
z3*4oXW|1?Cm_@&yoj5A)u1TZLghMmJd;f=Cn>Z)jR*>d&3r?EJIFXnP;<&h}9*xU`
zy%Yg1@}L@+#U4%tcfO;k1i?uSA(a98;Ne_we>$3rI~*?)a)E=pfx6Y<d~iE7n$Ija
zvLWO%Kyx&l3vN_KbMb@6A3`pghYa=m^geCNaB$q7iw19+PYV8jGV8*r;g(r6wNv0i
zOcs}aV4#K5!M&PjIvrr$L`G*o&P_NG+#!i3(gRPdL_`MQmxQyxU5jWIo$&68l!f6Q
zMmP`LZHVTvACB7k<Dokhp}mK20Ni7U25^Lv-ChCo9Eb4saMeJ%y^<Aw(;lTEh&P3Q
z2~9U;ncaI+fB#)H-ZuWFEZz2;jiha>znjGy#=mi;8-76CF#g3Wj)8ydr^7G~Eg&VY
a`SdR$WH7vqMK3}_jmqJb%Dqzb*Z%<1pY$>S

literal 0
HcmV?d00001

diff --git a/litellm-proxy-extras/dist/litellm_proxy_extras-0.4.31.tar.gz b/litellm-proxy-extras/dist/litellm_proxy_extras-0.4.31.tar.gz
new file mode 100644
index 0000000000000000000000000000000000000000..64607235479efeaea303c3fe519c55ee88629a26
GIT binary patch
literal 23846
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
Z(T{%gqaXd~M?dR-{(r~;($)az0{~WDY4!jB

literal 0
HcmV?d00001

diff --git a/litellm-proxy-extras/litellm_proxy_extras/migrations/20260205144610_add_soft_budget_to_team_table/migration.sql b/litellm-proxy-extras/litellm_proxy_extras/migrations/20260205144610_add_soft_budget_to_team_table/migration.sql
new file mode 100644
index 0000000000..a64f1de342
--- /dev/null
+++ b/litellm-proxy-extras/litellm_proxy_extras/migrations/20260205144610_add_soft_budget_to_team_table/migration.sql
@@ -0,0 +1,3 @@
+-- AlterTable
+ALTER TABLE "LiteLLM_TeamTable" ADD COLUMN     "soft_budget" DOUBLE PRECISION;
+