cortexdbai 0.3.1__tar.gz → 0.3.2__tar.gz

{cortexdbai-0.3.1 → cortexdbai-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cortexdbai
-Version: 0.3.1
+Version: 0.3.2
 Summary: The Long-Term Memory Layer for AI Systems
 Project-URL: Homepage, https://cortexdb.ai
 Project-URL: Documentation, https://docs.cortexdb.ai

{cortexdbai-0.3.1 → cortexdbai-0.3.2}/cortexdb/__init__.py

@@ -49,7 +49,7 @@ from cortexdb import v1  # the explicit submodule namespace
 Cortex = V1Client
 AsyncCortex = AsyncV1Client
 
-__version__ = "0.3.1"
+__version__ = "0.3.2"
 __all__ = [
     # Clients (preferred top-level names)
     "Cortex",

{cortexdbai-0.3.1 → cortexdbai-0.3.2}/cortexdb/v1/client.py

@@ -62,6 +62,22 @@ def _build_headers(
     return h
 
 
+def _capture_sdk_error(exc: BaseException) -> None:
+    """Best-effort client-side error tracking (observability plan, Phase 6).
+
+    If the host application uses Sentry, forward SDK transport/API errors to
+    it so failures users hit are visible to the operator. This is a NO-OP when
+    ``sentry_sdk`` isn't installed or isn't initialized — the SDK never
+    initializes Sentry itself (the app owns that decision and the DSN)."""
+    try:
+        import sentry_sdk
+
+        if sentry_sdk.Hub.current.client is not None:
+            sentry_sdk.capture_exception(exc)
+    except Exception:
+        pass
+
+
 def _raise_for_response(status: int, text: str) -> None:
     """If the response is non-2xx, raise the most-specific V1APIError
     subclass derived from the v1 error envelope. Otherwise return None."""
@@ -71,7 +87,9 @@ def _raise_for_response(status: int, text: str) -> None:
         body = json.loads(text) if text else {}
     except json.JSONDecodeError:
         body = {"error_code": "UNKNOWN", "message": text[:500]}
-    raise V1APIError.from_response(status, body)
+    err = V1APIError.from_response(status, body)
+    _capture_sdk_error(err)
+    raise err
 
 
 def _envelope(
@@ -260,11 +278,18 @@ class V1Client:
         self,
         scope: str,
         items: Iterable[Mapping[str, Any]],
+        *,
+        wait: Optional[str] = None,
     ) -> dict:
         """``POST /v1/experience/bulk`` — accepts up to 1000 envelopes per
         request. ``items`` is a sequence of dicts with at least ``text``
         (or ``json_data``) plus optional ``role`` / ``observed_at`` /
-        ``labels`` / ``idempotency_key`` keys."""
+        ``labels`` / ``idempotency_key`` keys.
+
+        ``wait`` turns the batch into a barrier: pass ``"indexed"`` (or
+        ``"consolidated"`` etc.) to block until every accepted event reaches
+        that stage before returning — the batch analogue of
+        :meth:`experience`'s ``wait``, ideal for bulk-ingest-then-recall."""
         envelopes = [
             _envelope(
                 scope=str(item.get("scope", scope)),
@@ -278,7 +303,8 @@ class V1Client:
             )
             for item in items
         ]
-        return self._post("/v1/experience/bulk", {"items": envelopes})
+        path = "/v1/experience/bulk" + (f"?wait={wait}" if wait else "")
+        return self._post(path, {"items": envelopes})
 
     # ── recall + answer ───────────────────────────────────────────────
 

{cortexdbai-0.3.1 → cortexdbai-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cortexdbai"
-version = "0.3.1"
+version = "0.3.2"
 description = "The Long-Term Memory Layer for AI Systems"
 readme = "README.md"
 license = "Apache-2.0"