recallrai 0.3.1__py3-none-any.whl → 0.3.2__py3-none-any.whl

recallrai/__init__.py

@@ -8,7 +8,7 @@ from .client import RecallrAI
 from .user import User
 from .session import Session
 
-__version__ = "0.3.1"
+__version__ = "0.3.2"
 
 __all__ = [
     "RecallrAI",

recallrai/models/session.py

@@ -62,6 +62,7 @@ class SessionStatus(str, enum.Enum):
     PENDING = "pending"
     PROCESSING = "processing"
     PROCESSED = "processed"
+    INSUFFICIENT_BALANCE = "insufficient_balance"
 
 
 class SessionModel(BaseModel):

recallrai/session.py

@@ -103,7 +103,8 @@ class Session:
         summaries_threshold: float = 0.5,
         last_n_messages: Optional[int] = None, 
         last_n_summaries: Optional[int] = None,
-        timezone: Optional[str] = None
+        timezone: Optional[str] = None,
+        include_system_prompt: bool = True
     ) -> Context:
         """
         Get the current context for this session.
@@ -117,6 +118,7 @@ class Session:
             last_n_messages: Number of last messages to include in context.
             last_n_summaries: Number of last summaries to include in context.
             timezone: Timezone for formatting timestamps (e.g., 'America/New_York'). None for UTC.
+            include_system_prompt: Whether to include the default system prompt of Recallr AI. Defaults to True.
 
         Returns:
             Context information with the memory text and whether memory was used.
@@ -136,6 +138,7 @@ class Session:
             "max_top_k": max_top_k,
             "memories_threshold": memories_threshold,
             "summaries_threshold": summaries_threshold,
+            "include_system_prompt": include_system_prompt,
         }
         if last_n_messages is not None:
             params["last_n_messages"] = last_n_messages

recallrai/user.py

@@ -8,6 +8,7 @@ from .utils import HTTPClient
 from .models import (
     UserModel, 
     SessionModel, 
+    SessionStatus,
     SessionList, 
     UserMemoriesList, 
     UserMessagesList,
@@ -244,6 +245,7 @@ class User:
         limit: int = 10,
         metadata_filter: Optional[Dict[str, Any]] = None,
         user_metadata_filter: Optional[Dict[str, Any]] = None,
+        status_filter: Optional[List[SessionStatus]] = None,
     ) -> SessionList:
         """
         List sessions for this user with pagination.
@@ -253,6 +255,7 @@ class User:
             limit: Maximum number of records to return.
             metadata_filter: Optional metadata filter for sessions.
             user_metadata_filter: Optional metadata filter for the user.
+            status_filter: Optional list of session statuses to filter by (e.g., ["pending", "processing", "processed", "insufficient_balance"]).
 
         Returns:
             List of sessions with pagination info.
@@ -270,6 +273,8 @@ class User:
             params["metadata_filter"] = json.dumps(metadata_filter)
         if user_metadata_filter is not None:
             params["user_metadata_filter"] = json.dumps(user_metadata_filter)
+        if status_filter is not None:
+            params["status_filter"] = [status.value for status in status_filter]
 
         response = self._http.get(
             f"/api/v1/users/{self.user_id}/sessions",

recallrai/utils/http_client.py

@@ -44,7 +44,7 @@ class HTTPClient:
                 "X-Recallr-Project-Id": self.project_id,
                 "Content-Type": "application/json",
                 "Accept": "application/json",
-                "User-Agent": f"RecallrAI-Python-SDK/0.3.1",
+                "User-Agent": f"RecallrAI-Python-SDK/0.3.2",
             },
         )
 
@@ -84,10 +84,10 @@ class HTTPClient:
                 json=data,
             )
             
-            # Try to parse to JSON to catch JSON errors early
-            _ = response.json()
+            if response.status_code == 204:
+                return response  # No content to parse
             
-            if response.status_code == 422:
+            elif response.status_code == 422:
                 detail = response.json().get("detail", "Validation error")
                 raise ValidationError(
                     message=detail,
@@ -106,6 +106,9 @@ class HTTPClient:
                     http_status=response.status_code
                 )
             
+            # Try to parse to JSON to catch JSON errors early
+            _ = response.json()
+            
             return response
         except TimeoutException as e:
             raise TimeoutError(

{recallrai-0.3.1.dist-info → recallrai-0.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: recallrai
-Version: 0.3.1
+Version: 0.3.2
 Summary: Official Python SDK for RecallrAI - Revolutionary contextual memory system that enables AI assistants to form meaningful connections between conversations, just like human memory.
 License: MIT
 Keywords: ai,memory,context,llm,mem0,getzep,zep
@@ -226,18 +226,20 @@ except SessionNotFoundError as e:
 ### List Sessions
 
 ```python
+from recallrai.models import SessionStatus
 from recallrai.exceptions import UserNotFoundError
 
 try:
     # First, get the user
     user = client.get_user("user123")
     
-    # List sessions for this user with optional metadata filters
+    # List sessions for this user with optional filters
     session_list = user.list_sessions(
         offset=0,
         limit=10,
-        metadata_filter={"type": "chat"},           # optional
-        user_metadata_filter={"role": "admin"}       # optional
+        metadata_filter={"type": "chat"},           # optional: filter by session metadata
+        user_metadata_filter={"role": "admin"},     # optional: filter by user metadata
+        status_filter=[SessionStatus.PENDING, SessionStatus.PROCESSING]     # optional: filter by session status
     )
     print(f"Total sessions: {session_list.total}")
     print(f"Has more sessions: {session_list.has_more}")
@@ -312,6 +314,7 @@ try:
     # - last_n_messages: Number of last messages to include in context (optional, range: 1-100)
     # - last_n_summaries: Number of last summaries to include in context (optional, range: 1-20)
     # - timezone: Timezone for formatting timestamps (optional, e.g., 'America/New_York', None for UTC)
+    # - include_system_prompt: Whether to include the default system prompt of Recallr AI (default: True)
 except UserNotFoundError as e:
     print(f"Error: {e}")
 except SessionNotFoundError as e:

{recallrai-0.3.1.dist-info → recallrai-0.3.2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-recallrai/__init__.py,sha256=Mc9ZKmUauWw65BA5d_qq7aHCY0Yyyq0UUyL-GUkkYdU,273
+recallrai/__init__.py,sha256=abFAtjWyJSZf16Z93jfgJcCSctbAEHE8i6PKjhrafe8,273
 recallrai/client.py,sha256=VNQ-AgmgQIdV5pOfvU7KptYC34jA_tGW1Kt3XnJoa-M,5230
 recallrai/exceptions/__init__.py,sha256=d1LiuofGiGOP8rmzpvUKinKaa_o1cn2JThGr__Hwysw,1209
 recallrai/exceptions/auth.py,sha256=mnxps1GLljuERxzqBZXg_LZqOYUbTM47GLaW9noiP3w,554
@@ -12,12 +12,12 @@ recallrai/exceptions/validation.py,sha256=O54apJf4pUsKXbo3A7I2nXV4J-BEk4txrAUNw8
 recallrai/merge_conflict.py,sha256=cEi2-0rOTKQXu61tt1p2LVItyA7l05TyvRw_mfCNIhI,7682
 recallrai/models/__init__.py,sha256=7M9q2BUDVyzCP7UNFmwo5Jzfni8fXibVPUCpiyQwG2w,1010
 recallrai/models/merge_conflict.py,sha256=H0yG-Tja01-vmBrI7mNXrARrgQVxF-LEE1YsB9voXJY,5337
-recallrai/models/session.py,sha256=xtNLoohWG5pmABf40y0zhU8Bo3guS8S6hbh4jFjI8AA,4782
+recallrai/models/session.py,sha256=bYh_4wipHENG8QXgkNHXd4XZHnN3EjCXoxFu15BDXZE,4832
 recallrai/models/user.py,sha256=8amkmBFAV0w2dkFBdp8Zx8nbuzQX3CkhEdpNIDBrqIY,6289
-recallrai/session.py,sha256=sL3StMzjDg9yf5wNf4gCifueUxUMpb36WGEbrFJJKXs,13422
-recallrai/user.py,sha256=_wCi3-RlNaVgDbwfLCiBFNlISPcVifbazw20iZgITWg,19060
+recallrai/session.py,sha256=FqSS9DhuuwDi_XMKFWvQdhXPV2DFtIZZ4Ws2f5gOljY,13639
+recallrai/user.py,sha256=IWLO_QvE9sy3iWeuZ2zOdVX_n0_JojV71rmZjcUmiPE,19405
 recallrai/utils/__init__.py,sha256=NWqn-HBC3Ahv_0E00-aHGDrTPN0RN1cXrvIxwvQLtZQ,108
-recallrai/utils/http_client.py,sha256=jvGVi6QMsK6ti5L6wGDCD_76-i6UdsSMtO58iH-h7aw,4474
-recallrai-0.3.1.dist-info/METADATA,sha256=_py2itinpzkS1mb1DPBcWZJNmYUC0vbSHNIeESCecU4,30262
-recallrai-0.3.1.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-recallrai-0.3.1.dist-info/RECORD,,
+recallrai/utils/http_client.py,sha256=_kK21uDTXzUcKSQMv1oAo12LGlo_ibLMaevnoi_o0sk,4588
+recallrai-0.3.2.dist-info/METADATA,sha256=6EUvhre9lS3d_Vm_mWdx8B3LMCtC-A5mBWlMYc5Z0HU,30567
+recallrai-0.3.2.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+recallrai-0.3.2.dist-info/RECORD,,