feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 116
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-d854bc81e0a99171716893e6790a87ba350bb6fc778f8e3244abdd47d5c252c3.yml
-openapi_spec_hash: 5189220e4712a7b0cdd35beba2ebb47d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-2e6ddfc9da00e33fcf13baf0b67012b97f051fa986658ff114fde989e56caa94.yml
+openapi_spec_hash: 5af02ea2008312d609394e548756e761
 config_hash: 60929489bdc1eaf979e7ef74fdd17b94

src/resources/runners/runners.ts

@@ -375,6 +375,13 @@ export interface RunnerConfiguration {
    */
   autoUpdate?: boolean;
 
+  /**
+   * devcontainer_image_cache_enabled controls whether the devcontainer build cache
+   * is enabled for this runner. Only takes effect on supported runners, currently
+   * only AWS EC2 runners.
+   */
+  devcontainerImageCacheEnabled?: boolean;
+
   /**
    * log_level is the log level for the runner
    */
@@ -705,6 +712,12 @@ export namespace RunnerUpdateParams {
        */
       autoUpdate?: boolean | null;
 
+      /**
+       * devcontainer_image_cache_enabled controls whether the shared devcontainer build
+       * cache is enabled for this runner.
+       */
+      devcontainerImageCacheEnabled?: boolean | null;
+
       /**
        * log_level is the log level for the runner
        */

src/resources/secrets.ts

@@ -58,7 +58,38 @@ export class Secrets extends APIResource {
   }
 
   /**
-   * ListSecrets
+   * Lists secrets
+   *
+   * Use this method to:
+   *
+   * - View all project secrets
+   * - View all user secrets
+   *
+   * ### Examples
+   *
+   * - List project secrets:
+   *
+   *   Shows all secrets for a project.
+   *
+   *   ```yaml
+   *   filter:
+   *     scope:
+   *       projectId: "b0e12f6c-4c67-429d-a4a6-d9838b5da047"
+   *   pagination:
+   *     pageSize: 20
+   *   ```
+   *
+   * - List user secrets:
+   *
+   *   Shows all secrets for a user.
+   *
+   *   ```yaml
+   *   filter:
+   *     scope:
+   *       userId: "123e4567-e89b-12d3-a456-426614174000"
+   *   pagination:
+   *     pageSize: 20
+   *   ```
    */
   list(params: SecretListParams, options?: RequestOptions): PagePromise<SecretsSecretsPage, Secret> {
     const { token, pageSize, ...body } = params;

src/resources/usage.ts

@@ -6,10 +6,29 @@ import { RequestOptions } from '../internal/request-options';
 
 export class Usage extends APIResource {
   /**
-   * Lists environment sessions within a specified date range.
+   * Lists completed environment sessions within a specified date range.
    *
-   * Returns a list of environment sessions that were active within the specified
-   * date range.
+   * Returns a list of environment sessions that were completed within the specified
+   * date range. Currently running sessions are not included.
+   *
+   * Use this method to:
+   *
+   * - View environment sessions
+   * - Filter by project
+   * - Monitor session activity
+   * - Create custom usage reports
+   *
+   * ### Example
+   *
+   * ```yaml
+   * filter:
+   *   projectId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
+   *   dateRange:
+   *     startTime: "2024-01-01T00:00:00Z"
+   *     endTime: "2024-01-02T00:00:00Z"
+   * pagination:
+   *   pageSize: 100
+   * ```
    */
   listEnvironmentSessions(
     params: UsageListEnvironmentSessionsParams,
@@ -48,7 +67,7 @@ export interface EnvironmentSession {
   environmentId?: string;
 
   /**
-   * Project ID associated with the session.
+   * Project ID associated with the session (if available).
    */
   projectId?: string;
 
@@ -63,7 +82,7 @@ export interface EnvironmentSession {
   stoppedAt?: string;
 
   /**
-   * User ID who created the session.
+   * User ID that created the session.
    */
   userId?: string;
 }