atbash-hermes-plugin 0.1.6__tar.gz → 0.1.7.dev0__tar.gz

{atbash_hermes_plugin-0.1.6 → atbash_hermes_plugin-0.1.7.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atbash-hermes-plugin
-Version: 0.1.6
+Version: 0.1.7.dev0
 Summary: Atbash safety plugin for Hermes Agent
 Author: atbash
 License-Expression: LicenseRef-Atbash-Proprietary
@@ -10,7 +10,10 @@ Keywords: atbash,hermes,hermes-agent,agent-safety,ai-safety,tool-guard,judge,pol
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: atbash-sdk==0.1.6
+Requires-Dist: atbash-sdk==0.1.7.dev0
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: opentelemetry-exporter-otlp-proto-http<2,>=1.29
+Requires-Dist: opentelemetry-sdk<2,>=1.29
 Dynamic: license-file
 
 # Atbash Hermes Plugin
@@ -35,13 +38,13 @@ stopped before execution.
 Install the plugin into the same Python environment that runs Hermes:
 
 ```bash
-pip install atbash-hermes-plugin==0.1.6
+pip install --pre atbash-hermes-plugin==0.1.7.dev0
 ```
 
 If Hermes is installed in a virtual environment, use that environment's Python:
 
 ```bash
-/path/to/hermes/venv/bin/python -m pip install atbash-hermes-plugin==0.1.6
+/path/to/hermes/venv/bin/python -m pip install --pre atbash-hermes-plugin==0.1.7.dev0
 ```
 
 ## Configure Atbash
@@ -117,6 +120,19 @@ ATBASH_ORG_NAME=your-org-name
 ATBASH_TOOL_MAP_PATH=$HOME/.config/atbash/hermes-tool-map.json
 ```
 
+## Telemetry
+
+The plugin initializes the Atbash Python SDK OpenTelemetry metrics with
+`source="plugin:hermes"`, matching the pattern used by the OpenClaw plugin.
+Telemetry is best-effort and never blocks guard registration or tool execution.
+
+The Python SDK telemetry opt-out is file-based. To disable telemetry, create:
+
+```bash
+mkdir -p ~/.config/atbash
+printf '{"enabled": false}\n' > ~/.config/atbash/telemetry.json
+```
+
 ## Enable Or Check The Plugin
 
 Hermes should discover installed Python packages that expose the

{atbash_hermes_plugin-0.1.6 → atbash_hermes_plugin-0.1.7.dev0}/README.md

@@ -20,13 +20,13 @@ stopped before execution.
 Install the plugin into the same Python environment that runs Hermes:
 
 ```bash
-pip install atbash-hermes-plugin==0.1.6
+pip install --pre atbash-hermes-plugin==0.1.7.dev0
 ```
 
 If Hermes is installed in a virtual environment, use that environment's Python:
 
 ```bash
-/path/to/hermes/venv/bin/python -m pip install atbash-hermes-plugin==0.1.6
+/path/to/hermes/venv/bin/python -m pip install --pre atbash-hermes-plugin==0.1.7.dev0
 ```
 
 ## Configure Atbash
@@ -102,6 +102,19 @@ ATBASH_ORG_NAME=your-org-name
 ATBASH_TOOL_MAP_PATH=$HOME/.config/atbash/hermes-tool-map.json
 ```
 
+## Telemetry
+
+The plugin initializes the Atbash Python SDK OpenTelemetry metrics with
+`source="plugin:hermes"`, matching the pattern used by the OpenClaw plugin.
+Telemetry is best-effort and never blocks guard registration or tool execution.
+
+The Python SDK telemetry opt-out is file-based. To disable telemetry, create:
+
+```bash
+mkdir -p ~/.config/atbash
+printf '{"enabled": false}\n' > ~/.config/atbash/telemetry.json
+```
+
 ## Enable Or Check The Plugin
 
 Hermes should discover installed Python packages that expose the

{atbash_hermes_plugin-0.1.6 → atbash_hermes_plugin-0.1.7.dev0}/atbash_hermes_plugin/__init__.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import atexit
 import json
 import logging
 import os
@@ -7,6 +8,7 @@ from pathlib import Path
 from typing import Any, Dict, Optional
 
 logger = logging.getLogger("atbash-hermes-plugin")
+_TELEMETRY_SHUTDOWN_REGISTERED = False
 
 HOLD_MESSAGE = (
     "Action held for operator review. The agent will not be jailed — please approve "
@@ -177,6 +179,24 @@ def _safe_json_value(value: Any) -> Any:
     return str(value)
 
 
+def _setup_telemetry() -> None:
+    """Initialize SDK telemetry with a Hermes-specific source label.
+
+    Telemetry is best-effort: missing optional OpenTelemetry packages or runtime
+    exporter issues must never prevent the guard from registering.
+    """
+    global _TELEMETRY_SHUTDOWN_REGISTERED
+    try:
+        from atbash.opentel import setup_telemetry, shutdown_telemetry  # type: ignore
+
+        setup_telemetry(enabled=True, source="plugin:hermes")
+        if not _TELEMETRY_SHUTDOWN_REGISTERED:
+            atexit.register(shutdown_telemetry)
+            _TELEMETRY_SHUTDOWN_REGISTERED = True
+    except Exception as e:
+        logger.debug("Atbash telemetry setup skipped err=%s", e)
+
+
 class AtbashHermesGuard:
     def __init__(self) -> None:
         self.debug = _as_bool(os.getenv("ATBASH_DEBUG"), False)
@@ -220,7 +240,7 @@ class AtbashHermesGuard:
                 from atbash import Atbash  # type: ignore
                 from atbash.types import ToolCallInput  # type: ignore
             except Exception:
-                raise RuntimeError("atbash-sdk is required. Install with: pip install atbash-sdk==0.1.6") from e
+                raise RuntimeError("atbash-sdk is required. Install with: pip install atbash-sdk==0.1.7.dev0") from e
 
         self.ToolCallInput = ToolCallInput
         judge_cfg = self._judge_config()
@@ -391,6 +411,7 @@ class AtbashHermesGuard:
 
 
 def register(ctx):
+    _setup_telemetry()
     guard = AtbashHermesGuard()
     ctx.register_hook("pre_tool_call", guard.pre_tool_call)
     logger.info("[atbash-hermes-plugin] registered pre_tool_call hook")

{atbash_hermes_plugin-0.1.6 → atbash_hermes_plugin-0.1.7.dev0}/atbash_hermes_plugin.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atbash-hermes-plugin
-Version: 0.1.6
+Version: 0.1.7.dev0
 Summary: Atbash safety plugin for Hermes Agent
 Author: atbash
 License-Expression: LicenseRef-Atbash-Proprietary
@@ -10,7 +10,10 @@ Keywords: atbash,hermes,hermes-agent,agent-safety,ai-safety,tool-guard,judge,pol
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: atbash-sdk==0.1.6
+Requires-Dist: atbash-sdk==0.1.7.dev0
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: opentelemetry-exporter-otlp-proto-http<2,>=1.29
+Requires-Dist: opentelemetry-sdk<2,>=1.29
 Dynamic: license-file
 
 # Atbash Hermes Plugin
@@ -35,13 +38,13 @@ stopped before execution.
 Install the plugin into the same Python environment that runs Hermes:
 
 ```bash
-pip install atbash-hermes-plugin==0.1.6
+pip install --pre atbash-hermes-plugin==0.1.7.dev0
 ```
 
 If Hermes is installed in a virtual environment, use that environment's Python:
 
 ```bash
-/path/to/hermes/venv/bin/python -m pip install atbash-hermes-plugin==0.1.6
+/path/to/hermes/venv/bin/python -m pip install --pre atbash-hermes-plugin==0.1.7.dev0
 ```
 
 ## Configure Atbash
@@ -117,6 +120,19 @@ ATBASH_ORG_NAME=your-org-name
 ATBASH_TOOL_MAP_PATH=$HOME/.config/atbash/hermes-tool-map.json
 ```
 
+## Telemetry
+
+The plugin initializes the Atbash Python SDK OpenTelemetry metrics with
+`source="plugin:hermes"`, matching the pattern used by the OpenClaw plugin.
+Telemetry is best-effort and never blocks guard registration or tool execution.
+
+The Python SDK telemetry opt-out is file-based. To disable telemetry, create:
+
+```bash
+mkdir -p ~/.config/atbash
+printf '{"enabled": false}\n' > ~/.config/atbash/telemetry.json
+```
+
 ## Enable Or Check The Plugin
 
 Hermes should discover installed Python packages that expose the

atbash_hermes_plugin-0.1.7.dev0/atbash_hermes_plugin.egg-info/requires.txt

@@ -0,0 +1,4 @@
+atbash-sdk==0.1.7.dev0
+httpx<1,>=0.27
+opentelemetry-exporter-otlp-proto-http<2,>=1.29
+opentelemetry-sdk<2,>=1.29

{atbash_hermes_plugin-0.1.6 → atbash_hermes_plugin-0.1.7.dev0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "atbash-hermes-plugin"
-version = "0.1.6"
+version = "0.1.7.dev0"
 description = "Atbash safety plugin for Hermes Agent"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -24,7 +24,10 @@ keywords = [
   "policy"
 ]
 dependencies = [
-  "atbash-sdk==0.1.6"
+  "atbash-sdk==0.1.7.dev0",
+  "httpx>=0.27,<1",
+  "opentelemetry-exporter-otlp-proto-http>=1.29,<2",
+  "opentelemetry-sdk>=1.29,<2",
 ]
 
 [project.urls]

atbash_hermes_plugin-0.1.6/atbash_hermes_plugin.egg-info/requires.txt

@@ -1 +0,0 @@
-atbash-sdk==0.1.6