@code-harness/sdk 0.1.0 → 0.1.1

package/dist/browser.d.ts

@@ -1,4 +1,4 @@
-import type { Client } from './client.js';
+import type { BaseClient } from './core/client.js';
 export interface WaitFor {
     selector?: string;
     text?: string;
@@ -32,7 +32,7 @@ export declare class Browser {
     #private;
     readonly sandboxId: string | null;
     readonly record: boolean;
-    constructor(client: Client, { id, sandboxId, record }: {
+    constructor(client: BaseClient, { id, sandboxId, record }: {
         id: string | null;
         sandboxId: string | null;
         record: boolean;

package/dist/browser.js.map

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

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

@@ -1,25 +1,8 @@
-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 Client {
-    #private;
-    readonly baseUrl: string;
-    constructor(options?: ClientOptions);
-    me(): Promise<{
-        id: string;
-        email: string;
-    }>;
+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>;
-    createBrowser(): Promise<Browser>;
-    getBrowser(id: string): Browser;
-    request(method: string, path: string, body?: unknown): Promise<Response>;
 }

package/dist/client.js

@@ -1,24 +1,6 @@
-import { Browser } from './browser.js';
-import { CodeHarnessError } from './errors.js';
+import { BaseClient } from './core/client.js';
 import { Sandbox } from './sandbox.js';
-const API_PREFIX = '/api/v1';
-export class Client {
-    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();
-    }
+export class Client extends BaseClient {
     async createSandbox({ name, env, ...options } = {}) {
         const response = await this.request('POST', '/workspaces', {
             name: name ?? `sandbox-${Date.now()}`,
@@ -30,34 +12,5 @@ export class Client {
         const response = await this.request('GET', `/workspaces/${encodeURIComponent(id)}`);
         return new Sandbox(this, (await response.json()), options);
     }
-    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 });
-    }
-    // Sends one call to /api/v1, a FormData body as multipart and any other as JSON, and throws CodeHarnessError unless it answers 2xx.
-    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;
-    }
 }
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/core/client.js

@@ -0,0 +1,66 @@
+import { Browser } from '../browser.js';
+import { CodeHarnessError } from '../errors.js';
+import { Sandbox } from './sandbox.js';
+const API_PREFIX = '/api/v1';
+// everything but sandboxes, which each entry's Client adds with its own Sandbox
+export 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 });
+    }
+    // Sends one call to /api/v1, a FormData body as multipart and any other as JSON, and throws CodeHarnessError unless it answers 2xx.
+    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;
+    }
+}
+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/core/client.js.map

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

package/dist/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/core/index.js

@@ -0,0 +1,5 @@
+export { Browser } from '../browser.js';
+export { CodeHarnessError } from '../errors.js';
+export { Client } from './client.js';
+export { Sandbox, } from './sandbox.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA6E,MAAM,eAAe,CAAA;AAClH,OAAO,EAAE,gBAAgB,EAA6B,MAAM,cAAc,CAAA;AAC1E,OAAO,EAAE,MAAM,EAAiD,MAAM,aAAa,CAAA;AACnF,OAAO,EACL,OAAO,GAOR,MAAM,cAAc,CAAA"}

package/dist/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/core/sandbox.js

@@ -0,0 +1,117 @@
+import { Browser } from '../browser.js';
+import { CodeHarnessError } from '../errors.js';
+export const ROOT = '/workspace';
+const DEFAULT_TIMEOUT_MS = 120_000;
+const UTF8 = new TextDecoder('utf-8', { fatal: true });
+// /workspace/src/a.ts or src/a.ts → src/a.ts, /workspace → ''; null for a path outside /workspace
+const relativePath = (path) => {
+    if (path === ROOT)
+        return '';
+    return path.startsWith(`${ROOT}/`) ? path.slice(ROOT.length + 1) : path.startsWith('/') ? null : path;
+};
+const encodePath = (relative) => relative.split('/').map(encodeURIComponent).join('/');
+// a file route's answer for one path; anything else, like a 401, isn't about the path and is thrown
+const 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;
+};
+export 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}\ntimed 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 {
+                // the files route takes text only
+                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}`);
+    }
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/core/sandbox.js.map

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

package/dist/errors.d.ts

@@ -1,9 +1,8 @@
-import { SandboxError } from 'deepagents';
 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 SandboxError {
+export declare class CodeHarnessError extends Error {
+    readonly code: CodeHarnessErrorCode;
     readonly status: number | null;
     readonly name: string;
-    readonly code: CodeHarnessErrorCode;
     constructor(message: string, code: CodeHarnessErrorCode, status?: number | null, cause?: Error);
     static fromResponse(response: Response): Promise<CodeHarnessError>;
 }

package/dist/errors.js

@@ -1,4 +1,3 @@
-import { SandboxError } from 'deepagents';
 const CODES = {
     400: 'INVALID_REQUEST',
     401: 'AUTHENTICATION_FAILED',
@@ -9,13 +8,17 @@ const CODES = {
     502: 'UPSTREAM_FAILED',
     504: 'TIMEOUT',
 };
-export class CodeHarnessError extends SandboxError {
+// deepagents' SandboxError.isInstance checks this symbol, so the client entry needn't load deepagents
+const SANDBOX_ERROR = Symbol.for('sandbox.error');
+export class CodeHarnessError extends Error {
+    code;
     status;
     name = 'CodeHarnessError';
     constructor(message, code, status = null, cause) {
-        super(message, code, cause);
+        super(message, { cause });
+        this.code = code;
         this.status = status;
-        Object.setPrototypeOf(this, CodeHarnessError.prototype);
+        Object.defineProperty(this, SANDBOX_ERROR, { value: true });
     }
     static async fromResponse(response) {
         const body = (await response.json().catch(() => null));

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEzC,MAAM,KAAK,GAAyC;IAClD,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,uBAAuB;IAC5B,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,SAAS;CACf,CAAA;AAcD,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAOrC,MAAM;IANC,IAAI,GAAW,kBAAkB,CAAA;IAGnD,YACE,OAAe,EACf,IAA0B,EACjB,MAAM,GAAkB,IAAI,EACrC,KAAa;QAEb,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;sBAHlB,MAAM;QAIf,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAA;IACzD,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,QAAkB;QAC1C,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAgD,CAAA;QACrG,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,IAAI,EAAE,KAAK,IAAI,QAAQ,CAAC,UAAU,CAAA;QAEnE,OAAO,IAAI,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC5F,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,KAAK,GAAyC;IAClD,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,uBAAuB;IAC5B,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,SAAS;CACf,CAAA;AAcD,sGAAsG;AACtG,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;AAEjD,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAK9B,IAAI;IACJ,MAAM;IALC,IAAI,GAAW,kBAAkB,CAAA;IAEnD,YACE,OAAe,EACN,IAA0B,EAC1B,MAAM,GAAkB,IAAI,EACrC,KAAa;QAEb,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;oBAJhB,IAAI;sBACJ,MAAM;QAIf,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7D,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,QAAkB;QAC1C,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAgD,CAAA;QACrG,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,IAAI,EAAE,KAAK,IAAI,QAAQ,CAAC,UAAU,CAAA;QAEnE,OAAO,IAAI,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC5F,CAAC;CACF"}

package/dist/sandbox.d.ts

@@ -1,26 +1,8 @@
 import { BaseSandbox, type ExecuteResponse, type FileDownloadResponse, type FileUploadResponse } from 'deepagents';
-import { Browser } from './browser.js';
-import type { Client } from './client.js';
-export declare const ROOT = "/workspace";
-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;
-}
+import type { Browser } from './browser.js';
+import type { BaseClient } from './core/client.js';
+import { type LaunchOptions, type SandboxOptions, type Workspace } from './core/sandbox.js';
+export { ROOT, type LaunchOptions, type SandboxOptions, type Workspace } from './core/sandbox.js';
 export declare class Sandbox extends BaseSandbox {
     #private;
     readonly id: string;
@@ -28,11 +10,11 @@ export declare class Sandbox extends BaseSandbox {
     readonly envKeys: string[];
     readonly createdAt: Date;
     readonly browser: Browser;
-    constructor(client: Client, workspace: Workspace, { timeoutMs, record }?: SandboxOptions);
+    constructor(client: BaseClient, workspace: Workspace, options?: 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 }?: {
+    uploadAsZip(zip: Blob | Uint8Array<ArrayBuffer> | ArrayBuffer, options?: {
         path?: string;
     }): Promise<{
         path: string;
@@ -41,7 +23,7 @@ export declare class Sandbox extends BaseSandbox {
     launch(options: LaunchOptions): Promise<{
         url: string;
     }>;
-    logs({ tail }?: {
+    logs(options?: {
         tail?: number;
     }): Promise<string[]>;
     stop(): Promise<void>;

package/dist/sandbox.js

@@ -1,119 +1,46 @@
 import { BaseSandbox, } from 'deepagents';
-import { Browser } from './browser.js';
-import { CodeHarnessError } from './errors.js';
-export const ROOT = '/workspace';
-const DEFAULT_TIMEOUT_MS = 120_000;
-const UTF8 = new TextDecoder('utf-8', { fatal: true });
-// /workspace/src/a.ts or src/a.ts → src/a.ts, /workspace → ''; null for a path outside /workspace
-const relativePath = (path) => {
-    if (path === ROOT)
-        return '';
-    return path.startsWith(`${ROOT}/`) ? path.slice(ROOT.length + 1) : path.startsWith('/') ? null : path;
-};
-const encodePath = (relative) => relative.split('/').map(encodeURIComponent).join('/');
-// a file route's answer for one path; anything else, like a 401, isn't about the path and is thrown
-const 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;
-};
+import { Sandbox as CoreSandbox } from './core/sandbox.js';
+export { ROOT } from './core/sandbox.js';
+// deepagents' BaseSandbox over the client entry's Sandbox, which holds the calls
 export class Sandbox extends BaseSandbox {
     id;
     name;
     envKeys;
     createdAt;
     browser;
-    #client;
-    #timeoutMs;
-    constructor(client, workspace, { timeoutMs = DEFAULT_TIMEOUT_MS, record = false } = {}) {
+    #sandbox;
+    constructor(client, workspace, options = {}) {
         super();
-        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 });
+        this.#sandbox = new CoreSandbox(client, workspace, options);
+        this.id = this.#sandbox.id;
+        this.name = this.#sandbox.name;
+        this.envKeys = this.#sandbox.envKeys;
+        this.createdAt = this.#sandbox.createdAt;
+        this.browser = this.#sandbox.browser;
     }
-    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}\ntimed out after ${this.#timeoutMs} ms` : result.output,
-            exitCode: result.exitCode,
-            truncated: false,
-        };
+    execute(command) {
+        return this.#sandbox.execute(command);
     }
-    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 {
-                // the files route takes text only
-                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;
+    uploadFiles(files) {
+        return this.#sandbox.uploadFiles(files);
     }
-    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;
+    downloadFiles(paths) {
+        return this.#sandbox.downloadFiles(paths);
     }
-    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();
+    uploadAsZip(zip, options = {}) {
+        return this.#sandbox.uploadAsZip(zip, options);
     }
-    async launch(options) {
-        return (await this.#client.request('POST', `/workspaces/${this.id}/sandbox/launch`, options)).json();
+    launch(options) {
+        return this.#sandbox.launch(options);
     }
-    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;
+    logs(options = {}) {
+        return this.#sandbox.logs(options);
     }
-    async stop() {
-        await this.#client.request('POST', `/workspaces/${this.id}/sandbox/stop`);
+    stop() {
+        return this.#sandbox.stop();
     }
-    async close() {
-        await this.browser.close();
-        await this.#client.request('DELETE', `/workspaces/${this.id}`);
+    close() {
+        return this.#sandbox.close();
     }
 }
 //# sourceMappingURL=sandbox.js.map

package/dist/sandbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAIZ,MAAM,YAAY,CAAA;AAInB,OAAO,EAAE,OAAO,IAAI,WAAW,EAA2D,MAAM,mBAAmB,CAAA;AAEnH,OAAO,EAAE,IAAI,EAA2D,MAAM,mBAAmB,CAAA;AAEjG,iFAAiF;AACjF,MAAM,OAAO,OAAQ,SAAQ,WAAW;IAC7B,EAAE,CAAQ;IACV,IAAI,CAAQ;IACZ,OAAO,CAAU;IACjB,SAAS,CAAM;IACf,OAAO,CAAS;IAChB,QAAQ,CAAa;IAE9B,YAAY,MAAkB,EAAE,SAAoB,EAAE,OAAO,GAAmB,EAAE;QAChF,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,QAAQ,GAAG,IAAI,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;QAC3D,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAA;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAA;QAC9B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAA;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAA;QACxC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAA;IACtC,CAAC;IAED,OAAO,CAAC,OAAe;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACvC,CAAC;IAED,WAAW,CAAC,KAAkC;QAC5C,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;IACzC,CAAC;IAED,aAAa,CAAC,KAAe;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;IAC3C,CAAC;IAED,WAAW,CACT,GAAiD,EACjD,OAAO,GAAsB,EAAE;QAE/B,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAChD,CAAC;IAED,MAAM,CAAC,OAAsB;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACtC,CAAC;IAED,IAAI,CAAC,OAAO,GAAsB,EAAE;QAClC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACpC,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;IAC7B,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;IAC9B,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@code-harness/sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "TypeScript client for Code-Harness sandboxes and browsers, with a deepagents backend and LangChain middleware",
   "type": "module",
   "repository": {
@@ -18,6 +18,16 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./client": {
+      "import": {
+        "types": "./dist/core/index.d.ts",
+        "default": "./dist/core/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/core/index.d.ts",
+        "default": "./dist/cjs/core/index.js"
+      }
+    },
     "./package.json": "./package.json"
   },
   "files": ["dist"],
@@ -25,9 +35,10 @@
     "node": ">=20"
   },
   "scripts": {
-    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && bun run build:cjs",
     "typecheck": "tsc",
-    "test": "bun test"
+    "test": "bun test",
+    "build:cjs": "bun build src/core/index.ts --format=cjs --target=node --outfile dist/cjs/core/index.js && cp dist/browser.d.ts dist/errors.d.ts dist/cjs/ && cp dist/core/*.d.ts dist/cjs/core/ && echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json"
   },
   "peerDependencies": {
     "@langchain/core": "^1.3.2",
@@ -35,6 +46,20 @@
     "langchain": "^1.6.0",
     "zod": "^4.0.0"
   },
+  "peerDependenciesMeta": {
+    "@langchain/core": {
+      "optional": true
+    },
+    "deepagents": {
+      "optional": true
+    },
+    "langchain": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@langchain/core": "^1.3.4",
     "@types/bun": "^1.4.3",