lucidicai 3.3.1__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.1"
+__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,6 +1,7 @@
 """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
@@ -11,6 +12,18 @@ if TYPE_CHECKING:
 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."""
 
@@ -52,7 +65,7 @@ class PromptResource:
         variables: Optional[Dict[str, Any]] = None,
         label: str = "production",
         cache_ttl: int = 0,
-    ) -> str:
+    ) -> Prompt:
         """Get a prompt from the prompt database.
 
         Args:
@@ -63,38 +76,43 @@ class PromptResource:
                        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:
             cache_key = (prompt_name, label)
 
             # Check cache
             if self._is_cache_valid(cache_key, cache_ttl):
-                prompt = self._cache[cache_key]["content"]
+                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},
                 )
-                prompt = response.get("prompt_content", "")
+                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": prompt,
+                        "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(
@@ -103,7 +121,7 @@ class PromptResource:
         variables: Optional[Dict[str, Any]] = None,
         label: str = "production",
         cache_ttl: int = 0,
-    ) -> str:
+    ) -> Prompt:
         """Get a prompt from the prompt database (asynchronous).
 
         See get() for full documentation.
@@ -113,28 +131,32 @@ class PromptResource:
 
             # Check cache
             if self._is_cache_valid(cache_key, cache_ttl):
-                prompt = self._cache[cache_key]["content"]
+                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},
                 )
-                prompt = response.get("prompt_content", "")
+                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": prompt,
+                        "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-3.3.1.dist-info → lucidicai-3.4.0.dist-info}/METADATA

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

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

@@ -1,4 +1,4 @@
-lucidicai/__init__.py,sha256=Dur2YTPgHbjFM09QQ36SHOHE0B62uFb5dIUHKo4oy7g,1284
+lucidicai/__init__.py,sha256=F60cdLYiZ2P2xh5B1GXzIUFckj-HUwGZimMOAfepXUk,1376
 lucidicai/action.py,sha256=sPRd1hTIVXDqnvG9ZXWEipUFh0bsXcE0Fm7RVqmVccM,237
 lucidicai/client.py,sha256=BGKP91_Oj5kHQU0osYf1T_BWakL8KIhs0AgUc5X99sU,15104
 lucidicai/constants.py,sha256=zN8O7TjoRHRlaGa9CZUWppS73rhzKGwaEkF9XMTV0Cg,1160
@@ -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=5pIV3vTfOQkovQpINohDVseY678E04CWz2E5V4NA-i8,4625
+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.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,,
+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,,