@onkernel/sdk 0.22.0 → 0.23.0

package/src/resources/agents/auth/index.ts

@@ -0,0 +1,24 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Auth,
+  type AgentAuthDiscoverResponse,
+  type AgentAuthInvocationResponse,
+  type AgentAuthSubmitResponse,
+  type AuthAgent,
+  type AuthAgentCreateRequest,
+  type AuthAgentInvocationCreateRequest,
+  type AuthAgentInvocationCreateResponse,
+  type DiscoveredField,
+  type AuthCreateParams,
+  type AuthListParams,
+  type AuthAgentsOffsetPagination,
+} from './auth';
+export {
+  Invocations,
+  type InvocationExchangeResponse,
+  type InvocationCreateParams,
+  type InvocationDiscoverParams,
+  type InvocationExchangeParams,
+  type InvocationSubmitParams,
+} from './invocations';

package/src/resources/agents/auth/invocations.ts

@@ -0,0 +1,167 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as AuthAPI from './auth';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Invocations extends APIResource {
+  /**
+   * Creates a new authentication invocation for the specified auth agent. This
+   * starts the auth flow and returns a hosted URL for the user to complete
+   * authentication.
+   *
+   * @example
+   * ```ts
+   * const authAgentInvocationCreateResponse =
+   *   await client.agents.auth.invocations.create({
+   *     auth_agent_id: 'abc123xyz',
+   *   });
+   * ```
+   */
+  create(
+    body: InvocationCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<AuthAPI.AuthAgentInvocationCreateResponse> {
+    return this._client.post('/agents/auth/invocations', { body, ...options });
+  }
+
+  /**
+   * Returns invocation details including app_name and target_domain. Uses the JWT
+   * returned by the exchange endpoint, or standard API key or JWT authentication.
+   *
+   * @example
+   * ```ts
+   * const agentAuthInvocationResponse =
+   *   await client.agents.auth.invocations.retrieve(
+   *     'invocation_id',
+   *   );
+   * ```
+   */
+  retrieve(invocationID: string, options?: RequestOptions): APIPromise<AuthAPI.AgentAuthInvocationResponse> {
+    return this._client.get(path`/agents/auth/invocations/${invocationID}`, options);
+  }
+
+  /**
+   * Inspects the target site to detect logged-in state or discover required fields.
+   * Returns 200 with success: true when fields are found, or 4xx/5xx for failures.
+   * Requires the JWT returned by the exchange endpoint.
+   *
+   * @example
+   * ```ts
+   * const agentAuthDiscoverResponse =
+   *   await client.agents.auth.invocations.discover(
+   *     'invocation_id',
+   *   );
+   * ```
+   */
+  discover(
+    invocationID: string,
+    body: InvocationDiscoverParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<AuthAPI.AgentAuthDiscoverResponse> {
+    return this._client.post(path`/agents/auth/invocations/${invocationID}/discover`, { body, ...options });
+  }
+
+  /**
+   * Validates the handoff code and returns a JWT token for subsequent requests. No
+   * authentication required (the handoff code serves as the credential).
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.agents.auth.invocations.exchange(
+   *     'invocation_id',
+   *     { code: 'abc123xyz' },
+   *   );
+   * ```
+   */
+  exchange(
+    invocationID: string,
+    body: InvocationExchangeParams,
+    options?: RequestOptions,
+  ): APIPromise<InvocationExchangeResponse> {
+    return this._client.post(path`/agents/auth/invocations/${invocationID}/exchange`, { body, ...options });
+  }
+
+  /**
+   * Submits field values for the discovered login form and may return additional
+   * auth fields or success. Requires the JWT returned by the exchange endpoint.
+   *
+   * @example
+   * ```ts
+   * const agentAuthSubmitResponse =
+   *   await client.agents.auth.invocations.submit(
+   *     'invocation_id',
+   *     {
+   *       field_values: {
+   *         email: 'user@example.com',
+   *         password: '********',
+   *       },
+   *     },
+   *   );
+   * ```
+   */
+  submit(
+    invocationID: string,
+    body: InvocationSubmitParams,
+    options?: RequestOptions,
+  ): APIPromise<AuthAPI.AgentAuthSubmitResponse> {
+    return this._client.post(path`/agents/auth/invocations/${invocationID}/submit`, { body, ...options });
+  }
+}
+
+/**
+ * Response from exchange endpoint
+ */
+export interface InvocationExchangeResponse {
+  /**
+   * Invocation ID
+   */
+  invocation_id: string;
+
+  /**
+   * JWT token with invocation_id claim (30 minute TTL)
+   */
+  jwt: string;
+}
+
+export interface InvocationCreateParams {
+  /**
+   * ID of the auth agent to create an invocation for
+   */
+  auth_agent_id: string;
+}
+
+export interface InvocationDiscoverParams {
+  /**
+   * Optional login page URL. If provided, will override the stored login URL for
+   * this discovery invocation and skip Phase 1 discovery.
+   */
+  login_url?: string;
+}
+
+export interface InvocationExchangeParams {
+  /**
+   * Handoff code from start endpoint
+   */
+  code: string;
+}
+
+export interface InvocationSubmitParams {
+  /**
+   * Values for the discovered login fields
+   */
+  field_values: { [key: string]: string };
+}
+
+export declare namespace Invocations {
+  export {
+    type InvocationExchangeResponse as InvocationExchangeResponse,
+    type InvocationCreateParams as InvocationCreateParams,
+    type InvocationDiscoverParams as InvocationDiscoverParams,
+    type InvocationExchangeParams as InvocationExchangeParams,
+    type InvocationSubmitParams as InvocationSubmitParams,
+  };
+}

package/src/resources/agents/auth.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './auth/index';

package/src/resources/agents/index.ts

@@ -0,0 +1,17 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Agents } from './agents';
+export {
+  Auth,
+  type AgentAuthDiscoverResponse,
+  type AgentAuthInvocationResponse,
+  type AgentAuthSubmitResponse,
+  type AuthAgent,
+  type AuthAgentCreateRequest,
+  type AuthAgentInvocationCreateRequest,
+  type AuthAgentInvocationCreateResponse,
+  type DiscoveredField,
+  type AuthCreateParams,
+  type AuthListParams,
+  type AuthAgentsOffsetPagination,
+} from './auth/index';

package/src/resources/agents.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './agents/index';

package/src/resources/browser-pools.ts

@@ -266,11 +266,11 @@ export interface BrowserPoolRequest {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (commonly 1024x768@60). Only specific viewport
-   * configurations are supported. The server will reject unsupported combinations.
-   * Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-   * 1440x900@25, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
-   * be automatically determined from the width and height if they match a supported
+   * image defaults apply (1920x1080@25). Only specific viewport configurations are
+   * supported. The server will reject unsupported combinations. Supported
+   * resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25,
+   * 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will be
+   * automatically determined from the width and height if they match a supported
    * configuration exactly. Note: Higher resolutions may affect the responsiveness of
    * live view browser
    */
@@ -284,7 +284,7 @@ export interface BrowserPoolRequest {
 export interface BrowserPoolUpdateRequest extends BrowserPoolRequest {
   /**
    * Whether to discard all idle browsers and rebuild the pool immediately. Defaults
-   * to true.
+   * to false.
    */
   discard_all_idle?: boolean;
 }
@@ -339,7 +339,8 @@ export interface BrowserPoolAcquireResponse {
   kiosk_mode?: boolean;
 
   /**
-   * Optional persistence configuration for the browser session.
+   * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
+   * instead.
    */
   persistence?: BrowsersAPI.BrowserPersistence;
 
@@ -355,11 +356,11 @@ export interface BrowserPoolAcquireResponse {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (commonly 1024x768@60). Only specific viewport
-   * configurations are supported. The server will reject unsupported combinations.
-   * Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-   * 1440x900@25, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
-   * be automatically determined from the width and height if they match a supported
+   * image defaults apply (1920x1080@25). Only specific viewport configurations are
+   * supported. The server will reject unsupported combinations. Supported
+   * resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25,
+   * 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will be
+   * automatically determined from the width and height if they match a supported
    * configuration exactly. Note: Higher resolutions may affect the responsiveness of
    * live view browser
    */
@@ -425,11 +426,11 @@ export interface BrowserPoolCreateParams {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (commonly 1024x768@60). Only specific viewport
-   * configurations are supported. The server will reject unsupported combinations.
-   * Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-   * 1440x900@25, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
-   * be automatically determined from the width and height if they match a supported
+   * image defaults apply (1920x1080@25). Only specific viewport configurations are
+   * supported. The server will reject unsupported combinations. Supported
+   * resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25,
+   * 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will be
+   * automatically determined from the width and height if they match a supported
    * configuration exactly. Note: Higher resolutions may affect the responsiveness of
    * live view browser
    */
@@ -444,7 +445,7 @@ export interface BrowserPoolUpdateParams {
 
   /**
    * Whether to discard all idle browsers and rebuild the pool immediately. Defaults
-   * to true.
+   * to false.
    */
   discard_all_idle?: boolean;
 
@@ -501,11 +502,11 @@ export interface BrowserPoolUpdateParams {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (commonly 1024x768@60). Only specific viewport
-   * configurations are supported. The server will reject unsupported combinations.
-   * Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-   * 1440x900@25, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
-   * be automatically determined from the width and height if they match a supported
+   * image defaults apply (1920x1080@25). Only specific viewport configurations are
+   * supported. The server will reject unsupported combinations. Supported
+   * resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25,
+   * 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will be
+   * automatically determined from the width and height if they match a supported
    * configuration exactly. Note: Higher resolutions may affect the responsiveness of
    * live view browser
    */

package/src/resources/browsers/browsers.ts

@@ -127,14 +127,10 @@ export class Browsers extends APIResource {
   }
 
   /**
-   * Delete a persistent browser session by its persistent_id.
+   * DEPRECATED: Use DELETE /browsers/{id} instead. Delete a persistent browser
+   * session by its persistent_id.
    *
-   * @example
-   * ```ts
-   * await client.browsers.delete({
-   *   persistent_id: 'persistent_id',
-   * });
-   * ```
+   * @deprecated
    */
   delete(params: BrowserDeleteParams, options?: RequestOptions): APIPromise<void> {
     const { persistent_id } = params;
@@ -192,11 +188,12 @@ export class Browsers extends APIResource {
 export type BrowserListResponsesOffsetPagination = OffsetPagination<BrowserListResponse>;
 
 /**
- * Optional persistence configuration for the browser session.
+ * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
+ * instead.
  */
 export interface BrowserPersistence {
   /**
-   * Unique identifier for the persistent browser session.
+   * DEPRECATED: Unique identifier for the persistent browser session.
    */
   id: string;
 }
@@ -279,7 +276,8 @@ export interface BrowserCreateResponse {
   kiosk_mode?: boolean;
 
   /**
-   * Optional persistence configuration for the browser session.
+   * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
+   * instead.
    */
   persistence?: BrowserPersistence;
 
@@ -295,11 +293,11 @@ export interface BrowserCreateResponse {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (commonly 1024x768@60). Only specific viewport
-   * configurations are supported. The server will reject unsupported combinations.
-   * Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-   * 1440x900@25, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
-   * be automatically determined from the width and height if they match a supported
+   * image defaults apply (1920x1080@25). Only specific viewport configurations are
+   * supported. The server will reject unsupported combinations. Supported
+   * resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25,
+   * 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will be
+   * automatically determined from the width and height if they match a supported
    * configuration exactly. Note: Higher resolutions may affect the responsiveness of
    * live view browser
    */
@@ -354,7 +352,8 @@ export interface BrowserRetrieveResponse {
   kiosk_mode?: boolean;
 
   /**
-   * Optional persistence configuration for the browser session.
+   * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
+   * instead.
    */
   persistence?: BrowserPersistence;
 
@@ -370,11 +369,11 @@ export interface BrowserRetrieveResponse {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (commonly 1024x768@60). Only specific viewport
-   * configurations are supported. The server will reject unsupported combinations.
-   * Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-   * 1440x900@25, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
-   * be automatically determined from the width and height if they match a supported
+   * image defaults apply (1920x1080@25). Only specific viewport configurations are
+   * supported. The server will reject unsupported combinations. Supported
+   * resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25,
+   * 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will be
+   * automatically determined from the width and height if they match a supported
    * configuration exactly. Note: Higher resolutions may affect the responsiveness of
    * live view browser
    */
@@ -429,7 +428,8 @@ export interface BrowserListResponse {
   kiosk_mode?: boolean;
 
   /**
-   * Optional persistence configuration for the browser session.
+   * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
+   * instead.
    */
   persistence?: BrowserPersistence;
 
@@ -445,11 +445,11 @@ export interface BrowserListResponse {
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (commonly 1024x768@60). Only specific viewport
-   * configurations are supported. The server will reject unsupported combinations.
-   * Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-   * 1440x900@25, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
-   * be automatically determined from the width and height if they match a supported
+   * image defaults apply (1920x1080@25). Only specific viewport configurations are
+   * supported. The server will reject unsupported combinations. Supported
+   * resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25,
+   * 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will be
+   * automatically determined from the width and height if they match a supported
    * configuration exactly. Note: Higher resolutions may affect the responsiveness of
    * live view browser
    */
@@ -480,7 +480,8 @@ export interface BrowserCreateParams {
   kiosk_mode?: boolean;
 
   /**
-   * Optional persistence configuration for the browser session.
+   * @deprecated DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles
+   * instead.
    */
   persistence?: BrowserPersistence;
 
@@ -505,21 +506,20 @@ export interface BrowserCreateParams {
 
   /**
    * The number of seconds of inactivity before the browser session is terminated.
-   * Only applicable to non-persistent browsers. Activity includes CDP connections
-   * and live view connections. Defaults to 60 seconds. Minimum allowed is 10
-   * seconds. Maximum allowed is 259200 (72 hours). We check for inactivity every 5
-   * seconds, so the actual timeout behavior you will see is +/- 5 seconds around the
-   * specified value.
+   * Activity includes CDP connections and live view connections. Defaults to 60
+   * seconds. Minimum allowed is 10 seconds. Maximum allowed is 259200 (72 hours). We
+   * check for inactivity every 5 seconds, so the actual timeout behavior you will
+   * see is +/- 5 seconds around the specified value.
    */
   timeout_seconds?: number;
 
   /**
    * Initial browser window size in pixels with optional refresh rate. If omitted,
-   * image defaults apply (commonly 1024x768@60). Only specific viewport
-   * configurations are supported. The server will reject unsupported combinations.
-   * Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-   * 1440x900@25, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
-   * be automatically determined from the width and height if they match a supported
+   * image defaults apply (1920x1080@25). Only specific viewport configurations are
+   * supported. The server will reject unsupported combinations. Supported
+   * resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25,
+   * 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will be
+   * automatically determined from the width and height if they match a supported
    * configuration exactly. Note: Higher resolutions may affect the responsiveness of
    * live view browser
    */

package/src/resources/index.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export * from './shared';
+export { Agents } from './agents/agents';
 export {
   Apps,
   type AppListResponse,

package/src/resources/shared.ts

@@ -53,11 +53,11 @@ export interface BrowserProfile {
 
 /**
  * Initial browser window size in pixels with optional refresh rate. If omitted,
- * image defaults apply (commonly 1024x768@60). Only specific viewport
- * configurations are supported. The server will reject unsupported combinations.
- * Supported resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25,
- * 1440x900@25, 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will
- * be automatically determined from the width and height if they match a supported
+ * image defaults apply (1920x1080@25). Only specific viewport configurations are
+ * supported. The server will reject unsupported combinations. Supported
+ * resolutions are: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25,
+ * 1024x768@60, 1200x800@60 If refresh_rate is not provided, it will be
+ * automatically determined from the width and height if they match a supported
  * configuration exactly. Note: Higher resolutions may affect the responsiveness of
  * live view browser
  */

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.22.0'; // x-release-please-version
+export const VERSION = '0.23.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.22.0";
+export declare const VERSION = "0.23.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.22.0'; // x-release-please-version
+exports.VERSION = '0.23.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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