revenium-python-sdk 0.1.5__tar.gz → 0.1.6__tar.gz

{revenium_python_sdk-0.1.5/revenium_python_sdk.egg-info → revenium_python_sdk-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: revenium-python-sdk
-Version: 0.1.5
+Version: 0.1.6
 Summary: The official Revenium Python SDK — unified AI metering middleware for OpenAI, Anthropic, Google, Ollama, LiteLLM, Perplexity, and fal.ai.
 Author-email: Revenium <support@revenium.io>
 License: MIT
@@ -194,7 +194,7 @@ import revenium_middleware_openai  # Auto-initializes on import
 
 client = openai.OpenAI()
 response = client.chat.completions.create(
-    model="gpt-5.5",
+    model="gpt-4o-mini",
     messages=[{"role": "user", "content": "Hello!"}]
 )
 print(response.choices[0].message.content)
@@ -244,7 +244,7 @@ client = openai.OpenAI()
 
 # Basic chat completion
 response = client.chat.completions.create(
-    model="gpt-5.5",
+    model="gpt-4o-mini",
     messages=[{"role": "user", "content": "Hello!"}],
     usage_metadata={
         "organizationName": "AcmeCorp",
@@ -256,7 +256,7 @@ response = client.chat.completions.create(
 
 # Streaming
 stream = client.chat.completions.create(
-    model="gpt-5.5",
+    model="gpt-4o-mini",
     messages=[{"role": "user", "content": "Tell me a story"}],
     stream=True
 )
@@ -547,7 +547,7 @@ litellm.api_base = os.getenv("LITELLM_PROXY_URL")
 litellm.api_key = os.getenv("LITELLM_API_KEY")
 
 response = litellm.completion(
-    model="gpt-5.5",
+    model="gpt-4o-mini",
     messages=[{"role": "user", "content": "Hello!"}],
     usage_metadata={
         "organizationName": "AcmeCorp",
@@ -705,7 +705,7 @@ handler = ReveniumCallbackHandler(
     agent_name="support_agent"
 )
 
-llm = ChatOpenAI(model="gpt-5.5", callbacks=[handler])
+llm = ChatOpenAI(model="gpt-4o-mini", callbacks=[handler])
 response = llm.invoke("Hello!")
 ```
 
@@ -744,7 +744,7 @@ result = agent.invoke(
 from revenium_middleware_langchain import AsyncReveniumCallbackHandler
 
 handler = AsyncReveniumCallbackHandler(trace_id="async-session")
-llm = ChatOpenAI(model="gpt-5.5", callbacks=[handler])
+llm = ChatOpenAI(model="gpt-4o-mini", callbacks=[handler])
 response = await llm.ainvoke("Hello!")
 ```
 
@@ -790,7 +790,7 @@ Add business context to any API call by passing a `usage_metadata` dictionary. A
 
 ```python
 response = client.chat.completions.create(
-    model="gpt-5.5",
+    model="gpt-4o-mini",
     messages=[{"role": "user", "content": "Hello!"}],
     usage_metadata={
         "trace_id": "conv-28a7e9d4",
@@ -812,7 +812,7 @@ response = client.chat.completions.create(
 )
 ```
 
-**Deprecation notice:** The old field names `organizationId`, `organization_id`, `productId`, and `product_id` are still supported for backward compatibility but are deprecated. Use `organizationName` and `productName` for new implementations.
+**Deprecation notice:** The legacy field aliases `organizationId`, `organization_id`, `productId`, and `product_id` are accepted by this SDK only as an input-layer convenience and emit a `DeprecationWarning`. The Revenium backend no longer accepts them — they are translated to `organizationName` / `productName` before the wire call. Migrate to `organization_name` / `organizationName` and `product_name` / `productName` now; the input-layer aliases will be removed in the next major release.
 
 **API Reference:** [Complete metadata field documentation](https://revenium.readme.io/reference/meter_ai_completion)
 
@@ -853,7 +853,7 @@ REVENIUM_TRACE_TYPE=customer-support
 
 ```python
 response = client.chat.completions.create(
-    model="gpt-5.5",
+    model="gpt-4o-mini",
     messages=[{"role": "user", "content": "Hello!"}],
     usage_metadata={
         "environment": "production",
@@ -877,7 +877,7 @@ workflow_id = str(uuid.uuid4())
 
 # Step 1: Parent operation
 parent_response = client.chat.completions.create(
-    model="gpt-5.5",
+    model="gpt-4o-mini",
     messages=[{"role": "user", "content": "Analyze this document"}],
     usage_metadata={
         "trace_id": "analysis-session-456",
@@ -888,7 +888,7 @@ parent_response = client.chat.completions.create(
 
 # Step 2: Child operation linked to parent
 child_response = client.chat.completions.create(
-    model="gpt-5.5",
+    model="gpt-4o-mini",
     messages=[{"role": "user", "content": "Summarize findings"}],
     usage_metadata={
         "trace_id": "analysis-session-456",
@@ -919,7 +919,7 @@ from revenium_middleware import revenium_metadata
 def handle_customer_query(question: str) -> str:
     # All API calls automatically include the decorator metadata
     response = client.chat.completions.create(
-        model="gpt-5.5",
+        model="gpt-4o-mini",
         messages=[{"role": "user", "content": question}]
     )
     return response.choices[0].message.content
@@ -958,13 +958,13 @@ def outer_function():
 def mixed_metadata():
     # Uses decorator metadata
     response1 = client.chat.completions.create(
-        model="gpt-5.5",
+        model="gpt-4o-mini",
         messages=[{"role": "user", "content": "Hello"}]
     )
 
     # API-level metadata overrides decorator's task_type
     response2 = client.chat.completions.create(
-        model="gpt-5.5",
+        model="gpt-4o-mini",
         messages=[{"role": "user", "content": "Hello"}],
         usage_metadata={
             "task_type": "special-override",  # Overrides decorator
@@ -993,7 +993,7 @@ from revenium_middleware import revenium_meter, revenium_metadata
 def premium_feature(prompt: str) -> str:
     # This WILL be metered (decorated with @revenium_meter)
     response = client.chat.completions.create(
-        model="gpt-5.5",
+        model="gpt-4o-mini",
         messages=[{"role": "user", "content": prompt}]
     )
     return response.choices[0].message.content
@@ -1001,7 +1001,7 @@ def premium_feature(prompt: str) -> str:
 def free_feature(prompt: str) -> str:
     # This will NOT be metered (no @revenium_meter decorator)
     response = client.chat.completions.create(
-        model="gpt-5.5",
+        model="gpt-4o-mini",
         messages=[{"role": "user", "content": prompt}]
     )
     return response.choices[0].message.content
@@ -1087,7 +1087,7 @@ from openai import OpenAI
 
 client = OpenAI()
 response = client.chat.completions.create(
-    model="gpt-5.5",
+    model="gpt-4o-mini",
     messages=[
         {"role": "system", "content": "You are a helpful assistant."},
         {"role": "user", "content": "What is the capital of France?"}
@@ -1109,62 +1109,6 @@ Prompt capture works with both streaming and non-streaming requests, and with mu
 
 ---
 
-## Terminal Summary Output
-
-Display a cost and usage summary in your terminal after each API request. Useful for development, debugging, and monitoring AI costs in real-time.
-
-### Configuration
-
-| Environment Variable | Values | Description |
-|---------------------|--------|-------------|
-| `REVENIUM_PRINT_SUMMARY` | `false` (default), `true` or `human`, `json` | Controls output format |
-| `REVENIUM_TEAM_ID` | Your team ID | Required to fetch and display cost information |
-
-```bash
-# Enable human-readable output
-export REVENIUM_PRINT_SUMMARY=human
-
-# Required for cost display (find in Revenium web app)
-export REVENIUM_TEAM_ID=your-team-id-here
-```
-
-### Human-Readable Format
-
-```
-============================================================
-REVENIUM USAGE SUMMARY
-============================================================
-Model: gpt-5.5
-Provider: OPENAI
-Duration: 1.23s
-
-Token Usage:
-  Input Tokens:  150
-  Output Tokens: 250
-  Total Tokens:  400
-
-Cost: $0.000045
-
-Trace ID: abc-123
-============================================================
-```
-
-### JSON Format
-
-```json
-{"model":"gpt-5.5","provider":"OPENAI","durationSeconds":1.23,"inputTokenCount":150,"outputTokenCount":250,"totalTokenCount":400,"cost":0.000045,"costStatus":"available","traceId":"abc-123"}
-```
-
-### Cost Status
-
-| Scenario | Display |
-|----------|---------|
-| Cost available | `$0.000045` |
-| `REVENIUM_TEAM_ID` set, cost pending | `Pending (aggregating... check Revenium dashboard)` |
-| `REVENIUM_TEAM_ID` not set | `Add REVENIUM_TEAM_ID to see pricing` |
-
----
-
 ## Cost Controls / Enforcement
 
 Block outbound provider requests client-side when a Revenium cost control trips. When the circuit breaker is enabled, the middleware polls compiled enforcement rules from the Revenium API in a background daemon thread and raises `BudgetExceededError` **before** the upstream call, preventing spend beyond the configured limit.
@@ -1243,7 +1187,7 @@ client = openai.OpenAI()
 
 try:
     response = client.chat.completions.create(
-        model="gpt-5.5",
+        model="gpt-4o-mini",
         messages=[{"role": "user", "content": "Summarize the meeting notes"}],
     )
 except BudgetExceededError as exc:
@@ -1282,9 +1226,8 @@ See [`examples/openai/openai_blocking_demo.py`](examples/openai/openai_blocking_
 | `REVENIUM_METERING_BASE_URL` | `https://api.revenium.ai` | Revenium API endpoint |
 | `REVENIUM_LOG_LEVEL` | `INFO` | Log level: `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL` |
 | `REVENIUM_CAPTURE_PROMPTS` | `false` | Enable prompt capture |
-| `REVENIUM_PRINT_SUMMARY` | `false` | Terminal output: `false`, `true`/`human`, `json` |
 | `REVENIUM_SELECTIVE_METERING` | `false` | Only meter `@revenium_meter` decorated functions |
-| `REVENIUM_TEAM_ID` | - | Team ID for cost display in terminal summary |
+| `REVENIUM_TEAM_ID` | - | Team ID for cost lookups |
 | `REVENIUM_ENVIRONMENT` | - | Deployment environment (auto-detects from `ENVIRONMENT`, `DEPLOYMENT_ENV`) |
 | `REVENIUM_REGION` | - | Cloud region (auto-detects from `AWS_REGION`, `AZURE_REGION`, `GCP_REGION`) |
 | `REVENIUM_CREDENTIAL_ALIAS` | - | Human-readable API key name |

{revenium_python_sdk-0.1.5 → revenium_python_sdk-0.1.6}/README.md

@@ -106,7 +106,7 @@ import revenium_middleware_openai  # Auto-initializes on import
 
 client = openai.OpenAI()
 response = client.chat.completions.create(
-    model="gpt-5.5",
+    model="gpt-4o-mini",
     messages=[{"role": "user", "content": "Hello!"}]
 )
 print(response.choices[0].message.content)
@@ -156,7 +156,7 @@ client = openai.OpenAI()
 
 # Basic chat completion
 response = client.chat.completions.create(
-    model="gpt-5.5",
+    model="gpt-4o-mini",
     messages=[{"role": "user", "content": "Hello!"}],
     usage_metadata={
         "organizationName": "AcmeCorp",
@@ -168,7 +168,7 @@ response = client.chat.completions.create(
 
 # Streaming
 stream = client.chat.completions.create(
-    model="gpt-5.5",
+    model="gpt-4o-mini",
     messages=[{"role": "user", "content": "Tell me a story"}],
     stream=True
 )
@@ -459,7 +459,7 @@ litellm.api_base = os.getenv("LITELLM_PROXY_URL")
 litellm.api_key = os.getenv("LITELLM_API_KEY")
 
 response = litellm.completion(
-    model="gpt-5.5",
+    model="gpt-4o-mini",
     messages=[{"role": "user", "content": "Hello!"}],
     usage_metadata={
         "organizationName": "AcmeCorp",
@@ -617,7 +617,7 @@ handler = ReveniumCallbackHandler(
     agent_name="support_agent"
 )
 
-llm = ChatOpenAI(model="gpt-5.5", callbacks=[handler])
+llm = ChatOpenAI(model="gpt-4o-mini", callbacks=[handler])
 response = llm.invoke("Hello!")
 ```
 
@@ -656,7 +656,7 @@ result = agent.invoke(
 from revenium_middleware_langchain import AsyncReveniumCallbackHandler
 
 handler = AsyncReveniumCallbackHandler(trace_id="async-session")
-llm = ChatOpenAI(model="gpt-5.5", callbacks=[handler])
+llm = ChatOpenAI(model="gpt-4o-mini", callbacks=[handler])
 response = await llm.ainvoke("Hello!")
 ```
 
@@ -702,7 +702,7 @@ Add business context to any API call by passing a `usage_metadata` dictionary. A
 
 ```python
 response = client.chat.completions.create(
-    model="gpt-5.5",
+    model="gpt-4o-mini",
     messages=[{"role": "user", "content": "Hello!"}],
     usage_metadata={
         "trace_id": "conv-28a7e9d4",
@@ -724,7 +724,7 @@ response = client.chat.completions.create(
 )
 ```
 
-**Deprecation notice:** The old field names `organizationId`, `organization_id`, `productId`, and `product_id` are still supported for backward compatibility but are deprecated. Use `organizationName` and `productName` for new implementations.
+**Deprecation notice:** The legacy field aliases `organizationId`, `organization_id`, `productId`, and `product_id` are accepted by this SDK only as an input-layer convenience and emit a `DeprecationWarning`. The Revenium backend no longer accepts them — they are translated to `organizationName` / `productName` before the wire call. Migrate to `organization_name` / `organizationName` and `product_name` / `productName` now; the input-layer aliases will be removed in the next major release.
 
 **API Reference:** [Complete metadata field documentation](https://revenium.readme.io/reference/meter_ai_completion)
 
@@ -765,7 +765,7 @@ REVENIUM_TRACE_TYPE=customer-support
 
 ```python
 response = client.chat.completions.create(
-    model="gpt-5.5",
+    model="gpt-4o-mini",
     messages=[{"role": "user", "content": "Hello!"}],
     usage_metadata={
         "environment": "production",
@@ -789,7 +789,7 @@ workflow_id = str(uuid.uuid4())
 
 # Step 1: Parent operation
 parent_response = client.chat.completions.create(
-    model="gpt-5.5",
+    model="gpt-4o-mini",
     messages=[{"role": "user", "content": "Analyze this document"}],
     usage_metadata={
         "trace_id": "analysis-session-456",
@@ -800,7 +800,7 @@ parent_response = client.chat.completions.create(
 
 # Step 2: Child operation linked to parent
 child_response = client.chat.completions.create(
-    model="gpt-5.5",
+    model="gpt-4o-mini",
     messages=[{"role": "user", "content": "Summarize findings"}],
     usage_metadata={
         "trace_id": "analysis-session-456",
@@ -831,7 +831,7 @@ from revenium_middleware import revenium_metadata
 def handle_customer_query(question: str) -> str:
     # All API calls automatically include the decorator metadata
     response = client.chat.completions.create(
-        model="gpt-5.5",
+        model="gpt-4o-mini",
         messages=[{"role": "user", "content": question}]
     )
     return response.choices[0].message.content
@@ -870,13 +870,13 @@ def outer_function():
 def mixed_metadata():
     # Uses decorator metadata
     response1 = client.chat.completions.create(
-        model="gpt-5.5",
+        model="gpt-4o-mini",
         messages=[{"role": "user", "content": "Hello"}]
     )
 
     # API-level metadata overrides decorator's task_type
     response2 = client.chat.completions.create(
-        model="gpt-5.5",
+        model="gpt-4o-mini",
         messages=[{"role": "user", "content": "Hello"}],
         usage_metadata={
             "task_type": "special-override",  # Overrides decorator
@@ -905,7 +905,7 @@ from revenium_middleware import revenium_meter, revenium_metadata
 def premium_feature(prompt: str) -> str:
     # This WILL be metered (decorated with @revenium_meter)
     response = client.chat.completions.create(
-        model="gpt-5.5",
+        model="gpt-4o-mini",
         messages=[{"role": "user", "content": prompt}]
     )
     return response.choices[0].message.content
@@ -913,7 +913,7 @@ def premium_feature(prompt: str) -> str:
 def free_feature(prompt: str) -> str:
     # This will NOT be metered (no @revenium_meter decorator)
     response = client.chat.completions.create(
-        model="gpt-5.5",
+        model="gpt-4o-mini",
         messages=[{"role": "user", "content": prompt}]
     )
     return response.choices[0].message.content
@@ -999,7 +999,7 @@ from openai import OpenAI
 
 client = OpenAI()
 response = client.chat.completions.create(
-    model="gpt-5.5",
+    model="gpt-4o-mini",
     messages=[
         {"role": "system", "content": "You are a helpful assistant."},
         {"role": "user", "content": "What is the capital of France?"}
@@ -1021,62 +1021,6 @@ Prompt capture works with both streaming and non-streaming requests, and with mu
 
 ---
 
-## Terminal Summary Output
-
-Display a cost and usage summary in your terminal after each API request. Useful for development, debugging, and monitoring AI costs in real-time.
-
-### Configuration
-
-| Environment Variable | Values | Description |
-|---------------------|--------|-------------|
-| `REVENIUM_PRINT_SUMMARY` | `false` (default), `true` or `human`, `json` | Controls output format |
-| `REVENIUM_TEAM_ID` | Your team ID | Required to fetch and display cost information |
-
-```bash
-# Enable human-readable output
-export REVENIUM_PRINT_SUMMARY=human
-
-# Required for cost display (find in Revenium web app)
-export REVENIUM_TEAM_ID=your-team-id-here
-```
-
-### Human-Readable Format
-
-```
-============================================================
-REVENIUM USAGE SUMMARY
-============================================================
-Model: gpt-5.5
-Provider: OPENAI
-Duration: 1.23s
-
-Token Usage:
-  Input Tokens:  150
-  Output Tokens: 250
-  Total Tokens:  400
-
-Cost: $0.000045
-
-Trace ID: abc-123
-============================================================
-```
-
-### JSON Format
-
-```json
-{"model":"gpt-5.5","provider":"OPENAI","durationSeconds":1.23,"inputTokenCount":150,"outputTokenCount":250,"totalTokenCount":400,"cost":0.000045,"costStatus":"available","traceId":"abc-123"}
-```
-
-### Cost Status
-
-| Scenario | Display |
-|----------|---------|
-| Cost available | `$0.000045` |
-| `REVENIUM_TEAM_ID` set, cost pending | `Pending (aggregating... check Revenium dashboard)` |
-| `REVENIUM_TEAM_ID` not set | `Add REVENIUM_TEAM_ID to see pricing` |
-
----
-
 ## Cost Controls / Enforcement
 
 Block outbound provider requests client-side when a Revenium cost control trips. When the circuit breaker is enabled, the middleware polls compiled enforcement rules from the Revenium API in a background daemon thread and raises `BudgetExceededError` **before** the upstream call, preventing spend beyond the configured limit.
@@ -1155,7 +1099,7 @@ client = openai.OpenAI()
 
 try:
     response = client.chat.completions.create(
-        model="gpt-5.5",
+        model="gpt-4o-mini",
         messages=[{"role": "user", "content": "Summarize the meeting notes"}],
     )
 except BudgetExceededError as exc:
@@ -1194,9 +1138,8 @@ See [`examples/openai/openai_blocking_demo.py`](examples/openai/openai_blocking_
 | `REVENIUM_METERING_BASE_URL` | `https://api.revenium.ai` | Revenium API endpoint |
 | `REVENIUM_LOG_LEVEL` | `INFO` | Log level: `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL` |
 | `REVENIUM_CAPTURE_PROMPTS` | `false` | Enable prompt capture |
-| `REVENIUM_PRINT_SUMMARY` | `false` | Terminal output: `false`, `true`/`human`, `json` |
 | `REVENIUM_SELECTIVE_METERING` | `false` | Only meter `@revenium_meter` decorated functions |
-| `REVENIUM_TEAM_ID` | - | Team ID for cost display in terminal summary |
+| `REVENIUM_TEAM_ID` | - | Team ID for cost lookups |
 | `REVENIUM_ENVIRONMENT` | - | Deployment environment (auto-detects from `ENVIRONMENT`, `DEPLOYMENT_ENV`) |
 | `REVENIUM_REGION` | - | Cloud region (auto-detects from `AWS_REGION`, `AZURE_REGION`, `GCP_REGION`) |
 | `REVENIUM_CREDENTIAL_ALIAS` | - | Human-readable API key name |

{revenium_python_sdk-0.1.5 → revenium_python_sdk-0.1.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "revenium-python-sdk"
-version = "0.1.5"
+version = "0.1.6"
 description = "The official Revenium Python SDK — unified AI metering middleware for OpenAI, Anthropic, Google, Ollama, LiteLLM, Perplexity, and fal.ai."
 readme = "README.md"
 requires-python = ">=3.8"

{revenium_python_sdk-0.1.5 → revenium_python_sdk-0.1.6}/revenium_middleware/_core/config.py

@@ -8,13 +8,10 @@ this via class inheritance and re-export symbols for backward compatibility.
 
 import logging
 import os
-from typing import Set, Literal, Union, Optional
+from typing import Set, Optional
 
 logger = logging.getLogger(__name__)
 
-# Type alias for summary format
-SummaryFormat = Literal["human", "json"]
-
 
 class Config:
     """Shared configuration constants for all Revenium middleware providers."""
@@ -65,13 +62,9 @@ class Config:
     CAPTURE_PROMPTS: bool = False
     MAX_PROMPT_LENGTH: int = 50_000  # Maximum characters per prompt field
 
-    # Terminal summary settings
-    ENV_REVENIUM_PRINT_SUMMARY: str = "REVENIUM_PRINT_SUMMARY"
+    # Revenium API targeting
     ENV_REVENIUM_TEAM_ID: str = "REVENIUM_TEAM_ID"
     ENV_REVENIUM_BASE_URL: str = "REVENIUM_METERING_BASE_URL"
-    SUMMARY_RETRY_ATTEMPTS: int = 3
-    SUMMARY_RETRY_DELAY: float = 2.0
-    SUMMARY_API_TIMEOUT: float = 5.0
     DEFAULT_BASE_URL: str = "https://api.revenium.ai"
 
     # Enforcement / circuit breaker — see _core/enforcement.py.
@@ -139,38 +132,6 @@ def get_timeout_config() -> dict:
     }
 
 
-def parse_print_summary_value(value: Optional[str]) -> Union[bool, SummaryFormat]:
-    """
-    Parse REVENIUM_PRINT_SUMMARY environment variable value.
-
-    Returns:
-        False if disabled, 'human' or 'json' if enabled
-    """
-    if value is None:
-        return False
-
-    value_lower = value.lower().strip()
-
-    if value_lower in ('false', '0', 'no', 'off', 'disabled', ''):
-        return False
-    elif value_lower in ('true', '1', 'yes', 'on', 'enabled', 'human'):
-        return 'human'
-    elif value_lower == 'json':
-        return 'json'
-    else:
-        logger.warning(
-            f"Invalid REVENIUM_PRINT_SUMMARY value '{value}'. "
-            f"Expected 'true', 'human', 'json', or 'false'. Defaulting to disabled."
-        )
-        return False
-
-
-def get_print_summary_config() -> Union[bool, SummaryFormat]:
-    """Get print summary configuration from environment."""
-    value = get_config_value(Config.ENV_REVENIUM_PRINT_SUMMARY)
-    return parse_print_summary_value(value)
-
-
 def get_team_id() -> Optional[str]:
     """Get Revenium team ID from environment."""
     return get_config_value(Config.ENV_REVENIUM_TEAM_ID)

{revenium_python_sdk-0.1.5 → revenium_python_sdk-0.1.6}/revenium_middleware/_core/fields.py

@@ -1,5 +1,6 @@
 import logging
-from typing import Any, Dict, Mapping, Optional
+import warnings
+from typing import Any, Dict, Mapping, Optional, Set, Tuple
 
 logger = logging.getLogger(__name__)
 
@@ -10,6 +11,21 @@ AGENTIC_JOB_FIELD_MAP = {
     "agenticJobVersion": ("agentic_job_version", "agenticJobVersion"),
 }
 
+# Tracks (old_field, new_field) pairs already warned about in this process,
+# so high-volume callers don't get a deprecation log flood per call.
+_WARNED_DEPRECATED_FIELDS: Set[Tuple[str, str]] = set()
+
+
+def _reset_deprecation_warning_cache() -> None:
+    """Clear the once-per-key deprecation-warning gate.
+
+    Intended for test isolation — production callers should not need this.
+    Test suites with autouse fixtures call this before each test so that tests
+    which assert a warning fires on a specific call do not bleed across each
+    other.
+    """
+    _WARNED_DEPRECATED_FIELDS.clear()
+
 
 def extract_field_with_fallback(
     source: Mapping[str, Any],
@@ -29,11 +45,17 @@ def extract_field_with_fallback(
 
     if source.get(old_snake) or source.get(old_camel):
         if not (source.get(new_snake) or source.get(new_camel)):
-            logger.warning(
-                "Fields '%s' and '%s' are deprecated. Use '%s' or '%s' instead. "
-                "The old fields will be removed in a future version.",
-                old_camel, old_snake, new_camel, new_snake,
-            )
+            key = (old_camel, new_camel)
+            if key not in _WARNED_DEPRECATED_FIELDS:
+                _WARNED_DEPRECATED_FIELDS.add(key)
+                msg = (
+                    "Fields '%s' and '%s' are deprecated and are no longer "
+                    "accepted by the Revenium backend. The SDK is translating to "
+                    "'%s' for this call. Use '%s' or '%s' instead. The "
+                    "input-layer aliases will be removed in the next major release."
+                )
+                logger.warning(msg, old_camel, old_snake, new_camel, new_camel, new_snake)
+                warnings.warn(msg % (old_camel, old_snake, new_camel, new_camel, new_snake), DeprecationWarning, stacklevel=3)
 
     return value
 

{revenium_python_sdk-0.1.5 → revenium_python_sdk-0.1.6}/revenium_middleware/anthropic/config.py

@@ -7,12 +7,9 @@ Extends shared core config with Anthropic-specific settings.
 from revenium_middleware._core.config import (  # noqa: F401
     Config as _CoreConfig,
     SecurityConfig,
-    SummaryFormat,
     get_config_value,
     is_debug_enabled,
     get_timeout_config,
-    parse_print_summary_value,
-    get_print_summary_config,
     get_team_id,
     get_base_url,
 )