centive-sdk 2.2.0.dev4__py3-none-any.whl → 2.2.0.dev5__py3-none-any.whl

centive_sdk/resources/async_sessions.py

@@ -416,6 +416,19 @@ class AsyncSessions:
                     error_detail = self._extract_error_message(response)
                     raise AuthError(f"Authentication failed: {error_detail}", request_id=request_id)
 
+                elif response.status_code == 404:
+                    # Not transient, so it must not be retried: the route is
+                    # absent on this deployment. That is the shape of a Centive
+                    # backend older than the SDK — /anam/events does not exist
+                    # before page tracking — and of a trigger-session for a user
+                    # with no session in this org. Retrying either one three
+                    # times, then opening a circuit breaker, spends requests and
+                    # fills logs to reach the same answer.
+                    error_detail = self._extract_error_message(response)
+                    raise ValidationError(
+                        f"Not found (404): {error_detail}", request_id=request_id
+                    )
+
                 elif response.status_code in [400, 413, 422]:
                     # 413 is "payload over the API's size caps": retrying the
                     # same body cannot succeed, so it is a validation failure.

centive_sdk/resources/telemetry_batcher.py

@@ -95,6 +95,7 @@ class TelemetryBatcher:
         self._wake = asyncio.Event()
         self._running = False
         self._auth_error_logged = False
+        self._missing_endpoint_logged = False
         self.on_context: Optional[ContextCallable] = None
 
     # ------------------------------------------------------------------ state
@@ -246,15 +247,33 @@ class TelemetryBatcher:
                 safe_log(self._logger, "error", f"telemetry rejected: invalid API key ({e})")
             return False
         except ValidationError as e:
-            # 400 / 413 / 422: our payload was wrong; retrying cannot help.
+            # 400 / 404 / 413 / 422: the payload or the route was wrong, and
+            # retrying cannot change either.
             self._stats.dropped_non_retryable += len(batch)
             self._stats.last_error = "ValidationError"
-            safe_log(
-                self._logger,
-                "warning",
-                f"telemetry batch rejected by API, dropped: {e}",
-                {"events": len(batch)},
-            )
+            if "(404)" in str(e):
+                # A Centive deployment older than this SDK: page tracking has
+                # no endpoint to reach there. Said once, plainly, because the
+                # fix is a backend upgrade and not something a retry reaches.
+                # Not fatal: everything else the SDK does still works, and a
+                # rolling upgrade can bring the endpoint up under us, so later
+                # batches keep trying quietly.
+                if not self._missing_endpoint_logged:
+                    self._missing_endpoint_logged = True
+                    safe_log(
+                        self._logger,
+                        "warning",
+                        "this Centive deployment has no product-events endpoint; page "
+                        "events are being discarded. Everything else is unaffected. "
+                        "Set telemetry_enabled=False to stop sending them.",
+                    )
+            else:
+                safe_log(
+                    self._logger,
+                    "warning",
+                    f"telemetry batch rejected by API, dropped: {e}",
+                    {"events": len(batch)},
+                )
             return True
         except Exception as e:  # unknown: treat as retryable but bounded by the breaker
             self._breaker.record_failure()

{centive_sdk-2.2.0.dev4.dist-info → centive_sdk-2.2.0.dev5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: centive-sdk
-Version: 2.2.0.dev4
+Version: 2.2.0.dev5
 Summary: Python SDK for Centive backend integration
 Project-URL: Homepage, https://github.com/TheAgenticAI/centive-backend-sdk
 Project-URL: Repository, https://github.com/TheAgenticAI/centive-backend-sdk

{centive_sdk-2.2.0.dev4.dist-info → centive_sdk-2.2.0.dev5.dist-info}/RECORD

@@ -11,13 +11,13 @@ centive_sdk/models/__init__.py,sha256=-ledNpbOi1Q14ELhvlDbGPF37N3yv5XJ-QsH2I6UMV
 centive_sdk/models/requests.py,sha256=6KW5KEjyMAy-DAppTssu5b-LSf1doKtMnOfng5O3tNc,7153
 centive_sdk/models/responses.py,sha256=zCYPB0aL2DXn-z0Febkuxo3DdZ_5sdpdGy2Jtf8Ubs8,2519
 centive_sdk/resources/__init__.py,sha256=GLutz38X4F4FwPfSZy35EkWTV7l7t9RgcBKwXmz2X_Y,179
-centive_sdk/resources/async_sessions.py,sha256=P7BDnkTKKU26kSCK5p91R593FurOHCHH0iF8PcTU1ZQ,20691
+centive_sdk/resources/async_sessions.py,sha256=m0_gj2wLabs3BTe6rZuo9WGgSwEMJLmdKW8_s4T7KRM,21500
 centive_sdk/resources/async_telemetry.py,sha256=wT12g9rG2dp_ml5YpAYCxobLlhfcsyy-LHty4bwwFZI,2431
 centive_sdk/resources/message_accumulator.py,sha256=Or3sMGkXG9upeQ9sm8YWL_V5vvsxtnE9tu52VBUUGgY,19261
 centive_sdk/resources/sessions.py,sha256=Ipg4bpmpejA5WoALbT49ah0c3I7x4OgPn9tSmfW8JAw,16741
-centive_sdk/resources/telemetry_batcher.py,sha256=Oiysy_TsvxZU26H0vUjlWB5sH8M5krSuL9RjZgwDQiw,13537
+centive_sdk/resources/telemetry_batcher.py,sha256=OkOv2Iir6E_9mdtAKvelol3RaveGSlH-ckIoE2cQYCc,14629
 centive_sdk/resources/websocket_server.py,sha256=iGS48oB4myV-sI0nArlBE3Y0fe_GlfBClFtVAPzrvdU,59760
-centive_sdk-2.2.0.dev4.dist-info/METADATA,sha256=TAMEhgIrXDXIyl_E-T8tCqJNEZS9ZumpFUpPYTKgZic,36427
-centive_sdk-2.2.0.dev4.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
-centive_sdk-2.2.0.dev4.dist-info/licenses/LICENSE,sha256=9dFibPr7z9srhWwd35lQL2MX1Kx2qivEZdVQb9L8Q-Q,1064
-centive_sdk-2.2.0.dev4.dist-info/RECORD,,
+centive_sdk-2.2.0.dev5.dist-info/METADATA,sha256=6hTQ3pohxlZnB5dEEwBLq5vngFLK5LhX7NXgPMp9HOM,36427
+centive_sdk-2.2.0.dev5.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+centive_sdk-2.2.0.dev5.dist-info/licenses/LICENSE,sha256=9dFibPr7z9srhWwd35lQL2MX1Kx2qivEZdVQb9L8Q-Q,1064
+centive_sdk-2.2.0.dev5.dist-info/RECORD,,