feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 18
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-d52acd1a525b4bfe9f4befcc3a645f5d1289d75e7bad999cf1330e539b2ed84e.yml
 openapi_spec_hash: c34df5406cfa4d245812d30f99d28116
-config_hash: f305e457fd9ddd1dec2614b14d7936a5
+config_hash: 9b9291a6c872b063900a46386729ba3c

api.md

@@ -26,12 +26,13 @@ Methods:
 Types:
 
 ```python
-from supermemory.types import SearchDocumentsResponse, SearchMemoriesResponse
+from supermemory.types import SearchDocumentsResponse, SearchExecuteResponse, SearchMemoriesResponse
 ```
 
 Methods:
 
 - <code title="post /v3/search">client.search.<a href="./src/supermemory/resources/search.py">documents</a>(\*\*<a href="src/supermemory/types/search_documents_params.py">params</a>) -> <a href="./src/supermemory/types/search_documents_response.py">SearchDocumentsResponse</a></code>
+- <code title="post /v3/search">client.search.<a href="./src/supermemory/resources/search.py">execute</a>(\*\*<a href="src/supermemory/types/search_execute_params.py">params</a>) -> <a href="./src/supermemory/types/search_execute_response.py">SearchExecuteResponse</a></code>
 - <code title="post /v4/search">client.search.<a href="./src/supermemory/resources/search.py">memories</a>(\*\*<a href="src/supermemory/types/search_memories_params.py">params</a>) -> <a href="./src/supermemory/types/search_memories_response.py">SearchMemoriesResponse</a></code>
 
 # Settings

src/supermemory/resources/search.py

@@ -7,7 +7,7 @@
 
 import httpx
 
-from ..types import search_memories_params, search_documents_params
+from ..types import search_execute_params, search_memories_params, search_documents_params
 from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
 from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
@@ -19,6 +19,7 @@
     async_to_streamed_response_wrapper,
 )
 from .._base_client import make_request_options
+from ..types.search_execute_response import SearchExecuteResponse
 from ..types.search_memories_response import SearchMemoriesResponse
 from ..types.search_documents_response import SearchDocumentsResponse
 
@@ -144,6 +145,105 @@ def documents(
             cast_to=SearchDocumentsResponse,
         )
 
+    def execute(
+        self,
+        *,
+        q: str,
+        categories_filter: List[Literal["technology", "science", "business", "health"]] | NotGiven = NOT_GIVEN,
+        chunk_threshold: float | NotGiven = NOT_GIVEN,
+        container_tags: List[str] | NotGiven = NOT_GIVEN,
+        doc_id: str | NotGiven = NOT_GIVEN,
+        document_threshold: float | NotGiven = NOT_GIVEN,
+        filters: search_execute_params.Filters | NotGiven = NOT_GIVEN,
+        include_full_docs: bool | NotGiven = NOT_GIVEN,
+        include_summary: bool | NotGiven = NOT_GIVEN,
+        limit: int | NotGiven = NOT_GIVEN,
+        only_matching_chunks: bool | NotGiven = NOT_GIVEN,
+        rerank: bool | NotGiven = NOT_GIVEN,
+        rewrite_query: bool | NotGiven = NOT_GIVEN,
+        # 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.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> SearchExecuteResponse:
+        """
+        Search memories with advanced filtering
+
+        Args:
+          q: Search query string
+
+          categories_filter: Optional category filters
+
+          chunk_threshold: Threshold / sensitivity for chunk selection. 0 is least sensitive (returns most
+              chunks, more results), 1 is most sensitive (returns lesser chunks, accurate
+              results)
+
+          container_tags: Optional tags this search should be containerized by. This can be an ID for your
+              user, a project ID, or any other identifier you wish to use to filter memories.
+
+          doc_id: Optional document ID to search within. You can use this to find chunks in a very
+              large document.
+
+          document_threshold: Threshold / sensitivity for document selection. 0 is least sensitive (returns
+              most documents, more results), 1 is most sensitive (returns lesser documents,
+              accurate results)
+
+          filters: Optional filters to apply to the search
+
+          include_full_docs: If true, include full document in the response. This is helpful if you want a
+              chatbot to know the full context of the document.
+
+          include_summary: If true, include document summary in the response. This is helpful if you want a
+              chatbot to know the full context of the document.
+
+          limit: Maximum number of results to return
+
+          only_matching_chunks: If true, only return matching chunks without context. Normally, we send the
+              previous and next chunk to provide more context for LLMs. If you only want the
+              matching chunk, set this to true.
+
+          rerank: If true, rerank the results based on the query. This is helpful if you want to
+              ensure the most relevant results are returned.
+
+          rewrite_query: If true, rewrites the query to make it easier to find documents. This increases
+              the latency by about 400ms
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._post(
+            "/v3/search",
+            body=maybe_transform(
+                {
+                    "q": q,
+                    "categories_filter": categories_filter,
+                    "chunk_threshold": chunk_threshold,
+                    "container_tags": container_tags,
+                    "doc_id": doc_id,
+                    "document_threshold": document_threshold,
+                    "filters": filters,
+                    "include_full_docs": include_full_docs,
+                    "include_summary": include_summary,
+                    "limit": limit,
+                    "only_matching_chunks": only_matching_chunks,
+                    "rerank": rerank,
+                    "rewrite_query": rewrite_query,
+                },
+                search_execute_params.SearchExecuteParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=SearchExecuteResponse,
+        )
+
     def memories(
         self,
         *,
@@ -334,6 +434,105 @@ async def documents(
             cast_to=SearchDocumentsResponse,
         )
 
+    async def execute(
+        self,
+        *,
+        q: str,
+        categories_filter: List[Literal["technology", "science", "business", "health"]] | NotGiven = NOT_GIVEN,
+        chunk_threshold: float | NotGiven = NOT_GIVEN,
+        container_tags: List[str] | NotGiven = NOT_GIVEN,
+        doc_id: str | NotGiven = NOT_GIVEN,
+        document_threshold: float | NotGiven = NOT_GIVEN,
+        filters: search_execute_params.Filters | NotGiven = NOT_GIVEN,
+        include_full_docs: bool | NotGiven = NOT_GIVEN,
+        include_summary: bool | NotGiven = NOT_GIVEN,
+        limit: int | NotGiven = NOT_GIVEN,
+        only_matching_chunks: bool | NotGiven = NOT_GIVEN,
+        rerank: bool | NotGiven = NOT_GIVEN,
+        rewrite_query: bool | NotGiven = NOT_GIVEN,
+        # 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.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> SearchExecuteResponse:
+        """
+        Search memories with advanced filtering
+
+        Args:
+          q: Search query string
+
+          categories_filter: Optional category filters
+
+          chunk_threshold: Threshold / sensitivity for chunk selection. 0 is least sensitive (returns most
+              chunks, more results), 1 is most sensitive (returns lesser chunks, accurate
+              results)
+
+          container_tags: Optional tags this search should be containerized by. This can be an ID for your
+              user, a project ID, or any other identifier you wish to use to filter memories.
+
+          doc_id: Optional document ID to search within. You can use this to find chunks in a very
+              large document.
+
+          document_threshold: Threshold / sensitivity for document selection. 0 is least sensitive (returns
+              most documents, more results), 1 is most sensitive (returns lesser documents,
+              accurate results)
+
+          filters: Optional filters to apply to the search
+
+          include_full_docs: If true, include full document in the response. This is helpful if you want a
+              chatbot to know the full context of the document.
+
+          include_summary: If true, include document summary in the response. This is helpful if you want a
+              chatbot to know the full context of the document.
+
+          limit: Maximum number of results to return
+
+          only_matching_chunks: If true, only return matching chunks without context. Normally, we send the
+              previous and next chunk to provide more context for LLMs. If you only want the
+              matching chunk, set this to true.
+
+          rerank: If true, rerank the results based on the query. This is helpful if you want to
+              ensure the most relevant results are returned.
+
+          rewrite_query: If true, rewrites the query to make it easier to find documents. This increases
+              the latency by about 400ms
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._post(
+            "/v3/search",
+            body=await async_maybe_transform(
+                {
+                    "q": q,
+                    "categories_filter": categories_filter,
+                    "chunk_threshold": chunk_threshold,
+                    "container_tags": container_tags,
+                    "doc_id": doc_id,
+                    "document_threshold": document_threshold,
+                    "filters": filters,
+                    "include_full_docs": include_full_docs,
+                    "include_summary": include_summary,
+                    "limit": limit,
+                    "only_matching_chunks": only_matching_chunks,
+                    "rerank": rerank,
+                    "rewrite_query": rewrite_query,
+                },
+                search_execute_params.SearchExecuteParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=SearchExecuteResponse,
+        )
+
     async def memories(
         self,
         *,
@@ -412,6 +611,9 @@ def __init__(self, search: SearchResource) -> None:
         self.documents = to_raw_response_wrapper(
             search.documents,
         )
+        self.execute = to_raw_response_wrapper(
+            search.execute,
+        )
         self.memories = to_raw_response_wrapper(
             search.memories,
         )
@@ -424,6 +626,9 @@ def __init__(self, search: AsyncSearchResource) -> None:
         self.documents = async_to_raw_response_wrapper(
             search.documents,
         )
+        self.execute = async_to_raw_response_wrapper(
+            search.execute,
+        )
         self.memories = async_to_raw_response_wrapper(
             search.memories,
         )
@@ -436,6 +641,9 @@ def __init__(self, search: SearchResource) -> None:
         self.documents = to_streamed_response_wrapper(
             search.documents,
         )
+        self.execute = to_streamed_response_wrapper(
+            search.execute,
+        )
         self.memories = to_streamed_response_wrapper(
             search.memories,
         )
@@ -448,6 +656,9 @@ def __init__(self, search: AsyncSearchResource) -> None:
         self.documents = async_to_streamed_response_wrapper(
             search.documents,
         )
+        self.execute = async_to_streamed_response_wrapper(
+            search.execute,
+        )
         self.memories = async_to_streamed_response_wrapper(
             search.memories,
         )

src/supermemory/types/__init__.py

@@ -9,11 +9,13 @@
 from .memory_list_response import MemoryListResponse as MemoryListResponse
 from .memory_update_params import MemoryUpdateParams as MemoryUpdateParams
 from .setting_get_response import SettingGetResponse as SettingGetResponse
+from .search_execute_params import SearchExecuteParams as SearchExecuteParams
 from .setting_update_params import SettingUpdateParams as SettingUpdateParams
 from .connection_list_params import ConnectionListParams as ConnectionListParams
 from .memory_update_response import MemoryUpdateResponse as MemoryUpdateResponse
 from .search_memories_params import SearchMemoriesParams as SearchMemoriesParams
 from .search_documents_params import SearchDocumentsParams as SearchDocumentsParams
+from .search_execute_response import SearchExecuteResponse as SearchExecuteResponse
 from .setting_update_response import SettingUpdateResponse as SettingUpdateResponse
 from .connection_create_params import ConnectionCreateParams as ConnectionCreateParams
 from .connection_import_params import ConnectionImportParams as ConnectionImportParams

src/supermemory/types/search_execute_params.py

@@ -0,0 +1,93 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, List, Union, Iterable
+from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["SearchExecuteParams", "Filters", "FiltersUnionMember0"]
+
+
+class SearchExecuteParams(TypedDict, total=False):
+    q: Required[str]
+    """Search query string"""
+
+    categories_filter: Annotated[
+        List[Literal["technology", "science", "business", "health"]], PropertyInfo(alias="categoriesFilter")
+    ]
+    """Optional category filters"""
+
+    chunk_threshold: Annotated[float, PropertyInfo(alias="chunkThreshold")]
+    """Threshold / sensitivity for chunk selection.
+
+    0 is least sensitive (returns most chunks, more results), 1 is most sensitive
+    (returns lesser chunks, accurate results)
+    """
+
+    container_tags: Annotated[List[str], PropertyInfo(alias="containerTags")]
+    """Optional tags this search should be containerized by.
+
+    This can be an ID for your user, a project ID, or any other identifier you wish
+    to use to filter memories.
+    """
+
+    doc_id: Annotated[str, PropertyInfo(alias="docId")]
+    """Optional document ID to search within.
+
+    You can use this to find chunks in a very large document.
+    """
+
+    document_threshold: Annotated[float, PropertyInfo(alias="documentThreshold")]
+    """Threshold / sensitivity for document selection.
+
+    0 is least sensitive (returns most documents, more results), 1 is most sensitive
+    (returns lesser documents, accurate results)
+    """
+
+    filters: Filters
+    """Optional filters to apply to the search"""
+
+    include_full_docs: Annotated[bool, PropertyInfo(alias="includeFullDocs")]
+    """If true, include full document in the response.
+
+    This is helpful if you want a chatbot to know the full context of the document.
+    """
+
+    include_summary: Annotated[bool, PropertyInfo(alias="includeSummary")]
+    """If true, include document summary in the response.
+
+    This is helpful if you want a chatbot to know the full context of the document.
+    """
+
+    limit: int
+    """Maximum number of results to return"""
+
+    only_matching_chunks: Annotated[bool, PropertyInfo(alias="onlyMatchingChunks")]
+    """If true, only return matching chunks without context.
+
+    Normally, we send the previous and next chunk to provide more context for LLMs.
+    If you only want the matching chunk, set this to true.
+    """
+
+    rerank: bool
+    """If true, rerank the results based on the query.
+
+    This is helpful if you want to ensure the most relevant results are returned.
+    """
+
+    rewrite_query: Annotated[bool, PropertyInfo(alias="rewriteQuery")]
+    """If true, rewrites the query to make it easier to find documents.
+
+    This increases the latency by about 400ms
+    """
+
+
+class FiltersUnionMember0(TypedDict, total=False):
+    and_: Annotated[Iterable[object], PropertyInfo(alias="AND")]
+
+    or_: Annotated[Iterable[object], PropertyInfo(alias="OR")]
+
+
+Filters: TypeAlias = Union[FiltersUnionMember0, Dict[str, object]]