lucidicai 3.2.0__py3-none-any.whl → 3.3.1__py3-none-any.whl

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.1"
 
 # All exports
 __all__ = [

lucidicai/api/resources/prompt.py

@@ -1,30 +1,57 @@
 """Prompt resource API operations."""
 import logging
-from typing import Any, Dict, Optional
+import time
+from typing import Any, Dict, Optional, Tuple, TYPE_CHECKING
 
 from ..client import HttpClient
 
+if TYPE_CHECKING:
+    from ...core.config import SDKConfig
+
 logger = logging.getLogger("Lucidic")
 
 
 class PromptResource:
     """Handle prompt-related API operations."""
 
-    def __init__(self, http: HttpClient, production: bool = False):
+    def __init__(self, http: HttpClient, config: "SDKConfig", production: bool = False):
         """Initialize prompt resource.
 
         Args:
             http: HTTP client instance
+            config: SDK configuration
             production: Whether to suppress errors in production mode
         """
         self.http = http
+        self._config = config
         self._production = production
+        self._cache: Dict[Tuple[str, str], Dict[str, Any]] = {}
+
+    def _is_cache_valid(self, cache_key: Tuple[str, str], cache_ttl: int) -> bool:
+        """Check if a cached prompt is still valid.
+
+        Args:
+            cache_key: The (prompt_name, label) tuple
+            cache_ttl: Cache TTL in seconds (-1 = indefinite, 0 = no cache)
+
+        Returns:
+            True if cache is valid, False otherwise
+        """
+        if cache_ttl == 0:
+            return False
+        if cache_key not in self._cache:
+            return False
+        if cache_ttl == -1:
+            return True
+        cached = self._cache[cache_key]
+        return (time.time() - cached["timestamp"]) < cache_ttl
 
     def get(
         self,
         prompt_name: str,
         variables: Optional[Dict[str, Any]] = None,
         label: str = "production",
+        cache_ttl: int = 0,
     ) -> str:
         """Get a prompt from the prompt database.
 
@@ -32,21 +59,36 @@ class PromptResource:
             prompt_name: Name of the prompt.
             variables: Variables to interpolate into the prompt.
             label: Prompt version label (default: "production").
+            cache_ttl: Cache TTL in seconds. 0 = no cache, -1 = cache indefinitely,
+                       positive value = seconds before refetching.
 
         Returns:
             The prompt content with variables interpolated.
         """
         try:
-            response = self.http.get(
-                "getprompt",
-                {"prompt_name": prompt_name, "label": label},
-            )
-            prompt = response.get("prompt_content", "")
+            cache_key = (prompt_name, label)
+
+            # Check cache
+            if self._is_cache_valid(cache_key, cache_ttl):
+                prompt = self._cache[cache_key]["content"]
+            else:
+                response = self.http.get(
+                    "getprompt",
+                    {"prompt_name": prompt_name, "label": label, "agent_id": self._config.agent_id},
+                )
+                prompt = response.get("prompt_content", "")
+
+                # Store in cache if caching is enabled
+                if cache_ttl != 0:
+                    self._cache[cache_key] = {
+                        "content": prompt,
+                        "timestamp": time.time(),
+                    }
 
             # Replace variables
             if variables:
                 for key, value in variables.items():
-                    prompt = prompt.replace(f"{{{key}}}", str(value))
+                    prompt = prompt.replace(f"{{{{{key}}}}}", str(value))
 
             return prompt
         except Exception as e:
@@ -60,21 +102,35 @@ class PromptResource:
         prompt_name: str,
         variables: Optional[Dict[str, Any]] = None,
         label: str = "production",
+        cache_ttl: int = 0,
     ) -> str:
         """Get a prompt from the prompt database (asynchronous).
 
         See get() for full documentation.
         """
         try:
-            response = await self.http.aget(
-                "getprompt",
-                {"prompt_name": prompt_name, "label": label},
-            )
-            prompt = response.get("prompt_content", "")
+            cache_key = (prompt_name, label)
+
+            # Check cache
+            if self._is_cache_valid(cache_key, cache_ttl):
+                prompt = self._cache[cache_key]["content"]
+            else:
+                response = await self.http.aget(
+                    "getprompt",
+                    {"prompt_name": prompt_name, "label": label, "agent_id": self._config.agent_id},
+                )
+                prompt = response.get("prompt_content", "")
+
+                # Store in cache if caching is enabled
+                if cache_ttl != 0:
+                    self._cache[cache_key] = {
+                        "content": prompt,
+                        "timestamp": time.time(),
+                    }
 
             if variables:
                 for key, value in variables.items():
-                    prompt = prompt.replace(f"{{{key}}}", str(value))
+                    prompt = prompt.replace(f"{{{{{key}}}}}", str(value))
 
             return prompt
         except Exception as e:

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,
         )
 
@@ -144,7 +155,7 @@ class LucidicAI:
             "events": EventResource(self._http, self._production),
             "datasets": DatasetResource(self._http, self._config.agent_id, self._production),
             "experiments": ExperimentResource(self._http, self._config.agent_id, self._production),
-            "prompts": PromptResource(self._http, self._production),
+            "prompts": PromptResource(self._http, self._config, self._production),
             "feature_flags": FeatureFlagResource(self._http, self._config.agent_id, self._production),
             "evals": EvalsResource(self._http, self._production),
         }

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.dist-info → lucidicai-3.3.1.dist-info}/METADATA

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

{lucidicai-3.2.0.dist-info → lucidicai-3.3.1.dist-info}/RECORD

@@ -1,6 +1,6 @@
-lucidicai/__init__.py,sha256=L5Zy-XJVTIqJAi3nrh8lAp8J4ii4yaEudaQxB94tXQM,1284
+lucidicai/__init__.py,sha256=Dur2YTPgHbjFM09QQ36SHOHE0B62uFb5dIUHKo4oy7g,1284
 lucidicai/action.py,sha256=sPRd1hTIVXDqnvG9ZXWEipUFh0bsXcE0Fm7RVqmVccM,237
-lucidicai/client.py,sha256=WnkUeo_Z0uP4xh66gNC6MJhYdyhRpjC61OBjHEJLHq4,14674
+lucidicai/client.py,sha256=BGKP91_Oj5kHQU0osYf1T_BWakL8KIhs0AgUc5X99sU,15104
 lucidicai/constants.py,sha256=zN8O7TjoRHRlaGa9CZUWppS73rhzKGwaEkF9XMTV0Cg,1160
 lucidicai/context.py,sha256=ruEXAndSv0gQ-YEXLlC4Fx6NNbaylfp_dZxbpwmLZSA,4622
 lucidicai/dataset.py,sha256=wu25X02JyWkht_yQabgQpGZFfzbNTxG6tf5k9ol8Amo,4005
@@ -26,10 +26,10 @@ lucidicai/api/resources/evals.py,sha256=_3nLE6dMLht844mWw7kl_hctjv5JIuC6MP06YWUg
 lucidicai/api/resources/event.py,sha256=GTIU5sIbLNTWAHk4rB120xWTRkhnraz9JNfamEygyNo,14267
 lucidicai/api/resources/experiment.py,sha256=fOIKJ5d89bHJBVZ3wjbhY_6XF3kLHz9TE3BVPA5pNpA,3563
 lucidicai/api/resources/feature_flag.py,sha256=ii412DIkZCEAhrXdGydcpQKveqGlFq4NlgdmWQnU83c,2259
-lucidicai/api/resources/prompt.py,sha256=tdMVTaLc3DDRbd_R8Xd5mkvpdwQONfr8OwkJRTE0atE,2495
+lucidicai/api/resources/prompt.py,sha256=5pIV3vTfOQkovQpINohDVseY678E04CWz2E5V4NA-i8,4625
 lucidicai/api/resources/session.py,sha256=jW_bftHdunhLHl_3-k0nqB5FrtLhlFeCF0tMFE82nNw,20761
 lucidicai/core/__init__.py,sha256=b0YQkd8190Y_GgwUcmf0tOiSLARd7L4kq4jwfhhGAyI,39
-lucidicai/core/config.py,sha256=06XZPOCpB8YY9nzqt7deR3CP6MAQIKCTZYdSzscAPDY,8730
+lucidicai/core/config.py,sha256=q4h-yR35Ay_3znL7vavri6ScfeM69RjHShNNzjoQthc,10194
 lucidicai/core/errors.py,sha256=bYSRPqadXUCPadVLb-2fj63CB6jlAnfDeu2azHB2z8M,2137
 lucidicai/core/types.py,sha256=KabcTBQe7SemigccKfJSDiJmjSJDJJvvtefSd8pfrJI,702
 lucidicai/integrations/__init__.py,sha256=9eJxdcw9C_zLXLQGdKK-uwCYhjdnEelrXbYYNo48ewk,292
@@ -93,7 +93,7 @@ lucidicai/utils/images.py,sha256=z8mlIKgFfrIbuk-l4L2rB62uw_uPO79sHPXPY7eLu2A,128
 lucidicai/utils/logger.py,sha256=R3B3gSee64F6UVHUrShihBq_O7W7bgfrBiVDXTO3Isg,4777
 lucidicai/utils/queue.py,sha256=8DQwnGw7pINEJ0dNSkB0PhdPW-iBQQ-YZg23poe4umE,17323
 lucidicai/utils/serialization.py,sha256=KdOREZd7XBxFBAZ86DePMfYPzSVyKr4RcgUa82aFxrs,820
-lucidicai-3.2.0.dist-info/METADATA,sha256=4H-66e1GD2248FpoRJBLUb1oW3ICnJhIYXcngIirq6Q,902
-lucidicai-3.2.0.dist-info/WHEEL,sha256=Xo9-1PvkuimrydujYJAjF7pCkriuXBpUPEjma1nZyJ0,92
-lucidicai-3.2.0.dist-info/top_level.txt,sha256=vSSdM3lclF4I5tyVC0xxUk8eIRnnYXMe1hW-eO91HUo,10
-lucidicai-3.2.0.dist-info/RECORD,,
+lucidicai-3.3.1.dist-info/METADATA,sha256=-VsGzxsuN4ux1cLJN6jcbEO2cOv2G756BdsAWY8uiio,902
+lucidicai-3.3.1.dist-info/WHEEL,sha256=Xo9-1PvkuimrydujYJAjF7pCkriuXBpUPEjma1nZyJ0,92
+lucidicai-3.3.1.dist-info/top_level.txt,sha256=vSSdM3lclF4I5tyVC0xxUk8eIRnnYXMe1hW-eO91HUo,10
+lucidicai-3.3.1.dist-info/RECORD,,