feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 12
+configured_endpoints: 18
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-f181eaeb22a42d197dbd9c45fa61bf9a9b78a91d3334fc0f841494dc73d1a203.yml
 openapi_spec_hash: bb8262ebcdea53979cf1cafbc2c68dc8
-config_hash: 9b9291a6c872b063900a46386729ba3c
+config_hash: 2737bce9823a13e0263c0fa2701821fa

README.md

@@ -127,6 +127,23 @@ response = client.search.memories(
 print(response.include)
 ```
 
+## File uploads
+
+Request parameters that correspond to file uploads can be passed as `bytes`, or a [`PathLike`](https://docs.python.org/3/library/os.html#os.PathLike) instance or a tuple of `(filename, contents, media type)`.
+
+```python
+from pathlib import Path
+from supermemory import Supermemory
+
+client = Supermemory()
+
+client.memories.upload_file(
+    file=Path("/path/to/file"),
+)
+```
+
+The async client uses the exact same interface. If you pass a [`PathLike`](https://docs.python.org/3/library/os.html#os.PathLike) instance, the file contents will be read asynchronously automatically.
+
 ## Handling errors
 
 When the library is unable to connect to the API (for example, due to network connection problems or a timeout), a subclass of `supermemory.APIConnectionError` is raised.
@@ -143,8 +160,8 @@ from supermemory import Supermemory
 client = Supermemory()
 
 try:
-    client.search.documents(
-        q="machine learning concepts",
+    client.memories.update(
+        id="id",
     )
 except supermemory.APIConnectionError as e:
     print("The server could not be reached")
@@ -188,8 +205,8 @@ client = Supermemory(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).search.documents(
-    q="machine learning concepts",
+client.with_options(max_retries=5).memories.update(
+    id="id",
 )
 ```
 
@@ -213,8 +230,8 @@ client = Supermemory(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).search.documents(
-    q="machine learning concepts",
+client.with_options(timeout=5.0).memories.update(
+    id="id",
 )
 ```
 
@@ -256,13 +273,13 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 from supermemory import Supermemory
 
 client = Supermemory()
-response = client.search.with_raw_response.documents(
-    q="machine learning concepts",
+response = client.memories.with_raw_response.update(
+    id="id",
 )
 print(response.headers.get('X-My-Header'))
 
-search = response.parse()  # get the object that `search.documents()` would have returned
-print(search.results)
+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.
@@ -276,8 +293,8 @@ 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.search.with_streaming_response.documents(
-    q="machine learning concepts",
+with client.memories.with_streaming_response.update(
+    id="id",
 ) as response:
     print(response.headers.get("X-My-Header"))
 

api.md

@@ -1,3 +1,49 @@
+# Memories
+
+Types:
+
+```python
+from supermemory.types import (
+    MemoryUpdateResponse,
+    MemoryListResponse,
+    MemoryAddResponse,
+    MemoryGetResponse,
+    MemoryUploadFileResponse,
+)
+```
+
+Methods:
+
+- <code title="patch /v3/documents/{id}">client.memories.<a href="./src/supermemory/resources/memories.py">update</a>(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="post /v3/documents/list">client.memories.<a href="./src/supermemory/resources/memories.py">list</a>(\*\*<a href="src/supermemory/types/memory_list_params.py">params</a>) -> <a href="./src/supermemory/types/memory_list_response.py">MemoryListResponse</a></code>
+- <code title="delete /v3/documents/{id}">client.memories.<a href="./src/supermemory/resources/memories.py">delete</a>(id) -> None</code>
+- <code title="post /v3/documents">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/documents/{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>
+- <code title="post /v3/documents/file">client.memories.<a href="./src/supermemory/resources/memories.py">upload_file</a>(\*\*<a href="src/supermemory/types/memory_upload_file_params.py">params</a>) -> <a href="./src/supermemory/types/memory_upload_file_response.py">MemoryUploadFileResponse</a></code>
+
+# Documents
+
+Types:
+
+```python
+from supermemory.types import (
+    DocumentUpdateResponse,
+    DocumentListResponse,
+    DocumentAddResponse,
+    DocumentGetResponse,
+    DocumentUploadFileResponse,
+)
+```
+
+Methods:
+
+- <code title="patch /v3/documents/{id}">client.documents.<a href="./src/supermemory/resources/documents.py">update</a>(id, \*\*<a href="src/supermemory/types/document_update_params.py">params</a>) -> <a href="./src/supermemory/types/document_update_response.py">DocumentUpdateResponse</a></code>
+- <code title="post /v3/documents/list">client.documents.<a href="./src/supermemory/resources/documents.py">list</a>(\*\*<a href="src/supermemory/types/document_list_params.py">params</a>) -> <a href="./src/supermemory/types/document_list_response.py">DocumentListResponse</a></code>
+- <code title="delete /v3/documents/{id}">client.documents.<a href="./src/supermemory/resources/documents.py">delete</a>(id) -> None</code>
+- <code title="post /v3/documents">client.documents.<a href="./src/supermemory/resources/documents.py">add</a>(\*\*<a href="src/supermemory/types/document_add_params.py">params</a>) -> <a href="./src/supermemory/types/document_add_response.py">DocumentAddResponse</a></code>
+- <code title="get /v3/documents/{id}">client.documents.<a href="./src/supermemory/resources/documents.py">get</a>(id) -> <a href="./src/supermemory/types/document_get_response.py">DocumentGetResponse</a></code>
+- <code title="post /v3/documents/file">client.documents.<a href="./src/supermemory/resources/documents.py">upload_file</a>(\*\*<a href="src/supermemory/types/document_upload_file_params.py">params</a>) -> <a href="./src/supermemory/types/document_upload_file_response.py">DocumentUploadFileResponse</a></code>
+
 # Search
 
 Types:

src/supermemory/_client.py

@@ -21,7 +21,7 @@
 )
 from ._utils import is_given, get_async_library
 from ._version import __version__
-from .resources import search, settings, connections
+from .resources import search, memories, settings, documents, connections
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import APIStatusError, SupermemoryError
 from ._base_client import (
@@ -43,6 +43,8 @@
 
 
 class Supermemory(SyncAPIClient):
+    memories: memories.MemoriesResource
+    documents: documents.DocumentsResource
     search: search.SearchResource
     settings: settings.SettingsResource
     connections: connections.ConnectionsResource
@@ -103,6 +105,8 @@ def __init__(
             _strict_response_validation=_strict_response_validation,
         )
 
+        self.memories = memories.MemoriesResource(self)
+        self.documents = documents.DocumentsResource(self)
         self.search = search.SearchResource(self)
         self.settings = settings.SettingsResource(self)
         self.connections = connections.ConnectionsResource(self)
@@ -215,6 +219,8 @@ def _make_status_error(
 
 
 class AsyncSupermemory(AsyncAPIClient):
+    memories: memories.AsyncMemoriesResource
+    documents: documents.AsyncDocumentsResource
     search: search.AsyncSearchResource
     settings: settings.AsyncSettingsResource
     connections: connections.AsyncConnectionsResource
@@ -275,6 +281,8 @@ def __init__(
             _strict_response_validation=_strict_response_validation,
         )
 
+        self.memories = memories.AsyncMemoriesResource(self)
+        self.documents = documents.AsyncDocumentsResource(self)
         self.search = search.AsyncSearchResource(self)
         self.settings = settings.AsyncSettingsResource(self)
         self.connections = connections.AsyncConnectionsResource(self)
@@ -388,27 +396,35 @@ def _make_status_error(
 
 class SupermemoryWithRawResponse:
     def __init__(self, client: Supermemory) -> None:
+        self.memories = memories.MemoriesResourceWithRawResponse(client.memories)
+        self.documents = documents.DocumentsResourceWithRawResponse(client.documents)
         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.documents = documents.AsyncDocumentsResourceWithRawResponse(client.documents)
         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.documents = documents.DocumentsResourceWithStreamingResponse(client.documents)
         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.documents = documents.AsyncDocumentsResourceWithStreamingResponse(client.documents)
         self.search = search.AsyncSearchResourceWithStreamingResponse(client.search)
         self.settings = settings.AsyncSettingsResourceWithStreamingResponse(client.settings)
         self.connections = connections.AsyncConnectionsResourceWithStreamingResponse(client.connections)

src/supermemory/_files.py

@@ -34,7 +34,7 @@ def assert_is_file_content(obj: object, *, key: str | None = None) -> None:
     if not is_file_content(obj):
         prefix = f"Expected entry at `{key}`" if key is not None else f"Expected file input `{obj!r}`"
         raise RuntimeError(
-            f"{prefix} to be bytes, an io.IOBase instance, PathLike or a tuple but received {type(obj)} instead."
+            f"{prefix} to be bytes, an io.IOBase instance, PathLike or a tuple but received {type(obj)} instead. See https://github.com/supermemoryai/python-sdk/tree/main#file-uploads"
         ) from None
 
 

src/supermemory/resources/__init__.py

@@ -8,6 +8,14 @@
     SearchResourceWithStreamingResponse,
     AsyncSearchResourceWithStreamingResponse,
 )
+from .memories import (
+    MemoriesResource,
+    AsyncMemoriesResource,
+    MemoriesResourceWithRawResponse,
+    AsyncMemoriesResourceWithRawResponse,
+    MemoriesResourceWithStreamingResponse,
+    AsyncMemoriesResourceWithStreamingResponse,
+)
 from .settings import (
     SettingsResource,
     AsyncSettingsResource,
@@ -16,6 +24,14 @@
     SettingsResourceWithStreamingResponse,
     AsyncSettingsResourceWithStreamingResponse,
 )
+from .documents import (
+    DocumentsResource,
+    AsyncDocumentsResource,
+    DocumentsResourceWithRawResponse,
+    AsyncDocumentsResourceWithRawResponse,
+    DocumentsResourceWithStreamingResponse,
+    AsyncDocumentsResourceWithStreamingResponse,
+)
 from .connections import (
     ConnectionsResource,
     AsyncConnectionsResource,
@@ -26,6 +42,18 @@
 )
 
 __all__ = [
+    "MemoriesResource",
+    "AsyncMemoriesResource",
+    "MemoriesResourceWithRawResponse",
+    "AsyncMemoriesResourceWithRawResponse",
+    "MemoriesResourceWithStreamingResponse",
+    "AsyncMemoriesResourceWithStreamingResponse",
+    "DocumentsResource",
+    "AsyncDocumentsResource",
+    "DocumentsResourceWithRawResponse",
+    "AsyncDocumentsResourceWithRawResponse",
+    "DocumentsResourceWithStreamingResponse",
+    "AsyncDocumentsResourceWithStreamingResponse",
     "SearchResource",
     "AsyncSearchResource",
     "SearchResourceWithRawResponse",