cortexdbai 0.2.4__tar.gz → 0.3.0__tar.gz

{cortexdbai-0.2.4 → cortexdbai-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cortexdbai
-Version: 0.2.4
+Version: 0.3.0
 Summary: The Long-Term Memory Layer for AI Systems
 Project-URL: Homepage, https://cortexdb.ai
 Project-URL: Documentation, https://docs.cortexdb.ai
@@ -10,11 +10,9 @@ Project-URL: Changelog, https://github.com/cortexdb/cortexdb/blob/main/CHANGELOG
 Author-email: Prashant Malik <prashant@cortexdb.ai>
 License-Expression: Apache-2.0
 Keywords: ai,cortexdb,event-sourcing,knowledge-graph,llm,memory
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -22,7 +20,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Database
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Typing :: Typed
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Requires-Dist: httpx>=0.24
 Requires-Dist: pydantic>=2.0
 Requires-Dist: requests>=2.31

cortexdbai-0.3.0/cortexdb/__init__.py

@@ -0,0 +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.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.3.0"
+__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.2.4 → cortexdbai-0.3.0}/pyproject.toml

@@ -4,21 +4,27 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cortexdbai"
-version = "0.2.4"
+version = "0.3.0"
 description = "The Long-Term Memory Layer for AI Systems"
 readme = "README.md"
 license = "Apache-2.0"
-requires-python = ">=3.9"
+# 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 :: 3 - Alpha",
+    "Development Status :: 4 - Beta",
     "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",
@@ -55,7 +61,7 @@ Changelog = "https://github.com/cortexdb/cortexdb/blob/main/CHANGELOG.md"
 packages = ["cortexdb"]
 
 [tool.ruff]
-target-version = "py39"
+target-version = "py310"
 line-length = 100
 
 [tool.ruff.lint]

cortexdbai-0.2.4/cortexdb/__init__.py

@@ -1,116 +0,0 @@
-"""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.4"
-__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",
-]