@onkernel/sdk 0.4.0 → 0.6.0

package/src/internal/shim-types.ts

@@ -0,0 +1,26 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+/**
+ * Shims for types that we can't always rely on being available globally.
+ *
+ * Note: these only exist at the type-level, there is no corresponding runtime
+ * version for any of these symbols.
+ */
+
+type NeverToAny<T> = T extends never ? any : T;
+
+/** @ts-ignore */
+type _DOMReadableStream<R = any> = globalThis.ReadableStream<R>;
+
+/** @ts-ignore */
+type _NodeReadableStream<R = any> = import('stream/web').ReadableStream<R>;
+
+type _ConditionalNodeReadableStream<R = any> =
+  typeof globalThis extends { ReadableStream: any } ? never : _NodeReadableStream<R>;
+
+type _ReadableStream<R = any> = NeverToAny<
+  | ([0] extends [1 & _DOMReadableStream<R>] ? never : _DOMReadableStream<R>)
+  | ([0] extends [1 & _ConditionalNodeReadableStream<R>] ? never : _ConditionalNodeReadableStream<R>)
+>;
+
+export type { _ReadableStream as ReadableStream };

package/src/internal/shims.ts

@@ -7,8 +7,8 @@
  * messages in cases where an environment isn't fully supported.
  */
 
-import { type Fetch } from './builtin-types';
-import { type ReadableStream } from './shim-types';
+import type { Fetch } from './builtin-types';
+import type { ReadableStream } from './shim-types';
 
 export function getDefaultFetch(): Fetch {
   if (typeof fetch !== 'undefined') {

package/src/internal/uploads.ts

@@ -90,7 +90,7 @@ export const multipartFormRequestOptions = async (
   return { ...opts, body: await createForm(opts.body, fetch) };
 };
 
-const supportsFormDataMap = new WeakMap<Fetch, Promise<boolean>>();
+const supportsFormDataMap = /** @__PURE__ */ new WeakMap<Fetch, Promise<boolean>>();
 
 /**
  * node-fetch doesn't support the global FormData object in recent node versions. Instead of sending
@@ -138,7 +138,7 @@ export const createForm = async <T = Record<string, unknown>>(
 
 // We check for Blob not File because Bun.File doesn't inherit from File,
 // but they both inherit from Blob and have a `name` property at runtime.
-const isNamedBlob = (value: object) => value instanceof Blob && 'name' in value;
+const isNamedBlob = (value: unknown) => value instanceof Blob && 'name' in value;
 
 const isUploadable = (value: unknown) =>
   typeof value === 'object' &&

package/src/internal/utils/log.ts

@@ -58,7 +58,7 @@ const noopLogger = {
   debug: noop,
 };
 
-let cachedLoggers = new WeakMap<Logger, [LogLevel, Logger]>();
+let cachedLoggers = /** @__PURE__ */ new WeakMap<Logger, [LogLevel, Logger]>();
 
 export function loggerFor(client: Kernel): Logger {
   const logger = client.logger;

package/src/internal/utils/path.ts

@@ -60,4 +60,4 @@ export const createPathTagFunction = (pathEncoder = encodeURIPath) =>
 /**
  * URI-encodes path params and ensures no unsafe /./ or /../ path segments are introduced.
  */
-export const path = createPathTagFunction(encodeURIPath);
+export const path = /* @__PURE__ */ createPathTagFunction(encodeURIPath);

package/src/internal/utils/values.ts

@@ -9,6 +9,9 @@ export const isAbsoluteURL = (url: string): boolean => {
   return startsWithSchemeRegexp.test(url);
 };
 
+export let isArray = (val: unknown): val is unknown[] => ((isArray = Array.isArray), isArray(val));
+export let isReadonlyArray = isArray as (val: unknown) => val is readonly unknown[];
+
 /** Returns an object if the given value isn't an object, otherwise returns as-is */
 export function maybeObj(x: unknown): object {
   if (typeof x !== 'object') {

package/src/resources/apps/apps.ts

@@ -8,25 +8,14 @@ import {
   DeploymentFollowResponse,
   Deployments,
 } from './deployments';
-import * as InvocationsAPI from './invocations';
-import {
-  InvocationCreateParams,
-  InvocationCreateResponse,
-  InvocationRetrieveResponse,
-  InvocationUpdateParams,
-  InvocationUpdateResponse,
-  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.
+   * List applications. Optionally filter by app name and/or version label.
    *
    * @example
    * ```ts
@@ -58,7 +47,7 @@ export namespace AppListResponse {
     /**
      * Deployment region code
      */
-    region: string;
+    region: 'aws.us-east-1a';
 
     /**
      * Version label for the application
@@ -85,7 +74,6 @@ export interface AppListParams {
 }
 
 Apps.Deployments = Deployments;
-Apps.Invocations = Invocations;
 
 export declare namespace Apps {
   export { type AppListResponse as AppListResponse, type AppListParams as AppListParams };
@@ -96,13 +84,4 @@ export declare namespace Apps {
     type DeploymentFollowResponse as DeploymentFollowResponse,
     type DeploymentCreateParams as DeploymentCreateParams,
   };
-
-  export {
-    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/deployments.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as Shared from '../shared';
 import { APIPromise } from '../../core/api-promise';
 import { Stream } from '../../core/streaming';
 import { type Uploadable } from '../../core/uploads';
@@ -11,7 +12,7 @@ import { path } from '../../internal/utils/path';
 
 export class Deployments extends APIResource {
   /**
-   * Deploy a new application
+   * Deploy a new application and associated actions to Kernel.
    *
    * @example
    * ```ts
@@ -96,7 +97,7 @@ export namespace DeploymentCreateResponse {
 export type DeploymentFollowResponse =
   | DeploymentFollowResponse.StateEvent
   | DeploymentFollowResponse.StateUpdateEvent
-  | DeploymentFollowResponse.LogEvent;
+  | Shared.LogEvent;
 
 export namespace DeploymentFollowResponse {
   /**
@@ -138,26 +139,6 @@ export namespace DeploymentFollowResponse {
      */
     timestamp?: string;
   }
-
-  /**
-   * A log entry from the application.
-   */
-  export interface LogEvent {
-    /**
-     * Event type identifier (always "log").
-     */
-    event: 'log';
-
-    /**
-     * Log message text.
-     */
-    message: string;
-
-    /**
-     * Time the log entry was produced.
-     */
-    timestamp?: string;
-  }
 }
 
 export interface DeploymentCreateParams {

package/src/resources/apps/index.ts

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

package/src/resources/browsers.ts

@@ -9,7 +9,7 @@ import { path } from '../internal/utils/path';
 
 export class Browsers extends APIResource {
   /**
-   * Create Browser Session
+   * Create a new browser session from within an action.
    *
    * @example
    * ```ts
@@ -23,7 +23,7 @@ export class Browsers extends APIResource {
   }
 
   /**
-   * Get Browser Session by ID
+   * Get information about a browser session.
    *
    * @example
    * ```ts
@@ -37,7 +37,7 @@ export class Browsers extends APIResource {
   }
 
   /**
-   * List active browser sessions for the authenticated user
+   * List active browser sessions
    *
    * @example
    * ```ts
@@ -49,7 +49,7 @@ export class Browsers extends APIResource {
   }
 
   /**
-   * Delete a persistent browser session by persistent_id query parameter.
+   * Delete a persistent browser session by its persistent_id.
    *
    * @example
    * ```ts
@@ -68,7 +68,7 @@ export class Browsers extends APIResource {
   }
 
   /**
-   * Delete Browser Session by ID
+   * Delete a browser session by ID
    *
    * @example
    * ```ts
@@ -175,6 +175,12 @@ export interface BrowserCreateParams {
    * Optional persistence configuration for the browser session.
    */
   persistence?: BrowserPersistence;
+
+  /**
+   * If true, launches the browser in stealth mode to reduce detection by anti-bot
+   * mechanisms.
+   */
+  stealth?: boolean;
 }
 
 export interface BrowserDeleteParams {

package/src/resources/deployments.ts

@@ -0,0 +1,326 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as Shared from './shared';
+import { APIPromise } from '../core/api-promise';
+import { Stream } from '../core/streaming';
+import { type Uploadable } from '../core/uploads';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+import { multipartFormRequestOptions } from '../internal/uploads';
+import { path } from '../internal/utils/path';
+
+export class Deployments extends APIResource {
+  /**
+   * Create a new deployment.
+   *
+   * @example
+   * ```ts
+   * const deployment = await client.deployments.create({
+   *   entrypoint_rel_path: 'src/app.py',
+   *   file: fs.createReadStream('path/to/file'),
+   * });
+   * ```
+   */
+  create(body: DeploymentCreateParams, options?: RequestOptions): APIPromise<DeploymentCreateResponse> {
+    return this._client.post('/deployments', multipartFormRequestOptions({ body, ...options }, this._client));
+  }
+
+  /**
+   * Get information about a deployment's status.
+   *
+   * @example
+   * ```ts
+   * const deployment = await client.deployments.retrieve('id');
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<DeploymentRetrieveResponse> {
+    return this._client.get(path`/deployments/${id}`, options);
+  }
+
+  /**
+   * Establishes a Server-Sent Events (SSE) stream that delivers real-time logs and
+   * status updates for a deployment. The stream terminates automatically once the
+   * deployment reaches a terminal state.
+   *
+   * @example
+   * ```ts
+   * const response = await client.deployments.follow('id');
+   * ```
+   */
+  follow(id: string, options?: RequestOptions): APIPromise<Stream<DeploymentFollowResponse>> {
+    return this._client.get(path`/deployments/${id}/events`, {
+      ...options,
+      headers: buildHeaders([{ Accept: 'text/event-stream' }, options?.headers]),
+      stream: true,
+    }) as APIPromise<Stream<DeploymentFollowResponse>>;
+  }
+}
+
+/**
+ * An event representing the current state of a deployment.
+ */
+export interface DeploymentStateEvent {
+  /**
+   * Deployment record information.
+   */
+  deployment: DeploymentStateEvent.Deployment;
+
+  /**
+   * Event type identifier (always "deployment_state").
+   */
+  event: 'deployment_state';
+
+  /**
+   * Time the state was reported.
+   */
+  timestamp: string;
+}
+
+export namespace DeploymentStateEvent {
+  /**
+   * Deployment record information.
+   */
+  export interface Deployment {
+    /**
+     * Unique identifier for the deployment
+     */
+    id: string;
+
+    /**
+     * Timestamp when the deployment was created
+     */
+    created_at: string;
+
+    /**
+     * Deployment region code
+     */
+    region: 'aws.us-east-1a';
+
+    /**
+     * Current status of the deployment
+     */
+    status: 'queued' | 'in_progress' | 'running' | 'failed' | 'stopped';
+
+    /**
+     * Relative path to the application entrypoint
+     */
+    entrypoint_rel_path?: string;
+
+    /**
+     * Environment variables configured for this deployment
+     */
+    env_vars?: Record<string, string>;
+
+    /**
+     * Status reason
+     */
+    status_reason?: string;
+
+    /**
+     * Timestamp when the deployment was last updated
+     */
+    updated_at?: string | null;
+  }
+}
+
+/**
+ * Deployment record information.
+ */
+export interface DeploymentCreateResponse {
+  /**
+   * Unique identifier for the deployment
+   */
+  id: string;
+
+  /**
+   * Timestamp when the deployment was created
+   */
+  created_at: string;
+
+  /**
+   * Deployment region code
+   */
+  region: 'aws.us-east-1a';
+
+  /**
+   * Current status of the deployment
+   */
+  status: 'queued' | 'in_progress' | 'running' | 'failed' | 'stopped';
+
+  /**
+   * Relative path to the application entrypoint
+   */
+  entrypoint_rel_path?: string;
+
+  /**
+   * Environment variables configured for this deployment
+   */
+  env_vars?: Record<string, string>;
+
+  /**
+   * Status reason
+   */
+  status_reason?: string;
+
+  /**
+   * Timestamp when the deployment was last updated
+   */
+  updated_at?: string | null;
+}
+
+/**
+ * Deployment record information.
+ */
+export interface DeploymentRetrieveResponse {
+  /**
+   * Unique identifier for the deployment
+   */
+  id: string;
+
+  /**
+   * Timestamp when the deployment was created
+   */
+  created_at: string;
+
+  /**
+   * Deployment region code
+   */
+  region: 'aws.us-east-1a';
+
+  /**
+   * Current status of the deployment
+   */
+  status: 'queued' | 'in_progress' | 'running' | 'failed' | 'stopped';
+
+  /**
+   * Relative path to the application entrypoint
+   */
+  entrypoint_rel_path?: string;
+
+  /**
+   * Environment variables configured for this deployment
+   */
+  env_vars?: Record<string, string>;
+
+  /**
+   * Status reason
+   */
+  status_reason?: string;
+
+  /**
+   * Timestamp when the deployment was last updated
+   */
+  updated_at?: string | null;
+}
+
+/**
+ * Union type representing any deployment event.
+ */
+export type DeploymentFollowResponse =
+  | Shared.LogEvent
+  | DeploymentStateEvent
+  | DeploymentFollowResponse.AppVersionSummaryEvent
+  | Shared.ErrorEvent;
+
+export namespace DeploymentFollowResponse {
+  /**
+   * Summary of an application version.
+   */
+  export interface AppVersionSummaryEvent {
+    /**
+     * Unique identifier for the app version
+     */
+    id: string;
+
+    /**
+     * List of actions available on the app
+     */
+    actions: Array<AppVersionSummaryEvent.Action>;
+
+    /**
+     * Name of the application
+     */
+    app_name: string;
+
+    /**
+     * Event type identifier (always "app_version_summary").
+     */
+    event: 'app_version_summary';
+
+    /**
+     * Deployment region code
+     */
+    region: 'aws.us-east-1a';
+
+    /**
+     * Time the state was reported.
+     */
+    timestamp: string;
+
+    /**
+     * Version label for the application
+     */
+    version: string;
+
+    /**
+     * Environment variables configured for this app version
+     */
+    env_vars?: Record<string, string>;
+  }
+
+  export namespace AppVersionSummaryEvent {
+    /**
+     * An action available on the app
+     */
+    export interface Action {
+      /**
+       * Name of the action
+       */
+      name: string;
+    }
+  }
+}
+
+export interface DeploymentCreateParams {
+  /**
+   * Relative path to the entrypoint of the application
+   */
+  entrypoint_rel_path: string;
+
+  /**
+   * ZIP file containing the application source directory
+   */
+  file: Uploadable;
+
+  /**
+   * Map of environment variables to set for the deployed application. Each key-value
+   * pair represents an environment variable.
+   */
+  env_vars?: Record<string, string>;
+
+  /**
+   * Allow overwriting an existing app version
+   */
+  force?: boolean;
+
+  /**
+   * Region for deployment. Currently we only support "aws.us-east-1a"
+   */
+  region?: 'aws.us-east-1a';
+
+  /**
+   * Version of the application. Can be any string.
+   */
+  version?: string;
+}
+
+export declare namespace Deployments {
+  export {
+    type DeploymentStateEvent as DeploymentStateEvent,
+    type DeploymentCreateResponse as DeploymentCreateResponse,
+    type DeploymentRetrieveResponse as DeploymentRetrieveResponse,
+    type DeploymentFollowResponse as DeploymentFollowResponse,
+    type DeploymentCreateParams as DeploymentCreateParams,
+  };
+}

package/src/resources/index.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export * from './shared';
 export { Apps, type AppListResponse, type AppListParams } from './apps/apps';
 export {
   Browsers,
@@ -10,3 +11,21 @@ export {
   type BrowserCreateParams,
   type BrowserDeleteParams,
 } from './browsers';
+export {
+  Deployments,
+  type DeploymentStateEvent,
+  type DeploymentCreateResponse,
+  type DeploymentRetrieveResponse,
+  type DeploymentFollowResponse,
+  type DeploymentCreateParams,
+} from './deployments';
+export {
+  Invocations,
+  type InvocationStateEvent,
+  type InvocationCreateResponse,
+  type InvocationRetrieveResponse,
+  type InvocationUpdateResponse,
+  type InvocationFollowResponse,
+  type InvocationCreateParams,
+  type InvocationUpdateParams,
+} from './invocations';