agentx-python 0.8.12__py3-none-any.whl → 0.8.13__py3-none-any.whl

agentx/integrations/_traced_call.py

@@ -143,6 +143,9 @@ def finish_llm_call(
             input=input_repr,
             output=output,
             model=model,
+            # Stamp the provider literal on a span opened without one (adoption keeps an
+            # explicit framework= or a framework integration's label winning over this).
+            framework=framework,
             input_tokens=input_tokens,
             output_tokens=output_tokens,
             cache_read_tokens=cache_read_tokens,

agentx/monitor/client.py

@@ -268,6 +268,28 @@ class MonitorClient:
         plus deltas vs the prior window and the run-outcome breakdown."""
         return self._request("GET", "/kpis", params={"window": window})
 
+    def metrics(
+        self,
+        window: str = "1d",
+        *,
+        agent: Optional[str] = None,
+        model: Optional[str] = None,
+        tool: Optional[str] = None,
+        framework: Optional[str] = None,
+        status: Optional[str] = None,
+    ) -> dict:
+        """The Monitor metrics grid's data over a window ("1h".."90d") - bucketed spans by kind,
+        latency percentiles, tokens/cost, tool executions and failures, and platform attribution
+        (`frameworks` window totals + per-bucket `byFramework` - the Platforms chart). Optional
+        filters scope every number the way the dashboard's filter chips do; `framework` matches
+        the platform label traces carry (see TRACING.md's Platform detection), with "other"
+        selecting unlabeled traffic."""
+        params = {"window": window}
+        for key, value in (("agent", agent), ("model", model), ("tool", tool), ("framework", framework), ("status", status)):
+            if value is not None:
+                params[key] = value
+        return self._request("GET", "/metrics", params=params)
+
     def topics(self, window: str = "7d") -> dict:
         """The Topics view's data over a window ("24h", "7d", "30d"): LLM-classified themes of
         sampled production traffic with per-topic counts and sentiment. Empty until Topics is

agentx/tracing/framework_detect.py

@@ -0,0 +1,64 @@
+"""Best-effort agent-framework auto-detection (the "platform agnostic" story).
+
+A span whose framework was neither passed explicitly (``tracer.trace(...,
+framework="...")``) nor adopted from a framework integration (callback handler,
+observer, patched client - see ``_TraceSpan._captured_framework``) gets labeled
+by looking at which known ORCHESTRATION framework is actually imported in this
+process. ``sys.modules`` is the signal - imported, not merely installed - so a
+machine with ten frameworks pip-installed but one in use still resolves.
+
+Only unambiguous answers are given: zero or more than one known framework
+loaded means ``None``, and the span goes out unlabeled rather than mislabeled.
+The user's explicit ``framework=`` always wins, including totally custom names
+for platforms this table has never heard of.
+
+Raw provider SDKs (openai, anthropic, google-genai, ...) are deliberately NOT
+in this table: they are transitive dependencies of nearly every framework, so
+their presence says nothing about what orchestrates the agent - and their
+patched-client integrations already stamp the provider literal on the spans
+they create.
+"""
+
+from __future__ import annotations
+
+import sys
+from typing import Optional
+
+# Top-level module name -> the wire literal the matching integration emits.
+# Multiple modules may map to one literal (langgraph is the LangChain family).
+_ORCHESTRATOR_MODULES = {
+    "langchain": "langchain",
+    "langchain_core": "langchain",
+    "langgraph": "langchain",
+    "crewai": "crewai",
+    "llama_index": "llamaindex",
+    "autogen": "autogen",
+    "autogen_agentchat": "autogen",
+    "agents": "openai-agents",  # the OpenAI Agents SDK's import name
+    "google.adk": "google-adk",
+    "semantic_kernel": "semantic-kernel",
+    "haystack": "haystack",
+    "pydantic_ai": "pydantic-ai",
+    "smolagents": "smolagents",
+    "dspy": "dspy",
+}
+
+
+def _looks_like_openai_agents_sdk() -> bool:
+    # "agents" is a name any user package could claim - only trust it when the
+    # OpenAI Agents SDK's own submodules are loaded alongside it.
+    return "agents.run" in sys.modules or "agents.tracing" in sys.modules
+
+
+def detect_framework() -> Optional[str]:
+    """The single unambiguous orchestration framework imported right now, else None."""
+    found: set = set()
+    for module, literal in _ORCHESTRATOR_MODULES.items():
+        if module not in sys.modules:
+            continue
+        if module == "agents" and not _looks_like_openai_agents_sdk():
+            continue
+        found.add(literal)
+        if len(found) > 1:
+            return None
+    return found.pop() if len(found) == 1 else None

agentx/tracing/tracer.py

@@ -14,6 +14,7 @@ from agentx.exceptions import CIGateFailure
 from agentx.tracing.ingest_client import IngestClient
 from agentx.tracing.ci_types import CIRun, CIRunResult, CIRunStatus, CIQuestionScore
 from agentx.tracing.eval_scope import EVAL_RUN_SOURCE, current_eval_run_id
+from agentx.tracing.framework_detect import detect_framework
 
 F = TypeVar("F", bound=Callable[..., Any])
 
@@ -125,6 +126,10 @@ class _TraceSpan:
         # Adopted from a merged child run (e.g. AgentXCallbackHandler) when this span itself
         # wasn't opened with an explicit framework= - see _merge_child_run below.
         self._captured_framework: Optional[str] = None
+        # Best-effort auto-detection (framework_detect.py), resolved once at span open so child
+        # spans emitted mid-flight carry the same label the root will. Lowest precedence:
+        # explicit framework= > integration adoption > this. None when ambiguous.
+        self._detected_framework: Optional[str] = None if framework else detect_framework()
         self._input_tokens: int = 0
         self._output_tokens: int = 0
         # Subsets of _input_tokens (not additional tokens) - a prompt-caching write/read, when the
@@ -191,7 +196,7 @@ class _TraceSpan:
             latency_ms=latency_ms,
             error=self._error,
             metadata=metadata,
-            framework=self._framework or self._captured_framework,
+            framework=self._framework or self._captured_framework or self._detected_framework or detect_framework(),
             model=self._model or self._captured_model,
             tool_calls=self.tool_calls or None,
             session_id=self._session_id,
@@ -235,14 +240,18 @@ class _TraceSpan:
         input: Any = None,
         output: Any = None,
         model: Optional[str] = None,
+        framework: Optional[str] = None,
         input_tokens: Optional[int] = None,
         output_tokens: Optional[int] = None,
         cache_read_tokens: Optional[int] = None,
         cache_write_tokens: Optional[int] = None,
     ) -> None:
         """Record one LLM-call child span (e.g. one patched Anthropic call) under this span -
-        name left unset so _merge_child_run auto-numbers it "LLM Call N"."""
+        name left unset so _merge_child_run auto-numbers it "LLM Call N". ``framework`` lets the
+        patched client stamp its provider literal on a span the user opened without one - the
+        adoption in _merge_child_run keeps explicit/integration labels winning."""
         self._merge_child_run(
+            framework=framework,
             execution_steps=[{
                 "duration_ms": duration_ms,
                 "start_time": start_time,
@@ -301,7 +310,7 @@ class _TraceSpan:
         child = _TraceSpan(
             tracer=self._tracer,
             name=name,
-            framework=framework or self._framework or self._captured_framework,
+            framework=framework or self._framework or self._captured_framework or self._detected_framework,
             model=model,
             session_id=self._session_id,
         )
@@ -397,6 +406,13 @@ class _TraceSpan:
         under this span).
         """
         with self._merge_lock:
+            # Adopt framework/model BEFORE emitting child spans: child_span resolves its
+            # framework from this span's fields, so adopting after the emission loops used to
+            # send every CrewAI/AutoGen child out unlabeled while only the root got stamped.
+            if model and not self._captured_model:
+                self._captured_model = model
+            if framework and not self._captured_framework:
+                self._captured_framework = framework
             for step in [] if not emit_steps else (execution_steps or []):
                 self._child_span_count += 1
                 self.child_span(
@@ -463,10 +479,6 @@ class _TraceSpan:
                 self.input = input
             if output is not None:
                 self.output = output
-            if model and not self._captured_model:
-                self._captured_model = model
-            if framework and not self._captured_framework:
-                self._captured_framework = framework
             if input_tokens:
                 self._input_tokens += input_tokens
             if output_tokens:
@@ -520,7 +532,8 @@ class _TraceSpan:
             # to be called from inside another active span.
             span = self._tracer.trace(
                 self.name, metadata=self._metadata, framework=self._framework, model=self._model,
-                session_id=self._session_id,
+                session_id=self._session_id, sync=self._sync, monitor=self._monitor,
+                pattern_ids=self._pattern_ids, agent_id=self._agent_id, span_kind=self._span_kind,
             )
             span.__enter__()
             try:
@@ -542,7 +555,8 @@ class _TraceSpan:
             # See _wrap_sync's comment - same "fresh span per call" reasoning applies here.
             span = self._tracer.trace(
                 self.name, metadata=self._metadata, framework=self._framework, model=self._model,
-                session_id=self._session_id,
+                session_id=self._session_id, sync=self._sync, monitor=self._monitor,
+                pattern_ids=self._pattern_ids, agent_id=self._agent_id, span_kind=self._span_kind,
             )
             span.__enter__()
             try:
@@ -911,6 +925,22 @@ class Tracer:
 
             with client.tracer.trace("support-agent", agent_id="ag_123", sync=True) as span:
                 span.output = call_llm(...)
+
+        ``framework`` names the platform the agent runs on - tracing is platform agnostic, and
+        this label is how the dashboard's framework filter and Monitor's Platforms chart group
+        traffic. Three ways it gets set, strongest first:
+
+        1. **Explicit**: ``framework="langchain"`` - any string works, including platforms
+           AgentX has no integration for (``framework="my-inhouse-runner"``).
+        2. **Integration**: every integration stamps its own literal automatically -
+           ``langchain``, ``crewai``, ``openai-agents``, ``openai``, ``anthropic``,
+           ``google-genai``, ``google-adk``, ``litellm``, ``llamaindex``, ``autogen``,
+           ``moveworks``, ``databricks``.
+        3. **Auto-detection**: with neither of the above, the SDK labels the span with the one
+           known orchestration framework imported in the process (LangChain/LangGraph, CrewAI,
+           LlamaIndex, AutoGen, OpenAI Agents SDK, Google ADK, Semantic Kernel, Haystack,
+           Pydantic AI, smolagents, DSPy). Ambiguous (several imported) or unknown -> the span
+           goes out unlabeled rather than mislabeled.
         """
         return _TraceSpan(
             tracer=self,

agentx/version.py

@@ -1,7 +1,7 @@
-VERSION = "0.8.12"
+VERSION = "0.8.13"
 
 # The AgentX-trace-eval release this SDK version is tested against - what `agentx-trace-eval`
 # installs and converges to (see agentx/cli.py). Bump together with VERSION when releasing, so
 # every published SDK names a known-good engine+dashboard pair. Users can override with
 # AGENTX_TRACE_EVAL_VERSION=<tag|latest>.
-ENGINE_VERSION = "v0.3.4"
+ENGINE_VERSION = "v0.3.7"

{agentx_python-0.8.12.dist-info → agentx_python-0.8.13.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentx-python
-Version: 0.8.12
+Version: 0.8.13
 Summary: Official Python SDK for AgentX (https://www.agentx.so/)
 Home-page: https://github.com/AgentX-ai/AgentX-python
 Author: Robin Wang and AgentX Team
@@ -252,7 +252,12 @@ extra:
 | LlamaIndex            | `pip install "agentx-python[llamaindex]"`    | `AgentXLlamaIndexHandler` |
 | AutoGen               | `pip install "agentx-python[autogen]"`       | `AgentXAutoGenObserver`   |
 
-Or plain Python - wrap any function with `@tracer.trace(...)` and it just works, no framework required.
+Or plain Python - wrap any function with `@tracer.trace(...)` and it just works, no framework
+required. Tracing is **platform agnostic**: each integration stamps its platform label
+automatically, a plain trace auto-detects the one orchestration framework imported in the
+process, and `framework="any-name"` labels platforms AgentX has never heard of - the label
+drives the dashboard's framework filter and Monitor's Platforms chart. See
+[Platform detection](TRACING.md#platform-detection).
 
 Running specialist agents in parallel with a `ThreadPoolExecutor`? Wrap each worker body in `tracer.use_span(span)` so their steps land on the parent trace instead of becoming independent traces - see [TRACING.md](TRACING.md) for the full pattern.
 

{agentx_python-0.8.12.dist-info → agentx_python-0.8.13.dist-info}/RECORD

@@ -10,7 +10,7 @@ agentx/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 agentx/testing.py,sha256=0shZEid_vhJgBegpO_loUq6APYDxQrUgD3jvcRdIDV8,7372
 agentx/traces.py,sha256=sz9gxutlDKNgf0fdCkyzKsGwK5eMAJuIEl3NIwGrsuo,2287
 agentx/util.py,sha256=lt2Kpg4Fj8whrSuAhLEahcPEIYRVpK9RCC5y9ShdTJs,703
-agentx/version.py,sha256=vsrbVEe8EC1S6DCr1jnhCYco-1GCWOHdaUPGulZoMR0,365
+agentx/version.py,sha256=h93nyZEahmg-F_qXioTJhKMFmXgzcYA3exV9z2on3LQ,365
 agentx/evaluations/__init__.py,sha256=Erv7RGFlRxGTG4rVb2uHhCqLLEX_iAWKqkZKzK6CumE,262
 agentx/evaluations/_term.py,sha256=WFpiNzdgDBeJJ-Gg-6X7TwwxllobuE4OqFUTuDQvS3Y,2529
 agentx/evaluations/client.py,sha256=UlYl8OFmIjk8oqmL_LEpjnTn6CmUPBM1kgVgzkUKfT8,31999
@@ -28,7 +28,7 @@ agentx/evaluations/adapters/http_endpoint.py,sha256=-Gika9lBcXjtbnyB-uNR6nYEVJhW
 agentx/evaluations/adapters/precomputed.py,sha256=vxnQELmpiU2NkQATfiVjG7v1ZmmkrEA70Y11ijfYtHw,1208
 agentx/evaluations/adapters/raw.py,sha256=FkDq_mdf21-xt5EHnGyIGcS6VZxkEkFcmM9VTd-T5sA,1130
 agentx/integrations/__init__.py,sha256=W-EcQhHE01-SGPeKTB2AgfvUyRzNP4BqUMMtP2qQ4Q0,647
-agentx/integrations/_traced_call.py,sha256=IUk2ZSZN8E5Th-WU1s0PcJixLguoh6LQpG8hbnRgqZU,6451
+agentx/integrations/_traced_call.py,sha256=O6f8HKRHDfFwoUIZDtvENVsv_OsHwzuyPMbzBakKVdo,6662
 agentx/integrations/anthropic.py,sha256=HNFiwtljfWsAJOmc2XXseKSVb8ThUr6BZ6CWT7uGv18,10383
 agentx/integrations/autogen.py,sha256=cZryUl45Sdr9t1ba4tkz45XfkvjCud1hPp6pV0auKy8,8863
 agentx/integrations/crewai.py,sha256=AMxAP2Rpdojf2iaMVNcs8_LhnUGJnsS1NaX-w-1Gicc,10703
@@ -43,7 +43,7 @@ agentx/integrations/openai.py,sha256=1KLs-hJaeW2emHPwNkmC3zcGksL3zd87uWbcLGRW704
 agentx/integrations/openai_agents.py,sha256=tCa3kPxqux5LnNNDQ6zA05OybQrjkc_LeE08YuNPJEs,12742
 agentx/monitor/__init__.py,sha256=MLiASSvQnCy2jqVNRTgPWFhUSf8lGYRQeEgEVVhE5Tg,574
 agentx/monitor/agents.py,sha256=8Xk4jWmNTvdtjFixHiLmw4jj96uqIXWIT6KW8zXoWrc,1006
-agentx/monitor/client.py,sha256=XUecRuhWM80_dlKFCHORp9TPWN80XM5SApkGRTFedX4,19724
+agentx/monitor/client.py,sha256=nY1cvjbCqL6BZMY6ubM-Q6JUKGgUM5CdBektV99EArQ,20812
 agentx/monitor/judge_scorers.py,sha256=Mu6OOnfjp1SRkZMcOyriO7zPawv-O2H2l2X-0io5WLM,15025
 agentx/monitor/models.py,sha256=yTC3WTdTziHMkdeAXlTro-4YiSbBUHMgf9kNZHGfPDA,8470
 agentx/monitor/online_evaluators.py,sha256=YWnsBmlIbYvj4LCaX4guwx4HS5y3oEzCQfo6ae9VH_w,8693
@@ -61,11 +61,12 @@ agentx/resources/workforce.py,sha256=lfGVkoV9lcOp-lZScjTvwRarJMkhzfMfLm4syJDujGc
 agentx/tracing/__init__.py,sha256=l2mIRILE-wWrCD0fekgrIOQUEvtDObzdrkgpQUtXroU,408
 agentx/tracing/ci_types.py,sha256=zFVcZGvc1qbVDdOlEPQ1i5R6terqJHxCzFF4ZjouxxI,1423
 agentx/tracing/eval_scope.py,sha256=ElMbPxpqpQBVuaUnHNlw9RIQu71oyOpd0yR55bDH8eI,2144
+agentx/tracing/framework_detect.py,sha256=uV4O7Th-4_2UkdooAyaWCOIA0jwLJbblFQ_ucFDjeJM,2638
 agentx/tracing/ingest_client.py,sha256=spnm6bV3NXGuj2w7HwdKiJdKDJWRUFmSP3jl3rcGqkQ,18202
-agentx/tracing/tracer.py,sha256=qQojU-T4O8IJKyf9vue0Em66qPBTZKl3FMyr3KJKPnI,53770
-agentx_python-0.8.12.dist-info/licenses/LICENSE,sha256=gZVsM-nLsE8vlaY6NXXsVoo6IlCClxkToAWmhgT3y_s,10762
-agentx_python-0.8.12.dist-info/METADATA,sha256=3uZCbOgUOxHRzbygAFJTbVulNQqgXZONs0jMig7uGYc,20768
-agentx_python-0.8.12.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-agentx_python-0.8.12.dist-info/entry_points.txt,sha256=rQqF1JTY3T1yfviBU1r8PU-5mBdfOk6P4bZ1L4BskIM,172
-agentx_python-0.8.12.dist-info/top_level.txt,sha256=s-q-HB9Gb_QdrZNacSeQyF_c25gQooMy7DlxzgLOHPk,7
-agentx_python-0.8.12.dist-info/RECORD,,
+agentx/tracing/tracer.py,sha256=TxY6zG6hbM81jpfrqP4imaEvoyy_hnJVUSTnoAVHMG0,56240
+agentx_python-0.8.13.dist-info/licenses/LICENSE,sha256=gZVsM-nLsE8vlaY6NXXsVoo6IlCClxkToAWmhgT3y_s,10762
+agentx_python-0.8.13.dist-info/METADATA,sha256=cit9iBc_TXXOlcp8AObpzlXdbx3FLuaVTbBsBdggcJ8,21154
+agentx_python-0.8.13.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+agentx_python-0.8.13.dist-info/entry_points.txt,sha256=rQqF1JTY3T1yfviBU1r8PU-5mBdfOk6P4bZ1L4BskIM,172
+agentx_python-0.8.13.dist-info/top_level.txt,sha256=s-q-HB9Gb_QdrZNacSeQyF_c25gQooMy7DlxzgLOHPk,7
+agentx_python-0.8.13.dist-info/RECORD,,