cortexdbai 0.10.0__tar.gz → 0.10.2__tar.gz

{cortexdbai-0.10.0 → cortexdbai-0.10.2}/.gitignore

@@ -80,3 +80,15 @@ local-instance/
 
 # doc-claims verifier scratch output
 tools/verifier_out*/
+
+# Generated benchmark / runtime data (audit M-10: hundreds of untracked
+# data dirs at the workspace root slow every git status/search and risk
+# being packaged; results JSONs are artifacts, never source)
+benchmarks/data_*/
+benchmarks/**/fast_results/
+data_*/
+*_data/
+cortexdb_data*/
+server_results/
+*.log
+docker_build.log

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cortexdbai
-Version: 0.10.0
+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.0 → 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.0 → cortexdbai-0.10.2}/cortexdb/__init__.py

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

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

@@ -33,7 +33,7 @@ from cortexdb.v1.exceptions import (
 
 
 DEFAULT_TIMEOUT_SECONDS = 60.0
-DEFAULT_API_URL = "http://localhost:3142"
+DEFAULT_API_URL = "http://localhost:3141"
 
 
 # ── Internal helpers ────────────────────────────────────────────────────────
@@ -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.0 → cortexdbai-0.10.2}/pyproject.toml

@@ -1,186 +1,186 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "cortexdbai"
-version = "0.10.0"
-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.2"
+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"]