cortexdbai 0.2.1__tar.gz → 0.2.3__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cortexdbai
-Version: 0.2.1
+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.1 → 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.1"
-__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.1 → cortexdbai-0.2.3}/cortexdb/v1/__init__.py

@@ -1,60 +1,60 @@
-"""CortexDB v1 Python SDK.
-
-The v1 API surface uses scope paths (``org:foo/user:bar``), the
-``ExperienceEnvelope`` shape on write, the stratified ``StratifiedPack``
-shape on recall, and PASETO/JWT bearer auth (with ``X-Cortex-Actor``
-required on every request).
-
-Quick start:
-
-.. code-block:: python
-
-    from cortexdb.v1 import V1Client
-
-    client = V1Client(
-        api_url="https://api.cortexdb.ai",  # or http://localhost:3142 for v1 surface
-        actor="user:alice",
-        bearer="eyJ...",  # PASETO v4 public or JWT (RS256/ES256)
-    )
-
-    # Ingest
-    client.experience_bulk("org:initech/user:alice", [
-        {"role": "user", "text": "I love coffee in the morning"},
-    ])
-
-    # Recall
-    pack = client.recall("org:initech/user:alice", query="What does Alice drink?")
-
-    # Answer
-    out = client.answer(
-        "org:initech/user:alice",
-        question="What does Alice drink?",
-        question_type="single-session-user",
-    )
-    print(out["answer"])
-"""
-
-from cortexdb.v1.client import AsyncV1Client, V1Client
-from cortexdb.v1.exceptions import (
-    V1APIError,
-    V1AuthError,
-    V1ConnectionError,
-    V1Error,
-    V1NotConfiguredError,
-    V1PolicyDeniedError,
-    V1RateLimitError,
-    V1TimeoutError,
-)
-
-__all__ = [
-    "V1Client",
-    "AsyncV1Client",
-    "V1Error",
-    "V1APIError",
-    "V1AuthError",
-    "V1ConnectionError",
-    "V1TimeoutError",
-    "V1RateLimitError",
-    "V1NotConfiguredError",
-    "V1PolicyDeniedError",
-]
+"""CortexDB v1 Python SDK.
+
+The v1 API surface uses scope paths (``org:foo/user:bar``), the
+``ExperienceEnvelope`` shape on write, the stratified ``StratifiedPack``
+shape on recall, and PASETO/JWT bearer auth (with ``X-Cortex-Actor``
+required on every request).
+
+Quick start:
+
+.. code-block:: python
+
+    from cortexdb.v1 import V1Client
+
+    client = V1Client(
+        api_url="https://api.cortexdb.ai",  # or http://localhost:3142 for v1 surface
+        actor="user:alice",
+        bearer="eyJ...",  # PASETO v4 public or JWT (RS256/ES256)
+    )
+
+    # Ingest
+    client.experience_bulk("org:initech/user:alice", [
+        {"role": "user", "text": "I love coffee in the morning"},
+    ])
+
+    # Recall
+    pack = client.recall("org:initech/user:alice", query="What does Alice drink?")
+
+    # Answer
+    out = client.answer(
+        "org:initech/user:alice",
+        question="What does Alice drink?",
+        question_type="single-session-user",
+    )
+    print(out["answer"])
+"""
+
+from cortexdb.v1.client import AsyncV1Client, V1Client
+from cortexdb.v1.exceptions import (
+    V1APIError,
+    V1AuthError,
+    V1ConnectionError,
+    V1Error,
+    V1NotConfiguredError,
+    V1PolicyDeniedError,
+    V1RateLimitError,
+    V1TimeoutError,
+)
+
+__all__ = [
+    "V1Client",
+    "AsyncV1Client",
+    "V1Error",
+    "V1APIError",
+    "V1AuthError",
+    "V1ConnectionError",
+    "V1TimeoutError",
+    "V1RateLimitError",
+    "V1NotConfiguredError",
+    "V1PolicyDeniedError",
+]