sovant 1.3.1__tar.gz → 1.3.2__tar.gz

{sovant-1.3.1/src/sovant.egg-info → sovant-1.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sovant
-Version: 1.3.1
+Version: 1.3.2
 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 → sovant-1.3.2}/README.md

@@ -235,6 +235,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 → sovant-1.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sovant"
-version = "1.3.1"
+version = "1.3.2"
 description = "Sovant Python SDK — governed AI memory layer for AI agents and applications"
 readme = "README.md"
 requires-python = ">=3.10"

{sovant-1.3.1 → sovant-1.3.2}/src/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.2"

{sovant-1.3.1 → sovant-1.3.2}/src/sovant/client.py

@@ -193,6 +193,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 → sovant-1.3.2/src/sovant.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sovant
-Version: 1.3.1
+Version: 1.3.2
 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