trodo-python 2.18.0__py3-none-any.whl → 2.18.2__py3-none-any.whl

trodo/__init__.py

@@ -322,7 +322,7 @@ def reset(distinct_id: str) -> ResetResult:
 def get_prompt(
     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,
@@ -330,7 +330,9 @@ def get_prompt(
     """Fetch a managed prompt by name.
 
     Follows the ``production`` label by default; pass ``label`` for a different
-    one or ``version`` to pin exactly.
+    one or ``version`` to pin exactly. ``version`` may be the integer
+    ``version_no`` or a ``version_hash`` (full, or an unambiguous short prefix
+    like ``a3f9c2``) — the hash is the stable identity, so prefer it.
 
     Cached for 60s with stale-while-revalidate, so a Trodo outage degrades
     instead of taking your app down. Pass ``fallback`` to cover cold start::
@@ -524,14 +526,21 @@ def wrap_agent(
     conversation_id: Optional[str] = None,
     parent_run_id: Optional[str] = None,
     metadata: Optional[Dict[str, Any]] = None,
+    user: Optional[Dict[str, Any]] = None,
 ) -> _wrap_agent_ctx:
-    """Wrap a block as an agent run — returns a context manager yielding RunHandle."""
+    """Wrap a block as an agent run — returns a context manager yielding RunHandle.
+
+    ``user`` carries profile traits alongside the run — ``{"properties": ...,
+    "set_once": ..., "fixed_properties": ...}`` — so a request handler can
+    attribute the run and enrich the profile in one round trip.
+    """
     return _get_client().wrap_agent(
         agent_name,
         distinct_id=distinct_id,
         conversation_id=conversation_id,
         parent_run_id=parent_run_id,
         metadata=metadata,
+        user=user,
     )
 
 
@@ -540,14 +549,18 @@ def agent(
     *,
     distinct_id: Optional[str] = None,
     conversation_id: Optional[str] = None,
+    parent_run_id: Optional[str] = None,
     metadata: Optional[Dict[str, Any]] = None,
+    user: Optional[Dict[str, Any]] = None,
 ) -> Callable[[Callable[..., Any]], Callable[..., Any]]:
     """Decorator form of wrap_agent."""
     return _get_client().agent(
         agent_name,
         distinct_id=distinct_id,
         conversation_id=conversation_id,
+        parent_run_id=parent_run_id,
         metadata=metadata,
+        user=user,
     )
 
 
@@ -591,6 +604,7 @@ def start_run(
     parent_run_id: Optional[str] = None,
     metadata: Optional[Dict[str, Any]] = None,
     input: Any = None,
+    user: Optional[Dict[str, Any]] = None,
 ) -> str:
     """Open a Run record without a context manager.
 
@@ -607,6 +621,7 @@ def start_run(
         parent_run_id=parent_run_id,
         metadata=metadata,
         input=input,
+        user=user,
     )
 
 

trodo/client.py

@@ -357,7 +357,9 @@ class TrodoClient:
         *,
         distinct_id: Optional[str] = None,
         conversation_id: Optional[str] = None,
+        parent_run_id: Optional[str] = None,
         metadata: Optional[Dict[str, Any]] = None,
+        user: Optional[Dict[str, Any]] = None,
     ) -> Callable[[Callable[..., Any]], Callable[..., Any]]:
         """Decorator form of wrap_agent."""
 
@@ -368,7 +370,9 @@ class TrodoClient:
                     agent_name,
                     distinct_id=distinct_id,
                     conversation_id=conversation_id,
+                    parent_run_id=parent_run_id,
                     metadata=metadata,
+                    user=user,
                 ) as run:
                     result = fn(*args, **kwargs)
                     run.set_output(result)

{trodo_python-2.18.0.dist-info → trodo_python-2.18.2.dist-info}/METADATA

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

{trodo_python-2.18.0.dist-info → trodo_python-2.18.2.dist-info}/RECORD

@@ -1,5 +1,5 @@
-trodo/__init__.py,sha256=Z24IqU5MsOX2VP6xwWcgpy5UiJb3DniXFmQPiiYlxtQ,26243
-trodo/client.py,sha256=5Uxt0tTLDjuMlXIqqdTbg4uiuISY5u7MTK4F1wahdfc,22281
+trodo/__init__.py,sha256=LxN-qzeCDU_SpYs0gsZQxvdj5PuWd8cOBUqYGk9viLc,26928
+trodo/client.py,sha256=9UYaHZtWPMYdlG2xWVf77PQJ9DfFgN-zobTh60i8_Cc,22453
 trodo/types.py,sha256=eySgUvCXROG2TxtxgiU0MNr5iH0DEcduK8bmYtTKG44,3138
 trodo/user_context.py,sha256=uHCI2WYoOI3cNwdIUEuZdX4VYSu14pzm348ksn6hn_c,8195
 trodo/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -36,7 +36,7 @@ trodo/session/server_session.py,sha256=McsudEiq33XDq3nqxgzBcUvIjQxCMscwEuAPnYXrT
 trodo/session/session_manager.py,sha256=7ht5LeeZX1HLLfPeNV_a8NkXGbHl3up0CRtCGr3EzjQ,2995
 trodo/util/__init__.py,sha256=Z9c4rPPdKg06Kk3byKheDqksSgR4WNvS475oQ5sNljc,54
 trodo/util/lru.py,sha256=QIsM7s6J_E9ZjiXatSyReZIEeGypTAcgrPWWy8YsRa4,2465
-trodo_python-2.18.0.dist-info/METADATA,sha256=Pa8V9NdIZEs6q0o4dyj4WIOBKBmd52xEt-NRQ_LgfUo,25308
-trodo_python-2.18.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-trodo_python-2.18.0.dist-info/top_level.txt,sha256=VCQu1CJWFmNsqTs1YxMcw4Mq35Tc3z3uI9RwHEXAayQ,6
-trodo_python-2.18.0.dist-info/RECORD,,
+trodo_python-2.18.2.dist-info/METADATA,sha256=UnFh9i8kRSmo6JfdHcRWy7dYGm7vGW714FgDC_5ckM8,25308
+trodo_python-2.18.2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+trodo_python-2.18.2.dist-info/top_level.txt,sha256=VCQu1CJWFmNsqTs1YxMcw4Mq35Tc3z3uI9RwHEXAayQ,6
+trodo_python-2.18.2.dist-info/RECORD,,