release: 0.6.0

.github/workflows/ci.yml

@@ -19,7 +19,7 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/gitpod-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
 
       - name: Install Rye
         run: |
@@ -44,7 +44,7 @@ jobs:
       id-token: write
     runs-on: ${{ github.repository == 'stainless-sdks/gitpod-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
 
       - name: Install Rye
         run: |
@@ -63,7 +63,7 @@ jobs:
       - name: Get GitHub OIDC Token
         if: github.repository == 'stainless-sdks/gitpod-python'
         id: github-oidc
-        uses: actions/github-script@v6
+        uses: actions/github-script@00f12e3e20659f42342b1c0226afda7f7c042325 # v6
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
@@ -81,7 +81,7 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/gitpod-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
 
       - name: Install Rye
         run: |

.github/workflows/publish-pypi.yml

@@ -17,10 +17,10 @@ jobs:
       id-token: write
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
 
       - name: Install Rye
-        uses: eifinger/setup-rye@v4
+        uses: eifinger/setup-rye@c694239a43768373e87d0103d7f547027a23f3c8 # v4
         with:
           version: '0.44.0'
 
@@ -31,7 +31,7 @@ jobs:
         run: rye build --clean
 
       - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
+        uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e # release/v1
         with:
           # No token needed! Trusted publishing handles authentication
           packages-dir: dist/

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.5.2"
+  ".": "0.6.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 159
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-d62ef4b9187c1f3d36f428abc4b31d8a09ffd36e93d39b8136c60c8f463c838e.yml
-openapi_spec_hash: d7f01b6f24e88eb46d744ecd28061f26
-config_hash: 26e4a10dfc6ec809322e60d889d15414
+configured_endpoints: 160
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-643adebfc36ae5f3c31dc2305867f8259c9ec13420989ec37b78cdf87283a279.yml
+openapi_spec_hash: 5d04ebe79f446da15639adddf9bffc9b
+config_hash: 8e1b089e9f5af438fd56b523014af4f2

CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.6.0 (2026-01-06)
+
+Full Changelog: [v0.5.2...v0.6.0](https://github.com/gitpod-io/gitpod-sdk-python/compare/v0.5.2...v0.6.0)
+
+### Features
+
+* **agent:** add group-based SCM tools access control ([9e23e57](https://github.com/gitpod-io/gitpod-sdk-python/commit/9e23e576ea787296c10f7edbb2a20bd9c47f5a4b))
+* **skills:** add organization-level skills support ([052b48a](https://github.com/gitpod-io/gitpod-sdk-python/commit/052b48ad57f64a7c09d05c898ea6638da0c886db))
+
+
+### Bug Fixes
+
+* use async_to_httpx_files in patch method ([af8d708](https://github.com/gitpod-io/gitpod-sdk-python/commit/af8d70859c29a43ffd66f949bb70712491458c3d))
+
+
+### Chores
+
+* **internal:** codegen related update ([c0e59ad](https://github.com/gitpod-io/gitpod-sdk-python/commit/c0e59ade25f1d13024bb78d5f525c8f55e52676c))
+* **internal:** codegen related update ([34dd0fe](https://github.com/gitpod-io/gitpod-sdk-python/commit/34dd0fe4f13576840288a518b7c7c70f8d39d8f4))
+* pin GitHub Actions to SHA ([36acefc](https://github.com/gitpod-io/gitpod-sdk-python/commit/36acefc6f9ab2cbbde739b885e0734a9f476115b))
+
 ## 0.5.2 (2025-12-16)
 
 Full Changelog: [v0.5.1...v0.5.2](https://github.com/gitpod-io/gitpod-sdk-python/compare/v0.5.1...v0.5.2)

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2025 Gitpod
+   Copyright 2026 Gitpod
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

api.md

@@ -281,12 +281,17 @@ Methods:
 Types:
 
 ```python
-from gitpod.types.groups import GroupMembership, MembershipCreateResponse
+from gitpod.types.groups import (
+    GroupMembership,
+    MembershipCreateResponse,
+    MembershipRetrieveResponse,
+)
 ```
 
 Methods:
 
 - <code title="post /gitpod.v1.GroupService/CreateMembership">client.groups.memberships.<a href="./src/gitpod/resources/groups/memberships.py">create</a>(\*\*<a href="src/gitpod/types/groups/membership_create_params.py">params</a>) -> <a href="./src/gitpod/types/groups/membership_create_response.py">MembershipCreateResponse</a></code>
+- <code title="post /gitpod.v1.GroupService/GetMembership">client.groups.memberships.<a href="./src/gitpod/resources/groups/memberships.py">retrieve</a>(\*\*<a href="src/gitpod/types/groups/membership_retrieve_params.py">params</a>) -> <a href="./src/gitpod/types/groups/membership_retrieve_response.py">MembershipRetrieveResponse</a></code>
 - <code title="post /gitpod.v1.GroupService/ListMemberships">client.groups.memberships.<a href="./src/gitpod/resources/groups/memberships.py">list</a>(\*\*<a href="src/gitpod/types/groups/membership_list_params.py">params</a>) -> <a href="./src/gitpod/types/groups/group_membership.py">SyncMembersPage[GroupMembership]</a></code>
 - <code title="post /gitpod.v1.GroupService/DeleteMembership">client.groups.memberships.<a href="./src/gitpod/resources/groups/memberships.py">delete</a>(\*\*<a href="src/gitpod/types/groups/membership_delete_params.py">params</a>) -> object</code>
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gitpod-sdk"
-version = "0.5.2"
+version = "0.6.0"
 description = "The official Python library for the gitpod API"
 dynamic = ["readme"]
 license = "Apache-2.0"

scripts/lint

@@ -4,8 +4,13 @@ set -e
 
 cd "$(dirname "$0")/.."
 
-echo "==> Running lints"
-rye run lint
+if [ "$1" = "--fix" ]; then
+  echo "==> Running lints with --fix"
+  rye run fix:ruff
+else
+  echo "==> Running lints"
+  rye run lint
+fi
 
 echo "==> Making sure it imports"
 rye run python -c 'import gitpod'

src/gitpod/_base_client.py

@@ -1774,7 +1774,7 @@ async def patch(
         options: RequestOptions = {},
     ) -> ResponseT:
         opts = FinalRequestOptions.construct(
-            method="patch", url=path, json_data=body, files=to_httpx_files(files), **options
+            method="patch", url=path, json_data=body, files=await async_to_httpx_files(files), **options
         )
         return await self.request(cast_to, opts)
 

src/gitpod/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "gitpod"
-__version__ = "0.5.2"  # x-release-please-version
+__version__ = "0.6.0"  # x-release-please-version

src/gitpod/resources/agents.py

@@ -120,6 +120,7 @@ def create_prompt(
         command: str | Omit = omit,
         description: str | Omit = omit,
         is_command: bool | Omit = omit,
+        is_skill: bool | Omit = omit,
         is_template: bool | Omit = omit,
         name: str | Omit = omit,
         prompt: str | Omit = omit,
@@ -154,6 +155,7 @@ def create_prompt(
                     "command": command,
                     "description": description,
                     "is_command": is_command,
+                    "is_skill": is_skill,
                     "is_template": is_template,
                     "name": name,
                     "prompt": prompt,
@@ -768,6 +770,7 @@ async def create_prompt(
         command: str | Omit = omit,
         description: str | Omit = omit,
         is_command: bool | Omit = omit,
+        is_skill: bool | Omit = omit,
         is_template: bool | Omit = omit,
         name: str | Omit = omit,
         prompt: str | Omit = omit,
@@ -802,6 +805,7 @@ async def create_prompt(
                     "command": command,
                     "description": description,
                     "is_command": is_command,
+                    "is_skill": is_skill,
                     "is_template": is_template,
                     "name": name,
                     "prompt": prompt,

src/gitpod/resources/groups/memberships.py

@@ -16,10 +16,16 @@
 )
 from ...pagination import SyncMembersPage, AsyncMembersPage
 from ..._base_client import AsyncPaginator, make_request_options
-from ...types.groups import membership_list_params, membership_create_params, membership_delete_params
+from ...types.groups import (
+    membership_list_params,
+    membership_create_params,
+    membership_delete_params,
+    membership_retrieve_params,
+)
 from ...types.shared_params.subject import Subject
 from ...types.groups.group_membership import GroupMembership
 from ...types.groups.membership_create_response import MembershipCreateResponse
+from ...types.groups.membership_retrieve_response import MembershipRetrieveResponse
 
 __all__ = ["MembershipsResource", "AsyncMembershipsResource"]
 
@@ -108,6 +114,69 @@ def create(
             cast_to=MembershipCreateResponse,
         )
 
+    def retrieve(
+        self,
+        *,
+        subject: Subject,
+        group_id: 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,
+    ) -> MembershipRetrieveResponse:
+        """
+        Gets a specific membership by group ID and subject.
+
+        Use this method to:
+
+        - Check if a user or service account is a member of a group
+        - Verify group membership for access control
+
+        ### Examples
+
+        - Check user membership:
+
+          Checks if a user is a member of a specific group.
+
+          ```yaml
+          groupId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
+          subject:
+            id: "f53d2330-3795-4c5d-a1f3-453121af9c60"
+            principal: PRINCIPAL_USER
+          ```
+
+        ### Authorization
+
+        All organization members can check group membership (transparency model).
+
+        Args:
+          subject: Subject to check membership for
+
+          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(
+            "/gitpod.v1.GroupService/GetMembership",
+            body=maybe_transform(
+                {
+                    "subject": subject,
+                    "group_id": group_id,
+                },
+                membership_retrieve_params.MembershipRetrieveParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=MembershipRetrieveResponse,
+        )
+
     def list(
         self,
         *,
@@ -323,6 +392,69 @@ async def create(
             cast_to=MembershipCreateResponse,
         )
 
+    async def retrieve(
+        self,
+        *,
+        subject: Subject,
+        group_id: 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,
+    ) -> MembershipRetrieveResponse:
+        """
+        Gets a specific membership by group ID and subject.
+
+        Use this method to:
+
+        - Check if a user or service account is a member of a group
+        - Verify group membership for access control
+
+        ### Examples
+
+        - Check user membership:
+
+          Checks if a user is a member of a specific group.
+
+          ```yaml
+          groupId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
+          subject:
+            id: "f53d2330-3795-4c5d-a1f3-453121af9c60"
+            principal: PRINCIPAL_USER
+          ```
+
+        ### Authorization
+
+        All organization members can check group membership (transparency model).
+
+        Args:
+          subject: Subject to check membership for
+
+          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(
+            "/gitpod.v1.GroupService/GetMembership",
+            body=await async_maybe_transform(
+                {
+                    "subject": subject,
+                    "group_id": group_id,
+                },
+                membership_retrieve_params.MembershipRetrieveParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=MembershipRetrieveResponse,
+        )
+
     def list(
         self,
         *,
@@ -463,6 +595,9 @@ def __init__(self, memberships: MembershipsResource) -> None:
         self.create = to_raw_response_wrapper(
             memberships.create,
         )
+        self.retrieve = to_raw_response_wrapper(
+            memberships.retrieve,
+        )
         self.list = to_raw_response_wrapper(
             memberships.list,
         )
@@ -478,6 +613,9 @@ def __init__(self, memberships: AsyncMembershipsResource) -> None:
         self.create = async_to_raw_response_wrapper(
             memberships.create,
         )
+        self.retrieve = async_to_raw_response_wrapper(
+            memberships.retrieve,
+        )
         self.list = async_to_raw_response_wrapper(
             memberships.list,
         )
@@ -493,6 +631,9 @@ def __init__(self, memberships: MembershipsResource) -> None:
         self.create = to_streamed_response_wrapper(
             memberships.create,
         )
+        self.retrieve = to_streamed_response_wrapper(
+            memberships.retrieve,
+        )
         self.list = to_streamed_response_wrapper(
             memberships.list,
         )
@@ -508,6 +649,9 @@ def __init__(self, memberships: AsyncMembershipsResource) -> None:
         self.create = async_to_streamed_response_wrapper(
             memberships.create,
         )
+        self.retrieve = async_to_streamed_response_wrapper(
+            memberships.retrieve,
+        )
         self.list = async_to_streamed_response_wrapper(
             memberships.list,
         )