release: 0.9.0 (#72)

* codegen metadata

* feat: Define SCIMConfiguration database schema

* feat(api): improve SearchRepositories pagination with next_page and total_count

* codegen metadata

* feat: move agent mode from Spec to Status, add AgentModeChange signals

* feat(api): add draft and state fields to PullRequest proto

* feat: [api] sorting for `ListMembers`

* feat: [backend] Introduce role and member status filtering for `ListMembers`

* feat(dashboard): show tier badge in org selector

* feat(secrets): add ServiceAccountSecret entity with full support

* codegen metadata

* codegen metadata

* feat: [backend] Introduce org:runners_admin organization role

* codegen metadata

* feat(api): add ListSCMOrganizations endpoint

* chore(internal): update `actions/checkout` version

* feat: API for SCIM configuration management

* fix(docs): add missing pointer prefix to api.md return types

* codegen metadata

* feat(automations): add before_snapshot trigger type

* feat: [backend] Adding direct_share field to groups

* feat: [api] Introduce RPCs to share resources with individual users

* feat(api): add CheckRepositoryAccess API for repository access validation

* codegen metadata

* feat(api): add inputs array to UserInputBlock proto

* feat(agent): add spec mode for planning before interactive implementation

* codegen metadata

* release: 0.9.0

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.github/workflows/ci.yml

@@ -20,7 +20,7 @@ jobs:
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
 
     steps:
-      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
 
       - name: Setup go
         uses: actions/setup-go@d35c59abb061a4a6fb18e82ac0862c26744d6ab5 # v5
@@ -35,7 +35,7 @@ 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@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
 
       - name: Setup go
         uses: actions/setup-go@d35c59abb061a4a6fb18e82ac0862c26744d6ab5 # v5

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.8.0"
+  ".": "0.9.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-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
+configured_endpoints: 170
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-2423c089f280cdf34a987d40531692097a69f4aa971c6adf9aeec4fd7984cec2.yml
+openapi_spec_hash: 24037c3ab9ceca689150d07ecec7aa80
+config_hash: d726afb2a92132197e4eae04303e8041

CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 0.9.0 (2026-01-21)
+
+Full Changelog: [v0.8.0...v0.9.0](https://github.com/gitpod-io/gitpod-sdk-go/compare/v0.8.0...v0.9.0)
+
+### Features
+
+* [api] Introduce RPCs to share resources with individual users ([d7ffceb](https://github.com/gitpod-io/gitpod-sdk-go/commit/d7ffceb2eaa72981a62c72f283d60744ca62892a))
+* [api] sorting for `ListMembers` ([cabae1a](https://github.com/gitpod-io/gitpod-sdk-go/commit/cabae1a3485c18f2bc4906b3f93ae3f407ef0109))
+* [backend] Adding direct_share field to groups ([143f723](https://github.com/gitpod-io/gitpod-sdk-go/commit/143f7236d939a962c38a40cf3504d09a8a02d791))
+* [backend] Introduce org:runners_admin organization role ([7993dc4](https://github.com/gitpod-io/gitpod-sdk-go/commit/7993dc4480f7f676181f7837e41caa7f337febaa))
+* [backend] Introduce role and member status filtering for `ListMembers` ([fda937f](https://github.com/gitpod-io/gitpod-sdk-go/commit/fda937f8cbdec42a802895bf6c23e0cb74317c10))
+* **agent:** add spec mode for planning before interactive implementation ([47daf98](https://github.com/gitpod-io/gitpod-sdk-go/commit/47daf9841f0ba302ea5c442bd578cd6912b18ee9))
+* API for SCIM configuration management ([a0f4eed](https://github.com/gitpod-io/gitpod-sdk-go/commit/a0f4eed6d124adafdd7f4fb5aa5685ebe409ff5e))
+* **api:** add CheckRepositoryAccess API for repository access validation ([1879407](https://github.com/gitpod-io/gitpod-sdk-go/commit/1879407adceddbbce473b79bbfd8ed91bfe9f1c1))
+* **api:** add draft and state fields to PullRequest proto ([b9a0d47](https://github.com/gitpod-io/gitpod-sdk-go/commit/b9a0d47bdd27ff86502afbba720b3d718cdd5f99))
+* **api:** add inputs array to UserInputBlock proto ([a1e5a8a](https://github.com/gitpod-io/gitpod-sdk-go/commit/a1e5a8ab944d912f2bbc10f16ad676dba3376bf7))
+* **api:** add ListSCMOrganizations endpoint ([6ee682f](https://github.com/gitpod-io/gitpod-sdk-go/commit/6ee682f9bd97ec6d9af9b7e9368cdd25e16c8adf))
+* **api:** improve SearchRepositories pagination with next_page and total_count ([5616440](https://github.com/gitpod-io/gitpod-sdk-go/commit/56164403356b880c01ec2494cedb2f4862fabaf7))
+* **automations:** add before_snapshot trigger type ([7e9a241](https://github.com/gitpod-io/gitpod-sdk-go/commit/7e9a24185ce20eeaf8221d0333a7c16ee37ca972))
+* **dashboard:** show tier badge in org selector ([3c6cbfa](https://github.com/gitpod-io/gitpod-sdk-go/commit/3c6cbfae5c174df931ae0e365f6279f61a28ca21))
+* Define SCIMConfiguration database schema ([92e9eaf](https://github.com/gitpod-io/gitpod-sdk-go/commit/92e9eafacdd3573ba3805625c21ea476d459aeb8))
+* move agent mode from Spec to Status, add AgentModeChange signals ([32e7ca6](https://github.com/gitpod-io/gitpod-sdk-go/commit/32e7ca6a4a091dfe2d8e5e624ccfd78546e69465))
+* **secrets:** add ServiceAccountSecret entity with full support ([ec680a1](https://github.com/gitpod-io/gitpod-sdk-go/commit/ec680a173f2724fd28eb9c58e16e936cadbd1eba))
+
+
+### Bug Fixes
+
+* **docs:** add missing pointer prefix to api.md return types ([82efe0a](https://github.com/gitpod-io/gitpod-sdk-go/commit/82efe0afe041ce2ffc4ee6452bc1f202c6ca169a))
+
+
+### Chores
+
+* **internal:** update `actions/checkout` version ([ad9a294](https://github.com/gitpod-io/gitpod-sdk-go/commit/ad9a2944946a952fa632be07ef188a32ae46d8ab))
+
 ## 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)

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.8.0'
+go get -u 'github.com/gitpod-io/gitpod-sdk-go@v0.9.0'
 ```
 
 <!-- x-release-please-end -->

account.go

@@ -508,10 +508,12 @@ type AccountMembership struct {
 	UserID string `json:"userId,required" format:"uuid"`
 	// user_role is the role the user has in the organization
 	UserRole shared.OrganizationRole `json:"userRole,required"`
-	// organization_name is the member count of the organization the user is a member
-	// of
-	OrganizationMemberCount int64                 `json:"organizationMemberCount"`
-	JSON                    accountMembershipJSON `json:"-"`
+	// organization_member_count is the member count of the organization the user is a
+	// member of
+	OrganizationMemberCount int64 `json:"organizationMemberCount"`
+	// organization_tier is the tier of the organization (Free, Core, Enterprise)
+	OrganizationTier shared.OrganizationTier `json:"organizationTier"`
+	JSON             accountMembershipJSON   `json:"-"`
 }
 
 // accountMembershipJSON contains the JSON metadata for the struct
@@ -522,6 +524,7 @@ type accountMembershipJSON struct {
 	UserID                  apijson.Field
 	UserRole                apijson.Field
 	OrganizationMemberCount apijson.Field
+	OrganizationTier        apijson.Field
 	raw                     string
 	ExtraFields             map[string]apijson.Field
 }

agent.go

@@ -388,10 +388,14 @@ type AgentCodeContextPullRequest struct {
 	ID string `json:"id"`
 	// Author name as provided by the SCM system
 	Author string `json:"author"`
+	// Whether this is a draft pull request
+	Draft bool `json:"draft"`
 	// Source branch name (the branch being merged from)
 	FromBranch string `json:"fromBranch"`
 	// Repository information
 	Repository AgentCodeContextPullRequestRepository `json:"repository"`
+	// Current state of the pull request
+	State shared.State `json:"state"`
 	// Pull request title
 	Title string `json:"title"`
 	// Target branch name (the branch being merged into)
@@ -406,8 +410,10 @@ type AgentCodeContextPullRequest struct {
 type agentCodeContextPullRequestJSON struct {
 	ID          apijson.Field
 	Author      apijson.Field
+	Draft       apijson.Field
 	FromBranch  apijson.Field
 	Repository  apijson.Field
+	State       apijson.Field
 	Title       apijson.Field
 	ToBranch    apijson.Field
 	URL         apijson.Field
@@ -482,10 +488,14 @@ type AgentCodeContextPullRequestParam struct {
 	ID param.Field[string] `json:"id"`
 	// Author name as provided by the SCM system
 	Author param.Field[string] `json:"author"`
+	// Whether this is a draft pull request
+	Draft param.Field[bool] `json:"draft"`
 	// Source branch name (the branch being merged from)
 	FromBranch param.Field[string] `json:"fromBranch"`
 	// Repository information
 	Repository param.Field[AgentCodeContextPullRequestRepositoryParam] `json:"repository"`
+	// Current state of the pull request
+	State param.Field[shared.State] `json:"state"`
 	// Pull request title
 	Title param.Field[string] `json:"title"`
 	// Target branch name (the branch being merged into)
@@ -783,9 +793,7 @@ type AgentExecutionSpec struct {
 	// desired_phase is the desired phase of the agent run
 	DesiredPhase AgentExecutionSpecDesiredPhase `json:"desiredPhase"`
 	Limits       AgentExecutionSpecLimits       `json:"limits"`
-	// mode is the operational mode for this agent execution
-	Mode    AgentMode `json:"mode"`
-	Session string    `json:"session"`
+	Session      string                         `json:"session"`
 	// version of the spec. The value of this field has no semantic meaning (e.g. don't
 	// interpret it as as a timestamp), but it can be used to impose a partial order.
 	// If a.spec_version < b.spec_version then a was the spec before b.
@@ -800,7 +808,6 @@ type agentExecutionSpecJSON struct {
 	CodeContext  apijson.Field
 	DesiredPhase apijson.Field
 	Limits       apijson.Field
-	Mode         apijson.Field
 	Session      apijson.Field
 	SpecVersion  apijson.Field
 	raw          string
@@ -879,6 +886,9 @@ type AgentExecutionStatus struct {
 	Iterations      string                            `json:"iterations"`
 	// judgement is the judgement of the agent run produced by the judgement prompt.
 	Judgement string `json:"judgement"`
+	// mode is the current operational mode of the agent execution. This is set by the
+	// agent when entering different modes (e.g., Ralph mode via /ona:ralph command).
+	Mode AgentMode `json:"mode"`
 	// outputs is a map of key-value pairs that can be set by the agent during
 	// execution. Similar to task execution outputs, but with typed values for
 	// structured data.
@@ -917,6 +927,7 @@ type agentExecutionStatusJSON struct {
 	InputTokensUsed          apijson.Field
 	Iterations               apijson.Field
 	Judgement                apijson.Field
+	Mode                     apijson.Field
 	Outputs                  apijson.Field
 	OutputTokensUsed         apijson.Field
 	Phase                    apijson.Field
@@ -1136,11 +1147,13 @@ const (
 	AgentModeUnspecified AgentMode = "AGENT_MODE_UNSPECIFIED"
 	AgentModeExecution   AgentMode = "AGENT_MODE_EXECUTION"
 	AgentModePlanning    AgentMode = "AGENT_MODE_PLANNING"
+	AgentModeRalph       AgentMode = "AGENT_MODE_RALPH"
+	AgentModeSpec        AgentMode = "AGENT_MODE_SPEC"
 )
 
 func (r AgentMode) IsKnown() bool {
 	switch r {
-	case AgentModeUnspecified, AgentModeExecution, AgentModePlanning:
+	case AgentModeUnspecified, AgentModeExecution, AgentModePlanning, AgentModeRalph, AgentModeSpec:
 		return true
 	}
 	return false
@@ -1417,27 +1430,96 @@ type UserInputBlockParam struct {
 	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"`
+	// ImageInput allows sending images to the agent. Client must provide the MIME
+	// type; backend validates against magic bytes.
+	//
+	// Deprecated: deprecated
+	Image  param.Field[UserInputBlockImageParam]   `json:"image"`
+	Inputs param.Field[[]UserInputBlockInputParam] `json:"inputs"`
+	// Deprecated: deprecated
+	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.
+// ImageInput allows sending images to the agent. Client must provide the MIME
+// type; backend validates against magic bytes.
+//
+// Deprecated: deprecated
 type UserInputBlockImageParam struct {
-	// Raw image data (max 4MB). Supported formats: PNG, JPEG, WebP.
-	Data param.Field[string] `json:"data" format:"byte"`
+	// Raw image data (max 4MB). Supported formats: PNG, JPEG.
+	Data     param.Field[string]                      `json:"data" format:"byte"`
+	MimeType param.Field[UserInputBlockImageMimeType] `json:"mimeType"`
 }
 
 func (r UserInputBlockImageParam) MarshalJSON() (data []byte, err error) {
 	return apijson.MarshalRoot(r)
 }
 
+type UserInputBlockImageMimeType string
+
+const (
+	UserInputBlockImageMimeTypeImagePng  UserInputBlockImageMimeType = "image/png"
+	UserInputBlockImageMimeTypeImageJpeg UserInputBlockImageMimeType = "image/jpeg"
+)
+
+func (r UserInputBlockImageMimeType) IsKnown() bool {
+	switch r {
+	case UserInputBlockImageMimeTypeImagePng, UserInputBlockImageMimeTypeImageJpeg:
+		return true
+	}
+	return false
+}
+
+type UserInputBlockInputParam struct {
+	// ImageInput allows sending images to the agent. Client must provide the MIME
+	// type; backend validates against magic bytes.
+	Image param.Field[UserInputBlockInputsImageParam] `json:"image"`
+	Text  param.Field[UserInputBlockInputsTextParam]  `json:"text"`
+}
+
+func (r UserInputBlockInputParam) MarshalJSON() (data []byte, err error) {
+	return apijson.MarshalRoot(r)
+}
+
+// ImageInput allows sending images to the agent. Client must provide the MIME
+// type; backend validates against magic bytes.
+type UserInputBlockInputsImageParam struct {
+	// Raw image data (max 4MB). Supported formats: PNG, JPEG.
+	Data     param.Field[string]                            `json:"data" format:"byte"`
+	MimeType param.Field[UserInputBlockInputsImageMimeType] `json:"mimeType"`
+}
+
+func (r UserInputBlockInputsImageParam) MarshalJSON() (data []byte, err error) {
+	return apijson.MarshalRoot(r)
+}
+
+type UserInputBlockInputsImageMimeType string
+
+const (
+	UserInputBlockInputsImageMimeTypeImagePng  UserInputBlockInputsImageMimeType = "image/png"
+	UserInputBlockInputsImageMimeTypeImageJpeg UserInputBlockInputsImageMimeType = "image/jpeg"
+)
+
+func (r UserInputBlockInputsImageMimeType) IsKnown() bool {
+	switch r {
+	case UserInputBlockInputsImageMimeTypeImagePng, UserInputBlockInputsImageMimeTypeImageJpeg:
+		return true
+	}
+	return false
+}
+
+type UserInputBlockInputsTextParam struct {
+	Content param.Field[string] `json:"content"`
+}
+
+func (r UserInputBlockInputsTextParam) MarshalJSON() (data []byte, err error) {
+	return apijson.MarshalRoot(r)
+}
+
+// Deprecated: deprecated
 type UserInputBlockTextParam struct {
 	Content param.Field[string] `json:"content"`
 }

agent_test.go

@@ -12,6 +12,7 @@ import (
 	"github.com/gitpod-io/gitpod-sdk-go"
 	"github.com/gitpod-io/gitpod-sdk-go/internal/testutil"
 	"github.com/gitpod-io/gitpod-sdk-go/option"
+	"github.com/gitpod-io/gitpod-sdk-go/shared"
 )
 
 func TestAgentNewExecutionConversationTokenWithOptionalParams(t *testing.T) {
@@ -264,8 +265,18 @@ func TestAgentSendToExecutionWithOptionalParams(t *testing.T) {
 			ID:        gitpod.F("id"),
 			CreatedAt: gitpod.F(time.Now()),
 			Image: gitpod.F(gitpod.UserInputBlockImageParam{
-				Data: gitpod.F("U3RhaW5sZXNzIHJvY2tz"),
+				Data:     gitpod.F("U3RhaW5sZXNzIHJvY2tz"),
+				MimeType: gitpod.F(gitpod.UserInputBlockImageMimeTypeImagePng),
 			}),
+			Inputs: gitpod.F([]gitpod.UserInputBlockInputParam{{
+				Image: gitpod.F(gitpod.UserInputBlockInputsImageParam{
+					Data:     gitpod.F("U3RhaW5sZXNzIHJvY2tz"),
+					MimeType: gitpod.F(gitpod.UserInputBlockInputsImageMimeTypeImagePng),
+				}),
+				Text: gitpod.F(gitpod.UserInputBlockInputsTextParam{
+					Content: gitpod.F("x"),
+				}),
+			}}),
 			Text: gitpod.F(gitpod.UserInputBlockTextParam{
 				Content: gitpod.F("Generate a report based on the latest logs."),
 			}),
@@ -305,13 +316,15 @@ func TestAgentStartExecutionWithOptionalParams(t *testing.T) {
 			PullRequest: gitpod.F(gitpod.AgentCodeContextPullRequestParam{
 				ID:         gitpod.F("id"),
 				Author:     gitpod.F("author"),
+				Draft:      gitpod.F(true),
 				FromBranch: gitpod.F("fromBranch"),
 				Repository: gitpod.F(gitpod.AgentCodeContextPullRequestRepositoryParam{
 					CloneURL: gitpod.F("cloneUrl"),
 					Host:     gitpod.F("host"),
 					Name:     gitpod.F("name"),
 					Owner:    gitpod.F("owner"),
 				}),
+				State:    gitpod.F(shared.StateUnspecified),
 				Title:    gitpod.F("title"),
 				ToBranch: gitpod.F("toBranch"),
 				URL:      gitpod.F("url"),