cortexdbai 0.10.1__tar.gz → 0.10.2__tar.gz

{cortexdbai-0.10.1 → cortexdbai-0.10.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cortexdbai
-Version: 0.10.1
+Version: 0.10.2
 Summary: The Long-Term Memory Layer for AI Systems
 Project-URL: Homepage, https://cortexdb.ai
 Project-URL: Documentation, https://docs.cortexdb.ai
@@ -187,7 +187,7 @@ ans = c.answer("ws:demo", "What changed in payments recently?")
 
 # Forget — GDPR erasure. confirm_all wipes the whole scope.
 c.forget("ws:demo", confirm_all=True, cascade="redact_events",
-         audit_note="GDPR Article 17 request")
+         reason="GDPR Article 17 request")
 
 # Layer reads (paginated { items, has_more }).
 c.events("ws:demo")

{cortexdbai-0.10.1 → cortexdbai-0.10.2}/README.md

@@ -74,7 +74,7 @@ ans = c.answer("ws:demo", "What changed in payments recently?")
 
 # Forget — GDPR erasure. confirm_all wipes the whole scope.
 c.forget("ws:demo", confirm_all=True, cascade="redact_events",
-         audit_note="GDPR Article 17 request")
+         reason="GDPR Article 17 request")
 
 # Layer reads (paginated { items, has_more }).
 c.events("ws:demo")

{cortexdbai-0.10.1 → cortexdbai-0.10.2}/cortexdb/__init__.py

@@ -1,71 +1,71 @@
-"""CortexDB Python SDK — the long-term memory layer for AI systems.
-
-The SDK is a thin HTTP client over the v1 API surface that cortexdb
-exposes by default on port 3141. The top-level :class:`Cortex` class
-(alias :class:`V1Client`) is what you should reach for.
-
-Quick start::
-
-    from cortexdb import Cortex
-
-    # Local docker run with no auth (CORTEX_API_KEY unset on the server):
-    with Cortex("http://localhost:3141") as c:
-        c.experience("ws:demo", text="Priya at Acme signed for 200 seats.")
-        pack = c.recall("ws:demo", query="How many seats did Acme sign for?")
-        print(pack)
-
-    # Hosted / multi-tenant deployment with PASETO bearer + actor header:
-    with Cortex(
-        "https://api-v1.cortexdb.ai",
-        actor="user:alice",
-        bearer="eyJ...",
-    ) as c:
-        out = c.answer(
-            "org:initech/user:alice",
-            question="What did Alice say about coffee?",
-        )
-
-Versions ≤ 0.2.x exposed a separate ``cortexdb.Cortex`` class targeting
-the legacy ``/v1/remember`` endpoints. That surface was retired in 0.3.0
-because the cortexdb binary's public port now only serves the v1 API;
-the legacy endpoints survive only as an internal bench-compat helper.
-If you need them, pin ``cortexdbai<0.3``.
-"""
-
-from cortexdb.v1 import V1Client, AsyncV1Client
-from cortexdb.v1.exceptions import (
-    V1APIError,
-    V1AuthError,
-    V1ConnectionError,
-    V1Error,
-    V1NotConfiguredError,
-    V1PolicyDeniedError,
-    V1RateLimitError,
-    V1TimeoutError,
-)
-from cortexdb import v1  # the explicit submodule namespace
-
-# Ergonomic top-level aliases. New code can write either form.
-Cortex = V1Client
-AsyncCortex = AsyncV1Client
-
-__version__ = "0.10.1"
-__all__ = [
-    # Clients (preferred top-level names)
-    "Cortex",
-    "AsyncCortex",
-    # Explicit v1 names (identical classes, kept for code that pinned them)
-    "V1Client",
-    "AsyncV1Client",
-    # Submodule
-    "v1",
-    # Exceptions
-    "V1Error",
-    "V1APIError",
-    "V1AuthError",
-    "V1ConnectionError",
-    "V1TimeoutError",
-    "V1RateLimitError",
-    "V1NotConfiguredError",
-    "V1PolicyDeniedError",
-]
+"""CortexDB Python SDK — the long-term memory layer for AI systems.
+
+The SDK is a thin HTTP client over the v1 API surface that cortexdb
+exposes by default on port 3141. The top-level :class:`Cortex` class
+(alias :class:`V1Client`) is what you should reach for.
+
+Quick start::
+
+    from cortexdb import Cortex
+
+    # Local docker run with no auth (CORTEX_API_KEY unset on the server):
+    with Cortex("http://localhost:3141") as c:
+        c.experience("ws:demo", text="Priya at Acme signed for 200 seats.")
+        pack = c.recall("ws:demo", query="How many seats did Acme sign for?")
+        print(pack)
+
+    # Hosted / multi-tenant deployment with PASETO bearer + actor header:
+    with Cortex(
+        "https://api-v1.cortexdb.ai",
+        actor="user:alice",
+        bearer="eyJ...",
+    ) as c:
+        out = c.answer(
+            "org:initech/user:alice",
+            question="What did Alice say about coffee?",
+        )
+
+Versions ≤ 0.2.x exposed a separate ``cortexdb.Cortex`` class targeting
+the legacy ``/v1/remember`` endpoints. That surface was retired in 0.3.0
+because the cortexdb binary's public port now only serves the v1 API;
+the legacy endpoints survive only as an internal bench-compat helper.
+If you need them, pin ``cortexdbai<0.3``.
+"""
+
+from cortexdb.v1 import V1Client, AsyncV1Client
+from cortexdb.v1.exceptions import (
+    V1APIError,
+    V1AuthError,
+    V1ConnectionError,
+    V1Error,
+    V1NotConfiguredError,
+    V1PolicyDeniedError,
+    V1RateLimitError,
+    V1TimeoutError,
+)
+from cortexdb import v1  # the explicit submodule namespace
+
+# Ergonomic top-level aliases. New code can write either form.
+Cortex = V1Client
+AsyncCortex = AsyncV1Client
+
+__version__ = "0.10.1"
+__all__ = [
+    # Clients (preferred top-level names)
+    "Cortex",
+    "AsyncCortex",
+    # Explicit v1 names (identical classes, kept for code that pinned them)
+    "V1Client",
+    "AsyncV1Client",
+    # Submodule
+    "v1",
+    # Exceptions
+    "V1Error",
+    "V1APIError",
+    "V1AuthError",
+    "V1ConnectionError",
+    "V1TimeoutError",
+    "V1RateLimitError",
+    "V1NotConfiguredError",
+    "V1PolicyDeniedError",
+]

{cortexdbai-0.10.1 → cortexdbai-0.10.2}/cortexdb/v1/client.py

@@ -384,7 +384,9 @@ class V1Client:
         processor. A ``triple`` (subject/predicate/object dict, see
         :func:`_envelope`) writes a fact deterministically — no LLM extractor
         in the loop (server >= v0.7.0). ``wait`` selects sync semantics:
-        ``captured``, ``indexed``, ``consolidated``."""
+        ``captured``, ``indexed``, ``consolidated`` (``accepted`` is a valid
+        alias for the omitted default on server >= v0.8.7; anything else
+        422s listing the valid values)."""
         env = _envelope(
             scope,
             role=role,
@@ -458,7 +460,10 @@ class V1Client:
         ``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."""
+        :meth:`experience`'s ``wait``, ideal for bulk-ingest-then-recall.
+        Items whose envelope carries a ``triple`` write their facts
+        deterministically in bulk too (server >= v0.8.7; older servers only
+        did this on the single-write endpoint)."""
         envelopes = [
             _envelope(
                 scope=str(item.get("scope", scope)),
@@ -900,6 +905,25 @@ class V1Client:
         Requires ``diagnostics.read``. Stability: ``experimental``."""
         return self._get("/v1/admin/layers/stats")
 
+    def index_audit(
+        self,
+        *,
+        repair: bool = False,
+        scope: Optional[str] = None,
+    ) -> dict:
+        """``POST /v1/admin/index-audit`` — WAL↔search-index self-audit.
+        Reports events whose search-index entries are missing; with
+        ``repair=True`` re-indexes them from stored state (server >= v0.8.7
+        also rebuilds missing content rows from the WAL event content).
+        ``scope`` restricts the audit and repair to one scope subtree
+        (honored on server >= v0.8.7; silently ignored before). Requires
+        ``diagnostics.read``. Synchronous full-WAL walk — can take seconds
+        to minutes on a large store. Stability: ``experimental``."""
+        body: dict = {"repair": repair}
+        if scope is not None:
+            body["scope"] = scope
+        return self._post("/v1/admin/index-audit", body)
+
     # ── low-level transport ──────────────────────────────────────────
 
     def _get(

{cortexdbai-0.10.1 → cortexdbai-0.10.2}/pyproject.toml

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