feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 19
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-ebd5e757d0e76cb83013e01a1e0bb3dba62beb83b2a2ffa28d148ea032e96fd0.yml
 openapi_spec_hash: f930474a6ad230545154244045cc602e
-config_hash: 23f1770611dec274363355d52f3918cc
+config_hash: ec08a36e60458b4d83e71798a8043484

README.md

@@ -160,7 +160,7 @@ from supermemory import Supermemory
 client = Supermemory()
 
 try:
-    client.memories.add(
+    client.add(
         content="content",
     )
 except supermemory.APIConnectionError as e:
@@ -205,7 +205,7 @@ client = Supermemory(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).memories.add(
+client.with_options(max_retries=5).add(
     content="content",
 )
 ```
@@ -230,7 +230,7 @@ client = Supermemory(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).memories.add(
+client.with_options(timeout=5.0).add(
     content="content",
 )
 ```
@@ -273,13 +273,13 @@ 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.with_raw_response.add(
     content="content",
 )
 print(response.headers.get('X-My-Header'))
 
-memory = response.parse()  # get the object that `memories.add()` would have returned
-print(memory.id)
+client = response.parse()  # get the object that `add()` would have returned
+print(client.id)
 ```
 
 These methods return an [`APIResponse`](https://github.com/supermemoryai/python-sdk/tree/main/src/supermemory/_response.py) object.
@@ -293,7 +293,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.add(
+with client.with_streaming_response.add(
     content="content",
 ) as response:
     print(response.headers.get("X-My-Header"))

api.md

@@ -3,11 +3,12 @@
 Types:
 
 ```python
-from supermemory.types import ProfileResponse
+from supermemory.types import AddResponse, ProfileResponse
 ```
 
 Methods:
 
+- <code title="post /v3/documents">client.<a href="./src/supermemory/_client.py">add</a>(\*\*<a href="src/supermemory/types/client_add_params.py">params</a>) -> <a href="./src/supermemory/types/add_response.py">AddResponse</a></code>
 - <code title="post /v4/profile">client.<a href="./src/supermemory/_client.py">profile</a>(\*\*<a href="src/supermemory/types/client_profile_params.py">params</a>) -> <a href="./src/supermemory/types/profile_response.py">ProfileResponse</a></code>
 
 # Memories

src/supermemory/_client.py

@@ -3,14 +3,14 @@
 from __future__ import annotations
 
 import os
-from typing import Any, Mapping
+from typing import Any, Dict, Union, Mapping
 from typing_extensions import Self, override
 
 import httpx
 
 from . import _exceptions
 from ._qs import Querystring
-from .types import client_profile_params
+from .types import client_add_params, client_profile_params
 from ._types import (
     Body,
     Omit,
@@ -21,6 +21,7 @@
     Transport,
     ProxiesTypes,
     RequestOptions,
+    SequenceNotStr,
     omit,
     not_given,
 )
@@ -46,6 +47,7 @@
     AsyncAPIClient,
     make_request_options,
 )
+from .types.add_response import AddResponse
 from .types.profile_response import ProfileResponse
 
 __all__ = [
@@ -202,6 +204,62 @@ def copy(
     # client.with_options(timeout=10).foo.create(...)
     with_options = copy
 
+    def add(
+        self,
+        *,
+        content: str,
+        container_tag: str | Omit = omit,
+        container_tags: SequenceNotStr[str] | Omit = omit,
+        custom_id: str | Omit = omit,
+        metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | 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.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> AddResponse:
+        """
+        Add a document with any content type (text, url, file, etc.) and metadata
+
+        Args:
+          content: The content to extract and process into a document. This can be a URL to a
+              website, a PDF, an image, or a video.
+
+          container_tag: Optional tag this document should be containerized by. Max 100 characters,
+              alphanumeric with hyphens and underscores only.
+
+          custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
+              hyphens and underscores only.
+
+          metadata: Optional metadata for the document.
+
+          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/documents",
+            body=maybe_transform(
+                {
+                    "content": content,
+                    "container_tag": container_tag,
+                    "container_tags": container_tags,
+                    "custom_id": custom_id,
+                    "metadata": metadata,
+                },
+                client_add_params.ClientAddParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=AddResponse,
+        )
+
     def profile(
         self,
         *,
@@ -422,6 +480,62 @@ def copy(
     # client.with_options(timeout=10).foo.create(...)
     with_options = copy
 
+    async def add(
+        self,
+        *,
+        content: str,
+        container_tag: str | Omit = omit,
+        container_tags: SequenceNotStr[str] | Omit = omit,
+        custom_id: str | Omit = omit,
+        metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | 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.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> AddResponse:
+        """
+        Add a document with any content type (text, url, file, etc.) and metadata
+
+        Args:
+          content: The content to extract and process into a document. This can be a URL to a
+              website, a PDF, an image, or a video.
+
+          container_tag: Optional tag this document should be containerized by. Max 100 characters,
+              alphanumeric with hyphens and underscores only.
+
+          custom_id: Optional custom ID of the document. Max 100 characters, alphanumeric with
+              hyphens and underscores only.
+
+          metadata: Optional metadata for the document.
+
+          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/documents",
+            body=await async_maybe_transform(
+                {
+                    "content": content,
+                    "container_tag": container_tag,
+                    "container_tags": container_tags,
+                    "custom_id": custom_id,
+                    "metadata": metadata,
+                },
+                client_add_params.ClientAddParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=AddResponse,
+        )
+
     async def profile(
         self,
         *,
@@ -508,6 +622,9 @@ def __init__(self, client: Supermemory) -> None:
         self.settings = settings.SettingsResourceWithRawResponse(client.settings)
         self.connections = connections.ConnectionsResourceWithRawResponse(client.connections)
 
+        self.add = to_raw_response_wrapper(
+            client.add,
+        )
         self.profile = to_raw_response_wrapper(
             client.profile,
         )
@@ -521,6 +638,9 @@ def __init__(self, client: AsyncSupermemory) -> None:
         self.settings = settings.AsyncSettingsResourceWithRawResponse(client.settings)
         self.connections = connections.AsyncConnectionsResourceWithRawResponse(client.connections)
 
+        self.add = async_to_raw_response_wrapper(
+            client.add,
+        )
         self.profile = async_to_raw_response_wrapper(
             client.profile,
         )
@@ -534,6 +654,9 @@ def __init__(self, client: Supermemory) -> None:
         self.settings = settings.SettingsResourceWithStreamingResponse(client.settings)
         self.connections = connections.ConnectionsResourceWithStreamingResponse(client.connections)
 
+        self.add = to_streamed_response_wrapper(
+            client.add,
+        )
         self.profile = to_streamed_response_wrapper(
             client.profile,
         )
@@ -547,6 +670,9 @@ def __init__(self, client: AsyncSupermemory) -> None:
         self.settings = settings.AsyncSettingsResourceWithStreamingResponse(client.settings)
         self.connections = connections.AsyncConnectionsResourceWithStreamingResponse(client.connections)
 
+        self.add = async_to_streamed_response_wrapper(
+            client.add,
+        )
         self.profile = async_to_streamed_response_wrapper(
             client.profile,
         )

src/supermemory/types/__init__.py

@@ -2,7 +2,9 @@
 
 from __future__ import annotations
 
+from .add_response import AddResponse as AddResponse
 from .profile_response import ProfileResponse as ProfileResponse
+from .client_add_params import ClientAddParams as ClientAddParams
 from .memory_add_params import MemoryAddParams as MemoryAddParams
 from .memory_list_params import MemoryListParams as MemoryListParams
 from .document_add_params import DocumentAddParams as DocumentAddParams

src/supermemory/types/add_response.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .._models import BaseModel
+
+__all__ = ["AddResponse"]
+
+
+class AddResponse(BaseModel):
+    id: str
+    """Unique identifier of the document"""
+
+    status: str
+    """Status of the document"""

src/supermemory/types/client_add_params.py

@@ -0,0 +1,36 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, Union
+from typing_extensions import Required, Annotated, TypedDict
+
+from .._types import SequenceNotStr
+from .._utils import PropertyInfo
+
+__all__ = ["ClientAddParams"]
+
+
+class ClientAddParams(TypedDict, total=False):
+    content: Required[str]
+    """The content to extract and process into a document.
+
+    This can be a URL to a website, a PDF, an image, or a video.
+    """
+
+    container_tag: Annotated[str, PropertyInfo(alias="containerTag")]
+    """Optional tag this document should be containerized by.
+
+    Max 100 characters, alphanumeric with hyphens and underscores only.
+    """
+
+    container_tags: Annotated[SequenceNotStr[str], PropertyInfo(alias="containerTags")]
+
+    custom_id: Annotated[str, PropertyInfo(alias="customId")]
+    """Optional custom ID of the document.
+
+    Max 100 characters, alphanumeric with hyphens and underscores only.
+    """
+
+    metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]]
+    """Optional metadata for the document."""