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-571ecc4d367c9f140a08728c8e3b5c1cc4f5f8ae698e325c5cbe5181c2c87bb0.yml
-openapi_spec_hash: b96a73f50568a58168354cb8690969e9
-config_hash: eb32087403f958eead829e810f5a71b8
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-3fa2583744becce1e91ec5ad18f45d2cf17778def3a8f70537a15b08c746c2fb.yml
+openapi_spec_hash: bf3c5827e7ddb8b32435aeb671fe7845
+config_hash: b9c958a39a94966479e516e9061818be

README.md

@@ -24,36 +24,43 @@ pip install --pre supermemory
 The full API of this library can be found in [api.md](api.md).
 
 ```python
+import os
 from supermemory import Supermemory
 
 client = Supermemory(
-    api_key="My API Key",
+    api_key=os.environ.get("SUPERMEMORY_API_KEY"),  # This is the default and can be omitted
 )
 
-response = client.search.execute(
-    q="documents related to python",
+memories = client.memories.list(
+    "id",
 )
-print(response.results)
+print(memories.success)
 ```
 
+While you can provide an `api_key` keyword argument,
+we recommend using [python-dotenv](https://pypi.org/project/python-dotenv/)
+to add `SUPERMEMORY_API_KEY="My API Key"` to your `.env` file
+so that your API Key is not stored in source control.
+
 ## Async usage
 
 Simply import `AsyncSupermemory` instead of `Supermemory` and use `await` with each API call:
 
 ```python
+import os
 import asyncio
 from supermemory import AsyncSupermemory
 
 client = AsyncSupermemory(
-    api_key="My API Key",
+    api_key=os.environ.get("SUPERMEMORY_API_KEY"),  # This is the default and can be omitted
 )
 
 
 async def main() -> None:
-    response = await client.search.execute(
-        q="documents related to python",
+    memories = await client.memories.list(
+        "id",
     )
-    print(response.results)
+    print(memories.success)
 
 
 asyncio.run(main())
@@ -83,13 +90,11 @@ All errors inherit from `supermemory.APIError`.
 import supermemory
 from supermemory import Supermemory
 
-client = Supermemory(
-    api_key="My API Key",
-)
+client = Supermemory()
 
 try:
-    client.memory.create(
-        content="This is a detailed article about machine learning concepts..",
+    client.memories.list(
+        "id",
     )
 except supermemory.APIConnectionError as e:
     print("The server could not be reached")
@@ -128,14 +133,13 @@ from supermemory import Supermemory
 
 # Configure the default for all requests:
 client = Supermemory(
-    api_key="My API Key",
     # default is 2
     max_retries=0,
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).memory.create(
-    content="This is a detailed article about machine learning concepts..",
+client.with_options(max_retries=5).memories.list(
+    "id",
 )
 ```
 
@@ -149,20 +153,18 @@ from supermemory import Supermemory
 
 # Configure the default for all requests:
 client = Supermemory(
-    api_key="My API Key",
     # 20 seconds (default is 1 minute)
     timeout=20.0,
 )
 
 # More granular control:
 client = Supermemory(
-    api_key="My API Key",
     timeout=httpx.Timeout(60.0, read=5.0, write=10.0, connect=2.0),
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).memory.create(
-    content="This is a detailed article about machine learning concepts..",
+client.with_options(timeout=5.0).memories.list(
+    "id",
 )
 ```
 
@@ -203,16 +205,14 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 ```py
 from supermemory import Supermemory
 
-client = Supermemory(
-    api_key="My API Key",
-)
-response = client.memory.with_raw_response.create(
-    content="This is a detailed article about machine learning concepts..",
+client = Supermemory()
+response = client.memories.with_raw_response.list(
+    "id",
 )
 print(response.headers.get('X-My-Header'))
 
-memory = response.parse()  # get the object that `memory.create()` would have returned
-print(memory.id)
+memory = response.parse()  # get the object that `memories.list()` would have returned
+print(memory.success)
 ```
 
 These methods return an [`APIResponse`](https://github.com/supermemoryai/python-sdk/tree/main/src/supermemory/_response.py) object.
@@ -226,8 +226,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.memory.with_streaming_response.create(
-    content="This is a detailed article about machine learning concepts..",
+with client.memories.with_streaming_response.list(
+    "id",
 ) as response:
     print(response.headers.get("X-My-Header"))
 
@@ -284,7 +284,6 @@ import httpx
 from supermemory import Supermemory, DefaultHttpxClient
 
 client = Supermemory(
-    api_key="My API Key",
     # Or use the `SUPERMEMORY_BASE_URL` env var
     base_url="http://my.test.server.example.com:8083",
     http_client=DefaultHttpxClient(
@@ -307,9 +306,7 @@ By default the library closes underlying HTTP connections whenever the client is
 ```py
 from supermemory import Supermemory
 
-with Supermemory(
-    api_key="My API Key",
-) as client:
+with Supermemory() as client:
   # make requests here
   ...
 

api.md

@@ -1,56 +1,50 @@
-# Settings
-
-Types:
-
-```python
-from supermemory.types import SettingUpdateResponse
-```
-
-Methods:
-
-- <code title="put /settings">client.settings.<a href="./src/supermemory/resources/settings.py">update</a>(\*\*<a href="src/supermemory/types/setting_update_params.py">params</a>) -> <a href="./src/supermemory/types/setting_update_response.py">SettingUpdateResponse</a></code>
-
-# Memory
+# Memories
 
 Types:
 
 ```python
 from supermemory.types import (
-    MemoryCreateResponse,
     MemoryListResponse,
     MemoryDeleteResponse,
+    MemoryAddResponse,
     MemoryGetResponse,
 )
 ```
 
 Methods:
 
-- <code title="post /add">client.memory.<a href="./src/supermemory/resources/memory.py">create</a>(\*\*<a href="src/supermemory/types/memory_create_params.py">params</a>) -> <a href="./src/supermemory/types/memory_create_response.py">MemoryCreateResponse</a></code>
-- <code title="get /memories">client.memory.<a href="./src/supermemory/resources/memory.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 /delete/{id}">client.memory.<a href="./src/supermemory/resources/memory.py">delete</a>(id) -> <a href="./src/supermemory/types/memory_delete_response.py">MemoryDeleteResponse</a></code>
-- <code title="get /memory/{id}">client.memory.<a href="./src/supermemory/resources/memory.py">get</a>(id) -> <a href="./src/supermemory/types/memory_get_response.py">MemoryGetResponse</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>
+- <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
+# Settings
 
 Types:
 
 ```python
-from supermemory.types import SearchExecuteResponse
+from supermemory.types import SettingUpdateResponse, SettingGetResponse
 ```
 
 Methods:
 
-- <code title="post /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>
+- <code title="patch /v3/settings">client.settings.<a href="./src/supermemory/resources/settings.py">update</a>(\*\*<a href="src/supermemory/types/setting_update_params.py">params</a>) -> <a href="./src/supermemory/types/setting_update_response.py">SettingUpdateResponse</a></code>
+- <code title="get /v3/settings">client.settings.<a href="./src/supermemory/resources/settings.py">get</a>() -> <a href="./src/supermemory/types/setting_get_response.py">SettingGetResponse</a></code>
 
-# Connection
+# Connections
 
 Types:
 
 ```python
-from supermemory.types import ConnectionCreateResponse
+from supermemory.types import (
+    ConnectionCreateResponse,
+    ConnectionListResponse,
+    ConnectionGetResponse,
+)
 ```
 
 Methods:
 
-- <code title="get /connect/{app}">client.connection.<a href="./src/supermemory/resources/connection.py">create</a>(app, \*\*<a href="src/supermemory/types/connection_create_params.py">params</a>) -> <a href="./src/supermemory/types/connection_create_response.py">ConnectionCreateResponse</a></code>
-- <code title="get /connections/{connectionId}">client.connection.<a href="./src/supermemory/resources/connection.py">retrieve</a>(connection_id) -> None</code>
+- <code title="post /v3/connections/{provider}">client.connections.<a href="./src/supermemory/resources/connections.py">create</a>(provider) -> <a href="./src/supermemory/types/connection_create_response.py">ConnectionCreateResponse</a></code>
+- <code title="get /v3/connections">client.connections.<a href="./src/supermemory/resources/connections.py">list</a>() -> <a href="./src/supermemory/types/connection_list_response.py">ConnectionListResponse</a></code>
+- <code title="get /v3/connections/{connectionId}">client.connections.<a href="./src/supermemory/resources/connections.py">get</a>(connection_id) -> <a href="./src/supermemory/types/connection_get_response.py">ConnectionGetResponse</a></code>

src/supermemory/_client.py

@@ -21,7 +21,7 @@
 )
 from ._utils import is_given, get_async_library
 from ._version import __version__
-from .resources import memory, search, settings, connection
+from .resources import memories, settings, connections
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import APIStatusError, SupermemoryError
 from ._base_client import (
@@ -43,10 +43,9 @@
 
 
 class Supermemory(SyncAPIClient):
+    memories: memories.MemoriesResource
     settings: settings.SettingsResource
-    memory: memory.MemoryResource
-    search: search.SearchResource
-    connection: connection.ConnectionResource
+    connections: connections.ConnectionsResource
     with_raw_response: SupermemoryWithRawResponse
     with_streaming_response: SupermemoryWithStreamedResponse
 
@@ -91,7 +90,7 @@ def __init__(
         if base_url is None:
             base_url = os.environ.get("SUPERMEMORY_BASE_URL")
         if base_url is None:
-            base_url = f"https://v2.api.supermemory.ai"
+            base_url = f"https://api.supermemory.ai/"
 
         super().__init__(
             version=__version__,
@@ -104,10 +103,9 @@ def __init__(
             _strict_response_validation=_strict_response_validation,
         )
 
+        self.memories = memories.MemoriesResource(self)
         self.settings = settings.SettingsResource(self)
-        self.memory = memory.MemoryResource(self)
-        self.search = search.SearchResource(self)
-        self.connection = connection.ConnectionResource(self)
+        self.connections = connections.ConnectionsResource(self)
         self.with_raw_response = SupermemoryWithRawResponse(self)
         self.with_streaming_response = SupermemoryWithStreamedResponse(self)
 
@@ -116,6 +114,12 @@ def __init__(
     def qs(self) -> Querystring:
         return Querystring(array_format="comma")
 
+    @property
+    @override
+    def auth_headers(self) -> dict[str, str]:
+        api_key = self.api_key
+        return {"Authorization": f"Bearer {api_key}"}
+
     @property
     @override
     def default_headers(self) -> dict[str, str | Omit]:
@@ -211,10 +215,9 @@ def _make_status_error(
 
 
 class AsyncSupermemory(AsyncAPIClient):
+    memories: memories.AsyncMemoriesResource
     settings: settings.AsyncSettingsResource
-    memory: memory.AsyncMemoryResource
-    search: search.AsyncSearchResource
-    connection: connection.AsyncConnectionResource
+    connections: connections.AsyncConnectionsResource
     with_raw_response: AsyncSupermemoryWithRawResponse
     with_streaming_response: AsyncSupermemoryWithStreamedResponse
 
@@ -259,7 +262,7 @@ def __init__(
         if base_url is None:
             base_url = os.environ.get("SUPERMEMORY_BASE_URL")
         if base_url is None:
-            base_url = f"https://v2.api.supermemory.ai"
+            base_url = f"https://api.supermemory.ai/"
 
         super().__init__(
             version=__version__,
@@ -272,10 +275,9 @@ def __init__(
             _strict_response_validation=_strict_response_validation,
         )
 
+        self.memories = memories.AsyncMemoriesResource(self)
         self.settings = settings.AsyncSettingsResource(self)
-        self.memory = memory.AsyncMemoryResource(self)
-        self.search = search.AsyncSearchResource(self)
-        self.connection = connection.AsyncConnectionResource(self)
+        self.connections = connections.AsyncConnectionsResource(self)
         self.with_raw_response = AsyncSupermemoryWithRawResponse(self)
         self.with_streaming_response = AsyncSupermemoryWithStreamedResponse(self)
 
@@ -284,6 +286,12 @@ def __init__(
     def qs(self) -> Querystring:
         return Querystring(array_format="comma")
 
+    @property
+    @override
+    def auth_headers(self) -> dict[str, str]:
+        api_key = self.api_key
+        return {"Authorization": f"Bearer {api_key}"}
+
     @property
     @override
     def default_headers(self) -> dict[str, str | Omit]:
@@ -380,34 +388,30 @@ def _make_status_error(
 
 class SupermemoryWithRawResponse:
     def __init__(self, client: Supermemory) -> None:
+        self.memories = memories.MemoriesResourceWithRawResponse(client.memories)
         self.settings = settings.SettingsResourceWithRawResponse(client.settings)
-        self.memory = memory.MemoryResourceWithRawResponse(client.memory)
-        self.search = search.SearchResourceWithRawResponse(client.search)
-        self.connection = connection.ConnectionResourceWithRawResponse(client.connection)
+        self.connections = connections.ConnectionsResourceWithRawResponse(client.connections)
 
 
 class AsyncSupermemoryWithRawResponse:
     def __init__(self, client: AsyncSupermemory) -> None:
+        self.memories = memories.AsyncMemoriesResourceWithRawResponse(client.memories)
         self.settings = settings.AsyncSettingsResourceWithRawResponse(client.settings)
-        self.memory = memory.AsyncMemoryResourceWithRawResponse(client.memory)
-        self.search = search.AsyncSearchResourceWithRawResponse(client.search)
-        self.connection = connection.AsyncConnectionResourceWithRawResponse(client.connection)
+        self.connections = connections.AsyncConnectionsResourceWithRawResponse(client.connections)
 
 
 class SupermemoryWithStreamedResponse:
     def __init__(self, client: Supermemory) -> None:
+        self.memories = memories.MemoriesResourceWithStreamingResponse(client.memories)
         self.settings = settings.SettingsResourceWithStreamingResponse(client.settings)
-        self.memory = memory.MemoryResourceWithStreamingResponse(client.memory)
-        self.search = search.SearchResourceWithStreamingResponse(client.search)
-        self.connection = connection.ConnectionResourceWithStreamingResponse(client.connection)
+        self.connections = connections.ConnectionsResourceWithStreamingResponse(client.connections)
 
 
 class AsyncSupermemoryWithStreamedResponse:
     def __init__(self, client: AsyncSupermemory) -> None:
+        self.memories = memories.AsyncMemoriesResourceWithStreamingResponse(client.memories)
         self.settings = settings.AsyncSettingsResourceWithStreamingResponse(client.settings)
-        self.memory = memory.AsyncMemoryResourceWithStreamingResponse(client.memory)
-        self.search = search.AsyncSearchResourceWithStreamingResponse(client.search)
-        self.connection = connection.AsyncConnectionResourceWithStreamingResponse(client.connection)
+        self.connections = connections.AsyncConnectionsResourceWithStreamingResponse(client.connections)
 
 
 Client = Supermemory