feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 26
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-eef92a68d48cbd0da30cae650e608f5114a52305f81c4deea56ef42e4a0ec05b.yml
-openapi_spec_hash: 5b9e4ea9387648b156fdcfea9651ff58
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-99fe2a928c370e4958b4402331420035181618e4d0203cbf5048d197923e583e.yml
+openapi_spec_hash: 44279226783fee110b5fee1017d8edec
 config_hash: a69d5c502ffbfb11a2c8ec61ca5823e9

src/supermemory/resources/search.py

@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+from typing_extensions import Literal
+
 import httpx
 
 from ..types import search_execute_params, search_memories_params, search_documents_params
@@ -249,6 +251,7 @@ def memories(
         limit: int | Omit = omit,
         rerank: bool | Omit = omit,
         rewrite_query: bool | Omit = omit,
+        search_mode: Literal["memories", "hybrid"] | Omit = omit,
         threshold: float | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -276,6 +279,10 @@ def memories(
           rewrite_query: If true, rewrites the query to make it easier to find documents. This increases
               the latency by about 400ms
 
+          search_mode: Search mode. 'memories' searches only memory entries (default). 'hybrid'
+              searches memories first, then falls back to document chunks if no memories are
+              found.
+
           threshold: Threshold / sensitivity for memories selection. 0 is least sensitive (returns
               most memories, more results), 1 is most sensitive (returns lesser memories,
               accurate results)
@@ -299,6 +306,7 @@ def memories(
                     "limit": limit,
                     "rerank": rerank,
                     "rewrite_query": rewrite_query,
+                    "search_mode": search_mode,
                     "threshold": threshold,
                 },
                 search_memories_params.SearchMemoriesParams,
@@ -536,6 +544,7 @@ async def memories(
         limit: int | Omit = omit,
         rerank: bool | Omit = omit,
         rewrite_query: bool | Omit = omit,
+        search_mode: Literal["memories", "hybrid"] | Omit = omit,
         threshold: float | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -563,6 +572,10 @@ async def memories(
           rewrite_query: If true, rewrites the query to make it easier to find documents. This increases
               the latency by about 400ms
 
+          search_mode: Search mode. 'memories' searches only memory entries (default). 'hybrid'
+              searches memories first, then falls back to document chunks if no memories are
+              found.
+
           threshold: Threshold / sensitivity for memories selection. 0 is least sensitive (returns
               most memories, more results), 1 is most sensitive (returns lesser memories,
               accurate results)
@@ -586,6 +599,7 @@ async def memories(
                     "limit": limit,
                     "rerank": rerank,
                     "rewrite_query": rewrite_query,
+                    "search_mode": search_mode,
                     "threshold": threshold,
                 },
                 search_memories_params.SearchMemoriesParams,

src/supermemory/types/search_memories_params.py

@@ -359,6 +359,13 @@ class SearchMemoriesParams(TypedDict, total=False):
     This increases the latency by about 400ms
     """
 
+    search_mode: Annotated[Literal["memories", "hybrid"], PropertyInfo(alias="searchMode")]
+    """Search mode.
+
+    'memories' searches only memory entries (default). 'hybrid' searches memories
+    first, then falls back to document chunks if no memories are found.
+    """
+
     threshold: float
     """Threshold / sensitivity for memories selection.
 

src/supermemory/types/search_memories_response.py

@@ -105,10 +105,7 @@ class ResultDocument(BaseModel):
 
 class Result(BaseModel):
     id: str
-    """Memory entry ID"""
-
-    memory: str
-    """The memory content"""
+    """Memory entry ID or chunk ID"""
 
     metadata: Optional[Dict[str, object]] = None
     """Memory metadata"""
@@ -119,6 +116,9 @@ class Result(BaseModel):
     updated_at: str = FieldInfo(alias="updatedAt")
     """Memory last update date"""
 
+    chunk: Optional[str] = None
+    """The chunk content (only present for chunk results from hybrid search)"""
+
     chunks: Optional[List[ResultChunk]] = None
     """Relevant chunks from associated documents (only included when chunks=true)"""
 
@@ -128,13 +128,21 @@ class Result(BaseModel):
     documents: Optional[List[ResultDocument]] = None
     """Associated documents for this memory entry"""
 
+    memory: Optional[str] = None
+    """The memory content (only present for memory results)"""
+
     version: Optional[float] = None
     """Version number of this memory entry"""
 
 
 class SearchMemoriesResponse(BaseModel):
     results: List[Result]
-    """Array of matching memory entries with similarity scores"""
+    """Array of matching memory entries and chunks with similarity scores.
+
+    Contains memory results when searchMode='memories', or both memory and chunk
+    results when searchMode='hybrid'. Memory results have 'memory' field, chunk
+    results have 'chunk' field.
+    """
 
     timing: float
     """Search execution time in milliseconds"""

tests/api_resources/test_search.py

@@ -187,6 +187,7 @@ def test_method_memories_with_all_params(self, client: Supermemory) -> None:
             limit=10,
             rerank=False,
             rewrite_query=False,
+            search_mode="memories",
             threshold=0.5,
         )
         assert_matches_type(SearchMemoriesResponse, search, path=["response"])
@@ -389,6 +390,7 @@ async def test_method_memories_with_all_params(self, async_client: AsyncSupermem
             limit=10,
             rerank=False,
             rewrite_query=False,
+            search_mode="memories",
             threshold=0.5,
         )
         assert_matches_type(SearchMemoriesResponse, search, path=["response"])