trodo-python 2.13.0__tar.gz → 2.14.0__tar.gz

{trodo_python-2.13.0 → trodo_python-2.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trodo-python
-Version: 2.13.0
+Version: 2.14.0
 Summary: Trodo Analytics SDK for Python — server-side event tracking
 License: ISC
 Keywords: analytics,tracking,trodo,server-side

{trodo_python-2.13.0 → trodo_python-2.14.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "trodo-python"
-version = "2.13.0"
+version = "2.14.0"
 description = "Trodo Analytics SDK for Python — server-side event tracking"
 readme = "README.md"
 license = { text = "ISC" }

{trodo_python-2.13.0 → trodo_python-2.14.0}/trodo/managers/prompt_manager.py

@@ -16,7 +16,7 @@ from __future__ import annotations
 
 import threading
 import time
-from typing import Any, Callable, Dict, List, Optional, Set
+from typing import Any, Callable, Dict, List, Optional, Set, Union
 
 from ..prompts.compile import CompileError, compile_prompt
 from ..prompts.template import TemplateError, render
@@ -38,7 +38,7 @@ __all__ = [
 DEFAULT_TTL_SECONDS = 60.0
 
 
-def _cache_key(name: str, version: Optional[int], label: Optional[str]) -> str:
+def _cache_key(name: str, version: Optional[Union[int, str]], label: Optional[str]) -> str:
     # Resolution happens server-side on every fetch; the client only caches
     # under whatever selector was asked for. So a label flip propagates within
     # one TTL without the client knowing anything about labels.
@@ -73,6 +73,9 @@ def _to_prompt(raw: Dict[str, Any], is_fallback: bool = False) -> ManagedPrompt:
         description=raw.get("description"),
         tags=list(raw.get("tags") or []),
         version=int(raw.get("version") or 0),
+        version_hash=raw.get("version_hash"),
+        content_hash=raw.get("content_hash"),
+        parent_hash=raw.get("parent_hash"),
         labels=list(raw.get("labels") or []),
         messages=list(raw.get("messages") or []),
         model=dict(raw.get("model") or {}),
@@ -172,7 +175,7 @@ class PromptManager:
         self,
         name: str,
         label: Optional[str] = None,
-        version: Optional[int] = None,
+        version: Optional[Union[int, str]] = None,
         cache_ttl_seconds: Optional[float] = None,
         fallback: Optional[Dict[str, Any]] = None,
         max_retries: int = 2,
@@ -181,7 +184,8 @@ class PromptManager:
 
         Without arguments you get the version labelled ``production``; pass
         ``label`` to follow a different deploy label, or ``version`` to pin
-        exactly.
+        exactly. ``version`` may be the integer ``version_no`` or a
+        ``version_hash`` (full, or an unambiguous short prefix like ``a3f9c2``).
 
         Availability ladder — fresh cache -> stale cache -> ``fallback`` ->
         raise. A prompt fetch is on your hot path, so a Trodo outage degrades

{trodo_python-2.13.0 → trodo_python-2.14.0}/trodo/prompts/types.py

@@ -59,6 +59,13 @@ class ManagedPrompt:
     response_format: Optional[ResponseFormat] = None
     variables: List[PromptVariable] = field(default_factory=list)
     version: int = 0
+    #: Git-style commit id of this version (content + parent + message + author
+    #: + time). Stable and immutable — the recommended way to reference a version.
+    version_hash: Optional[str] = None
+    #: sha256 of the content; identical content shares it.
+    content_hash: Optional[str] = None
+    #: The preceding version's ``version_hash`` (None for the first).
+    parent_hash: Optional[str] = None
     labels: List[str] = field(default_factory=list)
     tags: List[str] = field(default_factory=list)
     description: Optional[str] = None

{trodo_python-2.13.0 → trodo_python-2.14.0}/trodo_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trodo-python
-Version: 2.13.0
+Version: 2.14.0
 Summary: Trodo Analytics SDK for Python — server-side event tracking
 License: ISC
 Keywords: analytics,tracking,trodo,server-side