feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 9
+configured_endpoints: 10
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-a280bf0a406a709c156d5e3fe7c8ae93ebe607d937af8d725d0a2997cab07a7d.yml
 openapi_spec_hash: 15c602571db9cbcce4703c929b994d82
-config_hash: b9c958a39a94966479e516e9061818be
+config_hash: 1c771b2d30afc18bf405a425ea1c327a

README.md

@@ -31,12 +31,10 @@ client = Supermemory(
     api_key=os.environ.get("SUPERMEMORY_API_KEY"),  # This is the default and can be omitted
 )
 
-memory = client.memories.update(
-    path_id="id",
-    body_id="acxV5LHMEsG2hMSNb4umbn",
-    content="This is a detailed article about machine learning concepts...",
+response = client.search.execute(
+    q="documents related to python",
 )
-print(memory.id)
+print(response.results)
 ```
 
 While you can provide an `api_key` keyword argument,
@@ -59,12 +57,10 @@ client = AsyncSupermemory(
 
 
 async def main() -> None:
-    memory = await client.memories.update(
-        path_id="id",
-        body_id="acxV5LHMEsG2hMSNb4umbn",
-        content="This is a detailed article about machine learning concepts...",
+    response = await client.search.execute(
+        q="documents related to python",
     )
-    print(memory.id)
+    print(response.results)
 
 
 asyncio.run(main())
@@ -97,9 +93,7 @@ from supermemory import Supermemory
 client = Supermemory()
 
 try:
-    client.memories.update(
-        path_id="id",
-        body_id="acxV5LHMEsG2hMSNb4umbn",
+    client.memories.add(
         content="This is a detailed article about machine learning concepts...",
     )
 except supermemory.APIConnectionError as e:
@@ -144,9 +138,7 @@ client = Supermemory(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).memories.update(
-    path_id="id",
-    body_id="acxV5LHMEsG2hMSNb4umbn",
+client.with_options(max_retries=5).memories.add(
     content="This is a detailed article about machine learning concepts...",
 )
 ```
@@ -171,9 +163,7 @@ client = Supermemory(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).memories.update(
-    path_id="id",
-    body_id="acxV5LHMEsG2hMSNb4umbn",
+client.with_options(timeout=5.0).memories.add(
     content="This is a detailed article about machine learning concepts...",
 )
 ```
@@ -216,14 +206,12 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 from supermemory import Supermemory
 
 client = Supermemory()
-response = client.memories.with_raw_response.update(
-    path_id="id",
-    body_id="acxV5LHMEsG2hMSNb4umbn",
+response = client.memories.with_raw_response.add(
     content="This is a detailed article about machine learning concepts...",
 )
 print(response.headers.get('X-My-Header'))
 
-memory = response.parse()  # get the object that `memories.update()` would have returned
+memory = response.parse()  # get the object that `memories.add()` would have returned
 print(memory.id)
 ```
 
@@ -238,9 +226,7 @@ The above interface eagerly reads the full response body when you make the reque
 To stream the response body, use `.with_streaming_response` instead, which requires a context manager and only reads the response body once you call `.read()`, `.text()`, `.json()`, `.iter_bytes()`, `.iter_text()`, `.iter_lines()` or `.parse()`. In the async client, these are async methods.
 
 ```python
-with client.memories.with_streaming_response.update(
-    path_id="id",
-    body_id="acxV5LHMEsG2hMSNb4umbn",
+with client.memories.with_streaming_response.add(
     content="This is a detailed article about machine learning concepts...",
 ) as response:
     print(response.headers.get("X-My-Header"))

api.md

@@ -20,6 +20,18 @@ Methods:
 - <code title="post /v3/memories">client.memories.<a href="./src/supermemory/resources/memories.py">add</a>(\*\*<a href="src/supermemory/types/memory_add_params.py">params</a>) -> <a href="./src/supermemory/types/memory_add_response.py">MemoryAddResponse</a></code>
 - <code title="get /v3/memories/{id}">client.memories.<a href="./src/supermemory/resources/memories.py">get</a>(id) -> <a href="./src/supermemory/types/memory_get_response.py">MemoryGetResponse</a></code>
 
+# Search
+
+Types:
+
+```python
+from supermemory.types import SearchExecuteResponse
+```
+
+Methods:
+
+- <code title="get /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>
+
 # Settings
 
 Types:

src/supermemory/_client.py

@@ -21,7 +21,7 @@
 )
 from ._utils import is_given, get_async_library
 from ._version import __version__
-from .resources import memories, settings, connections
+from .resources import search, memories, settings, connections
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import APIStatusError, SupermemoryError
 from ._base_client import (
@@ -44,6 +44,7 @@
 
 class Supermemory(SyncAPIClient):
     memories: memories.MemoriesResource
+    search: search.SearchResource
     settings: settings.SettingsResource
     connections: connections.ConnectionsResource
     with_raw_response: SupermemoryWithRawResponse
@@ -104,6 +105,7 @@ def __init__(
         )
 
         self.memories = memories.MemoriesResource(self)
+        self.search = search.SearchResource(self)
         self.settings = settings.SettingsResource(self)
         self.connections = connections.ConnectionsResource(self)
         self.with_raw_response = SupermemoryWithRawResponse(self)
@@ -216,6 +218,7 @@ def _make_status_error(
 
 class AsyncSupermemory(AsyncAPIClient):
     memories: memories.AsyncMemoriesResource
+    search: search.AsyncSearchResource
     settings: settings.AsyncSettingsResource
     connections: connections.AsyncConnectionsResource
     with_raw_response: AsyncSupermemoryWithRawResponse
@@ -276,6 +279,7 @@ def __init__(
         )
 
         self.memories = memories.AsyncMemoriesResource(self)
+        self.search = search.AsyncSearchResource(self)
         self.settings = settings.AsyncSettingsResource(self)
         self.connections = connections.AsyncConnectionsResource(self)
         self.with_raw_response = AsyncSupermemoryWithRawResponse(self)
@@ -389,27 +393,31 @@ def _make_status_error(
 class SupermemoryWithRawResponse:
     def __init__(self, client: Supermemory) -> None:
         self.memories = memories.MemoriesResourceWithRawResponse(client.memories)
+        self.search = search.SearchResourceWithRawResponse(client.search)
         self.settings = settings.SettingsResourceWithRawResponse(client.settings)
         self.connections = connections.ConnectionsResourceWithRawResponse(client.connections)
 
 
 class AsyncSupermemoryWithRawResponse:
     def __init__(self, client: AsyncSupermemory) -> None:
         self.memories = memories.AsyncMemoriesResourceWithRawResponse(client.memories)
+        self.search = search.AsyncSearchResourceWithRawResponse(client.search)
         self.settings = settings.AsyncSettingsResourceWithRawResponse(client.settings)
         self.connections = connections.AsyncConnectionsResourceWithRawResponse(client.connections)
 
 
 class SupermemoryWithStreamedResponse:
     def __init__(self, client: Supermemory) -> None:
         self.memories = memories.MemoriesResourceWithStreamingResponse(client.memories)
+        self.search = search.SearchResourceWithStreamingResponse(client.search)
         self.settings = settings.SettingsResourceWithStreamingResponse(client.settings)
         self.connections = connections.ConnectionsResourceWithStreamingResponse(client.connections)
 
 
 class AsyncSupermemoryWithStreamedResponse:
     def __init__(self, client: AsyncSupermemory) -> None:
         self.memories = memories.AsyncMemoriesResourceWithStreamingResponse(client.memories)
+        self.search = search.AsyncSearchResourceWithStreamingResponse(client.search)
         self.settings = settings.AsyncSettingsResourceWithStreamingResponse(client.settings)
         self.connections = connections.AsyncConnectionsResourceWithStreamingResponse(client.connections)
 

src/supermemory/resources/__init__.py

@@ -1,5 +1,13 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+from .search import (
+    SearchResource,
+    AsyncSearchResource,
+    SearchResourceWithRawResponse,
+    AsyncSearchResourceWithRawResponse,
+    SearchResourceWithStreamingResponse,
+    AsyncSearchResourceWithStreamingResponse,
+)
 from .memories import (
     MemoriesResource,
     AsyncMemoriesResource,
@@ -32,6 +40,12 @@
     "AsyncMemoriesResourceWithRawResponse",
     "MemoriesResourceWithStreamingResponse",
     "AsyncMemoriesResourceWithStreamingResponse",
+    "SearchResource",
+    "AsyncSearchResource",
+    "SearchResourceWithRawResponse",
+    "AsyncSearchResourceWithRawResponse",
+    "SearchResourceWithStreamingResponse",
+    "AsyncSearchResourceWithStreamingResponse",
     "SettingsResource",
     "AsyncSettingsResource",
     "SettingsResourceWithRawResponse",