@code-harness/sdk 0.0.0-stage → 0.1.1

package/dist/browser.d.ts

@@ -0,0 +1,65 @@
+import type { BaseClient } from './core/client.js';
+export interface WaitFor {
+    selector?: string;
+    text?: string;
+    timeoutMs?: number;
+}
+export interface PageRef {
+    ref: number;
+    tag: string;
+    role: string | null;
+    name: string;
+    value: string;
+    placeholder: string;
+    href: string;
+}
+export interface Page {
+    title: string;
+    url: string;
+    text: string;
+    refs: PageRef[];
+}
+export interface NavigatedPage extends Page {
+    status: number | null;
+    error: string | null;
+}
+export interface RunResult {
+    result: unknown;
+    error: string | null;
+    durationMs: number;
+}
+export declare class Browser {
+    #private;
+    readonly sandboxId: string | null;
+    readonly record: boolean;
+    constructor(client: BaseClient, { id, sandboxId, record }: {
+        id: string | null;
+        sandboxId: string | null;
+        record: boolean;
+    });
+    get id(): string | null;
+    navigate(url: string, options?: {
+        until?: WaitFor;
+    }): Promise<NavigatedPage>;
+    read(options?: {
+        maxChars?: number;
+        waitFor?: WaitFor;
+    }): Promise<Page>;
+    click(ref: number, options?: {
+        waitFor?: WaitFor;
+    }): Promise<Page>;
+    type(ref: number, text: string, options?: {
+        submit?: boolean;
+        waitFor?: WaitFor;
+    }): Promise<Page>;
+    screenshot(options?: {
+        fullPage?: boolean;
+        waitFor?: WaitFor;
+    }): Promise<{
+        path: string;
+    }>;
+    run(code: string, options?: {
+        timeoutMs?: number;
+    }): Promise<RunResult>;
+    close(): Promise<void>;
+}

package/dist/browser.js

@@ -0,0 +1,60 @@
+import { CodeHarnessError } from './errors.js';
+export class Browser {
+    sandboxId;
+    record;
+    #client;
+    #id;
+    #creating = null;
+    constructor(client, { id, sandboxId, record }) {
+        this.#client = client;
+        this.#id = id;
+        this.sandboxId = sandboxId;
+        this.record = record;
+    }
+    get id() {
+        return this.#id;
+    }
+    navigate(url, options = {}) {
+        return this.#call('navigate', { url, ...options });
+    }
+    read(options = {}) {
+        return this.#call('read', options);
+    }
+    click(ref, options = {}) {
+        return this.#call('click', { ref, ...options });
+    }
+    type(ref, text, options = {}) {
+        return this.#call('type', { ref, text, ...options });
+    }
+    screenshot(options = {}) {
+        return this.#call('screenshot', options);
+    }
+    run(code, options = {}) {
+        return this.#call('run', { code, ...options });
+    }
+    async close() {
+        if (!this.#id)
+            return;
+        await this.#client.request('DELETE', `/browser/${this.#id}`).catch(err => {
+            // already closed, by an earlier close or the idle sweep
+            if (!(err instanceof CodeHarnessError && err.code === 'NOT_FOUND'))
+                throw err;
+        });
+    }
+    async #call(action, body) {
+        const id = await this.#sessionId();
+        return (await this.#client.request('POST', `/browser/${id}/${action}`, body)).json();
+    }
+    // A sandbox's browser has no session until its first call; concurrent first calls share one.
+    async #sessionId() {
+        if (this.#id)
+            return this.#id;
+        this.#creating ??= this.#client
+            .request('POST', '/browser', { workspaceId: this.sandboxId, record: this.record })
+            .then(response => response.json())
+            .then(session => (this.#id = session.id))
+            .finally(() => (this.#creating = null));
+        return this.#creating;
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAoC9C,MAAM,OAAO,OAAO;IACT,SAAS,CAAe;IACxB,MAAM,CAAS;IACf,OAAO,CAAY;IAC5B,GAAG,CAAe;IAClB,SAAS,GAA2B,IAAI,CAAA;IAExC,YACE,MAAkB,EAClB,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAoE;QAE3F,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,IAAI,CAAC,GAAG,GAAG,EAAE,CAAA;QACb,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,GAAG,CAAA;IACjB,CAAC;IAED,QAAQ,CAAC,GAAW,EAAE,OAAO,GAAwB,EAAE;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;IACpD,CAAC;IAED,IAAI,CAAC,OAAO,GAA6C,EAAE;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,OAAO,GAA0B,EAAE;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;IACjD,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,IAAY,EAAE,OAAO,GAA4C,EAAE;QACnF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;IACtD,CAAC;IAED,UAAU,CAAC,OAAO,GAA8C,EAAE;QAChE,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IAC1C,CAAC;IAED,GAAG,CAAC,IAAY,EAAE,OAAO,GAA2B,EAAE;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;IAChD,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,OAAM;QAErB,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;YACvE,wDAAwD;YACxD,IAAI,CAAC,CAAC,GAAG,YAAY,gBAAgB,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC;gBAAE,MAAM,GAAG,CAAA;QAC/E,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CAAI,MAAc,EAAE,IAAY;QACzC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;QAElC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAgB,CAAA;IACpG,CAAC;IAED,6FAA6F;IAC7F,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC,GAAG,CAAA;QAE7B,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,OAAO;aAC5B,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;aACjF,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAA6B,CAAC;aAC5D,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;aACxC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAAA;QAEzC,OAAO,IAAI,CAAC,SAAS,CAAA;IACvB,CAAC;CACF"}

package/dist/cjs/browser.d.ts

@@ -0,0 +1,65 @@
+import type { BaseClient } from './core/client.js';
+export interface WaitFor {
+    selector?: string;
+    text?: string;
+    timeoutMs?: number;
+}
+export interface PageRef {
+    ref: number;
+    tag: string;
+    role: string | null;
+    name: string;
+    value: string;
+    placeholder: string;
+    href: string;
+}
+export interface Page {
+    title: string;
+    url: string;
+    text: string;
+    refs: PageRef[];
+}
+export interface NavigatedPage extends Page {
+    status: number | null;
+    error: string | null;
+}
+export interface RunResult {
+    result: unknown;
+    error: string | null;
+    durationMs: number;
+}
+export declare class Browser {
+    #private;
+    readonly sandboxId: string | null;
+    readonly record: boolean;
+    constructor(client: BaseClient, { id, sandboxId, record }: {
+        id: string | null;
+        sandboxId: string | null;
+        record: boolean;
+    });
+    get id(): string | null;
+    navigate(url: string, options?: {
+        until?: WaitFor;
+    }): Promise<NavigatedPage>;
+    read(options?: {
+        maxChars?: number;
+        waitFor?: WaitFor;
+    }): Promise<Page>;
+    click(ref: number, options?: {
+        waitFor?: WaitFor;
+    }): Promise<Page>;
+    type(ref: number, text: string, options?: {
+        submit?: boolean;
+        waitFor?: WaitFor;
+    }): Promise<Page>;
+    screenshot(options?: {
+        fullPage?: boolean;
+        waitFor?: WaitFor;
+    }): Promise<{
+        path: string;
+    }>;
+    run(code: string, options?: {
+        timeoutMs?: number;
+    }): Promise<RunResult>;
+    close(): Promise<void>;
+}

package/dist/cjs/core/client.d.ts

@@ -0,0 +1,27 @@
+import { Browser } from '../browser.js';
+import { Sandbox, type SandboxOptions } from './sandbox.js';
+export interface ClientOptions {
+    baseUrl?: string;
+    token?: string;
+    fetch?: typeof fetch;
+}
+export interface CreateSandboxOptions extends SandboxOptions {
+    name?: string;
+    env?: Record<string, string>;
+}
+export declare class BaseClient {
+    #private;
+    readonly baseUrl: string;
+    constructor(options?: ClientOptions);
+    me(): Promise<{
+        id: string;
+        email: string;
+    }>;
+    createBrowser(): Promise<Browser>;
+    getBrowser(id: string): Browser;
+    request(method: string, path: string, body?: unknown): Promise<Response>;
+}
+export declare class Client extends BaseClient {
+    createSandbox({ name, env, ...options }?: CreateSandboxOptions): Promise<Sandbox>;
+    getSandbox(id: string, options?: SandboxOptions): Promise<Sandbox>;
+}

package/dist/cjs/core/index.d.ts

@@ -0,0 +1,4 @@
+export { Browser, type NavigatedPage, type Page, type PageRef, type RunResult, type WaitFor } from '../browser.js';
+export { CodeHarnessError, type CodeHarnessErrorCode } from '../errors.js';
+export { Client, type ClientOptions, type CreateSandboxOptions } from './client.js';
+export { Sandbox, type ExecuteResponse, type FileDownloadResponse, type FileOperationError, type FileUploadResponse, type LaunchOptions, type SandboxOptions, } from './sandbox.js';

package/dist/cjs/core/index.js

@@ -0,0 +1,304 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/core/index.ts
+var exports_core = {};
+__export(exports_core, {
+  Browser: () => Browser,
+  Client: () => Client,
+  CodeHarnessError: () => CodeHarnessError,
+  Sandbox: () => Sandbox
+});
+module.exports = __toCommonJS(exports_core);
+
+// src/errors.ts
+var CODES = {
+  400: "INVALID_REQUEST",
+  401: "AUTHENTICATION_FAILED",
+  404: "NOT_FOUND",
+  409: "CONFLICT",
+  413: "TOO_LARGE",
+  429: "RATE_LIMITED",
+  502: "UPSTREAM_FAILED",
+  504: "TIMEOUT"
+};
+var SANDBOX_ERROR = Symbol.for("sandbox.error");
+
+class CodeHarnessError extends Error {
+  code;
+  status;
+  name = "CodeHarnessError";
+  constructor(message, code, status = null, cause) {
+    super(message, { cause });
+    this.code = code;
+    this.status = status;
+    Object.defineProperty(this, SANDBOX_ERROR, { value: true });
+  }
+  static async fromResponse(response) {
+    const body = await response.json().catch(() => null);
+    const message = body?.message ?? body?.error ?? response.statusText;
+    return new CodeHarnessError(message, CODES[response.status] ?? "UNKNOWN", response.status);
+  }
+}
+
+// src/browser.ts
+class Browser {
+  sandboxId;
+  record;
+  #client;
+  #id;
+  #creating = null;
+  constructor(client, { id, sandboxId, record }) {
+    this.#client = client;
+    this.#id = id;
+    this.sandboxId = sandboxId;
+    this.record = record;
+  }
+  get id() {
+    return this.#id;
+  }
+  navigate(url, options = {}) {
+    return this.#call("navigate", { url, ...options });
+  }
+  read(options = {}) {
+    return this.#call("read", options);
+  }
+  click(ref, options = {}) {
+    return this.#call("click", { ref, ...options });
+  }
+  type(ref, text, options = {}) {
+    return this.#call("type", { ref, text, ...options });
+  }
+  screenshot(options = {}) {
+    return this.#call("screenshot", options);
+  }
+  run(code, options = {}) {
+    return this.#call("run", { code, ...options });
+  }
+  async close() {
+    if (!this.#id)
+      return;
+    await this.#client.request("DELETE", `/browser/${this.#id}`).catch((err) => {
+      if (!(err instanceof CodeHarnessError && err.code === "NOT_FOUND"))
+        throw err;
+    });
+  }
+  async#call(action, body) {
+    const id = await this.#sessionId();
+    return (await this.#client.request("POST", `/browser/${id}/${action}`, body)).json();
+  }
+  async#sessionId() {
+    if (this.#id)
+      return this.#id;
+    this.#creating ??= this.#client.request("POST", "/browser", { workspaceId: this.sandboxId, record: this.record }).then((response) => response.json()).then((session) => this.#id = session.id).finally(() => this.#creating = null);
+    return this.#creating;
+  }
+}
+// src/core/sandbox.ts
+var ROOT = "/workspace";
+var DEFAULT_TIMEOUT_MS = 120000;
+var UTF8 = new TextDecoder("utf-8", { fatal: true });
+var relativePath = (path) => {
+  if (path === ROOT)
+    return "";
+  return path.startsWith(`${ROOT}/`) ? path.slice(ROOT.length + 1) : path.startsWith("/") ? null : path;
+};
+var encodePath = (relative) => relative.split("/").map(encodeURIComponent).join("/");
+var fileError = (err) => {
+  if (err instanceof CodeHarnessError && err.code === "NOT_FOUND")
+    return "file_not_found";
+  if (err instanceof CodeHarnessError && err.code === "INVALID_REQUEST")
+    return "invalid_path";
+  throw err;
+};
+
+class Sandbox {
+  id;
+  name;
+  envKeys;
+  createdAt;
+  browser;
+  #client;
+  #timeoutMs;
+  constructor(client, workspace, { timeoutMs = DEFAULT_TIMEOUT_MS, record = false } = {}) {
+    this.#client = client;
+    this.#timeoutMs = timeoutMs;
+    this.id = workspace.id;
+    this.name = workspace.name;
+    this.envKeys = workspace.defaultEnvKeys;
+    this.createdAt = new Date(workspace.createdAt);
+    this.browser = new Browser(client, { id: null, sandboxId: workspace.id, record });
+  }
+  async execute(command) {
+    const response = await this.#client.request("POST", `/workspaces/${this.id}/sandbox/exec`, {
+      command,
+      timeoutMs: this.#timeoutMs
+    });
+    const result = await response.json();
+    return {
+      output: result.timedOut ? `${result.output}
+timed out after ${this.#timeoutMs} ms` : result.output,
+      exitCode: result.exitCode,
+      truncated: false
+    };
+  }
+  async uploadFiles(files) {
+    const results = [];
+    for (const [path, bytes] of files) {
+      const relative = relativePath(path);
+      if (!relative) {
+        results.push({ path, error: "invalid_path" });
+        continue;
+      }
+      let content;
+      try {
+        content = UTF8.decode(bytes);
+      } catch {
+        results.push({ path, error: "invalid_path" });
+        continue;
+      }
+      const error = await this.#client.request("PUT", `/workspaces/${this.id}/files/${encodePath(relative)}`, { content }).then(() => null, fileError);
+      results.push({ path, error });
+    }
+    return results;
+  }
+  async downloadFiles(paths) {
+    const results = [];
+    for (const path of paths) {
+      const relative = relativePath(path);
+      if (!relative) {
+        results.push({ path, content: null, error: "invalid_path" });
+        continue;
+      }
+      try {
+        const response = await this.#client.request("GET", `/workspaces/${this.id}/files/${encodePath(relative)}?raw=true`);
+        results.push({ path, content: new Uint8Array(await response.arrayBuffer()), error: null });
+      } catch (err) {
+        results.push({ path, content: null, error: fileError(err) });
+      }
+    }
+    return results;
+  }
+  async uploadAsZip(zip, { path = "" } = {}) {
+    const relative = relativePath(path);
+    if (relative === null)
+      throw new CodeHarnessError(`${path} is outside ${ROOT}`, "INVALID_REQUEST");
+    const form = new FormData;
+    form.append("path", relative);
+    form.append("file", zip instanceof Blob ? zip : new Blob([zip]), "upload.zip");
+    return (await this.#client.request("PUT", `/workspaces/${this.id}/upload`, form)).json();
+  }
+  async launch(options) {
+    return (await this.#client.request("POST", `/workspaces/${this.id}/sandbox/launch`, options)).json();
+  }
+  async logs({ tail } = {}) {
+    const query = tail === undefined ? "" : `?tail=${tail}`;
+    const response = await this.#client.request("GET", `/workspaces/${this.id}/sandbox/logs${query}`);
+    return (await response.json()).lines;
+  }
+  async stop() {
+    await this.#client.request("POST", `/workspaces/${this.id}/sandbox/stop`);
+  }
+  async close() {
+    await this.browser.close();
+    await this.#client.request("DELETE", `/workspaces/${this.id}`);
+  }
+}
+
+// src/core/client.ts
+var API_PREFIX = "/api/v1";
+
+class BaseClient {
+  baseUrl;
+  #token;
+  #fetch;
+  constructor(options = {}) {
+    const env = typeof process === "undefined" ? {} : process.env;
+    const baseUrl = options.baseUrl ?? env.CODE_HARNESS_BASE_URL;
+    const token = options.token ?? env.CODE_HARNESS_TOKEN;
+    if (!baseUrl || !token)
+      throw new CodeHarnessError("Pass baseUrl and token, or set CODE_HARNESS_BASE_URL and CODE_HARNESS_TOKEN", "AUTHENTICATION_FAILED");
+    this.baseUrl = baseUrl.replace(/\/+$/, "");
+    this.#token = token;
+    this.#fetch = options.fetch ?? fetch;
+  }
+  async me() {
+    return (await this.request("GET", "/me")).json();
+  }
+  async createBrowser() {
+    const session = await (await this.request("POST", "/browser", {})).json();
+    return new Browser(this, { id: session.id, sandboxId: null, record: false });
+  }
+  getBrowser(id) {
+    return new Browser(this, { id, sandboxId: null, record: false });
+  }
+  async request(method, path, body) {
+    const headers = { authorization: `Bearer ${this.#token}` };
+    const isJson = body !== undefined && !(body instanceof FormData);
+    if (isJson)
+      headers["content-type"] = "application/json";
+    let response;
+    try {
+      response = await this.#fetch(`${this.baseUrl}${API_PREFIX}${path}`, {
+        method,
+        headers,
+        body: isJson ? JSON.stringify(body) : body
+      });
+    } catch (err) {
+      const cause = err instanceof Error ? err : new Error(String(err));
+      throw new CodeHarnessError(`Can't reach ${this.baseUrl}: ${cause.message}`, "NETWORK_ERROR", null, cause);
+    }
+    if (!response.ok)
+      throw await CodeHarnessError.fromResponse(response);
+    return response;
+  }
+}
+
+class Client extends BaseClient {
+  async createSandbox({ name, env, ...options } = {}) {
+    const response = await this.request("POST", "/workspaces", {
+      name: name ?? `sandbox-${Date.now()}`,
+      defaultEnv: env
+    });
+    return new Sandbox(this, await response.json(), options);
+  }
+  async getSandbox(id, options = {}) {
+    const response = await this.request("GET", `/workspaces/${encodeURIComponent(id)}`);
+    return new Sandbox(this, await response.json(), options);
+  }
+}

package/dist/cjs/core/sandbox.d.ts

@@ -0,0 +1,63 @@
+import { Browser } from '../browser.js';
+import type { BaseClient } from './client.js';
+export declare const ROOT = "/workspace";
+export type FileOperationError = 'file_not_found' | 'permission_denied' | 'is_directory' | 'invalid_path';
+export interface ExecuteResponse {
+    output: string;
+    exitCode: number | null;
+    truncated: boolean;
+}
+export interface FileUploadResponse {
+    path: string;
+    error: FileOperationError | null;
+}
+export interface FileDownloadResponse {
+    path: string;
+    content: Uint8Array | null;
+    error: FileOperationError | null;
+}
+export interface SandboxOptions {
+    timeoutMs?: number;
+    record?: boolean;
+}
+export interface LaunchOptions {
+    command: string;
+    port: number;
+    env?: Record<string, string>;
+    network?: {
+        allow?: string[];
+        deny?: string[];
+    };
+}
+export interface Workspace {
+    id: string;
+    name: string;
+    defaultEnvKeys: string[];
+    createdAt: string;
+}
+export declare class Sandbox {
+    #private;
+    readonly id: string;
+    readonly name: string;
+    readonly envKeys: string[];
+    readonly createdAt: Date;
+    readonly browser: Browser;
+    constructor(client: BaseClient, workspace: Workspace, { timeoutMs, record }?: SandboxOptions);
+    execute(command: string): Promise<ExecuteResponse>;
+    uploadFiles(files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
+    downloadFiles(paths: string[]): Promise<FileDownloadResponse[]>;
+    uploadAsZip(zip: Blob | Uint8Array<ArrayBuffer> | ArrayBuffer, { path }?: {
+        path?: string;
+    }): Promise<{
+        path: string;
+        files: number;
+    }>;
+    launch(options: LaunchOptions): Promise<{
+        url: string;
+    }>;
+    logs({ tail }?: {
+        tail?: number;
+    }): Promise<string[]>;
+    stop(): Promise<void>;
+    close(): Promise<void>;
+}

package/dist/cjs/errors.d.ts

@@ -0,0 +1,8 @@
+export type CodeHarnessErrorCode = 'INVALID_REQUEST' | 'AUTHENTICATION_FAILED' | 'NOT_FOUND' | 'CONFLICT' | 'TOO_LARGE' | 'RATE_LIMITED' | 'UPSTREAM_FAILED' | 'TIMEOUT' | 'NETWORK_ERROR' | 'UNKNOWN';
+export declare class CodeHarnessError extends Error {
+    readonly code: CodeHarnessErrorCode;
+    readonly status: number | null;
+    readonly name: string;
+    constructor(message: string, code: CodeHarnessErrorCode, status?: number | null, cause?: Error);
+    static fromResponse(response: Response): Promise<CodeHarnessError>;
+}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/client.d.ts

@@ -0,0 +1,8 @@
+import { BaseClient, type CreateSandboxOptions } from './core/client.js';
+import type { SandboxOptions } from './core/sandbox.js';
+import { Sandbox } from './sandbox.js';
+export type { ClientOptions, CreateSandboxOptions } from './core/client.js';
+export declare class Client extends BaseClient {
+    createSandbox({ name, env, ...options }?: CreateSandboxOptions): Promise<Sandbox>;
+    getSandbox(id: string, options?: SandboxOptions): Promise<Sandbox>;
+}

package/dist/client.js

@@ -0,0 +1,16 @@
+import { BaseClient } from './core/client.js';
+import { Sandbox } from './sandbox.js';
+export class Client extends BaseClient {
+    async createSandbox({ name, env, ...options } = {}) {
+        const response = await this.request('POST', '/workspaces', {
+            name: name ?? `sandbox-${Date.now()}`,
+            defaultEnv: env,
+        });
+        return new Sandbox(this, (await response.json()), options);
+    }
+    async getSandbox(id, options = {}) {
+        const response = await this.request('GET', `/workspaces/${encodeURIComponent(id)}`);
+        return new Sandbox(this, (await response.json()), options);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA6B,MAAM,kBAAkB,CAAA;AAExE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAItC,MAAM,OAAO,MAAO,SAAQ,UAAU;IACpC,KAAK,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,GAAyB,EAAE;QACtE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE;YACzD,IAAI,EAAE,IAAI,IAAI,WAAW,IAAI,CAAC,GAAG,EAAE,EAAE;YACrC,UAAU,EAAE,GAAG;SAChB,CAAC,CAAA;QAEF,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAc,EAAE,OAAO,CAAC,CAAA;IACzE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAU,EAAE,OAAO,GAAmB,EAAE;QACvD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,eAAe,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAEnF,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAc,EAAE,OAAO,CAAC,CAAA;IACzE,CAAC;CACF"}

package/dist/core/client.d.ts

@@ -0,0 +1,27 @@
+import { Browser } from '../browser.js';
+import { Sandbox, type SandboxOptions } from './sandbox.js';
+export interface ClientOptions {
+    baseUrl?: string;
+    token?: string;
+    fetch?: typeof fetch;
+}
+export interface CreateSandboxOptions extends SandboxOptions {
+    name?: string;
+    env?: Record<string, string>;
+}
+export declare class BaseClient {
+    #private;
+    readonly baseUrl: string;
+    constructor(options?: ClientOptions);
+    me(): Promise<{
+        id: string;
+        email: string;
+    }>;
+    createBrowser(): Promise<Browser>;
+    getBrowser(id: string): Browser;
+    request(method: string, path: string, body?: unknown): Promise<Response>;
+}
+export declare class Client extends BaseClient {
+    createSandbox({ name, env, ...options }?: CreateSandboxOptions): Promise<Sandbox>;
+    getSandbox(id: string, options?: SandboxOptions): Promise<Sandbox>;
+}