@onkernel/sdk 0.2.0 → 0.4.0

package/src/client.ts

@@ -23,6 +23,9 @@ import { FinalRequestOptions, RequestOptions } from './internal/request-options'
 import {
   BrowserCreateParams,
   BrowserCreateResponse,
+  BrowserDeleteParams,
+  BrowserListResponse,
+  BrowserPersistence,
   BrowserRetrieveResponse,
   Browsers,
 } from './resources/browsers';
@@ -744,8 +747,11 @@ export declare namespace Kernel {
 
   export {
     Browsers as Browsers,
+    type BrowserPersistence as BrowserPersistence,
     type BrowserCreateResponse as BrowserCreateResponse,
     type BrowserRetrieveResponse as BrowserRetrieveResponse,
+    type BrowserListResponse as BrowserListResponse,
     type BrowserCreateParams as BrowserCreateParams,
+    type BrowserDeleteParams as BrowserDeleteParams,
   };
 }

package/src/resources/apps/apps.ts

@@ -13,6 +13,8 @@ import {
   InvocationCreateParams,
   InvocationCreateResponse,
   InvocationRetrieveResponse,
+  InvocationUpdateParams,
+  InvocationUpdateResponse,
   Invocations,
 } from './invocations';
 import { APIPromise } from '../../core/api-promise';
@@ -99,6 +101,8 @@ export declare namespace Apps {
     Invocations as Invocations,
     type InvocationCreateResponse as InvocationCreateResponse,
     type InvocationRetrieveResponse as InvocationRetrieveResponse,
+    type InvocationUpdateResponse as InvocationUpdateResponse,
     type InvocationCreateParams as InvocationCreateParams,
+    type InvocationUpdateParams as InvocationUpdateParams,
   };
 }

package/src/resources/apps/index.ts

@@ -11,5 +11,7 @@ export {
   Invocations,
   type InvocationCreateResponse,
   type InvocationRetrieveResponse,
+  type InvocationUpdateResponse,
   type InvocationCreateParams,
+  type InvocationUpdateParams,
 } from './invocations';

package/src/resources/apps/invocations.ts

@@ -28,13 +28,32 @@ export class Invocations extends APIResource {
    * @example
    * ```ts
    * const invocation = await client.apps.invocations.retrieve(
-   *   'ckqwer3o20000jb9s7abcdef',
+   *   'rr33xuugxj9h0bkf1rdt2bet',
    * );
    * ```
    */
   retrieve(id: string, options?: RequestOptions): APIPromise<InvocationRetrieveResponse> {
     return this._client.get(path`/invocations/${id}`, options);
   }
+
+  /**
+   * Update invocation status or output
+   *
+   * @example
+   * ```ts
+   * const invocation = await client.apps.invocations.update(
+   *   'id',
+   *   { status: 'succeeded' },
+   * );
+   * ```
+   */
+  update(
+    id: string,
+    body: InvocationUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<InvocationUpdateResponse> {
+    return this._client.patch(path`/invocations/${id}`, { body, ...options });
+  }
 }
 
 export interface InvocationCreateResponse {
@@ -109,6 +128,55 @@ export interface InvocationRetrieveResponse {
   status_reason?: string;
 }
 
+export interface InvocationUpdateResponse {
+  /**
+   * ID of the invocation
+   */
+  id: string;
+
+  /**
+   * Name of the action invoked
+   */
+  action_name: string;
+
+  /**
+   * Name of the application
+   */
+  app_name: string;
+
+  /**
+   * RFC 3339 Nanoseconds timestamp when the invocation started
+   */
+  started_at: string;
+
+  /**
+   * Status of the invocation
+   */
+  status: 'queued' | 'running' | 'succeeded' | 'failed';
+
+  /**
+   * RFC 3339 Nanoseconds timestamp when the invocation finished (null if still
+   * running)
+   */
+  finished_at?: string | null;
+
+  /**
+   * Output produced by the action, rendered as a JSON string. This could be: string,
+   * number, boolean, array, object, or null.
+   */
+  output?: string;
+
+  /**
+   * Payload provided to the invocation. This is a string that can be parsed as JSON.
+   */
+  payload?: string;
+
+  /**
+   * Status reason
+   */
+  status_reason?: string;
+}
+
 export interface InvocationCreateParams {
   /**
    * Name of the action to invoke
@@ -125,16 +193,36 @@ export interface InvocationCreateParams {
    */
   version: string;
 
+  /**
+   * If true, invoke asynchronously. When set, the API responds 202 Accepted with
+   * status "queued".
+   */
+  async?: boolean;
+
   /**
    * Input data for the action, sent as a JSON string.
    */
   payload?: string;
 }
 
+export interface InvocationUpdateParams {
+  /**
+   * New status for the invocation.
+   */
+  status: 'succeeded' | 'failed';
+
+  /**
+   * Updated output of the invocation rendered as JSON string.
+   */
+  output?: string;
+}
+
 export declare namespace Invocations {
   export {
     type InvocationCreateResponse as InvocationCreateResponse,
     type InvocationRetrieveResponse as InvocationRetrieveResponse,
+    type InvocationUpdateResponse as InvocationUpdateResponse,
     type InvocationCreateParams as InvocationCreateParams,
+    type InvocationUpdateParams as InvocationUpdateParams,
   };
 }

package/src/resources/browsers.ts

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
+import * as BrowsersAPI from './browsers';
 import { APIPromise } from '../core/api-promise';
+import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
@@ -12,7 +14,7 @@ export class Browsers extends APIResource {
    * @example
    * ```ts
    * const browser = await client.browsers.create({
-   *   invocation_id: 'ckqwer3o20000jb9s7abcdef',
+   *   invocation_id: 'rr33xuugxj9h0bkf1rdt2bet',
    * });
    * ```
    */
@@ -26,13 +28,71 @@ export class Browsers extends APIResource {
    * @example
    * ```ts
    * const browser = await client.browsers.retrieve(
-   *   'e5bf36fe-9247-4e2b-8b5a-2f594cc1c073',
+   *   'htzv5orfit78e1m2biiifpbv',
    * );
    * ```
    */
   retrieve(id: string, options?: RequestOptions): APIPromise<BrowserRetrieveResponse> {
     return this._client.get(path`/browsers/${id}`, options);
   }
+
+  /**
+   * List active browser sessions for the authenticated user
+   *
+   * @example
+   * ```ts
+   * const browsers = await client.browsers.list();
+   * ```
+   */
+  list(options?: RequestOptions): APIPromise<BrowserListResponse> {
+    return this._client.get('/browsers', options);
+  }
+
+  /**
+   * Delete a persistent browser session by persistent_id query parameter.
+   *
+   * @example
+   * ```ts
+   * await client.browsers.delete({
+   *   persistent_id: 'persistent_id',
+   * });
+   * ```
+   */
+  delete(params: BrowserDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { persistent_id } = params;
+    return this._client.delete('/browsers', {
+      query: { persistent_id },
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Delete Browser Session by ID
+   *
+   * @example
+   * ```ts
+   * await client.browsers.deleteByID(
+   *   'htzv5orfit78e1m2biiifpbv',
+   * );
+   * ```
+   */
+  deleteByID(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/browsers/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+/**
+ * Optional persistence configuration for the browser session.
+ */
+export interface BrowserPersistence {
+  /**
+   * Unique identifier for the persistent browser session.
+   */
+  id: string;
 }
 
 export interface BrowserCreateResponse {
@@ -50,6 +110,11 @@ export interface BrowserCreateResponse {
    * Unique identifier for the browser session
    */
   session_id: string;
+
+  /**
+   * Optional persistence configuration for the browser session.
+   */
+  persistence?: BrowserPersistence;
 }
 
 export interface BrowserRetrieveResponse {
@@ -67,6 +132,37 @@ export interface BrowserRetrieveResponse {
    * Unique identifier for the browser session
    */
   session_id: string;
+
+  /**
+   * Optional persistence configuration for the browser session.
+   */
+  persistence?: BrowserPersistence;
+}
+
+export type BrowserListResponse = Array<BrowserListResponse.BrowserListResponseItem>;
+
+export namespace BrowserListResponse {
+  export interface BrowserListResponseItem {
+    /**
+     * Remote URL for live viewing the browser session
+     */
+    browser_live_view_url: string;
+
+    /**
+     * Websocket URL for Chrome DevTools Protocol connections to the browser session
+     */
+    cdp_ws_url: string;
+
+    /**
+     * Unique identifier for the browser session
+     */
+    session_id: string;
+
+    /**
+     * Optional persistence configuration for the browser session.
+     */
+    persistence?: BrowsersAPI.BrowserPersistence;
+  }
 }
 
 export interface BrowserCreateParams {
@@ -74,12 +170,27 @@ export interface BrowserCreateParams {
    * action invocation ID
    */
   invocation_id: string;
+
+  /**
+   * Optional persistence configuration for the browser session.
+   */
+  persistence?: BrowserPersistence;
+}
+
+export interface BrowserDeleteParams {
+  /**
+   * Persistent browser identifier
+   */
+  persistent_id: string;
 }
 
 export declare namespace Browsers {
   export {
+    type BrowserPersistence as BrowserPersistence,
     type BrowserCreateResponse as BrowserCreateResponse,
     type BrowserRetrieveResponse as BrowserRetrieveResponse,
+    type BrowserListResponse as BrowserListResponse,
     type BrowserCreateParams as BrowserCreateParams,
+    type BrowserDeleteParams as BrowserDeleteParams,
   };
 }

package/src/resources/index.ts

@@ -3,7 +3,10 @@
 export { Apps, type AppListResponse, type AppListParams } from './apps/apps';
 export {
   Browsers,
+  type BrowserPersistence,
   type BrowserCreateResponse,
   type BrowserRetrieveResponse,
+  type BrowserListResponse,
   type BrowserCreateParams,
+  type BrowserDeleteParams,
 } from './browsers';

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.2.0'; // x-release-please-version
+export const VERSION = '0.4.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.2.0";
+export declare const VERSION = "0.4.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.2.0";
+export declare const VERSION = "0.4.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.2.0'; // x-release-please-version
+exports.VERSION = '0.4.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.2.0'; // x-release-please-version
+export const VERSION = '0.4.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map