@hatchet-dev/sandbox 0.1.1 → 0.1.3

package/dist/index.js

@@ -1,8 +1,381 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FilesystemError = exports.Files = exports.Sandbox = void 0;
-var sandbox_js_1 = require("./sandbox.js");
-Object.defineProperty(exports, "Sandbox", { enumerable: true, get: function () { return sandbox_js_1.Sandbox; } });
-var files_js_1 = require("./files.js");
-Object.defineProperty(exports, "Files", { enumerable: true, get: function () { return files_js_1.Files; } });
-Object.defineProperty(exports, "FilesystemError", { enumerable: true, get: function () { return files_js_1.FilesystemError; } });
+import { HatchetClient } from '@hatchet-dev/typescript-sdk/v1';
+import * as fs from 'fs/promises';
+
+// src/sandbox.ts
+var FilesystemError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "FilesystemError";
+  }
+  code;
+};
+var toEntry = (e) => ({
+  ...e,
+  modifiedTime: e.modifiedTime ? new Date(e.modifiedTime) : void 0
+});
+var STAGE_OVER_BYTES = 2 << 20;
+async function toBytes(data) {
+  if (typeof data === "string") return Buffer.from(data, "utf8");
+  if (data instanceof Blob) return Buffer.from(await data.arrayBuffer());
+  if (data instanceof Uint8Array) return Buffer.from(data.buffer, data.byteOffset, data.byteLength);
+  return Buffer.from(data);
+}
+async function putStaged(url, bytes) {
+  if (url.startsWith("file://")) {
+    await fs.writeFile(decodeURIComponent(url.slice("file://".length)), bytes);
+    return;
+  }
+  const res = await fetch(url, {
+    method: "PUT",
+    body: new Uint8Array(bytes),
+    headers: { "Content-Type": "application/octet-stream" }
+  });
+  if (!res.ok)
+    throw new FilesystemError("staging_failed", `stage upload failed: HTTP ${res.status}`);
+}
+async function getStaged(url) {
+  if (url.startsWith("file://")) {
+    return fs.readFile(decodeURIComponent(url.slice("file://".length)));
+  }
+  const res = await fetch(url);
+  if (!res.ok)
+    throw new FilesystemError("staging_failed", `stage download failed: HTTP ${res.status}`);
+  return Buffer.from(await res.arrayBuffer());
+}
+var Files = class {
+  /** @internal */
+  constructor(turn) {
+    this.turn = turn;
+  }
+  turn;
+  async call(fn, input, fresh = false) {
+    const out = await this.turn(`$fs.${fn}`, input, fresh);
+    if (out.error) throw new FilesystemError(out.error.code, out.error.message);
+    return out;
+  }
+  async read(path, opts = {}) {
+    const out = await this.call("read", { path });
+    const bytes = out.url ? await this.readStaged(out.url, out.stagedKey) : Buffer.from(out.content ?? "", "base64");
+    if (opts.format === "bytes") return new Uint8Array(bytes);
+    if (opts.format === "blob") return new Blob([new Uint8Array(bytes)]);
+    return bytes.toString("utf8");
+  }
+  /** A replayed durable read may hold a URL that has expired; the provider signs the same staged file again. The renewal is a plain run, not a durable child, so the replayed child sequence stays aligned. */
+  async readStaged(url, stagedKey) {
+    try {
+      return await getStaged(url);
+    } catch (e) {
+      if (url.startsWith("file://") || !(e instanceof FilesystemError)) throw e;
+      const { getUrl } = await this.call("presign", { stagedKey }, true);
+      return getStaged(getUrl);
+    }
+  }
+  async write(pathOrFiles, data) {
+    if (typeof pathOrFiles !== "string") return this.writeFiles(pathOrFiles);
+    const [entry] = await this.writeFiles([{ path: pathOrFiles, data: data ?? "" }]);
+    return entry;
+  }
+  /** Writes several files in one task. */
+  async writeFiles(files) {
+    const bytes = await Promise.all(files.map((f) => toBytes(f.data)));
+    const encoded = [];
+    for (const [i, f] of files.entries()) {
+      const b = bytes[i];
+      if (b.length <= STAGE_OVER_BYTES) {
+        encoded.push({ path: f.path, content: b.toString("base64") });
+        continue;
+      }
+      const { stagedKey, putUrl } = await this.call("presign", {});
+      try {
+        await putStaged(putUrl, b);
+        encoded.push({ path: f.path, stagedKey });
+      } catch {
+        const again = await this.call("presign", {}, true);
+        await putStaged(again.putUrl, b);
+        encoded.push({ path: f.path, stagedKey: again.stagedKey });
+      }
+    }
+    const { entries = [] } = await this.call("write", { files: encoded });
+    return entries.map(toEntry);
+  }
+  /** Lists a directory. `depth` 1 (default) is the directory itself; higher values recurse. No snapshot is made. */
+  async list(path = ".", opts = {}) {
+    const { entries = [] } = await this.call("list", { path, depth: opts.depth ?? 1 });
+    return entries.map(toEntry);
+  }
+  /** True if the path exists. No snapshot is made. */
+  async exists(path) {
+    const { entry } = await this.call("stat", { path });
+    return entry != null;
+  }
+  /** Metadata of a file or directory. Throws `FilesystemError` with code `not_found` if absent. */
+  async getInfo(path) {
+    const { entry } = await this.call("stat", { path });
+    if (!entry) throw new FilesystemError("not_found", `${path} does not exist`);
+    return toEntry(entry);
+  }
+  /** Creates a directory and its parents. Returns false if it already existed. */
+  async makeDir(path) {
+    const { created } = await this.call("mkdir", { path });
+    return created === true;
+  }
+  /** Renames or moves a file or directory. */
+  async rename(oldPath, newPath) {
+    const { entry } = await this.call("rename", { path: oldPath, newPath });
+    return toEntry(entry);
+  }
+  /** Copies a file or directory tree. */
+  async copy(srcPath, dstPath) {
+    const { entry } = await this.call("copy", { path: srcPath, newPath: dstPath });
+    return toEntry(entry);
+  }
+  /** Deletes a file or directory tree. */
+  async remove(path) {
+    await this.call("remove", { path });
+  }
+  /** The provider fetches an https URL into the workspace. The sandbox needs no network. Private and loopback addresses are refused. */
+  async download(url, path, opts = {}) {
+    const { entry } = await this.call("download", {
+      url,
+      path,
+      ...opts.timeoutMs ? { timeoutMs: opts.timeoutMs } : {}
+    });
+    return toEntry(entry);
+  }
+  /** The provider sends a workspace file to an https URL with HTTP PUT, for example a presigned URL. */
+  async upload(path, url, opts = {}) {
+    await this.call("upload", {
+      path,
+      url,
+      ...opts.timeoutMs ? { timeoutMs: opts.timeoutMs } : {}
+    });
+  }
+};
+
+// src/otel.ts
+var telemetryStarted = false;
+async function setupTelemetry() {
+  if (telemetryStarted || process.env.HATCHET_SANDBOX_OTEL === "false" || process.env.BRICKIE_OTEL === "false") {
+    return;
+  }
+  telemetryStarted = true;
+  try {
+    const [{ registerInstrumentations }, { HatchetInstrumentor }] = await Promise.all([
+      import('@opentelemetry/instrumentation'),
+      import('@hatchet-dev/typescript-sdk/opentelemetry/index.js')
+    ]);
+    registerInstrumentations({ instrumentations: [new HatchetInstrumentor()] });
+  } catch (err) {
+    console.error(`sandbox: opentelemetry disabled: ${err.message}`);
+  }
+}
+
+// src/sandbox.ts
+var TASK_NAMES = ["hatchet-sandbox", "brickie-sandbox"];
+var taskNames = /* @__PURE__ */ new WeakMap();
+async function registered(client, name) {
+  const namespace = client.config.namespace ?? "";
+  const full = name.startsWith(namespace) ? name : `${namespace}${name}`;
+  for (let offset = 0; ; ) {
+    const { rows = [] } = await client.workflows.list({ name: full, limit: 100, offset });
+    if (rows.some((w) => w.name === full)) return true;
+    if (rows.length === 0) return false;
+    offset += rows.length;
+  }
+}
+async function probe(client) {
+  for (const name of TASK_NAMES) {
+    if (await registered(client, name)) return name;
+  }
+  return void 0;
+}
+function resolveTaskName(client) {
+  let pending = taskNames.get(client);
+  if (!pending) {
+    pending = probe(client).then(
+      (name) => {
+        if (!name) taskNames.delete(client);
+        return name ?? TASK_NAMES[TASK_NAMES.length - 1];
+      },
+      (err) => {
+        taskNames.delete(client);
+        throw err;
+      }
+    );
+    taskNames.set(client, pending);
+  }
+  return pending;
+}
+var UNITS = {
+  K: 1e3,
+  M: 1e6,
+  G: 1e9,
+  T: 1e12,
+  Ki: 2 ** 10,
+  Mi: 2 ** 20,
+  Gi: 2 ** 30,
+  Ti: 2 ** 40
+};
+function toMib(value, field) {
+  if (typeof value === "number") {
+    if (!Number.isInteger(value) || value <= 0)
+      throw new Error(`resources.${field}: expected a positive whole number of MiB`);
+    return value;
+  }
+  const m = /^(\d+(?:\.\d+)?)\s*([KMGT]i?)?B?$/.exec(value.trim());
+  if (!m)
+    throw new Error(
+      `resources.${field}: expected a quantity like '512Mi', '4Gi' or '8G', got ${JSON.stringify(value)}`
+    );
+  const bytes = Number(m[1]) * (m[2] ? UNITS[m[2]] : UNITS.Mi);
+  const mib = Math.ceil(bytes / UNITS.Mi);
+  if (mib <= 0) throw new Error(`resources.${field}: must be at least 1Mi`);
+  return mib;
+}
+function wireResources(r) {
+  const out = {};
+  if (r.vcpu !== void 0) {
+    if (!Number.isInteger(r.vcpu) || r.vcpu <= 0)
+      throw new Error("resources.vcpu: expected a positive whole number of cores");
+    out.vcpu = r.vcpu;
+  }
+  if (r.memory !== void 0) out.memoryMib = toMib(r.memory, "memory");
+  if (r.disk !== void 0) out.diskMib = toMib(r.disk, "disk");
+  if (Object.keys(out).length === 0)
+    throw new Error("resources: set at least one of vcpu, memory, disk");
+  return out;
+}
+function turnRunner(client) {
+  const resolved = resolveTaskName(client);
+  return async (input, opts) => {
+    const name = await resolved;
+    const additionalMetadata = {
+      "hatchet.sandbox.fn": input.fn,
+      ...input.sandboxId ? { "hatchet.sandbox.id": input.sandboxId } : {},
+      ...input.image ? { "hatchet.sandbox.image": input.image } : {},
+      ...input.snapshotId ? { "hatchet.sandbox.from": input.snapshotId } : {}
+    };
+    const result = opts?.fresh ? await (await client.admin.runWorkflow(name, input, {
+      additionalMetadata
+    })).result() : await client.workflow({ name }).run(input, { additionalMetadata });
+    return result[name] ?? result;
+  };
+}
+var Sandbox = class _Sandbox {
+  constructor(run, sandboxId, template) {
+    this.run = run;
+    this.sandboxId = sandboxId;
+    this.template = template;
+    this.files = new Files((fn, input, fresh) => this.turn(fn, input, fresh));
+  }
+  run;
+  sandboxId;
+  template;
+  /** File operations on the workspace. */
+  files;
+  /** Starts a new sandbox. Prefer `hatchet.sandbox.create`. */
+  static async create(client, opts = {}) {
+    await setupTelemetry();
+    const run = turnRunner(client);
+    const metadata = opts.provider ? { ...opts.metadata, provider: opts.provider } : opts.metadata;
+    const created = await run({
+      fn: "$create",
+      input: {},
+      ...opts.id ? { sandboxId: opts.id } : {},
+      ...opts.template ? { image: opts.template } : {},
+      ...opts.from ? { snapshotId: opts.from } : {},
+      ...metadata ? { metadata } : {},
+      ...opts.idleTimeoutMs ? { idleTtlMs: opts.idleTimeoutMs } : {},
+      ...opts.inheritParentMetadata ? { inheritMetadata: true } : {},
+      ...opts.resources ? { resources: wireResources(opts.resources) } : {}
+    });
+    return new _Sandbox(run, created.sandboxId, opts.template);
+  }
+  /** Attaches to a sandbox by ID. Prefer `hatchet.sandbox.connect`. */
+  static async connect(client, sandboxId, opts = {}) {
+    await setupTelemetry();
+    const run = turnRunner(client);
+    await run({
+      fn: "$connect",
+      input: {},
+      sandboxId,
+      ...opts.template ? { image: opts.template } : {}
+    });
+    return new _Sandbox(run, sandboxId, opts.template);
+  }
+  /** Lists sandboxes on the provider. Prefer `hatchet.sandbox.list`. */
+  static async list(client, opts = {}) {
+    const result = await turnRunner(client)({
+      fn: "$list",
+      input: {
+        ...opts.sandboxId ? { sandboxId: opts.sandboxId } : {},
+        ...opts.metadata ? { metadata: opts.metadata } : {}
+      }
+    });
+    const raw = result.output.sandboxes ?? [];
+    return raw.map((s) => ({
+      ...s,
+      createdAt: new Date(s.createdAt),
+      lastUsed: s.lastUsed ? new Date(s.lastUsed) : void 0
+    }));
+  }
+  /** Deletes every sandbox matching the filter, with all their snapshots and files. Prefer `hatchet.sandbox.delete`. */
+  static async delete(client, opts) {
+    if (!opts.sandboxId && Object.keys(opts.metadata ?? {}).length === 0)
+      throw new Error("delete needs a sandboxId or a metadata filter");
+    const run = turnRunner(client);
+    const ids = [];
+    for (const { sandboxId } of await _Sandbox.list(client, opts)) {
+      await run({ fn: "$delete", input: {}, sandboxId });
+      ids.push(sandboxId);
+    }
+    return ids;
+  }
+  /** Runs a shell command with `sh -c` in the workspace and makes a snapshot. A timeout gives `exitCode` 124, not an error. */
+  async exec(cmd, opts = {}) {
+    return this.turn("$command", {
+      cmd,
+      ...opts.timeoutMs ? { timeoutMs: opts.timeoutMs } : {}
+    });
+  }
+  /** Removes the sandbox. Its snapshots stay; `connect` can bring it back. */
+  async kill() {
+    await this.turn("$destroy", {});
+  }
+  /** Removes the sandbox and deletes every snapshot and file the provider stored for it. `connect` fails afterwards. */
+  async delete() {
+    await this.turn("$delete", {});
+  }
+  async turn(fn, input, fresh = false) {
+    const result = await this.run(
+      {
+        sandboxId: this.sandboxId,
+        ...this.template ? { image: this.template } : {},
+        fn,
+        input
+      },
+      { fresh }
+    );
+    return {
+      ...result.output,
+      snapshotId: result.snapshotId,
+      timings: result.timings
+    };
+  }
+};
+Object.defineProperty(HatchetClient.prototype, "sandbox", {
+  configurable: true,
+  get() {
+    return {
+      create: (opts) => Sandbox.create(this, opts),
+      connect: (sandboxId, opts) => Sandbox.connect(this, sandboxId, opts),
+      list: (opts) => Sandbox.list(this, opts),
+      delete: (opts) => Sandbox.delete(this, opts)
+    };
+  }
+});
+
+export { Files, FilesystemError, Sandbox };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/files.ts","../src/otel.ts","../src/sandbox.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import * as fs from 'node:fs/promises';\nimport type { JsonObject } from '@hatchet-dev/typescript-sdk/v1';\n\nexport type FileType = 'file' | 'dir';\n\nexport interface EntryInfo {\n  name: string;\n  path: string;\n  type: FileType;\n  size: number;\n  mode: number;\n  permissions: string;\n  modifiedTime?: Date;\n}\n\nexport type FileData = string | ArrayBuffer | Uint8Array | Blob;\n\nexport interface WriteEntry {\n  path: string;\n  data: FileData;\n}\n\nexport interface ReadOpts {\n  format?: 'text' | 'bytes' | 'blob';\n}\n\nexport interface TransferOpts {\n  /** Give up after this long. */\n  timeoutMs?: number;\n}\n\nexport interface ListOpts {\n  depth?: number;\n}\n\nexport type FilesystemErrorCode =\n  | 'staging_failed'\n  | 'not_found'\n  | 'invalid_path'\n  | 'invalid_url'\n  | 'invalid_content'\n  | 'invalid'\n  | 'is_a_directory'\n  | 'not_a_directory'\n  | 'too_large'\n  | 'transfer_failed';\n\n/** Thrown for caller mistakes such as a missing file or a path outside the workspace. */\nexport class FilesystemError extends Error {\n  constructor(\n    readonly code: FilesystemErrorCode,\n    message: string\n  ) {\n    super(message);\n    this.name = 'FilesystemError';\n  }\n}\n\ntype RawEntry = Omit<EntryInfo, 'modifiedTime'> & { modifiedTime?: string };\n\ninterface FsOutput extends JsonObject {\n  content?: string;\n  stagedKey?: string;\n  url?: string;\n  putUrl?: string;\n  getUrl?: string;\n  entry?: RawEntry | null;\n  entries?: RawEntry[];\n  created?: boolean;\n  error?: { code: FilesystemErrorCode; message: string };\n}\n\n/** @internal */\nexport type FsTurn = (fn: string, input: JsonObject, fresh?: boolean) => Promise<FsOutput>;\n\nconst toEntry = (e: RawEntry): EntryInfo => ({\n  ...e,\n  modifiedTime: e.modifiedTime ? new Date(e.modifiedTime) : undefined,\n});\n\nconst STAGE_OVER_BYTES = 2 << 20;\n\nasync function toBytes(data: FileData): Promise<Buffer> {\n  if (typeof data === 'string') return Buffer.from(data, 'utf8');\n  if (data instanceof Blob) return Buffer.from(await data.arrayBuffer());\n  if (data instanceof Uint8Array) return Buffer.from(data.buffer, data.byteOffset, data.byteLength);\n  return Buffer.from(data);\n}\n\nasync function putStaged(url: string, bytes: Buffer): Promise<void> {\n  if (url.startsWith('file://')) {\n    await fs.writeFile(decodeURIComponent(url.slice('file://'.length)), bytes);\n    return;\n  }\n  const res = await fetch(url, {\n    method: 'PUT',\n    body: new Uint8Array(bytes),\n    headers: { 'Content-Type': 'application/octet-stream' },\n  });\n  if (!res.ok)\n    throw new FilesystemError('staging_failed', `stage upload failed: HTTP ${res.status}`);\n}\n\nasync function getStaged(url: string): Promise<Buffer> {\n  if (url.startsWith('file://')) {\n    return fs.readFile(decodeURIComponent(url.slice('file://'.length)));\n  }\n  const res = await fetch(url);\n  if (!res.ok)\n    throw new FilesystemError('staging_failed', `stage download failed: HTTP ${res.status}`);\n  return Buffer.from(await res.arrayBuffer());\n}\n/** File operations on a sandbox workspace. Paths are relative to the workspace. Each call is one Hatchet task. */\nexport class Files {\n  /** @internal */\n  constructor(private readonly turn: FsTurn) {}\n\n  private async call(fn: string, input: JsonObject, fresh = false): Promise<FsOutput> {\n    const out = await this.turn(`$fs.${fn}`, input, fresh);\n    if (out.error) throw new FilesystemError(out.error.code, out.error.message);\n    return out;\n  }\n\n  /** Reads a file as text (default), bytes, or a Blob. Files over the provider's `--max-file-bytes` (2 MiB) come through the provider's `--store` instead of Hatchet. */\n  read(path: string, opts?: ReadOpts & { format?: 'text' }): Promise<string>;\n  read(path: string, opts: ReadOpts & { format: 'bytes' }): Promise<Uint8Array>;\n  read(path: string, opts: ReadOpts & { format: 'blob' }): Promise<Blob>;\n  async read(path: string, opts: ReadOpts = {}): Promise<string | Uint8Array | Blob> {\n    const out = await this.call('read', { path });\n    const bytes = out.url\n      ? await this.readStaged(out.url, out.stagedKey!)\n      : Buffer.from(out.content ?? '', 'base64');\n    if (opts.format === 'bytes') return new Uint8Array(bytes);\n    if (opts.format === 'blob') return new Blob([new Uint8Array(bytes)]);\n    return bytes.toString('utf8');\n  }\n\n  /** A replayed durable read may hold a URL that has expired; the provider signs the same staged file again. The renewal is a plain run, not a durable child, so the replayed child sequence stays aligned. */\n  private async readStaged(url: string, stagedKey: string): Promise<Buffer> {\n    try {\n      return await getStaged(url);\n    } catch (e) {\n      if (url.startsWith('file://') || !(e instanceof FilesystemError)) throw e;\n      const { getUrl } = await this.call('presign', { stagedKey }, true);\n      return getStaged(getUrl!);\n    }\n  }\n\n  /** Writes one file or several. Parent directories are created. Bytes are stored exactly. Files over 2 MiB go through the provider's `--store` instead of Hatchet. */\n  write(path: string, data: FileData): Promise<EntryInfo>;\n  write(files: WriteEntry[]): Promise<EntryInfo[]>;\n  async write(\n    pathOrFiles: string | WriteEntry[],\n    data?: FileData\n  ): Promise<EntryInfo | EntryInfo[]> {\n    if (typeof pathOrFiles !== 'string') return this.writeFiles(pathOrFiles);\n    const [entry] = await this.writeFiles([{ path: pathOrFiles, data: data ?? '' }]);\n    return entry;\n  }\n\n  /** Writes several files in one task. */\n  async writeFiles(files: WriteEntry[]): Promise<EntryInfo[]> {\n    const bytes = await Promise.all(files.map((f) => toBytes(f.data)));\n    const encoded: Array<{ path: string; content?: string; stagedKey?: string }> = [];\n    for (const [i, f] of files.entries()) {\n      const b = bytes[i];\n      if (b.length <= STAGE_OVER_BYTES) {\n        encoded.push({ path: f.path, content: b.toString('base64') });\n        continue;\n      }\n      const { stagedKey, putUrl } = await this.call('presign', {});\n      try {\n        await putStaged(putUrl!, b);\n        encoded.push({ path: f.path, stagedKey: stagedKey! });\n      } catch {\n        const again = await this.call('presign', {}, true);\n        await putStaged(again.putUrl!, b);\n        encoded.push({ path: f.path, stagedKey: again.stagedKey! });\n      }\n    }\n    const { entries = [] } = await this.call('write', { files: encoded });\n    return entries.map(toEntry);\n  }\n\n  /** Lists a directory. `depth` 1 (default) is the directory itself; higher values recurse. No snapshot is made. */\n  async list(path = '.', opts: ListOpts = {}): Promise<EntryInfo[]> {\n    const { entries = [] } = await this.call('list', { path, depth: opts.depth ?? 1 });\n    return entries.map(toEntry);\n  }\n\n  /** True if the path exists. No snapshot is made. */\n  async exists(path: string): Promise<boolean> {\n    const { entry } = await this.call('stat', { path });\n    return entry != null;\n  }\n\n  /** Metadata of a file or directory. Throws `FilesystemError` with code `not_found` if absent. */\n  async getInfo(path: string): Promise<EntryInfo> {\n    const { entry } = await this.call('stat', { path });\n    if (!entry) throw new FilesystemError('not_found', `${path} does not exist`);\n    return toEntry(entry);\n  }\n\n  /** Creates a directory and its parents. Returns false if it already existed. */\n  async makeDir(path: string): Promise<boolean> {\n    const { created } = await this.call('mkdir', { path });\n    return created === true;\n  }\n\n  /** Renames or moves a file or directory. */\n  async rename(oldPath: string, newPath: string): Promise<EntryInfo> {\n    const { entry } = await this.call('rename', { path: oldPath, newPath });\n    return toEntry(entry!);\n  }\n\n  /** Copies a file or directory tree. */\n  async copy(srcPath: string, dstPath: string): Promise<EntryInfo> {\n    const { entry } = await this.call('copy', { path: srcPath, newPath: dstPath });\n    return toEntry(entry!);\n  }\n\n  /** Deletes a file or directory tree. */\n  async remove(path: string): Promise<void> {\n    await this.call('remove', { path });\n  }\n  /** The provider fetches an https URL into the workspace. The sandbox needs no network. Private and loopback addresses are refused. */\n  async download(url: string, path: string, opts: TransferOpts = {}): Promise<EntryInfo> {\n    const { entry } = await this.call('download', {\n      url,\n      path,\n      ...(opts.timeoutMs ? { timeoutMs: opts.timeoutMs } : {}),\n    });\n    return toEntry(entry!);\n  }\n  /** The provider sends a workspace file to an https URL with HTTP PUT, for example a presigned URL. */\n  async upload(path: string, url: string, opts: TransferOpts = {}): Promise<void> {\n    await this.call('upload', {\n      path,\n      url,\n      ...(opts.timeoutMs ? { timeoutMs: opts.timeoutMs } : {}),\n    });\n  }\n}\n","let telemetryStarted = false;\n\nexport async function setupTelemetry(): Promise<void> {\n  if (\n    telemetryStarted ||\n    process.env.HATCHET_SANDBOX_OTEL === 'false' ||\n    process.env.BRICKIE_OTEL === 'false'\n  ) {\n    return;\n  }\n  telemetryStarted = true;\n  try {\n    const [{ registerInstrumentations }, { HatchetInstrumentor }] = await Promise.all([\n      import('@opentelemetry/instrumentation'),\n      import('@hatchet-dev/typescript-sdk/opentelemetry/index.js'),\n    ]);\n    registerInstrumentations({ instrumentations: [new HatchetInstrumentor()] });\n  } catch (err) {\n    console.error(`sandbox: opentelemetry disabled: ${(err as Error).message}`);\n  }\n}\n","import { HatchetClient, JsonObject } from '@hatchet-dev/typescript-sdk/v1';\nimport { Files } from './files.js';\nimport { setupTelemetry } from './otel.js';\n\nconst TASK_NAMES = ['hatchet-sandbox', 'brickie-sandbox'];\nconst taskNames = new WeakMap<HatchetClient, Promise<string>>();\n\nasync function registered(client: HatchetClient, name: string): Promise<boolean> {\n  const namespace = client.config.namespace ?? '';\n  const full = name.startsWith(namespace) ? name : `${namespace}${name}`;\n  for (let offset = 0; ;) {\n    const { rows = [] } = await client.workflows.list({ name: full, limit: 100, offset });\n    if (rows.some((w) => w.name === full)) return true;\n    if (rows.length === 0) return false;\n    offset += rows.length;\n  }\n}\n\nasync function probe(client: HatchetClient): Promise<string | undefined> {\n  for (const name of TASK_NAMES) {\n    if (await registered(client, name)) return name;\n  }\n  return undefined;\n}\n\nfunction resolveTaskName(client: HatchetClient): Promise<string> {\n  let pending = taskNames.get(client);\n  if (!pending) {\n    pending = probe(client).then(\n      (name) => {\n        if (!name) taskNames.delete(client);\n        return name ?? TASK_NAMES[TASK_NAMES.length - 1];\n      },\n      (err) => {\n        taskNames.delete(client);\n        throw err;\n      }\n    );\n    taskNames.set(client, pending);\n  }\n  return pending;\n}\n\ninterface TurnInput extends JsonObject {\n  sandboxId?: string;\n  image?: string;\n  fn: string;\n  input: JsonObject;\n  snapshotId?: string;\n  metadata?: Record<string, string>;\n  idleTtlMs?: number;\n  inheritMetadata?: boolean;\n}\n\ninterface TurnResult extends JsonObject {\n  output: JsonObject;\n  sandboxId: string;\n  snapshotId?: string;\n  timings?: Record<string, number>;\n}\n\nexport interface Timings {\n  /** Snapshot made after this turn. Absent for turns that do not change the workspace. */\n  snapshotId?: string;\n  /** Milliseconds per phase: `claim`, `restore`, `exec`, `checkpoint`. */\n  timings?: Record<string, number>;\n}\n\nexport interface CommandResult extends Timings {\n  stdout: string;\n  stderr: string;\n  /** A non-zero code is a normal result, not an error. */\n  exitCode: number;\n}\n\nexport interface SandboxOpts {\n  /** Sandbox ID to use instead of a generated one. Lowercase letters, digits, and hyphens; must be new on the provider. */\n  id?: string;\n  /** Container image. Defaults to the provider's image. */\n  template?: string;\n  /** Snapshot to start from. Two sandboxes with the same `from` are a fork. */\n  from?: string;\n  /** Key-value tags, used to find the sandbox again with {@link SandboxNamespace.list}. */\n  metadata?: Record<string, string>;\n  /** Milliseconds without a turn before the provider removes the sandbox. Capped by the provider. */\n  idleTimeoutMs?: number;\n  /** With `from`, start from the metadata of the sandbox that made that snapshot. Pairs given in `metadata` take precedence over inherited ones. */\n  inheritParentMetadata?: boolean;\n  /** Name of the sandbox provider to create on. Required when the tenant has more than one; with `from`, it must be the provider that holds the snapshot. */\n  provider?: string;\n  /** Machine size. Providers that cannot honour a field fail the create with their own message. Providers that do not know the option ignore it. */\n  resources?: Resources;\n}\n\nexport interface Resources {\n  /** Whole cores. */\n  vcpu?: number;\n  /** A number is MiB. A string takes a Kubernetes quantity such as `'512Mi'`, `'4Gi'` or `'8G'`. */\n  memory?: number | string;\n  /** Same format as `memory`. */\n  disk?: number | string;\n}\n\nconst UNITS: Record<string, number> = {\n  K: 1e3,\n  M: 1e6,\n  G: 1e9,\n  T: 1e12,\n  Ki: 2 ** 10,\n  Mi: 2 ** 20,\n  Gi: 2 ** 30,\n  Ti: 2 ** 40,\n};\n\nfunction toMib(value: number | string, field: string): number {\n  if (typeof value === 'number') {\n    if (!Number.isInteger(value) || value <= 0)\n      throw new Error(`resources.${field}: expected a positive whole number of MiB`);\n    return value;\n  }\n  const m = /^(\\d+(?:\\.\\d+)?)\\s*([KMGT]i?)?B?$/.exec(value.trim());\n  if (!m)\n    throw new Error(\n      `resources.${field}: expected a quantity like '512Mi', '4Gi' or '8G', got ${JSON.stringify(value)}`\n    );\n  const bytes = Number(m[1]) * (m[2] ? UNITS[m[2]] : UNITS.Mi);\n  const mib = Math.ceil(bytes / UNITS.Mi);\n  if (mib <= 0) throw new Error(`resources.${field}: must be at least 1Mi`);\n  return mib;\n}\n\nfunction wireResources(r: Resources): JsonObject {\n  const out: JsonObject = {};\n  if (r.vcpu !== undefined) {\n    if (!Number.isInteger(r.vcpu) || r.vcpu <= 0)\n      throw new Error('resources.vcpu: expected a positive whole number of cores');\n    out.vcpu = r.vcpu;\n  }\n  if (r.memory !== undefined) out.memoryMib = toMib(r.memory, 'memory');\n  if (r.disk !== undefined) out.diskMib = toMib(r.disk, 'disk');\n  if (Object.keys(out).length === 0)\n    throw new Error('resources: set at least one of vcpu, memory, disk');\n  return out;\n}\n\nexport interface ExecOpts {\n  /** Kill the command after this long. The result then has `exitCode` 124. */\n  timeoutMs?: number;\n}\n\nexport interface ConnectOpts {\n  /** Image to use if the sandbox has to be started again. Defaults to the provider's image. */\n  template?: string;\n}\n\nexport interface SandboxListOpts {\n  /** Only the sandbox with this ID. */\n  sandboxId?: string;\n  /** Only sandboxes whose metadata contains every one of these pairs. */\n  metadata?: Record<string, string>;\n}\n\nexport interface SandboxInfo {\n  sandboxId: string;\n  metadata?: Record<string, string>;\n  /** True while the sandbox is running. A sandbox that is not live is started again by `connect`. */\n  live: boolean;\n  latestSnapshot?: string;\n  createdAt: Date;\n  lastUsed?: Date;\n}\n\ntype RunTurn = (input: TurnInput, opts?: { fresh?: boolean }) => Promise<TurnResult>;\n\nfunction turnRunner(client: HatchetClient): RunTurn {\n  const resolved = resolveTaskName(client);\n  return async (input, opts) => {\n    const name = await resolved;\n    const additionalMetadata = {\n      'hatchet.sandbox.fn': input.fn,\n      ...(input.sandboxId ? { 'hatchet.sandbox.id': input.sandboxId } : {}),\n      ...(input.image ? { 'hatchet.sandbox.image': input.image } : {}),\n      ...(input.snapshotId ? { 'hatchet.sandbox.from': input.snapshotId } : {}),\n    };\n    const result = opts?.fresh\n      ? await (\n          await client.admin.runWorkflow<TurnInput, Record<string, TurnResult>>(name, input, {\n            additionalMetadata,\n          })\n        ).result()\n      : await client\n          .workflow<TurnInput, Record<string, TurnResult>>({ name })\n          .run(input, { additionalMetadata });\n    return result[name] ?? (result as unknown as TurnResult);\n  };\n}\n\n/** One sandbox. Every method is one Hatchet task on the tenant's sandbox provider. */\nexport class Sandbox {\n  /** File operations on the workspace. */\n  readonly files: Files;\n\n  private constructor(\n    private readonly run: RunTurn,\n    readonly sandboxId: string,\n    private readonly template?: string\n  ) {\n    this.files = new Files((fn, input, fresh) => this.turn(fn, input, fresh));\n  }\n\n  /** Starts a new sandbox. Prefer `hatchet.sandbox.create`. */\n  static async create(client: HatchetClient, opts: SandboxOpts = {}): Promise<Sandbox> {\n    await setupTelemetry();\n    const run = turnRunner(client);\n    const metadata = opts.provider ? { ...opts.metadata, provider: opts.provider } : opts.metadata;\n    const created = await run({\n      fn: '$create',\n      input: {},\n      ...(opts.id ? { sandboxId: opts.id } : {}),\n      ...(opts.template ? { image: opts.template } : {}),\n      ...(opts.from ? { snapshotId: opts.from } : {}),\n      ...(metadata ? { metadata } : {}),\n      ...(opts.idleTimeoutMs ? { idleTtlMs: opts.idleTimeoutMs } : {}),\n      ...(opts.inheritParentMetadata ? { inheritMetadata: true } : {}),\n      ...(opts.resources ? { resources: wireResources(opts.resources) } : {}),\n    });\n    return new Sandbox(run, created.sandboxId, opts.template);\n  }\n\n  /** Attaches to a sandbox by ID. Prefer `hatchet.sandbox.connect`. */\n  static async connect(\n    client: HatchetClient,\n    sandboxId: string,\n    opts: ConnectOpts = {}\n  ): Promise<Sandbox> {\n    await setupTelemetry();\n    const run = turnRunner(client);\n    await run({\n      fn: '$connect',\n      input: {},\n      sandboxId,\n      ...(opts.template ? { image: opts.template } : {}),\n    });\n    return new Sandbox(run, sandboxId, opts.template);\n  }\n\n  /** Lists sandboxes on the provider. Prefer `hatchet.sandbox.list`. */\n  static async list(client: HatchetClient, opts: SandboxListOpts = {}): Promise<SandboxInfo[]> {\n    const result = await turnRunner(client)({\n      fn: '$list',\n      input: {\n        ...(opts.sandboxId ? { sandboxId: opts.sandboxId } : {}),\n        ...(opts.metadata ? { metadata: opts.metadata } : {}),\n      },\n    });\n    const raw = (result.output.sandboxes ?? []) as Array<\n      Omit<SandboxInfo, 'createdAt' | 'lastUsed'> & { createdAt: string; lastUsed?: string }\n    >;\n    return raw.map((s) => ({\n      ...s,\n      createdAt: new Date(s.createdAt),\n      lastUsed: s.lastUsed ? new Date(s.lastUsed) : undefined,\n    }));\n  }\n\n  /** Deletes every sandbox matching the filter, with all their snapshots and files. Prefer `hatchet.sandbox.delete`. */\n  static async delete(client: HatchetClient, opts: SandboxListOpts): Promise<string[]> {\n    if (!opts.sandboxId && Object.keys(opts.metadata ?? {}).length === 0)\n      throw new Error('delete needs a sandboxId or a metadata filter');\n    const run = turnRunner(client);\n    const ids: string[] = [];\n    for (const { sandboxId } of await Sandbox.list(client, opts)) {\n      await run({ fn: '$delete', input: {}, sandboxId });\n      ids.push(sandboxId);\n    }\n    return ids;\n  }\n\n  /** Runs a shell command with `sh -c` in the workspace and makes a snapshot. A timeout gives `exitCode` 124, not an error. */\n  async exec(cmd: string, opts: ExecOpts = {}): Promise<CommandResult> {\n    return this.turn<CommandResult>('$command', {\n      cmd,\n      ...(opts.timeoutMs ? { timeoutMs: opts.timeoutMs } : {}),\n    });\n  }\n\n  /** Removes the sandbox. Its snapshots stay; `connect` can bring it back. */\n  async kill(): Promise<void> {\n    await this.turn('$destroy', {});\n  }\n\n  /** Removes the sandbox and deletes every snapshot and file the provider stored for it. `connect` fails afterwards. */\n  async delete(): Promise<void> {\n    await this.turn('$delete', {});\n  }\n\n  private async turn<T = JsonObject>(fn: string, input: JsonObject, fresh = false): Promise<T> {\n    const result = await this.run(\n      {\n        sandboxId: this.sandboxId,\n        ...(this.template ? { image: this.template } : {}),\n        fn,\n        input,\n      },\n      { fresh }\n    );\n    return {\n      ...result.output,\n      snapshotId: result.snapshotId,\n      timings: result.timings,\n    } as unknown as T;\n  }\n}\n\n/** `hatchet.sandbox`, added to `HatchetClient` by importing `@hatchet-dev/sandbox`. */\nexport interface SandboxNamespace {\n  /** Starts a new sandbox. Inside a durable task this is a durable step. */\n  create(opts?: SandboxOpts): Promise<Sandbox>;\n  /** Attaches to a sandbox by ID. If it is not running, the provider starts it from its latest snapshot. */\n  connect(sandboxId: string, opts?: ConnectOpts): Promise<Sandbox>;\n  /** Lists sandboxes the provider knows, filtered by ID or metadata. */\n  list(opts?: SandboxListOpts): Promise<SandboxInfo[]>;\n  /** Deletes the sandboxes matching the filter, with every snapshot and file stored for them. Returns their IDs. */\n  delete(opts: SandboxListOpts): Promise<string[]>;\n}\n\ndeclare module '@hatchet-dev/typescript-sdk/v1' {\n  interface HatchetClient {\n    readonly sandbox: SandboxNamespace;\n  }\n}\n\nObject.defineProperty(HatchetClient.prototype, 'sandbox', {\n  configurable: true,\n  get(this: HatchetClient): SandboxNamespace {\n    return {\n      create: (opts) => Sandbox.create(this, opts),\n      connect: (sandboxId, opts) => Sandbox.connect(this, sandboxId, opts),\n      list: (opts) => Sandbox.list(this, opts),\n      delete: (opts) => Sandbox.delete(this, opts),\n    };\n  },\n});\n"]}

package/package.json

@@ -1,25 +1,36 @@
 {
   "name": "@hatchet-dev/sandbox",
-  "version": "0.1.1",
+  "version": "0.1.3",
+  "private": false,
   "description": "Hatchet Sandbox TypeScript SDK",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/hatchet-dev/brickie.git",
-    "directory": "sdks/typescript"
+    "url": "https://github.com/hatchet-dev/hatchet.git",
+    "directory": "sdks/typescript-sandbox"
   },
+  "type": "module",
+  "sideEffects": true,
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
       "default": "./dist/index.js"
-    }
+    },
+    "./package.json": "./package.json"
   },
-  "files": [
-    "dist",
-    "CHANGELOG.md"
-  ],
-  "publishConfig": {
-    "access": "public"
+  "peerDependencies": {
+    "@hatchet-dev/typescript-sdk": ">=1.33.1"
   },
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",
@@ -28,20 +39,34 @@
     "@opentelemetry/instrumentation": "^0.221.0",
     "@opentelemetry/sdk-trace-base": "^2.0.0"
   },
-  "peerDependencies": {
-    "@hatchet-dev/typescript-sdk": ">=1.33.1"
-  },
   "devDependencies": {
-    "@hatchet-dev/typescript-sdk": "^1.33.1",
-    "@types/node": "^24.0.0",
-    "tsx": "^4.23.15",
-    "typedoc": "^0.28.0",
-    "typescript": "^5.9.0"
+    "@eslint/js": "^10.0.1",
+    "@hatchet-dev/typescript-sdk": "file:../typescript/dist",
+    "@types/node": "^26.6.3",
+    "eslint": "^10.0.3",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.5",
+    "eslint-plugin-unused-imports": "^4.4.1",
+    "prettier": "^3.8.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.56.1"
+  },
+  "publishConfig": {
+    "access": "public"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "typecheck": "tsc",
-    "docs": "typedoc",
-    "test": "node --import tsx --test --test-force-exit --test-timeout=180000 test/e2e.test.ts"
+    "build:sdk": "cd ../typescript && pnpm install --frozen-lockfile --config.strict-dep-builds=false && pnpm tsc:build && pnpm prepublish",
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "pnpm run eslint:check && pnpm run prettier:check",
+    "lint:fix": "pnpm run eslint:fix && pnpm run prettier:fix",
+    "eslint:check": "eslint \"src/**/*.ts\"",
+    "eslint:fix": "eslint \"src/**/*.ts\" --fix",
+    "prettier:check": "prettier \"src/**/*.ts\" \"*.md\" --list-different",
+    "prettier:fix": "prettier \"src/**/*.ts\" \"*.md\" --write",
+    "publish:ci": "pnpm run build && pnpm publish --access public --no-git-checks",
+    "publish:ci:alpha": "pnpm run build && pnpm publish --access public --no-git-checks --tag alpha",
+    "release:local": "pnpm run build:sdk && pnpm install && pnpm run lint && pnpm run build && pnpm publish --access public --no-git-checks"
   }
 }

package/dist/files.d.ts

@@ -1,94 +0,0 @@
-import type { JsonObject } from '@hatchet-dev/typescript-sdk/v1';
-export type FileType = 'file' | 'dir';
-export interface EntryInfo {
-    name: string;
-    path: string;
-    type: FileType;
-    size: number;
-    mode: number;
-    permissions: string;
-    modifiedTime?: Date;
-}
-export type FileData = string | ArrayBuffer | Uint8Array | Blob;
-export interface WriteEntry {
-    path: string;
-    data: FileData;
-}
-export interface ReadOpts {
-    format?: 'text' | 'bytes' | 'blob';
-}
-export interface TransferOpts {
-    /** Give up after this long. */
-    timeoutMs?: number;
-}
-export interface ListOpts {
-    depth?: number;
-}
-export type FilesystemErrorCode = 'staging_failed' | 'not_found' | 'invalid_path' | 'invalid_url' | 'invalid_content' | 'invalid' | 'is_a_directory' | 'not_a_directory' | 'too_large' | 'transfer_failed';
-/** Thrown for caller mistakes such as a missing file or a path outside the workspace. */
-export declare class FilesystemError extends Error {
-    readonly code: FilesystemErrorCode;
-    constructor(code: FilesystemErrorCode, message: string);
-}
-type RawEntry = Omit<EntryInfo, 'modifiedTime'> & {
-    modifiedTime?: string;
-};
-interface FsOutput extends JsonObject {
-    content?: string;
-    stagedKey?: string;
-    url?: string;
-    putUrl?: string;
-    getUrl?: string;
-    entry?: RawEntry | null;
-    entries?: RawEntry[];
-    created?: boolean;
-    error?: {
-        code: FilesystemErrorCode;
-        message: string;
-    };
-}
-/** @internal */
-export type FsTurn = (fn: string, input: JsonObject) => Promise<FsOutput>;
-/** File operations on a sandbox workspace. Paths are relative to the workspace. Each call is one Hatchet task. */
-export declare class Files {
-    private readonly turn;
-    /** @internal */
-    constructor(turn: FsTurn);
-    private call;
-    /** Reads a file as text (default), bytes, or a Blob. Files over the provider's `--max-file-bytes` (2 MiB) come through the provider's `--store` instead of Hatchet. */
-    read(path: string, opts?: ReadOpts & {
-        format?: 'text';
-    }): Promise<string>;
-    read(path: string, opts: ReadOpts & {
-        format: 'bytes';
-    }): Promise<Uint8Array>;
-    read(path: string, opts: ReadOpts & {
-        format: 'blob';
-    }): Promise<Blob>;
-    /** A replayed durable read may hold a URL that has expired; the provider signs the same staged file again. */
-    private readStaged;
-    /** Writes one file or several. Parent directories are created. Bytes are stored exactly. Files over 2 MiB go through the provider's `--store` instead of Hatchet. */
-    write(path: string, data: FileData): Promise<EntryInfo>;
-    write(files: WriteEntry[]): Promise<EntryInfo[]>;
-    /** Writes several files in one task. */
-    writeFiles(files: WriteEntry[]): Promise<EntryInfo[]>;
-    /** Lists a directory. `depth` 1 (default) is the directory itself; higher values recurse. No snapshot is made. */
-    list(path?: string, opts?: ListOpts): Promise<EntryInfo[]>;
-    /** True if the path exists. No snapshot is made. */
-    exists(path: string): Promise<boolean>;
-    /** Metadata of a file or directory. Throws `FilesystemError` with code `not_found` if absent. */
-    getInfo(path: string): Promise<EntryInfo>;
-    /** Creates a directory and its parents. Returns false if it already existed. */
-    makeDir(path: string): Promise<boolean>;
-    /** Renames or moves a file or directory. */
-    rename(oldPath: string, newPath: string): Promise<EntryInfo>;
-    /** Copies a file or directory tree. */
-    copy(srcPath: string, dstPath: string): Promise<EntryInfo>;
-    /** Deletes a file or directory tree. */
-    remove(path: string): Promise<void>;
-    /** The provider fetches an https URL into the workspace. The sandbox needs no network. Private and loopback addresses are refused. */
-    download(url: string, path: string, opts?: TransferOpts): Promise<EntryInfo>;
-    /** The provider sends a workspace file to an https URL with HTTP PUT, for example a presigned URL. */
-    upload(path: string, url: string, opts?: TransferOpts): Promise<void>;
-}
-export {};