feat(api): api update

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-a75aed7778611ef91eff34326795cda9db48400c6be805428b81aa0fcb9ab0dc.yml
-openapi_spec_hash: 5d82339bc5339752f83f6155ec39e7c8
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-d3db80a2ee031274f023285c4ce7fe482d76ef850eac429bdef66c18da593ed8.yml
+openapi_spec_hash: 467b45efb291874fa8e76e80f492ec5e
 config_hash: 9b9291a6c872b063900a46386729ba3c

README.md

@@ -160,7 +160,9 @@ from supermemory import Supermemory
 client = Supermemory()
 
 try:
-    client.memories.add()
+    client.memories.add(
+        content="This is a detailed article about machine learning concepts...",
+    )
 except supermemory.APIConnectionError as e:
     print("The server could not be reached")
     print(e.__cause__)  # an underlying Exception, likely raised within httpx.
@@ -203,7 +205,9 @@ client = Supermemory(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).memories.add()
+client.with_options(max_retries=5).memories.add(
+    content="This is a detailed article about machine learning concepts...",
+)
 ```
 
 ### Timeouts
@@ -226,7 +230,9 @@ client = Supermemory(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).memories.add()
+client.with_options(timeout=5.0).memories.add(
+    content="This is a detailed article about machine learning concepts...",
+)
 ```
 
 On timeout, an `APITimeoutError` is thrown.
@@ -267,7 +273,9 @@ 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.add()
+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.add()` would have returned
@@ -285,7 +293,9 @@ 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.add() as response:
+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"))
 
     for line in response.iter_lines():

src/supermemory/resources/memories.py

@@ -223,9 +223,9 @@ def delete(
     def add(
         self,
         *,
+        content: str,
         container_tag: str | NotGiven = NOT_GIVEN,
         container_tags: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
-        content: str | NotGiven = NOT_GIVEN,
         custom_id: str | NotGiven = NOT_GIVEN,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -239,13 +239,6 @@ def add(
         Add a memory with any content type (text, url, file, etc.) and metadata
 
         Args:
-          container_tag: Optional tag this memory should be containerized by. This can be an ID for your
-              user, a project ID, or any other identifier you wish to use to group memories.
-
-          container_tags: (DEPRECATED: Use containerTag instead) Optional tags this memory should be
-              containerized by. This can be an ID for your user, a project ID, or any other
-              identifier you wish to use to group memories.
-
           content: The content to extract and process into a memory. This can be a URL to a
               website, a PDF, an image, or a video.
 
@@ -255,6 +248,13 @@ def add(
 
               We automatically detect the content type from the url's response format.
 
+          container_tag: Optional tag this memory should be containerized by. This can be an ID for your
+              user, a project ID, or any other identifier you wish to use to group memories.
+
+          container_tags: (DEPRECATED: Use containerTag instead) Optional tags this memory should be
+              containerized by. This can be an ID for your user, a project ID, or any other
+              identifier you wish to use to group memories.
+
           custom_id: Optional custom ID of the memory. This could be an ID from your database that
               will uniquely identify this memory.
 
@@ -276,9 +276,9 @@ def add(
             "/v3/memories",
             body=maybe_transform(
                 {
+                    "content": content,
                     "container_tag": container_tag,
                     "container_tags": container_tags,
-                    "content": content,
                     "custom_id": custom_id,
                     "metadata": metadata,
                 },
@@ -564,9 +564,9 @@ async def delete(
     async def add(
         self,
         *,
+        content: str,
         container_tag: str | NotGiven = NOT_GIVEN,
         container_tags: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
-        content: str | NotGiven = NOT_GIVEN,
         custom_id: str | NotGiven = NOT_GIVEN,
         metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -580,13 +580,6 @@ async def add(
         Add a memory with any content type (text, url, file, etc.) and metadata
 
         Args:
-          container_tag: Optional tag this memory should be containerized by. This can be an ID for your
-              user, a project ID, or any other identifier you wish to use to group memories.
-
-          container_tags: (DEPRECATED: Use containerTag instead) Optional tags this memory should be
-              containerized by. This can be an ID for your user, a project ID, or any other
-              identifier you wish to use to group memories.
-
           content: The content to extract and process into a memory. This can be a URL to a
               website, a PDF, an image, or a video.
 
@@ -596,6 +589,13 @@ async def add(
 
               We automatically detect the content type from the url's response format.
 
+          container_tag: Optional tag this memory should be containerized by. This can be an ID for your
+              user, a project ID, or any other identifier you wish to use to group memories.
+
+          container_tags: (DEPRECATED: Use containerTag instead) Optional tags this memory should be
+              containerized by. This can be an ID for your user, a project ID, or any other
+              identifier you wish to use to group memories.
+
           custom_id: Optional custom ID of the memory. This could be an ID from your database that
               will uniquely identify this memory.
 
@@ -617,9 +617,9 @@ async def add(
             "/v3/memories",
             body=await async_maybe_transform(
                 {
+                    "content": content,
                     "container_tag": container_tag,
                     "container_tags": container_tags,
-                    "content": content,
                     "custom_id": custom_id,
                     "metadata": metadata,
                 },

src/supermemory/types/memory_add_params.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from typing import Dict, Union
-from typing_extensions import Annotated, TypedDict
+from typing_extensions import Required, Annotated, TypedDict
 
 from .._types import SequenceNotStr
 from .._utils import PropertyInfo
@@ -12,6 +12,18 @@
 
 
 class MemoryAddParams(TypedDict, total=False):
+    content: Required[str]
+    """The content to extract and process into a memory.
+
+    This can be a URL to a website, a PDF, an image, or a video.
+
+    Plaintext: Any plaintext format
+
+    URL: A URL to a website, PDF, image, or video
+
+    We automatically detect the content type from the url's response format.
+    """
+
     container_tag: Annotated[str, PropertyInfo(alias="containerTag")]
     """Optional tag this memory should be containerized by.
 
@@ -26,18 +38,6 @@ class MemoryAddParams(TypedDict, total=False):
     identifier you wish to use to group memories.
     """
 
-    content: str
-    """The content to extract and process into a memory.
-
-    This can be a URL to a website, a PDF, an image, or a video.
-
-    Plaintext: Any plaintext format
-
-    URL: A URL to a website, PDF, image, or video
-
-    We automatically detect the content type from the url's response format.
-    """
-
     custom_id: Annotated[str, PropertyInfo(alias="customId")]
     """Optional custom ID of the memory.
 

tests/api_resources/test_memories.py

@@ -172,16 +172,18 @@ def test_path_params_delete(self, client: Supermemory) -> None:
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     def test_method_add(self, client: Supermemory) -> None:
-        memory = client.memories.add()
+        memory = client.memories.add(
+            content="This is a detailed article about machine learning concepts...",
+        )
         assert_matches_type(MemoryAddResponse, memory, path=["response"])
 
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     def test_method_add_with_all_params(self, client: Supermemory) -> None:
         memory = client.memories.add(
+            content="This is a detailed article about machine learning concepts...",
             container_tag="user_123",
             container_tags=["user_123", "project_123"],
-            content="This is a detailed article about machine learning concepts...",
             custom_id="mem_abc123",
             metadata={
                 "category": "technology",
@@ -197,7 +199,9 @@ def test_method_add_with_all_params(self, client: Supermemory) -> None:
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     def test_raw_response_add(self, client: Supermemory) -> None:
-        response = client.memories.with_raw_response.add()
+        response = client.memories.with_raw_response.add(
+            content="This is a detailed article about machine learning concepts...",
+        )
 
         assert response.is_closed is True
         assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -207,7 +211,9 @@ def test_raw_response_add(self, client: Supermemory) -> None:
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     def test_streaming_response_add(self, client: Supermemory) -> None:
-        with client.memories.with_streaming_response.add() as response:
+        with client.memories.with_streaming_response.add(
+            content="This is a detailed article about machine learning concepts...",
+        ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
 
@@ -456,16 +462,18 @@ async def test_path_params_delete(self, async_client: AsyncSupermemory) -> None:
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     async def test_method_add(self, async_client: AsyncSupermemory) -> None:
-        memory = await async_client.memories.add()
+        memory = await async_client.memories.add(
+            content="This is a detailed article about machine learning concepts...",
+        )
         assert_matches_type(MemoryAddResponse, memory, path=["response"])
 
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     async def test_method_add_with_all_params(self, async_client: AsyncSupermemory) -> None:
         memory = await async_client.memories.add(
+            content="This is a detailed article about machine learning concepts...",
             container_tag="user_123",
             container_tags=["user_123", "project_123"],
-            content="This is a detailed article about machine learning concepts...",
             custom_id="mem_abc123",
             metadata={
                 "category": "technology",
@@ -481,7 +489,9 @@ async def test_method_add_with_all_params(self, async_client: AsyncSupermemory)
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     async def test_raw_response_add(self, async_client: AsyncSupermemory) -> None:
-        response = await async_client.memories.with_raw_response.add()
+        response = await async_client.memories.with_raw_response.add(
+            content="This is a detailed article about machine learning concepts...",
+        )
 
         assert response.is_closed is True
         assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -491,7 +501,9 @@ async def test_raw_response_add(self, async_client: AsyncSupermemory) -> None:
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     async def test_streaming_response_add(self, async_client: AsyncSupermemory) -> None:
-        async with async_client.memories.with_streaming_response.add() as response:
+        async with async_client.memories.with_streaming_response.add(
+            content="This is a detailed article about machine learning concepts...",
+        ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"