feat(api): update via SDK Studio

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 6
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-19b0d17ba368f32827ee322d15a7f4ff7e1f3bbf66606fad227b3465f8ffc5ab.yml
-openapi_spec_hash: 4a3cb766898e8a134ef99fe6c4c87736
-config_hash: 5b3919927cba9bf9dcc80458c199318d
+configured_endpoints: 7
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-c9d64df733f286f09d2203f4e3d820ce57e8d4c629c5e2db4e2bfac91fbc1598.yml
+openapi_spec_hash: fa407611fc566d55f403864fbfaa6c23
+config_hash: 4dfa4d870ce0e23e31ce33ab6a53dd21

api.md

@@ -1,5 +1,13 @@
 # Apps
 
+Types:
+
+- <code><a href="./src/resources/apps/apps.ts">AppListResponse</a></code>
+
+Methods:
+
+- <code title="get /apps">client.apps.<a href="./src/resources/apps/apps.ts">list</a>({ ...params }) -> AppListResponse</code>
+
 ## Deployments
 
 Types:

src/client.ts

@@ -30,7 +30,7 @@ import { readEnv } from './internal/utils/env';
 import { formatRequestDetails, loggerFor } from './internal/utils/log';
 import { isEmptyObj } from './internal/utils/values';
 import { KernelApp } from './core/app-framework';
-import { Apps } from './resources/apps/apps';
+import { AppListParams, AppListResponse, Apps } from './resources/apps/apps';
 
 const environments = {
   production: 'https://api.onkernel.com/',
@@ -740,7 +740,7 @@ Kernel.Browsers = Browsers;
 export declare namespace Kernel {
   export type RequestOptions = Opts.RequestOptions;
 
-  export { Apps as Apps };
+  export { Apps as Apps, type AppListResponse as AppListResponse, type AppListParams as AppListParams };
 
   export {
     Browsers as Browsers,

src/resources/apps/apps.ts

@@ -15,16 +15,79 @@ import {
   InvocationRetrieveResponse,
   Invocations,
 } from './invocations';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
 
 export class Apps extends APIResource {
   deployments: DeploymentsAPI.Deployments = new DeploymentsAPI.Deployments(this._client);
   invocations: InvocationsAPI.Invocations = new InvocationsAPI.Invocations(this._client);
+
+  /**
+   * List application versions for the authenticated user. Optionally filter by app
+   * name and/or version label.
+   *
+   * @example
+   * ```ts
+   * const apps = await client.apps.list();
+   * ```
+   */
+  list(query: AppListParams | null | undefined = {}, options?: RequestOptions): APIPromise<AppListResponse> {
+    return this._client.get('/apps', { query, ...options });
+  }
+}
+
+export type AppListResponse = Array<AppListResponse.AppListResponseItem>;
+
+export namespace AppListResponse {
+  /**
+   * Summary of an application version.
+   */
+  export interface AppListResponseItem {
+    /**
+     * Unique identifier for the app version
+     */
+    id: string;
+
+    /**
+     * Name of the application
+     */
+    app_name: string;
+
+    /**
+     * Deployment region code
+     */
+    region: string;
+
+    /**
+     * Version label for the application
+     */
+    version: string;
+
+    /**
+     * Environment variables configured for this app version
+     */
+    env_vars?: Record<string, string>;
+  }
+}
+
+export interface AppListParams {
+  /**
+   * Filter results by application name.
+   */
+  app_name?: string;
+
+  /**
+   * Filter results by version label.
+   */
+  version?: string;
 }
 
 Apps.Deployments = Deployments;
 Apps.Invocations = Invocations;
 
 export declare namespace Apps {
+  export { type AppListResponse as AppListResponse, type AppListParams as AppListParams };
+
   export {
     Deployments as Deployments,
     type DeploymentCreateResponse as DeploymentCreateResponse,

src/resources/apps/index.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Apps } from './apps';
+export { Apps, type AppListResponse, type AppListParams } from './apps';
 export {
   Deployments,
   type DeploymentCreateResponse,

src/resources/index.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Apps } from './apps/apps';
+export { Apps, type AppListResponse, type AppListParams } from './apps/apps';
 export {
   Browsers,
   type BrowserCreateResponse,

tests/api-resources/apps/apps.test.ts

@@ -0,0 +1,30 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import Kernel from '@onkernel/sdk';
+
+const client = new Kernel({
+  apiKey: 'My API Key',
+  baseURL: process.env['TEST_API_BASE_URL'] ?? 'http://127.0.0.1:4010',
+});
+
+describe('resource apps', () => {
+  // skipped: tests are disabled for the time being
+  test.skip('list', async () => {
+    const responsePromise = client.apps.list();
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
+
+  // skipped: tests are disabled for the time being
+  test.skip('list: request options and params are passed correctly', async () => {
+    // ensure the request options are being passed correctly by passing an invalid HTTP method in order to cause an error
+    await expect(
+      client.apps.list({ app_name: 'app_name', version: 'version' }, { path: '/_stainless_unknown_path' }),
+    ).rejects.toThrow(Kernel.NotFoundError);
+  });
+});