sovant 1.3.1__py3-none-any.whl → 1.3.3__py3-none-any.whl

sovant/__init__.py

@@ -1,4 +1,4 @@
 from .client import Sovant, SovantError
 from .models import MemoryCreate, MemoryResult, SearchQuery
 
-__version__ = "1.3.1"
+__version__ = "1.3.3"

sovant/client.py

@@ -5,6 +5,9 @@ import httpx
 from typing import Any, Dict, Optional, Callable
 from .models import MemoryCreate, SearchQuery
 
+# SDK version — used for X-Sovant-Client header
+SDK_VERSION = "1.3.3"
+
 class SovantError(Exception):
     def __init__(self, message: str, code: str, status: int | None = None, details: Any | None = None):
         super().__init__(message)
@@ -38,7 +41,8 @@ class Sovant:
             timeout=self.timeout,
             headers={
                 "authorization": f"Bearer {self.api_key}",
-                "content-type": "application/json"
+                "content-type": "application/json",
+                "x-sovant-client": f"python-sdk/{SDK_VERSION}"
             }
         )
 
@@ -193,6 +197,61 @@ class Sovant:
     def memory_delete(self, id: str):
         return self._request("DELETE", f"{self.base_url}/api/v1/memories/{id}")
 
+    def memory_list(
+        self,
+        limit: int | None = None,
+        offset: int | None = None,
+        thread_id: str | None = None,
+        type: str | None = None,
+        tags: list[str] | None = None,
+        is_pinned: bool | None = None,
+        is_archived: bool | None = None,
+        sort_by: str | None = None,
+        sort_order: str | None = None,
+    ):
+        """
+        List memories with filtering and pagination
+
+        Returns memories ordered by sort criteria (default: created_at desc).
+        Use list() to fetch recent memories or filter by criteria.
+        Use memory_search() for semantic/vector-based queries.
+        Use memory_recall() for conversational AI queries.
+
+        Args:
+            limit: Maximum memories to return (default: 20, max: 100)
+            offset: Number of memories to skip for pagination (default: 0)
+            thread_id: Filter by thread ID
+            type: Filter by memory type ('journal', 'insight', 'observation', 'task', 'preference')
+            tags: Filter by tags (memories must have all specified tags)
+            is_pinned: Filter by pinned status
+            is_archived: Filter by archived status
+            sort_by: Sort field ('created_at', 'updated_at', 'importance', 'type')
+            sort_order: Sort direction ('asc' or 'desc')
+
+        Returns:
+            Dict with 'memories', 'total', 'limit', 'offset', 'has_more'
+        """
+        params = {}
+        if limit is not None:
+            params['limit'] = str(limit)
+        if offset is not None:
+            params['offset'] = str(offset)
+        if thread_id:
+            params['thread_id'] = thread_id
+        if type:
+            params['type'] = type
+        if tags:
+            params['tags'] = ','.join(tags)
+        if is_pinned is not None:
+            params['is_pinned'] = str(is_pinned).lower()
+        if is_archived is not None:
+            params['is_archived'] = str(is_archived).lower()
+        if sort_by:
+            params['sort_by'] = sort_by
+        if sort_order:
+            params['sort_order'] = sort_order
+        return self._request("GET", f"{self.base_url}/api/v1/memory", params=params)
+
     def memory_create_batch(self, memories: list[Dict[str, Any]]):
         """
         Batch create multiple memories in a single request

{sovant-1.3.1.dist-info → sovant-1.3.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sovant
-Version: 1.3.1
+Version: 1.3.3
 Summary: Sovant Python SDK — governed AI memory layer for AI agents and applications
 Author: Sovant
 License-Expression: MIT
@@ -251,6 +251,42 @@ results = client.memory_create_batch([
 ])
 ```
 
+#### List Memories
+
+Fetch memories with filtering and pagination. Use `memory_list()` to retrieve recent memories or filter by criteria — it's more efficient than `memory_search()` when you don't need vector similarity.
+
+```python
+# List recent memories
+result = client.memory_list(limit=20, offset=0)
+for mem in result["memories"]:
+    print(mem["content"])
+
+# Filter by thread
+thread_mems = client.memory_list(thread_id="thread-uuid", limit=50)
+
+# Filter by type and tags
+prefs = client.memory_list(
+    type="preference",
+    tags=["settings"],
+    sort_by="updated_at",
+    sort_order="desc",
+)
+
+# Pinned memories only
+pinned = client.memory_list(is_pinned=True)
+```
+
+**Available parameters:**
+- `limit` — max results (default: 20, max: 100)
+- `offset` — pagination offset
+- `thread_id` — filter by thread
+- `type` — filter by memory type
+- `tags` — filter by tags (must have all)
+- `is_pinned` — filter by pinned status
+- `is_archived` — filter by archived status
+- `sort_by` — `created_at`, `updated_at`, `importance`, or `type`
+- `sort_order` — `asc` or `desc`
+
 ### Thread Management
 
 ```python

{sovant-1.3.1.dist-info → sovant-1.3.3.dist-info}/RECORD

@@ -1,14 +1,14 @@
-sovant/__init__.py,sha256=t0XgMU44um_gJBNGkg8QnaEC1SXsIh56IF2TrdDgbuY,122
+sovant/__init__.py,sha256=3gd4GM34YftQwmaHd5OojDa2WskrgGABzr78RvRK49s,122
 sovant/base_client.py,sha256=Vmn6OGywGwLbH5cEeflSjVOFwn5iX_YdfTdUq9pWWxA,8778
-sovant/client.py,sha256=8VnTPSli1QgRky9PqUb9OAKdbMPTfXlGoUkmAYsFfCw,11804
+sovant/client.py,sha256=zl3rCfuOFxpvZIOmrwtwf4U-vjeKi7YbPF09kXrBuvs,14112
 sovant/exceptions.py,sha256=MQMSgk7ckXnAbe7hPPpbKOnRBHSPxuCY7WSjqfJAvd0,1557
 sovant/models.py,sha256=avDAITMptDDdDfNH_ed854Q7kF6z_1OzjwJ9Xeft_-8,979
 sovant/types.py,sha256=gnvdXksJt8LObti7nc6eHSBCB7Pz7SNpS5o_HRTq_kA,6098
 sovant/resources/__init__.py,sha256=cPFIM7h8duviDdeHudnVEAmv3F89RHQxdH5BCRWFteQ,193
 sovant/resources/memories.py,sha256=bKKE0uWqFkPa1OEvbK1LrdSD7v6N04RhJ_2VDoPPQBA,11379
 sovant/resources/threads.py,sha256=mN29xP0JODmZBKyfhpeqJyViUWNVMAx3TlYAW-1ruTs,12558
-sovant-1.3.1.dist-info/licenses/LICENSE,sha256=rnNP6-elrMIlQ9jf2aqnHZMyyQ_wvF3y1hTpVUusCWU,1062
-sovant-1.3.1.dist-info/METADATA,sha256=ej271WYl3oSvAlmWRCVIjr_ebFSkgzw4-C3NVCOm01k,9515
-sovant-1.3.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-sovant-1.3.1.dist-info/top_level.txt,sha256=za6eVEsYd_ZQQs8vrmEWNcAR58r1wCDge_jA60e4CvQ,7
-sovant-1.3.1.dist-info/RECORD,,
+sovant-1.3.3.dist-info/licenses/LICENSE,sha256=rnNP6-elrMIlQ9jf2aqnHZMyyQ_wvF3y1hTpVUusCWU,1062
+sovant-1.3.3.dist-info/METADATA,sha256=s_57kPXW1hivUFm30aA81MurmKYoBJgkCPMqc8BcUqk,10604
+sovant-1.3.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+sovant-1.3.3.dist-info/top_level.txt,sha256=za6eVEsYd_ZQQs8vrmEWNcAR58r1wCDge_jA60e4CvQ,7
+sovant-1.3.3.dist-info/RECORD,,