cortexdbai 0.2.2__tar.gz → 0.2.3__tar.gz

{cortexdbai-0.2.2 → cortexdbai-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cortexdbai
-Version: 0.2.2
+Version: 0.2.3
 Summary: The Long-Term Memory Layer for AI Systems
 Project-URL: Homepage, https://cortexdb.ai
 Project-URL: Documentation, https://docs.cortexdb.ai
@@ -25,6 +25,7 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.9
 Requires-Dist: httpx>=0.24
 Requires-Dist: pydantic>=2.0
+Requires-Dist: requests>=2.31
 Requires-Dist: tenacity>=8.0
 Provides-Extra: async
 Requires-Dist: httpx[http2]; extra == 'async'

{cortexdbai-0.2.2 → cortexdbai-0.2.3}/cortexdb/__init__.py

@@ -1,116 +1,116 @@
-"""CortexDB Python SDK — The Long-Term Memory Layer for AI Systems.
-
-Two API surfaces are available:
-
-* The top-level :class:`Cortex` / :class:`AsyncCortex` clients target the
-  legacy v0 endpoints (``/v1/remember``, ``/v1/recall``, ``/v1/answer``
-  with the v0 request shape) served on port 3141 by default. Used by
-  existing integrations.
-* The :mod:`cortexdb.v1` submodule targets the new v1 surface
-  (``/v1/experience``, stratified-pack recall, layered ``/v1/answer``,
-  ``/v1/episodes``, ``/v1/beliefs``, ``/v1/understanding``,
-  ``/v1/admin/layers/stats``, ``/v1/audit``, ``/v1/forget``) served on
-  port 3142 in dual-port deployments, with PASETO/JWT bearer auth.
-  New apps should use :class:`cortexdb.v1.V1Client`.
-
-Quick start (v1):
-
-.. code-block:: python
-
-    from cortexdb.v1 import V1Client
-
-    with V1Client("https://api.cortexdb.ai", actor="user:alice", bearer=token) as c:
-        c.experience_bulk("org:initech/user:alice", [{"text": "hello"}])
-        out = c.answer("org:initech/user:alice", "what did I say?",
-                       question_type="single-session-user")
-        print(out["answer"])
-"""
-
-from cortexdb.client import AsyncCortex, Cortex
-from cortexdb import v1  # re-export the v1 namespace
-from cortexdb.exceptions import (
-    CortexAPIError,
-    CortexAuthError,
-    CortexConnectionError,
-    CortexError,
-    CortexRateLimitError,
-    CortexTimeoutError,
-)
-from cortexdb.models import (
-    Actor,
-    ActorType,
-    BlobRef,
-    ContentType,
-    EntityRef,
-    EntityRelationship,
-    EntityResponse,
-    Episode,
-    EpisodeBrief,
-    EpisodeType,
-    ForgetRequest,
-    ForgetResponse,
-    HealthResponse,
-    IngestEpisodeRequest,
-    IngestEpisodeResponse,
-    LinkResponse,
-    ListEpisodesResponse,
-    MetricsResponse,
-    ProcessingStatus,
-    RecallMemory,
-    RecallRequest,
-    RecallResponse,
-    RememberRequest,
-    RememberResponse,
-    SearchResponse,
-    Source,
-    Visibility,
-    VisibilityLevel,
-)
-
-__version__ = "0.2.2"
-__all__ = [
-    # v1 surface (recommended for new apps)
-    "v1",
-    # Legacy v0 clients
-    "Cortex",
-    "AsyncCortex",
-    # Enums
-    "EpisodeType",
-    "ActorType",
-    "VisibilityLevel",
-    "ContentType",
-    "ProcessingStatus",
-    # Core models
-    "Actor",
-    "Source",
-    "Visibility",
-    "EntityRef",
-    "Episode",
-    "BlobRef",
-    "RecallMemory",
-    # Request models
-    "IngestEpisodeRequest",
-    "RememberRequest",
-    "RecallRequest",
-    "ForgetRequest",
-    # Response models
-    "IngestEpisodeResponse",
-    "RememberResponse",
-    "RecallResponse",
-    "ForgetResponse",
-    "ListEpisodesResponse",
-    "HealthResponse",
-    "MetricsResponse",
-    "EntityResponse",
-    "EntityRelationship",
-    "EpisodeBrief",
-    "LinkResponse",
-    "SearchResponse",
-    # Exceptions
-    "CortexError",
-    "CortexAPIError",
-    "CortexConnectionError",
-    "CortexTimeoutError",
-    "CortexAuthError",
-    "CortexRateLimitError",
-]
+"""CortexDB Python SDK — The Long-Term Memory Layer for AI Systems.
+
+Two API surfaces are available:
+
+* The top-level :class:`Cortex` / :class:`AsyncCortex` clients target the
+  legacy v0 endpoints (``/v1/remember``, ``/v1/recall``, ``/v1/answer``
+  with the v0 request shape) served on port 3141 by default. Used by
+  existing integrations.
+* The :mod:`cortexdb.v1` submodule targets the new v1 surface
+  (``/v1/experience``, stratified-pack recall, layered ``/v1/answer``,
+  ``/v1/episodes``, ``/v1/beliefs``, ``/v1/understanding``,
+  ``/v1/admin/layers/stats``, ``/v1/audit``, ``/v1/forget``) served on
+  port 3142 in dual-port deployments, with PASETO/JWT bearer auth.
+  New apps should use :class:`cortexdb.v1.V1Client`.
+
+Quick start (v1):
+
+.. code-block:: python
+
+    from cortexdb.v1 import V1Client
+
+    with V1Client("https://api.cortexdb.ai", actor="user:alice", bearer=token) as c:
+        c.experience_bulk("org:initech/user:alice", [{"text": "hello"}])
+        out = c.answer("org:initech/user:alice", "what did I say?",
+                       question_type="single-session-user")
+        print(out["answer"])
+"""
+
+from cortexdb.client import AsyncCortex, Cortex
+from cortexdb import v1  # re-export the v1 namespace
+from cortexdb.exceptions import (
+    CortexAPIError,
+    CortexAuthError,
+    CortexConnectionError,
+    CortexError,
+    CortexRateLimitError,
+    CortexTimeoutError,
+)
+from cortexdb.models import (
+    Actor,
+    ActorType,
+    BlobRef,
+    ContentType,
+    EntityRef,
+    EntityRelationship,
+    EntityResponse,
+    Episode,
+    EpisodeBrief,
+    EpisodeType,
+    ForgetRequest,
+    ForgetResponse,
+    HealthResponse,
+    IngestEpisodeRequest,
+    IngestEpisodeResponse,
+    LinkResponse,
+    ListEpisodesResponse,
+    MetricsResponse,
+    ProcessingStatus,
+    RecallMemory,
+    RecallRequest,
+    RecallResponse,
+    RememberRequest,
+    RememberResponse,
+    SearchResponse,
+    Source,
+    Visibility,
+    VisibilityLevel,
+)
+
+__version__ = "0.2.3"
+__all__ = [
+    # v1 surface (recommended for new apps)
+    "v1",
+    # Legacy v0 clients
+    "Cortex",
+    "AsyncCortex",
+    # Enums
+    "EpisodeType",
+    "ActorType",
+    "VisibilityLevel",
+    "ContentType",
+    "ProcessingStatus",
+    # Core models
+    "Actor",
+    "Source",
+    "Visibility",
+    "EntityRef",
+    "Episode",
+    "BlobRef",
+    "RecallMemory",
+    # Request models
+    "IngestEpisodeRequest",
+    "RememberRequest",
+    "RecallRequest",
+    "ForgetRequest",
+    # Response models
+    "IngestEpisodeResponse",
+    "RememberResponse",
+    "RecallResponse",
+    "ForgetResponse",
+    "ListEpisodesResponse",
+    "HealthResponse",
+    "MetricsResponse",
+    "EntityResponse",
+    "EntityRelationship",
+    "EpisodeBrief",
+    "LinkResponse",
+    "SearchResponse",
+    # Exceptions
+    "CortexError",
+    "CortexAPIError",
+    "CortexConnectionError",
+    "CortexTimeoutError",
+    "CortexAuthError",
+    "CortexRateLimitError",
+]

{cortexdbai-0.2.2 → cortexdbai-0.2.3}/cortexdb/v1/client.py

@@ -289,11 +289,17 @@ class V1Client:
         query: Optional[str] = None,
         view: str = "holistic",
         include: Optional[Sequence[str]] = None,
-        diagnostics: str = "summary",
+        diagnostics: str = "none",
         budgets: Optional[Mapping[str, Any]] = None,
         temporal: Optional[Mapping[str, Any]] = None,
     ) -> dict:
-        """``POST /v1/recall`` — returns a ``StratifiedPack``."""
+        """``POST /v1/recall`` — returns a ``StratifiedPack``.
+
+        ``diagnostics`` defaults to ``"none"`` so free-tier tokens — which
+        do not carry the ``diagnostics.read`` capability — succeed on the
+        first call. Pass ``diagnostics="summary"`` (or ``"full"``) when
+        you hold the elevated capability and want pipeline provenance.
+        """
         body: dict = {"scope": scope, "view": view, "diagnostics": diagnostics}
         if query:
             body["query"] = query
@@ -632,8 +638,12 @@ class AsyncV1Client:
         *,
         query: Optional[str] = None,
         view: str = "holistic",
+        diagnostics: str = "none",
     ) -> dict:
-        body: dict = {"scope": scope, "view": view}
+        """``POST /v1/recall``. ``diagnostics`` defaults to ``"none"`` so
+        free-tier tokens succeed on the first call (no ``diagnostics.read``
+        capability required)."""
+        body: dict = {"scope": scope, "view": view, "diagnostics": diagnostics}
         if query:
             body["query"] = query
         return await self._post("/v1/recall", body)

{cortexdbai-0.2.2 → cortexdbai-0.2.3}/pyproject.toml

@@ -1,65 +1,66 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "cortexdbai"
-version = "0.2.2"
-description = "The Long-Term Memory Layer for AI Systems"
-readme = "README.md"
-license = "Apache-2.0"
-requires-python = ">=3.9"
-authors = [
-    { name = "Prashant Malik", email = "prashant@cortexdb.ai" },
-]
-keywords = ["ai", "memory", "llm", "knowledge-graph", "event-sourcing", "cortexdb"]
-classifiers = [
-    "Development Status :: 3 - Alpha",
-    "Intended Audience :: Developers",
-    "License :: OSI Approved :: Apache Software License",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
-    "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 = [
-    "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",
-]
-
-[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 = "py39"
-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.2.3"
+description = "The Long-Term Memory Layer for AI Systems"
+readme = "README.md"
+license = "Apache-2.0"
+requires-python = ">=3.9"
+authors = [
+    { name = "Prashant Malik", email = "prashant@cortexdb.ai" },
+]
+keywords = ["ai", "memory", "llm", "knowledge-graph", "event-sourcing", "cortexdb"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "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",
+]
+
+[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 = "py39"
+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"]