cortexdbai 0.2.5__tar.gz → 0.3.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cortexdbai
-Version: 0.2.5
+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

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.5 → cortexdbai-0.3.0}/pyproject.toml

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

cortexdbai-0.2.5/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.5"
-__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",
-]