trodo-python 2.10.11__py3-none-any.whl → 2.11.0__py3-none-any.whl

trodo/__init__.py

@@ -19,7 +19,8 @@ Raw-HTTP LLM caller (no OTel integration for your client):
         model='gemini-2.5-flash', provider='google',
         input_tokens=resp['usageMetadata']['promptTokenCount'],
         output_tokens=resp['usageMetadata']['candidatesTokenCount'],
-        prompt=body, completion=resp,
+        prompt=body['messages'],  # the chat-message list sent to the model
+        completion=resp,
     )
 
 Custom tool:
@@ -40,7 +41,7 @@ Downstream microservice (join the caller's run instead of making a new one):
 
 from __future__ import annotations
 
-__version__ = "2.10.11"
+__version__ = "2.11.0"
 
 from typing import Any, Callable, Dict, List, Optional, Union
 

trodo/otel/helpers.py

@@ -297,6 +297,12 @@ def llm(
     fall back to scalar-only extraction, or ``extract_usage_map=lambda r: {..}``
     to build the map yourself.
 
+    The wrapped function's arguments become the span input. For the AI-score
+    detectors to see per-role content, pass the model call's chat-message list
+    (``[{"role", "content"}, ...]`` — roles system/user/assistant/tool +
+    ``context`` for RAG docs) so the span input is exactly what the model
+    receives.
+
     Usage::
 
         answer = trodo.llm(
@@ -470,12 +476,18 @@ def track_llm_call(
     ``usage_details`` map, or a raw provider ``usage`` object to auto-extract
     from (e.g. ``resp['usage']`` or ``resp['usageMetadata']``).
 
+    ``prompt`` — prefer the chat-message list you sent to the model
+    (``[{"role", "content"}, ...]``, roles system/user/assistant/tool +
+    ``context`` for RAG docs, any order, multiple per role). The backend
+    embeds each role separately, which powers the AI-score detectors. A plain
+    string or dict is stored as one opaque input.
+
     Usage:
         resp = httpx.post(url, json=body).json()
         trodo.track_llm_call(
             model='claude-sonnet-4', provider='anthropic',
             usage=resp['usage'],          # cache fields captured automatically
-            prompt=body, completion=resp,
+            prompt=body['messages'], completion=resp,
         )
     """
     if get_active_context() is None:

trodo/otel/wrap_agent.py

@@ -29,7 +29,7 @@ import time
 import traceback
 import uuid
 from datetime import datetime, timezone
-from typing import Any, Callable, Dict, Optional, Union
+from typing import Any, Callable, Dict, List, Optional, Union
 
 from .context import ActiveSpanContext, get_active_context, run_with_context
 from .processor import TrodoSpanProcessor, TrodoRun, TrodoSpan
@@ -149,16 +149,19 @@ def _resolve_error(handle, exc_type, exc, tb) -> Dict[str, Optional[str]]:
             "status_code": None, "stack_trace": None, "level": None}
 
 
-def _prepare_value(value: Any, max_len: int = _MAX_VALUE_LEN) -> Optional[Union[str, Dict[str, Any]]]:
+def _prepare_value(value: Any, max_len: int = _MAX_VALUE_LEN) -> Optional[Union[str, Dict[str, Any], List[Any]]]:
     """Prepare a value for storage in the JSONB input/output column.
 
-    Dicts/lists pass through as-is (stored as JSONB objects/arrays).
-    Strings are truncated at max_len.
+    Dicts/lists pass through as-is (stored as JSONB objects/arrays). For LLM
+    span inputs, prefer a chat-message list ``[{"role", "content"}, ...]``
+    (roles system/user/assistant/tool + ``context`` for RAG docs, any order,
+    multiple per role) — the backend embeds each role separately and the
+    AI-score detectors key on them. Strings are truncated at max_len.
     Everything else is JSON-serialised then truncated.
     """
     if value is None:
         return None
-    if isinstance(value, dict):
+    if isinstance(value, (dict, list)):
         return value
     if isinstance(value, str):
         return value[:max_len] if len(value) > max_len else value
@@ -248,6 +251,9 @@ class RunHandle:
         self.error_type: Optional[str] = None
 
     def set_input(self, value: Any) -> None:
+        """Set the run input. Prefer a chat-message list
+        ``[{"role": "user", "content": ...}, ...]`` — the backend embeds the
+        user messages as the run's semantic input."""
         self.input = _prepare_value(value)
 
     def set_output(self, value: Any) -> None:
@@ -337,6 +343,11 @@ class SpanHandle:
         return self.error_message is not None or self.error_type is not None
 
     def set_input(self, value: Any) -> None:
+        """Set the span input. For LLM spans prefer a chat-message list
+        ``[{"role", "content"}, ...]`` (roles system/user/assistant/tool +
+        ``context`` for RAG docs, any order, multiple per role) — each role is
+        embedded separately and powers the AI-score detectors. Anything else
+        is stored as one opaque input."""
         self.input = _prepare_value(value)
 
     def set_output(self, value: Any) -> None:

{trodo_python-2.10.11.dist-info → trodo_python-2.11.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trodo-python
-Version: 2.10.11
+Version: 2.11.0
 Summary: Trodo Analytics SDK for Python — server-side event tracking
 License: ISC
 Keywords: analytics,tracking,trodo,server-side
@@ -250,6 +250,30 @@ search = trodo.retrieval('vector_search', vector_search)
 docs = search(query)
 ```
 
+### LLM span input: the chat-message list
+
+For LLM spans, set the input to the **same messages you send to the model** —
+a chat-message list, not one blob:
+
+```python
+span.set_input([
+    {"role": "system", "content": system_prompt},        # rules & role
+    {"role": "context", "content": retrieved_docs},      # RAG docs (Trodo extension)
+    {"role": "user", "content": "Where is my order?"},
+    {"role": "assistant", "content": None, "tool_calls": [...]},
+    {"role": "tool", "content": '{"status": "shipped"}', "tool_call_id": "c1"},
+    {"role": "user", "content": "When will it arrive?"},  # multiple turns are fine
+])
+```
+
+Roles: the standard `system` / `user` / `assistant` / `tool` plus `context` —
+a Trodo extension for RAG / retrieved documents. Any order, any number per
+role; aliases `developer` / `model` / `function` normalise automatically.
+Trodo embeds the input as a whole **and each role separately**, which powers
+the AI-score detectors (system → rule adherence; user → trajectory/echo;
+context else tool+assistant → grounding, contradiction, factual retention).
+A plain string still works and is embedded as one vector.
+
 ### Raw-HTTP escape hatches
 
 If your LLM client isn't OTel-instrumented and you can't wrap it as a
@@ -261,7 +285,8 @@ trodo.track_llm_call(
     model='gemini-2.5-flash', provider='google',
     input_tokens=resp['usageMetadata']['promptTokenCount'],
     output_tokens=resp['usageMetadata']['candidatesTokenCount'],
-    prompt=body, completion=resp,
+    prompt=body['messages'],  # the chat-message list sent to the model
+    completion=resp,
 )
 ```
 

{trodo_python-2.10.11.dist-info → trodo_python-2.11.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-trodo/__init__.py,sha256=aUErMBjRUxOxfmsKnCMtBNIwcgAObOPu06zGy1YW9fc,18167
+trodo/__init__.py,sha256=fZ9qn_ObzXX7WLpEnhnlivN6sASv-u9vYXw_IWGNkf0,18229
 trodo/client.py,sha256=dhGiOJmxdWmXDDDabHN865_cAxttJs9LWPeDwEFbAwI,19107
 trodo/types.py,sha256=eySgUvCXROG2TxtxgiU0MNr5iH0DEcduK8bmYtTKG44,3138
 trodo/user_context.py,sha256=9la6azzwEanVmdP4ps_xMoufbeWVeIGU-M8ychmgajg,7859
@@ -14,18 +14,18 @@ trodo/managers/people_manager.py,sha256=mMVnx40Mlifx6NGgChvohC9ViK6dQu2mkXNHbV8p
 trodo/otel/__init__.py,sha256=yiRFXWUU45bAM2CV37XeO7zf1hmnmjufdP4XO50yEyE,624
 trodo/otel/auto_instrument.py,sha256=hJesQMOOp86U66PampcGNINmBVvwVuU_WHVrbUMauug,20895
 trodo/otel/context.py,sha256=iJ1rE42-SbO8VZHAxhIl2ZJXgNwLIVps5xLg8GKgfFc,1165
-trodo/otel/helpers.py,sha256=4HsjMOrE-7zuvaRSiGXxV7ZyfXQ5gLxtR3HdpLut9sk,20054
+trodo/otel/helpers.py,sha256=XOMWcgZHaq5SQbkFxDaXPE4CDFjn01xjJmJ1vIxvwpw,20730
 trodo/otel/processor.py,sha256=aqcTmzTw9cESgIp829pu_XCa5_dG_2MaeJNsqJZeqQU,7495
 trodo/otel/register.py,sha256=bV_ePTfUvPugig2GZnylhzxi2QfoPWs96A9mGLPMrSQ,9387
 trodo/otel/transport.py,sha256=hzZz8gwSMGJ8CxdijmLn1Ljt18owr9XTWy13DLbwYbw,2441
-trodo/otel/wrap_agent.py,sha256=CWzu_yUwHYft5lvi4uY8LX3ceQvCjH8HYLbyM0xOk0s,38220
+trodo/otel/wrap_agent.py,sha256=_nFDhxPyl0RlNKj29cBNeRc_zAY5FUiHvTiNUWxTt0M,39049
 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.10.11.dist-info/METADATA,sha256=prtRZUT6xKP4qPbLFha6dIiOAaUbkKANEdBqsYRZGgY,20484
-trodo_python-2.10.11.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
-trodo_python-2.10.11.dist-info/top_level.txt,sha256=VCQu1CJWFmNsqTs1YxMcw4Mq35Tc3z3uI9RwHEXAayQ,6
-trodo_python-2.10.11.dist-info/RECORD,,
+trodo_python-2.11.0.dist-info/METADATA,sha256=kfO84FYYYUexa79fxuSjkj3ou4NJU1xTVeFAHYewz7M,21698
+trodo_python-2.11.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+trodo_python-2.11.0.dist-info/top_level.txt,sha256=VCQu1CJWFmNsqTs1YxMcw4Mq35Tc3z3uI9RwHEXAayQ,6
+trodo_python-2.11.0.dist-info/RECORD,,