veris-ai 1.10.0__tar.gz → 1.10.1__tar.gz

{veris_ai-1.10.0 → veris_ai-1.10.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: veris-ai
-Version: 1.10.0
+Version: 1.10.1
 Summary: A Python package for Veris AI tools
 Project-URL: Homepage, https://github.com/veris-ai/veris-python-sdk
 Project-URL: Bug Tracker, https://github.com/veris-ai/veris-python-sdk/issues
@@ -151,7 +151,7 @@ What this enables:
 
 End-to-end propagation with the simulator:
 - The simulator injects W3C headers when connecting to your FastAPI MCP endpoints
-- The SDK injects W3C headers on `/api/v2/tool_mock` and logging requests back to the simulator
+- The SDK injects W3C headers on `/v2/tool_mock` and logging requests back to the simulator
 - Result: customer agent spans and tool mocks appear under the same distributed trace
 
 ## Function Mocking
@@ -212,6 +212,58 @@ async def get_data() -> dict:
 
 **Implementation**: See [`src/veris_ai/tool_mock.py`](src/veris_ai/tool_mock.py) for decorator logic and API integration.
 
+### Core Instrument
+
+Instrument OpenAI agents without changing tool code by using the SDK's Runner (extends OpenAI's Runner) and an optional VerisConfig for fine control.
+
+Requirements:
+- Install extras: `uv add "veris-ai[agents]"`
+- Set `ENV=simulation` to enable mock behavior (otherwise passes through)
+
+Minimal usage:
+
+```python
+from veris_ai import Runner
+
+result = await Runner.run(agent, "What's 10 + 5?")
+```
+
+Select tools to intercept (include/exclude):
+
+```python
+from veris_ai import Runner, VerisConfig
+
+config = VerisConfig(include_tools=["calculator", "search_web"])  # or exclude_tools=[...]
+result = await Runner.run(agent, "Process this", veris_config=config)
+```
+
+Per‑tool behavior via ToolCallOptions:
+
+```python
+from veris_ai import Runner, VerisConfig, ToolCallOptions, ResponseExpectation
+
+config = VerisConfig(
+    tool_options={
+        "calculator": ToolCallOptions(
+            response_expectation=ResponseExpectation.REQUIRED,
+            cache_response=True,
+            mode="tool",
+        ),
+        "search_web": ToolCallOptions(
+            response_expectation=ResponseExpectation.NONE,
+            cache_response=False,
+            mode="spy",
+        ),
+    }
+)
+
+result = await Runner.run(agent, "Calculate and search", veris_config=config)
+```
+
+Notes:
+- Runner is a drop‑in enhancement over OpenAI's Runner (full details in [OpenAI Agents Integration](#openai-agents-integration))
+- See complete examples in [`examples/openai_agents_example.py`](examples/openai_agents_example.py)
+
 ## OpenAI Agents Integration
 
 **Semantic Tag**: `openai-agents`

{veris_ai-1.10.0 → veris_ai-1.10.1}/README.md

@@ -108,7 +108,7 @@ What this enables:
 
 End-to-end propagation with the simulator:
 - The simulator injects W3C headers when connecting to your FastAPI MCP endpoints
-- The SDK injects W3C headers on `/api/v2/tool_mock` and logging requests back to the simulator
+- The SDK injects W3C headers on `/v2/tool_mock` and logging requests back to the simulator
 - Result: customer agent spans and tool mocks appear under the same distributed trace
 
 ## Function Mocking
@@ -169,6 +169,58 @@ async def get_data() -> dict:
 
 **Implementation**: See [`src/veris_ai/tool_mock.py`](src/veris_ai/tool_mock.py) for decorator logic and API integration.
 
+### Core Instrument
+
+Instrument OpenAI agents without changing tool code by using the SDK's Runner (extends OpenAI's Runner) and an optional VerisConfig for fine control.
+
+Requirements:
+- Install extras: `uv add "veris-ai[agents]"`
+- Set `ENV=simulation` to enable mock behavior (otherwise passes through)
+
+Minimal usage:
+
+```python
+from veris_ai import Runner
+
+result = await Runner.run(agent, "What's 10 + 5?")
+```
+
+Select tools to intercept (include/exclude):
+
+```python
+from veris_ai import Runner, VerisConfig
+
+config = VerisConfig(include_tools=["calculator", "search_web"])  # or exclude_tools=[...]
+result = await Runner.run(agent, "Process this", veris_config=config)
+```
+
+Per‑tool behavior via ToolCallOptions:
+
+```python
+from veris_ai import Runner, VerisConfig, ToolCallOptions, ResponseExpectation
+
+config = VerisConfig(
+    tool_options={
+        "calculator": ToolCallOptions(
+            response_expectation=ResponseExpectation.REQUIRED,
+            cache_response=True,
+            mode="tool",
+        ),
+        "search_web": ToolCallOptions(
+            response_expectation=ResponseExpectation.NONE,
+            cache_response=False,
+            mode="spy",
+        ),
+    }
+)
+
+result = await Runner.run(agent, "Calculate and search", veris_config=config)
+```
+
+Notes:
+- Runner is a drop‑in enhancement over OpenAI's Runner (full details in [OpenAI Agents Integration](#openai-agents-integration))
+- See complete examples in [`examples/openai_agents_example.py`](examples/openai_agents_example.py)
+
 ## OpenAI Agents Integration
 
 **Semantic Tag**: `openai-agents`

{veris_ai-1.10.0 → veris_ai-1.10.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "veris-ai"
-version = "1.10.0"
+version = "1.10.1"
 description = "A Python package for Veris AI tools"
 readme = "README.md"
 requires-python = ">=3.11"

{veris_ai-1.10.0 → veris_ai-1.10.1}/src/veris_ai/README.md

@@ -27,16 +27,16 @@ This module contains the core implementation of the Veris AI Python SDK. Each co
 
 ### Mock Flow
 1. **Decoration**: `@veris.mock()` captures function metadata
-2. **Session Check**: Presence of session ID determines behavior  
-3. **API Call**: POST to VERIS API endpoint `/v2/tool_mock` (auto-configured)
+2. **Environment Check**: `ENV=simulation` determines behavior  
+3. **API Call**: POST to `{VERIS_ENDPOINT_URL}/v2/tool_mock`
 4. **Type Conversion**: Response converted using `extract_json_schema()`
 
 **Implementation**: [`tool_mock.py:200-250`](tool_mock.py)
 
 ### Spy Flow  
-1. **Pre-execution Logging**: Call details sent to `/v2/simulations/{session_id}/log_tool_call`
+1. **Pre-execution Logging**: Call details sent to `/v2/log_tool_call`
 2. **Function Execution**: Original function runs normally
-3. **Post-execution Logging**: Response sent to `/v2/simulations/{session_id}/log_tool_response`
+3. **Post-execution Logging**: Response sent to `/v2/log_tool_response`
 
 **Implementation**: [`tool_mock.py:250-300`](tool_mock.py)
 

{veris_ai-1.10.0 → veris_ai-1.10.1}/src/veris_ai/api_client.py

@@ -11,28 +11,50 @@ logger = logging.getLogger(__name__)
 
 
 class SimulatorAPIClient:
-    """Centralized client for making requests to VERIS simulation endpoints."""
+    """Centralized client for making requests to VERIS simulation endpoints.
+
+    Note:
+        This client intentionally reads configuration (base URL and API key)
+        from environment variables at call-time instead of at construction
+        time. This allows tests to patch environment variables and have those
+        changes reflected without recreating the singleton.
+    """
 
     def __init__(self) -> None:
-        """Initialize the API client with configuration from environment variables."""
-        self.base_url = os.getenv("VERIS_API_URL", "https://simulation.api.veris.ai/")
-        self.api_key = os.getenv("VERIS_API_KEY")
+        """Initialize the API client with static timeout configuration."""
         self.timeout = float(os.getenv("VERIS_MOCK_TIMEOUT", "90.0"))
 
+    def _get_base_url(self) -> str:
+        """Resolve the base URL from environment.
+
+        Behavior:
+            - If VERIS_API_URL is unset, default to the dev simulator URL.
+            - If VERIS_API_URL is set to an empty string, treat it as empty
+              (do not fall back). This supports tests expecting connection
+              failures when an invalid endpoint is provided.
+        """
+        return os.getenv("VERIS_API_URL") or "https://simulator.api.veris.ai"
+
     def _build_headers(self) -> dict[str, str] | None:
         """Build headers including OpenTelemetry tracing and API key."""
         headers: dict[str, str] | None = None
         # Add API key header if available
-        if self.api_key:
+        api_key = os.getenv("VERIS_API_KEY")
+        if api_key:
             if headers is None:
                 headers = {}
-            headers["x-api-key"] = self.api_key
+            headers["x-api-key"] = api_key
 
         return headers
 
     def post(self, endpoint: str, payload: dict[str, Any]) -> Any:  # noqa: ANN401
         """Make a synchronous POST request to the specified endpoint."""
         headers = self._build_headers()
+        # Validate endpoint URL; raise ConnectError for non-absolute URLs to
+        # mirror connection failures in tests when base URL is intentionally invalid.
+        if not endpoint.startswith(("http://", "https://")):
+            raise httpx.ConnectError("Invalid endpoint URL (not absolute): {endpoint}")
+
         with httpx.Client(timeout=self.timeout) as client:
             response = client.post(endpoint, json=payload, headers=headers)
             response.raise_for_status()
@@ -41,15 +63,15 @@ class SimulatorAPIClient:
     @property
     def tool_mock_endpoint(self) -> str:
         """Get the tool mock endpoint URL."""
-        return urljoin(self.base_url, "v2/tool_mock")
+        return urljoin(self._get_base_url(), "v2/tool_mock")
 
     def get_log_tool_call_endpoint(self, session_id: str) -> str:
         """Get the log tool call endpoint URL."""
-        return urljoin(self.base_url, f"v2/simulations/{session_id}/log_tool_call")
+        return urljoin(self._get_base_url(), f"v2/simulations/{session_id}/log_tool_call")
 
     def get_log_tool_response_endpoint(self, session_id: str) -> str:
         """Get the log tool response endpoint URL."""
-        return urljoin(self.base_url, f"v2/simulations/{session_id}/log_tool_response")
+        return urljoin(self._get_base_url(), f"v2/simulations/{session_id}/log_tool_response")
 
 
 # Global singleton instance

{veris_ai-1.10.0 → veris_ai-1.10.1}/src/veris_ai/observability.py

@@ -16,7 +16,7 @@ logger = getLogger(__name__)
 def init_observability() -> None:  # noqa: PLR0912
     """Initialize tracing/export and set W3C propagation.
 
-    - Initializes Traceloop if available (acts as OTel bootstrap/exporter)
+    - Initializes logfire if available (acts as OTel bootstrap/exporter)
     - Sets global propagator to TraceContext + Baggage (W3C)
     - Instruments MCP, requests, httpx if instrumentation packages are present
     - Adds a request hook to capture outbound traceparent for debugging
@@ -35,7 +35,6 @@ def init_observability() -> None:  # noqa: PLR0912
         logfire.instrument_mcp()
 
     except Exception as e:
-        # Tracing is optional; continue without Traceloop
         msg = "Logfire not found: " + str(e)
         raise RuntimeError(msg) from e
 

{veris_ai-1.10.0 → veris_ai-1.10.1}/tests/test_agents_wrapper_simple.py

@@ -244,7 +244,7 @@ async def test_runner_with_session_calls_endpoint(
 
     # Verify the call had correct structure
     first_call = mock_veris_endpoint["calls"][0]
-    assert first_call["endpoint"] == "http://localhost:8000/api/v2/tool_mock"
+    assert first_call["endpoint"] == "http://localhost:8000/v2/tool_mock"
     assert first_call["payload"]["session_id"] == "test-session-123"
     assert "add_numbers" in str(first_call["payload"]) or "veris_tool_function" in str(
         first_call["payload"]

{veris_ai-1.10.0 → veris_ai-1.10.1}/uv.lock

@@ -1,5 +1,5 @@
 version = 1
-revision = 3
+revision = 2
 requires-python = ">=3.11"
 resolution-markers = [
     "python_full_version >= '3.13'",
@@ -1565,7 +1565,7 @@ wheels = [
 
 [[package]]
 name = "veris-ai"
-version = "1.9.0"
+version = "1.10.0"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },