feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

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

README.md

@@ -31,10 +31,12 @@ client = Supermemory(
     api_key=os.environ.get("SUPERMEMORY_API_KEY"),  # This is the default and can be omitted
 )
 
-memories = client.memories.list(
-    "id",
+memory = client.memories.update(
+    path_id="id",
+    body_id="acxV5LHMEsG2hMSNb4umbn",
+    content="This is a detailed article about machine learning concepts...",
 )
-print(memories.success)
+print(memory.id)
 ```
 
 While you can provide an `api_key` keyword argument,
@@ -57,10 +59,12 @@ client = AsyncSupermemory(
 
 
 async def main() -> None:
-    memories = await client.memories.list(
-        "id",
+    memory = await client.memories.update(
+        path_id="id",
+        body_id="acxV5LHMEsG2hMSNb4umbn",
+        content="This is a detailed article about machine learning concepts...",
     )
-    print(memories.success)
+    print(memory.id)
 
 
 asyncio.run(main())
@@ -93,8 +97,10 @@ from supermemory import Supermemory
 client = Supermemory()
 
 try:
-    client.memories.list(
-        "id",
+    client.memories.update(
+        path_id="id",
+        body_id="acxV5LHMEsG2hMSNb4umbn",
+        content="This is a detailed article about machine learning concepts...",
     )
 except supermemory.APIConnectionError as e:
     print("The server could not be reached")
@@ -138,8 +144,10 @@ client = Supermemory(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).memories.list(
-    "id",
+client.with_options(max_retries=5).memories.update(
+    path_id="id",
+    body_id="acxV5LHMEsG2hMSNb4umbn",
+    content="This is a detailed article about machine learning concepts...",
 )
 ```
 
@@ -163,8 +171,10 @@ client = Supermemory(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).memories.list(
-    "id",
+client.with_options(timeout=5.0).memories.update(
+    path_id="id",
+    body_id="acxV5LHMEsG2hMSNb4umbn",
+    content="This is a detailed article about machine learning concepts...",
 )
 ```
 
@@ -206,13 +216,15 @@ 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.list(
-    "id",
+response = client.memories.with_raw_response.update(
+    path_id="id",
+    body_id="acxV5LHMEsG2hMSNb4umbn",
+    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.list()` would have returned
-print(memory.success)
+memory = response.parse()  # get the object that `memories.update()` would have returned
+print(memory.id)
 ```
 
 These methods return an [`APIResponse`](https://github.com/supermemoryai/python-sdk/tree/main/src/supermemory/_response.py) object.
@@ -226,8 +238,10 @@ 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.list(
-    "id",
+with client.memories.with_streaming_response.update(
+    path_id="id",
+    body_id="acxV5LHMEsG2hMSNb4umbn",
+    content="This is a detailed article about machine learning concepts...",
 ) as response:
     print(response.headers.get("X-My-Header"))
 

api.md

@@ -4,6 +4,7 @@ Types:
 
 ```python
 from supermemory.types import (
+    MemoryUpdateResponse,
     MemoryListResponse,
     MemoryDeleteResponse,
     MemoryAddResponse,
@@ -13,6 +14,7 @@ from supermemory.types import (
 
 Methods:
 
+- <code title="patch /v3/memories/{id}">client.memories.<a href="./src/supermemory/resources/memories.py">update</a>(path_id, \*\*<a href="src/supermemory/types/memory_update_params.py">params</a>) -> <a href="./src/supermemory/types/memory_update_response.py">MemoryUpdateResponse</a></code>
 - <code title="delete /v3/memories/{id}">client.memories.<a href="./src/supermemory/resources/memories.py">list</a>(id) -> <a href="./src/supermemory/types/memory_list_response.py">MemoryListResponse</a></code>
 - <code title="get /v3/memories/{id}">client.memories.<a href="./src/supermemory/resources/memories.py">delete</a>(id) -> <a href="./src/supermemory/types/memory_delete_response.py">MemoryDeleteResponse</a></code>
 - <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>

src/supermemory/resources/memories.py

@@ -6,7 +6,7 @@
 
 import httpx
 
-from ..types import memory_add_params
+from ..types import memory_add_params, memory_update_params
 from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
 from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
@@ -22,6 +22,7 @@
 from ..types.memory_get_response import MemoryGetResponse
 from ..types.memory_list_response import MemoryListResponse
 from ..types.memory_delete_response import MemoryDeleteResponse
+from ..types.memory_update_response import MemoryUpdateResponse
 
 __all__ = ["MemoriesResource", "AsyncMemoriesResource"]
 
@@ -46,6 +47,52 @@ def with_streaming_response(self) -> MemoriesResourceWithStreamingResponse:
         """
         return MemoriesResourceWithStreamingResponse(self)
 
+    def update(
+        self,
+        path_id: str,
+        *,
+        body_id: str,
+        content: str,
+        container_tags: List[str] | NotGiven = NOT_GIVEN,
+        metadata: Dict[str, Union[str, float, 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,
+    ) -> MemoryUpdateResponse:
+        """
+        Update a memory with any content type (text, url, file, etc.) and metadata
+
+        Args:
+          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
+        """
+        if not path_id:
+            raise ValueError(f"Expected a non-empty value for `path_id` but received {path_id!r}")
+        return self._patch(
+            f"/v3/memories/{path_id}",
+            body=maybe_transform(
+                {
+                    "body_id": body_id,
+                    "content": content,
+                    "container_tags": container_tags,
+                    "metadata": metadata,
+                },
+                memory_update_params.MemoryUpdateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=MemoryUpdateResponse,
+        )
+
     def list(
         self,
         id: str,
@@ -207,6 +254,52 @@ def with_streaming_response(self) -> AsyncMemoriesResourceWithStreamingResponse:
         """
         return AsyncMemoriesResourceWithStreamingResponse(self)
 
+    async def update(
+        self,
+        path_id: str,
+        *,
+        body_id: str,
+        content: str,
+        container_tags: List[str] | NotGiven = NOT_GIVEN,
+        metadata: Dict[str, Union[str, float, 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,
+    ) -> MemoryUpdateResponse:
+        """
+        Update a memory with any content type (text, url, file, etc.) and metadata
+
+        Args:
+          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
+        """
+        if not path_id:
+            raise ValueError(f"Expected a non-empty value for `path_id` but received {path_id!r}")
+        return await self._patch(
+            f"/v3/memories/{path_id}",
+            body=await async_maybe_transform(
+                {
+                    "body_id": body_id,
+                    "content": content,
+                    "container_tags": container_tags,
+                    "metadata": metadata,
+                },
+                memory_update_params.MemoryUpdateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=MemoryUpdateResponse,
+        )
+
     async def list(
         self,
         id: str,
@@ -352,6 +445,9 @@ class MemoriesResourceWithRawResponse:
     def __init__(self, memories: MemoriesResource) -> None:
         self._memories = memories
 
+        self.update = to_raw_response_wrapper(
+            memories.update,
+        )
         self.list = to_raw_response_wrapper(
             memories.list,
         )
@@ -370,6 +466,9 @@ class AsyncMemoriesResourceWithRawResponse:
     def __init__(self, memories: AsyncMemoriesResource) -> None:
         self._memories = memories
 
+        self.update = async_to_raw_response_wrapper(
+            memories.update,
+        )
         self.list = async_to_raw_response_wrapper(
             memories.list,
         )
@@ -388,6 +487,9 @@ class MemoriesResourceWithStreamingResponse:
     def __init__(self, memories: MemoriesResource) -> None:
         self._memories = memories
 
+        self.update = to_streamed_response_wrapper(
+            memories.update,
+        )
         self.list = to_streamed_response_wrapper(
             memories.list,
         )
@@ -406,6 +508,9 @@ class AsyncMemoriesResourceWithStreamingResponse:
     def __init__(self, memories: AsyncMemoriesResource) -> None:
         self._memories = memories
 
+        self.update = async_to_streamed_response_wrapper(
+            memories.update,
+        )
         self.list = async_to_streamed_response_wrapper(
             memories.list,
         )

src/supermemory/types/__init__.py

@@ -6,9 +6,11 @@
 from .memory_add_response import MemoryAddResponse as MemoryAddResponse
 from .memory_get_response import MemoryGetResponse as MemoryGetResponse
 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 .setting_update_params import SettingUpdateParams as SettingUpdateParams
 from .memory_delete_response import MemoryDeleteResponse as MemoryDeleteResponse
+from .memory_update_response import MemoryUpdateResponse as MemoryUpdateResponse
 from .connection_get_response import ConnectionGetResponse as ConnectionGetResponse
 from .setting_update_response import SettingUpdateResponse as SettingUpdateResponse
 from .connection_list_response import ConnectionListResponse as ConnectionListResponse

src/supermemory/types/connection_create_response.py

@@ -8,6 +8,8 @@
 
 
 class ConnectionCreateResponse(BaseModel):
-    expires_in: str = FieldInfo(alias="expiresIn")
+    id: str
+
+    auth_link: str = FieldInfo(alias="authLink")
 
-    magic_link: str = FieldInfo(alias="magicLink")
+    expires_in: str = FieldInfo(alias="expiresIn")

src/supermemory/types/memory_update_params.py

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, List, Union
+from typing_extensions import Required, Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["MemoryUpdateParams"]
+
+
+class MemoryUpdateParams(TypedDict, total=False):
+    body_id: Required[Annotated[str, PropertyInfo(alias="id")]]
+
+    content: Required[str]
+
+    container_tags: Annotated[List[str], PropertyInfo(alias="containerTags")]
+
+    metadata: Dict[str, Union[str, float, bool]]

src/supermemory/types/memory_update_response.py

@@ -0,0 +1,11 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .._models import BaseModel
+
+__all__ = ["MemoryUpdateResponse"]
+
+
+class MemoryUpdateResponse(BaseModel):
+    id: str
+
+    status: str