lucidicai 3.3.0__py3-none-any.whl → 3.4.0__py3-none-any.whl

lucidicai/__init__.py

@@ -34,11 +34,14 @@ from .core.errors import (
     FeatureFlagError,
 )
 
+# Prompt object
+from .api.resources.prompt import Prompt
+
 # Integrations
 from .integrations.livekit import setup_livekit
 
 # Version
-__version__ = "3.3.0"
+__version__ = "3.4.0"
 
 # All exports
 __all__ = [
@@ -53,6 +56,8 @@ __all__ = [
     "InvalidOperationError",
     "PromptError",
     "FeatureFlagError",
+    # Prompt object
+    "Prompt",
     # Integrations
     "setup_livekit",
     # Version

lucidicai/api/resources/prompt.py

@@ -1,58 +1,118 @@
 """Prompt resource API operations."""
 import logging
-from typing import Any, Dict, Optional
+import time
+from dataclasses import dataclass
+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")
 
 
+@dataclass
+class Prompt:
+    """Represents a prompt retrieved from the Lucidic prompt database."""
+
+    raw_content: str
+    content: str
+    metadata: Dict[str, Any]
+
+    def __str__(self) -> str:
+        return self.content
+
+
 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",
-    ) -> str:
+        cache_ttl: int = 0,
+    ) -> Prompt:
         """Get a prompt from the prompt database.
 
         Args:
             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.
+            A Prompt object with raw_content, content (with variables replaced),
+            and metadata. Use str(prompt) for backward-compatible string access.
         """
         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):
+                raw_content = self._cache[cache_key]["content"]
+                metadata = self._cache[cache_key]["metadata"]
+            else:
+                response = self.http.get(
+                    "getprompt",
+                    {"prompt_name": prompt_name, "label": label, "agent_id": self._config.agent_id},
+                )
+                raw_content = response.get("prompt_content", "")
+                metadata = response.get("metadata", {})
+
+                # Store in cache if caching is enabled
+                if cache_ttl != 0:
+                    self._cache[cache_key] = {
+                        "content": raw_content,
+                        "metadata": metadata,
+                        "timestamp": time.time(),
+                    }
 
             # Replace variables
+            content = raw_content
             if variables:
                 for key, value in variables.items():
-                    prompt = prompt.replace(f"{{{key}}}", str(value))
+                    content = content.replace(f"{{{{{key}}}}}", str(value))
 
-            return prompt
+            return Prompt(raw_content=raw_content, content=content, metadata=metadata)
         except Exception as e:
             if self._production:
                 logger.error(f"[PromptResource] Failed to get prompt: {e}")
-                return ""
+                return Prompt(raw_content="", content="", metadata={})
             raise
 
     async def aget(
@@ -60,25 +120,43 @@ class PromptResource:
         prompt_name: str,
         variables: Optional[Dict[str, Any]] = None,
         label: str = "production",
-    ) -> str:
+        cache_ttl: int = 0,
+    ) -> Prompt:
         """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):
+                raw_content = self._cache[cache_key]["content"]
+                metadata = self._cache[cache_key]["metadata"]
+            else:
+                response = await self.http.aget(
+                    "getprompt",
+                    {"prompt_name": prompt_name, "label": label, "agent_id": self._config.agent_id},
+                )
+                raw_content = response.get("prompt_content", "")
+                metadata = response.get("metadata", {})
+
+                # Store in cache if caching is enabled
+                if cache_ttl != 0:
+                    self._cache[cache_key] = {
+                        "content": raw_content,
+                        "metadata": metadata,
+                        "timestamp": time.time(),
+                    }
 
+            content = raw_content
             if variables:
                 for key, value in variables.items():
-                    prompt = prompt.replace(f"{{{key}}}", str(value))
+                    content = content.replace(f"{{{{{key}}}}}", str(value))
 
-            return prompt
+            return Prompt(raw_content=raw_content, content=content, metadata=metadata)
         except Exception as e:
             if self._production:
                 logger.error(f"[PromptResource] Failed to get prompt: {e}")
-                return ""
+                return Prompt(raw_content="", content="", metadata={})
             raise

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.4.0.dist-info}/METADATA

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

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

@@ -1,6 +1,6 @@
-lucidicai/__init__.py,sha256=gdk3Y-cq-RaTbhBcBE77saBwHSbIvqaScU9gNoTi7_g,1284
+lucidicai/__init__.py,sha256=F60cdLYiZ2P2xh5B1GXzIUFckj-HUwGZimMOAfepXUk,1376
 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=KAvpgWuLzo4HhSHy1vSBApNNplNAfMNyjYjv0fsurHM,5637
 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.4.0.dist-info/METADATA,sha256=8-0BGkaSBc5YCjeVpDV6QFTCgZiCWDnzeY3Y00RcvOg,902
+lucidicai-3.4.0.dist-info/WHEEL,sha256=Xo9-1PvkuimrydujYJAjF7pCkriuXBpUPEjma1nZyJ0,92
+lucidicai-3.4.0.dist-info/top_level.txt,sha256=vSSdM3lclF4I5tyVC0xxUk8eIRnnYXMe1hW-eO91HUo,10
+lucidicai-3.4.0.dist-info/RECORD,,