agentmark-sdk 0.2.0__tar.gz → 0.2.1__tar.gz

{agentmark_sdk-0.2.0 → agentmark_sdk-0.2.1}/CHANGELOG.md

@@ -1,3 +1,24 @@
+## 0.2.1 (2026-04-16)
+
+### 🩹 Fixes
+
+- fix: set explicit User-Agent on OTLP span exports to bypass Cloudflare BIC ([#584](https://github.com/agentmark-ai/agentmark/pull/584))
+
+  Cloudflare's Browser Integrity Check rejects requests bearing the default
+  `Python-urllib/*` User-Agent with HTTP 403 (error code 1010). `JsonOtlpSpanExporter`
+  uses `urllib.request.urlopen` without setting a UA, so every trace export through
+  a Cloudflare-proxied zone (api.agentmark.co, api-stg.agentmark.co) was silently
+  rejected before reaching the gateway. Combined with the exporter's bare
+  `except Exception: return FAILURE`, the failure produced no logs, no metrics,
+  and no ClickHouse rows — just a complete absence of traces.
+
+  The `ApiLoader` path (`/v1/templates` etc.) wasn't affected because it uses
+  `httpx`, whose default UA `python-httpx/<version>` isn't on the BIC block list.
+
+  Set `User-Agent: agentmark-sdk-python/<version>` on every outbound POST. The
+  version is resolved at import time via `importlib.metadata.version("agentmark-sdk")`
+  so it stays in lockstep with the installed distribution.
+
 ## 0.2.0 (2026-04-13)
 
 ### 🚀 Features

{agentmark_sdk-0.2.0 → agentmark_sdk-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentmark-sdk
-Version: 0.2.0
+Version: 0.2.1
 Summary: AgentMark SDK for Python - Tracing and Observability
 Author-email: AgentMark <support@agentmark.co>
 License: MIT

{agentmark_sdk-0.2.0 → agentmark_sdk-0.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentmark-sdk"
-version = "0.2.0"
+version = "0.2.1"
 description = "AgentMark SDK for Python - Tracing and Observability"
 requires-python = ">=3.10"
 keywords = [

{agentmark_sdk-0.2.0 → agentmark_sdk-0.2.1}/src/agentmark_sdk/config.py

@@ -2,7 +2,7 @@
 
 # API Endpoints
 AGENTMARK_TRACE_ENDPOINT = "v1/traces"
-AGENTMARK_SCORE_ENDPOINT = "v1/score"
+AGENTMARK_SCORE_ENDPOINT = "v1/scores"
 
 # Default base URL
 DEFAULT_BASE_URL = "https://api.agentmark.co"

{agentmark_sdk-0.2.0 → agentmark_sdk-0.2.1}/src/agentmark_sdk/otlp_json_exporter.py

@@ -15,12 +15,19 @@ import base64
 import json
 import urllib.request
 from collections import defaultdict
+from importlib.metadata import version as _pkg_version
 from typing import Any, Sequence
 
 from opentelemetry.sdk.trace import ReadableSpan
 from opentelemetry.sdk.trace.export import SpanExporter, SpanExportResult
 from opentelemetry.trace import SpanKind
 
+# Cloudflare Browser Integrity Check rejects the default urllib User-Agent
+# ("Python-urllib/x.y") with a 403 error code 1010. Set an explicit SDK UA so
+# requests through proxied zones (api.agentmark.co et al) aren't blocked
+# before reaching the gateway.
+_SDK_USER_AGENT = f"agentmark-sdk-python/{_pkg_version('agentmark-sdk')}"
+
 # OTLP wire format uses 1-indexed SpanKind values (UNSPECIFIED=0,
 # INTERNAL=1, SERVER=2, ...) while the Python API uses 0-indexed
 # (INTERNAL=0, SERVER=1, ...). This mapping is stable per the OTLP spec.
@@ -50,6 +57,7 @@ class JsonOtlpSpanExporter(SpanExporter):
             data=payload,
             headers={
                 "Content-Type": "application/json",
+                "User-Agent": _SDK_USER_AGENT,
                 **self._headers,
             },
             method="POST",