release: 0.12.0

[stainless-app]

Automated Release PR

0.12.0 (2026-07-30)

Full Changelog: v0.11.0...v0.12.0

⚠ BREAKING CHANGES

• api: narrow public SDK surface
• agent: remove loop condition mechanism

Features

• add base snapshot resource types (86bc2ef)
• agent: add devcontainer rebuild wait schema (0cf6575)
• agents: add native goal set control (09bcc43)
• api: add access_token field to runner create response models (957eb60)
• api: add agent turn controls (0c7f633)
• api: add AGENT_EXECUTION_CNF capability to RunnerCapability (3a521b2)
• api: add agent_execution_ids filter to agents list_executions (630d438)
• api: add allow_unverified_email_scim_fallback_match to scim_configurations (e1bba76)
• api: add base snapshot build environment role (0ce4953)
• api: add base snapshot runner capability (2c9855c)
• api: add Claude Sonnet 5 model enum (73ea069)
• api: add Codex agent settings shape (8d830ce)
• api: add Codex fast mode setting (5c7ef6c)
• api: add codex model policy states (f930e3c)
• api: add Codex policy allowlists (4594b02)
• api: add credential_proxy to secrets, remove format from environment spec (349a1ba)
• api: add default environment class IDs to project creation defaults (212b6b2)
• api: add disable_from_scratch to organizations policies (916c70f)
• api: add dynamic LLM header contracts (6520bd4)
• api: add incident trigger support to workflow_trigger and workflow_execution (5e90f8a)
• api: add integration_id field, make webhook_id required in pull_request trigger (077b662)
• api: add max_port_admission_level to organizations policies (4942a70)
• api: add old_path field to ContentGitChangedFile (d79d4d4)
• api: add Opus 4.8 supported model (386256e)
• api: add pagination and query parameter to runners.list_scm_organizations (333311a)
• api: add port_authentication capability to runner_capability (c29b095)
• api: add prebuild trigger value to environments automations (af2c44e)
• api: add prebuild_requires_success field to TaskSpec (eccb99f)
• api: add project_creation_defaults to organizations policies (5d8545f)
• api: add PULL_REQUEST_EVENT_REVIEW_REQUESTED to workflow_trigger events (242a3ab)
• api: add readiness_timeout field to service spec types (8786477)
• api: add RESOURCE_ROLE_ORG_ENVIRONMENTS_READER to resource_role (e99dc40)
• api: add RUNNER_CAPABILITY_REDIS_STREAM to RunnerCapability enum (b1ad5f5)
• api: add security policy CRUD (85d3d46)
• api: add StatusGoal model and goal field to agent_execution (3d37569)
• api: add SUPPORTED_MODEL_OPENAI_AUTO to agent_execution status (54503f5)
• api: add SUPPORTED_MODEL_OPUS_4_7 to agent_execution Status (74af533)
• api: add UserInputMetadata type (ea300f4)
• api: add web_browser_disabled parameter to organizations policies update (a4a49d6)
• api: expose audit log entry kind (d90ec8f)
• api: expose default security policy assignment (aeb8cba)
• api: expose usage insights API (c7e6921)
• api: expose Veto Exec security policies (07e4ed5)
• api: remove deprecated access_token from runner responses (003cd7d)
• api: remove terminal field from RunsOn type (faca2b2)
• audit: curate audit events at their producers (f54fb4a)
• audit: store and retrieve Veto Exec details (c6adc6a)
• automations: pin agent and Codex model per automation (ce020c9)
• codex: add GPT-5.6 model selection (315f4ff)
• internal/types: support eagerly validating pydantic iterators (cbf4bac)
• rbac: add billing viewer role (64f6c50)
• rbac: add insights viewer role (03c8230)
• secrets: support JFrog OIDC secret sources (419e2c0)
• support setting headers via env (4e4f3fe)

Bug Fixes

• api: narrow public SDK surface (97913bf)
• api: wrap prebuild default updates (69a9ca3)
• client: add missing f-string prefix in file type error message (9371ec1)
• client: preserve hardcoded query params when merging with user params (b7f0b1d)
• ensure file data are only sent as 1 parameter (5c02854)
• use correct field name format for multipart file arrays (c731392)

Performance Improvements

• client: optimize file structure copying in multipart requests (cb792b6)

Chores

• internal: more robust bootstrap script (5f05caa)
• internal: reformat pyproject.toml (b061deb)
• internal: regenerate SDK with no functional changes (2dc3c8d)

Documentation

• api: add customer-facing descriptions to runner enums and fix CreateRunner examples (5319ad7)
• api: update trigger usage note in AutomationTrigger (5a292cb)
• types: mark is_admin deprecated in Organization model (5e7b9f3)

Refactors

• agent: remove loop condition mechanism (9951849)
• api: default StartAgent agent ID (beee4ef)
• api: remove project defaults API surface (f96e98e)

---

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions

[stainless-app]

🧪 Testing

To try out this version of the SDK:

pip install 'https://pkg.stainless.com/s/gitpod-python/97913bf54c101cce3026b8fec0d1afde1f9d0c0d/gitpod_sdk-0.11.0-py3-none-any.whl'

Expires at: Sat, 29 Aug 2026 18:21:02 GMT
Updated at: Thu, 30 Jul 2026 18:21:02 GMT

[stainless-app]

🤖 Release is at https://github.com/gitpod-io/gitpod-sdk-python/releases/tag/v0.12.0 🌻