@onkernel/sdk 0.5.0 → 0.6.1

package/resources/{apps/invocations.d.ts → invocations.d.ts}

@@ -1,13 +1,15 @@
-import { APIResource } from "../../core/resource.js";
-import { APIPromise } from "../../core/api-promise.js";
-import { RequestOptions } from "../../internal/request-options.js";
+import { APIResource } from "../core/resource.js";
+import * as Shared from "./shared.js";
+import { APIPromise } from "../core/api-promise.js";
+import { Stream } from "../core/streaming.js";
+import { RequestOptions } from "../internal/request-options.js";
 export declare class Invocations extends APIResource {
     /**
      * Invoke an action.
      *
      * @example
      * ```ts
-     * const invocation = await client.apps.invocations.create({
+     * const invocation = await client.invocations.create({
      *   action_name: 'analyze',
      *   app_name: 'my-app',
      *   version: '1.0.0',
@@ -20,7 +22,7 @@ export declare class Invocations extends APIResource {
      *
      * @example
      * ```ts
-     * const invocation = await client.apps.invocations.retrieve(
+     * const invocation = await client.invocations.retrieve(
      *   'rr33xuugxj9h0bkf1rdt2bet',
      * );
      * ```
@@ -31,13 +33,88 @@ export declare class Invocations extends APIResource {
      *
      * @example
      * ```ts
-     * const invocation = await client.apps.invocations.update(
-     *   'id',
-     *   { status: 'succeeded' },
-     * );
+     * const invocation = await client.invocations.update('id', {
+     *   status: 'succeeded',
+     * });
      * ```
      */
     update(id: string, body: InvocationUpdateParams, options?: RequestOptions): APIPromise<InvocationUpdateResponse>;
+    /**
+     * Delete all browser sessions created within the specified invocation.
+     *
+     * @example
+     * ```ts
+     * await client.invocations.deleteBrowsers('id');
+     * ```
+     */
+    deleteBrowsers(id: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Establishes a Server-Sent Events (SSE) stream that delivers real-time logs and
+     * status updates for an invocation. The stream terminates automatically once the
+     * invocation reaches a terminal state.
+     *
+     * @example
+     * ```ts
+     * const response = await client.invocations.follow('id');
+     * ```
+     */
+    follow(id: string, options?: RequestOptions): APIPromise<Stream<InvocationFollowResponse>>;
+}
+/**
+ * An event representing the current state of an invocation.
+ */
+export interface InvocationStateEvent {
+    /**
+     * Event type identifier (always "invocation_state").
+     */
+    event: 'invocation_state';
+    invocation: InvocationStateEvent.Invocation;
+    /**
+     * Time the state was reported.
+     */
+    timestamp: string;
+}
+export declare namespace InvocationStateEvent {
+    interface Invocation {
+        /**
+         * 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 InvocationCreateResponse {
     /**
@@ -138,6 +215,10 @@ export interface InvocationUpdateResponse {
      */
     status_reason?: string;
 }
+/**
+ * Union type representing any invocation event.
+ */
+export type InvocationFollowResponse = Shared.LogEvent | InvocationStateEvent | Shared.ErrorEvent;
 export interface InvocationCreateParams {
     /**
      * Name of the action to invoke
@@ -172,6 +253,6 @@ export interface InvocationUpdateParams {
     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, };
+    export { type InvocationStateEvent as InvocationStateEvent, type InvocationCreateResponse as InvocationCreateResponse, type InvocationRetrieveResponse as InvocationRetrieveResponse, type InvocationUpdateResponse as InvocationUpdateResponse, type InvocationFollowResponse as InvocationFollowResponse, type InvocationCreateParams as InvocationCreateParams, type InvocationUpdateParams as InvocationUpdateParams, };
 }
 //# sourceMappingURL=invocations.d.ts.map

package/resources/invocations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocations.d.ts","sourceRoot":"","sources":["../src/resources/invocations.ts"],"names":[],"mappings":"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"}

package/resources/invocations.js

@@ -0,0 +1,83 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Invocations = void 0;
+const resource_1 = require("../core/resource.js");
+const headers_1 = require("../internal/headers.js");
+const path_1 = require("../internal/utils/path.js");
+class Invocations extends resource_1.APIResource {
+    /**
+     * Invoke an action.
+     *
+     * @example
+     * ```ts
+     * const invocation = await client.invocations.create({
+     *   action_name: 'analyze',
+     *   app_name: 'my-app',
+     *   version: '1.0.0',
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/invocations', { body, ...options });
+    }
+    /**
+     * Get details about an invocation's status and output.
+     *
+     * @example
+     * ```ts
+     * const invocation = await client.invocations.retrieve(
+     *   'rr33xuugxj9h0bkf1rdt2bet',
+     * );
+     * ```
+     */
+    retrieve(id, options) {
+        return this._client.get((0, path_1.path) `/invocations/${id}`, options);
+    }
+    /**
+     * Update an invocation's status or output.
+     *
+     * @example
+     * ```ts
+     * const invocation = await client.invocations.update('id', {
+     *   status: 'succeeded',
+     * });
+     * ```
+     */
+    update(id, body, options) {
+        return this._client.patch((0, path_1.path) `/invocations/${id}`, { body, ...options });
+    }
+    /**
+     * Delete all browser sessions created within the specified invocation.
+     *
+     * @example
+     * ```ts
+     * await client.invocations.deleteBrowsers('id');
+     * ```
+     */
+    deleteBrowsers(id, options) {
+        return this._client.delete((0, path_1.path) `/invocations/${id}/browsers`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Establishes a Server-Sent Events (SSE) stream that delivers real-time logs and
+     * status updates for an invocation. The stream terminates automatically once the
+     * invocation reaches a terminal state.
+     *
+     * @example
+     * ```ts
+     * const response = await client.invocations.follow('id');
+     * ```
+     */
+    follow(id, options) {
+        return this._client.get((0, path_1.path) `/invocations/${id}/events`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: 'text/event-stream' }, options?.headers]),
+            stream: true,
+        });
+    }
+}
+exports.Invocations = Invocations;
+//# sourceMappingURL=invocations.js.map

package/resources/invocations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocations.js","sourceRoot":"","sources":["../src/resources/invocations.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,oDAAmD;AAEnD,oDAA8C;AAE9C,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAA4B,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,gBAAgB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,EAAU,EACV,IAA4B,EAC5B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,gBAAgB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,EAAU,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,gBAAgB,EAAE,WAAW,EAAE;YAC5D,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,gBAAgB,EAAE,SAAS,EAAE;YACvD,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1E,MAAM,EAAE,IAAI;SACb,CAAiD,CAAC;IACrD,CAAC;CACF;AAjFD,kCAiFC"}

package/resources/invocations.mjs

@@ -0,0 +1,79 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { buildHeaders } from "../internal/headers.mjs";
+import { path } from "../internal/utils/path.mjs";
+export class Invocations extends APIResource {
+    /**
+     * Invoke an action.
+     *
+     * @example
+     * ```ts
+     * const invocation = await client.invocations.create({
+     *   action_name: 'analyze',
+     *   app_name: 'my-app',
+     *   version: '1.0.0',
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/invocations', { body, ...options });
+    }
+    /**
+     * Get details about an invocation's status and output.
+     *
+     * @example
+     * ```ts
+     * const invocation = await client.invocations.retrieve(
+     *   'rr33xuugxj9h0bkf1rdt2bet',
+     * );
+     * ```
+     */
+    retrieve(id, options) {
+        return this._client.get(path `/invocations/${id}`, options);
+    }
+    /**
+     * Update an invocation's status or output.
+     *
+     * @example
+     * ```ts
+     * const invocation = await client.invocations.update('id', {
+     *   status: 'succeeded',
+     * });
+     * ```
+     */
+    update(id, body, options) {
+        return this._client.patch(path `/invocations/${id}`, { body, ...options });
+    }
+    /**
+     * Delete all browser sessions created within the specified invocation.
+     *
+     * @example
+     * ```ts
+     * await client.invocations.deleteBrowsers('id');
+     * ```
+     */
+    deleteBrowsers(id, options) {
+        return this._client.delete(path `/invocations/${id}/browsers`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Establishes a Server-Sent Events (SSE) stream that delivers real-time logs and
+     * status updates for an invocation. The stream terminates automatically once the
+     * invocation reaches a terminal state.
+     *
+     * @example
+     * ```ts
+     * const response = await client.invocations.follow('id');
+     * ```
+     */
+    follow(id, options) {
+        return this._client.get(path `/invocations/${id}/events`, {
+            ...options,
+            headers: buildHeaders([{ Accept: 'text/event-stream' }, options?.headers]),
+            stream: true,
+        });
+    }
+}
+//# sourceMappingURL=invocations.mjs.map

package/resources/invocations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocations.mjs","sourceRoot":"","sources":["../src/resources/invocations.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAIf,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAA4B,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,gBAAgB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,EAAU,EACV,IAA4B,EAC5B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,gBAAgB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,EAAU,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,gBAAgB,EAAE,WAAW,EAAE;YAC5D,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,gBAAgB,EAAE,SAAS,EAAE;YACvD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1E,MAAM,EAAE,IAAI;SACb,CAAiD,CAAC;IACrD,CAAC;CACF"}

package/resources/shared.d.mts

@@ -0,0 +1,57 @@
+export interface ErrorDetail {
+    /**
+     * Lower-level error code providing more specific detail
+     */
+    code?: string;
+    /**
+     * Further detail about the error
+     */
+    message?: string;
+}
+/**
+ * An error event from the application.
+ */
+export interface ErrorEvent {
+    error: ErrorModel;
+    /**
+     * Event type identifier (always "error").
+     */
+    event: 'error';
+    /**
+     * Time the error occurred.
+     */
+    timestamp: string;
+}
+export interface ErrorModel {
+    /**
+     * Application-specific error code (machine-readable)
+     */
+    code: string;
+    /**
+     * Human-readable error description for debugging
+     */
+    message: string;
+    /**
+     * Additional error details (for multiple errors)
+     */
+    details?: Array<ErrorDetail>;
+    inner_error?: ErrorDetail;
+}
+/**
+ * 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;
+}
+//# sourceMappingURL=shared.d.mts.map

package/resources/shared.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.mts","sourceRoot":"","sources":["../src/resources/shared.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,UAAU,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAE7B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/resources/shared.d.ts

@@ -0,0 +1,57 @@
+export interface ErrorDetail {
+    /**
+     * Lower-level error code providing more specific detail
+     */
+    code?: string;
+    /**
+     * Further detail about the error
+     */
+    message?: string;
+}
+/**
+ * An error event from the application.
+ */
+export interface ErrorEvent {
+    error: ErrorModel;
+    /**
+     * Event type identifier (always "error").
+     */
+    event: 'error';
+    /**
+     * Time the error occurred.
+     */
+    timestamp: string;
+}
+export interface ErrorModel {
+    /**
+     * Application-specific error code (machine-readable)
+     */
+    code: string;
+    /**
+     * Human-readable error description for debugging
+     */
+    message: string;
+    /**
+     * Additional error details (for multiple errors)
+     */
+    details?: Array<ErrorDetail>;
+    inner_error?: ErrorDetail;
+}
+/**
+ * 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;
+}
+//# sourceMappingURL=shared.d.ts.map

package/resources/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/resources/shared.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,UAAU,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAE7B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/resources/shared.js

@@ -0,0 +1,4 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=shared.js.map

package/resources/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/resources/shared.ts"],"names":[],"mappings":";AAAA,sFAAsF"}

package/resources/shared.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export {};
+//# sourceMappingURL=shared.mjs.map

package/resources/shared.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.mjs","sourceRoot":"","sources":["../src/resources/shared.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/src/client.ts

@@ -5,7 +5,6 @@ import type { HTTPMethod, PromiseOrValue, MergedRequestInit, FinalizedRequestIni
 import { uuid4 } from './internal/utils/uuid';
 import { validatePositiveInteger, isAbsoluteURL, safeJSON } from './internal/utils/values';
 import { sleep } from './internal/utils/sleep';
-import { type Logger, type LogLevel, parseLogLevel } from './internal/utils/log';
 export type { Logger, LogLevel } from './internal/utils/log';
 import { castToError, isAbortError } from './internal/errors';
 import type { APIResponseProps } from './internal/parse';
@@ -17,9 +16,6 @@ import * as Errors from './core/error';
 import * as Uploads from './core/uploads';
 import * as API from './resources/index';
 import { APIPromise } from './core/api-promise';
-import { type Fetch } from './internal/builtin-types';
-import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
-import { FinalRequestOptions, RequestOptions } from './internal/request-options';
 import {
   BrowserCreateParams,
   BrowserCreateResponse,
@@ -29,11 +25,38 @@ import {
   BrowserRetrieveResponse,
   Browsers,
 } from './resources/browsers';
-import { readEnv } from './internal/utils/env';
-import { formatRequestDetails, loggerFor } from './internal/utils/log';
-import { isEmptyObj } from './internal/utils/values';
+import {
+  DeploymentCreateParams,
+  DeploymentCreateResponse,
+  DeploymentFollowResponse,
+  DeploymentRetrieveResponse,
+  DeploymentStateEvent,
+  Deployments,
+} from './resources/deployments';
 import { KernelApp } from './core/app-framework';
+import {
+  InvocationCreateParams,
+  InvocationCreateResponse,
+  InvocationFollowResponse,
+  InvocationRetrieveResponse,
+  InvocationStateEvent,
+  InvocationUpdateParams,
+  InvocationUpdateResponse,
+  Invocations,
+} from './resources/invocations';
 import { AppListParams, AppListResponse, Apps } from './resources/apps/apps';
+import { type Fetch } from './internal/builtin-types';
+import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
+import { FinalRequestOptions, RequestOptions } from './internal/request-options';
+import { readEnv } from './internal/utils/env';
+import {
+  type LogLevel,
+  type Logger,
+  formatRequestDetails,
+  loggerFor,
+  parseLogLevel,
+} from './internal/utils/log';
+import { isEmptyObj } from './internal/utils/values';
 
 const environments = {
   production: 'https://api.onkernel.com/',
@@ -216,6 +239,13 @@ export class Kernel {
     });
   }
 
+  /**
+   * Check whether the base URL is set to its default.
+   */
+  #baseURLOverridden(): boolean {
+    return this.baseURL !== environments[this._options.environment || 'production'];
+  }
+
   protected defaultQuery(): Record<string, string | undefined> | undefined {
     return this._options.defaultQuery;
   }
@@ -265,11 +295,16 @@ export class Kernel {
     return Errors.APIError.generate(status, error, message, headers);
   }
 
-  buildURL(path: string, query: Record<string, unknown> | null | undefined): string {
+  buildURL(
+    path: string,
+    query: Record<string, unknown> | null | undefined,
+    defaultBaseURL?: string | undefined,
+  ): string {
+    const baseURL = (!this.#baseURLOverridden() && defaultBaseURL) || this.baseURL;
     const url =
       isAbsoluteURL(path) ?
         new URL(path)
-      : new URL(this.baseURL + (this.baseURL.endsWith('/') && path.startsWith('/') ? path.slice(1) : path));
+      : new URL(baseURL + (baseURL.endsWith('/') && path.startsWith('/') ? path.slice(1) : path));
 
     const defaultQuery = this.defaultQuery();
     if (!isEmptyObj(defaultQuery)) {
@@ -610,9 +645,9 @@ export class Kernel {
     { retryCount = 0 }: { retryCount?: number } = {},
   ): { req: FinalizedRequestInit; url: string; timeout: number } {
     const options = { ...inputOptions };
-    const { method, path, query } = options;
+    const { method, path, query, defaultBaseURL } = options;
 
-    const url = this.buildURL(path!, query as Record<string, unknown>);
+    const url = this.buildURL(path!, query as Record<string, unknown>, defaultBaseURL);
     if ('timeout' in options) validatePositiveInteger('timeout', options.timeout);
     options.timeout = options.timeout ?? this.timeout;
     const { bodyHeaders, body } = this.buildBody({ options });
@@ -735,16 +770,40 @@ export class Kernel {
 
   static toFile = Uploads.toFile;
 
+  deployments: API.Deployments = new API.Deployments(this);
   apps: API.Apps = new API.Apps(this);
+  invocations: API.Invocations = new API.Invocations(this);
   browsers: API.Browsers = new API.Browsers(this);
 }
+Kernel.Deployments = Deployments;
 Kernel.Apps = Apps;
+Kernel.Invocations = Invocations;
 Kernel.Browsers = Browsers;
 export declare namespace Kernel {
   export type RequestOptions = Opts.RequestOptions;
 
+  export {
+    Deployments as Deployments,
+    type DeploymentStateEvent as DeploymentStateEvent,
+    type DeploymentCreateResponse as DeploymentCreateResponse,
+    type DeploymentRetrieveResponse as DeploymentRetrieveResponse,
+    type DeploymentFollowResponse as DeploymentFollowResponse,
+    type DeploymentCreateParams as DeploymentCreateParams,
+  };
+
   export { Apps as Apps, type AppListResponse as AppListResponse, type AppListParams as AppListParams };
 
+  export {
+    Invocations as Invocations,
+    type InvocationStateEvent as InvocationStateEvent,
+    type InvocationCreateResponse as InvocationCreateResponse,
+    type InvocationRetrieveResponse as InvocationRetrieveResponse,
+    type InvocationUpdateResponse as InvocationUpdateResponse,
+    type InvocationFollowResponse as InvocationFollowResponse,
+    type InvocationCreateParams as InvocationCreateParams,
+    type InvocationUpdateParams as InvocationUpdateParams,
+  };
+
   export {
     Browsers as Browsers,
     type BrowserPersistence as BrowserPersistence,
@@ -754,4 +813,9 @@ export declare namespace Kernel {
     type BrowserCreateParams as BrowserCreateParams,
     type BrowserDeleteParams as BrowserDeleteParams,
   };
+
+  export type ErrorDetail = API.ErrorDetail;
+  export type ErrorEvent = API.ErrorEvent;
+  export type ErrorModel = API.ErrorModel;
+  export type LogEvent = API.LogEvent;
 }

package/src/core/resource.ts

@@ -2,7 +2,7 @@
 
 import type { Kernel } from '../client';
 
-export class APIResource {
+export abstract class APIResource {
   protected _client: Kernel;
 
   constructor(client: Kernel) {

package/src/internal/headers.ts

@@ -1,5 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { isReadonlyArray } from './utils/values';
+
 type HeaderValue = string | undefined | null;
 export type HeadersLike =
   | Headers
@@ -9,7 +11,7 @@ export type HeadersLike =
   | null
   | NullableHeaders;
 
-const brand_privateNullableHeaders = Symbol('brand.privateNullableHeaders');
+const brand_privateNullableHeaders = /* @__PURE__ */ Symbol('brand.privateNullableHeaders');
 
 /**
  * @internal
@@ -25,8 +27,6 @@ export type NullableHeaders = {
   nulls: Set<string>;
 };
 
-const isArray = Array.isArray as (val: unknown) => val is readonly unknown[];
-
 function* iterateHeaders(headers: HeadersLike): IterableIterator<readonly [string, string | null]> {
   if (!headers) return;
 
@@ -43,7 +43,7 @@ function* iterateHeaders(headers: HeadersLike): IterableIterator<readonly [strin
   let iter: Iterable<readonly (HeaderValue | readonly HeaderValue[])[]>;
   if (headers instanceof Headers) {
     iter = headers.entries();
-  } else if (isArray(headers)) {
+  } else if (isReadonlyArray(headers)) {
     iter = headers;
   } else {
     shouldClear = true;
@@ -52,7 +52,7 @@ function* iterateHeaders(headers: HeadersLike): IterableIterator<readonly [strin
   for (let row of iter) {
     const name = row[0];
     if (typeof name !== 'string') throw new TypeError('expected header name to be a string');
-    const values = isArray(row[1]) ? row[1] : [row[1]];
+    const values = isReadonlyArray(row[1]) ? row[1] : [row[1]];
     let didClear = false;
     for (const value of values) {
       if (value === undefined) continue;

package/src/internal/request-options.ts

@@ -21,6 +21,7 @@ export type RequestOptions = {
   fetchOptions?: MergedRequestInit;
   signal?: AbortSignal | undefined | null;
   idempotencyKey?: string;
+  defaultBaseURL?: string | undefined;
 
   __binaryResponse?: boolean | undefined;
   __streamClass?: typeof Stream;