trodo-python 2.13.0__py3-none-any.whl → 2.14.0__py3-none-any.whl

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/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.dist-info → trodo_python-2.14.0.dist-info}/METADATA

@@ -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.dist-info → trodo_python-2.14.0.dist-info}/RECORD

@@ -11,7 +11,7 @@ trodo/auto/auto_event_manager.py,sha256=cztuRsRkNoJE5R4NfSfTrTJTGl4jx2Yb-Ncy0aVA
 trodo/managers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 trodo/managers/group_manager.py,sha256=ki3Se3qEoSZfREX63oeDeBmEfZF-ISHLE8azEtLg0tM,3542
 trodo/managers/people_manager.py,sha256=mMVnx40Mlifx6NGgChvohC9ViK6dQu2mkXNHbV8pK1E,2882
-trodo/managers/prompt_manager.py,sha256=vdii9mgsa5_M7Ewii3mcx6M9xJu_eJBRx_FoGQBII9E,10420
+trodo/managers/prompt_manager.py,sha256=kyQFdty7l7w7ngzsHw6zs1bgL4oa1Lj3ugMPxakrMqM,10719
 trodo/otel/__init__.py,sha256=yiRFXWUU45bAM2CV37XeO7zf1hmnmjufdP4XO50yEyE,624
 trodo/otel/auto_instrument.py,sha256=hJesQMOOp86U66PampcGNINmBVvwVuU_WHVrbUMauug,20895
 trodo/otel/context.py,sha256=iJ1rE42-SbO8VZHAxhIl2ZJXgNwLIVps5xLg8GKgfFc,1165
@@ -23,14 +23,14 @@ trodo/otel/wrap_agent.py,sha256=_nFDhxPyl0RlNKj29cBNeRc_zAY5FUiHvTiNUWxTt0M,3904
 trodo/prompts/__init__.py,sha256=yunNc8WkTSfEEkRR-NZWXAt_ZB3Ee2INRh-4RE7uHj4,806
 trodo/prompts/compile.py,sha256=sEMl8EWdK0G9uOKGcgc39ujnA5RLCUtbk26TYVqK68Q,6345
 trodo/prompts/template.py,sha256=obQiivPCR6LEdz7q1cby7uL25tYHYui4aoEaiUNqWfs,9357
-trodo/prompts/types.py,sha256=jAlxy4-Wj7FUH3hoX-XG2dymwdZv6HZWtWAU8ZF1StY,2917
+trodo/prompts/types.py,sha256=RhvYSuXCrwnZHu5TftObIAs-TQa2E7v08alNmD62x4s,3327
 trodo/queue/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 trodo/queue/batch_flusher.py,sha256=4Lg6T3Urwi9U0Q4FpFGPmjDYKg4ZliCTR-ND8BJvWaY,1298
 trodo/queue/event_queue.py,sha256=EVFZrhlq_kwC3jJ2GK0wMhHISf9UzLCZNDnT_aZ2I2A,872
 trodo/session/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 trodo/session/server_session.py,sha256=McsudEiq33XDq3nqxgzBcUvIjQxCMscwEuAPnYXrTjs,2136
 trodo/session/session_manager.py,sha256=JrgH1VeicmtlxPR4dXEuJbxhi23OelkgwW3-9Slv80o,2525
-trodo_python-2.13.0.dist-info/METADATA,sha256=HxXOZvtOQo-X2QNd0HQVo2jEAQUnCrkkRpwMM9tdHUw,23115
-trodo_python-2.13.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
-trodo_python-2.13.0.dist-info/top_level.txt,sha256=VCQu1CJWFmNsqTs1YxMcw4Mq35Tc3z3uI9RwHEXAayQ,6
-trodo_python-2.13.0.dist-info/RECORD,,
+trodo_python-2.14.0.dist-info/METADATA,sha256=RCejgO9mpxqpdJhLGakkYLLVCzSB0ZJXwdFMQFrkXP8,23115
+trodo_python-2.14.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+trodo_python-2.14.0.dist-info/top_level.txt,sha256=VCQu1CJWFmNsqTs1YxMcw4Mq35Tc3z3uI9RwHEXAayQ,6
+trodo_python-2.14.0.dist-info/RECORD,,