@onkernel/sdk 0.0.1-alpha.1

package/README.md

@@ -0,0 +1,15 @@
+# sdk
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run index.ts
+```
+
+This project was created using `bun init` in bun v1.2.9. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime.

package/dist/index.cjs

@@ -0,0 +1,71 @@
+'use strict';
+
+// src/index.ts
+var KernelRegistry = class {
+  registry = /* @__PURE__ */ new Map();
+  register(item) {
+    this.registry.set(item.name, item);
+  }
+  getAll() {
+    return Array.from(this.registry.values());
+  }
+  getByName(name) {
+    return this.registry.get(name);
+  }
+  getByType(type) {
+    return this.getAll().filter((item) => item.type === type);
+  }
+};
+var registry = new KernelRegistry();
+var Kernel = {
+  /**
+   * Define a scheduled function
+   */
+  schedule: (cronExpression, fn) => {
+    registry.register({
+      type: "schedule",
+      name: fn.name || `schedule_${cronExpression.replace(/\s+/g, "_")}`,
+      cron: cronExpression,
+      handler: fn
+    });
+    return fn;
+  },
+  /**
+   * Define an HTTP endpoint
+   */
+  endpoint: (options, handler) => {
+    registry.register({
+      type: "http",
+      name: handler.name || `endpoint_${options.method.toLowerCase()}_${options.path.replace(/\//g, "_")}`,
+      path: options.path,
+      method: options.method,
+      handler
+    });
+    return handler;
+  },
+  /**
+   * Use a browser for automation
+   * The returned browser object contains cdp_ws_url which should be used with playwright:
+   * const browser = await chromium.connectOverCDP(cdp_ws_url);
+   */
+  useBrowser: (fn) => {
+    return fn({
+      cdp_ws_url: "ws://localhost:9222"
+    });
+  },
+  /**
+   * Define a function
+   */
+  func: (fn) => {
+    const name = fn.name || "default";
+    registry.register({
+      type: "function",
+      name,
+      handler: fn
+    });
+    return fn;
+  }
+};
+
+exports.Kernel = Kernel;
+exports.registry = registry;

package/dist/index.d.cts

@@ -0,0 +1,59 @@
+interface Request {
+    query: Record<string, string>;
+    body?: any;
+}
+interface Browser {
+    cdp_ws_url: string;
+}
+interface KernelFunction {
+    type: 'function';
+    name: string;
+    handler: (...args: any[]) => Promise<any>;
+}
+interface KernelSchedule {
+    type: 'schedule';
+    name: string;
+    cron: string;
+    handler: () => Promise<void>;
+}
+interface KernelEndpoint {
+    type: 'http';
+    name: string;
+    path: string;
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    handler: (req: Request) => Promise<any>;
+}
+type KernelRegistryItem = KernelFunction | KernelSchedule | KernelEndpoint;
+declare class KernelRegistry {
+    private registry;
+    register(item: KernelRegistryItem): void;
+    getAll(): KernelRegistryItem[];
+    getByName(name: string): KernelRegistryItem | undefined;
+    getByType(type: 'function' | 'schedule' | 'http'): KernelRegistryItem[];
+}
+declare const registry: KernelRegistry;
+declare const Kernel: {
+    /**
+     * Define a scheduled function
+     */
+    schedule: (cronExpression: string, fn: () => Promise<void>) => () => Promise<void>;
+    /**
+     * Define an HTTP endpoint
+     */
+    endpoint: <T>(options: {
+        path: string;
+        method: string;
+    }, handler: (req: Request) => Promise<T>) => (req: Request) => Promise<T>;
+    /**
+     * Use a browser for automation
+     * The returned browser object contains cdp_ws_url which should be used with playwright:
+     * const browser = await chromium.connectOverCDP(cdp_ws_url);
+     */
+    useBrowser: <T>(fn: (browser: Browser) => Promise<T>) => Promise<T>;
+    /**
+     * Define a function
+     */
+    func: <T, R>(fn: (input: T) => Promise<R>) => (input: T) => Promise<R>;
+};
+
+export { type Browser, Kernel, type KernelEndpoint, type KernelFunction, type KernelRegistryItem, type KernelSchedule, type Request, registry };

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+interface Request {
+    query: Record<string, string>;
+    body?: any;
+}
+interface Browser {
+    cdp_ws_url: string;
+}
+interface KernelFunction {
+    type: 'function';
+    name: string;
+    handler: (...args: any[]) => Promise<any>;
+}
+interface KernelSchedule {
+    type: 'schedule';
+    name: string;
+    cron: string;
+    handler: () => Promise<void>;
+}
+interface KernelEndpoint {
+    type: 'http';
+    name: string;
+    path: string;
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    handler: (req: Request) => Promise<any>;
+}
+type KernelRegistryItem = KernelFunction | KernelSchedule | KernelEndpoint;
+declare class KernelRegistry {
+    private registry;
+    register(item: KernelRegistryItem): void;
+    getAll(): KernelRegistryItem[];
+    getByName(name: string): KernelRegistryItem | undefined;
+    getByType(type: 'function' | 'schedule' | 'http'): KernelRegistryItem[];
+}
+declare const registry: KernelRegistry;
+declare const Kernel: {
+    /**
+     * Define a scheduled function
+     */
+    schedule: (cronExpression: string, fn: () => Promise<void>) => () => Promise<void>;
+    /**
+     * Define an HTTP endpoint
+     */
+    endpoint: <T>(options: {
+        path: string;
+        method: string;
+    }, handler: (req: Request) => Promise<T>) => (req: Request) => Promise<T>;
+    /**
+     * Use a browser for automation
+     * The returned browser object contains cdp_ws_url which should be used with playwright:
+     * const browser = await chromium.connectOverCDP(cdp_ws_url);
+     */
+    useBrowser: <T>(fn: (browser: Browser) => Promise<T>) => Promise<T>;
+    /**
+     * Define a function
+     */
+    func: <T, R>(fn: (input: T) => Promise<R>) => (input: T) => Promise<R>;
+};
+
+export { type Browser, Kernel, type KernelEndpoint, type KernelFunction, type KernelRegistryItem, type KernelSchedule, type Request, registry };

package/dist/index.js

@@ -0,0 +1,68 @@
+// src/index.ts
+var KernelRegistry = class {
+  registry = /* @__PURE__ */ new Map();
+  register(item) {
+    this.registry.set(item.name, item);
+  }
+  getAll() {
+    return Array.from(this.registry.values());
+  }
+  getByName(name) {
+    return this.registry.get(name);
+  }
+  getByType(type) {
+    return this.getAll().filter((item) => item.type === type);
+  }
+};
+var registry = new KernelRegistry();
+var Kernel = {
+  /**
+   * Define a scheduled function
+   */
+  schedule: (cronExpression, fn) => {
+    registry.register({
+      type: "schedule",
+      name: fn.name || `schedule_${cronExpression.replace(/\s+/g, "_")}`,
+      cron: cronExpression,
+      handler: fn
+    });
+    return fn;
+  },
+  /**
+   * Define an HTTP endpoint
+   */
+  endpoint: (options, handler) => {
+    registry.register({
+      type: "http",
+      name: handler.name || `endpoint_${options.method.toLowerCase()}_${options.path.replace(/\//g, "_")}`,
+      path: options.path,
+      method: options.method,
+      handler
+    });
+    return handler;
+  },
+  /**
+   * Use a browser for automation
+   * The returned browser object contains cdp_ws_url which should be used with playwright:
+   * const browser = await chromium.connectOverCDP(cdp_ws_url);
+   */
+  useBrowser: (fn) => {
+    return fn({
+      cdp_ws_url: "ws://localhost:9222"
+    });
+  },
+  /**
+   * Define a function
+   */
+  func: (fn) => {
+    const name = fn.name || "default";
+    registry.register({
+      type: "function",
+      name,
+      handler: fn
+    });
+    return fn;
+  }
+};
+
+export { Kernel, registry };

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@onkernel/sdk",
+  "version": "0.0.1-alpha.1",
+  "type": "module",
+  "module": "index.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts --format esm,cjs"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "tsup": "^8.4.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "kernel",
+    "cli",
+    "ai",
+    "llm",
+    "llms",
+    "agent",
+    "agents",
+    "dev",
+    "development",
+    "deploy",
+    "deployment",
+    "build",
+    "workflow",
+    "typescript",
+    "command-line",
+    "devtools"
+  ]
+}