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

package/src/core/app-framework.ts

@@ -0,0 +1,137 @@
+export interface KernelContext {
+  invocationId: string;
+}
+
+export interface KernelAction {
+  name: string;
+  handler: (context: KernelContext, input: any) => Promise<any>;
+}
+
+export interface KernelJson {
+  apps: KernelAppJson[];
+}
+
+export interface KernelAppJson {
+  name: string;
+  actions: KernelActionJson[];
+}
+
+export interface KernelActionJson {
+  name: string;
+}
+
+export class KernelApp {
+  name: string;
+  actions: Map<string, KernelAction> = new Map();
+
+  constructor(name: string) {
+    this.name = name;
+    // Register this app in the global registry
+    appRegistry.registerApp(this);
+  }
+
+  /**
+   * Define an action
+   */
+  action<T, R>(
+    nameOrHandler: string | ((input: T) => Promise<R>) | ((context: KernelContext, input: T) => Promise<R>),
+    handler?: ((input: T) => Promise<R>) | ((context: KernelContext, input: T) => Promise<R>),
+  ) {
+    let actionName: string;
+    let actionHandler: (context: KernelContext, input: T) => Promise<R>;
+
+    if (typeof nameOrHandler === 'string' && handler) {
+      // Case: app.action("name", handler)
+      actionName = nameOrHandler;
+
+      // Create a handler that accepts context and input, adapting if needed
+      if (handler.length === 1) {
+        // Original handler only takes input, so we adapt it to the new signature
+        const singleArgHandler = handler as (input: T) => Promise<R>;
+        actionHandler = async (context: KernelContext, input: T) => singleArgHandler(input);
+      } else {
+        // Handler takes both context and input
+        actionHandler = handler as (context: KernelContext, input: T) => Promise<R>;
+      }
+    } else if (typeof nameOrHandler === 'function') {
+      // Case: app.action(handler)
+      actionName = nameOrHandler.name || 'default';
+
+      // Create a handler that accepts context and input, adapting if needed
+      if (nameOrHandler.length === 1) {
+        // Original handler only takes input, so we adapt it to the new signature
+        const singleArgHandler = nameOrHandler as (input: T) => Promise<R>;
+        actionHandler = async (context: KernelContext, input: T) => singleArgHandler(input);
+      } else {
+        // Handler takes both context and input
+        actionHandler = nameOrHandler as (context: KernelContext, input: T) => Promise<R>;
+      }
+    } else {
+      throw new Error('Invalid action definition');
+    }
+
+    // Register the action
+    this.actions.set(actionName, {
+      name: actionName,
+      handler: actionHandler,
+    });
+
+    return actionHandler;
+  }
+
+  /**
+   * Get all actions for this app
+   */
+  getActions(): KernelAction[] {
+    return Array.from(this.actions.values());
+  }
+
+  /**
+   * Get an action by name
+   */
+  getAction(name: string): KernelAction | undefined {
+    return this.actions.get(name);
+  }
+
+  /**
+   * Export app information without handlers
+   */
+  toJSON(): KernelAppJson {
+    return {
+      name: this.name,
+      actions: this.getActions().map((action) => ({
+        name: action.name,
+      })),
+    };
+  }
+}
+
+// Registry for storing all Kernel apps
+class KernelAppRegistry {
+  private apps: Map<string, KernelApp> = new Map();
+
+  registerApp(app: KernelApp): void {
+    this.apps.set(app.name, app);
+  }
+
+  getApps(): KernelApp[] {
+    return Array.from(this.apps.values());
+  }
+
+  getAppByName(name: string): KernelApp | undefined {
+    return this.apps.get(name);
+  }
+
+  export(): KernelJson {
+    return {
+      apps: this.getApps().map((app) => app.toJSON()),
+    };
+  }
+
+  exportJSON(): string {
+    return JSON.stringify(this.export(), null, 2);
+  }
+}
+
+// Create a singleton registry for apps
+export const appRegistry = new KernelAppRegistry();

package/src/index.ts

@@ -20,3 +20,5 @@ export {
   PermissionDeniedError,
   UnprocessableEntityError,
 } from './core/error';
+
+export { KernelAction, KernelContext, KernelJson, appRegistry } from './core/app-framework';

package/src/internal/headers.ts

@@ -71,8 +71,8 @@ function* iterateHeaders(headers: HeadersLike): IterableIterator<readonly [strin
 export const buildHeaders = (newHeaders: HeadersLike[]): NullableHeaders => {
   const targetHeaders = new Headers();
   const nullHeaders = new Set<string>();
-  const seenHeaders = new Set<string>();
   for (const headers of newHeaders) {
+    const seenHeaders = new Set<string>();
     for (const [name, value] of iterateHeaders(headers)) {
       const lowerName = name.toLowerCase();
       if (!seenHeaders.has(lowerName)) {

package/src/resources/apps.ts

@@ -14,9 +14,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',
    * });
    * ```
    */
@@ -30,8 +29,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',
    * });
    * ```
@@ -56,10 +56,7 @@ export class Apps extends APIResource {
 }
 
 export interface AppDeployResponse {
-  /**
-   * ID of the deployed app version
-   */
-  id: string;
+  apps: Array<AppDeployResponse.App>;
 
   /**
    * Success message
@@ -72,6 +69,31 @@ export interface AppDeployResponse {
   success: boolean;
 }
 
+export namespace AppDeployResponse {
+  export interface App {
+    /**
+     * ID for the app version deployed
+     */
+    id: string;
+
+    actions: Array<App.Action>;
+
+    /**
+     * Name of the app
+     */
+    name: string;
+  }
+
+  export namespace App {
+    export interface Action {
+      /**
+       * Name of the action
+       */
+      name: string;
+    }
+  }
+}
+
 export interface AppInvokeResponse {
   /**
    * ID of the invocation
@@ -81,7 +103,12 @@ 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 {
@@ -102,27 +129,37 @@ 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/src/resources/browser.ts

@@ -8,8 +8,11 @@ export class Browser extends APIResource {
   /**
    * Create Browser Session
    */
-  createSession(options?: RequestOptions): APIPromise<BrowserCreateSessionResponse> {
-    return this._client.post('/browser', options);
+  createSession(
+    body: BrowserCreateSessionParams,
+    options?: RequestOptions,
+  ): APIPromise<BrowserCreateSessionResponse> {
+    return this._client.post('/browser', { body, ...options });
   }
 }
 
@@ -30,6 +33,16 @@ 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,
+  };
 }

package/src/resources/index.ts

@@ -8,4 +8,4 @@ export {
   type AppDeployParams,
   type AppInvokeParams,
 } from './apps';
-export { Browser, type BrowserCreateSessionResponse } from './browser';
+export { Browser, type BrowserCreateSessionResponse, type BrowserCreateSessionParams } from './browser';

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.1.0-alpha.1'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.10'; // x-release-please-version

package/version.d.mts

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

package/version.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,kBAAkB,CAAC"}
+{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,mBAAmB,CAAC"}

package/version.d.ts

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

package/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,kBAAkB,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,mBAAmB,CAAC"}

package/version.js

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

package/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,eAAe,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,gBAAgB,CAAC,CAAC,2BAA2B"}

package/version.mjs

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

package/version.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,gBAAgB,CAAC,CAAC,2BAA2B"}