cortexdbai 0.10.1__tar.gz → 0.10.3__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cortexdbai
-Version: 0.10.1
+Version: 0.10.3
 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.3}/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.3}/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.3"
+__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.3}/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,
@@ -443,6 +445,24 @@ class V1Client:
         _raise_for_response(r.status_code, r.text)
         return r.json() if r.text else {}
 
+    def delete_blob(self, blob_id: str) -> dict:
+        """``DELETE /v1/blobs/{id}`` — purge an uploaded object.
+
+        Only the uploader may delete a blob; someone else's blob answers
+        404. Note that forgetting the experience which referenced a blob
+        removes the *memory*, not the *object* — deleting a file that was
+        uploaded here means both calls."""
+        try:
+            r = self._session.delete(
+                f"{self.api_url}/v1/blobs/{blob_id}", timeout=self.timeout
+            )
+        except requests.Timeout as e:
+            raise V1TimeoutError(str(e)) from e
+        except requests.ConnectionError as e:
+            raise V1ConnectionError(str(e)) from e
+        _raise_for_response(r.status_code, r.text)
+        return r.json() if r.text else {}
+
     def experience_bulk(
         self,
         scope: str,
@@ -458,7 +478,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 +923,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(
@@ -1104,6 +1146,19 @@ class AsyncV1Client:
         _raise_for_response(r.status_code, r.text)
         return r.json() if r.text else {}
 
+    async def delete_blob(self, blob_id: str) -> dict:
+        """``DELETE /v1/blobs/{id}`` — purge an uploaded object (uploader
+        only). Forgetting the referencing experience removes the memory, not
+        the object; deleting an uploaded file means both calls."""
+        try:
+            r = await self._client.delete(f"{self.api_url}/v1/blobs/{blob_id}")
+        except httpx.TimeoutException as e:
+            raise V1TimeoutError(str(e)) from e
+        except httpx.HTTPError as e:
+            raise V1ConnectionError(str(e)) from e
+        _raise_for_response(r.status_code, r.text)
+        return r.json() if r.text else {}
+
     async def recall(
         self,
         scope: str,

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

@@ -1,186 +1,186 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "cortexdbai"
-version = "0.10.1"
-description = "The Long-Term Memory Layer for AI Systems"
-readme = "README.md"
-license = "Apache-2.0"
-# 3.10+: the v1 module uses PEP 604 unions (`str | None`) in TypedDict
-# field annotations, which Python 3.9 cannot evaluate at class-definition
-# time even with `from __future__ import annotations`. Python 3.9 hit
-# end-of-life on 2025-10-31. Declaring >=3.10 means `pip install
-# cortexdbai` on 3.9 fails immediately with a clear "requires Python
-# 3.10+" error from pip — not a silent install followed by an obscure
-# `TypeError: Unable to evaluate type annotation 'str | None'` on the
-# first import.
-requires-python = ">=3.10"
-authors = [
-    { name = "Prashant Malik", email = "prashant@cortexdb.ai" },
-]
-keywords = ["ai", "memory", "llm", "knowledge-graph", "event-sourcing", "cortexdb"]
-classifiers = [
-    "Development Status :: 4 - Beta",
-    "Intended Audience :: Developers",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
-    "Topic :: Scientific/Engineering :: Artificial Intelligence",
-    "Topic :: Database",
-    "Typing :: Typed",
-]
-dependencies = [
-    "requests>=2.31",
-    "httpx>=0.24",
-    "pydantic>=2.0",
-    "tenacity>=8.0",
-]
-
-[project.optional-dependencies]
-async = [
-    "httpx[http2]",
-]
-dev = [
-    "pytest>=8.0",
-    "pytest-asyncio>=0.23",
-    "ruff>=0.4",
-]
-
-# --- Framework / provider integrations -------------------------------------
-# Each extra pulls in only the third-party framework needed by the matching
-# submodule under `cortexdb.integrations.<name>`. The CortexDB client itself
-# is always the base package, so it is never listed here. Nothing under
-# `cortexdb.integrations` is imported at `import cortexdb` time — importing a
-# submodule without its extra raises a clean ModuleNotFoundError.
-autogen = [
-    "ag2>=0.4",
-]
-ag2 = [
-    "ag2>=0.4",
-]
-agno = [
-    "agno>=1.0",
-]
-langchain = [
-    "langchain-core>=0.3",
-]
-beeai = [
-    "beeai-framework>=0.1",
-]
-camel = [
-    "camel-ai>=0.2",
-]
-controlflow = [
-    "controlflow>=0.11",
-]
-crewai = [
-    "crewai>=0.80",
-]
-dify = []
-dspy = [
-    "dspy>=2.0",
-]
-flowise = []
-google-adk = [
-    "google-adk>=0.1",
-]
-hermes = []
-instructor = [
-    "instructor>=1.0",
-    "pydantic>=2.0",
-]
-langgraph = [
-    "langchain-core>=0.3",
-    "langgraph-checkpoint>=2.0",
-]
-letta = [
-    "letta>=0.1",
-]
-llamaindex = [
-    "llama-index-core>=0.11",
-]
-nemo-guardrails = [
-    "nemoguardrails>=0.9",
-]
-openai-agents = [
-    "openai-agents>=0.1",
-]
-prefect = [
-    "prefect>=3.0",
-]
-pydanticai = [
-    "pydantic-ai>=0.1",
-]
-smolagents = [
-    "smolagents>=1.0",
-]
-temporal = [
-    "temporalio>=1.7",
-]
-groq = [
-    "httpx>=0.27",
-]
-fireworks = [
-    "httpx>=0.27",
-]
-together = [
-    "httpx>=0.27",
-]
-deepinfra = [
-    "httpx>=0.27",
-]
-ollama = [
-    "httpx>=0.27",
-]
-vllm = [
-    "httpx>=0.27",
-]
-# Convenience: every framework/provider integration at once.
-all-integrations = [
-    "ag2>=0.4",
-    "agno>=1.0",
-    "langchain-core>=0.3",
-    "beeai-framework>=0.1",
-    "camel-ai>=0.2",
-    "controlflow>=0.11",
-    "crewai>=0.80",
-    "dspy>=2.0",
-    "google-adk>=0.1",
-    "instructor>=1.0",
-    "langchain-core>=0.3",
-    "langgraph-checkpoint>=2.0",
-    "letta>=0.1",
-    "llama-index-core>=0.11",
-    "nemoguardrails>=0.9",
-    "openai-agents>=0.1",
-    "prefect>=3.0",
-    "pydantic-ai>=0.1",
-    "smolagents>=1.0",
-    "temporalio>=1.7",
-    "httpx>=0.27",
-]
-
-[project.urls]
-Homepage = "https://cortexdb.ai"
-Documentation = "https://docs.cortexdb.ai"
-Repository = "https://github.com/cortexdb/cortexdb"
-Issues = "https://github.com/cortexdb/cortexdb/issues"
-Changelog = "https://github.com/cortexdb/cortexdb/blob/main/CHANGELOG.md"
-
-[tool.hatch.build.targets.wheel]
-packages = ["cortexdb"]
-
-[tool.ruff]
-target-version = "py310"
-line-length = 100
-
-[tool.ruff.lint]
-select = ["E", "F", "W", "I", "N", "UP", "B", "A", "SIM", "TCH"]
-
-[tool.pytest.ini_options]
-asyncio_mode = "auto"
-testpaths = ["tests"]
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "cortexdbai"
+version = "0.10.3"
+description = "The Long-Term Memory Layer for AI Systems"
+readme = "README.md"
+license = "Apache-2.0"
+# 3.10+: the v1 module uses PEP 604 unions (`str | None`) in TypedDict
+# field annotations, which Python 3.9 cannot evaluate at class-definition
+# time even with `from __future__ import annotations`. Python 3.9 hit
+# end-of-life on 2025-10-31. Declaring >=3.10 means `pip install
+# cortexdbai` on 3.9 fails immediately with a clear "requires Python
+# 3.10+" error from pip — not a silent install followed by an obscure
+# `TypeError: Unable to evaluate type annotation 'str | None'` on the
+# first import.
+requires-python = ">=3.10"
+authors = [
+    { name = "Prashant Malik", email = "prashant@cortexdb.ai" },
+]
+keywords = ["ai", "memory", "llm", "knowledge-graph", "event-sourcing", "cortexdb"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Database",
+    "Typing :: Typed",
+]
+dependencies = [
+    "requests>=2.31",
+    "httpx>=0.24",
+    "pydantic>=2.0",
+    "tenacity>=8.0",
+]
+
+[project.optional-dependencies]
+async = [
+    "httpx[http2]",
+]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "ruff>=0.4",
+]
+
+# --- Framework / provider integrations -------------------------------------
+# Each extra pulls in only the third-party framework needed by the matching
+# submodule under `cortexdb.integrations.<name>`. The CortexDB client itself
+# is always the base package, so it is never listed here. Nothing under
+# `cortexdb.integrations` is imported at `import cortexdb` time — importing a
+# submodule without its extra raises a clean ModuleNotFoundError.
+autogen = [
+    "ag2>=0.4",
+]
+ag2 = [
+    "ag2>=0.4",
+]
+agno = [
+    "agno>=1.0",
+]
+langchain = [
+    "langchain-core>=0.3",
+]
+beeai = [
+    "beeai-framework>=0.1",
+]
+camel = [
+    "camel-ai>=0.2",
+]
+controlflow = [
+    "controlflow>=0.11",
+]
+crewai = [
+    "crewai>=0.80",
+]
+dify = []
+dspy = [
+    "dspy>=2.0",
+]
+flowise = []
+google-adk = [
+    "google-adk>=0.1",
+]
+hermes = []
+instructor = [
+    "instructor>=1.0",
+    "pydantic>=2.0",
+]
+langgraph = [
+    "langchain-core>=0.3",
+    "langgraph-checkpoint>=2.0",
+]
+letta = [
+    "letta>=0.1",
+]
+llamaindex = [
+    "llama-index-core>=0.11",
+]
+nemo-guardrails = [
+    "nemoguardrails>=0.9",
+]
+openai-agents = [
+    "openai-agents>=0.1",
+]
+prefect = [
+    "prefect>=3.0",
+]
+pydanticai = [
+    "pydantic-ai>=0.1",
+]
+smolagents = [
+    "smolagents>=1.0",
+]
+temporal = [
+    "temporalio>=1.7",
+]
+groq = [
+    "httpx>=0.27",
+]
+fireworks = [
+    "httpx>=0.27",
+]
+together = [
+    "httpx>=0.27",
+]
+deepinfra = [
+    "httpx>=0.27",
+]
+ollama = [
+    "httpx>=0.27",
+]
+vllm = [
+    "httpx>=0.27",
+]
+# Convenience: every framework/provider integration at once.
+all-integrations = [
+    "ag2>=0.4",
+    "agno>=1.0",
+    "langchain-core>=0.3",
+    "beeai-framework>=0.1",
+    "camel-ai>=0.2",
+    "controlflow>=0.11",
+    "crewai>=0.80",
+    "dspy>=2.0",
+    "google-adk>=0.1",
+    "instructor>=1.0",
+    "langchain-core>=0.3",
+    "langgraph-checkpoint>=2.0",
+    "letta>=0.1",
+    "llama-index-core>=0.11",
+    "nemoguardrails>=0.9",
+    "openai-agents>=0.1",
+    "prefect>=3.0",
+    "pydantic-ai>=0.1",
+    "smolagents>=1.0",
+    "temporalio>=1.7",
+    "httpx>=0.27",
+]
+
+[project.urls]
+Homepage = "https://cortexdb.ai"
+Documentation = "https://docs.cortexdb.ai"
+Repository = "https://github.com/cortexdb/cortexdb"
+Issues = "https://github.com/cortexdb/cortexdb/issues"
+Changelog = "https://github.com/cortexdb/cortexdb/blob/main/CHANGELOG.md"
+
+[tool.hatch.build.targets.wheel]
+packages = ["cortexdb"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "N", "UP", "B", "A", "SIM", "TCH"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]