lucidicai 3.3.0__tar.gz → 3.4.0__tar.gz

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

@@ -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 → lucidicai-3.4.0}/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-3.4.0/lucidicai/api/resources/prompt.py

@@ -0,0 +1,162 @@
+"""Prompt resource API operations."""
+import logging
+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, 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,
+    ) -> 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:
+            A Prompt object with raw_content, content (with variables replaced),
+            and metadata. Use str(prompt) for backward-compatible string access.
+        """
+        try:
+            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():
+                    content = content.replace(f"{{{{{key}}}}}", str(value))
+
+            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 Prompt(raw_content="", content="", metadata={})
+            raise
+
+    async def aget(
+        self,
+        prompt_name: str,
+        variables: Optional[Dict[str, Any]] = None,
+        label: str = "production",
+        cache_ttl: int = 0,
+    ) -> Prompt:
+        """Get a prompt from the prompt database (asynchronous).
+
+        See get() for full documentation.
+        """
+        try:
+            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():
+                    content = content.replace(f"{{{{{key}}}}}", str(value))
+
+            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 Prompt(raw_content="", content="", metadata={})
+            raise

{lucidicai-3.3.0 → lucidicai-3.4.0}/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 → lucidicai-3.4.0}/lucidicai.egg-info/PKG-INFO

@@ -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 → lucidicai-3.4.0}/setup.py

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

lucidicai-3.3.0/lucidicai/api/resources/prompt.py

@@ -1,84 +0,0 @@
-"""Prompt resource API operations."""
-import logging
-from typing import Any, Dict, Optional
-
-from ..client import HttpClient
-
-logger = logging.getLogger("Lucidic")
-
-
-class PromptResource:
-    """Handle prompt-related API operations."""
-
-    def __init__(self, http: HttpClient, production: bool = False):
-        """Initialize prompt resource.
-
-        Args:
-            http: HTTP client instance
-            production: Whether to suppress errors in production mode
-        """
-        self.http = http
-        self._production = production
-
-    def get(
-        self,
-        prompt_name: str,
-        variables: Optional[Dict[str, Any]] = None,
-        label: str = "production",
-    ) -> str:
-        """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").
-
-        Returns:
-            The prompt content with variables interpolated.
-        """
-        try:
-            response = self.http.get(
-                "getprompt",
-                {"prompt_name": prompt_name, "label": label},
-            )
-            prompt = response.get("prompt_content", "")
-
-            # Replace variables
-            if variables:
-                for key, value in variables.items():
-                    prompt = prompt.replace(f"{{{key}}}", str(value))
-
-            return prompt
-        except Exception as e:
-            if self._production:
-                logger.error(f"[PromptResource] Failed to get prompt: {e}")
-                return ""
-            raise
-
-    async def aget(
-        self,
-        prompt_name: str,
-        variables: Optional[Dict[str, Any]] = None,
-        label: str = "production",
-    ) -> 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", "")
-
-            if variables:
-                for key, value in variables.items():
-                    prompt = prompt.replace(f"{{{key}}}", str(value))
-
-            return prompt
-        except Exception as e:
-            if self._production:
-                logger.error(f"[PromptResource] Failed to get prompt: {e}")
-                return ""
-            raise