feat(client): default User-Agent header for SDK attribution (DAK-7617)

src/dakera/async_client.py

@@ -28,6 +28,8 @@
 import json
 import random
 from collections.abc import AsyncGenerator
+from importlib.metadata import PackageNotFoundError
+from importlib.metadata import version as _pkg_version
 from typing import Any
 
 try:
@@ -150,6 +152,14 @@
     WarmingTargetTier,
 )
 
+# DAK-7617: default User-Agent so the engine can attribute Python SDK usage.
+# Read from installed package metadata to avoid a circular import of ``dakera``
+# (``__version__`` is defined after this module is imported in ``__init__``).
+try:
+    _USER_AGENT = f"dakera-py/{_pkg_version('dakera')}"
+except PackageNotFoundError:  # pragma: no cover
+    _USER_AGENT = "dakera-py/unknown"
+
 
 class AsyncDakeraClient:
     """
@@ -204,7 +214,10 @@ def __init__(
         else:
             self._retry_config = RetryConfig(max_retries=max_retries)
 
-        default_headers: dict[str, str] = {"Content-Type": "application/json"}
+        default_headers: dict[str, str] = {
+            "Content-Type": "application/json",
+            "User-Agent": _USER_AGENT,
+        }
         if api_key:
             default_headers["Authorization"] = f"Bearer {api_key}"
         if headers:

src/dakera/client.py

@@ -8,6 +8,8 @@
 import random
 import time
 from collections.abc import Generator
+from importlib.metadata import PackageNotFoundError
+from importlib.metadata import version as _pkg_version
 from typing import Any, Union
 from urllib.parse import urljoin
 
@@ -126,6 +128,14 @@
     WarmingTargetTier,
 )
 
+# DAK-7617: default User-Agent so the engine can attribute Python SDK usage.
+# Read from installed package metadata to avoid a circular import of ``dakera``
+# (``__version__`` is defined after this module is imported in ``__init__``).
+try:
+    _USER_AGENT = f"dakera-py/{_pkg_version('dakera')}"
+except PackageNotFoundError:  # pragma: no cover
+    _USER_AGENT = "dakera-py/unknown"
+
 
 class DakeraClient:
     """
@@ -185,7 +195,9 @@ def __init__(
             self._retry_config = RetryConfig(max_retries=max_retries)
 
         self._session = requests.Session()
-        self._session.headers.update({"Content-Type": "application/json"})
+        self._session.headers.update(
+            {"Content-Type": "application/json", "User-Agent": _USER_AGENT}
+        )
 
         if api_key:
             self._session.headers.update({"Authorization": f"Bearer {api_key}"})