@spheron/sandbox 0.0.0-stage → 0.1.0

package/dist/sandbox.js

@@ -0,0 +1,332 @@
+import { Commands } from './commands.js';
+import { NoOfferError, NotFoundError, SandboxFailedError, SpheronApiError, SpheronError, TimeoutError } from './errors.js';
+import { Files } from './files.js';
+import { HttpClient, sleep } from './http.js';
+import { findOffers, pickOperatingSystem } from './offers.js';
+/** Refusals that mean "try the next offer": nothing was created and nothing is billed. */
+const NEXT_OFFER_CODES = new Set(['agent_access_unsupported', 'offer_unavailable']);
+/** A create with this key is still running on the server (the first try timed out on our side): ask again. */
+const CREATE_IN_PROGRESS = 'idempotency_in_progress';
+const CREATE_IN_PROGRESS_RETRY_MS = 5_000;
+const CREATE_IN_PROGRESS_BUDGET_MS = 10 * 60_000;
+/** Start refusals where nothing changed: the provider is still stopping, has no capacity yet, or is busy. Tried again. */
+const START_RETRY_CODES = new Set(['provider_start_failed', 'instance_busy', 'service_unavailable']);
+const START_RETRY_MS = 30_000;
+/** Hibernating a large machine's memory can take well over 4 minutes (seen live on a 1x A6000). */
+const START_RETRY_BUDGET_MS = 10 * 60_000;
+/** Answer Stop and Start with 202 and the operation after this many seconds, instead of a 504 at the server's 75. */
+const LIFECYCLE_PREFER = 'respond-async, wait=60';
+/** How often a running Stop or Start is checked. */
+const OPERATION_CHECK_MS = 5_000;
+/** The server gives a Stop 30 minutes: hibernating a large machine's memory takes long. */
+const STOP_TIMEOUT_MS = 30 * 60_000;
+/** A VM takes a few minutes to boot and install the sandbox. */
+const READY_TIMEOUT_MS = 20 * 60_000;
+/** After a create, the sandbox row can take a moment to be readable. */
+const NOT_FOUND_GRACE_MS = 60_000;
+/** A running instance gets this long for its sandbox to check in (after a boot or a Start) before it counts as broken. */
+const RECONNECT_GRACE_MS = 5 * 60_000;
+/** After a Start the instance can read stopped for a moment before it reads running; that long it counts as starting. */
+const STARTING_GRACE_MS = 3 * 60_000;
+/** Deployment states the instance does not come back from by itself (unless a Start is in flight). */
+const DEAD = new Set(['failed', 'terminated', 'terminated-provider', 'stopped']);
+const isActive = (op) => !!op && (op.status === 'queued' || op.status === 'running');
+function newIdempotencyKey() {
+    const c = globalThis.crypto;
+    if (c?.randomUUID)
+        return c.randomUUID();
+    return `sdk-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}${Math.random().toString(36).slice(2)}`;
+}
+/**
+ * A Spheron Agent GPU Sandbox: a GPU VM you run commands on and move files to and from, over the Spheron API.
+ *
+ * ```ts
+ * const sandbox = await Sandbox.create({ gpu: 'h100', maxHourlyPrice: 3 });
+ * const r = await sandbox.commands.run('nvidia-smi');
+ * console.log(r.output);
+ * await sandbox.terminate();
+ * ```
+ *
+ * The instance bills at its normal hourly price from the moment it runs until it is stopped or terminated.
+ */
+export class Sandbox {
+    /** The deployment id. */
+    id;
+    commands;
+    files;
+    #http;
+    constructor(http, deploymentId, pollIntervalMs) {
+        this.#http = http;
+        this.id = deploymentId;
+        const base = `/api/deployments/${encodeURIComponent(deploymentId)}/agent`;
+        this.commands = new Commands(http, base, pollIntervalMs);
+        this.files = new Files(http, base);
+    }
+    get path() {
+        return `/api/deployments/${encodeURIComponent(this.id)}`;
+    }
+    /** Offers a sandbox can be deployed on, cheapest first. Pass one to Sandbox.create({ offer }). */
+    static async findOffers(filter = {}) {
+        return findOffers(new HttpClient(filter), filter);
+    }
+    /**
+     * Connect to an instance that already has a sandbox (deployed with it on, by this SDK, the API or an AI agent).
+     * Only the person who deployed it can use its sandbox.
+     */
+    static async connect(deploymentId, opts = {}) {
+        const sandbox = new Sandbox(new HttpClient(opts), deploymentId, opts.pollIntervalMs ?? 2000);
+        await sandbox.status();
+        return sandbox;
+    }
+    /**
+     * Deploy a GPU VM with the sandbox on and, by default, wait until commands can run.
+     *
+     * Picks the cheapest offer matching the filter (or deploys `offer`), and moves on to the next one when an offer
+     * is sold out or cannot take the sandbox. Set maxHourlyPrice so a scarce GPU never lands on a pricey offer.
+     * Once an instance exists, any error names it in `deploymentId`: it bills until it is terminated.
+     */
+    static async create(opts = {}) {
+        const http = new HttpClient(opts);
+        // Offers first: a filter nothing matches fails before any account lookup.
+        const candidates = opts.offer ? [opts.offer] : await findOffers(http, opts);
+        if (!candidates.length) {
+            throw new NoOfferError('No GPU offer matches. Loosen the filter (gpu, gpuCount, regions, maxHourlyPrice) or try spot.');
+        }
+        const teamId = opts.teamId ?? (await defaultTeamId(http));
+        const ssh = opts.sshPublicKey ? { ssh_public_key: opts.sshPublicKey } : { sshKeyId: opts.sshKeyId ?? (await defaultSshKeyId(http, teamId)) };
+        const attempts = [];
+        for (const offer of candidates.slice(0, opts.offer ? 1 : Math.max(1, opts.maxOfferAttempts ?? 3))) {
+            const operatingSystem = pickOperatingSystem(offer, opts.operatingSystem);
+            if (!operatingSystem) {
+                attempts.push({ offerId: offer.offerId, provider: offer.provider, reason: `does not offer ${opts.operatingSystem}` });
+                continue;
+            }
+            let created;
+            try {
+                created = await createDeployment(http, {
+                    teamId,
+                    provider: offer.provider,
+                    offerId: offer.offerId,
+                    gpuType: offer.gpuType,
+                    gpuCount: offer.gpuCount,
+                    // Offers name their region in clusters.
+                    region: offer.region ?? offer.clusters?.[0],
+                    operatingSystem,
+                    instanceType: offer.instanceType,
+                    name: opts.name,
+                    ...ssh,
+                    volumeIds: opts.volumeIds,
+                    // Deploying a spot offer is the acknowledgement that it can be reclaimed at any time.
+                    spotTermsAcknowledged: String(offer.instanceType).toUpperCase() === 'SPOT' ? true : undefined,
+                    // The API names the sandbox agentAccess.
+                    agentAccess: true,
+                }, opts.signal);
+            }
+            catch (error) {
+                if (error instanceof SpheronApiError && error.code && NEXT_OFFER_CODES.has(error.code) && !opts.offer) {
+                    attempts.push({ offerId: offer.offerId, provider: offer.provider, reason: error.message });
+                    continue;
+                }
+                throw error;
+            }
+            const id = String(created.id ?? created._id ?? '');
+            if (!id)
+                throw new SpheronError('The API created the instance but did not return its id. Check your deployments list.');
+            const sandbox = new Sandbox(http, id, opts.pollIntervalMs ?? 2000);
+            if (opts.waitUntilReady !== false) {
+                await sandbox.waitUntilReady({ timeoutMs: opts.readyTimeoutMs, onStatus: opts.onStatus, checkEveryMs: opts.checkEveryMs, signal: opts.signal });
+            }
+            return sandbox;
+        }
+        const detail = attempts.map((a) => `${a.provider} ${a.offerId}: ${a.reason}`).join('; ');
+        throw new NoOfferError(`No offer could be deployed with the sandbox. ${detail}`, attempts);
+    }
+    /** The sandbox's state: installing, ready, failed or removed, and whether the instance is reachable now. */
+    async status(signal) {
+        return this.#http.request('GET', `${this.path}/agent`, { signal });
+    }
+    /** The instance: status, IP, SSH command, GPU, region, hourly rate and so on. */
+    async info(signal) {
+        return this.#http.request('GET', this.path, { signal });
+    }
+    /**
+     * Wait until the instance runs and the sandbox is reachable. Throws SandboxFailedError when the install fails or
+     * the instance dies, and TimeoutError (the instance keeps running and billing) when it takes too long.
+     */
+    async waitUntilReady(opts = {}) {
+        return this.tagged(() => this.waitReady(opts, false));
+    }
+    /** waitUntilReady, also for the moment after a Start when the instance still reads stopped. */
+    async waitReady(opts, afterStart) {
+        const timeoutMs = opts.timeoutMs ?? READY_TIMEOUT_MS;
+        const started = Date.now();
+        const deadline = started + timeoutMs;
+        /** Since when the running instance's sandbox has asked for its recovery command. */
+        let unreachableSince;
+        let phase;
+        const report = (p, s) => {
+            if (p !== phase)
+                opts.onStatus?.(p, s);
+            phase = p;
+        };
+        for (;;) {
+            let status = null;
+            try {
+                status = await this.status(opts.signal);
+            }
+            catch (error) {
+                if (!(error instanceof NotFoundError) || phase !== undefined || Date.now() - started > NOT_FOUND_GRACE_MS)
+                    throw error;
+            }
+            if (status) {
+                unreachableSince = status.recoveryCommand && status.deploymentRunning ? (unreachableSince ?? Date.now()) : undefined;
+                if (status.state === 'ready' && status.reachable && status.deploymentRunning) {
+                    report('ready', status);
+                    return status;
+                }
+                if (status.state === 'removed')
+                    throw new SandboxFailedError(`The sandbox on ${this.id} was removed.`, { state: status.state });
+                if (!status.deploymentRunning) {
+                    const d = await this.info(opts.signal);
+                    const starting = isActive(d.pendingOperation) || (afterStart && d.status === 'stopped' && Date.now() - started < STARTING_GRACE_MS);
+                    if (DEAD.has(d.status) && !starting) {
+                        const why = d.failureReason ? `: ${d.failureReason}` : '';
+                        throw new SandboxFailedError(`Instance ${this.id} is ${d.status}${why}`, { state: status.state, failureReason: d.failureReason });
+                    }
+                    report('deploying', status);
+                }
+                else if (status.state === 'failed' || (unreachableSince !== undefined && Date.now() - unreachableSince > RECONNECT_GRACE_MS)) {
+                    // The install failed, or the sandbox never checked in: only the person can fix it, over SSH.
+                    throw new SandboxFailedError(`The sandbox on ${this.id} is not working (${status.failureReason ?? status.state}). SSH into the instance and run recoveryCommand to bring it back, or terminate it.`, { state: status.state, failureReason: status.failureReason, recoveryCommand: status.recoveryCommand });
+                }
+                else {
+                    // Installing, or unreachable for a moment after a boot or a Start, until the agent checks in.
+                    report('installing', status);
+                }
+            }
+            if (Date.now() >= deadline) {
+                throw new TimeoutError(`Sandbox ${this.id} was not ready within ${Math.round(timeoutMs / 1000)} s. It is still billed: terminate it if you no longer need it.`);
+            }
+            await sleep(Math.min(opts.checkEveryMs ?? 5_000, Math.max(0, deadline - Date.now())), opts.signal);
+        }
+    }
+    /**
+     * Stop the instance: it keeps its disk and bills only storage. Commands fail until it is started again. By default
+     * this waits until the provider has finished stopping it, which can take minutes on a large machine.
+     */
+    async stop(opts = {}) {
+        await this.tagged(async () => {
+            const answer = await this.lifecycleCall('pause', opts.signal);
+            if (opts.wait !== false)
+                await this.follow(answer, Date.now() + (opts.timeoutMs ?? STOP_TIMEOUT_MS), opts.checkEveryMs, opts.signal);
+        });
+    }
+    /**
+     * Start a stopped instance, and by default wait until the sandbox is reachable again (timeoutMs covers both).
+     * While the provider is still stopping it, has no capacity yet or is busy, nothing changes and the start is tried
+     * again every retryEveryMs (default 30 s) for up to retryForMs (default 10 minutes).
+     */
+    async start(opts = {}) {
+        const retryEveryMs = opts.retryEveryMs ?? START_RETRY_MS;
+        await this.tagged(async () => {
+            const deadline = Date.now() + (opts.timeoutMs ?? READY_TIMEOUT_MS);
+            const retryUntil = Date.now() + (opts.retryForMs ?? START_RETRY_BUDGET_MS);
+            for (;;) {
+                try {
+                    await this.follow(await this.lifecycleCall('resume', opts.signal), deadline, opts.checkEveryMs, opts.signal);
+                    break;
+                }
+                catch (error) {
+                    const retry = error instanceof SpheronApiError && !!error.code && START_RETRY_CODES.has(error.code);
+                    if (!retry || Date.now() + retryEveryMs > retryUntil)
+                        throw error;
+                    await sleep(retryEveryMs, opts.signal);
+                }
+            }
+            if (opts.waitUntilReady !== false)
+                await this.waitReady({ ...opts, timeoutMs: Math.max(0, deadline - Date.now()) }, true);
+        });
+    }
+    /**
+     * Terminate the instance. It is deleted with its disk and stops billing. An instance must run for its offer's
+     * minimum runtime (usually 20 minutes) first: before then the API refuses with minimum_runtime_not_met.
+     */
+    async terminate() {
+        await this.tagged(() => this.#http.request('DELETE', this.path, { timeoutMs: 120_000 }));
+    }
+    /** Uninstall the sandbox program. The instance keeps running and your SSH access is unaffected. */
+    async removeSandbox() {
+        await this.tagged(() => this.#http.request('DELETE', `${this.path}/agent`));
+    }
+    /**
+     * POST pause or resume. A slow one answers 202 (or, from a server that ignores Prefer, 504) with the operation
+     * still running: both are handed back to follow, not thrown.
+     */
+    async lifecycleCall(action, signal) {
+        try {
+            return await this.#http.request('POST', `${this.path}/${action}`, { timeoutMs: 120_000, headers: { Prefer: LIFECYCLE_PREFER }, signal });
+        }
+        catch (error) {
+            if (error instanceof SpheronApiError && error.status === 504 && isActive(error.body?.operation))
+                return error.body;
+            throw error;
+        }
+    }
+    /** Wait for a Stop or Start to finish. Throws the operation's own error when it fails. */
+    async follow(answer, deadline, everyMs = OPERATION_CHECK_MS, signal) {
+        let op = answer?.operation;
+        while (op && isActive(op)) {
+            if (Date.now() >= deadline)
+                throw new TimeoutError(`${op.type === 'instance_pause' ? 'Stop' : 'Start'} of ${this.id} is still running (operation ${op.id}).`);
+            await sleep(everyMs, signal);
+            op = await this.#http.request('GET', `/api/operations/${encodeURIComponent(op.id)}`, { signal });
+        }
+        if (op?.status === 'failed') {
+            const e = op.error ?? {};
+            throw new SpheronApiError(e.status ?? 500, e.message ?? 'The operation failed.', { code: e.code, body: op });
+        }
+    }
+    /** Runs fn and names this instance on any error it throws, wrapping errors that are not ours. */
+    async tagged(fn) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            const tagged = error instanceof SpheronError ? error : Object.assign(new SpheronError(String(error?.message ?? error)), { cause: error });
+            tagged.deploymentId ??= this.id;
+            throw tagged;
+        }
+    }
+}
+/** POST /api/deployments with one idempotency key, asking again while a timed-out first try is still running. */
+async function createDeployment(http, body, signal) {
+    const key = newIdempotencyKey();
+    const until = Date.now() + CREATE_IN_PROGRESS_BUDGET_MS;
+    for (;;) {
+        try {
+            // The provider create can take most of a minute. The key makes a retried request return the same instance.
+            return await http.request('POST', '/api/deployments', { body, timeoutMs: 120_000, headers: { 'Idempotency-Key': key }, idempotent: true, signal });
+        }
+        catch (error) {
+            if (!(error instanceof SpheronApiError && error.code === CREATE_IN_PROGRESS) || Date.now() > until)
+                throw error;
+            await sleep(CREATE_IN_PROGRESS_RETRY_MS, signal);
+        }
+    }
+}
+async function defaultTeamId(http) {
+    const teams = await http.request('GET', '/api/teams');
+    if (Array.isArray(teams) && teams.length === 1)
+        return teams[0].id;
+    const names = (teams ?? []).map((t) => `${t.name ?? 'team'} (${t.id})`).join(', ');
+    throw new SpheronError(`Pass teamId: this key reaches ${teams?.length ?? 0} teams: ${names}`);
+}
+async function defaultSshKeyId(http, teamId) {
+    const keys = await http.request('GET', '/api/ssh-keys', { query: { teamId } });
+    const first = Array.isArray(keys) ? keys[0] : undefined;
+    if (!first) {
+        throw new SpheronError('An SSH key is required so you can always reach the instance yourself. Pass sshPublicKey, or save a key in the dashboard and pass sshKeyId.');
+    }
+    return first.id;
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/sandbox.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,102 @@
+import type { Recovery } from './errors.js';
+/** queued: not on the instance yet (it runs once the sandbox is reachable). running, then one of the final states. */
+export type CommandStatus = 'queued' | 'running' | 'done' | 'failed' | 'killed' | 'expired';
+export declare const FINAL_STATUSES: ReadonlySet<CommandStatus>;
+/** One answer from the commands API (internal: what the SDK reads, not part of its interface). */
+export interface CommandView {
+    commandId: string;
+    status: CommandStatus;
+    exitCode?: number;
+    /** Output (stdout and stderr together) from outputOffset on, as UTF-8. */
+    output: string;
+    outputOffset: number;
+    /** Where the next read starts, in bytes. */
+    nextOffset?: number;
+    /** True once the command wrote more than 1 MB: the rest is only in logPath on the instance. */
+    outputTruncated: boolean;
+    /** The full log on the instance. */
+    logPath?: string;
+    error?: string;
+    /** Present while the instance cannot be reached. A queued command still runs once it is back. */
+    recovery?: Recovery;
+}
+/** A finished command. */
+export interface CommandResult {
+    commandId: string;
+    status: CommandStatus;
+    /** Set when the command ran to an exit. */
+    exitCode?: number;
+    /** It finished with status done and exit code 0. */
+    ok: boolean;
+    /** Everything it printed (stdout and stderr together), up to 1 MB. */
+    output: string;
+    outputTruncated: boolean;
+    logPath?: string;
+    error?: string;
+}
+export interface SandboxStatus {
+    /** installing, ready, failed or removed. */
+    state: 'installing' | 'ready' | 'failed' | 'removed' | string;
+    installMethod: string;
+    lastSeenAt: string | null;
+    /** True when the sandbox program checked in within the last few minutes. */
+    reachable: boolean;
+    /** False when the instance is stopped, terminated or failed. */
+    deploymentRunning: boolean;
+    failureReason?: string;
+    /** Run this over SSH on the instance to bring the sandbox back. Present only when it would help. */
+    recoveryCommand?: string;
+}
+export interface FileEntry {
+    name: string;
+    type: 'file' | 'dir' | 'other' | string;
+    size?: number;
+}
+/** A deployment as GET /api/deployments/:id returns it. Only the commonly used fields are typed. */
+export interface Deployment {
+    id: string;
+    name?: string;
+    status: string;
+    teamId?: string;
+    /** The provider id, e.g. hyperstack or nebius. */
+    providerId?: string;
+    gpuType?: string;
+    gpuCount?: number;
+    region?: string;
+    operatingSystem?: string;
+    instanceType?: string;
+    ipAddress?: string;
+    /** For example `ssh -p 22 ubuntu@203.0.113.7`. */
+    sshCommand?: string;
+    sshPort?: number;
+    hourlyRate?: number;
+    createdAt?: string;
+    startedAt?: string;
+    pausedAt?: string;
+    /** Why a failed instance failed. */
+    failureReason?: string;
+    [key: string]: unknown;
+}
+/** One offer from GET /api/gpu-offers, with its group's gpuType. */
+export interface GpuOffer {
+    provider: string;
+    offerId: string;
+    gpuType: string;
+    name: string;
+    gpuCount: number;
+    vcpus: number;
+    memory: number;
+    storage: number;
+    price: number;
+    spot_price?: number;
+    region?: string;
+    /** The regions this offer deploys to; the first one is used when region is absent. */
+    clusters?: string[];
+    os_options?: string[];
+    instanceType: string;
+    available: boolean;
+    maintenance?: boolean;
+    supportsCloudInit: boolean;
+    minimumRuntimeMinutes?: number;
+    [key: string]: unknown;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export const FINAL_STATUSES = new Set(['done', 'failed', 'killed', 'expired']);
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,cAAc,GAA+B,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@spheron/sandbox",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Run commands and move files on a Spheron Agent GPU Sandbox from code.",
+  "license": "Apache-2.0",
+  "homepage": "https://docs.spheron.ai/sandbox-sdk",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "spheron",
+    "gpu",
+    "sandbox",
+    "agent",
+    "ai"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "lint": "tsc --noEmit",
+    "test": "bun test tests/",
+    "prepublishOnly": "bun run lint && bun run build"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.1.0",
+    "typescript": "^5.0.0"
+  }
+}