agentx-python 0.8.28__py3-none-any.whl → 0.8.29__py3-none-any.whl

agentx/evaluations/client.py

@@ -75,6 +75,22 @@ def _resolve_scorer_id(scorer_id: Optional[str], evaluation_settings_id: Optiona
     return scorer_id or evaluation_settings_id
 
 
+# "Argument not given" for update_tool_schema_meta, where None is itself a meaningful value
+# (clear the price).
+_UNSET: object = object()
+
+
+def _validated_tool_price(value: float) -> float:
+    """Local mirror of the engine's check: USD per call, finite and non-negative."""
+    try:
+        price = float(value)
+    except (TypeError, ValueError):
+        raise ValueError(f"price_per_call_usd must be a number of USD per call, got {value!r}") from None
+    if price != price or price in (float("inf"), float("-inf")) or price < 0:
+        raise ValueError(f"price_per_call_usd must be a finite, non-negative number, got {value!r}")
+    return price
+
+
 class EvaluationsClient:
     def __init__(
         self,
@@ -723,13 +739,39 @@ class EvaluationsClient:
         data = self._request("GET", "/evaluate/tool-schemas", base=self._api_root)
         return data.get("toolSchemas", []) if isinstance(data, dict) else data
 
-    def create_tool_schema(self, *, name: str, definition: str, description: Optional[str] = None) -> dict:
+    def create_tool_schema(
+        self, *, name: str, definition: str, description: Optional[str] = None,
+        price_per_call_usd: Optional[float] = None,
+    ) -> dict:
         payload: dict = {"name": name, "definition": definition}
         if description is not None:
             payload["description"] = description
+        if price_per_call_usd is not None:
+            payload["pricePerCallUsd"] = _validated_tool_price(price_per_call_usd)
         # Server-side write - no transport retry (see init_run's comment).
         return self._request("POST", "/evaluate/tool-schemas", base=self._api_root, json=payload, retry=False)
 
+    def update_tool_schema_meta(
+        self, tool_schema_id: str, *, description: Optional[str] = None,
+        price_per_call_usd: Optional[float] = _UNSET, test_endpoint_url: Optional[str] = _UNSET,  # type: ignore[assignment]
+    ) -> dict:
+        """Metadata-only edit (PATCH): description, per-call price, test endpoint. Never touches
+        the version log. ``price_per_call_usd=None`` clears the price (the tool becomes free)."""
+        payload: dict = {}
+        if description is not None:
+            payload["description"] = description
+        if price_per_call_usd is not _UNSET:
+            payload["pricePerCallUsd"] = None if price_per_call_usd is None else _validated_tool_price(price_per_call_usd)
+        if test_endpoint_url is not _UNSET:
+            payload["testEndpointUrl"] = test_endpoint_url
+        return self._request(
+            "PATCH", f"/evaluate/tool-schemas/{tool_schema_id}", base=self._api_root, json=payload, retry=False,
+        )
+
+    def delete_tool_schema(self, tool_schema_id: str) -> None:
+        """Deletes the tool schema and its version history."""
+        self._request("DELETE", f"/evaluate/tool-schemas/{tool_schema_id}", base=self._api_root, retry=False)
+
     def get_tool_schema_examples(self, tool_schema_id: str, window: Optional[str] = None) -> dict:
         params = {"window": window} if window else None
         return self._request(

agentx/evaluations/tool_schemas.py

@@ -19,15 +19,39 @@ class ToolSchemaClient:
     def list(self) -> List[dict]:
         return self._client.list_tool_schemas()
 
-    def create(self, *, name: str, definition: str, description: Optional[str] = None) -> dict:
-        return self._client.create_tool_schema(name=name, definition=definition, description=description)
+    def create(
+        self, *, name: str, definition: str, description: Optional[str] = None,
+        price_per_call_usd: Optional[float] = None,
+    ) -> dict:
+        """``price_per_call_usd`` is what one call of this tool costs you (a paid external API
+        billed per request). Every recorded call is charged, failed ones included; the spend
+        shows as the "Tool calls" segment of the Overview cost chart and counts toward the
+        ``estimatedCostUsd`` alert metric. Leave it unset for a free tool."""
+        return self._client.create_tool_schema(
+            name=name, definition=definition, description=description, price_per_call_usd=price_per_call_usd,
+        )
 
-    def get_or_create(self, *, name: str, definition: str, description: Optional[str] = None) -> dict:
-        """Idempotent register: returns the existing schema of this name if present."""
+    def get_or_create(
+        self, *, name: str, definition: str, description: Optional[str] = None,
+        price_per_call_usd: Optional[float] = None,
+    ) -> dict:
+        """Idempotent register: returns the existing schema of this name if present (its stored
+        price wins - use :meth:`set_price` to change it)."""
         existing = next((t for t in self.list() if t.get("name") == name), None)
         if existing:
             return existing
-        return self.create(name=name, definition=definition, description=description)
+        return self.create(
+            name=name, definition=definition, description=description, price_per_call_usd=price_per_call_usd,
+        )
+
+    def set_price(self, tool_schema_id: str, price_per_call_usd: Optional[float]) -> dict:
+        """Set (or clear with ``None``) a registered tool's USD price per call. Metadata only -
+        the definition's version log is untouched."""
+        return self._client.update_tool_schema_meta(tool_schema_id, price_per_call_usd=price_per_call_usd)
+
+    def delete(self, tool_schema_id: str) -> None:
+        """Deletes the tool schema and its version history."""
+        self._client.delete_tool_schema(tool_schema_id)
 
     def examples(self, tool_schema_id: str, window: Optional[str] = None) -> dict:
         """Failure evidence recorded against this tool (agent-tool-failure signals, low-rated

agentx/monitor/client.py

@@ -360,6 +360,16 @@ class MonitorClient:
                 params[key] = value
         return self._request("GET", "/metrics", params=params)
 
+    def cost_trend(self, window: str = "7d") -> dict:
+        """Overview's "Total cost" chart over a window ("24h", "7d", "30d"): priced spend per
+        bucket and in total, stacked by model, with two reserved segments - ``"eval runs"``
+        (offline-evaluation spend) and ``"tool calls"`` (registered tools' per-call prices, split
+        per tool in ``totalsByTool``). Unpriced models and tools contribute $0."""
+        return self._request(
+            "GET", "/agent-monitoring/cost-trend",
+            base=self._api_root(), 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

agentx/version.py

@@ -1,7 +1,7 @@
-VERSION = "0.8.28"
+VERSION = "0.8.29"
 
 # 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.31"
+ENGINE_VERSION = "v0.3.32"

{agentx_python-0.8.28.dist-info → agentx_python-0.8.29.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentx-python
-Version: 0.8.28
+Version: 0.8.29
 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.28.dist-info → agentx_python-0.8.29.dist-info}/RECORD

@@ -10,10 +10,10 @@ agentx/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 agentx/testing.py,sha256=0shZEid_vhJgBegpO_loUq6APYDxQrUgD3jvcRdIDV8,7372
 agentx/traces.py,sha256=Jh07n3GLS1SGRsDoLDTUaAbuMEdvjqxCCMA9gUcSZ0M,2331
 agentx/util.py,sha256=ivCuFQ5AGUw9fR9fJy5HrSp3lLwwngsDwppnvyZpq9E,1471
-agentx/version.py,sha256=GG8-5mWn22akjdeFMAvH6YuyN72ciRGt8EIqmtQjbdw,366
+agentx/version.py,sha256=RwLiFdaKYxE3N-pYulB9jC6smBCKOZZTf_Vh6vqhCrM,366
 agentx/evaluations/__init__.py,sha256=Erv7RGFlRxGTG4rVb2uHhCqLLEX_iAWKqkZKzK6CumE,262
 agentx/evaluations/_term.py,sha256=WFpiNzdgDBeJJ-Gg-6X7TwwxllobuE4OqFUTuDQvS3Y,2529
-agentx/evaluations/client.py,sha256=7c35tS8zM3fuvFfVDQk5etTTEFiIykmPjuJxkuFyFTY,38013
+agentx/evaluations/client.py,sha256=4Tuhp2GRPci01OIABg-wb6R_IxCy2qYtGxKuqSC8OVE,40075
 agentx/evaluations/datasets.py,sha256=_yqCdkg6aO6TfWOiicJKlDlFa_tAmCJitRLukW37PuU,17766
 agentx/evaluations/evaluation_settings.py,sha256=ZyFsPkQ_fwIhtb1cxUUBiCQEdbEinw4rSeI7nlHvk_8,7548
 agentx/evaluations/models.py,sha256=ENH594WSYBZvDdoqI3QN7wv4Qfwjy3o14fetWBs_ing,35438
@@ -21,7 +21,7 @@ agentx/evaluations/prompts.py,sha256=Yv9v0UUqZcef1GK-TwK7zcEN38zyN5sruGS0UTzF9UA
 agentx/evaluations/reporting.py,sha256=w6nGG2QMjl_qsGFkK2eJJFW30Qn64RjioaJ45Vy-RpU,6427
 agentx/evaluations/results.py,sha256=7B3aaJ-LFfmPLz904C5GR8MsAaDc1Kv_Le2kjnpCbGA,5146
 agentx/evaluations/runner.py,sha256=4k8XgIJhJqEm2tqpXyu27itx-MQnCjQZ1z6g_I6AznA,42343
-agentx/evaluations/tool_schemas.py,sha256=ZyrnSOnx9xlSAj4swfDey9ZLS2ly-g21DByTwRAGwNA,2323
+agentx/evaluations/tool_schemas.py,sha256=OWs4ARaVPUDqHe-qSCu4dqgqxs2PubiUj2mHJssYMns,3527
 agentx/evaluations/tracing.py,sha256=MSJD9bzfInMi7E70mc8mWUc0fx5DLkOgUzRru2mNQoc,1825
 agentx/evaluations/adapters/__init__.py,sha256=fK8Hx75usbiY03XUSmnLnSrwBXip2CQs24YZcdEgj6w,287
 agentx/evaluations/adapters/http_endpoint.py,sha256=-Gika9lBcXjtbnyB-uNR6nYEVJhWEPtDazi9ixLvJtg,2059
@@ -46,7 +46,7 @@ agentx/monitor/__init__.py,sha256=3KsLb0wedvh16wa8W2G3Z2bZ-LPxe5xmw2wAYmqtfZA,18
 agentx/monitor/_transport.py,sha256=ge0pmdvFdUtCJRkTLvAgjuTQVA8YOCYGQNoyRuselRk,2077
 agentx/monitor/agents.py,sha256=KhsHVhkqa6V0e0lPcuo04fh44_qSaJOaGcD6U6qXSFo,1622
 agentx/monitor/alert_rules.py,sha256=KIZoxyjPG4snnwmO3h4GEbKtlWULmcwGqNMLsdweXew,9871
-agentx/monitor/client.py,sha256=oZctmh77Ki5WnZI6vQaj_tDlmdP6XtkDYt3MKhnvGsU,27563
+agentx/monitor/client.py,sha256=Ey89VQrkgLxMtOUEo4damtFf9v1eziNI3SOl6M1rO6s,28138
 agentx/monitor/improvement_groups.py,sha256=MrXexaBLPNzZHrqZjiCPfmwa-DSr-RHuFdP73SKrMJM,6143
 agentx/monitor/judge_scorers.py,sha256=Xyoafo9ljeq5RpLe5HxvsL0Y0FebFQ-2CxYz8-E1Wio,21025
 agentx/monitor/models.py,sha256=mNBQDXdVthGYHUyEeRgpFdKVOC9uMtdUgBlLfep1E14,9298
@@ -69,9 +69,9 @@ agentx/tracing/eval_scope.py,sha256=ElMbPxpqpQBVuaUnHNlw9RIQu71oyOpd0yR55bDH8eI,
 agentx/tracing/framework_detect.py,sha256=uV4O7Th-4_2UkdooAyaWCOIA0jwLJbblFQ_ucFDjeJM,2638
 agentx/tracing/ingest_client.py,sha256=teukTPckFWPg5RhpbGbVDBejBzPIPXUO3_DJcuVh2uc,22660
 agentx/tracing/tracer.py,sha256=N7rIobHM9KdPU9mqBLVqgk_1mqtCNjBD57uAtXn9DO0,69167
-agentx_python-0.8.28.dist-info/licenses/LICENSE,sha256=gZVsM-nLsE8vlaY6NXXsVoo6IlCClxkToAWmhgT3y_s,10762
-agentx_python-0.8.28.dist-info/METADATA,sha256=9sFd2gVCfCWgweOoBcTHqM4IUpfHipe0qxYBEiLU4E4,23408
-agentx_python-0.8.28.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-agentx_python-0.8.28.dist-info/entry_points.txt,sha256=rQqF1JTY3T1yfviBU1r8PU-5mBdfOk6P4bZ1L4BskIM,172
-agentx_python-0.8.28.dist-info/top_level.txt,sha256=s-q-HB9Gb_QdrZNacSeQyF_c25gQooMy7DlxzgLOHPk,7
-agentx_python-0.8.28.dist-info/RECORD,,
+agentx_python-0.8.29.dist-info/licenses/LICENSE,sha256=gZVsM-nLsE8vlaY6NXXsVoo6IlCClxkToAWmhgT3y_s,10762
+agentx_python-0.8.29.dist-info/METADATA,sha256=LBFiSds7ivKbcKMSMNWJi6s0J5pJDBbIuIlPWUoVMbg,23408
+agentx_python-0.8.29.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+agentx_python-0.8.29.dist-info/entry_points.txt,sha256=rQqF1JTY3T1yfviBU1r8PU-5mBdfOk6P4bZ1L4BskIM,172
+agentx_python-0.8.29.dist-info/top_level.txt,sha256=s-q-HB9Gb_QdrZNacSeQyF_c25gQooMy7DlxzgLOHPk,7
+agentx_python-0.8.29.dist-info/RECORD,,