scope-analytics 0.1.0__tar.gz → 0.1.1__tar.gz

{scope_analytics-0.1.0/scope_analytics.egg-info → scope_analytics-0.1.1}/PKG-INFO

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

{scope_analytics-0.1.0 → scope_analytics-0.1.1}/scope_analytics/context.py

@@ -17,6 +17,23 @@ user_id_context: contextvars.ContextVar[Optional[str]] = contextvars.ContextVar(
     'scope_user_id', default=None
 )
 
+# Request context for LLM event correlation
+url_context: contextvars.ContextVar[Optional[str]] = contextvars.ContextVar(
+    'scope_url', default=None
+)
+
+referrer_context: contextvars.ContextVar[Optional[str]] = contextvars.ContextVar(
+    'scope_referrer', default=None
+)
+
+thread_id_context: contextvars.ContextVar[Optional[str]] = contextvars.ContextVar(
+    'scope_thread_id', default=None
+)
+
+user_agent_context: contextvars.ContextVar[Optional[str]] = contextvars.ContextVar(
+    'scope_user_agent', default=None
+)
+
 # Recursion guard - prevents infinite loops when Scope tracks its own LLM calls
 # This is critical when Scope AI backend uses Scope SDK to track itself
 _in_scope_context: contextvars.ContextVar[bool] = contextvars.ContextVar(
@@ -72,6 +89,50 @@ class ScopeContext:
         """
         return user_id_context.get()
 
+    # =========================================================================
+    # Request Context - URL, Referrer, Thread ID, User Agent
+    # =========================================================================
+
+    @staticmethod
+    def set_url(url: str) -> None:
+        """Set the request URL for the current context"""
+        url_context.set(url)
+
+    @staticmethod
+    def get_url() -> Optional[str]:
+        """Get the request URL from current context"""
+        return url_context.get()
+
+    @staticmethod
+    def set_referrer(referrer: str) -> None:
+        """Set the referrer for the current context"""
+        referrer_context.set(referrer)
+
+    @staticmethod
+    def get_referrer() -> Optional[str]:
+        """Get the referrer from current context"""
+        return referrer_context.get()
+
+    @staticmethod
+    def set_thread_id(thread_id: str) -> None:
+        """Set the thread ID for the current context (for ChatGPT-style apps)"""
+        thread_id_context.set(thread_id)
+
+    @staticmethod
+    def get_thread_id() -> Optional[str]:
+        """Get the thread ID from current context"""
+        return thread_id_context.get()
+
+    @staticmethod
+    def set_user_agent(user_agent: str) -> None:
+        """Set the user agent for the current context"""
+        user_agent_context.set(user_agent)
+
+    @staticmethod
+    def get_user_agent() -> Optional[str]:
+        """Get the user agent from current context"""
+        return user_agent_context.get()
+
     @staticmethod
     def clear() -> None:
         """
@@ -80,6 +141,10 @@ class ScopeContext:
         """
         session_id_context.set(None)
         user_id_context.set(None)
+        url_context.set(None)
+        referrer_context.set(None)
+        thread_id_context.set(None)
+        user_agent_context.set(None)
 
     @staticmethod
     def generate_temp_session_id() -> str:
@@ -116,6 +181,10 @@ class ScopeContext:
         return {
             "session_id": session_id_context.get(),
             "user_id": user_id_context.get(),
+            "url": url_context.get(),
+            "referrer": referrer_context.get(),
+            "thread_id": thread_id_context.get(),
+            "user_agent": user_agent_context.get(),
         }
 
     # =========================================================================

{scope_analytics-0.1.0 → scope_analytics-0.1.1}/scope_analytics/events.py

@@ -46,6 +46,12 @@ class EventFormatter:
         session_id = ScopeContext.get_session_id()
         user_id = ScopeContext.get_user_id()
 
+        # Get request context for conversation correlation
+        url = ScopeContext.get_url()
+        referrer = ScopeContext.get_referrer()
+        thread_id = ScopeContext.get_thread_id()
+        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_")
@@ -64,6 +70,13 @@ class EventFormatter:
             "session_id": session_id or ScopeContext.ensure_session_id(),
             "user_id": user_id,
 
+            # Request context for conversation correlation
+            # This enables the fallback chain: thread_id → session_id+url → session_id
+            "url": url,
+            "referrer": referrer,
+            "thread_id": thread_id,  # For ChatGPT-style apps with multiple threads
+            "user_agent": user_agent,
+
             # LLM call specific fields
             "provider": provider,
             "model": model,

{scope_analytics-0.1.0 → scope_analytics-0.1.1}/scope_analytics/middleware.py

@@ -199,6 +199,48 @@ def extract_session_from_headers(headers: dict) -> Optional[str]:
     return None
 
 
+def _set_request_context(headers: dict, path: str = None) -> None:
+    """
+    Set request context variables from HTTP headers.
+    This context is used to enrich LLM events with request information.
+
+    Args:
+        headers: Dictionary of HTTP headers
+        path: Request path (URL)
+    """
+    # Set URL (request path)
+    if path:
+        ScopeContext.set_url(path)
+
+    # Extract and set referrer (case-insensitive)
+    referrer = None
+    for key, value in headers.items():
+        key_lower = key.lower()
+        if key_lower == "referer" or key_lower == "referrer":
+            referrer = value
+            break
+    if referrer:
+        ScopeContext.set_referrer(referrer)
+
+    # Extract and set thread_id (X-Scope-Thread-ID header for ChatGPT-style apps)
+    thread_id = None
+    for key, value in headers.items():
+        if key.lower() == "x-scope-thread-id":
+            thread_id = value
+            break
+    if thread_id:
+        ScopeContext.set_thread_id(thread_id)
+
+    # Extract and set user_agent
+    user_agent = None
+    for key, value in headers.items():
+        if key.lower() == "user-agent":
+            user_agent = value
+            break
+    if user_agent:
+        ScopeContext.set_user_agent(user_agent)
+
+
 # =============================================================================
 # FastAPI / Starlette Middleware (ASGI)
 # =============================================================================
@@ -278,6 +320,9 @@ class ScopeSessionMiddleware:
         # Extract request details for tracking
         method = scope.get("method", "GET")
         path = scope.get("path", "/")
+
+        # Set request context (URL, referrer, thread_id, user_agent) for LLM events
+        _set_request_context(headers, path)
         query_string = scope.get("query_string", b"").decode("utf-8", errors="ignore")
         query_params = dict(pair.split("=", 1) for pair in query_string.split("&") if "=" in pair) if query_string else {}
 
@@ -407,6 +452,9 @@ class FlaskScopeMiddleware:
         # Extract request details for tracking
         method = environ.get("REQUEST_METHOD", "GET")
         path = environ.get("PATH_INFO", "/")
+
+        # Set request context (URL, referrer, thread_id, user_agent) for LLM events
+        _set_request_context(headers, path)
         query_string = environ.get("QUERY_STRING", "")
         query_params = dict(pair.split("=", 1) for pair in query_string.split("&") if "=" in pair) if query_string else {}
 
@@ -631,6 +679,9 @@ class DjangoScopeMiddleware:
         # Extract request details for tracking
         method = request.method
         path = request.path
+
+        # Set request context (URL, referrer, thread_id, user_agent) for LLM events
+        _set_request_context(django_headers, path)
         query_params = dict(request.GET.items()) if hasattr(request, 'GET') else {}
 
         # Extract useful headers

{scope_analytics-0.1.0 → scope_analytics-0.1.1/scope_analytics.egg-info}/PKG-INFO

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

{scope_analytics-0.1.0 → scope_analytics-0.1.1}/setup.py

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