release: 0.8.0 (#71)

* feat(agent): add group-based SCM tools access control

* fix: skip usage tests that don't work with Prism

* chore: pin GitHub Actions to SHA

* codegen metadata

* chore(internal): codegen related update

* codegen metadata

* feat(skills): add organization-level skills support

* feat(prebuild): expose snapshot completion percentage in prebuild status

* feat(api): add ImageInput to UserInputBlock proto

* fix: streaming endpoints should pass through errors correctly

* feat(api): add recommended editors configuration to project settings

* codegen metadata

* feat(db): add webhooks table with trigger reference

* release: 0.8.0

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>
Co-authored-by: Jesús Espino <jesus@gitpod.io>
Co-authored-by: Jesús Espino <jespinog@gmail.com>

Author: stainless-app[bot]

.github/workflows/ci.yml

@@ -20,10 +20,10 @@ jobs:
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
 
       - name: Setup go
-        uses: actions/setup-go@v5
+        uses: actions/setup-go@d35c59abb061a4a6fb18e82ac0862c26744d6ab5 # v5
         with:
           go-version-file: ./go.mod
 
@@ -35,10 +35,10 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/gitpod-go' && '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: Setup go
-        uses: actions/setup-go@v5
+        uses: actions/setup-go@d35c59abb061a4a6fb18e82ac0862c26744d6ab5 # v5
         with:
           go-version-file: ./go.mod
 

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.7.0"
+  ".": "0.8.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-3935e467f9c15925790aada293124db82bb5d6840eeac52d81fbac6a9b0fd154.yml
+openapi_spec_hash: b417d7f10ea430216e9b70e4468a3212
+config_hash: d3267594264bfb76d2ee7e881d5f8a5a

CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 0.8.0 (2026-01-09)
+
+Full Changelog: [v0.7.0...v0.8.0](https://github.com/gitpod-io/gitpod-sdk-go/compare/v0.7.0...v0.8.0)
+
+### Features
+
+* **agent:** add group-based SCM tools access control ([02a3ac4](https://github.com/gitpod-io/gitpod-sdk-go/commit/02a3ac402e5b07ea0efffaf6a35ea3740b800211))
+* **api:** add ImageInput to UserInputBlock proto ([c48d8ec](https://github.com/gitpod-io/gitpod-sdk-go/commit/c48d8ec1113b38bdc7cf11495001b6c29cb112a4))
+* **api:** add recommended editors configuration to project settings ([673574f](https://github.com/gitpod-io/gitpod-sdk-go/commit/673574ffc184dc7b7f5e66599e173899d9dd4e4e))
+* **db:** add webhooks table with trigger reference ([41d8762](https://github.com/gitpod-io/gitpod-sdk-go/commit/41d8762b09efce9967748d6c4e57308d8ee2dc7c))
+* **prebuild:** expose snapshot completion percentage in prebuild status ([5e6837c](https://github.com/gitpod-io/gitpod-sdk-go/commit/5e6837cb70420eeba8a19f2b10f965e6c4d4478f))
+* **skills:** add organization-level skills support ([dbd94be](https://github.com/gitpod-io/gitpod-sdk-go/commit/dbd94bebb9f959939d0bb2b882181316b771d0b9))
+
+
+### Bug Fixes
+
+* skip usage tests that don't work with Prism ([2e9de50](https://github.com/gitpod-io/gitpod-sdk-go/commit/2e9de50431b0d2ab64db8b7bbba3c83aedc7d74b))
+* streaming endpoints should pass through errors correctly ([0897659](https://github.com/gitpod-io/gitpod-sdk-go/commit/08976594ce2bdb431fc4a662ec0fa21d6989a8c3))
+
+
+### Chores
+
+* **internal:** codegen related update ([7118d8d](https://github.com/gitpod-io/gitpod-sdk-go/commit/7118d8d561c9b7bacfa89e78e7fa1731c8c9f37b))
+* pin GitHub Actions to SHA ([af1d69c](https://github.com/gitpod-io/gitpod-sdk-go/commit/af1d69c695071e89c7ede111953b510914b6dff0))
+
 ## 0.7.0 (2025-12-15)
 
 Full Changelog: [v0.6.1...v0.7.0](https://github.com/gitpod-io/gitpod-sdk-go/compare/v0.6.1...v0.7.0)

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.

README.md

@@ -24,7 +24,7 @@ Or to pin the version:
 <!-- x-release-please-start-version -->
 
 ```sh
-go get -u 'github.com/gitpod-io/gitpod-sdk-go@v0.7.0'
+go get -u 'github.com/gitpod-io/gitpod-sdk-go@v0.8.0'
 ```
 
 <!-- x-release-please-end -->

agent.go

@@ -1385,6 +1385,8 @@ type PromptSpec struct {
 	Command string `json:"command"`
 	// is_command indicates if this prompt is a command
 	IsCommand bool `json:"isCommand"`
+	// is_skill indicates if this prompt is a skill (workflow instructions for agents)
+	IsSkill bool `json:"isSkill"`
 	// is_template indicates if this prompt is a template
 	IsTemplate bool `json:"isTemplate"`
 	// prompt is the content of the prompt
@@ -1396,6 +1398,7 @@ type PromptSpec struct {
 type promptSpecJSON struct {
 	Command     apijson.Field
 	IsCommand   apijson.Field
+	IsSkill     apijson.Field
 	IsTemplate  apijson.Field
 	Prompt      apijson.Field
 	raw         string
@@ -1411,16 +1414,30 @@ func (r promptSpecJSON) RawJSON() string {
 }
 
 type UserInputBlockParam struct {
-	Text param.Field[UserInputBlockTextParam] `json:"text,required"`
-	ID   param.Field[string]                  `json:"id"`
+	ID param.Field[string] `json:"id"`
 	// Timestamp when this block was created. Used for debugging and support bundles.
 	CreatedAt param.Field[time.Time] `json:"createdAt" format:"date-time"`
+	// ImageInput allows sending images to the agent. Media type is inferred from magic
+	// bytes by the backend.
+	Image param.Field[UserInputBlockImageParam] `json:"image"`
+	Text  param.Field[UserInputBlockTextParam]  `json:"text"`
 }
 
 func (r UserInputBlockParam) MarshalJSON() (data []byte, err error) {
 	return apijson.MarshalRoot(r)
 }
 
+// ImageInput allows sending images to the agent. Media type is inferred from magic
+// bytes by the backend.
+type UserInputBlockImageParam struct {
+	// Raw image data (max 4MB). Supported formats: PNG, JPEG, WebP.
+	Data param.Field[string] `json:"data" format:"byte"`
+}
+
+func (r UserInputBlockImageParam) MarshalJSON() (data []byte, err error) {
+	return apijson.MarshalRoot(r)
+}
+
 type UserInputBlockTextParam struct {
 	Content param.Field[string] `json:"content"`
 }
@@ -1575,6 +1592,7 @@ type AgentNewPromptParams struct {
 	Command     param.Field[string] `json:"command"`
 	Description param.Field[string] `json:"description"`
 	IsCommand   param.Field[bool]   `json:"isCommand"`
+	IsSkill     param.Field[bool]   `json:"isSkill"`
 	IsTemplate  param.Field[bool]   `json:"isTemplate"`
 	Name        param.Field[string] `json:"name"`
 	Prompt      param.Field[string] `json:"prompt"`
@@ -1704,6 +1722,7 @@ type AgentListPromptsParamsFilter struct {
 	Command       param.Field[string] `json:"command"`
 	CommandPrefix param.Field[string] `json:"commandPrefix"`
 	IsCommand     param.Field[bool]   `json:"isCommand"`
+	IsSkill       param.Field[bool]   `json:"isSkill"`
 	IsTemplate    param.Field[bool]   `json:"isTemplate"`
 }
 
@@ -1804,6 +1823,8 @@ type AgentUpdatePromptParamsSpec struct {
 	Command param.Field[string] `json:"command"`
 	// Whether this prompt is a command
 	IsCommand param.Field[bool] `json:"isCommand"`
+	// Whether this prompt is a skill
+	IsSkill param.Field[bool] `json:"isSkill"`
 	// Whether this prompt is a template
 	IsTemplate param.Field[bool] `json:"isTemplate"`
 	// The prompt content

agent_test.go

@@ -56,6 +56,7 @@ func TestAgentNewPromptWithOptionalParams(t *testing.T) {
 		Command:     gitpod.F("command"),
 		Description: gitpod.F("x"),
 		IsCommand:   gitpod.F(true),
+		IsSkill:     gitpod.F(true),
 		IsTemplate:  gitpod.F(true),
 		Name:        gitpod.F("x"),
 		Prompt:      gitpod.F("x"),
@@ -177,6 +178,7 @@ func TestAgentListPromptsWithOptionalParams(t *testing.T) {
 			Command:       gitpod.F("command"),
 			CommandPrefix: gitpod.F("commandPrefix"),
 			IsCommand:     gitpod.F(true),
+			IsSkill:       gitpod.F(true),
 			IsTemplate:    gitpod.F(true),
 		}),
 		Pagination: gitpod.F(gitpod.AgentListPromptsParamsPagination{
@@ -259,11 +261,14 @@ func TestAgentSendToExecutionWithOptionalParams(t *testing.T) {
 	_, err := client.Agents.SendToExecution(context.TODO(), gitpod.AgentSendToExecutionParams{
 		AgentExecutionID: gitpod.F("6fa1a3c7-fbb7-49d1-ba56-1890dc7c4c35"),
 		UserInput: gitpod.F(gitpod.UserInputBlockParam{
+			ID:        gitpod.F("id"),
+			CreatedAt: gitpod.F(time.Now()),
+			Image: gitpod.F(gitpod.UserInputBlockImageParam{
+				Data: gitpod.F("U3RhaW5sZXNzIHJvY2tz"),
+			}),
 			Text: gitpod.F(gitpod.UserInputBlockTextParam{
 				Content: gitpod.F("Generate a report based on the latest logs."),
 			}),
-			ID:        gitpod.F("id"),
-			CreatedAt: gitpod.F(time.Now()),
 		}),
 	})
 	if err != nil {
@@ -372,6 +377,7 @@ func TestAgentUpdatePromptWithOptionalParams(t *testing.T) {
 		Spec: gitpod.F(gitpod.AgentUpdatePromptParamsSpec{
 			Command:    gitpod.F("command"),
 			IsCommand:  gitpod.F(true),
+			IsSkill:    gitpod.F(true),
 			IsTemplate: gitpod.F(true),
 			Prompt:     gitpod.F("prompt"),
 		}),

aliases.go

@@ -272,6 +272,9 @@ const ResourceTypeRoleAssignmentChanged = shared.ResourceTypeRoleAssignmentChang
 // This is an alias to an internal value.
 const ResourceTypeGroupMembershipChanged = shared.ResourceTypeGroupMembershipChanged
 
+// This is an alias to an internal value.
+const ResourceTypeWebhook = shared.ResourceTypeWebhook
+
 // This is an alias to an internal type.
 type RunsOn = shared.RunsOn
 

api.md

@@ -316,11 +316,13 @@ Response Types:
 
 - <a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#GroupMembership">GroupMembership</a>
 - <a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#GroupMembershipNewResponse">GroupMembershipNewResponse</a>
+- <a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#GroupMembershipGetResponse">GroupMembershipGetResponse</a>
 - <a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#GroupMembershipDeleteResponse">GroupMembershipDeleteResponse</a>
 
 Methods:
 
 - <code title="post /gitpod.v1.GroupService/CreateMembership">client.Groups.Memberships.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#GroupMembershipService.New">New</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, body <a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#GroupMembershipNewParams">GroupMembershipNewParams</a>) (<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#GroupMembershipNewResponse">GroupMembershipNewResponse</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
+- <code title="post /gitpod.v1.GroupService/GetMembership">client.Groups.Memberships.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#GroupMembershipService.Get">Get</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, body <a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#GroupMembershipGetParams">GroupMembershipGetParams</a>) (<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#GroupMembershipGetResponse">GroupMembershipGetResponse</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 - <code title="post /gitpod.v1.GroupService/ListMemberships">client.Groups.Memberships.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#GroupMembershipService.List">List</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, params <a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#GroupMembershipListParams">GroupMembershipListParams</a>) (<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go/packages/pagination">pagination</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go/packages/pagination#MembersPage">MembersPage</a>[<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#GroupMembership">GroupMembership</a>], <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 - <code title="post /gitpod.v1.GroupService/DeleteMembership">client.Groups.Memberships.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#GroupMembershipService.Delete">Delete</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, body <a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#GroupMembershipDeleteParams">GroupMembershipDeleteParams</a>) (<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#GroupMembershipDeleteResponse">GroupMembershipDeleteResponse</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 
@@ -524,6 +526,7 @@ Params Types:
 
 - <a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#EnvironmentInitializerParam">EnvironmentInitializerParam</a>
 - <a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#ProjectPrebuildConfigurationParam">ProjectPrebuildConfigurationParam</a>
+- <a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#RecommendedEditorsParam">RecommendedEditorsParam</a>
 
 Response Types:
 
@@ -532,6 +535,7 @@ Response Types:
 - <a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#ProjectMetadata">ProjectMetadata</a>
 - <a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#ProjectPhase">ProjectPhase</a>
 - <a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#ProjectPrebuildConfiguration">ProjectPrebuildConfiguration</a>
+- <a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#RecommendedEditors">RecommendedEditors</a>
 - <a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#ProjectNewResponse">ProjectNewResponse</a>
 - <a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#ProjectGetResponse">ProjectGetResponse</a>
 - <a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go">gitpod</a>.<a href="https://pkg.go.dev/github.com/gitpod-io/gitpod-sdk-go#ProjectUpdateResponse">ProjectUpdateResponse</a>