@run-cloud/sdk 0.5.1 → 0.7.0

package/dist/compat/modal.js

@@ -0,0 +1,181 @@
+import { compatibilityClient, createNative, getNative, listNative, unsupported, } from "./common.js";
+export class Image {
+    ref;
+    constructor(ref) {
+        this.ref = ref;
+    }
+    static fromRegistry(ref) {
+        return new Image(ref);
+    }
+    static debianSlim() {
+        return new Image("debian:12-slim");
+    }
+    aptInstall() {
+        return unsupported("Modal", "Image.aptInstall", "register a prebuilt OCI image with run.cloud");
+    }
+    pipInstall() {
+        return unsupported("Modal", "Image.pipInstall", "register a prebuilt OCI image with run.cloud");
+    }
+    runCommands() {
+        return unsupported("Modal", "Image.runCommands", "register a prebuilt OCI image with run.cloud");
+    }
+    env() {
+        return unsupported("Modal", "Image.env", "register a prebuilt OCI image with run.cloud");
+    }
+    workdir() {
+        return unsupported("Modal", "Image.workdir", "register a prebuilt OCI image with run.cloud");
+    }
+}
+export class ContainerProcess {
+    result;
+    stdout;
+    stderr;
+    returnCode = null;
+    constructor(result) {
+        this.result = result;
+        this.stdout = {
+            read: async () => (await this.result).stdout,
+            readText: async () => (await this.result).stdout,
+        };
+        this.stderr = {
+            read: async () => (await this.result).stderr,
+            readText: async () => (await this.result).stderr,
+        };
+    }
+    async wait() {
+        this.returnCode = (await this.result).exitCode;
+        return this.returnCode;
+    }
+    poll() {
+        return this.returnCode;
+    }
+    get returncode() {
+        return this.returnCode;
+    }
+}
+export class App {
+    name;
+    client;
+    constructor(name, client) {
+        this.name = name;
+        this.client = client;
+    }
+    static async lookup(name, options = {}) {
+        return new App(name, compatibilityClient(options));
+    }
+    async createSandbox(image, options = {}) {
+        return await Sandbox.create({ ...options, app: this, image });
+    }
+}
+export class ModalClient {
+    options;
+    apps = {
+        fromName: async (name, options = {}) => await App.lookup(name, { ...this.options, ...options }),
+    };
+    images = {
+        fromRegistry: (ref) => Image.fromRegistry(ref),
+        debianSlim: () => Image.debianSlim(),
+    };
+    sandboxes = {
+        create: async (app, image, options = {}) => await Sandbox.create({
+            app,
+            image,
+            command: options.command,
+            cpu: options.cpu,
+            memory: options.memoryMiB,
+            timeout: options.timeoutMs ? Math.ceil(options.timeoutMs / 1000) : undefined,
+            idleTimeout: options.idleTimeoutMs
+                ? Math.ceil(options.idleTimeoutMs / 1000)
+                : undefined,
+            name: options.name,
+            region: options.regions?.[0],
+            volumes: options.volumes,
+        }),
+        fromId: async (sandboxId) => await Sandbox.fromId(sandboxId, compatibilityClient(this.options)),
+        fromName: async (appName, name) => await Sandbox.fromName(await App.lookup(appName, this.options), name),
+    };
+    constructor(options = {}) {
+        this.options = options;
+    }
+}
+export class Sandbox {
+    native;
+    app;
+    entrypoint;
+    constructor(native, app) {
+        this.native = native;
+        this.app = app;
+    }
+    static async create(options = {}) {
+        if (options.volumes)
+            unsupported("Modal", "volumes");
+        if (Array.isArray(options.cpu)) {
+            unsupported("Modal", "CPU request/limit tuples", "pass a single CPU reservation");
+        }
+        const client = options.app?.client ?? compatibilityClient();
+        const native = await createNative(client, {
+            image: options.image instanceof Image ? options.image.ref : options.image,
+            cpu: options.cpu,
+            memory: options.memory,
+            timeoutSeconds: options.timeout,
+            idlePauseSeconds: options.idleTimeout,
+            name: options.name,
+            region: options.region,
+        });
+        const sandbox = new Sandbox(native, options.app);
+        if (options.command?.length)
+            sandbox.entrypoint = sandbox.exec(options.command);
+        return sandbox;
+    }
+    static async fromId(id, client) {
+        const actualClient = client ?? compatibilityClient();
+        return new Sandbox(await getNative(actualClient, id));
+    }
+    static async fromName(app, name) {
+        const match = (await listNative(app.client)).find((sandbox) => sandbox.name === name);
+        if (!match)
+            throw new Error(`no sandbox named ${name}`);
+        return new Sandbox(match, app);
+    }
+    static async list(app) {
+        const client = app?.client ?? compatibilityClient();
+        return (await listNative(client)).map((sandbox) => new Sandbox(sandbox, app));
+    }
+    get objectId() {
+        return this.native.id;
+    }
+    get sandboxId() {
+        return this.native.id;
+    }
+    exec(command, options = {}) {
+        return new ContainerProcess(this.native.exec(command, {
+            cwd: options.workdir,
+            env: options.env,
+            timeoutSeconds: options.timeout,
+        }));
+    }
+    async terminate() {
+        await this.native.destroy();
+        return this.entrypoint?.returncode ?? null;
+    }
+    detach() { }
+    async poll() {
+        await this.native.refresh();
+        return ["running", "starting", "pending", "creating"].includes(this.native.state) ? null : 0;
+    }
+    tunnels() {
+        return unsupported("Modal", "tunnels", "run.cloud public port capabilities are not available in the SDK yet");
+    }
+    setTags() {
+        return unsupported("Modal", "server-side tags", "use the native sandbox name field");
+    }
+}
+export class Probe {
+    static withTcp() {
+        return unsupported("Modal", "TCP readiness probes");
+    }
+    static withExec() {
+        return unsupported("Modal", "exec readiness probes");
+    }
+}
+//# sourceMappingURL=modal.js.map

package/dist/compat/modal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modal.js","sourceRoot":"","sources":["../../src/compat/modal.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,UAAU,EAGV,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,MAAM,OAAO,KAAK;IACa;IAA7B,YAA6B,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IAAG,CAAC;IAE5C,MAAM,CAAC,YAAY,CAAC,GAAW;QAC7B,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,UAAU;QACf,OAAO,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACrC,CAAC;IAED,UAAU;QACR,OAAO,WAAW,CAAC,OAAO,EAAE,kBAAkB,EAAE,8CAA8C,CAAC,CAAC;IAClG,CAAC;IAED,UAAU;QACR,OAAO,WAAW,CAAC,OAAO,EAAE,kBAAkB,EAAE,8CAA8C,CAAC,CAAC;IAClG,CAAC;IAED,WAAW;QACT,OAAO,WAAW,CAAC,OAAO,EAAE,mBAAmB,EAAE,8CAA8C,CAAC,CAAC;IACnG,CAAC;IAED,GAAG;QACD,OAAO,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,8CAA8C,CAAC,CAAC;IAC3F,CAAC;IAED,OAAO;QACL,OAAO,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,8CAA8C,CAAC,CAAC;IAC/F,CAAC;CACF;AAED,MAAM,OAAO,gBAAgB;IAKE;IAJpB,MAAM,CAA2D;IACjE,MAAM,CAA2D;IAClE,UAAU,GAAkB,IAAI,CAAC;IAEzC,YAA6B,MAAqE;QAArE,WAAM,GAAN,MAAM,CAA+D;QAChG,IAAI,CAAC,MAAM,GAAG;YACZ,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM;YAC5C,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM;SACjD,CAAC;QACF,IAAI,CAAC,MAAM,GAAG;YACZ,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM;YAC5C,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM;SACjD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,UAAU,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC;QAC/C,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,GAAG;IAEH;IACA;IAFX,YACW,IAAY,EACZ,MAAc;QADd,SAAI,GAAJ,IAAI,CAAQ;QACZ,WAAM,GAAN,MAAM,CAAQ;IACtB,CAAC;IAEJ,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,IAAY,EACZ,UAAsE,EAAE;QAExE,OAAO,IAAI,GAAG,CAAC,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,KAAsB,EACtB,UAAgD,EAAE;QAElD,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;CACF;AAED,MAAM,OAAO,WAAW;IAgDO;IA/CpB,IAAI,GAAG;QACd,QAAQ,EAAE,KAAK,EACb,IAAY,EACZ,UAAsE,EAAE,EAC1D,EAAE,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;KAC3E,CAAC;IAEO,MAAM,GAAG;QAChB,YAAY,EAAE,CAAC,GAAW,EAAS,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC;QAC7D,UAAU,EAAE,GAAU,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE;KAC5C,CAAC;IAEO,SAAS,GAAG;QACnB,MAAM,EAAE,KAAK,EACX,GAAQ,EACR,KAAY,EACZ,UASI,EAAE,EACY,EAAE,CACpB,MAAM,OAAO,CAAC,MAAM,CAAC;YACnB,GAAG;YACH,KAAK;YACL,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM,EAAE,OAAO,CAAC,SAAS;YACzB,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;YAC5E,WAAW,EAAE,OAAO,CAAC,aAAa;gBAChC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;gBACzC,CAAC,CAAC,SAAS;YACb,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;QACJ,MAAM,EAAE,KAAK,EAAE,SAAiB,EAAoB,EAAE,CACpD,MAAM,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpE,QAAQ,EAAE,KAAK,EAAE,OAAe,EAAE,IAAY,EAAoB,EAAE,CAClE,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;KACxE,CAAC;IAEF,YAA6B,UAAsC,EAAE;QAAxC,YAAO,GAAP,OAAO,CAAiC;IAAG,CAAC;CAC1E;AAeD,MAAM,OAAO,OAAO;IAIP;IACQ;IAJX,UAAU,CAAoB;IAEtC,YACW,MAAqB,EACb,GAAS;QADjB,WAAM,GAAN,MAAM,CAAe;QACb,QAAG,GAAH,GAAG,CAAM;IACzB,CAAC;IAEJ,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,UAAyB,EAAE;QAC7C,IAAI,OAAO,CAAC,OAAO;YAAE,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACrD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,WAAW,CAAC,OAAO,EAAE,0BAA0B,EAAE,+BAA+B,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,IAAI,mBAAmB,EAAE,CAAC;QAC5D,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;YACxC,KAAK,EAAE,OAAO,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK;YACzE,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,cAAc,EAAE,OAAO,CAAC,OAAO;YAC/B,gBAAgB,EAAE,OAAO,CAAC,WAAW;YACrC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,OAAO,CAAC,OAAO,EAAE,MAAM;YAAE,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAChF,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,MAAe;QAC7C,MAAM,YAAY,GAAG,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACrD,OAAO,IAAI,OAAO,CAAC,MAAM,SAAS,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAQ,EAAE,IAAY;QAC1C,MAAM,KAAK,GAAG,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACtF,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;QACxD,OAAO,IAAI,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAS;QACzB,MAAM,MAAM,GAAG,GAAG,EAAE,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACpD,OAAO,CAAC,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IACxB,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IACxB,CAAC;IAED,IAAI,CACF,OAA0B,EAC1B,UAAgF,EAAE;QAElF,OAAO,IAAI,gBAAgB,CACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;YACxB,GAAG,EAAE,OAAO,CAAC,OAAO;YACpB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,cAAc,EAAE,OAAO,CAAC,OAAO;SAChC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,UAAU,EAAE,UAAU,IAAI,IAAI,CAAC;IAC7C,CAAC;IAED,MAAM,KAAU,CAAC;IAEjB,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC5B,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/F,CAAC;IAED,OAAO;QACL,OAAO,WAAW,CAChB,OAAO,EACP,SAAS,EACT,qEAAqE,CACtE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,WAAW,CAAC,OAAO,EAAE,kBAAkB,EAAE,mCAAmC,CAAC,CAAC;IACvF,CAAC;CACF;AAED,MAAM,OAAO,KAAK;IAChB,MAAM,CAAC,OAAO;QACZ,OAAO,WAAW,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,CAAC,QAAQ;QACb,OAAO,WAAW,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/compat/sprites.d.ts

@@ -0,0 +1,38 @@
+import { type CompatibilityClientOptions, type NativeSandbox } from "./common.js";
+export declare class Sprite {
+    readonly native: NativeSandbox;
+    readonly name: string;
+    constructor(native: NativeSandbox, name: string);
+    exec(command: string, options?: {
+        cwd?: string;
+        env?: Record<string, string>;
+    }): Promise<import("../index.js").ExecResult>;
+    execFile(file: string, args?: string[], options?: {
+        cwd?: string;
+        env?: Record<string, string>;
+    }): Promise<import("../index.js").ExecResult>;
+    run(command: string, options?: {
+        cwd?: string;
+        env?: Record<string, string>;
+    }): Promise<import("../index.js").ExecResult>;
+    filesystem(): never;
+    url(): never;
+    delete(): Promise<void>;
+}
+export declare class SpritesClient {
+    private readonly options;
+    constructor(tokenOrOptions?: string | CompatibilityClientOptions, options?: CompatibilityClientOptions);
+    private find;
+    createSprite(name: string, options?: {
+        image?: string;
+        region?: string;
+        ramMB?: number;
+        cpus?: number;
+        storageGB?: number;
+    }): Promise<Sprite>;
+    sprite(name: string): Promise<Sprite>;
+    getSprite(name: string): Promise<Sprite>;
+    listSprites(): Promise<Sprite[]>;
+    destroySprite(name: string): Promise<void>;
+    deleteSprite(name: string): Promise<void>;
+}

package/dist/compat/sprites.js

@@ -0,0 +1,67 @@
+import { compatibilityClient, createNative, listNative, unsupported, } from "./common.js";
+export class Sprite {
+    native;
+    name;
+    constructor(native, name) {
+        this.native = native;
+        this.name = name;
+    }
+    async exec(command, options = {}) {
+        return await this.native.exec(command, options);
+    }
+    async execFile(file, args = [], options = {}) {
+        return await this.native.exec([file, ...args], options);
+    }
+    run(command, options = {}) {
+        return this.exec(command, options);
+    }
+    filesystem() {
+        return unsupported("Fly Sprites", "filesystem writes and listing");
+    }
+    url() {
+        return unsupported("Fly Sprites", "public URLs", "run.cloud public port capabilities are not available in the SDK yet");
+    }
+    async delete() {
+        await this.native.destroy();
+    }
+}
+export class SpritesClient {
+    options;
+    constructor(tokenOrOptions = {}, options = {}) {
+        this.options = typeof tokenOrOptions === "string" ? options : tokenOrOptions;
+    }
+    async find(name) {
+        return (await listNative(compatibilityClient(this.options))).find((sandbox) => sandbox.name === name);
+    }
+    async createSprite(name, options = {}) {
+        const client = compatibilityClient(this.options);
+        return new Sprite(await createNative(client, {
+            name,
+            image: options.image,
+            region: options.region,
+            memory: options.ramMB,
+            cpu: options.cpus,
+            disk: options.storageGB,
+        }), name);
+    }
+    async sprite(name) {
+        const existing = await this.find(name);
+        return existing ? new Sprite(existing, name) : await this.createSprite(name);
+    }
+    async getSprite(name) {
+        const existing = await this.find(name);
+        if (!existing)
+            throw new Error(`no sprite named ${name}`);
+        return new Sprite(existing, name);
+    }
+    async listSprites() {
+        return (await listNative(compatibilityClient(this.options))).map((sandbox) => new Sprite(sandbox, sandbox.name));
+    }
+    async destroySprite(name) {
+        await (await this.getSprite(name)).delete();
+    }
+    async deleteSprite(name) {
+        await this.destroySprite(name);
+    }
+}
+//# sourceMappingURL=sprites.js.map

package/dist/compat/sprites.js.map

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

package/dist/compat/vercel.d.ts

@@ -0,0 +1,50 @@
+import { type CompatibilityClientOptions, type NativeSandbox } from "./common.js";
+export interface CreateOpts extends CompatibilityClientOptions {
+    runtime?: string;
+    image?: string;
+    resources?: {
+        vcpus?: number;
+        memory?: number;
+    };
+    timeout?: number;
+    region?: string;
+    name?: string;
+}
+export interface CommandFinished {
+    exitCode: number;
+    stdout(): Promise<string>;
+    stderr(): Promise<string>;
+    output(stream?: "stdout" | "stderr" | "both"): Promise<string>;
+}
+export declare class Sandbox {
+    readonly native: NativeSandbox;
+    private readonly client;
+    readonly runtime?: string | undefined;
+    private constructor();
+    static create(options?: CreateOpts): Promise<Sandbox>;
+    static get(id: string | {
+        id?: string;
+        name?: string;
+    }, options?: CompatibilityClientOptions): Promise<Sandbox>;
+    static list(options?: CompatibilityClientOptions): Promise<Sandbox[]>;
+    get sandboxId(): string;
+    get name(): string;
+    runCommand(command: string, args?: string[], options?: {
+        cwd?: string;
+        env?: Record<string, string>;
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<CommandFinished>;
+    runCommandDetached(): never;
+    readFileToBuffer(options: {
+        path: string;
+    }): Promise<Uint8Array>;
+    readFile(options: {
+        path: string;
+    }): Promise<string>;
+    writeFiles(): never;
+    mkDir(): never;
+    domain(): never;
+    stop(): Promise<void>;
+    delete(): Promise<void>;
+}

package/dist/compat/vercel.js

@@ -0,0 +1,84 @@
+import { bytesToText, compatibilityClient, createNative, getNative, listNative, unsupported, } from "./common.js";
+function finished(exitCode, stdout, stderr) {
+    return {
+        exitCode,
+        stdout: async () => stdout,
+        stderr: async () => stderr,
+        output: async (stream = "both") => stream === "stdout" ? stdout : stream === "stderr" ? stderr : stdout + stderr,
+    };
+}
+export class Sandbox {
+    native;
+    client;
+    runtime;
+    constructor(native, client, runtime) {
+        this.native = native;
+        this.client = client;
+        this.runtime = runtime;
+    }
+    static async create(options = {}) {
+        const client = compatibilityClient(options);
+        return new Sandbox(await createNative(client, {
+            image: options.image,
+            cpu: options.resources?.vcpus,
+            memory: options.resources?.memory,
+            timeoutSeconds: options.timeout ? Math.ceil(options.timeout / 1000) : undefined,
+            region: options.region,
+            name: options.name,
+        }), client, options.runtime);
+    }
+    static async get(id, options = {}) {
+        const client = compatibilityClient(options);
+        const sandboxId = typeof id === "string"
+            ? id
+            : id.sandboxId ?? id.id ?? id.name;
+        if (!sandboxId)
+            throw new Error("sandbox id is required");
+        return new Sandbox(await getNative(client, sandboxId), client);
+    }
+    static async list(options = {}) {
+        const client = compatibilityClient(options);
+        return (await listNative(client)).map((sandbox) => new Sandbox(sandbox, client));
+    }
+    get sandboxId() {
+        return this.native.id;
+    }
+    get name() {
+        return this.native.name || this.native.id;
+    }
+    async runCommand(command, args = [], options = {}) {
+        const result = await this.native.exec([command, ...args], {
+            cwd: options.cwd,
+            env: options.env,
+            timeoutSeconds: options.timeoutMs
+                ? Math.ceil(options.timeoutMs / 1000)
+                : undefined,
+        });
+        return finished(result.exitCode, result.stdout, result.stderr);
+    }
+    runCommandDetached() {
+        return unsupported("Vercel Sandbox", "detached commands");
+    }
+    async readFileToBuffer(options) {
+        return await this.native.readFile(options.path);
+    }
+    async readFile(options) {
+        return bytesToText(await this.native.readFile(options.path));
+    }
+    writeFiles() {
+        return unsupported("Vercel Sandbox", "file writes", "use an image or a command that writes the content");
+    }
+    mkDir() {
+        return unsupported("Vercel Sandbox", "directory creation");
+    }
+    domain() {
+        return unsupported("Vercel Sandbox", "domain", "run.cloud public port capabilities are not available in the SDK yet");
+    }
+    async stop() {
+        await this.native.destroy();
+    }
+    async delete() {
+        await this.native.destroy();
+    }
+}
+//# sourceMappingURL=vercel.js.map

package/dist/compat/vercel.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@run-cloud/sdk",
-  "version": "0.5.1",
-  "description": "TypeScript client for run.cloud sandboxes, simulators and assets",
+  "version": "0.7.0",
+  "description": "TypeScript client for run.cloud, including sandbox-provider compatibility adapters",
   "license": "MIT",
   "keywords": [
     "runcloud",
@@ -47,6 +47,46 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./compat": {
+      "types": "./dist/compat/common.d.ts",
+      "import": "./dist/compat/common.js"
+    },
+    "./compat/modal": {
+      "types": "./dist/compat/modal.d.ts",
+      "import": "./dist/compat/modal.js"
+    },
+    "./compat/e2b": {
+      "types": "./dist/compat/e2b.d.ts",
+      "import": "./dist/compat/e2b.js"
+    },
+    "./compat/daytona": {
+      "types": "./dist/compat/daytona.d.ts",
+      "import": "./dist/compat/daytona.js"
+    },
+    "./compat/vercel": {
+      "types": "./dist/compat/vercel.d.ts",
+      "import": "./dist/compat/vercel.js"
+    },
+    "./compat/blaxel": {
+      "types": "./dist/compat/blaxel.d.ts",
+      "import": "./dist/compat/blaxel.js"
+    },
+    "./compat/sprites": {
+      "types": "./dist/compat/sprites.d.ts",
+      "import": "./dist/compat/sprites.js"
+    },
+    "./compat/cloudflare": {
+      "types": "./dist/compat/cloudflare.d.ts",
+      "import": "./dist/compat/cloudflare.js"
+    },
+    "./compat/codesandbox": {
+      "types": "./dist/compat/codesandbox.d.ts",
+      "import": "./dist/compat/codesandbox.js"
+    },
+    "./compat/fly": {
+      "types": "./dist/compat/fly.d.ts",
+      "import": "./dist/compat/fly.js"
     }
   },
   "files": [