@computesdk/boat 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 computesdk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,96 @@
-# Temporary Holding Version
+# @computesdk/boat
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Boat provider for ComputeSDK: Ubuntu cloud sandboxes with streaming commands, signed file transfers, named snapshots and templates, and HTTPS preview URLs.
+
+## Installation
+
+```bash
+npm install computesdk @computesdk/provider @computesdk/boat
+```
+
+## Setup
+
+Create an API key in the [Boat dashboard](https://boat.dev/dashboard?tab=api-keys) and export it:
+
+```bash
+export BOAT_API_KEY=boat_...
+# Optional: custom API endpoint (defaults to https://boat.dev/api/v1)
+export BOAT_API_BASE=https://boat.dev/api/v1
+```
+
+## Usage
+
+```typescript
+import { createCompute } from '@computesdk/provider';
+import { boat } from '@computesdk/boat';
+
+const compute = createCompute({ provider: boat({}) });
+const sandbox = await compute.instances.create({ type: 'small' });
+
+try {
+  const result = await sandbox.runCommand('echo "Hello from Boat"');
+  console.log(result.stdout);
+  await sandbox.filesystem.writeFile('/tmp/hello.txt', 'Hello from Boat');
+  console.log(await sandbox.filesystem.readFile('/tmp/hello.txt'));
+} finally {
+  await sandbox.destroy();
+}
+```
+
+## Configuration
+
+| Option | Meaning |
+| --- | --- |
+| `apiKey` | API key; falls back to `BOAT_API_KEY` |
+| `baseURL` | API URL; falls back to `BOAT_API_BASE`, then `https://boat.dev/api/v1` |
+| `timeout` | Default sandbox lifetime in milliseconds; omitted uses Boat's one-hour default |
+| `readyTimeout` | Provisioning wait deadline in milliseconds; defaults to 300000 |
+| `snapshotTimeout` | Named snapshot save deadline in milliseconds; defaults to 600000 |
+| `preview` | Default preview settings: `public`, `localhost`, and `title` |
+| `createOptions` | Native Boat creation defaults, such as `type`, `environment`, `noEnv`, `from`, `org`, and `ttlSeconds` |
+
+## Features
+
+- Sandbox create, get, list, and permanent destroy
+- Foreground commands with reconnecting output streams, optional timeouts, and remote cleanup; background commands
+- Interactive processes through the shared daemon API
+- Filesystem access, with signed binary transfers under `/home/user` and `/tmp` (`readBoatFile`, `writeBoatFile`)
+- Named snapshots and templates through `provider.snapshot` and `provider.template`
+- Token-protected HTTPS preview URLs, with typed controls through `getBoatUrl`
+
+## Limitations
+
+- Fixed machine types: CPU, memory, disk, GPU, image, region, and arbitrary metadata options are rejected
+- Preview URLs are HTTPS only
+- Snapshots keep disk changes, not process memory; `/tmp` is excluded
+- Setup scripts run in the background, so readiness does not mean setup has finished
+
+See the [Boat provider guide](https://github.com/computesdk/computesdk/blob/main/docs/providers/boat.md) for details and examples.
+
+## Development
+
+For local live tests, put `BOAT_API_KEY=boat_...` in the repository root `.env` file, which Git ignores. Tests use the live Boat API whenever `BOAT_API_KEY` is present.
+
+```bash
+# Unit tests and real-SDK/local-HTTP transport tests; no cloud resources.
+pnpm --filter @computesdk/boat test:unit
+
+# Shared conformance, shared CRUD, and Boat-specific integration tests.
+# BOAT_API_KEY in the environment or root .env enables live calls.
+pnpm --filter @computesdk/boat test:integration
+
+# All tests (also live when credentials are available).
+pnpm --filter @computesdk/boat test
+pnpm --filter @computesdk/boat typecheck
+pnpm --filter @computesdk/boat lint
+```
+
+`index.test.ts` uses `runProviderTestSuite` and `crud.test.ts` uses `runProviderCrudTest`. The shared contract checks commands, filesystem, streaming, and interactive processes; its baseline tests use shared mocks without credentials. CRUD and Boat-specific integration tests skip without credentials. No separate live opt-in flag is required.
+
+`unit.test.ts` uses SDK mocks; `transport.test.ts` uses the real Boat SDK against a local HTTP server. The separate `integration.test.ts` covers signed large-text/binary transfers, protected/public localhost preview routing, and named snapshot restore. Test files run sequentially to avoid concurrent account-quota pressure. The shared conformance entry point also spaces sandbox starts to stay below Boat's standard 12-starts-per-minute limit; accounts with lower limits may need slower pacing.
+
+Credentialed runs create multiple small billable sandboxes. Shared suite hooks clean up their instances; the Boat-specific test attempts cleanup of both sandboxes and its named snapshot in a finally block. To run every suite without cloud access even when root .env contains a key, use `BOAT_API_KEY= pnpm --filter @computesdk/boat test`.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,64 @@
+import { NamedSnapshot, CreateSandboxRequest, BoatApi } from '@boatdev/sdk';
+export { CreateSandboxRequest as BoatCreateOptions } from '@boatdev/sdk';
+import { CreateTemplateOptions, Provider, ProviderSnapshotManager, ProviderTemplateManager } from '@computesdk/provider';
+
+interface BoatSnapshot extends NamedSnapshot {
+    /** Reusable snapshot name; the native snapshotId is a different, non-bootable artifact ID. */
+    id: string;
+    provider: 'boat';
+}
+interface BoatTemplate extends BoatSnapshot {
+    templateId: string;
+}
+
+/** Binary download. Signed URLs support files under /home/user and /tmp. */
+declare function readBoatFile(sandbox: BoatSandbox, path: string): Promise<Uint8Array>;
+/** Binary or UTF-8 upload, without embedding the file in a command argument. */
+declare function writeBoatFile(sandbox: BoatSandbox, path: string, content: string | Uint8Array): Promise<void>;
+
+interface BoatConfig {
+    /** Falls back to BOAT_API_KEY. */
+    apiKey?: string;
+    /** Falls back to BOAT_API_BASE, then https://boat.dev/api/v1. */
+    baseURL?: string;
+    /** Default sandbox lifetime in milliseconds. Boat defaults to one hour. */
+    timeout?: number;
+    /** Provisioning deadline in milliseconds (default: 300000). */
+    readyTimeout?: number;
+    /** Native defaults, including type, environment, noEnv, and from. */
+    createOptions?: CreateSandboxRequest;
+    /** Named snapshot save deadline in milliseconds (default: 600000). */
+    snapshotTimeout?: number;
+    /** Default HTTPS preview settings. */
+    preview?: BoatPreviewDefaults;
+}
+/** Boat has an account-level client; retain it alongside the sandbox ID. */
+interface BoatSandbox {
+    api: BoatApi;
+    id: string;
+    /** Boat's sandbox name, so callers can match list() results without a getInfo() call each. */
+    name: string;
+    preview?: BoatPreviewDefaults;
+}
+interface BoatPreviewDefaults {
+    public?: boolean;
+    localhost?: boolean;
+    title?: string;
+}
+interface BoatPreviewOptions extends BoatPreviewDefaults {
+    port: number;
+    protocol?: string;
+}
+/** Typed preview controls beyond the portable getUrl interface. */
+declare function getBoatUrl(sandbox: BoatSandbox, options: BoatPreviewOptions): Promise<string>;
+interface BoatCreateTemplateOptions extends CreateTemplateOptions {
+    /** Sandbox whose disk to freeze as a reusable named template. */
+    sandboxId: string;
+}
+interface BoatProvider extends Provider<BoatSandbox, BoatTemplate, BoatSnapshot> {
+    snapshot: ProviderSnapshotManager<BoatSnapshot>;
+    template: ProviderTemplateManager<BoatTemplate, BoatCreateTemplateOptions>;
+}
+declare function boat(config?: BoatConfig): BoatProvider;
+
+export { type BoatConfig, type BoatCreateTemplateOptions, type BoatPreviewDefaults, type BoatPreviewOptions, type BoatProvider, type BoatSandbox, type BoatSnapshot, type BoatTemplate, boat, getBoatUrl, readBoatFile, writeBoatFile };

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+import { NamedSnapshot, CreateSandboxRequest, BoatApi } from '@boatdev/sdk';
+export { CreateSandboxRequest as BoatCreateOptions } from '@boatdev/sdk';
+import { CreateTemplateOptions, Provider, ProviderSnapshotManager, ProviderTemplateManager } from '@computesdk/provider';
+
+interface BoatSnapshot extends NamedSnapshot {
+    /** Reusable snapshot name; the native snapshotId is a different, non-bootable artifact ID. */
+    id: string;
+    provider: 'boat';
+}
+interface BoatTemplate extends BoatSnapshot {
+    templateId: string;
+}
+
+/** Binary download. Signed URLs support files under /home/user and /tmp. */
+declare function readBoatFile(sandbox: BoatSandbox, path: string): Promise<Uint8Array>;
+/** Binary or UTF-8 upload, without embedding the file in a command argument. */
+declare function writeBoatFile(sandbox: BoatSandbox, path: string, content: string | Uint8Array): Promise<void>;
+
+interface BoatConfig {
+    /** Falls back to BOAT_API_KEY. */
+    apiKey?: string;
+    /** Falls back to BOAT_API_BASE, then https://boat.dev/api/v1. */
+    baseURL?: string;
+    /** Default sandbox lifetime in milliseconds. Boat defaults to one hour. */
+    timeout?: number;
+    /** Provisioning deadline in milliseconds (default: 300000). */
+    readyTimeout?: number;
+    /** Native defaults, including type, environment, noEnv, and from. */
+    createOptions?: CreateSandboxRequest;
+    /** Named snapshot save deadline in milliseconds (default: 600000). */
+    snapshotTimeout?: number;
+    /** Default HTTPS preview settings. */
+    preview?: BoatPreviewDefaults;
+}
+/** Boat has an account-level client; retain it alongside the sandbox ID. */
+interface BoatSandbox {
+    api: BoatApi;
+    id: string;
+    /** Boat's sandbox name, so callers can match list() results without a getInfo() call each. */
+    name: string;
+    preview?: BoatPreviewDefaults;
+}
+interface BoatPreviewDefaults {
+    public?: boolean;
+    localhost?: boolean;
+    title?: string;
+}
+interface BoatPreviewOptions extends BoatPreviewDefaults {
+    port: number;
+    protocol?: string;
+}
+/** Typed preview controls beyond the portable getUrl interface. */
+declare function getBoatUrl(sandbox: BoatSandbox, options: BoatPreviewOptions): Promise<string>;
+interface BoatCreateTemplateOptions extends CreateTemplateOptions {
+    /** Sandbox whose disk to freeze as a reusable named template. */
+    sandboxId: string;
+}
+interface BoatProvider extends Provider<BoatSandbox, BoatTemplate, BoatSnapshot> {
+    snapshot: ProviderSnapshotManager<BoatSnapshot>;
+    template: ProviderTemplateManager<BoatTemplate, BoatCreateTemplateOptions>;
+}
+declare function boat(config?: BoatConfig): BoatProvider;
+
+export { type BoatConfig, type BoatCreateTemplateOptions, type BoatPreviewDefaults, type BoatPreviewOptions, type BoatProvider, type BoatSandbox, type BoatSnapshot, type BoatTemplate, boat, getBoatUrl, readBoatFile, writeBoatFile };

package/dist/index.js

@@ -0,0 +1,394 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  boat: () => boat,
+  getBoatUrl: () => getBoatUrl,
+  readBoatFile: () => readBoatFile,
+  writeBoatFile: () => writeBoatFile
+});
+module.exports = __toCommonJS(index_exports);
+var import_sdk2 = require("@boatdev/sdk");
+var import_provider3 = require("@computesdk/provider");
+
+// src/commands.ts
+var import_sdk = require("@boatdev/sdk");
+var import_provider = require("@computesdk/provider");
+function commandText(command, options) {
+  let text = command;
+  if (options?.env && Object.keys(options.env).length > 0) {
+    const env = Object.entries(options.env).map(([key, value]) => {
+      if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) throw new Error(`Invalid environment variable name: ${key}`);
+      return `"${(0, import_provider.escapeShellArg)(`${key}=${value}`)}"`;
+    }).join(" ");
+    text = `env ${env} /bin/sh -c "${(0, import_provider.escapeShellArg)(command)}"`;
+  }
+  return options?.cwd ? `cd -- "${(0, import_provider.escapeShellArg)(options.cwd)}" || exit
+${text}` : text;
+}
+async function run(sandbox, command, options) {
+  const start = Date.now();
+  const text = commandText(command, options);
+  if (options?.timeout !== void 0 && (!Number.isFinite(options.timeout) || options.timeout < 0)) {
+    throw new Error("Boat command timeout must be non-negative milliseconds; 0 means unlimited.");
+  }
+  if (options?.background) {
+    await sandbox.api.command({ sandboxId: sandbox.id, commandRequest: { command: text, detached: true } });
+    return { stdout: "", stderr: "", exitCode: 0, durationMs: Date.now() - start };
+  }
+  const controller = new AbortController();
+  let timer;
+  let processId;
+  let timedOut = false;
+  let stdout = "";
+  let stderr = "";
+  const result = (exitCode) => ({ stdout, stderr, exitCode, durationMs: Date.now() - start });
+  try {
+    for await (const frame of (0, import_sdk.runCommand)(sandbox.api, sandbox.id, text, { signal: controller.signal })) {
+      if (frame.type === "started") {
+        if (typeof frame.processId !== "number") throw new Error("Boat did not return a process ID.");
+        processId = frame.processId;
+        if (options?.timeout) {
+          const deadline = Date.now() + options.timeout;
+          const expire = () => {
+            const remaining = deadline - Date.now();
+            if (remaining <= 0) {
+              timedOut = true;
+              controller.abort();
+            } else timer = setTimeout(expire, Math.min(remaining, 2147483647));
+          };
+          expire();
+        }
+      }
+      if (frame.type === "stdout") {
+        stdout += frame.data ?? "";
+        options?.onStdout?.(frame.data ?? "");
+      }
+      if (frame.type === "stderr") {
+        stderr += frame.data ?? "";
+        options?.onStderr?.(frame.data ?? "");
+      }
+      if (frame.type === "error") throw new Error(frame.message || frame.error || "Boat command stream failed.");
+      if (frame.type === "exit" && !timedOut) return result(frame.timedOut ? 124 : frame.exitCode ?? 1);
+    }
+    throw new Error("Boat command stream ended without an exit frame.");
+  } catch (error) {
+    clearTimeout(timer);
+    if (processId !== void 0) {
+      try {
+        await sandbox.api.stopCommand({ sandboxId: sandbox.id, processId });
+      } catch (cleanupError) {
+        if (cleanupError?.response?.status !== 404) {
+          const reason = timedOut ? "timeout" : `stream failure (${error instanceof Error ? error.message : String(error)})`;
+          throw new Error(`Failed to stop Boat process ${processId} after ${reason}: ${String(cleanupError)}`);
+        }
+      }
+    }
+    if (timedOut) return result(124);
+    throw error;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function checked(sandbox, command) {
+  const result = await run(sandbox, command);
+  if (result.exitCode !== 0) throw new Error(`Boat filesystem operation failed: ${result.stderr || result.stdout || `exit ${result.exitCode}`}`);
+  return result.stdout;
+}
+
+// src/files.ts
+var import_node_path = require("path");
+var import_provider2 = require("@computesdk/provider");
+function signedPath(path) {
+  const absolute = import_node_path.posix.resolve("/home/user", path);
+  return absolute.startsWith("/home/user/") || absolute.startsWith("/tmp/");
+}
+async function readBoatFile(sandbox, path) {
+  if (!signedPath(path)) {
+    return new Uint8Array(Buffer.from(await checked(sandbox, `base64 < "${(0, import_provider2.escapeShellArg)(path)}"`), "base64"));
+  }
+  const signed = await sandbox.api.createDownloadUrl({ sandboxId: sandbox.id, fileUrlRequest: { path } });
+  const response = await fetch(signed.url);
+  if (!response.ok) throw new Error(`Boat file download failed (HTTP ${response.status}).`);
+  return new Uint8Array(await response.arrayBuffer());
+}
+async function writeBoatFile(sandbox, path, content) {
+  if (!signedPath(path)) {
+    const encoded = Buffer.from(content).toString("base64");
+    await checked(sandbox, `: > "${(0, import_provider2.escapeShellArg)(path)}"`);
+    for (let offset = 0; offset < encoded.length; offset += 48 * 1024) {
+      await checked(sandbox, `printf %s "${encoded.slice(offset, offset + 48 * 1024)}" | base64 -d >> "${(0, import_provider2.escapeShellArg)(path)}"`);
+    }
+    return;
+  }
+  const signed = await sandbox.api.createUploadUrl({ sandboxId: sandbox.id, fileUrlRequest: { path } });
+  const response = await fetch(signed.url, { method: signed.method, body: Buffer.from(content) });
+  if (!response.ok) throw new Error(`Boat file upload failed (HTTP ${response.status}).`);
+  await response.body?.cancel();
+}
+
+// src/snapshots.ts
+var import_node_crypto = require("crypto");
+function snapshotInfo(snapshot) {
+  return { ...snapshot, id: snapshot.name, provider: "boat" };
+}
+function templateInfo(snapshot) {
+  return { ...snapshot, templateId: snapshot.name };
+}
+async function saveSnapshot(api, config, sandboxId, options) {
+  if (options?.metadata !== void 0) throw new Error("Boat named snapshots do not support arbitrary metadata.");
+  const name = options?.name ?? `compute-${(0, import_node_crypto.randomUUID)()}`;
+  if (!/^[a-z0-9][a-z0-9-]{0,62}$/.test(name) || ["latest", "tree", "pull", "rm", "save", "current", "self", "new"].includes(name)) {
+    throw new Error("Boat snapshot names must be 1-63 lowercase letters, digits, or dashes, start with a letter or digit, and not be reserved.");
+  }
+  const timeout = config.snapshotTimeout ?? 6e5;
+  if (!Number.isFinite(timeout) || timeout <= 0) throw new Error("Boat snapshotTimeout must be positive milliseconds.");
+  const deadline = Date.now() + timeout;
+  let snapshot = (await api.saveNamedSnapshot({ namedSnapshotSaveRequest: { sandboxId, name } })).snapshot;
+  while (snapshot.status !== "ready") {
+    if (snapshot.status === "failed") throw new Error(`Boat snapshot ${name} failed: ${snapshot.error ?? "unknown error"}`);
+    if (Date.now() >= deadline) throw new Error(`Timed out waiting for Boat snapshot ${name}; inspect or delete it through the snapshot manager.`);
+    await new Promise((resolve) => setTimeout(resolve, Math.min(2e3, Math.max(0, deadline - Date.now()))));
+    snapshot = (await api.getNamedSnapshot({ name })).snapshot;
+  }
+  return snapshotInfo(snapshot);
+}
+function limitItems(items, limit) {
+  if (limit !== void 0 && (!Number.isInteger(limit) || limit < 0)) throw new Error("Boat list limit must be a non-negative integer.");
+  return limit === void 0 ? items : items.slice(0, limit);
+}
+async function listSnapshots(api, options) {
+  limitItems([], options?.limit);
+  if (options?.limit === 0) return [];
+  const sandboxId = options?.instanceId ?? options?.sandboxId;
+  return limitItems((await api.listNamedSnapshots()).snapshots.filter((snapshot) => sandboxId === void 0 || snapshot.sourceSandboxId === sandboxId).map(snapshotInfo), options?.limit);
+}
+
+// src/index.ts
+var BoatClient = class extends import_sdk2.BoatApi {
+  async request(context, initOverrides) {
+    try {
+      return await super.request(context, initOverrides);
+    } catch (error) {
+      if (!(error instanceof import_sdk2.ResponseError)) throw error;
+      const { response } = error;
+      const text = (await response.clone().text().catch(() => "")).replace(/\s+/g, " ").trim();
+      let detail = text.slice(0, 300);
+      try {
+        const body = JSON.parse(text);
+        const parts = [body.error, body.message].filter((part) => typeof part === "string" && part !== "");
+        if (parts.length > 0) detail = parts.join(": ").slice(0, 300);
+      } catch {
+      }
+      throw new import_sdk2.ResponseError(response, `Boat API error: ${response.status} ${response.statusText}${detail ? `: ${detail}` : ""}`);
+    }
+  }
+};
+function client(config) {
+  const apiKey = config.apiKey || process.env.BOAT_API_KEY;
+  if (!apiKey) throw new Error("Missing Boat API key. Provide 'apiKey' or set BOAT_API_KEY. Create a key at https://boat.dev/dashboard?tab=api-keys");
+  return new BoatClient(new import_sdk2.Configuration({
+    accessToken: apiKey,
+    basePath: config.baseURL || process.env.BOAT_API_BASE || "https://boat.dev/api/v1"
+  }));
+}
+function seconds(ms) {
+  if (!Number.isFinite(ms) || ms <= 0) throw new Error("Boat timeout must be a positive number of milliseconds.");
+  return Math.ceil(ms / 1e3);
+}
+function isNotFound(error) {
+  return error?.response?.status === 404;
+}
+async function waitUntilReady(api, sandboxId, timeoutMs, signal) {
+  const deadline = timeoutMs === 0 ? Number.POSITIVE_INFINITY : Date.now() + timeoutMs;
+  for (; ; ) {
+    if (signal?.aborted) throw signal.reason ?? new Error("Boat creation aborted.");
+    const { state } = (await api.get({ sandboxId })).sandbox;
+    if (["ready", "idle", "running"].includes(state)) return;
+    if (["archived", "archiving", "error", "cancelled"].includes(state)) throw new Error(`Boat sandbox ${sandboxId} entered terminal state ${state}.`);
+    if (Date.now() >= deadline) throw new Error(`Timed out waiting for Boat sandbox ${sandboxId} to become ready.`);
+    await new Promise((resolve) => setTimeout(resolve, Math.min(2e3, deadline - Date.now())));
+  }
+}
+function wrap(api, sandbox, preview) {
+  return { instance: { api, id: sandbox.id, name: sandbox.name, ...preview ? { preview } : {} }, instanceId: sandbox.id };
+}
+async function getBoatUrl(sandbox, options) {
+  if (options.protocol && options.protocol !== "https") throw new Error("Boat preview URLs support HTTPS only.");
+  const settings = { ...sandbox.preview, ...options };
+  const hostPortRequest = {
+    port: settings.port,
+    ...settings.public === void 0 ? {} : { _public: settings.public },
+    ...settings.localhost === void 0 ? {} : { localhost: settings.localhost },
+    ...settings.title === void 0 ? {} : { title: settings.title }
+  };
+  const result = await sandbox.api.hostPort({ sandboxId: sandbox.id, hostPortRequest });
+  if (!result.url) throw new Error("Boat did not return a preview URL.");
+  return result.url;
+}
+var createBoatProvider = (0, import_provider3.defineProvider)({
+  name: "boat",
+  methods: {
+    instances: {
+      create: async (config, options) => {
+        if (options?.templateId && options?.snapshotId) throw new Error("Specify either templateId or snapshotId, not both.");
+        if (options?.metadata !== void 0) throw new Error("Boat does not support arbitrary instance metadata.");
+        for (const key of ["cpu", "cpuLimit", "cpus", "vcpus", "memory", "memoryMiB", "memMiB", "memoryMb", "diskMiB", "diskMb", "diskSize", "resources", "launch_parameters", "deploymentPlan", "size", "vmTier", "gpu", "image", "region", "architecture"]) {
+          if (options?.[key] !== void 0) throw new Error(`Boat does not support ${key}; select a fixed machine type with type.`);
+        }
+        const api = client(config);
+        const lifetime = options?.timeout ?? (options?.ttlSeconds === void 0 ? config.timeout : void 0);
+        const defaults = config.createOptions;
+        const request = {
+          ...defaults,
+          type: options?.type ?? defaults?.type,
+          environment: options?.environment ?? defaults?.environment,
+          noEnv: options?.noEnv ?? defaults?.noEnv,
+          snapshots: options?.snapshots ?? defaults?.snapshots,
+          monitoring: options?.monitoring ?? defaults?.monitoring,
+          failFast: options?.failFast ?? defaults?.failFast,
+          setupScript: options?.setupScript ?? defaults?.setupScript,
+          org: options?.org ?? options?.teamId ?? defaults?.org,
+          from: options?.snapshotId ?? options?.templateId ?? options?.from ?? defaults?.from,
+          env: options?.envs ?? options?.env ?? defaults?.env,
+          ttlSeconds: lifetime === void 0 ? options?.ttlSeconds === void 0 ? defaults?.ttlSeconds : options.ttlSeconds : seconds(lifetime)
+        };
+        if (options?.signal?.aborted) throw options.signal.reason ?? new Error("Boat creation aborted.");
+        const { sandbox } = await api.create({ createSandboxRequest: request });
+        try {
+          await waitUntilReady(api, sandbox.id, config.readyTimeout ?? 3e5, options?.signal);
+          if (options?.signal?.aborted) throw options.signal.reason ?? new Error("Boat creation aborted.");
+          if (options?.name) await api.update({ sandboxId: sandbox.id, updateSandboxRequest: { name: options.name } });
+          return wrap(api, options?.name ? { ...sandbox, name: options.name } : sandbox, config.preview);
+        } catch (error) {
+          try {
+            await api.deleteSandbox({ sandboxId: sandbox.id, xAsciiConfirmDelete: sandbox.id });
+          } catch (cleanupError) {
+            if (isNotFound(cleanupError)) throw error;
+            throw new Error(`Boat creation failed (${String(error)}); cleanup of ${sandbox.id} also failed: ${String(cleanupError)}`);
+          }
+          throw error;
+        }
+      },
+      getById: async (config, sandboxId) => {
+        const api = client(config);
+        try {
+          return wrap(api, (await api.get({ sandboxId })).sandbox, config.preview);
+        } catch (error) {
+          if (isNotFound(error)) return null;
+          throw error;
+        }
+      },
+      list: async (config) => {
+        const api = client(config);
+        const items = [];
+        let cursor;
+        do {
+          const page = await api.sandboxes({ cursor });
+          items.push(...page.sandboxes.filter((s) => ["ready", "idle", "running"].includes(s.state)).map((s) => wrap(api, s, config.preview)));
+          cursor = page.pageInfo?.hasMore ? page.pageInfo.nextCursor ?? void 0 : void 0;
+        } while (cursor);
+        return items;
+      },
+      destroy: async (config, sandboxId) => {
+        try {
+          await client(config).deleteSandbox({ sandboxId, xAsciiConfirmDelete: sandboxId });
+        } catch (error) {
+          if (!isNotFound(error)) throw error;
+        }
+      },
+      runCommand: run,
+      streamCommand: run,
+      getInfo: async (sandbox) => {
+        const info = (await sandbox.api.get({ sandboxId: sandbox.id })).sandbox;
+        return {
+          id: info.id,
+          provider: "boat",
+          status: ["error", "cancelled"].includes(info.state) ? "error" : ["archived", "archiving"].includes(info.state) ? "stopped" : "running",
+          createdAt: info.createdAt ?? /* @__PURE__ */ new Date(0),
+          timeout: info.ttlSeconds == null ? 0 : info.ttlSeconds * 1e3,
+          metadata: { name: info.name, state: info.state, type: info.type, ip: info.ip, environment: info.environment, archiveAfter: info.archiveAfter }
+        };
+      },
+      getUrl: getBoatUrl,
+      filesystem: {
+        readFile: async (sandbox, path) => Buffer.from(await readBoatFile(sandbox, path)).toString("utf8"),
+        writeFile: writeBoatFile,
+        mkdir: async (sandbox, path) => {
+          await checked(sandbox, `mkdir -p -- "${(0, import_provider3.escapeShellArg)(path)}"`);
+        },
+        readdir: async (sandbox, path) => {
+          const script = 'import os,json,sys; p=sys.argv[1]; print(json.dumps([dict(name=e.name,type="directory" if e.is_dir() else "file",size=e.stat(follow_symlinks=False).st_size,modified=e.stat(follow_symlinks=False).st_mtime) for e in os.scandir(p)]))';
+          const entries = JSON.parse(await checked(sandbox, `python3 -c "${(0, import_provider3.escapeShellArg)(script)}" "${(0, import_provider3.escapeShellArg)(path)}"`));
+          return entries.map((entry) => ({ ...entry, modified: new Date(entry.modified * 1e3) }));
+        },
+        exists: async (sandbox, path) => {
+          const result = await run(sandbox, `test -e "${(0, import_provider3.escapeShellArg)(path)}"`);
+          if (result.exitCode > 1) throw new Error(`Boat filesystem exists failed: ${result.stderr}`);
+          return result.exitCode === 0;
+        },
+        remove: async (sandbox, path) => {
+          await checked(sandbox, `rm -rf -- "${(0, import_provider3.escapeShellArg)(path)}"`);
+        }
+      },
+      getInstance: (sandbox) => sandbox
+    },
+    snapshot: {
+      create: (config, sandboxId, options) => saveSnapshot(client(config), config, sandboxId, options),
+      list: (config, options) => listSnapshots(client(config), options),
+      delete: async (config, name) => {
+        try {
+          await client(config).deleteNamedSnapshot({ name });
+        } catch (error) {
+          if (!isNotFound(error)) throw error;
+        }
+      }
+    },
+    template: {
+      create: async (config, baseOptions) => {
+        const options = baseOptions;
+        if (!options.sandboxId) throw new Error("Boat template creation requires sandboxId.");
+        if (options.description !== void 0) throw new Error("Boat named templates do not support descriptions.");
+        return templateInfo(await saveSnapshot(client(config), config, options.sandboxId, options));
+      },
+      list: async (config, options) => (await listSnapshots(client(config), options)).map(templateInfo),
+      delete: async (config, name) => {
+        try {
+          await client(config).deleteNamedSnapshot({ name });
+        } catch (error) {
+          if (!isNotFound(error)) throw error;
+        }
+      }
+    }
+  }
+});
+function boat(config = {}) {
+  const provider = createBoatProvider(config);
+  return { ...provider, snapshot: provider.snapshot, template: provider.template };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  boat,
+  getBoatUrl,
+  readBoatFile,
+  writeBoatFile
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/commands.ts","../src/files.ts","../src/snapshots.ts"],"sourcesContent":["import { BoatApi, Configuration, ResponseError } from '@boatdev/sdk';\nimport type { CreateSandboxRequest, InitOverrideFunction, RequestOpts, Sandbox } from '@boatdev/sdk';\nimport { defineProvider, escapeShellArg } from '@computesdk/provider';\nimport type { Provider, ProviderSnapshotManager, ProviderTemplateManager, CreateTemplateOptions } from '@computesdk/provider';\nimport { checked, run } from './commands';\nimport { readBoatFile, writeBoatFile } from './files';\nimport { saveSnapshot, listSnapshots, templateInfo } from './snapshots';\nimport type { BoatSnapshot, BoatTemplate } from './snapshots';\nimport type { FileEntry } from 'computesdk';\n\nexport interface BoatConfig {\n  /** Falls back to BOAT_API_KEY. */\n  apiKey?: string;\n  /** Falls back to BOAT_API_BASE, then https://boat.dev/api/v1. */\n  baseURL?: string;\n  /** Default sandbox lifetime in milliseconds. Boat defaults to one hour. */\n  timeout?: number;\n  /** Provisioning deadline in milliseconds (default: 300000). */\n  readyTimeout?: number;\n  /** Native defaults, including type, environment, noEnv, and from. */\n  createOptions?: CreateSandboxRequest;\n  /** Named snapshot save deadline in milliseconds (default: 600000). */\n  snapshotTimeout?: number;\n  /** Default HTTPS preview settings. */\n  preview?: BoatPreviewDefaults;\n}\n\n/** Boat has an account-level client; retain it alongside the sandbox ID. */\nexport interface BoatSandbox {\n  api: BoatApi;\n  id: string;\n  /** Boat's sandbox name, so callers can match list() results without a getInfo() call each. */\n  name: string;\n  preview?: BoatPreviewDefaults;\n}\n\n/**\n * The SDK's errors say only \"Response returned an error code\". Add the status and Boat's\n * error body, and keep an unread `response` for the SDK's retry checks and 404 handling.\n * Overriding request() leaves successful responses, including command streams, untouched.\n */\nclass BoatClient extends BoatApi {\n  protected async request(context: RequestOpts, initOverrides?: RequestInit | InitOverrideFunction): Promise<Response> {\n    try {\n      return await super.request(context, initOverrides);\n    } catch (error) {\n      if (!(error instanceof ResponseError)) throw error;\n      const { response } = error;\n      const text = (await response.clone().text().catch(() => '')).replace(/\\s+/g, ' ').trim();\n      let detail = text.slice(0, 300);\n      try {\n        const body = JSON.parse(text) as { error?: unknown; message?: unknown };\n        const parts = [body.error, body.message].filter((part): part is string => typeof part === 'string' && part !== '');\n        if (parts.length > 0) detail = parts.join(': ').slice(0, 300);\n      } catch { /* Not JSON; keep the raw text. */ }\n      throw new ResponseError(response, `Boat API error: ${response.status} ${response.statusText}${detail ? `: ${detail}` : ''}`);\n    }\n  }\n}\n\nfunction client(config: BoatConfig): BoatApi {\n  const apiKey = config.apiKey || process.env.BOAT_API_KEY;\n  if (!apiKey) throw new Error(\"Missing Boat API key. Provide 'apiKey' or set BOAT_API_KEY. Create a key at https://boat.dev/dashboard?tab=api-keys\");\n  return new BoatClient(new Configuration({\n    accessToken: apiKey,\n    basePath: config.baseURL || process.env.BOAT_API_BASE || 'https://boat.dev/api/v1',\n  }));\n}\n\nfunction seconds(ms: number): number {\n  if (!Number.isFinite(ms) || ms <= 0) throw new Error('Boat timeout must be a positive number of milliseconds.');\n  return Math.ceil(ms / 1000);\n}\n\nfunction isNotFound(error: unknown): boolean {\n  return (error as { response?: { status?: number } })?.response?.status === 404;\n}\n\n/** Unlike the SDK's waitUntilReady, stop on cancelled sandboxes and honour the abort signal. */\nasync function waitUntilReady(api: BoatApi, sandboxId: string, timeoutMs: number, signal?: AbortSignal): Promise<void> {\n  const deadline = timeoutMs === 0 ? Number.POSITIVE_INFINITY : Date.now() + timeoutMs;\n  for (;;) {\n    if (signal?.aborted) throw signal.reason ?? new Error('Boat creation aborted.');\n    const { state } = (await api.get({ sandboxId })).sandbox;\n    if (['ready', 'idle', 'running'].includes(state)) return;\n    if (['archived', 'archiving', 'error', 'cancelled'].includes(state)) throw new Error(`Boat sandbox ${sandboxId} entered terminal state ${state}.`);\n    if (Date.now() >= deadline) throw new Error(`Timed out waiting for Boat sandbox ${sandboxId} to become ready.`);\n    await new Promise(resolve => setTimeout(resolve, Math.min(2000, deadline - Date.now())));\n  }\n}\n\nfunction wrap(api: BoatApi, sandbox: Sandbox, preview?: BoatPreviewDefaults) {\n  return { instance: { api, id: sandbox.id, name: sandbox.name, ...(preview ? { preview } : {}) }, instanceId: sandbox.id };\n}\n\nexport interface BoatPreviewDefaults {\n  public?: boolean;\n  localhost?: boolean;\n  title?: string;\n}\nexport interface BoatPreviewOptions extends BoatPreviewDefaults { port: number; protocol?: string }\n\n/** Typed preview controls beyond the portable getUrl interface. */\nexport async function getBoatUrl(sandbox: BoatSandbox, options: BoatPreviewOptions): Promise<string> {\n  if (options.protocol && options.protocol !== 'https') throw new Error('Boat preview URLs support HTTPS only.');\n  const settings = { ...sandbox.preview, ...options };\n  const hostPortRequest = {\n    port: settings.port,\n    ...(settings.public === undefined ? {} : { _public: settings.public }),\n    ...(settings.localhost === undefined ? {} : { localhost: settings.localhost }),\n    ...(settings.title === undefined ? {} : { title: settings.title }),\n  };\n  const result = await sandbox.api.hostPort({ sandboxId: sandbox.id, hostPortRequest });\n  if (!result.url) throw new Error('Boat did not return a preview URL.');\n  return result.url;\n}\n\nexport interface BoatCreateTemplateOptions extends CreateTemplateOptions {\n  /** Sandbox whose disk to freeze as a reusable named template. */\n  sandboxId: string;\n}\nexport interface BoatProvider extends Provider<BoatSandbox, BoatTemplate, BoatSnapshot> {\n  snapshot: ProviderSnapshotManager<BoatSnapshot>;\n  template: ProviderTemplateManager<BoatTemplate, BoatCreateTemplateOptions>;\n}\n\nconst createBoatProvider = defineProvider<BoatSandbox, BoatConfig, BoatTemplate, BoatSnapshot>({\n  name: 'boat',\n  methods: {\n    instances: {\n      create: async (config, options) => {\n        if (options?.templateId && options?.snapshotId) throw new Error('Specify either templateId or snapshotId, not both.');\n        if (options?.metadata !== undefined) throw new Error('Boat does not support arbitrary instance metadata.');\n        for (const key of ['cpu', 'cpuLimit', 'cpus', 'vcpus', 'memory', 'memoryMiB', 'memMiB', 'memoryMb', 'diskMiB', 'diskMb', 'diskSize', 'resources', 'launch_parameters', 'deploymentPlan', 'size', 'vmTier', 'gpu', 'image', 'region', 'architecture']) {\n          if (options?.[key] !== undefined) throw new Error(`Boat does not support ${key}; select a fixed machine type with type.`);\n        }\n        const api = client(config);\n        const lifetime = options?.timeout ?? (options?.ttlSeconds === undefined ? config.timeout : undefined);\n        const defaults = config.createOptions;\n        const request: CreateSandboxRequest = {\n          ...defaults,\n          type: options?.type ?? defaults?.type,\n          environment: options?.environment ?? defaults?.environment,\n          noEnv: options?.noEnv ?? defaults?.noEnv,\n          snapshots: options?.snapshots ?? defaults?.snapshots,\n          monitoring: options?.monitoring ?? defaults?.monitoring,\n          failFast: options?.failFast ?? defaults?.failFast,\n          setupScript: options?.setupScript ?? defaults?.setupScript,\n          org: options?.org ?? options?.teamId ?? defaults?.org,\n          from: options?.snapshotId ?? options?.templateId ?? options?.from ?? defaults?.from,\n          env: options?.envs ?? options?.env ?? defaults?.env,\n          ttlSeconds: lifetime === undefined ? (options?.ttlSeconds === undefined ? defaults?.ttlSeconds : options.ttlSeconds) : seconds(lifetime),\n        };\n        if (options?.signal?.aborted) throw options.signal.reason ?? new Error('Boat creation aborted.');\n        const { sandbox } = await api.create({ createSandboxRequest: request });\n        try {\n          await waitUntilReady(api, sandbox.id, config.readyTimeout ?? 300_000, options?.signal);\n          if (options?.signal?.aborted) throw options.signal.reason ?? new Error('Boat creation aborted.');\n          if (options?.name) await api.update({ sandboxId: sandbox.id, updateSandboxRequest: { name: options.name } });\n          return wrap(api, options?.name ? { ...sandbox, name: options.name } : sandbox, config.preview);\n        } catch (error) {\n          // A provisioning or rename failure must not leave a billable VM behind.\n          try { await api.deleteSandbox({ sandboxId: sandbox.id, xAsciiConfirmDelete: sandbox.id }); }\n          catch (cleanupError) {\n            // Boat removes cancelled sandboxes itself, so a 404 means there is nothing left to clean up.\n            if (isNotFound(cleanupError)) throw error;\n            throw new Error(`Boat creation failed (${String(error)}); cleanup of ${sandbox.id} also failed: ${String(cleanupError)}`);\n          }\n          throw error;\n        }\n      },\n      getById: async (config, sandboxId) => {\n        const api = client(config);\n        try { return wrap(api, (await api.get({ sandboxId })).sandbox, config.preview); }\n        catch (error) { if (isNotFound(error)) return null; throw error; }\n      },\n      list: async config => {\n        const api = client(config);\n        const items: ReturnType<typeof wrap>[] = [];\n        let cursor: string | undefined;\n        do {\n          const page = await api.sandboxes({ cursor });\n          items.push(...page.sandboxes.filter(s => ['ready', 'idle', 'running'].includes(s.state)).map(s => wrap(api, s, config.preview)));\n          cursor = page.pageInfo?.hasMore ? page.pageInfo.nextCursor ?? undefined : undefined;\n        } while (cursor);\n        return items;\n      },\n      destroy: async (config, sandboxId) => {\n        try { await client(config).deleteSandbox({ sandboxId, xAsciiConfirmDelete: sandboxId }); }\n        catch (error) { if (!isNotFound(error)) throw error; }\n      },\n      runCommand: run,\n      streamCommand: run,\n      getInfo: async sandbox => {\n        const info = (await sandbox.api.get({ sandboxId: sandbox.id })).sandbox;\n        return {\n          id: info.id, provider: 'boat',\n          status: ['error', 'cancelled'].includes(info.state) ? 'error' : ['archived', 'archiving'].includes(info.state) ? 'stopped' : 'running',\n          createdAt: info.createdAt ?? new Date(0),\n          timeout: info.ttlSeconds == null ? 0 : info.ttlSeconds * 1000,\n          metadata: { name: info.name, state: info.state, type: info.type, ip: info.ip, environment: info.environment, archiveAfter: info.archiveAfter },\n        };\n      },\n      getUrl: getBoatUrl,\n      filesystem: {\n        readFile: async (sandbox, path) => Buffer.from(await readBoatFile(sandbox, path)).toString('utf8'),\n        writeFile: writeBoatFile,\n        mkdir: async (sandbox, path) => { await checked(sandbox, `mkdir -p -- \"${escapeShellArg(path)}\"`); },\n        readdir: async (sandbox, path): Promise<FileEntry[]> => {\n          const script = 'import os,json,sys; p=sys.argv[1]; print(json.dumps([dict(name=e.name,type=\"directory\" if e.is_dir() else \"file\",size=e.stat(follow_symlinks=False).st_size,modified=e.stat(follow_symlinks=False).st_mtime) for e in os.scandir(p)]))';\n          const entries: Array<Omit<FileEntry, 'modified'> & { modified: number }> = JSON.parse(await checked(sandbox, `python3 -c \"${escapeShellArg(script)}\" \"${escapeShellArg(path)}\"`));\n          return entries.map(entry => ({ ...entry, modified: new Date(entry.modified * 1000) }));\n        },\n        exists: async (sandbox, path) => {\n          const result = await run(sandbox, `test -e \"${escapeShellArg(path)}\"`);\n          if (result.exitCode > 1) throw new Error(`Boat filesystem exists failed: ${result.stderr}`);\n          return result.exitCode === 0;\n        },\n        remove: async (sandbox, path) => { await checked(sandbox, `rm -rf -- \"${escapeShellArg(path)}\"`); },\n      },\n      getInstance: sandbox => sandbox,\n    },\n    snapshot: {\n      create: (config, sandboxId, options) => saveSnapshot(client(config), config, sandboxId, options),\n      list: (config, options) => listSnapshots(client(config), options),\n      delete: async (config, name) => {\n        try { await client(config).deleteNamedSnapshot({ name }); }\n        catch (error) { if (!isNotFound(error)) throw error; }\n      },\n    },\n    template: {\n      create: async (config, baseOptions) => {\n        const options = baseOptions as BoatCreateTemplateOptions;\n        if (!options.sandboxId) throw new Error('Boat template creation requires sandboxId.');\n        if (options.description !== undefined) throw new Error('Boat named templates do not support descriptions.');\n        return templateInfo(await saveSnapshot(client(config), config, options.sandboxId, options));\n      },\n      list: async (config, options) => (await listSnapshots(client(config), options)).map(templateInfo),\n      delete: async (config, name) => {\n        try { await client(config).deleteNamedSnapshot({ name }); }\n        catch (error) { if (!isNotFound(error)) throw error; }\n      },\n    },\n  },\n});\n\nexport function boat(config: BoatConfig = {}): BoatProvider {\n  const provider = createBoatProvider(config);\n  return { ...provider, snapshot: provider.snapshot!, template: provider.template! };\n}\n\nexport { readBoatFile, writeBoatFile } from './files';\nexport type { BoatSnapshot, BoatTemplate } from './snapshots';\nexport type { CreateSandboxRequest as BoatCreateOptions } from '@boatdev/sdk';\n","import { runCommand as runBoatCommand } from '@boatdev/sdk';\nimport { escapeShellArg } from '@computesdk/provider';\nimport type { CommandResult, RunCommandOptions } from 'computesdk';\nimport type { BoatSandbox } from './index';\n\n\nfunction commandText(command: string, options?: RunCommandOptions): string {\n  let text = command;\n  if (options?.env && Object.keys(options.env).length > 0) {\n    const env = Object.entries(options.env).map(([key, value]) => {\n      if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) throw new Error(`Invalid environment variable name: ${key}`);\n      return `\"${escapeShellArg(`${key}=${value}`)}\"`;\n    }).join(' ');\n    // Absolute path: env resolves its command with the caller's PATH, which may have no shell.\n    text = `env ${env} /bin/sh -c \"${escapeShellArg(command)}\"`;\n  }\n  // Exit on a failed cd so no statement of a multi-statement command runs elsewhere.\n  return options?.cwd ? `cd -- \"${escapeShellArg(options.cwd)}\" || exit\\n${text}` : text;\n}\n\n/** Stream every foreground command to avoid synchronous output limits. */\nexport async function run(sandbox: BoatSandbox, command: string, options?: RunCommandOptions): Promise<CommandResult> {\n  const start = Date.now();\n  const text = commandText(command, options);\n  if (options?.timeout !== undefined && (!Number.isFinite(options.timeout) || options.timeout < 0)) {\n    throw new Error('Boat command timeout must be non-negative milliseconds; 0 means unlimited.');\n  }\n  if (options?.background) {\n    await sandbox.api.command({ sandboxId: sandbox.id, commandRequest: { command: text, detached: true } });\n    return { stdout: '', stderr: '', exitCode: 0, durationMs: Date.now() - start };\n  }\n  const controller = new AbortController();\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let processId: number | undefined;\n  let timedOut = false;\n  let stdout = '';\n  let stderr = '';\n  const result = (exitCode: number) => ({ stdout, stderr, exitCode, durationMs: Date.now() - start });\n  try {\n    for await (const frame of runBoatCommand(sandbox.api, sandbox.id, text, { signal: controller.signal })) {\n      if (frame.type === 'started') {\n        if (typeof frame.processId !== 'number') throw new Error('Boat did not return a process ID.');\n        processId = frame.processId;\n        if (options?.timeout) {\n          const deadline = Date.now() + options.timeout;\n          const expire = () => {\n            const remaining = deadline - Date.now();\n            if (remaining <= 0) { timedOut = true; controller.abort(); }\n            else timer = setTimeout(expire, Math.min(remaining, 2_147_483_647));\n          };\n          expire();\n        }\n      }\n      if (frame.type === 'stdout') { stdout += frame.data ?? ''; options?.onStdout?.(frame.data ?? ''); }\n      if (frame.type === 'stderr') { stderr += frame.data ?? ''; options?.onStderr?.(frame.data ?? ''); }\n      if (frame.type === 'error') throw new Error(frame.message || frame.error || 'Boat command stream failed.');\n      if (frame.type === 'exit' && !timedOut) return result(frame.timedOut ? 124 : frame.exitCode ?? 1);\n    }\n    throw new Error('Boat command stream ended without an exit frame.');\n  } catch (error) {\n    // A deadline passing during cleanup must not turn this failure into a timeout result.\n    clearTimeout(timer);\n    // Detached commands survive a lost stream; do not orphan a failed or timed-out foreground job.\n    if (processId !== undefined) {\n      try { await sandbox.api.stopCommand({ sandboxId: sandbox.id, processId }); }\n      catch (cleanupError) {\n        if ((cleanupError as { response?: { status?: number } })?.response?.status !== 404) {\n          const reason = timedOut ? 'timeout' : `stream failure (${error instanceof Error ? error.message : String(error)})`;\n          throw new Error(`Failed to stop Boat process ${processId} after ${reason}: ${String(cleanupError)}`);\n        }\n      }\n    }\n    if (timedOut) return result(124);\n    throw error;\n  } finally {\n    clearTimeout(timer);\n  }\n}\n\nexport async function checked(sandbox: BoatSandbox, command: string): Promise<string> {\n  const result = await run(sandbox, command);\n  if (result.exitCode !== 0) throw new Error(`Boat filesystem operation failed: ${result.stderr || result.stdout || `exit ${result.exitCode}`}`);\n  return result.stdout;\n}\n","import { posix } from 'node:path';\nimport type { BoatSandbox } from './index';\nimport { escapeShellArg } from '@computesdk/provider';\nimport { checked } from './commands';\n\nfunction signedPath(path: string): boolean {\n  const absolute = posix.resolve('/home/user', path);\n  return absolute.startsWith('/home/user/') || absolute.startsWith('/tmp/');\n}\n\n/** Binary download. Signed URLs support files under /home/user and /tmp. */\nexport async function readBoatFile(sandbox: BoatSandbox, path: string): Promise<Uint8Array> {\n  if (!signedPath(path)) {\n    return new Uint8Array(Buffer.from(await checked(sandbox, `base64 < \"${escapeShellArg(path)}\"`), 'base64'));\n  }\n  const signed = await sandbox.api.createDownloadUrl({ sandboxId: sandbox.id, fileUrlRequest: { path } });\n  const response = await fetch(signed.url);\n  // Do not include the signed URL in errors or send the account bearer token to it.\n  if (!response.ok) throw new Error(`Boat file download failed (HTTP ${response.status}).`);\n  return new Uint8Array(await response.arrayBuffer());\n}\n\n/** Binary or UTF-8 upload, without embedding the file in a command argument. */\nexport async function writeBoatFile(sandbox: BoatSandbox, path: string, content: string | Uint8Array): Promise<void> {\n  if (!signedPath(path)) {\n    // The signed API confines paths. Preserve shell access elsewhere with bounded command payloads.\n    const encoded = Buffer.from(content).toString('base64');\n    await checked(sandbox, `: > \"${escapeShellArg(path)}\"`);\n    for (let offset = 0; offset < encoded.length; offset += 48 * 1024) {\n      await checked(sandbox, `printf %s \"${encoded.slice(offset, offset + 48 * 1024)}\" | base64 -d >> \"${escapeShellArg(path)}\"`);\n    }\n    return;\n  }\n  const signed = await sandbox.api.createUploadUrl({ sandboxId: sandbox.id, fileUrlRequest: { path } });\n  const response = await fetch(signed.url, { method: signed.method, body: Buffer.from(content) });\n  if (!response.ok) throw new Error(`Boat file upload failed (HTTP ${response.status}).`);\n  await response.body?.cancel();\n}\n","import { randomUUID } from 'node:crypto';\nimport type { BoatApi, NamedSnapshot } from '@boatdev/sdk';\nimport type { CreateSnapshotOptions, ListSnapshotsOptions } from '@computesdk/provider';\nimport type { BoatConfig } from './index';\n\nexport interface BoatSnapshot extends NamedSnapshot {\n  /** Reusable snapshot name; the native snapshotId is a different, non-bootable artifact ID. */\n  id: string;\n  provider: 'boat';\n}\nexport interface BoatTemplate extends BoatSnapshot { templateId: string }\n\nexport function snapshotInfo(snapshot: NamedSnapshot): BoatSnapshot {\n  return { ...snapshot, id: snapshot.name, provider: 'boat' };\n}\nexport function templateInfo(snapshot: BoatSnapshot): BoatTemplate {\n  return { ...snapshot, templateId: snapshot.name };\n}\n\nexport async function saveSnapshot(api: BoatApi, config: BoatConfig, sandboxId: string, options?: CreateSnapshotOptions): Promise<BoatSnapshot> {\n  if (options?.metadata !== undefined) throw new Error('Boat named snapshots do not support arbitrary metadata.');\n  const name = options?.name ?? `compute-${randomUUID()}`;\n  if (!/^[a-z0-9][a-z0-9-]{0,62}$/.test(name) || ['latest', 'tree', 'pull', 'rm', 'save', 'current', 'self', 'new'].includes(name)) {\n    throw new Error('Boat snapshot names must be 1-63 lowercase letters, digits, or dashes, start with a letter or digit, and not be reserved.');\n  }\n  const timeout = config.snapshotTimeout ?? 600_000;\n  if (!Number.isFinite(timeout) || timeout <= 0) throw new Error('Boat snapshotTimeout must be positive milliseconds.');\n  const deadline = Date.now() + timeout;\n  let snapshot = (await api.saveNamedSnapshot({ namedSnapshotSaveRequest: { sandboxId, name } })).snapshot;\n  while (snapshot.status !== 'ready') {\n    if (snapshot.status === 'failed') throw new Error(`Boat snapshot ${name} failed: ${snapshot.error ?? 'unknown error'}`);\n    if (Date.now() >= deadline) throw new Error(`Timed out waiting for Boat snapshot ${name}; inspect or delete it through the snapshot manager.`);\n    await new Promise(resolve => setTimeout(resolve, Math.min(2000, Math.max(0, deadline - Date.now()))));\n    snapshot = (await api.getNamedSnapshot({ name })).snapshot;\n  }\n  return snapshotInfo(snapshot);\n}\n\nexport function limitItems<T>(items: T[], limit?: number): T[] {\n  if (limit !== undefined && (!Number.isInteger(limit) || limit < 0)) throw new Error('Boat list limit must be a non-negative integer.');\n  return limit === undefined ? items : items.slice(0, limit);\n}\n\nexport async function listSnapshots(api: BoatApi, options?: ListSnapshotsOptions): Promise<BoatSnapshot[]> {\n  limitItems([], options?.limit);\n  if (options?.limit === 0) return [];\n  const sandboxId = options?.instanceId ?? options?.sandboxId;\n  return limitItems((await api.listNamedSnapshots()).snapshots\n    .filter(snapshot => sandboxId === undefined || snapshot.sourceSandboxId === sandboxId)\n    .map(snapshotInfo), options?.limit);\n}\n"],"mappings":"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","names":["import_sdk","import_provider","runBoatCommand","import_provider"]}

package/dist/index.mjs

@@ -0,0 +1,366 @@
+// src/index.ts
+import { BoatApi, Configuration, ResponseError } from "@boatdev/sdk";
+import { defineProvider, escapeShellArg as escapeShellArg3 } from "@computesdk/provider";
+
+// src/commands.ts
+import { runCommand as runBoatCommand } from "@boatdev/sdk";
+import { escapeShellArg } from "@computesdk/provider";
+function commandText(command, options) {
+  let text = command;
+  if (options?.env && Object.keys(options.env).length > 0) {
+    const env = Object.entries(options.env).map(([key, value]) => {
+      if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) throw new Error(`Invalid environment variable name: ${key}`);
+      return `"${escapeShellArg(`${key}=${value}`)}"`;
+    }).join(" ");
+    text = `env ${env} /bin/sh -c "${escapeShellArg(command)}"`;
+  }
+  return options?.cwd ? `cd -- "${escapeShellArg(options.cwd)}" || exit
+${text}` : text;
+}
+async function run(sandbox, command, options) {
+  const start = Date.now();
+  const text = commandText(command, options);
+  if (options?.timeout !== void 0 && (!Number.isFinite(options.timeout) || options.timeout < 0)) {
+    throw new Error("Boat command timeout must be non-negative milliseconds; 0 means unlimited.");
+  }
+  if (options?.background) {
+    await sandbox.api.command({ sandboxId: sandbox.id, commandRequest: { command: text, detached: true } });
+    return { stdout: "", stderr: "", exitCode: 0, durationMs: Date.now() - start };
+  }
+  const controller = new AbortController();
+  let timer;
+  let processId;
+  let timedOut = false;
+  let stdout = "";
+  let stderr = "";
+  const result = (exitCode) => ({ stdout, stderr, exitCode, durationMs: Date.now() - start });
+  try {
+    for await (const frame of runBoatCommand(sandbox.api, sandbox.id, text, { signal: controller.signal })) {
+      if (frame.type === "started") {
+        if (typeof frame.processId !== "number") throw new Error("Boat did not return a process ID.");
+        processId = frame.processId;
+        if (options?.timeout) {
+          const deadline = Date.now() + options.timeout;
+          const expire = () => {
+            const remaining = deadline - Date.now();
+            if (remaining <= 0) {
+              timedOut = true;
+              controller.abort();
+            } else timer = setTimeout(expire, Math.min(remaining, 2147483647));
+          };
+          expire();
+        }
+      }
+      if (frame.type === "stdout") {
+        stdout += frame.data ?? "";
+        options?.onStdout?.(frame.data ?? "");
+      }
+      if (frame.type === "stderr") {
+        stderr += frame.data ?? "";
+        options?.onStderr?.(frame.data ?? "");
+      }
+      if (frame.type === "error") throw new Error(frame.message || frame.error || "Boat command stream failed.");
+      if (frame.type === "exit" && !timedOut) return result(frame.timedOut ? 124 : frame.exitCode ?? 1);
+    }
+    throw new Error("Boat command stream ended without an exit frame.");
+  } catch (error) {
+    clearTimeout(timer);
+    if (processId !== void 0) {
+      try {
+        await sandbox.api.stopCommand({ sandboxId: sandbox.id, processId });
+      } catch (cleanupError) {
+        if (cleanupError?.response?.status !== 404) {
+          const reason = timedOut ? "timeout" : `stream failure (${error instanceof Error ? error.message : String(error)})`;
+          throw new Error(`Failed to stop Boat process ${processId} after ${reason}: ${String(cleanupError)}`);
+        }
+      }
+    }
+    if (timedOut) return result(124);
+    throw error;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function checked(sandbox, command) {
+  const result = await run(sandbox, command);
+  if (result.exitCode !== 0) throw new Error(`Boat filesystem operation failed: ${result.stderr || result.stdout || `exit ${result.exitCode}`}`);
+  return result.stdout;
+}
+
+// src/files.ts
+import { posix } from "path";
+import { escapeShellArg as escapeShellArg2 } from "@computesdk/provider";
+function signedPath(path) {
+  const absolute = posix.resolve("/home/user", path);
+  return absolute.startsWith("/home/user/") || absolute.startsWith("/tmp/");
+}
+async function readBoatFile(sandbox, path) {
+  if (!signedPath(path)) {
+    return new Uint8Array(Buffer.from(await checked(sandbox, `base64 < "${escapeShellArg2(path)}"`), "base64"));
+  }
+  const signed = await sandbox.api.createDownloadUrl({ sandboxId: sandbox.id, fileUrlRequest: { path } });
+  const response = await fetch(signed.url);
+  if (!response.ok) throw new Error(`Boat file download failed (HTTP ${response.status}).`);
+  return new Uint8Array(await response.arrayBuffer());
+}
+async function writeBoatFile(sandbox, path, content) {
+  if (!signedPath(path)) {
+    const encoded = Buffer.from(content).toString("base64");
+    await checked(sandbox, `: > "${escapeShellArg2(path)}"`);
+    for (let offset = 0; offset < encoded.length; offset += 48 * 1024) {
+      await checked(sandbox, `printf %s "${encoded.slice(offset, offset + 48 * 1024)}" | base64 -d >> "${escapeShellArg2(path)}"`);
+    }
+    return;
+  }
+  const signed = await sandbox.api.createUploadUrl({ sandboxId: sandbox.id, fileUrlRequest: { path } });
+  const response = await fetch(signed.url, { method: signed.method, body: Buffer.from(content) });
+  if (!response.ok) throw new Error(`Boat file upload failed (HTTP ${response.status}).`);
+  await response.body?.cancel();
+}
+
+// src/snapshots.ts
+import { randomUUID } from "crypto";
+function snapshotInfo(snapshot) {
+  return { ...snapshot, id: snapshot.name, provider: "boat" };
+}
+function templateInfo(snapshot) {
+  return { ...snapshot, templateId: snapshot.name };
+}
+async function saveSnapshot(api, config, sandboxId, options) {
+  if (options?.metadata !== void 0) throw new Error("Boat named snapshots do not support arbitrary metadata.");
+  const name = options?.name ?? `compute-${randomUUID()}`;
+  if (!/^[a-z0-9][a-z0-9-]{0,62}$/.test(name) || ["latest", "tree", "pull", "rm", "save", "current", "self", "new"].includes(name)) {
+    throw new Error("Boat snapshot names must be 1-63 lowercase letters, digits, or dashes, start with a letter or digit, and not be reserved.");
+  }
+  const timeout = config.snapshotTimeout ?? 6e5;
+  if (!Number.isFinite(timeout) || timeout <= 0) throw new Error("Boat snapshotTimeout must be positive milliseconds.");
+  const deadline = Date.now() + timeout;
+  let snapshot = (await api.saveNamedSnapshot({ namedSnapshotSaveRequest: { sandboxId, name } })).snapshot;
+  while (snapshot.status !== "ready") {
+    if (snapshot.status === "failed") throw new Error(`Boat snapshot ${name} failed: ${snapshot.error ?? "unknown error"}`);
+    if (Date.now() >= deadline) throw new Error(`Timed out waiting for Boat snapshot ${name}; inspect or delete it through the snapshot manager.`);
+    await new Promise((resolve) => setTimeout(resolve, Math.min(2e3, Math.max(0, deadline - Date.now()))));
+    snapshot = (await api.getNamedSnapshot({ name })).snapshot;
+  }
+  return snapshotInfo(snapshot);
+}
+function limitItems(items, limit) {
+  if (limit !== void 0 && (!Number.isInteger(limit) || limit < 0)) throw new Error("Boat list limit must be a non-negative integer.");
+  return limit === void 0 ? items : items.slice(0, limit);
+}
+async function listSnapshots(api, options) {
+  limitItems([], options?.limit);
+  if (options?.limit === 0) return [];
+  const sandboxId = options?.instanceId ?? options?.sandboxId;
+  return limitItems((await api.listNamedSnapshots()).snapshots.filter((snapshot) => sandboxId === void 0 || snapshot.sourceSandboxId === sandboxId).map(snapshotInfo), options?.limit);
+}
+
+// src/index.ts
+var BoatClient = class extends BoatApi {
+  async request(context, initOverrides) {
+    try {
+      return await super.request(context, initOverrides);
+    } catch (error) {
+      if (!(error instanceof ResponseError)) throw error;
+      const { response } = error;
+      const text = (await response.clone().text().catch(() => "")).replace(/\s+/g, " ").trim();
+      let detail = text.slice(0, 300);
+      try {
+        const body = JSON.parse(text);
+        const parts = [body.error, body.message].filter((part) => typeof part === "string" && part !== "");
+        if (parts.length > 0) detail = parts.join(": ").slice(0, 300);
+      } catch {
+      }
+      throw new ResponseError(response, `Boat API error: ${response.status} ${response.statusText}${detail ? `: ${detail}` : ""}`);
+    }
+  }
+};
+function client(config) {
+  const apiKey = config.apiKey || process.env.BOAT_API_KEY;
+  if (!apiKey) throw new Error("Missing Boat API key. Provide 'apiKey' or set BOAT_API_KEY. Create a key at https://boat.dev/dashboard?tab=api-keys");
+  return new BoatClient(new Configuration({
+    accessToken: apiKey,
+    basePath: config.baseURL || process.env.BOAT_API_BASE || "https://boat.dev/api/v1"
+  }));
+}
+function seconds(ms) {
+  if (!Number.isFinite(ms) || ms <= 0) throw new Error("Boat timeout must be a positive number of milliseconds.");
+  return Math.ceil(ms / 1e3);
+}
+function isNotFound(error) {
+  return error?.response?.status === 404;
+}
+async function waitUntilReady(api, sandboxId, timeoutMs, signal) {
+  const deadline = timeoutMs === 0 ? Number.POSITIVE_INFINITY : Date.now() + timeoutMs;
+  for (; ; ) {
+    if (signal?.aborted) throw signal.reason ?? new Error("Boat creation aborted.");
+    const { state } = (await api.get({ sandboxId })).sandbox;
+    if (["ready", "idle", "running"].includes(state)) return;
+    if (["archived", "archiving", "error", "cancelled"].includes(state)) throw new Error(`Boat sandbox ${sandboxId} entered terminal state ${state}.`);
+    if (Date.now() >= deadline) throw new Error(`Timed out waiting for Boat sandbox ${sandboxId} to become ready.`);
+    await new Promise((resolve) => setTimeout(resolve, Math.min(2e3, deadline - Date.now())));
+  }
+}
+function wrap(api, sandbox, preview) {
+  return { instance: { api, id: sandbox.id, name: sandbox.name, ...preview ? { preview } : {} }, instanceId: sandbox.id };
+}
+async function getBoatUrl(sandbox, options) {
+  if (options.protocol && options.protocol !== "https") throw new Error("Boat preview URLs support HTTPS only.");
+  const settings = { ...sandbox.preview, ...options };
+  const hostPortRequest = {
+    port: settings.port,
+    ...settings.public === void 0 ? {} : { _public: settings.public },
+    ...settings.localhost === void 0 ? {} : { localhost: settings.localhost },
+    ...settings.title === void 0 ? {} : { title: settings.title }
+  };
+  const result = await sandbox.api.hostPort({ sandboxId: sandbox.id, hostPortRequest });
+  if (!result.url) throw new Error("Boat did not return a preview URL.");
+  return result.url;
+}
+var createBoatProvider = defineProvider({
+  name: "boat",
+  methods: {
+    instances: {
+      create: async (config, options) => {
+        if (options?.templateId && options?.snapshotId) throw new Error("Specify either templateId or snapshotId, not both.");
+        if (options?.metadata !== void 0) throw new Error("Boat does not support arbitrary instance metadata.");
+        for (const key of ["cpu", "cpuLimit", "cpus", "vcpus", "memory", "memoryMiB", "memMiB", "memoryMb", "diskMiB", "diskMb", "diskSize", "resources", "launch_parameters", "deploymentPlan", "size", "vmTier", "gpu", "image", "region", "architecture"]) {
+          if (options?.[key] !== void 0) throw new Error(`Boat does not support ${key}; select a fixed machine type with type.`);
+        }
+        const api = client(config);
+        const lifetime = options?.timeout ?? (options?.ttlSeconds === void 0 ? config.timeout : void 0);
+        const defaults = config.createOptions;
+        const request = {
+          ...defaults,
+          type: options?.type ?? defaults?.type,
+          environment: options?.environment ?? defaults?.environment,
+          noEnv: options?.noEnv ?? defaults?.noEnv,
+          snapshots: options?.snapshots ?? defaults?.snapshots,
+          monitoring: options?.monitoring ?? defaults?.monitoring,
+          failFast: options?.failFast ?? defaults?.failFast,
+          setupScript: options?.setupScript ?? defaults?.setupScript,
+          org: options?.org ?? options?.teamId ?? defaults?.org,
+          from: options?.snapshotId ?? options?.templateId ?? options?.from ?? defaults?.from,
+          env: options?.envs ?? options?.env ?? defaults?.env,
+          ttlSeconds: lifetime === void 0 ? options?.ttlSeconds === void 0 ? defaults?.ttlSeconds : options.ttlSeconds : seconds(lifetime)
+        };
+        if (options?.signal?.aborted) throw options.signal.reason ?? new Error("Boat creation aborted.");
+        const { sandbox } = await api.create({ createSandboxRequest: request });
+        try {
+          await waitUntilReady(api, sandbox.id, config.readyTimeout ?? 3e5, options?.signal);
+          if (options?.signal?.aborted) throw options.signal.reason ?? new Error("Boat creation aborted.");
+          if (options?.name) await api.update({ sandboxId: sandbox.id, updateSandboxRequest: { name: options.name } });
+          return wrap(api, options?.name ? { ...sandbox, name: options.name } : sandbox, config.preview);
+        } catch (error) {
+          try {
+            await api.deleteSandbox({ sandboxId: sandbox.id, xAsciiConfirmDelete: sandbox.id });
+          } catch (cleanupError) {
+            if (isNotFound(cleanupError)) throw error;
+            throw new Error(`Boat creation failed (${String(error)}); cleanup of ${sandbox.id} also failed: ${String(cleanupError)}`);
+          }
+          throw error;
+        }
+      },
+      getById: async (config, sandboxId) => {
+        const api = client(config);
+        try {
+          return wrap(api, (await api.get({ sandboxId })).sandbox, config.preview);
+        } catch (error) {
+          if (isNotFound(error)) return null;
+          throw error;
+        }
+      },
+      list: async (config) => {
+        const api = client(config);
+        const items = [];
+        let cursor;
+        do {
+          const page = await api.sandboxes({ cursor });
+          items.push(...page.sandboxes.filter((s) => ["ready", "idle", "running"].includes(s.state)).map((s) => wrap(api, s, config.preview)));
+          cursor = page.pageInfo?.hasMore ? page.pageInfo.nextCursor ?? void 0 : void 0;
+        } while (cursor);
+        return items;
+      },
+      destroy: async (config, sandboxId) => {
+        try {
+          await client(config).deleteSandbox({ sandboxId, xAsciiConfirmDelete: sandboxId });
+        } catch (error) {
+          if (!isNotFound(error)) throw error;
+        }
+      },
+      runCommand: run,
+      streamCommand: run,
+      getInfo: async (sandbox) => {
+        const info = (await sandbox.api.get({ sandboxId: sandbox.id })).sandbox;
+        return {
+          id: info.id,
+          provider: "boat",
+          status: ["error", "cancelled"].includes(info.state) ? "error" : ["archived", "archiving"].includes(info.state) ? "stopped" : "running",
+          createdAt: info.createdAt ?? /* @__PURE__ */ new Date(0),
+          timeout: info.ttlSeconds == null ? 0 : info.ttlSeconds * 1e3,
+          metadata: { name: info.name, state: info.state, type: info.type, ip: info.ip, environment: info.environment, archiveAfter: info.archiveAfter }
+        };
+      },
+      getUrl: getBoatUrl,
+      filesystem: {
+        readFile: async (sandbox, path) => Buffer.from(await readBoatFile(sandbox, path)).toString("utf8"),
+        writeFile: writeBoatFile,
+        mkdir: async (sandbox, path) => {
+          await checked(sandbox, `mkdir -p -- "${escapeShellArg3(path)}"`);
+        },
+        readdir: async (sandbox, path) => {
+          const script = 'import os,json,sys; p=sys.argv[1]; print(json.dumps([dict(name=e.name,type="directory" if e.is_dir() else "file",size=e.stat(follow_symlinks=False).st_size,modified=e.stat(follow_symlinks=False).st_mtime) for e in os.scandir(p)]))';
+          const entries = JSON.parse(await checked(sandbox, `python3 -c "${escapeShellArg3(script)}" "${escapeShellArg3(path)}"`));
+          return entries.map((entry) => ({ ...entry, modified: new Date(entry.modified * 1e3) }));
+        },
+        exists: async (sandbox, path) => {
+          const result = await run(sandbox, `test -e "${escapeShellArg3(path)}"`);
+          if (result.exitCode > 1) throw new Error(`Boat filesystem exists failed: ${result.stderr}`);
+          return result.exitCode === 0;
+        },
+        remove: async (sandbox, path) => {
+          await checked(sandbox, `rm -rf -- "${escapeShellArg3(path)}"`);
+        }
+      },
+      getInstance: (sandbox) => sandbox
+    },
+    snapshot: {
+      create: (config, sandboxId, options) => saveSnapshot(client(config), config, sandboxId, options),
+      list: (config, options) => listSnapshots(client(config), options),
+      delete: async (config, name) => {
+        try {
+          await client(config).deleteNamedSnapshot({ name });
+        } catch (error) {
+          if (!isNotFound(error)) throw error;
+        }
+      }
+    },
+    template: {
+      create: async (config, baseOptions) => {
+        const options = baseOptions;
+        if (!options.sandboxId) throw new Error("Boat template creation requires sandboxId.");
+        if (options.description !== void 0) throw new Error("Boat named templates do not support descriptions.");
+        return templateInfo(await saveSnapshot(client(config), config, options.sandboxId, options));
+      },
+      list: async (config, options) => (await listSnapshots(client(config), options)).map(templateInfo),
+      delete: async (config, name) => {
+        try {
+          await client(config).deleteNamedSnapshot({ name });
+        } catch (error) {
+          if (!isNotFound(error)) throw error;
+        }
+      }
+    }
+  }
+});
+function boat(config = {}) {
+  const provider = createBoatProvider(config);
+  return { ...provider, snapshot: provider.snapshot, template: provider.template };
+}
+export {
+  boat,
+  getBoatUrl,
+  readBoatFile,
+  writeBoatFile
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/commands.ts","../src/files.ts","../src/snapshots.ts"],"sourcesContent":["import { BoatApi, Configuration, ResponseError } from '@boatdev/sdk';\nimport type { CreateSandboxRequest, InitOverrideFunction, RequestOpts, Sandbox } from '@boatdev/sdk';\nimport { defineProvider, escapeShellArg } from '@computesdk/provider';\nimport type { Provider, ProviderSnapshotManager, ProviderTemplateManager, CreateTemplateOptions } from '@computesdk/provider';\nimport { checked, run } from './commands';\nimport { readBoatFile, writeBoatFile } from './files';\nimport { saveSnapshot, listSnapshots, templateInfo } from './snapshots';\nimport type { BoatSnapshot, BoatTemplate } from './snapshots';\nimport type { FileEntry } from 'computesdk';\n\nexport interface BoatConfig {\n  /** Falls back to BOAT_API_KEY. */\n  apiKey?: string;\n  /** Falls back to BOAT_API_BASE, then https://boat.dev/api/v1. */\n  baseURL?: string;\n  /** Default sandbox lifetime in milliseconds. Boat defaults to one hour. */\n  timeout?: number;\n  /** Provisioning deadline in milliseconds (default: 300000). */\n  readyTimeout?: number;\n  /** Native defaults, including type, environment, noEnv, and from. */\n  createOptions?: CreateSandboxRequest;\n  /** Named snapshot save deadline in milliseconds (default: 600000). */\n  snapshotTimeout?: number;\n  /** Default HTTPS preview settings. */\n  preview?: BoatPreviewDefaults;\n}\n\n/** Boat has an account-level client; retain it alongside the sandbox ID. */\nexport interface BoatSandbox {\n  api: BoatApi;\n  id: string;\n  /** Boat's sandbox name, so callers can match list() results without a getInfo() call each. */\n  name: string;\n  preview?: BoatPreviewDefaults;\n}\n\n/**\n * The SDK's errors say only \"Response returned an error code\". Add the status and Boat's\n * error body, and keep an unread `response` for the SDK's retry checks and 404 handling.\n * Overriding request() leaves successful responses, including command streams, untouched.\n */\nclass BoatClient extends BoatApi {\n  protected async request(context: RequestOpts, initOverrides?: RequestInit | InitOverrideFunction): Promise<Response> {\n    try {\n      return await super.request(context, initOverrides);\n    } catch (error) {\n      if (!(error instanceof ResponseError)) throw error;\n      const { response } = error;\n      const text = (await response.clone().text().catch(() => '')).replace(/\\s+/g, ' ').trim();\n      let detail = text.slice(0, 300);\n      try {\n        const body = JSON.parse(text) as { error?: unknown; message?: unknown };\n        const parts = [body.error, body.message].filter((part): part is string => typeof part === 'string' && part !== '');\n        if (parts.length > 0) detail = parts.join(': ').slice(0, 300);\n      } catch { /* Not JSON; keep the raw text. */ }\n      throw new ResponseError(response, `Boat API error: ${response.status} ${response.statusText}${detail ? `: ${detail}` : ''}`);\n    }\n  }\n}\n\nfunction client(config: BoatConfig): BoatApi {\n  const apiKey = config.apiKey || process.env.BOAT_API_KEY;\n  if (!apiKey) throw new Error(\"Missing Boat API key. Provide 'apiKey' or set BOAT_API_KEY. Create a key at https://boat.dev/dashboard?tab=api-keys\");\n  return new BoatClient(new Configuration({\n    accessToken: apiKey,\n    basePath: config.baseURL || process.env.BOAT_API_BASE || 'https://boat.dev/api/v1',\n  }));\n}\n\nfunction seconds(ms: number): number {\n  if (!Number.isFinite(ms) || ms <= 0) throw new Error('Boat timeout must be a positive number of milliseconds.');\n  return Math.ceil(ms / 1000);\n}\n\nfunction isNotFound(error: unknown): boolean {\n  return (error as { response?: { status?: number } })?.response?.status === 404;\n}\n\n/** Unlike the SDK's waitUntilReady, stop on cancelled sandboxes and honour the abort signal. */\nasync function waitUntilReady(api: BoatApi, sandboxId: string, timeoutMs: number, signal?: AbortSignal): Promise<void> {\n  const deadline = timeoutMs === 0 ? Number.POSITIVE_INFINITY : Date.now() + timeoutMs;\n  for (;;) {\n    if (signal?.aborted) throw signal.reason ?? new Error('Boat creation aborted.');\n    const { state } = (await api.get({ sandboxId })).sandbox;\n    if (['ready', 'idle', 'running'].includes(state)) return;\n    if (['archived', 'archiving', 'error', 'cancelled'].includes(state)) throw new Error(`Boat sandbox ${sandboxId} entered terminal state ${state}.`);\n    if (Date.now() >= deadline) throw new Error(`Timed out waiting for Boat sandbox ${sandboxId} to become ready.`);\n    await new Promise(resolve => setTimeout(resolve, Math.min(2000, deadline - Date.now())));\n  }\n}\n\nfunction wrap(api: BoatApi, sandbox: Sandbox, preview?: BoatPreviewDefaults) {\n  return { instance: { api, id: sandbox.id, name: sandbox.name, ...(preview ? { preview } : {}) }, instanceId: sandbox.id };\n}\n\nexport interface BoatPreviewDefaults {\n  public?: boolean;\n  localhost?: boolean;\n  title?: string;\n}\nexport interface BoatPreviewOptions extends BoatPreviewDefaults { port: number; protocol?: string }\n\n/** Typed preview controls beyond the portable getUrl interface. */\nexport async function getBoatUrl(sandbox: BoatSandbox, options: BoatPreviewOptions): Promise<string> {\n  if (options.protocol && options.protocol !== 'https') throw new Error('Boat preview URLs support HTTPS only.');\n  const settings = { ...sandbox.preview, ...options };\n  const hostPortRequest = {\n    port: settings.port,\n    ...(settings.public === undefined ? {} : { _public: settings.public }),\n    ...(settings.localhost === undefined ? {} : { localhost: settings.localhost }),\n    ...(settings.title === undefined ? {} : { title: settings.title }),\n  };\n  const result = await sandbox.api.hostPort({ sandboxId: sandbox.id, hostPortRequest });\n  if (!result.url) throw new Error('Boat did not return a preview URL.');\n  return result.url;\n}\n\nexport interface BoatCreateTemplateOptions extends CreateTemplateOptions {\n  /** Sandbox whose disk to freeze as a reusable named template. */\n  sandboxId: string;\n}\nexport interface BoatProvider extends Provider<BoatSandbox, BoatTemplate, BoatSnapshot> {\n  snapshot: ProviderSnapshotManager<BoatSnapshot>;\n  template: ProviderTemplateManager<BoatTemplate, BoatCreateTemplateOptions>;\n}\n\nconst createBoatProvider = defineProvider<BoatSandbox, BoatConfig, BoatTemplate, BoatSnapshot>({\n  name: 'boat',\n  methods: {\n    instances: {\n      create: async (config, options) => {\n        if (options?.templateId && options?.snapshotId) throw new Error('Specify either templateId or snapshotId, not both.');\n        if (options?.metadata !== undefined) throw new Error('Boat does not support arbitrary instance metadata.');\n        for (const key of ['cpu', 'cpuLimit', 'cpus', 'vcpus', 'memory', 'memoryMiB', 'memMiB', 'memoryMb', 'diskMiB', 'diskMb', 'diskSize', 'resources', 'launch_parameters', 'deploymentPlan', 'size', 'vmTier', 'gpu', 'image', 'region', 'architecture']) {\n          if (options?.[key] !== undefined) throw new Error(`Boat does not support ${key}; select a fixed machine type with type.`);\n        }\n        const api = client(config);\n        const lifetime = options?.timeout ?? (options?.ttlSeconds === undefined ? config.timeout : undefined);\n        const defaults = config.createOptions;\n        const request: CreateSandboxRequest = {\n          ...defaults,\n          type: options?.type ?? defaults?.type,\n          environment: options?.environment ?? defaults?.environment,\n          noEnv: options?.noEnv ?? defaults?.noEnv,\n          snapshots: options?.snapshots ?? defaults?.snapshots,\n          monitoring: options?.monitoring ?? defaults?.monitoring,\n          failFast: options?.failFast ?? defaults?.failFast,\n          setupScript: options?.setupScript ?? defaults?.setupScript,\n          org: options?.org ?? options?.teamId ?? defaults?.org,\n          from: options?.snapshotId ?? options?.templateId ?? options?.from ?? defaults?.from,\n          env: options?.envs ?? options?.env ?? defaults?.env,\n          ttlSeconds: lifetime === undefined ? (options?.ttlSeconds === undefined ? defaults?.ttlSeconds : options.ttlSeconds) : seconds(lifetime),\n        };\n        if (options?.signal?.aborted) throw options.signal.reason ?? new Error('Boat creation aborted.');\n        const { sandbox } = await api.create({ createSandboxRequest: request });\n        try {\n          await waitUntilReady(api, sandbox.id, config.readyTimeout ?? 300_000, options?.signal);\n          if (options?.signal?.aborted) throw options.signal.reason ?? new Error('Boat creation aborted.');\n          if (options?.name) await api.update({ sandboxId: sandbox.id, updateSandboxRequest: { name: options.name } });\n          return wrap(api, options?.name ? { ...sandbox, name: options.name } : sandbox, config.preview);\n        } catch (error) {\n          // A provisioning or rename failure must not leave a billable VM behind.\n          try { await api.deleteSandbox({ sandboxId: sandbox.id, xAsciiConfirmDelete: sandbox.id }); }\n          catch (cleanupError) {\n            // Boat removes cancelled sandboxes itself, so a 404 means there is nothing left to clean up.\n            if (isNotFound(cleanupError)) throw error;\n            throw new Error(`Boat creation failed (${String(error)}); cleanup of ${sandbox.id} also failed: ${String(cleanupError)}`);\n          }\n          throw error;\n        }\n      },\n      getById: async (config, sandboxId) => {\n        const api = client(config);\n        try { return wrap(api, (await api.get({ sandboxId })).sandbox, config.preview); }\n        catch (error) { if (isNotFound(error)) return null; throw error; }\n      },\n      list: async config => {\n        const api = client(config);\n        const items: ReturnType<typeof wrap>[] = [];\n        let cursor: string | undefined;\n        do {\n          const page = await api.sandboxes({ cursor });\n          items.push(...page.sandboxes.filter(s => ['ready', 'idle', 'running'].includes(s.state)).map(s => wrap(api, s, config.preview)));\n          cursor = page.pageInfo?.hasMore ? page.pageInfo.nextCursor ?? undefined : undefined;\n        } while (cursor);\n        return items;\n      },\n      destroy: async (config, sandboxId) => {\n        try { await client(config).deleteSandbox({ sandboxId, xAsciiConfirmDelete: sandboxId }); }\n        catch (error) { if (!isNotFound(error)) throw error; }\n      },\n      runCommand: run,\n      streamCommand: run,\n      getInfo: async sandbox => {\n        const info = (await sandbox.api.get({ sandboxId: sandbox.id })).sandbox;\n        return {\n          id: info.id, provider: 'boat',\n          status: ['error', 'cancelled'].includes(info.state) ? 'error' : ['archived', 'archiving'].includes(info.state) ? 'stopped' : 'running',\n          createdAt: info.createdAt ?? new Date(0),\n          timeout: info.ttlSeconds == null ? 0 : info.ttlSeconds * 1000,\n          metadata: { name: info.name, state: info.state, type: info.type, ip: info.ip, environment: info.environment, archiveAfter: info.archiveAfter },\n        };\n      },\n      getUrl: getBoatUrl,\n      filesystem: {\n        readFile: async (sandbox, path) => Buffer.from(await readBoatFile(sandbox, path)).toString('utf8'),\n        writeFile: writeBoatFile,\n        mkdir: async (sandbox, path) => { await checked(sandbox, `mkdir -p -- \"${escapeShellArg(path)}\"`); },\n        readdir: async (sandbox, path): Promise<FileEntry[]> => {\n          const script = 'import os,json,sys; p=sys.argv[1]; print(json.dumps([dict(name=e.name,type=\"directory\" if e.is_dir() else \"file\",size=e.stat(follow_symlinks=False).st_size,modified=e.stat(follow_symlinks=False).st_mtime) for e in os.scandir(p)]))';\n          const entries: Array<Omit<FileEntry, 'modified'> & { modified: number }> = JSON.parse(await checked(sandbox, `python3 -c \"${escapeShellArg(script)}\" \"${escapeShellArg(path)}\"`));\n          return entries.map(entry => ({ ...entry, modified: new Date(entry.modified * 1000) }));\n        },\n        exists: async (sandbox, path) => {\n          const result = await run(sandbox, `test -e \"${escapeShellArg(path)}\"`);\n          if (result.exitCode > 1) throw new Error(`Boat filesystem exists failed: ${result.stderr}`);\n          return result.exitCode === 0;\n        },\n        remove: async (sandbox, path) => { await checked(sandbox, `rm -rf -- \"${escapeShellArg(path)}\"`); },\n      },\n      getInstance: sandbox => sandbox,\n    },\n    snapshot: {\n      create: (config, sandboxId, options) => saveSnapshot(client(config), config, sandboxId, options),\n      list: (config, options) => listSnapshots(client(config), options),\n      delete: async (config, name) => {\n        try { await client(config).deleteNamedSnapshot({ name }); }\n        catch (error) { if (!isNotFound(error)) throw error; }\n      },\n    },\n    template: {\n      create: async (config, baseOptions) => {\n        const options = baseOptions as BoatCreateTemplateOptions;\n        if (!options.sandboxId) throw new Error('Boat template creation requires sandboxId.');\n        if (options.description !== undefined) throw new Error('Boat named templates do not support descriptions.');\n        return templateInfo(await saveSnapshot(client(config), config, options.sandboxId, options));\n      },\n      list: async (config, options) => (await listSnapshots(client(config), options)).map(templateInfo),\n      delete: async (config, name) => {\n        try { await client(config).deleteNamedSnapshot({ name }); }\n        catch (error) { if (!isNotFound(error)) throw error; }\n      },\n    },\n  },\n});\n\nexport function boat(config: BoatConfig = {}): BoatProvider {\n  const provider = createBoatProvider(config);\n  return { ...provider, snapshot: provider.snapshot!, template: provider.template! };\n}\n\nexport { readBoatFile, writeBoatFile } from './files';\nexport type { BoatSnapshot, BoatTemplate } from './snapshots';\nexport type { CreateSandboxRequest as BoatCreateOptions } from '@boatdev/sdk';\n","import { runCommand as runBoatCommand } from '@boatdev/sdk';\nimport { escapeShellArg } from '@computesdk/provider';\nimport type { CommandResult, RunCommandOptions } from 'computesdk';\nimport type { BoatSandbox } from './index';\n\n\nfunction commandText(command: string, options?: RunCommandOptions): string {\n  let text = command;\n  if (options?.env && Object.keys(options.env).length > 0) {\n    const env = Object.entries(options.env).map(([key, value]) => {\n      if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) throw new Error(`Invalid environment variable name: ${key}`);\n      return `\"${escapeShellArg(`${key}=${value}`)}\"`;\n    }).join(' ');\n    // Absolute path: env resolves its command with the caller's PATH, which may have no shell.\n    text = `env ${env} /bin/sh -c \"${escapeShellArg(command)}\"`;\n  }\n  // Exit on a failed cd so no statement of a multi-statement command runs elsewhere.\n  return options?.cwd ? `cd -- \"${escapeShellArg(options.cwd)}\" || exit\\n${text}` : text;\n}\n\n/** Stream every foreground command to avoid synchronous output limits. */\nexport async function run(sandbox: BoatSandbox, command: string, options?: RunCommandOptions): Promise<CommandResult> {\n  const start = Date.now();\n  const text = commandText(command, options);\n  if (options?.timeout !== undefined && (!Number.isFinite(options.timeout) || options.timeout < 0)) {\n    throw new Error('Boat command timeout must be non-negative milliseconds; 0 means unlimited.');\n  }\n  if (options?.background) {\n    await sandbox.api.command({ sandboxId: sandbox.id, commandRequest: { command: text, detached: true } });\n    return { stdout: '', stderr: '', exitCode: 0, durationMs: Date.now() - start };\n  }\n  const controller = new AbortController();\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let processId: number | undefined;\n  let timedOut = false;\n  let stdout = '';\n  let stderr = '';\n  const result = (exitCode: number) => ({ stdout, stderr, exitCode, durationMs: Date.now() - start });\n  try {\n    for await (const frame of runBoatCommand(sandbox.api, sandbox.id, text, { signal: controller.signal })) {\n      if (frame.type === 'started') {\n        if (typeof frame.processId !== 'number') throw new Error('Boat did not return a process ID.');\n        processId = frame.processId;\n        if (options?.timeout) {\n          const deadline = Date.now() + options.timeout;\n          const expire = () => {\n            const remaining = deadline - Date.now();\n            if (remaining <= 0) { timedOut = true; controller.abort(); }\n            else timer = setTimeout(expire, Math.min(remaining, 2_147_483_647));\n          };\n          expire();\n        }\n      }\n      if (frame.type === 'stdout') { stdout += frame.data ?? ''; options?.onStdout?.(frame.data ?? ''); }\n      if (frame.type === 'stderr') { stderr += frame.data ?? ''; options?.onStderr?.(frame.data ?? ''); }\n      if (frame.type === 'error') throw new Error(frame.message || frame.error || 'Boat command stream failed.');\n      if (frame.type === 'exit' && !timedOut) return result(frame.timedOut ? 124 : frame.exitCode ?? 1);\n    }\n    throw new Error('Boat command stream ended without an exit frame.');\n  } catch (error) {\n    // A deadline passing during cleanup must not turn this failure into a timeout result.\n    clearTimeout(timer);\n    // Detached commands survive a lost stream; do not orphan a failed or timed-out foreground job.\n    if (processId !== undefined) {\n      try { await sandbox.api.stopCommand({ sandboxId: sandbox.id, processId }); }\n      catch (cleanupError) {\n        if ((cleanupError as { response?: { status?: number } })?.response?.status !== 404) {\n          const reason = timedOut ? 'timeout' : `stream failure (${error instanceof Error ? error.message : String(error)})`;\n          throw new Error(`Failed to stop Boat process ${processId} after ${reason}: ${String(cleanupError)}`);\n        }\n      }\n    }\n    if (timedOut) return result(124);\n    throw error;\n  } finally {\n    clearTimeout(timer);\n  }\n}\n\nexport async function checked(sandbox: BoatSandbox, command: string): Promise<string> {\n  const result = await run(sandbox, command);\n  if (result.exitCode !== 0) throw new Error(`Boat filesystem operation failed: ${result.stderr || result.stdout || `exit ${result.exitCode}`}`);\n  return result.stdout;\n}\n","import { posix } from 'node:path';\nimport type { BoatSandbox } from './index';\nimport { escapeShellArg } from '@computesdk/provider';\nimport { checked } from './commands';\n\nfunction signedPath(path: string): boolean {\n  const absolute = posix.resolve('/home/user', path);\n  return absolute.startsWith('/home/user/') || absolute.startsWith('/tmp/');\n}\n\n/** Binary download. Signed URLs support files under /home/user and /tmp. */\nexport async function readBoatFile(sandbox: BoatSandbox, path: string): Promise<Uint8Array> {\n  if (!signedPath(path)) {\n    return new Uint8Array(Buffer.from(await checked(sandbox, `base64 < \"${escapeShellArg(path)}\"`), 'base64'));\n  }\n  const signed = await sandbox.api.createDownloadUrl({ sandboxId: sandbox.id, fileUrlRequest: { path } });\n  const response = await fetch(signed.url);\n  // Do not include the signed URL in errors or send the account bearer token to it.\n  if (!response.ok) throw new Error(`Boat file download failed (HTTP ${response.status}).`);\n  return new Uint8Array(await response.arrayBuffer());\n}\n\n/** Binary or UTF-8 upload, without embedding the file in a command argument. */\nexport async function writeBoatFile(sandbox: BoatSandbox, path: string, content: string | Uint8Array): Promise<void> {\n  if (!signedPath(path)) {\n    // The signed API confines paths. Preserve shell access elsewhere with bounded command payloads.\n    const encoded = Buffer.from(content).toString('base64');\n    await checked(sandbox, `: > \"${escapeShellArg(path)}\"`);\n    for (let offset = 0; offset < encoded.length; offset += 48 * 1024) {\n      await checked(sandbox, `printf %s \"${encoded.slice(offset, offset + 48 * 1024)}\" | base64 -d >> \"${escapeShellArg(path)}\"`);\n    }\n    return;\n  }\n  const signed = await sandbox.api.createUploadUrl({ sandboxId: sandbox.id, fileUrlRequest: { path } });\n  const response = await fetch(signed.url, { method: signed.method, body: Buffer.from(content) });\n  if (!response.ok) throw new Error(`Boat file upload failed (HTTP ${response.status}).`);\n  await response.body?.cancel();\n}\n","import { randomUUID } from 'node:crypto';\nimport type { BoatApi, NamedSnapshot } from '@boatdev/sdk';\nimport type { CreateSnapshotOptions, ListSnapshotsOptions } from '@computesdk/provider';\nimport type { BoatConfig } from './index';\n\nexport interface BoatSnapshot extends NamedSnapshot {\n  /** Reusable snapshot name; the native snapshotId is a different, non-bootable artifact ID. */\n  id: string;\n  provider: 'boat';\n}\nexport interface BoatTemplate extends BoatSnapshot { templateId: string }\n\nexport function snapshotInfo(snapshot: NamedSnapshot): BoatSnapshot {\n  return { ...snapshot, id: snapshot.name, provider: 'boat' };\n}\nexport function templateInfo(snapshot: BoatSnapshot): BoatTemplate {\n  return { ...snapshot, templateId: snapshot.name };\n}\n\nexport async function saveSnapshot(api: BoatApi, config: BoatConfig, sandboxId: string, options?: CreateSnapshotOptions): Promise<BoatSnapshot> {\n  if (options?.metadata !== undefined) throw new Error('Boat named snapshots do not support arbitrary metadata.');\n  const name = options?.name ?? `compute-${randomUUID()}`;\n  if (!/^[a-z0-9][a-z0-9-]{0,62}$/.test(name) || ['latest', 'tree', 'pull', 'rm', 'save', 'current', 'self', 'new'].includes(name)) {\n    throw new Error('Boat snapshot names must be 1-63 lowercase letters, digits, or dashes, start with a letter or digit, and not be reserved.');\n  }\n  const timeout = config.snapshotTimeout ?? 600_000;\n  if (!Number.isFinite(timeout) || timeout <= 0) throw new Error('Boat snapshotTimeout must be positive milliseconds.');\n  const deadline = Date.now() + timeout;\n  let snapshot = (await api.saveNamedSnapshot({ namedSnapshotSaveRequest: { sandboxId, name } })).snapshot;\n  while (snapshot.status !== 'ready') {\n    if (snapshot.status === 'failed') throw new Error(`Boat snapshot ${name} failed: ${snapshot.error ?? 'unknown error'}`);\n    if (Date.now() >= deadline) throw new Error(`Timed out waiting for Boat snapshot ${name}; inspect or delete it through the snapshot manager.`);\n    await new Promise(resolve => setTimeout(resolve, Math.min(2000, Math.max(0, deadline - Date.now()))));\n    snapshot = (await api.getNamedSnapshot({ name })).snapshot;\n  }\n  return snapshotInfo(snapshot);\n}\n\nexport function limitItems<T>(items: T[], limit?: number): T[] {\n  if (limit !== undefined && (!Number.isInteger(limit) || limit < 0)) throw new Error('Boat list limit must be a non-negative integer.');\n  return limit === undefined ? items : items.slice(0, limit);\n}\n\nexport async function listSnapshots(api: BoatApi, options?: ListSnapshotsOptions): Promise<BoatSnapshot[]> {\n  limitItems([], options?.limit);\n  if (options?.limit === 0) return [];\n  const sandboxId = options?.instanceId ?? options?.sandboxId;\n  return limitItems((await api.listNamedSnapshots()).snapshots\n    .filter(snapshot => sandboxId === undefined || snapshot.sourceSandboxId === sandboxId)\n    .map(snapshotInfo), options?.limit);\n}\n"],"mappings":"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","names":["escapeShellArg","escapeShellArg","escapeShellArg","escapeShellArg"]}

package/package.json

@@ -1,6 +1,71 @@
 {
   "name": "@computesdk/boat",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.1",
+  "description": "Boat provider for ComputeSDK - Ubuntu cloud sandboxes with streaming, named snapshots, signed file transfers, and preview URLs",
+  "author": "Dao Hoang Son",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@boatdev/sdk": "^1.9.9",
+    "@computesdk/provider": "2.1.23",
+    "computesdk": "4.1.17"
+  },
+  "keywords": [
+    "computesdk",
+    "boat",
+    "sandbox",
+    "code-execution",
+    "python",
+    "javascript",
+    "cloud",
+    "compute",
+    "provider",
+    "containers"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/computesdk/computesdk.git",
+    "directory": "packages/boat"
+  },
+  "homepage": "https://www.computesdk.com",
+  "bugs": {
+    "url": "https://github.com/computesdk/computesdk/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "eslint": "^8.37.0",
+    "rimraf": "^5.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0",
+    "@computesdk/test-utils": "2.0.6"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:unit": "vitest run src/__tests__/unit.test.ts src/__tests__/transport.test.ts",
+    "test:integration": "vitest run src/__tests__/index.test.ts src/__tests__/crud.test.ts src/__tests__/integration.test.ts",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts"
+  }
 }