feat(api): update via SDK Studio

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 3
+configured_endpoints: 4
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-d168b58fcf39dbd0458d132091793d3e2d0930070b7dda2d5f7f1baff20dd31b.yml
 openapi_spec_hash: b7e0fd7ee1656d7dbad57209d1584d92
-config_hash: 9139d1eb064baf60fd2265aac382f097
+config_hash: eab40627b734534462ae3b8ccd8b263b

api.md

@@ -4,11 +4,13 @@ Types:
 
 - <code><a href="./src/resources/apps.ts">AppDeployResponse</a></code>
 - <code><a href="./src/resources/apps.ts">AppInvokeResponse</a></code>
+- <code><a href="./src/resources/apps.ts">AppRetrieveInvocationResponse</a></code>
 
 Methods:
 
 - <code title="post /apps/deploy">client.apps.<a href="./src/resources/apps.ts">deploy</a>({ ...params }) -> AppDeployResponse</code>
 - <code title="post /apps/invoke">client.apps.<a href="./src/resources/apps.ts">invoke</a>({ ...params }) -> AppInvokeResponse</code>
+- <code title="get /apps/invocations/{id}">client.apps.<a href="./src/resources/apps.ts">retrieveInvocation</a>(id) -> AppRetrieveInvocationResponse</code>
 
 # Browser
 

src/client.ts

@@ -25,6 +25,7 @@ import {
   AppDeployResponse,
   AppInvokeParams,
   AppInvokeResponse,
+  AppRetrieveInvocationResponse,
   Apps,
 } from './resources/apps';
 import { Browser, BrowserCreateSessionResponse } from './resources/browser';
@@ -745,6 +746,7 @@ export declare namespace Kernel {
     Apps as Apps,
     type AppDeployResponse as AppDeployResponse,
     type AppInvokeResponse as AppInvokeResponse,
+    type AppRetrieveInvocationResponse as AppRetrieveInvocationResponse,
     type AppDeployParams as AppDeployParams,
     type AppInvokeParams as AppInvokeParams,
   };

src/resources/apps.ts

@@ -5,6 +5,7 @@ import { APIPromise } from '../core/api-promise';
 import { type Uploadable } from '../core/uploads';
 import { RequestOptions } from '../internal/request-options';
 import { multipartFormRequestOptions } from '../internal/uploads';
+import { path } from '../internal/utils/path';
 
 export class Apps extends APIResource {
   /**
@@ -39,6 +40,20 @@ export class Apps extends APIResource {
   invoke(body: AppInvokeParams, options?: RequestOptions): APIPromise<AppInvokeResponse> {
     return this._client.post('/apps/invoke', { body, ...options });
   }
+
+  /**
+   * Get an app invocation by id
+   *
+   * @example
+   * ```ts
+   * const response = await client.apps.retrieveInvocation(
+   *   'ckqwer3o20000jb9s7abcdef',
+   * );
+   * ```
+   */
+  retrieveInvocation(id: string, options?: RequestOptions): APIPromise<AppRetrieveInvocationResponse> {
+    return this._client.get(path`/apps/invocations/${id}`, options);
+  }
 }
 
 export interface AppDeployResponse {
@@ -75,6 +90,22 @@ export interface AppInvokeResponse {
   output?: string;
 }
 
+export interface AppRetrieveInvocationResponse {
+  id: string;
+
+  appName: string;
+
+  finishedAt: string | null;
+
+  input: string;
+
+  output: string;
+
+  startedAt: string;
+
+  status: string;
+}
+
 export interface AppDeployParams {
   /**
    * Name of the application
@@ -123,6 +154,7 @@ export declare namespace Apps {
   export {
     type AppDeployResponse as AppDeployResponse,
     type AppInvokeResponse as AppInvokeResponse,
+    type AppRetrieveInvocationResponse as AppRetrieveInvocationResponse,
     type AppDeployParams as AppDeployParams,
     type AppInvokeParams as AppInvokeParams,
   };

src/resources/index.ts

@@ -4,6 +4,7 @@ export {
   Apps,
   type AppDeployResponse,
   type AppInvokeResponse,
+  type AppRetrieveInvocationResponse,
   type AppDeployParams,
   type AppInvokeParams,
 } from './apps';

tests/api-resources/apps.test.ts

@@ -60,4 +60,16 @@ describe('resource apps', () => {
       version: '1.0.0',
     });
   });
+
+  // skipped: tests are disabled for the time being
+  test.skip('retrieveInvocation', async () => {
+    const responsePromise = client.apps.retrieveInvocation('ckqwer3o20000jb9s7abcdef');
+    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);
+  });
 });