@alchemy.run/daytona 0.0.0 → 2.0.0-beta.86

package/lib/Snapshot.js

@@ -0,0 +1,447 @@
+import { createHash } from "node:crypto";
+import * as BuildPlan from "@alchemy.run/docker/BuildPlan";
+import * as DockerfileParser from "@alchemy.run/docker/DockerfileParser";
+import { computeStaticSourceHash, makeContainerImageSource, } from "@alchemy.run/docker/ImageSource";
+import * as dockerRegistry from "@distilled.cloud/daytona/docker_registry";
+import * as sandboxes from "@distilled.cloud/daytona/sandbox";
+import * as snapshots from "@distilled.cloud/daytona/snapshots";
+import { Unowned } from "alchemy/AdoptPolicy";
+import { isResolved } from "alchemy/Diff";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Stream from "effect/Stream";
+import { uploadBuildContext } from "./internal/BuildContext.js";
+import { declarable } from "./internal/Declared.js";
+import { createInternalLabels } from "./internal/Labels.js";
+import { isOwnedName, resolveName } from "./internal/Names.js";
+import { runCommand } from "./internal/Process.js";
+import { resolved } from "./internal/Ref.js";
+import { waitForState, waitUntilGone } from "./internal/Wait.js";
+/**
+ * A Daytona snapshot: the image sandboxes boot from, with its default
+ * size. Pull one from a registry, build one from a Dockerfile on
+ * Daytona's builders, or capture one from a sandbox after running setup
+ * commands in it (a warm base to fork from).
+ *
+ * Snapshots are immutable: changing what one is built from replaces it.
+ * Daytona deactivates a snapshot after two weeks without use; deploy
+ * reactivates it.
+ * @see https://www.daytona.io/docs/en/snapshots/
+ *
+ * ### Pulling an Image
+ * **Example:** A public image with a size
+ * ```typescript
+ * export const Node = Daytona.Snapshot("Node", {
+ *   image: "node:22-bookworm",
+ *   cpu: 2,
+ *   memory: 4,
+ *   disk: 10,
+ * });
+ * ```
+ *
+ * ### Building from a Dockerfile
+ * **Example:** An inline Dockerfile built by Daytona
+ * ```typescript
+ * export const Base = Daytona.Snapshot("Base", {
+ *   dockerfile: Dockerfile.inline`
+ *     FROM node:22-bookworm
+ *     RUN apt-get update && apt-get install -y git ripgrep
+ *   `,
+ *   cpu: 2,
+ *   memory: 4,
+ * });
+ * ```
+ *
+ * ### Building a Directory
+ * **Example:** A Dockerfile and the files it copies
+ * ```typescript
+ * export const App = Daytona.Snapshot("App", {
+ *   context: "./sandbox",
+ *   build: { args: { NODE_ENV: "production" } },
+ * });
+ * ```
+ *
+ * ### Building with Local Docker
+ * **Example:** A build that reads a private npm token
+ * ```typescript
+ * export const App = Daytona.Snapshot("App", {
+ *   context: "./sandbox",
+ *   build: {
+ *     remote: false,
+ *     secrets: { npmrc: Redacted.make(process.env.NPM_TOKEN!) },
+ *   },
+ * });
+ * ```
+ *
+ * ### A Warm Base to Fork From
+ * **Example:** Clone and install once, then start every sandbox from it
+ * ```typescript
+ * export const Warm = Daytona.Snapshot("Warm", {
+ *   from: Base,
+ *   run: [
+ *     "git clone https://github.com/alchemy-run/alchemy /home/daytona/alchemy",
+ *     "cd /home/daytona/alchemy && pnpm install",
+ *   ],
+ * });
+ * ```
+ *
+ * ### Looking up an existing snapshot
+ * `Snapshot.lookup` references a snapshot Alchemy doesn't manage (created in
+ * the Daytona dashboard or by another stack). It is read during plan/deploy,
+ * never created, updated or deleted.
+ * `buildHash` is empty: the image wasn't built by this stack.
+ *
+ * **Example:** Start a sandbox from an existing snapshot
+ * ```typescript
+ * const base = Daytona.Snapshot.lookup({ name: "python-ml" });
+ * ```
+ *
+ * @resource
+ * @product Snapshot
+ */
+export const Snapshot = declarable()(Resource("Daytona.Snapshot"));
+/**
+ * What Daytona's builders can build: any Dockerfile, for amd64. Daytona's
+ * build request has no field for build arguments, so the plan bakes them
+ * into `ARG` defaults, nor for BuildKit secrets, so the plan rejects them.
+ */
+export const capabilities = {
+    target: "Daytona.Snapshot",
+    buildArgs: false,
+    secrets: false,
+    platforms: ["linux/amd64"],
+};
+/** The snapshot props name more than one of `image`, `dockerfile` and `from`, or none. */
+export class SnapshotSourceInvalid extends Data.TaggedError("Daytona.SnapshotSourceInvalid") {
+}
+/** A runtime build's Dockerfile copies local files, which only a deploy-time `context` can provide. */
+export class SnapshotContextUnsupported extends Data.TaggedError("Daytona.SnapshotContextUnsupported") {
+    get message() {
+        return `A snapshot built at runtime can't copy local files (${this.line.trim()}). Declare it with Daytona.Snapshot and a \`context\`, or fetch the files in a RUN step.`;
+    }
+}
+/** A `run` command exited non-zero while building a snapshot from a sandbox. */
+export class SnapshotRunFailed extends Data.TaggedError("Daytona.SnapshotRunFailed") {
+    get message() {
+        return `\`${this.command}\` exited ${this.exitCode} while building the snapshot:\n${this.output.slice(-2000)}`;
+    }
+}
+/** The image has no tag, or a moving one Daytona rejects. */
+export class SnapshotImageTagInvalid extends Data.TaggedError("Daytona.SnapshotImageTagInvalid") {
+    get message() {
+        return `Daytona needs an image with a fixed tag or digest; got ${this.image} (latest, lts and stable are rejected)`;
+    }
+}
+const sha256 = (value) => Effect.sync(() => createHash("sha256").update(JSON.stringify(value)).digest("hex"));
+const refName = (ref) => Effect.succeed(ref === undefined ? undefined : resolved(ref).name);
+const checkImage = (image) => {
+    const last = image.split("/").at(-1) ?? image;
+    const tag = image.includes("@")
+        ? "digest"
+        : last.includes(":")
+            ? last.split(":").at(-1)
+            : undefined;
+    return tag === undefined || ["latest", "lts", "stable"].includes(tag)
+        ? Effect.fail(new SnapshotImageTagInvalid({ image }))
+        : Effect.void;
+};
+/** The Dockerfile's text for Daytona; the plan has baked build arguments in. */
+const dockerfileText = (plan) => DockerfileParser.render(plan.dockerfile);
+/**
+ * Check Dockerfile content built at runtime (a Worker has no file system,
+ * so there is no context to copy from).
+ */
+export const checkRuntimeDockerfile = Effect.fn(function* (content) {
+    const parsed = yield* DockerfileParser.parse(content);
+    const { violations } = BuildPlan.check(parsed, capabilities, "linux/amd64");
+    if (violations.length > 0) {
+        return yield* new BuildPlan.UnsupportedDockerfile({
+            target: capabilities.target,
+            violations,
+            message: violations.map((v) => `line ${v.line}: ${v.instruction}: ${v.reason}`).join("\n"),
+        });
+    }
+    for (const stage of parsed.stages) {
+        for (const instruction of stage.instructions) {
+            if (instruction._tag !== "COPY" && instruction._tag !== "ADD")
+                continue;
+            if (instruction.flags.some((flag) => flag.name === "from"))
+                continue;
+            const local = instruction.sources.filter((source) => !/^(https?:\/\/|git@)/.test(source) && !source.startsWith("<<"));
+            if (local.length > 0)
+                return yield* new SnapshotContextUnsupported({ line: instruction.raw });
+        }
+    }
+});
+/** What the snapshot is built from, resolved; its hash decides rebuilds. */
+const resolveSource = Effect.fn(function* (news) {
+    const fromDockerfile = news.dockerfile !== undefined || news.context !== undefined;
+    const sources = [news.image, fromDockerfile ? true : undefined, news.from].filter((s) => s !== undefined);
+    if (sources.length !== 1) {
+        return yield* new SnapshotSourceInvalid({
+            message: "Daytona.Snapshot takes exactly one of `image`, `dockerfile`/`context` or `from`",
+        });
+    }
+    if (news.image !== undefined)
+        yield* checkImage(news.image);
+    // A Dockerfile builds on Daytona unless it asks for local Docker, or
+    // has build secrets (Daytona's builders can't receive them).
+    const remote = news.build?.remote ?? news.build?.secrets === undefined;
+    const local = fromDockerfile && !remote
+        ? {
+            dockerfile: news.dockerfile,
+            context: news.context,
+            build: { args: news.build?.args, secrets: news.build?.secrets },
+        }
+        : undefined;
+    const plan = fromDockerfile && remote
+        ? yield* BuildPlan.plan({ dockerfile: news.dockerfile, context: news.context, build: { args: news.build?.args } }, { capabilities })
+        : undefined;
+    const sizing = {
+        entrypoint: news.entrypoint,
+        cpu: news.cpu,
+        memory: news.memory,
+        disk: news.disk,
+        gpu: news.gpu,
+        gpuType: news.gpuType,
+        regionId: news.regionId,
+        sandboxClass: news.sandboxClass,
+    };
+    const source = {
+        image: news.image,
+        dockerfile: plan ? dockerfileText(plan) : undefined,
+        from: yield* refName(news.from),
+        run: news.run ?? [],
+        ...sizing,
+    };
+    const buildHash = yield* sha256({
+        image: source.image,
+        plan: plan?.hash,
+        local: local ? yield* computeStaticSourceHash(local, "linux/amd64") : undefined,
+        from: source.from,
+        run: source.run,
+        ...sizing,
+    });
+    return { source, plan, local, buildHash };
+});
+export const toSnapshotAttributes = (s, buildHash) => ({
+    snapshotId: s.id,
+    name: s.name,
+    state: s.state,
+    imageName: s.imageName,
+    ref: s.ref,
+    cpu: s.cpu,
+    memory: s.mem,
+    disk: s.disk,
+    gpu: s.gpu,
+    sourceSandboxId: s.sourceSandboxId ?? undefined,
+    buildHash,
+});
+export const getSnapshot = (idOrName) => snapshots
+    .getSnapshot({ id: idOrName })
+    .pipe(Effect.catchTag("SnapshotNotFound", () => Effect.undefined));
+/** Wait for a snapshot to become usable, reactivating it when Daytona has deactivated it. */
+export const waitForSnapshot = Effect.fn(function* (idOrName) {
+    const current = yield* snapshots.getSnapshot({ id: idOrName });
+    if (current.state === "inactive")
+        yield* snapshots.activateSnapshot({ id: current.id });
+    return yield* waitForState({
+        kind: "snapshot",
+        id: idOrName,
+        observe: snapshots.getSnapshot({ id: idOrName }),
+        want: ["active"],
+        fail: ["error", "build_failed"],
+        reason: (s) => s.errorReason,
+        budget: "30 minutes",
+    });
+});
+/** Delete a snapshot by name (Daytona deletes by id). Deleting a missing one succeeds. */
+export const deleteSnapshotByName = Effect.fn(function* (name) {
+    const found = yield* getSnapshot(name);
+    if (found !== undefined)
+        yield* deleteSnapshot(found.id);
+});
+export const deleteSnapshot = Effect.fn(function* (idOrName) {
+    yield* snapshots
+        .removeSnapshot({ id: idOrName })
+        .pipe(Effect.catchTag("SnapshotNotFound", () => Effect.void));
+    yield* waitUntilGone("snapshot", idOrName, getSnapshot(idOrName).pipe(Effect.map((s) => s !== undefined)), "5 minutes");
+});
+/**
+ * Start a sandbox from `from`, run the commands in it and capture it as a
+ * snapshot named `name`. The build sandbox is deleted whatever happens, and
+ * deletes itself after an hour if this process dies first.
+ */
+export const captureSnapshot = Effect.fn(function* (input) {
+    const build = yield* Effect.acquireRelease(sandboxes.createSandbox({
+        name: `${input.name}-build`.slice(0, 63),
+        snapshot: input.from,
+        labels: { ...input.labels, "alchemy.role": "snapshot-build" },
+        autoDeleteInterval: 60,
+    }), (sandbox) => sandboxes.deleteSandbox({ sandboxIdOrName: sandbox.id }).pipe(Effect.catchTag("SandboxNotFound", () => Effect.void), Effect.ignore));
+    const started = yield* waitForState({
+        kind: "sandbox",
+        id: build.id,
+        observe: sandboxes.getSandbox({ sandboxIdOrName: build.id }),
+        want: ["started"],
+        fail: ["error", "build_failed", "destroyed"],
+        reason: (s) => s.errorReason,
+    });
+    for (const command of input.run) {
+        yield* input.note(`Running \`${command}\` in the snapshot build sandbox...`);
+        const result = yield* runCommand(started.id, started.toolboxProxyUrl, {
+            command,
+            timeout: 1800,
+        });
+        if ((result.exitCode ?? 0) !== 0) {
+            return yield* new SnapshotRunFailed({
+                command,
+                exitCode: result.exitCode ?? -1,
+                output: result.result,
+            });
+        }
+    }
+    yield* input.note(`Capturing snapshot ${input.name}...`);
+    yield* sandboxes.createSandboxSnapshot({ sandboxIdOrName: started.id, name: input.name });
+    return yield* waitForSnapshot(input.name);
+}, Effect.scoped);
+/**
+ * Build a snapshot named `name` and wait until it is active: pull or
+ * build on Daytona's builders, or capture it from a `from` sandbox after
+ * running `run`. Shared by the resource and the runtime binding.
+ */
+export const buildSnapshot = Effect.fn(function* (input) {
+    const { name, source } = input;
+    if (source.from !== undefined) {
+        return yield* captureSnapshot({
+            labels: input.labels,
+            name,
+            from: source.from,
+            run: source.run ?? [],
+            note: input.note,
+        });
+    }
+    if (source.image !== undefined)
+        yield* checkImage(source.image);
+    yield* input.note(source.dockerfile !== undefined
+        ? `Building snapshot ${name} on Daytona...`
+        : `Pulling ${source.image} into snapshot ${name}...`);
+    yield* snapshots
+        .createSnapshot({
+        name,
+        imageName: source.image,
+        buildInfo: source.dockerfile !== undefined
+            ? { dockerfileContent: source.dockerfile, contextHashes: source.contextHashes }
+            : undefined,
+        entrypoint: source.entrypoint,
+        cpu: source.cpu,
+        memory: source.memory,
+        disk: source.disk,
+        gpu: source.gpu,
+        gpuType: source.gpuType,
+        regionId: source.regionId,
+        sandboxClass: source.sandboxClass,
+    })
+        .pipe(Effect.catchTag("SnapshotAlreadyExists", () => Effect.void));
+    return yield* waitForSnapshot(name);
+});
+/**
+ * Daytona's transient registry as a push target: a short-lived robot
+ * account scoped to the organization's own project, which Daytona pulls
+ * snapshots from without a registry entry.
+ */
+const transientRegistry = Effect.fn(function* (name, regionId) {
+    const access = yield* dockerRegistry.getTransientPushAccess({ regionId });
+    return {
+        repositoryUri: Effect.succeed(`${access.registryUrl}/${access.project}/${name}`),
+        // Pushes are content-addressed and the registry can't be listed with
+        // this account; pushing an existing tag is a no-op upload.
+        hasTag: () => Effect.succeed(false),
+        credentials: Effect.succeed({
+            server: access.registryUrl,
+            username: access.username,
+            password: access.secret,
+        }),
+    };
+});
+export const SnapshotProvider = () => Provider.effect(Snapshot, Effect.gen(function* () {
+    const images = yield* makeContainerImageSource;
+    return {
+        stables: ["snapshotId"],
+        list: Effect.fn(function* () {
+            const all = yield* snapshots.getAllSnapshots.items({}).pipe(Stream.runCollect);
+            return Array.from(all)
+                .filter((s) => !s.general)
+                .map((s) => toSnapshotAttributes(s, ""));
+        }),
+        diff: Effect.fn(function* ({ id, news, output }) {
+            if (!isResolved(news) || output === undefined)
+                return undefined;
+            const name = yield* resolveName(id, news.name, news.name === undefined ? output.name : undefined);
+            const { buildHash } = yield* resolveSource(news);
+            if (name !== output.name || buildHash !== output.buildHash) {
+                // Sandboxes reference snapshots by name, so a pinned name is freed first.
+                return { action: "replace", deleteFirst: name === output.name };
+            }
+        }),
+        lookup: Effect.fn(function* ({ name }) {
+            const found = yield* getSnapshot(name);
+            return found === undefined ? undefined : toSnapshotAttributes(found, "");
+        }),
+        read: Effect.fn(function* ({ id, olds, output }) {
+            const name = yield* resolveName(id, olds?.name, output?.name);
+            const found = (output ? yield* getSnapshot(output.snapshotId) : undefined) ??
+                (yield* getSnapshot(name));
+            if (found === undefined)
+                return undefined;
+            const attrs = toSnapshotAttributes(found, output?.buildHash ?? "");
+            return (yield* isOwnedName(id, found.name, output !== undefined))
+                ? attrs
+                : Unowned(attrs);
+        }),
+        reconcile: Effect.fn(function* ({ id, news, output, session }) {
+            const name = yield* resolveName(id, news.name, output?.name);
+            const { source, plan, local, buildHash } = yield* resolveSource(news);
+            // Observe
+            const current = yield* getSnapshot(output?.snapshotId ?? name);
+            if (current !== undefined && current.name === name) {
+                // Ensure usable: reactivate a snapshot Daytona deactivated after
+                // two weeks unused, and wait out a build already in flight.
+                const ready = current.state === "active" ? current : yield* waitForSnapshot(current.id);
+                return toSnapshotAttributes(ready, output?.buildHash ?? buildHash);
+            }
+            // Ensure — a local build pushes its image to Daytona's registry,
+            // which the snapshot then pulls.
+            if (local !== undefined) {
+                yield* session.note(`Building ${name} with local Docker...`);
+                const pushed = yield* images.resolve({ id, source: local, session, platform: "linux/amd64", bootstrap: () => "" }, yield* transientRegistry(name, news.regionId));
+                const built = yield* buildSnapshot({
+                    name,
+                    source: { ...source, dockerfile: undefined, image: pushed.imageUri },
+                    labels: yield* createInternalLabels(id),
+                    note: session.note,
+                });
+                return toSnapshotAttributes(built, buildHash);
+            }
+            // Ensure — upload what the Dockerfile copies, then build.
+            for (const warning of plan?.warnings ?? [])
+                yield* session.note(warning);
+            const contextHashes = plan !== undefined && plan.files.length > 0
+                ? [yield* uploadBuildContext(plan)]
+                : undefined;
+            const built = yield* buildSnapshot({
+                name,
+                source: { ...source, contextHashes },
+                labels: yield* createInternalLabels(id),
+                note: session.note,
+            });
+            return toSnapshotAttributes(built, buildHash);
+        }),
+        delete: Effect.fn(function* ({ output }) {
+            yield* deleteSnapshot(output.snapshotId);
+        }),
+    };
+}));
+//# sourceMappingURL=Snapshot.js.map

package/lib/Snapshot.js.map

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

package/lib/Volume.d.ts

@@ -0,0 +1,99 @@
+import * as volumes from "@distilled.cloud/daytona/volumes";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Effect from "effect/Effect";
+import type { Providers } from "./Providers.ts";
+export interface VolumeProps {
+    /**
+     * Volume name, unique in the organization. If omitted, a unique name is
+     * generated from the stack, stage and logical ID. Changing it replaces
+     * the volume (and its files).
+     */
+    name?: string;
+}
+export interface VolumeAttributes {
+    /** Volume ID. */
+    volumeId: string;
+    /** Volume name. */
+    name: string;
+    /** Volume state (`ready` once usable). */
+    state: volumes.VolumeState;
+    /** When the volume was created. */
+    createdAt: string;
+}
+export type Volume = Resource<"Daytona.Volume", VolumeProps, VolumeAttributes, never, Providers, VolumeLookup>;
+/**
+ * Props for {@link Volume.lookup}: find a volume this stack
+ * doesn't manage by its name.
+ */
+export interface VolumeLookup {
+    /** Volume name. */
+    name: string;
+}
+/**
+ * A Daytona volume: a persistent disk, backed by object storage, that
+ * sandboxes mount at a path. Its files outlive every sandbox that mounts
+ * it, and several sandboxes can mount it at once.
+ *
+ * Declare a volume here for data your whole app shares, like a dataset or
+ * a package cache. For a volume per user or per session, create it at
+ * runtime with {@link CreateVolume}.
+ * @see https://www.daytona.io/docs/en/volumes/
+ *
+ * ### Creating a Volume
+ * **Example:** A shared cache volume
+ * ```typescript
+ * export const Cache = Daytona.Volume("Cache", {});
+ * ```
+ *
+ * ### Mounting a Volume
+ * **Example:** Mount it in a sandbox declared at deploy
+ * ```typescript
+ * export const DevBox = Daytona.Sandbox("DevBox", {
+ *   snapshot: Base,
+ *   mounts: [{ volume: Cache, path: "/cache" }],
+ * });
+ * ```
+ *
+ * **Example:** Mount it in sandboxes created at runtime
+ * ```typescript
+ * const cache = yield* Daytona.MountVolume(Cache, { path: "/cache" });
+ * const sandbox = yield* sandboxes.create({ mounts: [cache] });
+ * ```
+ *
+ * ### Looking up an existing volume
+ * `Volume.lookup` references a volume Alchemy doesn't manage (created in
+ * the Daytona dashboard or by another stack). It is read during plan/deploy,
+ * never created, updated or deleted.
+ *
+ * **Example:** Mount an existing volume
+ * ```typescript
+ * const data = Daytona.Volume.lookup({ name: "datasets" });
+ * ```
+ *
+ * @resource
+ * @product Volume
+ */
+export declare const Volume: import("alchemy/Resource").ResourceClass<Volume>;
+export declare const toVolumeAttributes: (v: volumes.VolumeDto) => VolumeAttributes;
+export declare const getVolumeByName: (name: string) => Effect.Effect<volumes.VolumeDto | undefined, volumes.DaytonaOpError, volumes.DaytonaOpContext>;
+export declare const getVolumeById: (volumeId: string) => Effect.Effect<volumes.VolumeDto | undefined, volumes.DaytonaOpError, volumes.DaytonaOpContext>;
+export declare const waitForVolume: (volumeId: string) => Effect.Effect<volumes.VolumeDto, import("./internal/Wait.ts").StateFailed | import("./internal/Wait.ts").StateTimeout | volumes.GetVolumeError, volumes.DaytonaOpContext>;
+/**
+ * The volume named `name`, created if missing. A create racing another
+ * caller (`VolumeAlreadyExists`) re-reads the winner.
+ */
+export declare const ensureVolume: (name: string) => Effect.Effect<volumes.VolumeDto, import("@distilled.cloud/core/errors").BadGateway | import("@distilled.cloud/core/errors").BadRequest | import("@distilled.cloud/core/config").ConfigError | import("@distilled.cloud/core/errors").Conflict | import("@distilled.cloud/daytona/Errors").DaytonaParseError | import("@distilled.cloud/core/errors").Forbidden | import("@distilled.cloud/core/errors").GatewayTimeout | import("effect/http/HttpClientError").HttpClientError | import("@distilled.cloud/core/errors").InternalServerError | import("@distilled.cloud/core/protocol-http").InvalidInput | import("@distilled.cloud/core/errors").Locked | import("@distilled.cloud/core/errors").NotFound | import("@distilled.cloud/core/sdk-error").SdkError | import("@distilled.cloud/core/errors").ServiceUnavailable | import("./internal/Wait.ts").StateFailed | import("./internal/Wait.ts").StateTimeout | import("@distilled.cloud/core/errors").TooManyRequests | import("@distilled.cloud/core/errors").Unauthorized | import("@distilled.cloud/daytona/Errors").UnknownDaytonaError | import("@distilled.cloud/core/errors").UnprocessableEntity | volumes.VolumeNotFound, volumes.DaytonaOpContext>;
+/**
+ * Delete a volume. With `wait` (deploy), retry while a sandbox still
+ * mounts it and wait until it is gone. At run time `wait` is off: a
+ * request fails at once with `VolumeInUse` and returns as soon as Daytona
+ * accepts the delete. Daytona releases a volume about a minute after the
+ * sandbox that wrote to it is deleted, which is longer than a request
+ * should wait.
+ */
+export declare const deleteVolumeById: (volumeId: string, options?: {
+    readonly wait: boolean;
+} | undefined) => Effect.Effect<void, import("./internal/Wait.ts").StateTimeout | volumes.VolumeInUse | volumes.VolumeNotReady | volumes.DaytonaOpError, volumes.DaytonaOpContext>;
+export declare const VolumeProvider: () => import("effect/Layer").Layer<Provider.Provider<Volume>, never, import("alchemy/Stack").Stack | import("alchemy/Stage").Stage | volumes.DaytonaOpContext>;
+//# sourceMappingURL=Volume.d.ts.map

package/lib/Volume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Volume.d.ts","sources":["../src/Volume.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,kCAAkC,CAAC;AAG5D,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC;IAC3B,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,MAAM,GAAG,QAAQ,CAC3B,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,KAAK,EACL,SAAS,EACT,YAAY,CACb,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,eAAO,MAAM,MAAM,kDAAqC,CAAC;AAEzD,eAAO,MAAM,kBAAkB,MAAO,OAAO,CAAC,SAAS,KAAG,gBAKxD,CAAC;AAKH,eAAO,MAAM,eAAe,SAAU,MAAM,mGAIzC,CAAC;AAEJ,eAAO,MAAM,aAAa,aAAc,MAAM,mGAI3C,CAAC;AAEJ,eAAO,MAAM,aAAa,aAAc,MAAM,8KAQ1C,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,YAAY,sqCAQvB,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB;mBAED,OAAO;kLA0BjC,CAAC;AAEH,eAAO,MAAM,cAAc,gKAiDxB,CAAC"}