lucidicai 3.2.0__tar.gz → 3.3.0__tar.gz

{lucidicai-3.2.0 → lucidicai-3.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lucidicai
-Version: 3.2.0
+Version: 3.3.0
 Summary: Lucidic AI Python SDK
 Author: Andy Liang
 Author-email: andy@lucidic.ai

{lucidicai-3.2.0 → lucidicai-3.3.0}/lucidicai/__init__.py

@@ -38,7 +38,7 @@ from .core.errors import (
 from .integrations.livekit import setup_livekit
 
 # Version
-__version__ = "3.2.0"
+__version__ = "3.3.0"
 
 # All exports
 __all__ = [

{lucidicai-3.2.0 → lucidicai-3.3.0}/lucidicai/client.py

@@ -64,6 +64,8 @@ class LucidicAI:
         auto_end: Whether sessions auto-end on context exit or process shutdown.
         production: If True, suppress SDK errors. If None, checks LUCIDIC_PRODUCTION env var.
         region: Deployment region ("us", "india"). Falls back to LUCIDIC_REGION env var.
+        base_url: Custom base URL for API requests. Takes precedence over region.
+                  Falls back to LUCIDIC_BASE_URL env var.
         **kwargs: Additional configuration options passed to SDKConfig.
 
     Raises:
@@ -93,6 +95,13 @@ class LucidicAI:
             agent_id="...",
             region="india"
         )
+
+        # Custom base URL (e.g., self-hosted deployment)
+        client = LucidicAI(
+            api_key="...",
+            agent_id="...",
+            base_url="https://custom.example.com/api"
+        )
     """
 
     def __init__(
@@ -103,6 +112,7 @@ class LucidicAI:
         auto_end: bool = True,
         production: Optional[bool] = None,
         region: Optional[str] = None,
+        base_url: Optional[str] = None,
         **kwargs,
     ):
         # Generate unique client ID for telemetry routing
@@ -119,6 +129,7 @@ class LucidicAI:
             agent_id=agent_id,
             auto_end=auto_end,
             region=region,
+            base_url=base_url,
             **kwargs,
         )
 

{lucidicai-3.2.0 → lucidicai-3.3.0}/lucidicai/core/config.py

@@ -53,16 +53,20 @@ class NetworkConfig:
     connection_pool_maxsize: int = 100
 
     @classmethod
-    def from_env(cls, region: Optional[str] = None, debug: bool = False) -> 'NetworkConfig':
+    def from_env(cls, region: Optional[str] = None, base_url: Optional[str] = None, debug: bool = False) -> 'NetworkConfig':
         """Load network configuration from environment variables.
 
-        Priority: debug > region argument > LUCIDIC_REGION env var > default
+        Priority: debug > base_url argument > LUCIDIC_BASE_URL > region argument > LUCIDIC_REGION > default
 
         Args:
             region: Region string override (e.g., "us", "india")
-            debug: If True, use localhost URL regardless of region
+            base_url: Custom base URL override (takes precedence over region)
+            debug: If True, use localhost URL regardless of other settings
         """
-        # If debug mode, use localhost (ignores region)
+        import logging
+        logger = logging.getLogger("Lucidic")
+
+        # If debug mode, use localhost (highest priority)
         if debug:
             return cls(
                 base_url=DEBUG_URL,
@@ -74,7 +78,28 @@ class NetworkConfig:
                 connection_pool_maxsize=int(os.getenv("LUCIDIC_CONNECTION_POOL_MAXSIZE", "100"))
             )
 
-        # Resolve region: argument > env var > default
+        # Resolve base_url: argument > env var
+        resolved_base_url = base_url or os.getenv("LUCIDIC_BASE_URL")
+
+        if resolved_base_url:
+            # base_url takes precedence over region
+            region_str = region or os.getenv("LUCIDIC_REGION")
+            if region_str:
+                logger.warning(
+                    f"[LucidicAI] Both base_url and region specified. "
+                    f"Using base_url '{resolved_base_url}', ignoring region '{region_str}'."
+                )
+            return cls(
+                base_url=resolved_base_url,
+                region=None,  # Custom deployment, no region
+                timeout=int(os.getenv("LUCIDIC_TIMEOUT", "30")),
+                max_retries=int(os.getenv("LUCIDIC_MAX_RETRIES", "3")),
+                backoff_factor=float(os.getenv("LUCIDIC_BACKOFF_FACTOR", "0.5")),
+                connection_pool_size=int(os.getenv("LUCIDIC_CONNECTION_POOL_SIZE", "20")),
+                connection_pool_maxsize=int(os.getenv("LUCIDIC_CONNECTION_POOL_MAXSIZE", "100"))
+            )
+
+        # Fall back to region-based URL resolution
         region_str = region or os.getenv("LUCIDIC_REGION")
         resolved_region = Region.from_string(region_str) if region_str else DEFAULT_REGION
 
@@ -147,11 +172,13 @@ class SDKConfig:
     debug: bool = False
     
     @classmethod
-    def from_env(cls, region: Optional[str] = None, **overrides) -> 'SDKConfig':
+    def from_env(cls, region: Optional[str] = None, base_url: Optional[str] = None, **overrides) -> 'SDKConfig':
         """Create configuration from environment variables with optional overrides.
 
         Args:
             region: Region string (e.g., "us", "india"). Priority: arg > env var > default
+            base_url: Custom base URL override. Takes precedence over region.
+                      Falls back to LUCIDIC_BASE_URL env var.
             **overrides: Additional configuration overrides
         """
         from dotenv import load_dotenv
@@ -165,7 +192,7 @@ class SDKConfig:
             auto_end=os.getenv("LUCIDIC_AUTO_END", "true").lower() == "true",
             production_monitoring=False,
             blob_threshold=int(os.getenv("LUCIDIC_BLOB_THRESHOLD", "65536")),
-            network=NetworkConfig.from_env(region=region, debug=debug),
+            network=NetworkConfig.from_env(region=region, base_url=base_url, debug=debug),
             error_handling=ErrorHandlingConfig.from_env(),
             telemetry=TelemetryConfig.from_env(),
             environment=Environment.DEBUG if debug else Environment.PRODUCTION,

{lucidicai-3.2.0 → lucidicai-3.3.0}/lucidicai.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lucidicai
-Version: 3.2.0
+Version: 3.3.0
 Summary: Lucidic AI Python SDK
 Author: Andy Liang
 Author-email: andy@lucidic.ai

{lucidicai-3.2.0 → lucidicai-3.3.0}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="lucidicai",
-    version="3.2.0",
+    version="3.3.0",
     packages=find_packages(),
     install_requires=[
         "requests>=2.25.1",