agentx-python 0.8.6__py3-none-any.whl → 0.8.7__py3-none-any.whl

agentx/monitor/client.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 import logging
 import os
 import time
-from typing import Any, List, Optional
+from typing import Any, Dict, List, Optional
 
 import requests
 
@@ -116,6 +116,10 @@ class MonitorClient:
         # The human-review queue (list / queue / label / dismiss) - what makes the
         # label-and-calibrate loop scriptable instead of dashboard-only.
         self.review_queue = ReviewQueueClient(self)
+        from agentx.monitor.rules import MonitorRulesClient
+
+        # Automation rules: route matching traffic into review / a dataset / a webhook.
+        self.rules = MonitorRulesClient(self)
         from agentx.monitor.scorers import ScorersClient
         # Scorers-catalog administration as code: template enable/disable, code/external scorer
         # CRUD and dry runs - full parity with the dashboard's Scorers page (P1.3).
@@ -264,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 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
+        enabled project-wide via ``set_topics(True)`` - classification spends one judge call
+        per sampled trace, so it is off by default."""
+        return self._request(
+            "GET", "/agent-monitoring/topics",
+            base=self._api_root(), params={"window": window},
+        )
+
+    def set_topics(self, enabled: bool, sample_rate: Optional[float] = None) -> dict:
+        """Turn Topics classification on/off for the whole project (Platform Settings >
+        Monitoring Defaults). ``sample_rate`` (0-1) optionally bounds what fraction of traffic
+        is classified - each classified trace costs one judge call."""
+        payload: Dict[str, Any] = {"topicsEnabled": enabled}
+        if sample_rate is not None:
+            payload["topicsSampleRate"] = sample_rate
+        return self._request(
+            "PUT", "/agent-monitoring/settings/monitoring-defaults",
+            base=self._api_root(), json=payload,
+        )
+
     def calibration(self, window: str = "7d") -> "CalibrationSummary":
         """Project-level judge calibration over a window ("24h", "7d", or "30d"): how often
         AgentX's own verdicts agreed with real-world ground truth reported later (ops outcomes

agentx/monitor/rules.py

@@ -0,0 +1,78 @@
+from __future__ import annotations
+
+import logging
+from typing import Any, Dict, List, Optional, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from agentx.monitor.client import MonitorClient
+
+logger = logging.getLogger(__name__)
+
+
+class MonitorRule(dict):
+    """Wire object for one automation rule (dict subclass so unknown fields round-trip)."""
+
+    @property
+    def id(self) -> str:
+        return self["_id"]
+
+    @property
+    def enabled(self) -> bool:
+        return bool(self.get("enabled"))
+
+
+class MonitorRulesClient:
+    """Surfaced as ``client.monitor.rules``: automation rules, evaluated on every ingested root
+    trace. A RULE routes traffic somewhere (it never scores): ``action`` is one of
+
+    - ``"review"`` - sample matching traces into the human-review queue (the stream that feeds
+      judge calibration and tuning),
+    - ``"dataset"`` - append matching traces as cases on a dataset (``action_config
+      {"datasetId": ...}``),
+    - ``"webhook"`` - POST the matching trace to your URL (``action_config {"url": ...}``).
+
+    ``filter`` narrows what matches: ``{"model": ..., "status": "error"|"any", "contains": ...,
+    "scopeMode": "all"|"selected", "agentIds": [...]}``; ``sample_rate`` (0-1, default 1)
+    down-samples the matches.
+    """
+
+    def __init__(self, client: "MonitorClient"):
+        self._client = client
+
+    def _request(self, method: str, path: str, **kwargs: Any) -> Any:
+        return self._client._request(method, path, base=self._client._api_root(), **kwargs)
+
+    def list(self) -> List[MonitorRule]:
+        data = self._request("GET", "/agent-monitoring/rules")
+        return [MonitorRule(r) for r in data.get("rules", [])]
+
+    def create(
+        self,
+        name: str,
+        action: str,
+        *,
+        filter: Optional[Dict[str, Any]] = None,
+        sample_rate: Optional[float] = None,
+        action_config: Optional[Dict[str, Any]] = None,
+        enabled: bool = True,
+    ) -> MonitorRule:
+        payload: Dict[str, Any] = {"name": name, "action": action, "enabled": enabled}
+        if filter is not None:
+            payload["filter"] = filter
+        if sample_rate is not None:
+            payload["sampleRate"] = sample_rate
+        if action_config is not None:
+            payload["actionConfig"] = action_config
+        data = self._request("POST", "/agent-monitoring/rules", json=payload)
+        return MonitorRule(data.get("rule", data))
+
+    def update(self, rule_id: str, **fields: Any) -> MonitorRule:
+        """Sparse update. snake_case keys are mapped to the wire (``sample_rate`` ->
+        ``sampleRate``, ``action_config`` -> ``actionConfig``)."""
+        aliases = {"sample_rate": "sampleRate", "action_config": "actionConfig"}
+        payload = {aliases.get(k, k): v for k, v in fields.items()}
+        data = self._request("PUT", f"/agent-monitoring/rules/{rule_id}", json=payload)
+        return MonitorRule(data.get("rule", data))
+
+    def delete(self, rule_id: str) -> None:
+        self._request("DELETE", f"/agent-monitoring/rules/{rule_id}")

agentx/version.py

@@ -1 +1 @@
-VERSION = "0.8.6"
+VERSION = "0.8.7"

{agentx_python-0.8.6.dist-info → agentx_python-0.8.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentx-python
-Version: 0.8.6
+Version: 0.8.7
 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

{agentx_python-0.8.6.dist-info → agentx_python-0.8.7.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=hmHiHLKwWDl96GTl8BU-lEqkwGqsS8wHvMMNnaUkHZc,18
+agentx/version.py,sha256=kG_bb-Ryd4AoiM5iOElOryBDv_WEdw73ouYtbd5SIQE,18
 agentx/evaluations/__init__.py,sha256=Erv7RGFlRxGTG4rVb2uHhCqLLEX_iAWKqkZKzK6CumE,262
 agentx/evaluations/_term.py,sha256=WFpiNzdgDBeJJ-Gg-6X7TwwxllobuE4OqFUTuDQvS3Y,2529
 agentx/evaluations/client.py,sha256=miUmEq4IthUDl-QVAczqT7iaOu4X6QMbHhlm2rSSJpg,31239
@@ -43,13 +43,14 @@ 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=PNhtuBRrJvrtgA3gjm4ZN7dpb0BFTi-samNCo15hr2M,18336
+agentx/monitor/client.py,sha256=XUecRuhWM80_dlKFCHORp9TPWN80XM5SApkGRTFedX4,19724
 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
 agentx/monitor/patterns.py,sha256=ruBqLoA2T2KQuqRbbn1kWkIEkiOal3SvyPl9opGyhzI,4185
 agentx/monitor/profile.py,sha256=uGk-4bXT2vmnEQiY5u6rWhAfzZchHBXL74VD3piVHvU,3102
 agentx/monitor/review_queue.py,sha256=Tr3GDMJLJzyFKEEeB8HPmZBsNzzYVJYElDlfBC4qd68,3766
+agentx/monitor/rules.py,sha256=oLQ5RPgMPUKJFTSZzcBEMLzDlICElUNJTyIqxZMAGmQ,3040
 agentx/monitor/scorers.py,sha256=huIZBszrfLKI8I7VV6NFpW6piRsj9HI03rXUwWs2tgs,7336
 agentx/monitor/sessions.py,sha256=gePcL284m3UITxQAtHxwrKFl6bRjmRib1QK6JbZeS9s,815
 agentx/monitor/signals.py,sha256=Ld11lW2lbg8NHBUHdgoY6iwCvJDK-eg4ge4qQ9y7nGY,1432
@@ -62,9 +63,9 @@ agentx/tracing/ci_types.py,sha256=zFVcZGvc1qbVDdOlEPQ1i5R6terqJHxCzFF4ZjouxxI,14
 agentx/tracing/eval_scope.py,sha256=ElMbPxpqpQBVuaUnHNlw9RIQu71oyOpd0yR55bDH8eI,2144
 agentx/tracing/ingest_client.py,sha256=5X6RyxtMq1XYgOzsMd3b2f2qpmYpsMnhKm7NB3oup00,17664
 agentx/tracing/tracer.py,sha256=qQojU-T4O8IJKyf9vue0Em66qPBTZKl3FMyr3KJKPnI,53770
-agentx_python-0.8.6.dist-info/licenses/LICENSE,sha256=gZVsM-nLsE8vlaY6NXXsVoo6IlCClxkToAWmhgT3y_s,10762
-agentx_python-0.8.6.dist-info/METADATA,sha256=TtgnRoXPHmbRAmTFBQpjX7iN4Eq5-g6znYgTgZHc0uY,20992
-agentx_python-0.8.6.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-agentx_python-0.8.6.dist-info/entry_points.txt,sha256=rQqF1JTY3T1yfviBU1r8PU-5mBdfOk6P4bZ1L4BskIM,172
-agentx_python-0.8.6.dist-info/top_level.txt,sha256=s-q-HB9Gb_QdrZNacSeQyF_c25gQooMy7DlxzgLOHPk,7
-agentx_python-0.8.6.dist-info/RECORD,,
+agentx_python-0.8.7.dist-info/licenses/LICENSE,sha256=gZVsM-nLsE8vlaY6NXXsVoo6IlCClxkToAWmhgT3y_s,10762
+agentx_python-0.8.7.dist-info/METADATA,sha256=aZ0vtzylZ2kxkbb5f5jdSDaNmchZreVE-dzKnl33yCA,20992
+agentx_python-0.8.7.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+agentx_python-0.8.7.dist-info/entry_points.txt,sha256=rQqF1JTY3T1yfviBU1r8PU-5mBdfOk6P4bZ1L4BskIM,172
+agentx_python-0.8.7.dist-info/top_level.txt,sha256=s-q-HB9Gb_QdrZNacSeQyF_c25gQooMy7DlxzgLOHPk,7
+agentx_python-0.8.7.dist-info/RECORD,,