feat(api): OpenAPI spec update via Stainless API (#31)

plastic-labs · Jul 31, 2024 · f626a2c · f626a2c
1 parent f3e9cb4
commit f626a2c
Show file tree

Hide file tree

Showing 11 changed files with 27 additions and 79 deletions.
diff --git a/.stats.yml b/.stats.yml
@@ -1,2 +1,2 @@
 configured_endpoints: 38
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/plastic-labs%2Fhoncho-7967581df14089cda98ce7bd258102d5da5ec541dc5b17aa918f96be11a2bde8.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/plastic-labs%2FHoncho-9de9efee1447340a4b99258885f8c5472ee853fa3bc7327fd632be3c5f23f161.yml
diff --git a/README.md b/README.md
@@ -1,8 +1,8 @@
-# Honcho API library
+# honcho-ai API library
 
 [![PyPI version](https://img.shields.io/pypi/v/honcho-ai.svg)](https://pypi.org/project/honcho-ai/)
 
-The Honcho library provides convenient access to the Honcho REST API from any Python 3.7+
+The honcho-ai library provides convenient access to the Honcho REST API from any Python 3.7+
 application. The library includes type definitions for all request params and response fields,
 and offers both synchronous and asynchronous clients powered by [httpx](https://github.com/encode/httpx).
 

diff --git a/src/honcho/resources/apps/users/collections/collections.py b/src/honcho/resources/apps/users/collections/collections.py
@@ -105,8 +105,8 @@ def update(
         *,
         app_id: str,
         user_id: str,
-        name: str,
         metadata: Optional[Dict[str, object]] | NotGiven = NOT_GIVEN,
+        name: Optional[str] | 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,
@@ -136,8 +136,8 @@ def update(
             f"/apps/{app_id}/users/{user_id}/collections/{collection_id}",
             body=maybe_transform(
                 {
-                    "name": name,
                     "metadata": metadata,
+                    "name": name,
                 },
                 collection_update_params.CollectionUpdateParams,
             ),
@@ -445,8 +445,8 @@ async def update(
         *,
         app_id: str,
         user_id: str,
-        name: str,
         metadata: Optional[Dict[str, object]] | NotGiven = NOT_GIVEN,
+        name: Optional[str] | 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,
@@ -476,8 +476,8 @@ async def update(
             f"/apps/{app_id}/users/{user_id}/collections/{collection_id}",
             body=await async_maybe_transform(
                 {
-                    "name": name,
                     "metadata": metadata,
+                    "name": name,
                 },
                 collection_update_params.CollectionUpdateParams,
             ),

diff --git a/src/honcho/resources/apps/users/sessions/metamessages.py b/src/honcho/resources/apps/users/sessions/metamessages.py
@@ -59,15 +59,15 @@ def create(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Metamessage:
         """
-        Adds a message to a session
+        Adds a metamessage to a session
 
         Args: app_id (uuid.UUID): The ID of the app representing the client application
         using honcho user_id (str): The User ID representing the user, managed by the
-        user session_id (int): The ID of the Session to add the message to message
-        (schemas.MessageCreate): The Message object to add containing the message
-        content and type
+        user session_id (int): The ID of the Session to add the metamessage to
+        metamessage (schemas.MetamessageCreate): The Metamessage object to add
+        containing the metamessage content and type
 
-        Returns: schemas.Message: The Message object of the added message
+        Returns: schemas.Metamessage: The Metamessage object of the added metamessage
 
         Raises: HTTPException: If the session is not found
 
@@ -312,15 +312,15 @@ async def create(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Metamessage:
         """
-        Adds a message to a session
+        Adds a metamessage to a session
 
         Args: app_id (uuid.UUID): The ID of the app representing the client application
         using honcho user_id (str): The User ID representing the user, managed by the
-        user session_id (int): The ID of the Session to add the message to message
-        (schemas.MessageCreate): The Message object to add containing the message
-        content and type
+        user session_id (int): The ID of the Session to add the metamessage to
+        metamessage (schemas.MetamessageCreate): The Metamessage object to add
+        containing the metamessage content and type
 
-        Returns: schemas.Message: The Message object of the added message
+        Returns: schemas.Metamessage: The Metamessage object of the added metamessage
 
         Raises: HTTPException: If the session is not found
 

diff --git a/src/honcho/resources/apps/users/sessions/sessions.py b/src/honcho/resources/apps/users/sessions/sessions.py
@@ -72,7 +72,6 @@ def create(
         user_id: str,
         *,
         app_id: str,
-        location_id: str,
         metadata: Optional[Dict[str, object]] | 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.
@@ -87,7 +86,7 @@ def create(
         Args: app_id (uuid.UUID): The ID of the app representing the client application
         using honcho user_id (uuid.UUID): The User ID representing the user, managed by
         the user session (schemas.SessionCreate): The Session object containing any
-        metadata and a location ID
+        metadata
 
         Returns: schemas.Session: The Session object of the new Session
 
@@ -106,13 +105,7 @@ def create(
             raise ValueError(f"Expected a non-empty value for `user_id` but received {user_id!r}")
         return self._post(
             f"/apps/{app_id}/users/{user_id}/sessions",
-            body=maybe_transform(
-                {
-                    "location_id": location_id,
-                    "metadata": metadata,
-                },
-                session_create_params.SessionCreateParams,
-            ),
+            body=maybe_transform({"metadata": metadata}, session_create_params.SessionCreateParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -174,7 +167,6 @@ def list(
         app_id: str,
         filter: Optional[str] | NotGiven = NOT_GIVEN,
         is_active: Optional[bool] | NotGiven = NOT_GIVEN,
-        location_id: Optional[str] | NotGiven = NOT_GIVEN,
         page: int | NotGiven = NOT_GIVEN,
         reverse: Optional[bool] | NotGiven = NOT_GIVEN,
         size: int | NotGiven = NOT_GIVEN,
@@ -190,8 +182,7 @@ def list(
 
         Args: app_id (uuid.UUID): The ID of the app representing the client application
         using honcho user_id (uuid.UUID): The User ID representing the user, managed by
-        the user location_id (str, optional): Optional Location ID representing the
-        location of a session
+        the user
 
         Returns: list[schemas.Session]: List of Session objects
 
@@ -224,7 +215,6 @@ def list(
                     {
                         "filter": filter,
                         "is_active": is_active,
-                        "location_id": location_id,
                         "page": page,
                         "reverse": reverse,
                         "size": size,
@@ -440,7 +430,6 @@ async def create(
         user_id: str,
         *,
         app_id: str,
-        location_id: str,
         metadata: Optional[Dict[str, object]] | 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.
@@ -455,7 +444,7 @@ async def create(
         Args: app_id (uuid.UUID): The ID of the app representing the client application
         using honcho user_id (uuid.UUID): The User ID representing the user, managed by
         the user session (schemas.SessionCreate): The Session object containing any
-        metadata and a location ID
+        metadata
 
         Returns: schemas.Session: The Session object of the new Session
 
@@ -474,13 +463,7 @@ async def create(
             raise ValueError(f"Expected a non-empty value for `user_id` but received {user_id!r}")
         return await self._post(
             f"/apps/{app_id}/users/{user_id}/sessions",
-            body=await async_maybe_transform(
-                {
-                    "location_id": location_id,
-                    "metadata": metadata,
-                },
-                session_create_params.SessionCreateParams,
-            ),
+            body=await async_maybe_transform({"metadata": metadata}, session_create_params.SessionCreateParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -542,7 +525,6 @@ def list(
         app_id: str,
         filter: Optional[str] | NotGiven = NOT_GIVEN,
         is_active: Optional[bool] | NotGiven = NOT_GIVEN,
-        location_id: Optional[str] | NotGiven = NOT_GIVEN,
         page: int | NotGiven = NOT_GIVEN,
         reverse: Optional[bool] | NotGiven = NOT_GIVEN,
         size: int | NotGiven = NOT_GIVEN,
@@ -558,8 +540,7 @@ def list(
 
         Args: app_id (uuid.UUID): The ID of the app representing the client application
         using honcho user_id (uuid.UUID): The User ID representing the user, managed by
-        the user location_id (str, optional): Optional Location ID representing the
-        location of a session
+        the user
 
         Returns: list[schemas.Session]: List of Session objects
 
@@ -592,7 +573,6 @@ def list(
                     {
                         "filter": filter,
                         "is_active": is_active,
-                        "location_id": location_id,
                         "page": page,
                         "reverse": reverse,
                         "size": size,

diff --git a/src/honcho/types/apps/users/collection_update_params.py b/src/honcho/types/apps/users/collection_update_params.py
@@ -13,6 +13,6 @@ class CollectionUpdateParams(TypedDict, total=False):
 
     user_id: Required[str]
 
-    name: Required[str]
-
     metadata: Optional[Dict[str, object]]
+
+    name: Optional[str]
diff --git a/src/honcho/types/apps/users/session.py b/src/honcho/types/apps/users/session.py
@@ -15,8 +15,6 @@ class Session(BaseModel):
 
     is_active: bool
 
-    location_id: str
-
     metadata: Dict[str, object]
 
     user_id: str
diff --git a/src/honcho/types/apps/users/session_create_params.py b/src/honcho/types/apps/users/session_create_params.py
@@ -11,6 +11,4 @@
 class SessionCreateParams(TypedDict, total=False):
     app_id: Required[str]
 
-    location_id: Required[str]
-
     metadata: Optional[Dict[str, object]]
diff --git a/src/honcho/types/apps/users/session_list_params.py b/src/honcho/types/apps/users/session_list_params.py
@@ -15,8 +15,6 @@ class SessionListParams(TypedDict, total=False):
 
     is_active: Optional[bool]
 
-    location_id: Optional[str]
-
     page: int
     """Page number"""
 

diff --git a/tests/api_resources/apps/users/test_collections.py b/tests/api_resources/apps/users/test_collections.py
@@ -90,7 +90,6 @@ def test_method_update(self, client: Honcho) -> None:
             collection_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             app_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             user_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            name="name",
         )
         assert_matches_type(Collection, collection, path=["response"])
 
@@ -100,8 +99,8 @@ def test_method_update_with_all_params(self, client: Honcho) -> None:
             collection_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             app_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             user_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            name="name",
             metadata={"foo": "bar"},
+            name="name",
         )
         assert_matches_type(Collection, collection, path=["response"])
 
@@ -111,7 +110,6 @@ def test_raw_response_update(self, client: Honcho) -> None:
             collection_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             app_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             user_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            name="name",
         )
 
         assert response.is_closed is True
@@ -125,7 +123,6 @@ def test_streaming_response_update(self, client: Honcho) -> None:
             collection_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             app_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             user_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            name="name",
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -142,23 +139,20 @@ def test_path_params_update(self, client: Honcho) -> None:
                 collection_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
                 app_id="",
                 user_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-                name="name",
             )
 
         with pytest.raises(ValueError, match=r"Expected a non-empty value for `user_id` but received ''"):
             client.apps.users.collections.with_raw_response.update(
                 collection_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
                 app_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
                 user_id="",
-                name="name",
             )
 
         with pytest.raises(ValueError, match=r"Expected a non-empty value for `collection_id` but received ''"):
             client.apps.users.collections.with_raw_response.update(
                 collection_id="",
                 app_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
                 user_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-                name="name",
             )
 
     @parametrize
@@ -552,7 +546,6 @@ async def test_method_update(self, async_client: AsyncHoncho) -> None:
             collection_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             app_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             user_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            name="name",
         )
         assert_matches_type(Collection, collection, path=["response"])
 
@@ -562,8 +555,8 @@ async def test_method_update_with_all_params(self, async_client: AsyncHoncho) ->
             collection_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             app_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             user_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            name="name",
             metadata={"foo": "bar"},
+            name="name",
         )
         assert_matches_type(Collection, collection, path=["response"])
 
@@ -573,7 +566,6 @@ async def test_raw_response_update(self, async_client: AsyncHoncho) -> None:
             collection_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             app_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             user_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            name="name",
         )
 
         assert response.is_closed is True
@@ -587,7 +579,6 @@ async def test_streaming_response_update(self, async_client: AsyncHoncho) -> Non
             collection_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             app_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             user_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            name="name",
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -604,23 +595,20 @@ async def test_path_params_update(self, async_client: AsyncHoncho) -> None:
                 collection_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
                 app_id="",
                 user_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-                name="name",
             )
 
         with pytest.raises(ValueError, match=r"Expected a non-empty value for `user_id` but received ''"):
             await async_client.apps.users.collections.with_raw_response.update(
                 collection_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
                 app_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
                 user_id="",
-                name="name",
             )
 
         with pytest.raises(ValueError, match=r"Expected a non-empty value for `collection_id` but received ''"):
             await async_client.apps.users.collections.with_raw_response.update(
                 collection_id="",
                 app_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
                 user_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-                name="name",
             )
 
     @parametrize