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

trodo/__init__.py

@@ -41,7 +41,7 @@ Downstream microservice (join the caller's run instead of making a new one):
 
 from __future__ import annotations
 
-__version__ = "2.12.0"
+__version__ = "2.13.0"
 
 from typing import Any, Callable, Dict, List, Optional, Union
 

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,9 +73,12 @@ 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_config=dict(raw.get("model_config") or {}),
+        model=dict(raw.get("model") or {}),
         tools=list(raw.get("tools") or []),
         response_format=raw.get("response_format"),
         variables=_to_variables(raw.get("variables")),
@@ -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
@@ -245,7 +249,7 @@ class PromptManager:
                         "labels": [],
                         "tags": [],
                         "messages": fallback.get("messages") or [],
-                        "model_config": fallback.get("model_config") or {},
+                        "model": fallback.get("model") or {},
                         "tools": [],
                         "response_format": None,
                         "variables": fallback.get("variables") or [],

trodo/prompts/compile.py

@@ -175,7 +175,7 @@ def compile_prompt(prompt: Any, values: Optional[Dict[str, Any]] = None) -> Comp
 
     return CompiledPrompt(
         messages=out,
-        model=get("model_config") or {},
+        model=get("model") or {},
         tools=get("tools") or [],
         response_format=get("response_format"),
     )

trodo/prompts/types.py

@@ -54,11 +54,18 @@ class ManagedPrompt:
 
     name: str
     messages: List[PromptNode] = field(default_factory=list)
-    model_config: ModelConfig = field(default_factory=dict)
+    model: ModelConfig = field(default_factory=dict)
     tools: List[PromptTool] = field(default_factory=list)
     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.12.0.dist-info → trodo_python-2.14.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trodo-python
-Version: 2.12.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.12.0.dist-info → trodo_python-2.14.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-trodo/__init__.py,sha256=F5asTaDmKcWtk6NJ_DVr4wo1S4HoYMWFiiyqHHDNSvE,21167
+trodo/__init__.py,sha256=9VvBIbahXhuKln5593dCq29dan1IN7xFHU0voW4SDqs,21167
 trodo/client.py,sha256=z2q1HZKQNENycv9CRD0kOfwEhmz3Ti9_B-uPsqpvY3U,19454
 trodo/types.py,sha256=eySgUvCXROG2TxtxgiU0MNr5iH0DEcduK8bmYtTKG44,3138
 trodo/user_context.py,sha256=9la6azzwEanVmdP4ps_xMoufbeWVeIGU-M8ychmgajg,7859
@@ -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=Ub7rlg3dVVllr6qBf6sXLGvunnP_7FLeGEOal6sYFPY,10448
+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
@@ -21,16 +21,16 @@ trodo/otel/register.py,sha256=bV_ePTfUvPugig2GZnylhzxi2QfoPWs96A9mGLPMrSQ,9387
 trodo/otel/transport.py,sha256=hzZz8gwSMGJ8CxdijmLn1Ljt18owr9XTWy13DLbwYbw,2441
 trodo/otel/wrap_agent.py,sha256=_nFDhxPyl0RlNKj29cBNeRc_zAY5FUiHvTiNUWxTt0M,39049
 trodo/prompts/__init__.py,sha256=yunNc8WkTSfEEkRR-NZWXAt_ZB3Ee2INRh-4RE7uHj4,806
-trodo/prompts/compile.py,sha256=Jqy1yaSE1j931KIHP1opMpEEmBKHv-I4BUq-1xaNVWA,6352
+trodo/prompts/compile.py,sha256=sEMl8EWdK0G9uOKGcgc39ujnA5RLCUtbk26TYVqK68Q,6345
 trodo/prompts/template.py,sha256=obQiivPCR6LEdz7q1cby7uL25tYHYui4aoEaiUNqWfs,9357
-trodo/prompts/types.py,sha256=iCNoJk6_kk0JvEblGsDm6c9lEdQW6ixOOv6aCG6IP-k,2924
+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.12.0.dist-info/METADATA,sha256=pvC-YSCsk3GkCPdxnNGUkbgT-ZLBWIgO-MWLxqzzcrA,23115
-trodo_python-2.12.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
-trodo_python-2.12.0.dist-info/top_level.txt,sha256=VCQu1CJWFmNsqTs1YxMcw4Mq35Tc3z3uI9RwHEXAayQ,6
-trodo_python-2.12.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,,