scope-analytics 0.1.3__tar.gz → 0.1.4__tar.gz

{scope_analytics-0.1.3/scope_analytics.egg-info → scope_analytics-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scope-analytics
-Version: 0.1.3
+Version: 0.1.4
 Summary: AI-powered analytics SDK for backend applications with automatic LLM tracking
 Home-page: https://scopeai.dev
 Author: Scope AI

{scope_analytics-0.1.3 → scope_analytics-0.1.4}/scope_analytics/events.py

@@ -54,8 +54,10 @@ class EventFormatter:
         user_agent = ScopeContext.get_user_agent()
 
         # Determine if this is a user-facing LLM call
-        # If we have a session_id from frontend (not temp_), it's user-facing
-        is_user_facing = session_id and not session_id.startswith("temp_")
+        # If we have a session_id from frontend (not temp_), it's user-facing. A real boolean
+        # either way: before 0.1.4 a call with no session at all shipped None here (the bare
+        # `and` chain), so the first context-less call of a task was neither true nor false.
+        is_user_facing = bool(session_id and not session_id.startswith("temp_"))
 
         # Messages may carry SDK objects (pydantic content blocks appended by the app);
         # coerce to JSON-safe types FIRST so prompt extraction sees plain dicts and the
@@ -159,8 +161,9 @@ class EventFormatter:
         user_id = ScopeContext.get_user_id()
 
         # Determine if this is a user-facing request
-        # If we have a session_id from frontend (not temp_), it's user-initiated
-        is_user_facing = session_id and not session_id.startswith("temp_")
+        # If we have a session_id from frontend (not temp_), it's user-initiated. A real
+        # boolean either way (see format_llm_call).
+        is_user_facing = bool(session_id and not session_id.startswith("temp_"))
 
         event = {
             "event_type": "http_request",

{scope_analytics-0.1.3 → scope_analytics-0.1.4}/scope_analytics/supported_versions.py

@@ -34,9 +34,10 @@ SUPPORTED_VERSIONS = {
         # stream contract itself, failing the contract cells with Scope OFF); contract-grade
         # verification starts at 1.30.0 (pinned cell, httpx<0.28 for its proxies= era).
         # 3.x (2026-09): the majors keep the modern client shape, so the structural routing and
-        # both capture surfaces are unchanged — verified by the contract cells below.
-        "max_tested": "3.8.0",
-        "ci_matrix": ["1.0.0", "1.30.0", "1.57.0", "2.41.0", "2.46.0", "3.8.0"],
+        # both capture surfaces are unchanged — verified by the contract cells below (3.8.0 at
+        # 0.1.3; 3.14.1 at 0.1.4, the publish gate's floating "latest" cell + a clean venv).
+        "max_tested": "3.14.1",
+        "ci_matrix": ["1.0.0", "1.30.0", "1.57.0", "2.41.0", "2.46.0", "3.8.0", "3.14.1"],
     },
     "anthropic": {
         "import_name": "anthropic",
@@ -47,9 +48,10 @@ SUPPORTED_VERSIONS = {
         # SDKs that predate those surfaces.
         # 1.x (2026-09) moved the SDK's HTTP client from httpx to httpx2 — which is why outbound
         # capture patches httpx2 as its own target, and why the structural cell reads the http
-        # module off the SDK instead of assuming ours. The patch surfaces themselves are unchanged.
-        "max_tested": "1.4.0",
-        "ci_matrix": ["0.18.0", "0.30.0", "0.40.0", "0.116.0", "1.4.0"],
+        # module off the SDK instead of assuming ours. The patch surfaces themselves are unchanged
+        # (1.4.0 verified at 0.1.3; 1.6.0 at 0.1.4).
+        "max_tested": "1.6.0",
+        "ci_matrix": ["0.18.0", "0.30.0", "0.40.0", "0.116.0", "1.4.0", "1.6.0"],
     },
     "gemini": {
         # Targets the LEGACY google-generativeai SDK (import google.generativeai), which gemini_patch.py
@@ -76,9 +78,10 @@ SUPPORTED_VERSIONS = {
         "dist_name": "google-genai",
         "min_supported": "1.0.0",      # the unified SDK GA'd at v1.x (~May 2025)
         # Verified by tests/test_capture_contract_google.py against 1.60.0 AND 2.11.0 (current as of
-        # 2026-07; the 2.0 major's breaking changes were interactions-only — generate_content stable).
-        "max_tested": "2.22.0",
-        "ci_matrix": ["1.0.0", "1.60.0", "2.11.0", "2.22.0"],
+        # 2026-07; the 2.0 major's breaking changes were interactions-only — generate_content stable);
+        # 2.22.0 at 0.1.3, 2.23.0 at 0.1.4.
+        "max_tested": "2.23.0",
+        "ci_matrix": ["1.0.0", "1.60.0", "2.11.0", "2.22.0", "2.23.0"],
     },
 }
 

{scope_analytics-0.1.3 → scope_analytics-0.1.4/scope_analytics.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scope-analytics
-Version: 0.1.3
+Version: 0.1.4
 Summary: AI-powered analytics SDK for backend applications with automatic LLM tracking
 Home-page: https://scopeai.dev
 Author: Scope AI

{scope_analytics-0.1.3 → scope_analytics-0.1.4}/scope_analytics.egg-info/SOURCES.txt

@@ -36,4 +36,5 @@ tests/test_http_patch.py
 tests/test_identify.py
 tests/test_identity_bridge.py
 tests/test_patch_versions.py
-tests/test_redaction.py
+tests/test_redaction.py
+tests/test_user_facing.py

{scope_analytics-0.1.3 → scope_analytics-0.1.4}/setup.py

@@ -11,7 +11,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="scope-analytics",
-    version="0.1.3",
+    version="0.1.4",
     author="Scope AI",
     author_email="support@scopeai.dev",
     description="AI-powered analytics SDK for backend applications with automatic LLM tracking",

scope_analytics-0.1.4/tests/test_user_facing.py

@@ -0,0 +1,63 @@
+"""`is_user_facing` is a real boolean on every event the formatter writes.
+
+Before 0.1.4 `format_llm_call` and `format_http_request` computed it as the bare chain
+`session_id and not session_id.startswith("temp_")`, which is None when no session is in
+the context at all — so the FIRST context-less call of a background task shipped
+`is_user_facing: null`, neither true nor false, while every later call on that thread (the
+temp session now pinned) shipped false. A filter on `false` missed those first calls; the
+analyst's schema had to teach `{$ne: true}` around it. `format_external_api_call` had the
+bool() from the start; this pins all three to the same truth table.
+"""
+import pytest
+
+from scope_analytics.config import ScopeConfig
+from scope_analytics.context import ScopeContext
+from scope_analytics.events import EventFormatter
+
+
+@pytest.fixture
+def formatter():
+    ScopeContext.clear()
+    yield EventFormatter(ScopeConfig(api_key="sk_test_user_facing"))
+    ScopeContext.clear()
+
+
+def _llm(f):
+    return f.format_llm_call("openai", "gpt", [{"role": "user", "content": "hi"}], "yo")
+
+
+def _http(f):
+    return f.format_http_request("GET", "/x", 200, 1.0)
+
+
+def _outbound(f):
+    return f.format_external_api_call("GET", "https://api.example.com/v1/x", 200, 1.0)
+
+
+@pytest.mark.parametrize("build", [_llm, _http, _outbound], ids=["llm_call", "http_request", "external_api_call"])
+def test_no_session_at_all_is_false_not_none(formatter, build):
+    """The first context-less call — nothing pinned yet — is `false`, the same as every call after it."""
+    assert ScopeContext.get_session_id() is None
+    event = build(formatter)
+    assert event["is_user_facing"] is False, event["is_user_facing"]
+
+
+@pytest.mark.parametrize("build", [_llm, _http, _outbound], ids=["llm_call", "http_request", "external_api_call"])
+def test_a_temp_session_is_false(formatter, build):
+    ScopeContext.set_session_id("temp_0123456789abcdef")
+    assert build(formatter)["is_user_facing"] is False
+
+
+@pytest.mark.parametrize("build", [_llm, _http, _outbound], ids=["llm_call", "http_request", "external_api_call"])
+def test_a_visitor_session_is_true(formatter, build):
+    ScopeContext.set_session_id("sess_from_the_browser")
+    assert build(formatter)["is_user_facing"] is True
+
+
+def test_the_first_and_second_context_less_calls_agree(formatter):
+    """The regression's exact shape: call one had no session, call two saw the temp session
+    call one pinned — they must say the same thing."""
+    first = _llm(formatter)["is_user_facing"]
+    assert ScopeContext.get_session_id().startswith("temp_")
+    second = _llm(formatter)["is_user_facing"]
+    assert first is False and second is False