feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 19
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-ebd5e757d0e76cb83013e01a1e0bb3dba62beb83b2a2ffa28d148ea032e96fd0.yml
-openapi_spec_hash: f930474a6ad230545154244045cc602e
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-8f3109ed6b4537d66c1d430e552cb6d90323c2b495487132f5c5fc7fb0f91478.yml
+openapi_spec_hash: e2f06a2c0e73fb52262924ecd4027a6c
 config_hash: ec08a36e60458b4d83e71798a8043484

src/supermemory/types/search_memories_params.py

@@ -61,6 +61,12 @@ class FiltersAnd(TypedDict, total=False):
 
 
 class Include(TypedDict, total=False):
+    chunks: bool
+    """
+    If true, fetch and return chunks from documents associated with the found
+    memories. Performs vector search on chunks within those documents.
+    """
+
     documents: bool
 
     forgotten_memories: Annotated[bool, PropertyInfo(alias="forgottenMemories")]

src/supermemory/types/search_memories_response.py

@@ -10,13 +10,28 @@
 __all__ = [
     "SearchMemoriesResponse",
     "Result",
+    "ResultChunk",
     "ResultContext",
     "ResultContextChild",
     "ResultContextParent",
     "ResultDocument",
 ]
 
 
+class ResultChunk(BaseModel):
+    content: str
+    """Content of the chunk"""
+
+    document_id: str = FieldInfo(alias="documentId")
+    """ID of the document this chunk belongs to"""
+
+    position: float
+    """Position of chunk in the document (0-indexed)"""
+
+    score: float
+    """Similarity score between the query and chunk"""
+
+
 class ResultContextChild(BaseModel):
     memory: str
     """The contextual memory content"""
@@ -102,6 +117,9 @@ class Result(BaseModel):
     updated_at: str = FieldInfo(alias="updatedAt")
     """Memory last update date"""
 
+    chunks: Optional[List[ResultChunk]] = None
+    """Relevant chunks from associated documents (only included when chunks=true)"""
+
     context: Optional[ResultContext] = None
     """Object containing arrays of parent and child contextual memories"""
 

tests/api_resources/test_search.py

@@ -145,6 +145,7 @@ def test_method_memories_with_all_params(self, client: Supermemory) -> None:
             container_tag="user_123",
             filters={"or_": [{}]},
             include={
+                "chunks": False,
                 "documents": True,
                 "forgotten_memories": False,
                 "related_memories": True,
@@ -313,6 +314,7 @@ async def test_method_memories_with_all_params(self, async_client: AsyncSupermem
             container_tag="user_123",
             filters={"or_": [{}]},
             include={
+                "chunks": False,
                 "documents": True,
                 "forgotten_memories": False,
                 "related_memories": True,