agentx-python 0.8.12__tar.gz → 0.8.14__tar.gz

{agentx_python-0.8.12 → agentx_python-0.8.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentx-python
-Version: 0.8.12
+Version: 0.8.14
 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
@@ -8,7 +8,7 @@ Author-email: contact@agentx.so
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.6
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: urllib3>=1.26.11
@@ -50,6 +50,7 @@ Requires-Dist: litellm>=1.0.0; extra == "all"
 Requires-Dist: llama-index-core>=0.10.0; extra == "all"
 Requires-Dist: autogen-agentchat>=0.4.0; extra == "all"
 Requires-Dist: autogen-core>=0.4.0; extra == "all"
+Requires-Dist: mlflow>=3.6.0; extra == "all"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -109,12 +110,14 @@ pip install --upgrade agentx-python
 
 Requires Python 3.9 or newer.
 
-#### Run self host eval framework locally
+#### Run the self-host governance suite locally
 
-```
-agentx-trace-eval --dev --update
+```bash
+agentx-trace-eval --dev
 ```
 
+(See [Self-host](#self-host) below for what this downloads and how to point the SDK at it.)
+
 ---
 
 ## Quick start
@@ -137,7 +140,7 @@ report = (
     .analyze()
 )
 
-print(report.average_rating)   # LLM-graded score, 0–10
+print(report.average_rating)   # LLM-graded score, 0-10
 print(report.summary)          # AI-generated narrative from .analyze()
 ```
 
@@ -158,9 +161,9 @@ report = (
     .analyze()
 )
 
-print(report.average_rating)       # LLM-graded score, 0–10
-print(report.cosine_similarity)    # embedding cosine, 0–1 (None if not enabled)
-print(report.jaccard_similarity)   # token-set overlap, 0–1 (None if not enabled)
+print(report.average_rating)       # LLM-graded score, 0-10
+print(report.cosine_similarity)    # embedding cosine, 0-1 (None if not enabled)
+print(report.jaccard_similarity)   # token-set overlap, 0-1 (None if not enabled)
 
 print(report.summary)              # AI-generated narrative from .analyze()
 print(report.recommendations)      # list of prioritized, actionable fixes
@@ -184,7 +187,7 @@ client.evaluations.run(
 
 See [Prompt registry](EVALUATIONS.md#prompt-registry) in the full guide, or [self-host's docs](https://docs.agentx.so/improve/prompt-management) for the "Suggest improvement" dashboard flow (self-host only - no hosted-SaaS equivalent yet).
 
-On self-host, a finalized run can also **gate a CI job**: `run.gate(fail_under=7, no_regression=True)` (on the run context `.execute()` returns) checks the run's average rating against an absolute floor and/or the dataset's previous run, prints per-check verdicts into the CI log, and returns an exit code - `sys.exit(gate.exit_code)` blocks the merge on regression. Recorded gates appear in the dashboard's CI Gates tab. See [self-host's CI docs](https://docs.agentx.so/integrations/self-host-ci) for the GitHub Actions recipe.
+On self-host, a finalized run can also **gate a CI job**: `run.gate(fail_under=7, no_regression=True)` (on the run context `.execute()` returns) checks the run's average rating against an absolute floor and/or the dataset's previous run, prints per-check verdicts into the CI log, and returns a `GateResult` - `sys.exit(gate.exit_code)` blocks the merge on regression. Recorded gates appear in the dashboard's CI Gates tab. See [self-host's CI docs](https://docs.agentx.so/integrations/self-host-ci) for the GitHub Actions recipe.
 
 See **[EVALUATIONS.md](EVALUATIONS.md)** for the full guide - dataset builder, framework adapters, similarity metrics, smoke testing, judge configuration, prompt registry, and the complete API reference.
 
@@ -252,7 +255,16 @@ 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.
+Two more platforms are covered by **pull importers** rather than in-process hooks, each with its
+own CLI: `agentx-moveworks` (Moveworks Data API sync, no extra needed) and `agentx-databricks`
+(`pip install "agentx-python[databricks]"`, MLflow/Databricks trace sync).
+
+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.
 
@@ -287,12 +299,14 @@ for signal in client.monitor.signals.list(severity="high"):
     print(signal.summary, signal.occurrence_count)
 ```
 
-Per-agent coverage/threshold settings (sample rate, retention, and threshold overrides like the built-in "Latency regression" pattern's threshold) are `client.monitor.profile.get()`/`.update()`:
+Per-agent monitoring settings (enable/disable, detection categories, notification channels) are `client.monitor.profile.get()`/`.update()`:
 
 ```python
-client.monitor.profile.update("agent_123", threshold_overrides={"latencyMs": 15000})
+client.monitor.profile.update("agent_123", info_detection_enabled=False)
 ```
 
+On self-host, coverage mode, sample rate, retention, and the built-in latency threshold are project-level defaults set in the dashboard's Platform Settings; `update()` still accepts them for wire compatibility, but only the per-agent fields above take effect there.
+
 Self-host also has **online evaluators**: a real LLM judge scoring a sample of live traffic continuously, distinct from a pattern's rule-matching. A score below `alert_threshold` raises a signal the same way a failing pattern does, deduped and triage-ready in `client.monitor.signals`.
 
 ```python
@@ -366,7 +380,7 @@ export AGENTX_API_BASE_URL=http://localhost:4700/api/v1
 export AGENTX_API_KEY=<printed by agentx-trace-eval on first run>
 ```
 
-`agentx-trace-eval` isn't this SDK's own code - the engine itself is a separate, compiled binary, downloaded on demand rather than bundled into this package, so installing `agentx-python` doesn't get any heavier for the (much more common) case of just talking to the hosted AgentX API. See that repo's README for what's included, and `AGENTX_INSTALL_DIR`/`AGENTX_TRACE_EVAL_VERSION`/`AGENTX_TRACE_EVAL_SKIP_WEB` env vars to control where/what it installs.
+`agentx-trace-eval` isn't this SDK's own code - the engine itself is a separate, compiled binary, downloaded on demand rather than bundled into this package, so installing `agentx-python` doesn't get any heavier for the (much more common) case of just talking to the hosted AgentX API. Each SDK release pins the engine release it was tested against and converges the install to that pin, so upgrading the SDK upgrades the engine too. Two flags to know: `--update` (consumed by this launcher) force-reinstalls the resolved engine release, while `--upgrade` passes through to `agentx-server` and re-downloads the dashboard bundle before serving. See that repo's README for what's included, and the `AGENTX_INSTALL_DIR`/`AGENTX_TRACE_EVAL_VERSION`/`AGENTX_TRACE_EVAL_SKIP_WEB` env vars to control where/what it installs.
 
 ---
 

{agentx_python-0.8.12 → agentx_python-0.8.14}/README.md

@@ -45,12 +45,14 @@ pip install --upgrade agentx-python
 
 Requires Python 3.9 or newer.
 
-#### Run self host eval framework locally
+#### Run the self-host governance suite locally
 
-```
-agentx-trace-eval --dev --update
+```bash
+agentx-trace-eval --dev
 ```
 
+(See [Self-host](#self-host) below for what this downloads and how to point the SDK at it.)
+
 ---
 
 ## Quick start
@@ -73,7 +75,7 @@ report = (
     .analyze()
 )
 
-print(report.average_rating)   # LLM-graded score, 0–10
+print(report.average_rating)   # LLM-graded score, 0-10
 print(report.summary)          # AI-generated narrative from .analyze()
 ```
 
@@ -94,9 +96,9 @@ report = (
     .analyze()
 )
 
-print(report.average_rating)       # LLM-graded score, 0–10
-print(report.cosine_similarity)    # embedding cosine, 0–1 (None if not enabled)
-print(report.jaccard_similarity)   # token-set overlap, 0–1 (None if not enabled)
+print(report.average_rating)       # LLM-graded score, 0-10
+print(report.cosine_similarity)    # embedding cosine, 0-1 (None if not enabled)
+print(report.jaccard_similarity)   # token-set overlap, 0-1 (None if not enabled)
 
 print(report.summary)              # AI-generated narrative from .analyze()
 print(report.recommendations)      # list of prioritized, actionable fixes
@@ -120,7 +122,7 @@ client.evaluations.run(
 
 See [Prompt registry](EVALUATIONS.md#prompt-registry) in the full guide, or [self-host's docs](https://docs.agentx.so/improve/prompt-management) for the "Suggest improvement" dashboard flow (self-host only - no hosted-SaaS equivalent yet).
 
-On self-host, a finalized run can also **gate a CI job**: `run.gate(fail_under=7, no_regression=True)` (on the run context `.execute()` returns) checks the run's average rating against an absolute floor and/or the dataset's previous run, prints per-check verdicts into the CI log, and returns an exit code - `sys.exit(gate.exit_code)` blocks the merge on regression. Recorded gates appear in the dashboard's CI Gates tab. See [self-host's CI docs](https://docs.agentx.so/integrations/self-host-ci) for the GitHub Actions recipe.
+On self-host, a finalized run can also **gate a CI job**: `run.gate(fail_under=7, no_regression=True)` (on the run context `.execute()` returns) checks the run's average rating against an absolute floor and/or the dataset's previous run, prints per-check verdicts into the CI log, and returns a `GateResult` - `sys.exit(gate.exit_code)` blocks the merge on regression. Recorded gates appear in the dashboard's CI Gates tab. See [self-host's CI docs](https://docs.agentx.so/integrations/self-host-ci) for the GitHub Actions recipe.
 
 See **[EVALUATIONS.md](EVALUATIONS.md)** for the full guide - dataset builder, framework adapters, similarity metrics, smoke testing, judge configuration, prompt registry, and the complete API reference.
 
@@ -188,7 +190,16 @@ 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.
+Two more platforms are covered by **pull importers** rather than in-process hooks, each with its
+own CLI: `agentx-moveworks` (Moveworks Data API sync, no extra needed) and `agentx-databricks`
+(`pip install "agentx-python[databricks]"`, MLflow/Databricks trace sync).
+
+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.
 
@@ -223,12 +234,14 @@ for signal in client.monitor.signals.list(severity="high"):
     print(signal.summary, signal.occurrence_count)
 ```
 
-Per-agent coverage/threshold settings (sample rate, retention, and threshold overrides like the built-in "Latency regression" pattern's threshold) are `client.monitor.profile.get()`/`.update()`:
+Per-agent monitoring settings (enable/disable, detection categories, notification channels) are `client.monitor.profile.get()`/`.update()`:
 
 ```python
-client.monitor.profile.update("agent_123", threshold_overrides={"latencyMs": 15000})
+client.monitor.profile.update("agent_123", info_detection_enabled=False)
 ```
 
+On self-host, coverage mode, sample rate, retention, and the built-in latency threshold are project-level defaults set in the dashboard's Platform Settings; `update()` still accepts them for wire compatibility, but only the per-agent fields above take effect there.
+
 Self-host also has **online evaluators**: a real LLM judge scoring a sample of live traffic continuously, distinct from a pattern's rule-matching. A score below `alert_threshold` raises a signal the same way a failing pattern does, deduped and triage-ready in `client.monitor.signals`.
 
 ```python
@@ -302,7 +315,7 @@ export AGENTX_API_BASE_URL=http://localhost:4700/api/v1
 export AGENTX_API_KEY=<printed by agentx-trace-eval on first run>
 ```
 
-`agentx-trace-eval` isn't this SDK's own code - the engine itself is a separate, compiled binary, downloaded on demand rather than bundled into this package, so installing `agentx-python` doesn't get any heavier for the (much more common) case of just talking to the hosted AgentX API. See that repo's README for what's included, and `AGENTX_INSTALL_DIR`/`AGENTX_TRACE_EVAL_VERSION`/`AGENTX_TRACE_EVAL_SKIP_WEB` env vars to control where/what it installs.
+`agentx-trace-eval` isn't this SDK's own code - the engine itself is a separate, compiled binary, downloaded on demand rather than bundled into this package, so installing `agentx-python` doesn't get any heavier for the (much more common) case of just talking to the hosted AgentX API. Each SDK release pins the engine release it was tested against and converges the install to that pin, so upgrading the SDK upgrades the engine too. Two flags to know: `--update` (consumed by this launcher) force-reinstalls the resolved engine release, while `--upgrade` passes through to `agentx-server` and re-downloads the dashboard bundle before serving. See that repo's README for what's included, and the `AGENTX_INSTALL_DIR`/`AGENTX_TRACE_EVAL_VERSION`/`AGENTX_TRACE_EVAL_SKIP_WEB` env vars to control where/what it installs.
 
 ---
 

{agentx_python-0.8.12 → agentx_python-0.8.14}/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_python-0.8.12 → agentx_python-0.8.14}/agentx/integrations/anthropic.py

@@ -13,7 +13,7 @@ Usage::
 
 Works with both ``anthropic.Anthropic`` and ``anthropic.AsyncAnthropic`` clients.
 
-Requires: ``pip install agentx[anthropic]``
+Requires: ``pip install "agentx-python[anthropic]"``
 """
 from __future__ import annotations
 

{agentx_python-0.8.12 → agentx_python-0.8.14}/agentx/integrations/crewai.py

@@ -14,7 +14,7 @@ Or as a context manager around your own kickoff::
         result = crew.kickoff(inputs={"topic": "AI"})
         span.output = result.raw
 
-Requires: ``pip install agentx[crewai]``
+Requires: ``pip install "agentx-python[crewai]"``
 """
 from __future__ import annotations
 

{agentx_python-0.8.12 → agentx_python-0.8.14}/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_python-0.8.14/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_python-0.8.12 → agentx_python-0.8.14}/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_python-0.8.12 → agentx_python-0.8.14}/agentx/version.py

@@ -1,7 +1,7 @@
-VERSION = "0.8.12"
+VERSION = "0.8.14"
 
 # 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.10"

{agentx_python-0.8.12 → agentx_python-0.8.14}/agentx_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentx-python
-Version: 0.8.12
+Version: 0.8.14
 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
@@ -8,7 +8,7 @@ Author-email: contact@agentx.so
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.6
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: urllib3>=1.26.11
@@ -50,6 +50,7 @@ Requires-Dist: litellm>=1.0.0; extra == "all"
 Requires-Dist: llama-index-core>=0.10.0; extra == "all"
 Requires-Dist: autogen-agentchat>=0.4.0; extra == "all"
 Requires-Dist: autogen-core>=0.4.0; extra == "all"
+Requires-Dist: mlflow>=3.6.0; extra == "all"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -109,12 +110,14 @@ pip install --upgrade agentx-python
 
 Requires Python 3.9 or newer.
 
-#### Run self host eval framework locally
+#### Run the self-host governance suite locally
 
-```
-agentx-trace-eval --dev --update
+```bash
+agentx-trace-eval --dev
 ```
 
+(See [Self-host](#self-host) below for what this downloads and how to point the SDK at it.)
+
 ---
 
 ## Quick start
@@ -137,7 +140,7 @@ report = (
     .analyze()
 )
 
-print(report.average_rating)   # LLM-graded score, 0–10
+print(report.average_rating)   # LLM-graded score, 0-10
 print(report.summary)          # AI-generated narrative from .analyze()
 ```
 
@@ -158,9 +161,9 @@ report = (
     .analyze()
 )
 
-print(report.average_rating)       # LLM-graded score, 0–10
-print(report.cosine_similarity)    # embedding cosine, 0–1 (None if not enabled)
-print(report.jaccard_similarity)   # token-set overlap, 0–1 (None if not enabled)
+print(report.average_rating)       # LLM-graded score, 0-10
+print(report.cosine_similarity)    # embedding cosine, 0-1 (None if not enabled)
+print(report.jaccard_similarity)   # token-set overlap, 0-1 (None if not enabled)
 
 print(report.summary)              # AI-generated narrative from .analyze()
 print(report.recommendations)      # list of prioritized, actionable fixes
@@ -184,7 +187,7 @@ client.evaluations.run(
 
 See [Prompt registry](EVALUATIONS.md#prompt-registry) in the full guide, or [self-host's docs](https://docs.agentx.so/improve/prompt-management) for the "Suggest improvement" dashboard flow (self-host only - no hosted-SaaS equivalent yet).
 
-On self-host, a finalized run can also **gate a CI job**: `run.gate(fail_under=7, no_regression=True)` (on the run context `.execute()` returns) checks the run's average rating against an absolute floor and/or the dataset's previous run, prints per-check verdicts into the CI log, and returns an exit code - `sys.exit(gate.exit_code)` blocks the merge on regression. Recorded gates appear in the dashboard's CI Gates tab. See [self-host's CI docs](https://docs.agentx.so/integrations/self-host-ci) for the GitHub Actions recipe.
+On self-host, a finalized run can also **gate a CI job**: `run.gate(fail_under=7, no_regression=True)` (on the run context `.execute()` returns) checks the run's average rating against an absolute floor and/or the dataset's previous run, prints per-check verdicts into the CI log, and returns a `GateResult` - `sys.exit(gate.exit_code)` blocks the merge on regression. Recorded gates appear in the dashboard's CI Gates tab. See [self-host's CI docs](https://docs.agentx.so/integrations/self-host-ci) for the GitHub Actions recipe.
 
 See **[EVALUATIONS.md](EVALUATIONS.md)** for the full guide - dataset builder, framework adapters, similarity metrics, smoke testing, judge configuration, prompt registry, and the complete API reference.
 
@@ -252,7 +255,16 @@ 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.
+Two more platforms are covered by **pull importers** rather than in-process hooks, each with its
+own CLI: `agentx-moveworks` (Moveworks Data API sync, no extra needed) and `agentx-databricks`
+(`pip install "agentx-python[databricks]"`, MLflow/Databricks trace sync).
+
+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.
 
@@ -287,12 +299,14 @@ for signal in client.monitor.signals.list(severity="high"):
     print(signal.summary, signal.occurrence_count)
 ```
 
-Per-agent coverage/threshold settings (sample rate, retention, and threshold overrides like the built-in "Latency regression" pattern's threshold) are `client.monitor.profile.get()`/`.update()`:
+Per-agent monitoring settings (enable/disable, detection categories, notification channels) are `client.monitor.profile.get()`/`.update()`:
 
 ```python
-client.monitor.profile.update("agent_123", threshold_overrides={"latencyMs": 15000})
+client.monitor.profile.update("agent_123", info_detection_enabled=False)
 ```
 
+On self-host, coverage mode, sample rate, retention, and the built-in latency threshold are project-level defaults set in the dashboard's Platform Settings; `update()` still accepts them for wire compatibility, but only the per-agent fields above take effect there.
+
 Self-host also has **online evaluators**: a real LLM judge scoring a sample of live traffic continuously, distinct from a pattern's rule-matching. A score below `alert_threshold` raises a signal the same way a failing pattern does, deduped and triage-ready in `client.monitor.signals`.
 
 ```python
@@ -366,7 +380,7 @@ export AGENTX_API_BASE_URL=http://localhost:4700/api/v1
 export AGENTX_API_KEY=<printed by agentx-trace-eval on first run>
 ```
 
-`agentx-trace-eval` isn't this SDK's own code - the engine itself is a separate, compiled binary, downloaded on demand rather than bundled into this package, so installing `agentx-python` doesn't get any heavier for the (much more common) case of just talking to the hosted AgentX API. See that repo's README for what's included, and `AGENTX_INSTALL_DIR`/`AGENTX_TRACE_EVAL_VERSION`/`AGENTX_TRACE_EVAL_SKIP_WEB` env vars to control where/what it installs.
+`agentx-trace-eval` isn't this SDK's own code - the engine itself is a separate, compiled binary, downloaded on demand rather than bundled into this package, so installing `agentx-python` doesn't get any heavier for the (much more common) case of just talking to the hosted AgentX API. Each SDK release pins the engine release it was tested against and converges the install to that pin, so upgrading the SDK upgrades the engine too. Two flags to know: `--update` (consumed by this launcher) force-reinstalls the resolved engine release, while `--upgrade` passes through to `agentx-server` and re-downloads the dashboard bundle before serving. See that repo's README for what's included, and the `AGENTX_INSTALL_DIR`/`AGENTX_TRACE_EVAL_VERSION`/`AGENTX_TRACE_EVAL_SKIP_WEB` env vars to control where/what it installs.
 
 ---
 

{agentx_python-0.8.12 → agentx_python-0.8.14}/agentx_python.egg-info/SOURCES.txt

@@ -64,6 +64,7 @@ agentx/resources/workforce.py
 agentx/tracing/__init__.py
 agentx/tracing/ci_types.py
 agentx/tracing/eval_scope.py
+agentx/tracing/framework_detect.py
 agentx/tracing/ingest_client.py
 agentx/tracing/tracer.py
 agentx_python.egg-info/PKG-INFO
@@ -77,6 +78,7 @@ tests/test_cli_launcher.py
 tests/test_deep_dive_fixes.py
 tests/test_docs_match_sdk.py
 tests/test_eval_scope.py
+tests/test_framework_detect.py
 tests/test_integration.py
 tests/test_integrations.py
 tests/test_judge_scorers.py
@@ -84,5 +86,6 @@ tests/test_pairwise.py
 tests/test_review_queue.py
 tests/test_runner_features.py
 tests/test_selfhost_analysis_fallback.py
+tests/test_selfhost_compat.py
 tests/test_span_tree.py
 tests/test_testing.py

{agentx_python-0.8.12 → agentx_python-0.8.14}/agentx_python.egg-info/requires.txt

@@ -15,6 +15,7 @@ litellm>=1.0.0
 llama-index-core>=0.10.0
 autogen-agentchat>=0.4.0
 autogen-core>=0.4.0
+mlflow>=3.6.0
 
 [anthropic]
 anthropic>=0.25.0

{agentx_python-0.8.12 → agentx_python-0.8.14}/setup.py

@@ -70,6 +70,7 @@ setup(
             "llama-index-core>=0.10.0",
             "autogen-agentchat>=0.4.0",
             "autogen-core>=0.4.0",
+            "mlflow>=3.6.0",
         ],
     },
     author="Robin Wang and AgentX Team",
@@ -83,5 +84,5 @@ setup(
         "License :: OSI Approved :: Apache Software License",
         "Operating System :: OS Independent",
     ],
-    python_requires=">=3.6",
+    python_requires=">=3.9",
 )