chore(internal): regenerate SDK with no functional changes

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 193
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-a43265810afa7f7c50a08fec12012d5109ecad109105f5c6cf4205f9114ad5fc.yml
-openapi_spec_hash: 44434ed0762787b31c9ecec5f670fae5
-config_hash: 63777babba88b7fa1dbf28164294eaed
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-2414772123f92b697fd3e4c661c0719539aa93dd7fcd50dad734b279fec80ced.yml
+openapi_spec_hash: 44556e215acc58a53f8f18abd00ad4a7
+config_hash: 8934bf27653a3fd17f4e3d6a0f8cc7b8

src/gitpod/resources/groups/groups.py

@@ -153,7 +153,9 @@ def create(
     def retrieve(
         self,
         *,
+        id: str | Omit = omit,
         group_id: str | Omit = omit,
+        name: 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,
@@ -162,7 +164,7 @@ def retrieve(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> GroupRetrieveResponse:
         """
-        Gets information about a specific group.
+        Gets information about a specific group by ID or name.
 
         Use this method to:
 
@@ -172,19 +174,25 @@ def retrieve(
 
         ### Examples
 
-        - Get group details:
+        - Get group by ID:
 
-          Retrieves information about a specific group.
+          Retrieves information about a specific group by its unique ID.
 
           ```yaml
-          groupId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
+          id: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
           ```
 
         ### Authorization
 
         All organization members can view group information (transparency model).
 
         Args:
+          id: id looks up the group by its unique ID.
+
+          group_id: Deprecated: use the group oneof instead.
+
+          name: name looks up the group by its name within the caller's organization.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -195,7 +203,14 @@ def retrieve(
         """
         return self._post(
             "/gitpod.v1.GroupService/GetGroup",
-            body=maybe_transform({"group_id": group_id}, group_retrieve_params.GroupRetrieveParams),
+            body=maybe_transform(
+                {
+                    "id": id,
+                    "group_id": group_id,
+                    "name": name,
+                },
+                group_retrieve_params.GroupRetrieveParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -506,7 +521,9 @@ async def create(
     async def retrieve(
         self,
         *,
+        id: str | Omit = omit,
         group_id: str | Omit = omit,
+        name: 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,
@@ -515,7 +532,7 @@ async def retrieve(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> GroupRetrieveResponse:
         """
-        Gets information about a specific group.
+        Gets information about a specific group by ID or name.
 
         Use this method to:
 
@@ -525,19 +542,25 @@ async def retrieve(
 
         ### Examples
 
-        - Get group details:
+        - Get group by ID:
 
-          Retrieves information about a specific group.
+          Retrieves information about a specific group by its unique ID.
 
           ```yaml
-          groupId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
+          id: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
           ```
 
         ### Authorization
 
         All organization members can view group information (transparency model).
 
         Args:
+          id: id looks up the group by its unique ID.
+
+          group_id: Deprecated: use the group oneof instead.
+
+          name: name looks up the group by its name within the caller's organization.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -548,7 +571,14 @@ async def retrieve(
         """
         return await self._post(
             "/gitpod.v1.GroupService/GetGroup",
-            body=await async_maybe_transform({"group_id": group_id}, group_retrieve_params.GroupRetrieveParams),
+            body=await async_maybe_transform(
+                {
+                    "id": id,
+                    "group_id": group_id,
+                    "name": name,
+                },
+                group_retrieve_params.GroupRetrieveParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),

src/gitpod/types/group_list_params.py

@@ -2,8 +2,10 @@
 
 from __future__ import annotations
 
+from typing import Optional
 from typing_extensions import Annotated, TypedDict
 
+from .._types import SequenceNotStr
 from .._utils import PropertyInfo
 
 __all__ = ["GroupListParams", "Filter", "Pagination"]
@@ -24,9 +26,24 @@ class GroupListParams(TypedDict, total=False):
 class Filter(TypedDict, total=False):
     """filter contains options for filtering the list of groups."""
 
+    direct_share: Annotated[Optional[bool], PropertyInfo(alias="directShare")]
+    """
+    direct_share filters groups by their direct_share flag. When set, only groups
+    matching this value are returned.
+    """
+
+    group_ids: Annotated[SequenceNotStr[str], PropertyInfo(alias="groupIds")]
+    """group_ids filters the response to only groups with the specified IDs"""
+
     search: str
     """search performs case-insensitive search across group name, description, and ID"""
 
+    system_managed: Annotated[Optional[bool], PropertyInfo(alias="systemManaged")]
+    """
+    system_managed filters groups by their system_managed flag. When set, only
+    groups matching this value are returned.
+    """
+
 
 class Pagination(TypedDict, total=False):
     """pagination contains the pagination options for listing groups"""

src/gitpod/types/group_retrieve_params.py

@@ -10,4 +10,11 @@
 
 
 class GroupRetrieveParams(TypedDict, total=False):
+    id: str
+    """id looks up the group by its unique ID."""
+
     group_id: Annotated[str, PropertyInfo(alias="groupId")]
+    """Deprecated: use the group oneof instead."""
+
+    name: str
+    """name looks up the group by its name within the caller's organization."""

tests/api_resources/test_groups.py

@@ -71,7 +71,9 @@ def test_method_retrieve(self, client: Gitpod) -> None:
     @parametrize
     def test_method_retrieve_with_all_params(self, client: Gitpod) -> None:
         group = client.groups.retrieve(
-            group_id="d2c94c27-3b76-4a42-b88c-95a85e392c68",
+            id="d2c94c27-3b76-4a42-b88c-95a85e392c68",
+            group_id="groupId",
+            name="xxx",
         )
         assert_matches_type(GroupRetrieveResponse, group, path=["response"])
 
@@ -147,7 +149,12 @@ def test_method_list_with_all_params(self, client: Gitpod) -> None:
         group = client.groups.list(
             token="token",
             page_size=0,
-            filter={"search": "search"},
+            filter={
+                "direct_share": True,
+                "group_ids": ["182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"],
+                "search": "search",
+                "system_managed": True,
+            },
             pagination={
                 "token": "token",
                 "page_size": 20,
@@ -267,7 +274,9 @@ async def test_method_retrieve(self, async_client: AsyncGitpod) -> None:
     @parametrize
     async def test_method_retrieve_with_all_params(self, async_client: AsyncGitpod) -> None:
         group = await async_client.groups.retrieve(
-            group_id="d2c94c27-3b76-4a42-b88c-95a85e392c68",
+            id="d2c94c27-3b76-4a42-b88c-95a85e392c68",
+            group_id="groupId",
+            name="xxx",
         )
         assert_matches_type(GroupRetrieveResponse, group, path=["response"])
 
@@ -343,7 +352,12 @@ async def test_method_list_with_all_params(self, async_client: AsyncGitpod) -> N
         group = await async_client.groups.list(
             token="token",
             page_size=0,
-            filter={"search": "search"},
+            filter={
+                "direct_share": True,
+                "group_ids": ["182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"],
+                "search": "search",
+                "system_managed": True,
+            },
             pagination={
                 "token": "token",
                 "page_size": 20,