Skip to content

Commit 6f1eaf2

Browse files
stainless-app[bot]stainless-app[bot]
authored
release: 0.11.0 (#90)
* codegen metadata * codegen metadata * codegen metadata * feat(api): add announcement banner fields to organization proto * feat(api): implement GetAnnouncementBanner and UpdateAnnouncementBanner handlers * feat(api): add filters to ListPrebuilds for inventory page * codegen metadata * chore(ci): upgrade `actions/github-script` * feat: Introduce projects admin org role * codegen metadata * codegen metadata * feat(cli): add --name flag to environment create command * codegen metadata * feat: [backend] Resource admin should be able to see all resource shares * feat(runner): add capability check for ListSCMOrganizations * codegen metadata * feat: [SCIM] Configurable token expiration duration * codegen metadata * feat(db): add service_account_tokens table * feat(chat): add Pylon identity verification for chat widget * feat(api): remove getChatIdentityToken from accounts * feat(api): add RESOURCE_TYPE_ROLE_ASSIGNMENT to ResourceType enum * feat(api): add devRunnerId to agents, devEnvironmentId and provider enum to runners * codegen metadata * feat(api): add annotations field to agents metadata, filtering, and start params * feat(api): add derivedFromOrgRole field to groups RoleAssignment model * feat(api): add mcp integration status to agent execution * feat(api): add userIds parameter to organizations list members method * feat(api): add RESOURCE_ROLE_ORG_AUTOMATIONS_ADMIN to ResourceRole enum * feat(api): add RESOURCE_ROLE_ORG_GROUPS_ADMIN to ResourceRole enum * codegen metadata * fix(client): avoid memory leak with abort signals * codegen metadata * chore(client): do not parse responses with empty content-length * docs(api): update filePath parameter documentation in secrets * codegen metadata * codegen metadata * codegen metadata * codegen metadata * feat(api): add restrictAccountCreationToScim field to organizations policies * chore(client): restructure abort controller binding * codegen metadata * feat(api): add port access methods and organization admission level to environments * fix(client): avoid removing abort listener too early * chore(internal): fix pagination internals not accepting option promises * feat(api): add OPUS_4_6 and OPUS_4_6_EXTENDED model options to agents * feat(api): add executable_deny_list to environments and organization policies * feat(api): add scope field to environment secrets * codegen metadata * codegen metadata * docs(api): clarify port_sharing_disabled behavior in organization policy * feat(api): add additionalScopes field to sso-configurations * codegen metadata * codegen metadata * feat(api): add warm pools sub-resource to prebuilds with CRUD operations * codegen metadata * feat(api): add exclude_group_id filter to organizations listMembers * codegen metadata * codegen metadata * release: 0.11.0 --------- Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>
1 parent 3b1b2c9 commit 6f1eaf2

29 files changed

Lines changed: 680 additions & 26 deletions

‎.github/workflows/ci.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ jobs:
5757
- name: Get GitHub OIDC Token
5858
if: github.repository == 'stainless-sdks/gitpod-typescript'
5959
id: github-oidc
60-
uses: actions/github-script@00f12e3e20659f42342b1c0226afda7f7c042325 # v6
60+
uses: actions/github-script@v8
6161
with:
6262
script: core.setOutput('github_token', await core.getIDToken());
6363

‎.release-please-manifest.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
{
2-
".": "0.10.0"
2+
".": "0.11.0"
33
}

‎.stats.yml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
configured_endpoints: 170
2-
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-2423c089f280cdf34a987d40531692097a69f4aa971c6adf9aeec4fd7984cec2.yml
3-
openapi_spec_hash: 24037c3ab9ceca689150d07ecec7aa80
4-
config_hash: d726afb2a92132197e4eae04303e8041
1+
configured_endpoints: 172
2+
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-b97dcde84128bcf3740b0cf3c2c005e1dcd1cdac9b0768a28bd734f8d83c9fa2.yml
3+
openapi_spec_hash: 1172889d2eb3f0453514c6caae3459b3
4+
config_hash: 49d499b8ab46cede0e3461ef7cd549ca

‎CHANGELOG.md‎

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,59 @@
11
# Changelog
22

3+
## 0.11.0 (2026-02-11)
4+
5+
Full Changelog: [v0.10.0...v0.11.0](https://github.com/gitpod-io/gitpod-sdk-typescript/compare/v0.10.0...v0.11.0)
6+
7+
### Features
8+
9+
* [backend] Resource admin should be able to see all resource shares ([3554dd2](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/3554dd27b3c8705f8c4924ecb455902cf588fdb2))
10+
* [SCIM] Configurable token expiration duration ([cc92f75](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/cc92f75b9e66df803ba991cf99e7ee3d3d780660))
11+
* **api:** add additionalScopes field to sso-configurations ([27a22de](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/27a22de73c4f16272bd25291f49ad97fcc0a5a80))
12+
* **api:** add annotations field to agents metadata, filtering, and start params ([0f06d99](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/0f06d99feaad1ab5767a11054e8152d0ac11cb1a))
13+
* **api:** add announcement banner fields to organization proto ([2456204](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/2456204c95d6c25e38375e778d13c847c9e8d521))
14+
* **api:** add derivedFromOrgRole field to groups RoleAssignment model ([c8569bf](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/c8569bf65b910a2ec09054b37922a7f235801dac))
15+
* **api:** add devRunnerId to agents, devEnvironmentId and provider enum to runners ([b5ec4b9](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/b5ec4b9cad5c7f45eecbaa2b4f8db4e3ce86b2eb))
16+
* **api:** add exclude_group_id filter to organizations listMembers ([7842c1b](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/7842c1be5997a74c0dd342ca8791c014ec01dc4c))
17+
* **api:** add executable_deny_list to environments and organization policies ([4c56fef](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/4c56fef567186a390be111790fc9ebe4f0890f01))
18+
* **api:** add filters to ListPrebuilds for inventory page ([f338330](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/f3383301646f5548e7cc3cc2498dd162e1b64eef))
19+
* **api:** add mcp integration status to agent execution ([3aa82d4](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/3aa82d4ce924b9042882a6ab73ebdf5efeccbf71))
20+
* **api:** add OPUS_4_6 and OPUS_4_6_EXTENDED model options to agents ([71a7da8](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/71a7da87e8a14625d581de3dc263084408929d17))
21+
* **api:** add port access methods and organization admission level to environments ([8e135fc](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/8e135fcaa594dc41275c685dfa5f2b55ac9905bd))
22+
* **api:** add RESOURCE_ROLE_ORG_AUTOMATIONS_ADMIN to ResourceRole enum ([0158475](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/01584759838decfa20131da3951cdafe391434af))
23+
* **api:** add RESOURCE_ROLE_ORG_GROUPS_ADMIN to ResourceRole enum ([49a9e2e](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/49a9e2e45fb872a0558eeb36a173bc4884f9cdd2))
24+
* **api:** add RESOURCE_TYPE_ROLE_ASSIGNMENT to ResourceType enum ([b3fa661](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/b3fa6617ebcf629042e2149ec77e820b77d411e4))
25+
* **api:** add restrictAccountCreationToScim field to organizations policies ([03af733](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/03af733583acbec602e1fd3135265b22b054ec50))
26+
* **api:** add scope field to environment secrets ([f7f7d59](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/f7f7d5958bcfff764496180b196ad091398bbba4))
27+
* **api:** add userIds parameter to organizations list members method ([abf8b99](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/abf8b99d209ab44ad111d0cfb288e4d4f4b0ed58))
28+
* **api:** add warm pools sub-resource to prebuilds with CRUD operations ([0dd1669](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/0dd1669a90e1d26622f7d8bdee0fcc1c01b2bf1d))
29+
* **api:** implement GetAnnouncementBanner and UpdateAnnouncementBanner handlers ([fe9a63c](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/fe9a63c54dfabeff679a9e1c050a47706539cbd7))
30+
* **api:** remove getChatIdentityToken from accounts ([8d245cd](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/8d245cdc8c902c931a3576bd077e8b948af128e4))
31+
* **chat:** add Pylon identity verification for chat widget ([c854d9a](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/c854d9ab6e97ca02a7382cee062fece872854443))
32+
* **cli:** add --name flag to environment create command ([bd242aa](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/bd242aad382a2b6057352ac61e7ad29c81068989))
33+
* **db:** add service_account_tokens table ([02e87ef](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/02e87ef50c5a0a6e64bb8da9d8c2e0edc540ad31))
34+
* Introduce projects admin org role ([0ac01e0](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/0ac01e08a99e26ccc8bfac456771983a9d5c61b7))
35+
* **runner:** add capability check for ListSCMOrganizations ([bbcd73a](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/bbcd73af7862f8c68ee89dbbb85500f5a7e7a9f8))
36+
37+
38+
### Bug Fixes
39+
40+
* **client:** avoid memory leak with abort signals ([50c52c4](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/50c52c48613a28225b7159baa3bbbffc0058b575))
41+
* **client:** avoid removing abort listener too early ([355cba0](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/355cba0036cd98971455a407b048c75a545eb7c2))
42+
43+
44+
### Chores
45+
46+
* **ci:** upgrade `actions/github-script` ([2fe9a43](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/2fe9a432dda237d7a7aa89691a692c235db65c12))
47+
* **client:** do not parse responses with empty content-length ([7fb7af3](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/7fb7af3bf3d6fe18f351c5295b47dacea56c52bd))
48+
* **client:** restructure abort controller binding ([920167a](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/920167a458c06f43b695ba73e22198ab86616af9))
49+
* **internal:** fix pagination internals not accepting option promises ([1fb2b1e](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/1fb2b1ed9f7522d70cfa661991f6c5896b290ae3))
50+
51+
52+
### Documentation
53+
54+
* **api:** clarify port_sharing_disabled behavior in organization policy ([daac9e5](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/daac9e5a5dca952167ab4d09e736c82bfae1cbe9))
55+
* **api:** update filePath parameter documentation in secrets ([a63aedf](https://github.com/gitpod-io/gitpod-sdk-typescript/commit/a63aedf0b1f2e76ffa4b5bfafc69285fe93a555e))
56+
357
## 0.10.0 (2026-01-21)
458

559
Full Changelog: [v0.9.0...v0.10.0](https://github.com/gitpod-io/gitpod-sdk-typescript/compare/v0.9.0...v0.10.0)

‎api.md‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -115,6 +115,8 @@ Types:
115115
- <code><a href="./src/resources/environments/environments.ts">EnvironmentRole</a></code>
116116
- <code><a href="./src/resources/environments/environments.ts">EnvironmentSpec</a></code>
117117
- <code><a href="./src/resources/environments/environments.ts">EnvironmentStatus</a></code>
118+
- <code><a href="./src/resources/environments/environments.ts">KernelControlsConfig</a></code>
119+
- <code><a href="./src/resources/environments/environments.ts">Veto</a></code>
118120
- <code><a href="./src/resources/environments/environments.ts">EnvironmentCreateResponse</a></code>
119121
- <code><a href="./src/resources/environments/environments.ts">EnvironmentRetrieveResponse</a></code>
120122
- <code><a href="./src/resources/environments/environments.ts">EnvironmentUpdateResponse</a></code>
@@ -355,6 +357,19 @@ Methods:
355357
- <code title="post /gitpod.v1.OrganizationService/ListMembers">client.organizations.<a href="./src/resources/organizations/organizations.ts">listMembers</a>({ ...params }) -> OrganizationMembersMembersPage</code>
356358
- <code title="post /gitpod.v1.OrganizationService/SetRole">client.organizations.<a href="./src/resources/organizations/organizations.ts">setRole</a>({ ...params }) -> unknown</code>
357359

360+
## AnnouncementBanner
361+
362+
Types:
363+
364+
- <code><a href="./src/resources/organizations/announcement-banner.ts">AnnouncementBanner</a></code>
365+
- <code><a href="./src/resources/organizations/announcement-banner.ts">AnnouncementBannerUpdateResponse</a></code>
366+
- <code><a href="./src/resources/organizations/announcement-banner.ts">AnnouncementBannerGetResponse</a></code>
367+
368+
Methods:
369+
370+
- <code title="post /gitpod.v1.OrganizationService/UpdateAnnouncementBanner">client.organizations.announcementBanner.<a href="./src/resources/organizations/announcement-banner.ts">update</a>({ ...params }) -> AnnouncementBannerUpdateResponse</code>
371+
- <code title="post /gitpod.v1.OrganizationService/GetAnnouncementBanner">client.organizations.announcementBanner.<a href="./src/resources/organizations/announcement-banner.ts">get</a>({ ...params }) -> AnnouncementBannerGetResponse</code>
372+
358373
## CustomDomains
359374

360375
Types:
@@ -413,6 +428,7 @@ Types:
413428

414429
- <code><a href="./src/resources/organizations/policies.ts">AgentPolicy</a></code>
415430
- <code><a href="./src/resources/organizations/policies.ts">CrowdStrikeConfig</a></code>
431+
- <code><a href="./src/resources/organizations/policies.ts">ExecutableDenyList</a></code>
416432
- <code><a href="./src/resources/organizations/policies.ts">OrganizationPolicies</a></code>
417433
- <code><a href="./src/resources/organizations/policies.ts">SecurityAgentPolicy</a></code>
418434
- <code><a href="./src/resources/organizations/policies.ts">PolicyRetrieveResponse</a></code>
@@ -447,6 +463,7 @@ Methods:
447463

448464
Types:
449465

466+
- <code><a href="./src/resources/organizations/sso-configurations.ts">AdditionalScopesUpdate</a></code>
450467
- <code><a href="./src/resources/organizations/sso-configurations.ts">ProviderType</a></code>
451468
- <code><a href="./src/resources/organizations/sso-configurations.ts">SSOConfiguration</a></code>
452469
- <code><a href="./src/resources/organizations/sso-configurations.ts">SSOConfigurationState</a></code>

‎package.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@gitpod/sdk",
3-
"version": "0.10.0",
3+
"version": "0.11.0",
44
"description": "The official TypeScript library for the Gitpod API",
55
"author": "Gitpod <dev-feedback@gitpod.com>",
66
"types": "dist/index.d.ts",

‎src/client.ts‎

Lines changed: 21 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -260,6 +260,8 @@ import {
260260
EnvironmentUpdateResponse,
261261
Environments,
262262
EnvironmentsEnvironmentsPage,
263+
KernelControlsConfig,
264+
Veto,
263265
} from './resources/environments/environments';
264266
import {
265267
Group,
@@ -832,17 +834,22 @@ export class Gitpod {
832834
getAPIList<Item, PageClass extends Pagination.AbstractPage<Item> = Pagination.AbstractPage<Item>>(
833835
path: string,
834836
Page: new (...args: any[]) => PageClass,
835-
opts?: RequestOptions,
837+
opts?: PromiseOrValue<RequestOptions>,
836838
): Pagination.PagePromise<PageClass, Item> {
837-
return this.requestAPIList(Page, { method: 'get', path, ...opts });
839+
return this.requestAPIList(
840+
Page,
841+
opts && 'then' in opts ?
842+
opts.then((opts) => ({ method: 'get', path, ...opts }))
843+
: { method: 'get', path, ...opts },
844+
);
838845
}
839846

840847
requestAPIList<
841848
Item = unknown,
842849
PageClass extends Pagination.AbstractPage<Item> = Pagination.AbstractPage<Item>,
843850
>(
844851
Page: new (...args: ConstructorParameters<typeof Pagination.AbstractPage>) => PageClass,
845-
options: FinalRequestOptions,
852+
options: PromiseOrValue<FinalRequestOptions>,
846853
): Pagination.PagePromise<PageClass, Item> {
847854
const request = this.makeRequest(options, null, undefined);
848855
return new Pagination.PagePromise<PageClass, Item>(this as any as Gitpod, request, Page);
@@ -855,9 +862,10 @@ export class Gitpod {
855862
controller: AbortController,
856863
): Promise<Response> {
857864
const { signal, method, ...options } = init || {};
858-
if (signal) signal.addEventListener('abort', () => controller.abort());
865+
const abort = this._makeAbort(controller);
866+
if (signal) signal.addEventListener('abort', abort, { once: true });
859867

860-
const timeout = setTimeout(() => controller.abort(), ms);
868+
const timeout = setTimeout(abort, ms);
861869

862870
const isReadableBody =
863871
((globalThis as any).ReadableStream && options.body instanceof (globalThis as any).ReadableStream) ||
@@ -1024,6 +1032,12 @@ export class Gitpod {
10241032
return headers.values;
10251033
}
10261034

1035+
private _makeAbort(controller: AbortController) {
1036+
// note: we can't just inline this method inside `fetchWithTimeout()` because then the closure
1037+
// would capture all request options, and cause a memory leak.
1038+
return () => controller.abort();
1039+
}
1040+
10271041
private buildBody({ options: { body, headers: rawHeaders } }: { options: FinalRequestOptions }): {
10281042
bodyHeaders: HeadersLike;
10291043
body: BodyInit | undefined;
@@ -1331,6 +1345,8 @@ export declare namespace Gitpod {
13311345
type EnvironmentRole as EnvironmentRole,
13321346
type EnvironmentSpec as EnvironmentSpec,
13331347
type EnvironmentStatus as EnvironmentStatus,
1348+
type KernelControlsConfig as KernelControlsConfig,
1349+
type Veto as Veto,
13341350
type EnvironmentCreateResponse as EnvironmentCreateResponse,
13351351
type EnvironmentRetrieveResponse as EnvironmentRetrieveResponse,
13361352
type EnvironmentUpdateResponse as EnvironmentUpdateResponse,

‎src/internal/parse.ts‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,12 @@ export async function defaultParseResponse<T>(client: Gitpod, props: APIResponse
2929
const mediaType = contentType?.split(';')[0]?.trim();
3030
const isJSON = mediaType?.includes('application/json') || mediaType?.endsWith('+json');
3131
if (isJSON) {
32+
const contentLength = response.headers.get('content-length');
33+
if (contentLength === '0') {
34+
// if there is no content we can't do anything
35+
return undefined as T;
36+
}
37+
3238
const json = await response.json();
3339
return json as T;
3440
}

‎src/resources/agents.ts‎

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -498,6 +498,11 @@ export namespace AgentExecution {
498498
* Gitpod to function
499499
*/
500500
export interface Metadata {
501+
/**
502+
* annotations are key-value pairs for tracking external context.
503+
*/
504+
annotations?: { [key: string]: string };
505+
501506
/**
502507
* A Timestamp represents a point in time independent of any time zone or local
503508
* calendar, encoded as a count of seconds and fractions of seconds at nanosecond
@@ -796,6 +801,12 @@ export namespace AgentExecution {
796801
*/
797802
judgement?: string;
798803

804+
/**
805+
* mcp_integration_statuses contains the status of all MCP integrations used by
806+
* this agent execution
807+
*/
808+
mcpIntegrationStatuses?: Array<Status.McpIntegrationStatus>;
809+
799810
/**
800811
* mode is the current operational mode of the agent execution. This is set by the
801812
* agent when entering different modes (e.g., Ralph mode via /ona:ralph command).
@@ -843,6 +854,8 @@ export namespace AgentExecution {
843854
| 'SUPPORTED_MODEL_OPUS_4_EXTENDED'
844855
| 'SUPPORTED_MODEL_OPUS_4_5'
845856
| 'SUPPORTED_MODEL_OPUS_4_5_EXTENDED'
857+
| 'SUPPORTED_MODEL_OPUS_4_6'
858+
| 'SUPPORTED_MODEL_OPUS_4_6_EXTENDED'
846859
| 'SUPPORTED_MODEL_OPENAI_4O'
847860
| 'SUPPORTED_MODEL_OPENAI_4O_MINI'
848861
| 'SUPPORTED_MODEL_OPENAI_O1'
@@ -895,6 +908,43 @@ export namespace AgentExecution {
895908
}
896909
}
897910

911+
/**
912+
* MCPIntegrationStatus represents the status of a single MCP integration within an
913+
* agent execution context
914+
*/
915+
export interface McpIntegrationStatus {
916+
/**
917+
* id is the unique name of the MCP integration
918+
*/
919+
id?: string;
920+
921+
/**
922+
* failure_message contains the reason the MCP integration failed to connect or
923+
* operate
924+
*/
925+
failureMessage?: string;
926+
927+
/**
928+
* name is the unique name of the MCP integration (e.g., "linear", "notion")
929+
*/
930+
name?: string;
931+
932+
/**
933+
* phase is the current connection/health phase
934+
*/
935+
phase?:
936+
| 'MCP_INTEGRATION_PHASE_UNSPECIFIED'
937+
| 'MCP_INTEGRATION_PHASE_INITIALIZING'
938+
| 'MCP_INTEGRATION_PHASE_READY'
939+
| 'MCP_INTEGRATION_PHASE_FAILED'
940+
| 'MCP_INTEGRATION_PHASE_UNAVAILABLE';
941+
942+
/**
943+
* warning_message contains warnings (e.g., rate limiting, degraded performance)
944+
*/
945+
warningMessage?: string;
946+
}
947+
898948
export interface Outputs {
899949
boolValue?: boolean;
900950

@@ -1313,6 +1363,12 @@ export namespace AgentListExecutionsParams {
13131363
export interface Filter {
13141364
agentIds?: Array<string>;
13151365

1366+
/**
1367+
* annotations filters by key-value pairs. Only executions containing all specified
1368+
* annotations (with matching values) are returned.
1369+
*/
1370+
annotations?: { [key: string]: string };
1371+
13161372
creatorIds?: Array<string>;
13171373

13181374
environmentIds?: Array<string>;
@@ -1400,6 +1456,13 @@ export interface AgentSendToExecutionParams {
14001456
export interface AgentStartExecutionParams {
14011457
agentId?: string;
14021458

1459+
/**
1460+
* annotations are key-value pairs for tracking external context (e.g., Linear
1461+
* session IDs, GitHub issue references). Keys should follow domain/name convention
1462+
* (e.g., "linear.app/session-id").
1463+
*/
1464+
annotations?: { [key: string]: string };
1465+
14031466
codeContext?: AgentCodeContext;
14041467

14051468
/**
@@ -1410,6 +1473,13 @@ export interface AgentStartExecutionParams {
14101473

14111474
name?: string;
14121475

1476+
/**
1477+
* runner_id specifies a runner for this agent execution. When set, the agent
1478+
* execution is routed to this runner instead of the runner associated with the
1479+
* environment.
1480+
*/
1481+
runnerId?: string;
1482+
14131483
/**
14141484
* workflow_action_id is an optional reference to the workflow execution action
14151485
* that created this agent execution. Used for tracking and event correlation.

0 commit comments

Comments
 (0)