@onkernel/sdk 0.1.0-alpha.1 → 0.1.0-alpha.10

package/resources/apps.d.mts

@@ -9,9 +9,8 @@ export declare class Apps extends APIResource {
      * @example
      * ```ts
      * const response = await client.apps.deploy({
-     *   appName: 'my-awesome-app',
+     *   entrypointRelPath: 'app.py',
      *   file: fs.createReadStream('path/to/file'),
-     *   version: '1.0.0',
      * });
      * ```
      */
@@ -22,8 +21,9 @@ export declare class Apps extends APIResource {
      * @example
      * ```ts
      * const response = await client.apps.invoke({
+     *   actionName: 'analyze',
      *   appName: 'my-awesome-app',
-     *   payload: '{ "data": "example input" }',
+     *   payload: { data: 'example input' },
      *   version: '1.0.0',
      * });
      * ```
@@ -42,10 +42,7 @@ export declare class Apps extends APIResource {
     retrieveInvocation(id: string, options?: RequestOptions): APIPromise<AppRetrieveInvocationResponse>;
 }
 export interface AppDeployResponse {
-    /**
-     * ID of the deployed app version
-     */
-    id: string;
+    apps: Array<AppDeployResponse.App>;
     /**
      * Success message
      */
@@ -55,6 +52,27 @@ export interface AppDeployResponse {
      */
     success: boolean;
 }
+export declare namespace AppDeployResponse {
+    interface App {
+        /**
+         * ID for the app version deployed
+         */
+        id: string;
+        actions: Array<App.Action>;
+        /**
+         * Name of the app
+         */
+        name: string;
+    }
+    namespace App {
+        interface Action {
+            /**
+             * Name of the action
+             */
+            name: string;
+        }
+    }
+}
 export interface AppInvokeResponse {
     /**
      * ID of the invocation
@@ -63,7 +81,11 @@ export interface AppInvokeResponse {
     /**
      * Status of the invocation
      */
-    status: string;
+    status: 'QUEUED' | 'RUNNING' | 'SUCCEEDED' | 'FAILED';
+    /**
+     * Output from the invocation (if available)
+     */
+    output?: string;
 }
 export interface AppRetrieveInvocationResponse {
     id: string;
@@ -76,23 +98,31 @@ export interface AppRetrieveInvocationResponse {
 }
 export interface AppDeployParams {
     /**
-     * Name of the application
+     * Relative path to the entrypoint of the application
      */
-    appName: string;
+    entrypointRelPath: string;
     /**
-     * ZIP file containing the application
+     * ZIP file containing the application source directory
      */
     file: Uploadable;
     /**
-     * Version of the application
+     * Allow overwriting an existing app version
      */
-    version: string;
+    force?: 'true' | 'false';
     /**
-     * AWS region for deployment (e.g. "aws.us-east-1a")
+     * Region for deployment. Currently we only support "aws.us-east-1a"
      */
-    region?: string;
+    region?: 'aws.us-east-1a';
+    /**
+     * Version of the application. Can be any string.
+     */
+    version?: string;
 }
 export interface AppInvokeParams {
+    /**
+     * Name of the action to invoke
+     */
+    actionName: string;
     /**
      * Name of the application
      */

package/resources/apps.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"apps.d.mts","sourceRoot":"","sources":["../src/resources/apps.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,KAAK,UAAU,EAAE;OACnB,EAAE,cAAc,EAAE;AAIzB,qBAAa,IAAK,SAAQ,WAAW;IACnC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,iBAAiB,CAAC;IAItF;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,iBAAiB,CAAC;IAItF;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,6BAA6B,CAAC;CAGpG;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,6BAA6B;IAC5C,EAAE,EAAE,MAAM,CAAC;IAEX,OAAO,EAAE,MAAM,CAAC;IAEhB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,KAAK,EAAE,MAAM,CAAC;IAEd,MAAM,EAAE,MAAM,CAAC;IAEf,SAAS,EAAE,MAAM,CAAC;IAElB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,6BAA6B,IAAI,6BAA6B,EACnE,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}
+{"version":3,"file":"apps.d.mts","sourceRoot":"","sources":["../src/resources/apps.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,KAAK,UAAU,EAAE;OACnB,EAAE,cAAc,EAAE;AAIzB,qBAAa,IAAK,SAAQ,WAAW;IACnC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,iBAAiB,CAAC;IAItF;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,iBAAiB,CAAC;IAItF;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,6BAA6B,CAAC;CAGpG;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAEnC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,yBAAiB,iBAAiB,CAAC;IACjC,UAAiB,GAAG;QAClB;;WAEG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAE3B;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;KACd;IAED,UAAiB,GAAG,CAAC;QACnB,UAAiB,MAAM;YACrB;;eAEG;YACH,IAAI,EAAE,MAAM,CAAC;SACd;KACF;CACF;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAEtD;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,6BAA6B;IAC5C,EAAE,EAAE,MAAM,CAAC;IAEX,OAAO,EAAE,MAAM,CAAC;IAEhB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,KAAK,EAAE,MAAM,CAAC;IAEd,MAAM,EAAE,MAAM,CAAC;IAEf,SAAS,EAAE,MAAM,CAAC;IAElB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAE1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,6BAA6B,IAAI,6BAA6B,EACnE,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}

package/resources/apps.d.ts

@@ -9,9 +9,8 @@ export declare class Apps extends APIResource {
      * @example
      * ```ts
      * const response = await client.apps.deploy({
-     *   appName: 'my-awesome-app',
+     *   entrypointRelPath: 'app.py',
      *   file: fs.createReadStream('path/to/file'),
-     *   version: '1.0.0',
      * });
      * ```
      */
@@ -22,8 +21,9 @@ export declare class Apps extends APIResource {
      * @example
      * ```ts
      * const response = await client.apps.invoke({
+     *   actionName: 'analyze',
      *   appName: 'my-awesome-app',
-     *   payload: '{ "data": "example input" }',
+     *   payload: { data: 'example input' },
      *   version: '1.0.0',
      * });
      * ```
@@ -42,10 +42,7 @@ export declare class Apps extends APIResource {
     retrieveInvocation(id: string, options?: RequestOptions): APIPromise<AppRetrieveInvocationResponse>;
 }
 export interface AppDeployResponse {
-    /**
-     * ID of the deployed app version
-     */
-    id: string;
+    apps: Array<AppDeployResponse.App>;
     /**
      * Success message
      */
@@ -55,6 +52,27 @@ export interface AppDeployResponse {
      */
     success: boolean;
 }
+export declare namespace AppDeployResponse {
+    interface App {
+        /**
+         * ID for the app version deployed
+         */
+        id: string;
+        actions: Array<App.Action>;
+        /**
+         * Name of the app
+         */
+        name: string;
+    }
+    namespace App {
+        interface Action {
+            /**
+             * Name of the action
+             */
+            name: string;
+        }
+    }
+}
 export interface AppInvokeResponse {
     /**
      * ID of the invocation
@@ -63,7 +81,11 @@ export interface AppInvokeResponse {
     /**
      * Status of the invocation
      */
-    status: string;
+    status: 'QUEUED' | 'RUNNING' | 'SUCCEEDED' | 'FAILED';
+    /**
+     * Output from the invocation (if available)
+     */
+    output?: string;
 }
 export interface AppRetrieveInvocationResponse {
     id: string;
@@ -76,23 +98,31 @@ export interface AppRetrieveInvocationResponse {
 }
 export interface AppDeployParams {
     /**
-     * Name of the application
+     * Relative path to the entrypoint of the application
      */
-    appName: string;
+    entrypointRelPath: string;
     /**
-     * ZIP file containing the application
+     * ZIP file containing the application source directory
      */
     file: Uploadable;
     /**
-     * Version of the application
+     * Allow overwriting an existing app version
      */
-    version: string;
+    force?: 'true' | 'false';
     /**
-     * AWS region for deployment (e.g. "aws.us-east-1a")
+     * Region for deployment. Currently we only support "aws.us-east-1a"
      */
-    region?: string;
+    region?: 'aws.us-east-1a';
+    /**
+     * Version of the application. Can be any string.
+     */
+    version?: string;
 }
 export interface AppInvokeParams {
+    /**
+     * Name of the action to invoke
+     */
+    actionName: string;
     /**
      * Name of the application
      */

package/resources/apps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apps.d.ts","sourceRoot":"","sources":["../src/resources/apps.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,KAAK,UAAU,EAAE;OACnB,EAAE,cAAc,EAAE;AAIzB,qBAAa,IAAK,SAAQ,WAAW;IACnC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,iBAAiB,CAAC;IAItF;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,iBAAiB,CAAC;IAItF;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,6BAA6B,CAAC;CAGpG;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,6BAA6B;IAC5C,EAAE,EAAE,MAAM,CAAC;IAEX,OAAO,EAAE,MAAM,CAAC;IAEhB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,KAAK,EAAE,MAAM,CAAC;IAEd,MAAM,EAAE,MAAM,CAAC;IAEf,SAAS,EAAE,MAAM,CAAC;IAElB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,6BAA6B,IAAI,6BAA6B,EACnE,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}
+{"version":3,"file":"apps.d.ts","sourceRoot":"","sources":["../src/resources/apps.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,KAAK,UAAU,EAAE;OACnB,EAAE,cAAc,EAAE;AAIzB,qBAAa,IAAK,SAAQ,WAAW;IACnC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,iBAAiB,CAAC;IAItF;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,iBAAiB,CAAC;IAItF;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,6BAA6B,CAAC;CAGpG;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAEnC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,yBAAiB,iBAAiB,CAAC;IACjC,UAAiB,GAAG;QAClB;;WAEG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAE3B;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;KACd;IAED,UAAiB,GAAG,CAAC;QACnB,UAAiB,MAAM;YACrB;;eAEG;YACH,IAAI,EAAE,MAAM,CAAC;SACd;KACF;CACF;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAEtD;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,6BAA6B;IAC5C,EAAE,EAAE,MAAM,CAAC;IAEX,OAAO,EAAE,MAAM,CAAC;IAEhB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,KAAK,EAAE,MAAM,CAAC;IAEd,MAAM,EAAE,MAAM,CAAC;IAEf,SAAS,EAAE,MAAM,CAAC;IAElB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAE1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,6BAA6B,IAAI,6BAA6B,EACnE,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}

package/resources/apps.js

@@ -12,9 +12,8 @@ class Apps extends resource_1.APIResource {
      * @example
      * ```ts
      * const response = await client.apps.deploy({
-     *   appName: 'my-awesome-app',
+     *   entrypointRelPath: 'app.py',
      *   file: fs.createReadStream('path/to/file'),
-     *   version: '1.0.0',
      * });
      * ```
      */
@@ -27,8 +26,9 @@ class Apps extends resource_1.APIResource {
      * @example
      * ```ts
      * const response = await client.apps.invoke({
+     *   actionName: 'analyze',
      *   appName: 'my-awesome-app',
-     *   payload: '{ "data": "example input" }',
+     *   payload: { data: 'example input' },
      *   version: '1.0.0',
      * });
      * ```

package/resources/apps.js.map

@@ -1 +1 @@
-{"version":3,"file":"apps.js","sourceRoot":"","sources":["../src/resources/apps.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,oDAAkE;AAClE,oDAA8C;AAE9C,MAAa,IAAK,SAAQ,sBAAW;IACnC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAqB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,IAAA,qCAA2B,EAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5G,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAqB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAU,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,qBAAqB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;CACF;AA9CD,oBA8CC"}
+{"version":3,"file":"apps.js","sourceRoot":"","sources":["../src/resources/apps.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,oDAAkE;AAClE,oDAA8C;AAE9C,MAAa,IAAK,SAAQ,sBAAW;IACnC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,IAAqB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,IAAA,qCAA2B,EAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5G,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAqB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAU,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,qBAAqB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;CACF;AA9CD,oBA8CC"}

package/resources/apps.mjs

@@ -9,9 +9,8 @@ export class Apps extends APIResource {
      * @example
      * ```ts
      * const response = await client.apps.deploy({
-     *   appName: 'my-awesome-app',
+     *   entrypointRelPath: 'app.py',
      *   file: fs.createReadStream('path/to/file'),
-     *   version: '1.0.0',
      * });
      * ```
      */
@@ -24,8 +23,9 @@ export class Apps extends APIResource {
      * @example
      * ```ts
      * const response = await client.apps.invoke({
+     *   actionName: 'analyze',
      *   appName: 'my-awesome-app',
-     *   payload: '{ "data": "example input" }',
+     *   payload: { data: 'example input' },
      *   version: '1.0.0',
      * });
      * ```

package/resources/apps.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"apps.mjs","sourceRoot":"","sources":["../src/resources/apps.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAIf,EAAE,2BAA2B,EAAE;OAC/B,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,IAAK,SAAQ,WAAW;IACnC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAqB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,2BAA2B,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5G,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAqB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAU,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,qBAAqB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;CACF"}
+{"version":3,"file":"apps.mjs","sourceRoot":"","sources":["../src/resources/apps.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAIf,EAAE,2BAA2B,EAAE;OAC/B,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,IAAK,SAAQ,WAAW;IACnC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,IAAqB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,2BAA2B,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5G,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAqB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAU,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,qBAAqB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;CACF"}

package/resources/browser.d.mts

@@ -5,7 +5,7 @@ export declare class Browser extends APIResource {
     /**
      * Create Browser Session
      */
-    createSession(options?: RequestOptions): APIPromise<BrowserCreateSessionResponse>;
+    createSession(body: BrowserCreateSessionParams, options?: RequestOptions): APIPromise<BrowserCreateSessionResponse>;
 }
 export interface BrowserCreateSessionResponse {
     /**
@@ -21,7 +21,13 @@ export interface BrowserCreateSessionResponse {
      */
     sessionId: string;
 }
+export interface BrowserCreateSessionParams {
+    /**
+     * Kernel App invocation ID
+     */
+    invocationId: string;
+}
 export declare namespace Browser {
-    export { type BrowserCreateSessionResponse as BrowserCreateSessionResponse };
+    export { type BrowserCreateSessionResponse as BrowserCreateSessionResponse, type BrowserCreateSessionParams as BrowserCreateSessionParams, };
 }
 //# sourceMappingURL=browser.d.mts.map

package/resources/browser.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.mts","sourceRoot":"","sources":["../src/resources/browser.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,4BAA4B,CAAC;CAGlF;AAED,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EAAE,KAAK,4BAA4B,IAAI,4BAA4B,EAAE,CAAC;CAC9E"}
+{"version":3,"file":"browser.d.mts","sourceRoot":"","sources":["../src/resources/browser.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,aAAa,CACX,IAAI,EAAE,0BAA0B,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,4BAA4B,CAAC;CAG5C;AAED,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,4BAA4B,IAAI,4BAA4B,EACjE,KAAK,0BAA0B,IAAI,0BAA0B,GAC9D,CAAC;CACH"}

package/resources/browser.d.ts

@@ -5,7 +5,7 @@ export declare class Browser extends APIResource {
     /**
      * Create Browser Session
      */
-    createSession(options?: RequestOptions): APIPromise<BrowserCreateSessionResponse>;
+    createSession(body: BrowserCreateSessionParams, options?: RequestOptions): APIPromise<BrowserCreateSessionResponse>;
 }
 export interface BrowserCreateSessionResponse {
     /**
@@ -21,7 +21,13 @@ export interface BrowserCreateSessionResponse {
      */
     sessionId: string;
 }
+export interface BrowserCreateSessionParams {
+    /**
+     * Kernel App invocation ID
+     */
+    invocationId: string;
+}
 export declare namespace Browser {
-    export { type BrowserCreateSessionResponse as BrowserCreateSessionResponse };
+    export { type BrowserCreateSessionResponse as BrowserCreateSessionResponse, type BrowserCreateSessionParams as BrowserCreateSessionParams, };
 }
 //# sourceMappingURL=browser.d.ts.map

package/resources/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/resources/browser.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,4BAA4B,CAAC;CAGlF;AAED,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EAAE,KAAK,4BAA4B,IAAI,4BAA4B,EAAE,CAAC;CAC9E"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/resources/browser.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,aAAa,CACX,IAAI,EAAE,0BAA0B,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,4BAA4B,CAAC;CAG5C;AAED,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,4BAA4B,IAAI,4BAA4B,EACjE,KAAK,0BAA0B,IAAI,0BAA0B,GAC9D,CAAC;CACH"}

package/resources/browser.js

@@ -7,8 +7,8 @@ class Browser extends resource_1.APIResource {
     /**
      * Create Browser Session
      */
-    createSession(options) {
-        return this._client.post('/browser', options);
+    createSession(body, options) {
+        return this._client.post('/browser', { body, ...options });
     }
 }
 exports.Browser = Browser;

package/resources/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/resources/browser.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;OAEG;IACH,aAAa,CAAC,OAAwB;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;CACF;AAPD,0BAOC"}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/resources/browser.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;OAEG;IACH,aAAa,CACX,IAAgC,EAChC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF;AAVD,0BAUC"}

package/resources/browser.mjs

@@ -4,8 +4,8 @@ export class Browser extends APIResource {
     /**
      * Create Browser Session
      */
-    createSession(options) {
-        return this._client.post('/browser', options);
+    createSession(body, options) {
+        return this._client.post('/browser', { body, ...options });
     }
 }
 //# sourceMappingURL=browser.mjs.map

package/resources/browser.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"browser.mjs","sourceRoot":"","sources":["../src/resources/browser.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,aAAa,CAAC,OAAwB;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;CACF"}
+{"version":3,"file":"browser.mjs","sourceRoot":"","sources":["../src/resources/browser.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,aAAa,CACX,IAAgC,EAChC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/resources/index.d.mts

@@ -1,3 +1,3 @@
 export { Apps, type AppDeployResponse, type AppInvokeResponse, type AppRetrieveInvocationResponse, type AppDeployParams, type AppInvokeParams, } from "./apps.mjs";
-export { Browser, type BrowserCreateSessionResponse } from "./browser.mjs";
+export { Browser, type BrowserCreateSessionResponse, type BrowserCreateSessionParams } from "./browser.mjs";
 //# sourceMappingURL=index.d.mts.map

package/resources/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EACL,IAAI,EACJ,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,6BAA6B,EAClC,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB;OACM,EAAE,OAAO,EAAE,KAAK,4BAA4B,EAAE"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EACL,IAAI,EACJ,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,6BAA6B,EAClC,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB;OACM,EAAE,OAAO,EAAE,KAAK,4BAA4B,EAAE,KAAK,0BAA0B,EAAE"}

package/resources/index.d.ts

@@ -1,3 +1,3 @@
 export { Apps, type AppDeployResponse, type AppInvokeResponse, type AppRetrieveInvocationResponse, type AppDeployParams, type AppInvokeParams, } from "./apps.js";
-export { Browser, type BrowserCreateSessionResponse } from "./browser.js";
+export { Browser, type BrowserCreateSessionResponse, type BrowserCreateSessionParams } from "./browser.js";
 //# sourceMappingURL=index.d.ts.map

package/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EACL,IAAI,EACJ,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,6BAA6B,EAClC,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB;OACM,EAAE,OAAO,EAAE,KAAK,4BAA4B,EAAE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EACL,IAAI,EACJ,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,6BAA6B,EAClC,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB;OACM,EAAE,OAAO,EAAE,KAAK,4BAA4B,EAAE,KAAK,0BAA0B,EAAE"}

package/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kCAOgB;AANd,4FAAA,IAAI,OAAA;AAON,wCAAuE;AAA9D,kGAAA,OAAO,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kCAOgB;AANd,4FAAA,IAAI,OAAA;AAON,wCAAwG;AAA/F,kGAAA,OAAO,OAAA"}

package/resources/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,IAAI,GAML;OACM,EAAE,OAAO,EAAqC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,IAAI,GAML;OACM,EAAE,OAAO,EAAsE"}

package/src/client.ts

@@ -28,10 +28,17 @@ import {
   AppRetrieveInvocationResponse,
   Apps,
 } from './resources/apps';
-import { Browser, BrowserCreateSessionResponse } from './resources/browser';
+import { Browser, BrowserCreateSessionParams, BrowserCreateSessionResponse } from './resources/browser';
 import { readEnv } from './internal/utils/env';
 import { formatRequestDetails, loggerFor } from './internal/utils/log';
 import { isEmptyObj } from './internal/utils/values';
+import { KernelApp } from './core/app-framework';
+
+const environments = {
+  production: 'https://api.onkernel.com/',
+  development: 'https://localhost:3001/',
+};
+type Environment = keyof typeof environments;
 
 export interface ClientOptions {
   /**
@@ -39,6 +46,15 @@ export interface ClientOptions {
    */
   apiKey?: string | undefined;
 
+  /**
+   * Specifies the environment to use for the API.
+   *
+   * Each environment maps to a different base URL:
+   * - `production` corresponds to `https://api.onkernel.com/`
+   * - `development` corresponds to `https://localhost:3001/`
+   */
+  environment?: Environment | undefined;
+
   /**
    * Override the default base URL for the API, e.g., "https://api.example.com/v2/"
    *
@@ -128,7 +144,8 @@ export class Kernel {
    * API Client for interfacing with the Kernel API.
    *
    * @param {string | undefined} [opts.apiKey=process.env['KERNEL_API_KEY'] ?? undefined]
-   * @param {string} [opts.baseURL=process.env['KERNEL_BASE_URL'] ?? http://localhost:3001] - Override the default base URL for the API.
+   * @param {Environment} [opts.environment=production] - Specifies the environment URL to use for the API.
+   * @param {string} [opts.baseURL=process.env['KERNEL_BASE_URL'] ?? https://api.onkernel.com/] - Override the default base URL for the API.
    * @param {number} [opts.timeout=1 minute] - The maximum amount of time (in milliseconds) the client will wait for a response before timing out.
    * @param {MergedRequestInit} [opts.fetchOptions] - Additional `RequestInit` options to be passed to `fetch` calls.
    * @param {Fetch} [opts.fetch] - Specify a custom `fetch` function implementation.
@@ -150,10 +167,17 @@ export class Kernel {
     const options: ClientOptions = {
       apiKey,
       ...opts,
-      baseURL: baseURL || `http://localhost:3001`,
+      baseURL,
+      environment: opts.environment ?? 'production',
     };
 
-    this.baseURL = options.baseURL!;
+    if (baseURL && opts.environment) {
+      throw new Errors.KernelError(
+        'Ambiguous URL; The `baseURL` option (or KERNEL_BASE_URL env var) and the `environment` option are given. If you want to use the environment you must pass baseURL: null',
+      );
+    }
+
+    this.baseURL = options.baseURL || environments[options.environment || 'production'];
     this.timeout = options.timeout ?? Kernel.DEFAULT_TIMEOUT /* 1 minute */;
     this.logger = options.logger ?? console;
     const defaultLogLevel = 'warn';
@@ -179,7 +203,8 @@ export class Kernel {
   withOptions(options: Partial<ClientOptions>): this {
     return new (this.constructor as any as new (props: ClientOptions) => typeof this)({
       ...this._options,
-      baseURL: this.baseURL,
+      environment: options.environment ? options.environment : undefined,
+      baseURL: options.environment ? undefined : this.baseURL,
       maxRetries: this.maxRetries,
       timeout: this.timeout,
       logger: this.logger,
@@ -680,6 +705,16 @@ export class Kernel {
     }
   }
 
+  /**
+   * Create a new KernelApp instance.
+   *
+   * @param name - The name of the app to create.
+   * @returns A new KernelApp instance you can attach actions to.
+   */
+  public app(name: string): KernelApp {
+    return new KernelApp(name);
+  }
+
   static Kernel = this;
   static DEFAULT_TIMEOUT = 60000; // 1 minute
 
@@ -716,5 +751,9 @@ export declare namespace Kernel {
     type AppInvokeParams as AppInvokeParams,
   };
 
-  export { Browser as Browser, type BrowserCreateSessionResponse as BrowserCreateSessionResponse };
+  export {
+    Browser as Browser,
+    type BrowserCreateSessionResponse as BrowserCreateSessionResponse,
+    type BrowserCreateSessionParams as BrowserCreateSessionParams,
+  };
 }