lucidicai 3.3.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.3.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

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

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

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

@@ -1,6 +1,6 @@
-lucidicai/__init__.py,sha256=gdk3Y-cq-RaTbhBcBE77saBwHSbIvqaScU9gNoTi7_g,1284
+lucidicai/__init__.py,sha256=Dur2YTPgHbjFM09QQ36SHOHE0B62uFb5dIUHKo4oy7g,1284
 lucidicai/action.py,sha256=sPRd1hTIVXDqnvG9ZXWEipUFh0bsXcE0Fm7RVqmVccM,237
-lucidicai/client.py,sha256=LC9KPhZgTnt5klntHoyCQWWpRUE-X58lM80uAaWBNiU,15090
+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,7 +26,7 @@ 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=q4h-yR35Ay_3znL7vavri6ScfeM69RjHShNNzjoQthc,10194
@@ -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.3.0.dist-info/METADATA,sha256=p8D3cXfEzfEC4HnYYz68keBQwzNDOkSqifh8H13m1t4,902
-lucidicai-3.3.0.dist-info/WHEEL,sha256=Xo9-1PvkuimrydujYJAjF7pCkriuXBpUPEjma1nZyJ0,92
-lucidicai-3.3.0.dist-info/top_level.txt,sha256=vSSdM3lclF4I5tyVC0xxUk8eIRnnYXMe1hW-eO91HUo,10
-lucidicai-3.3.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,,