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

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

@@ -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 → trodo_python-2.14.0}/pyproject.toml

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

{trodo_python-2.12.0 → trodo_python-2.14.0}/tests/test_prompts.py

@@ -81,7 +81,7 @@ PROMPT = {
         {"role": "system", "content": [{"type": "text", "text": "You are {{persona}}."}]},
         {"role": "user", "content": [{"type": "text", "text": "Hello {{who}}"}]},
     ],
-    "model_config": {"provider": "openai", "model": "gpt-4o", "temperature": 0.3},
+    "model": {"provider": "openai", "model": "gpt-4o", "temperature": 0.3},
     "tools": [],
     "response_format": None,
     "variables": [
@@ -99,7 +99,7 @@ def test_compile_returns_structured_messages_not_a_string():
     assert out.messages[1]["content"][0] == {"type": "text", "text": "Hello world"}
 
 
-def test_compile_carries_model_config_and_tools():
+def test_compile_carries_model_and_tools():
     out = compile_prompt(PROMPT, {"who": "world"})
     assert out.model == {"provider": "openai", "model": "gpt-4o", "temperature": 0.3}
     assert out.tools == []
@@ -132,7 +132,7 @@ def test_compile_treats_values_as_inert_data():
 def test_compile_coerces_declared_types():
     p = {
         "messages": [{"role": "user", "content": [{"type": "text", "text": "n={{n}}"}]}],
-        "model_config": {},
+        "model": {},
         "tools": [],
         "response_format": None,
         "variables": [{"name": "n", "type": "number"}],
@@ -148,7 +148,7 @@ def test_compile_expands_placeholders_and_preserves_injected_messages():
             {"role": "system", "content": [{"type": "text", "text": "sys"}]},
             {"type": "placeholder", "name": "hist"},
         ],
-        "model_config": {},
+        "model": {},
         "tools": [],
         "response_format": None,
         "variables": [{"name": "hist", "type": "messages"}],
@@ -211,7 +211,7 @@ def test_get_maps_wire_shape_and_binds_compile():
     assert p.version == 2
     assert p.labels == ["production"]
     assert p.tags == ["support"]
-    assert p.model_config["model"] == "gpt-4o"
+    assert p.model["model"] == "gpt-4o"
     assert p.is_fallback is False
     assert p.compile(who="world").messages[1]["content"][0]["text"] == "Hello world"
 

{trodo_python-2.12.0 → trodo_python-2.14.0}/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_python-2.12.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,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_python-2.12.0 → trodo_python-2.14.0}/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_python-2.12.0 → trodo_python-2.14.0}/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 → trodo_python-2.14.0}/trodo_python.egg-info/PKG-INFO

@@ -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