local storage first

Author: rcholic

examples/cloud_tracing_agent.py examples/local_tracing_agent.pyexamples/cloud_tracing_agent.py renamed to examples/local_tracing_agent.py

@@ -41,7 +41,8 @@ def main():
     # If api_key is Pro/Enterprise, uses CloudTraceSink
     # If api_key is missing/invalid, falls back to local JsonlTraceSink
     run_id = "cloud-tracing-demo"
-    tracer = create_tracer(api_key=sentience_key, run_id=run_id)
+    # local storage tracer, is upload_tracer is True and api_key is provided, will upload to cloud
+    tracer = create_tracer(api_key=sentience_key, run_id=run_id, upload_trace=False)
 
     print(f"🆔 Run ID: {run_id}\n")
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sentienceapi"
-version = "0.90.5"
+version = "0.90.7"
 description = "Python SDK for Sentience AI Agent Browser Automation"
 readme = "README.md"
 requires-python = ">=3.11"

sentience/__init__.py

@@ -70,7 +70,7 @@
 )
 from .wait import wait_for
 
-__version__ = "0.90.5"
+__version__ = "0.90.7"
 
 __all__ = [
     # Core SDK

sentience/tracer_factory.py

@@ -23,6 +23,7 @@ def create_tracer(
     run_id: str | None = None,
     api_url: str | None = None,
     logger: SentienceLogger | None = None,
+    upload_trace: bool = False,
 ) -> Tracer:
     """
     Create tracer with automatic tier detection.
@@ -38,6 +39,9 @@ def create_tracer(
         run_id: Unique identifier for this agent run. If not provided, generates UUID.
         api_url: Sentience API base URL (default: https://api.sentienceapi.com)
         logger: Optional logger instance for logging file sizes and errors
+        upload_trace: Enable cloud trace upload (default: False). When True and api_key
+                      is provided, traces will be uploaded to cloud. When False, traces
+                      are saved locally only.
 
     Returns:
         Tracer configured with appropriate sink
@@ -62,12 +66,12 @@ def create_tracer(
     if api_url is None:
         api_url = SENTIENCE_API_URL
 
-    # 0. Check for orphaned traces from previous crashes (if api_key provided)
-    if api_key:
+    # 0. Check for orphaned traces from previous crashes (if api_key provided and upload enabled)
+    if api_key and upload_trace:
         _recover_orphaned_traces(api_key, api_url)
 
-    # 1. Try to initialize Cloud Sink (Pro/Enterprise tier)
-    if api_key:
+    # 1. Try to initialize Cloud Sink (Pro/Enterprise tier) if upload enabled
+    if api_key and upload_trace:
         try:
             # Request pre-signed upload URL from backend
             response = requests.post(