@alchemy.run/e2b 0.0.0 → 2.0.0-beta.87

package/lib/Template.js

@@ -0,0 +1,421 @@
+import * as templates from "@distilled.cloud/e2b/templates";
+import { Unowned } from "alchemy/AdoptPolicy";
+import { isResolved } from "alchemy/Diff";
+import { checkMountSupport, collectMountCapabilities, mountEnv, mountInstallLines, } from "alchemy/Mount";
+import { Platform } from "alchemy/Platform";
+import * as Provider from "alchemy/Provider";
+import { createContainerRuntimeContext, } from "alchemy/Runtime/Process";
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import * as Schedule from "effect/Schedule";
+import * as Stream from "effect/Stream";
+import { E2BUnexpectedResponse } from "./Errors.js";
+import { e2bName, isGeneratedName } from "./internal/Ownership.js";
+import { DEFAULT_PORT, makeBootstrap, programEnv, programReadyCmd } from "./internal/Program.js";
+import { planTemplateBuild, runTemplateBuild, } from "./internal/TemplateBuild.js";
+import { planSource } from "./internal/TemplatePlan.js";
+/**
+ * An E2B template: the image every sandbox boots from, built by E2B into a
+ * Firecracker snapshot.
+ *
+ * Build from a registry `image`, a `dockerfile` (a path or inline content),
+ * or another template (`fromTemplate`). E2B builds remotely, so a deploy
+ * needs no Docker daemon: Alchemy plans the Dockerfile with
+ * `@alchemy.run/docker`'s build plan, lowers it to E2B's build steps, and
+ * uploads only the `COPY` sources E2B has not seen, by content hash. A
+ * deploy starts a new build only when the inputs change.
+ *
+ * E2B's builder runs one stage for `linux/amd64`. A Dockerfile with several
+ * `FROM`s, `COPY --from`, `ADD <url>`, heredocs, `RUN --mount` or `SHELL`
+ * fails at plan time with `UnsupportedDockerfile`, listing the lines.
+ * `EXPOSE`, `LABEL`, `VOLUME`, `HEALTHCHECK` and `STOPSIGNAL` are ignored,
+ * as E2B ignores them. An `ARG` becomes an environment variable. `CMD` / `ENTRYPOINT`
+ * become the template's start command: it is captured running in the
+ * snapshot, so every sandbox starts with it already up.
+ *
+ * E2B templates carry no labels, so Alchemy recognises its templates by
+ * their generated name.
+ *
+ * ### Building a Template
+ * **Example:** From a registry image
+ * ```typescript
+ * export const Python = E2B.Template("Python", { image: "python:3.12-slim" });
+ * ```
+ *
+ * **Example:** From an inline Dockerfile
+ * ```typescript
+ * import * as Dockerfile from "@alchemy.run/docker/Dockerfile";
+ *
+ * export const Agent = E2B.Template("Agent", {
+ *   dockerfile: Dockerfile.inline`
+ *     FROM node:22-bookworm
+ *     RUN apt-get update && apt-get install -y git ripgrep
+ *     WORKDIR /work
+ *   `,
+ *   cpuCount: 2,
+ *   memoryMB: 4096,
+ * });
+ * ```
+ *
+ * **Example:** From a Dockerfile and its build context
+ * ```typescript
+ * export const Repo = E2B.Template("Repo", {
+ *   context: "./sandbox",
+ *   dockerfile: "./sandbox/Dockerfile",
+ *   build: { args: { NODE_VERSION: "22" } },
+ * });
+ * ```
+ *
+ * ### Starting a process in every sandbox
+ * **Example:** A dev server that is already running when a sandbox starts
+ * ```typescript
+ * export const Preview = E2B.Template("Preview", {
+ *   image: "node:22-bookworm",
+ *   run: ["npm create vite@latest app -- --template react", "cd app && npm install"],
+ *   startCmd: "cd /home/user/app && npm run dev -- --host 0.0.0.0 --port 3000",
+ *   readyCmd: "curl -sf http://localhost:3000",
+ * });
+ * ```
+ *
+ * ### Private base images
+ * **Example:** A base image in GHCR
+ * ```typescript
+ * export const Private = E2B.Template("Private", {
+ *   image: "ghcr.io/my-org/base:1",
+ *   registry: { username: "my-org", password: Config.Redacted("GHCR_TOKEN") },
+ * });
+ * ```
+ *
+ * ### Effect program
+ * Give the template a `main` and an Effect, and every sandbox from it boots
+ * with the program already serving HTTP on `port`. Alchemy bundles `main`,
+ * copies it into the template, and E2B snapshots the template once the
+ * program answers. The program runs with Bun; the image defaults to
+ * `oven/bun:1`.
+ *
+ * **Example:** A program in every sandbox
+ * ```typescript
+ * export default class Program extends E2B.Template<Program>()(
+ *   "Program",
+ *   { main: import.meta.url, port: 3000 },
+ *   Effect.gen(function* () {
+ *     return {
+ *       fetch: Effect.succeed(HttpServerResponse.text("hello from a sandbox")),
+ *     };
+ *   }),
+ * ) {}
+ * ```
+ *
+ * **Example:** Call the program in a sandbox
+ * ```typescript
+ * const sandboxes = yield* E2B.CreateSandbox(Program);
+ * const sandbox = yield* sandboxes.create({ timeout: 300 });
+ * const port = yield* sandbox.getTcpPort(3000);
+ * const res = yield* port.fetch(HttpClientRequest.get("/"));
+ * ```
+ *
+ * ### Async program
+ * A `main` without an Effect is bundled and run with Bun as-is. It must
+ * listen on `PORT`. `E2B.InferEnv` types its `env`.
+ *
+ * **Example:** A plain server
+ * ```typescript
+ * export const Server = E2B.Template("Server", {
+ *   main: "./src/server.mjs",
+ *   env: { GREETING: "hi" },
+ * });
+ * export type ServerEnv = E2B.InferEnv<typeof Server>;
+ * ```
+ *
+ * ### Bindings in the sandbox
+ * Bindings work inside a template program like in any other host.
+ *
+ * :::caution[Values are part of the template]
+ * Config and binding values are written into the template, so code in a
+ * sandbox can read them, `Redacted` ones included. Use egress secrets for
+ * credentials untrusted code must not see.
+ * :::
+ *
+ * **Example:** Read a volume from the program
+ * ```typescript
+ * export default class Program extends E2B.Template<Program>()(
+ *   "Program",
+ *   { main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     const reports = yield* E2B.ReadVolume(Reports);
+ *     return {
+ *       fetch: Effect.gen(function* () {
+ *         return HttpServerResponse.text(yield* reports.readText("/latest.json"));
+ *       }).pipe(Effect.orDie),
+ *     };
+ *   }).pipe(Effect.provide(E2B.ReadVolumeHttp)),
+ * ) {}
+ * ```
+ *
+ * ### Configuration
+ * **Example:** Size, image and port
+ * ```typescript
+ * export default class Program extends E2B.Template<Program>()(
+ *   "Program",
+ *   { main: import.meta.url, image: "oven/bun:1-debian", cpuCount: 4, memoryMB: 8192, port: 8080 },
+ *   Effect.gen(function* () {
+ *     return { fetch: Effect.succeed(HttpServerResponse.text("ok")) };
+ *   }),
+ * ) {}
+ * ```
+ *
+ * **Example:** Sandboxes from the template, in a Worker
+ * ```typescript
+ * const sandboxes = yield* E2B.CreateSandbox(Agent);
+ * const sandbox = yield* sandboxes.create({ timeout: 600 });
+ * ```
+ *
+ * ### Referencing a template the stack doesn't manage
+ * `E2B.Template.lookup` finds an existing template by name. Nothing is created,
+ * adopted or deleted.
+ *
+ * **Example:** Look one up by name
+ * ```typescript
+ * const base = E2B.Template.lookup({ name: "my-team/base-image" });
+ * const sandboxes = yield* E2B.CreateSandbox(base);
+ * ```
+ *
+ * @resource
+ * @product Template
+ */
+export const Template = Platform("E2B.Template", {
+    createRuntimeContext: createContainerRuntimeContext("E2B.Template"),
+});
+/** A template by id, or by name (alias). */
+export const observeTemplate = (templateId, name) => (templateId !== undefined
+    ? templates.getTemplate({ templateID: templateId })
+    : templates
+        .getTemplateByAlias({ alias: name })
+        .pipe(Effect.flatMap((alias) => templates.getTemplate({ templateID: alias.templateID })))).pipe(Effect.map((template) => template), Effect.catchTag("NotFound", () => Effect.undefined));
+/** The mounts the template's bindings attach, by path (a later binding wins). */
+const boundMounts = (bindings) => [
+    ...new Map((bindings ?? [])
+        .filter((binding) => binding.action !== "delete")
+        .flatMap((binding) => binding.data?.volumes ?? [])
+        .map((mount) => [mount.path, { volume: { name: mount.volume.name }, path: mount.path }])).values(),
+];
+/** The mount clients the template's bindings need. */
+const boundCapabilities = (bindings) => collectMountCapabilities((bindings ?? [])
+    .filter((binding) => binding.action !== "delete")
+    .map((binding) => ({ data: { mounts: binding.data?.mounts ?? [] } })));
+/** What an E2B sandbox's kernel offers mount clients (checked live: `/dev/fuse`, nfs/nfs4, CAP_SYS_ADMIN). */
+const E2B_MOUNT_SUPPORT = { fuse: true, nfs: true };
+const boundEnv = (bindings) => (bindings ?? [])
+    .filter((binding) => binding.action !== "delete")
+    .reduce((env, binding) => ({ ...env, ...binding.data?.env }), {});
+/**
+ * Plans a template's build: its Dockerfile or program lowered through
+ * `BuildPlan`, then its own E2B steps.
+ */
+const planOf = Effect.fn(function* (name, news, bindings) {
+    const { main, handler, port, build, env, dockerfile, context, image, ...steps } = news;
+    const programPort = port ?? DEFAULT_PORT;
+    const { args, ...bundle } = build ?? {};
+    let lowered;
+    const capabilities = boundCapabilities(bindings);
+    const unsupported = checkMountSupport("E2B.Template", capabilities, E2B_MOUNT_SUPPORT);
+    if (unsupported !== undefined)
+        return yield* unsupported;
+    if (main !== undefined) {
+        // The program, on `image` / `dockerfile` as its environment.
+        lowered = yield* planSource({
+            main,
+            ...(handler !== undefined ? { handler } : {}),
+            ...(image !== undefined ? { image } : {}),
+            ...(dockerfile !== undefined ? { dockerfile } : {}),
+            ...(context !== undefined ? { context } : {}),
+            build: bundle,
+        }, {
+            port: programPort,
+            ...(args !== undefined ? { args } : {}),
+            install: mountInstallLines(capabilities),
+            ...(news.isExternal
+                ? {}
+                : { bootstrap: makeBootstrap(handler ?? "default") }),
+        });
+    }
+    else if (dockerfile !== undefined || context !== undefined) {
+        if (image !== undefined) {
+            return yield* new E2BUnexpectedResponse({
+                message: `template ${name}: set one of image or dockerfile`,
+            });
+        }
+        lowered = yield* planSource({
+            ...(dockerfile !== undefined ? { dockerfile } : {}),
+            ...(context !== undefined ? { context } : {}),
+            ...(args !== undefined ? { build: { args } } : {}),
+        }, args !== undefined ? { args } : {});
+    }
+    const spec = {
+        ...steps,
+        ...(lowered === undefined && image !== undefined ? { image } : {}),
+        name,
+        env: main === undefined
+            ? yield* plainEnv(env)
+            : yield* programEnv(programPort, { ...mountEnv(capabilities), ...boundEnv(bindings) }, env),
+        ...(main !== undefined ? { readyCmd: steps.readyCmd ?? programReadyCmd(programPort) } : {}),
+    };
+    return { spec, plan: yield* planTemplateBuild(spec, lowered) };
+});
+/** `env` for a template without a program: plain values only. */
+const plainEnv = (env) => Effect.succeed(env === undefined
+    ? undefined
+    : Object.fromEntries(Object.entries(env).flatMap(([key, value]) => Redacted.isRedacted(value)
+        ? [[key, String(Redacted.value(value))]]
+        : typeof value === "string" || typeof value === "number" || typeof value === "boolean"
+            ? [[key, String(value)]]
+            : [])));
+export const TemplateProvider = () => Provider.effect(Template, Effect.gen(function* () {
+    return {
+        stables: ["templateId", "name"],
+        diff: Effect.fn(function* ({ id, olds, news, output }) {
+            if (!isResolved(news))
+                return undefined;
+            const name = output?.name ?? (yield* e2bName(id, olds?.name));
+            if (news.name !== undefined && news.name !== name)
+                return { action: "replace" };
+            if (output === undefined)
+                return undefined;
+            // The plan hash reads the build context, so a changed file under an
+            // unchanged `context` path still rebuilds.
+            // Bindings may be unresolved here; the engine reconciles when they
+            // change. Diff compares the hash of everything else.
+            const { plan } = yield* planOf(name, news, undefined);
+            if (plan.hash !== output.sourceHash || news.force)
+                return { action: "update" };
+            if ((news.public ?? false) !== output.public)
+                return { action: "update" };
+            return undefined;
+        }),
+        lookup: Effect.fn(function* ({ name }) {
+            // E2B's public defaults (`base`, `code-interpreter-v1`, …) can't be
+            // read by alias (403 "You don't have access to this template
+            // alias"); they are listed instead.
+            const defaults = yield* templates.listDefaultTemplates({});
+            const template = defaults.find((candidate) => candidate.aliases.includes(name) ||
+                candidate.names.some((full) => full === name || full.split(":")[0] === name)) ?? (yield* observeTemplate(undefined, name));
+            if (template === undefined)
+                return undefined;
+            return {
+                templateId: template.templateID,
+                name,
+                buildId: template.buildID,
+                buildHash: "",
+                sourceHash: "",
+                names: [...template.names],
+                public: template.public,
+                cpuCount: template.cpuCount,
+                memoryMB: template.memoryMB,
+                mounts: [],
+            };
+        }),
+        read: Effect.fn(function* ({ id, olds, output }) {
+            const name = output?.name ?? (yield* e2bName(id, olds?.name));
+            const template = yield* observeTemplate(output?.templateId, name);
+            if (template === undefined)
+                return undefined;
+            const attrs = {
+                templateId: template.templateID,
+                name,
+                buildId: template.buildID,
+                buildHash: output?.buildHash ?? "",
+                sourceHash: output?.sourceHash ?? "",
+                names: [...template.names],
+                public: template.public,
+                cpuCount: template.cpuCount,
+                memoryMB: template.memoryMB,
+                mounts: output?.mounts ?? [],
+            };
+            return output !== undefined || olds?.name === undefined ? attrs : Unowned(attrs);
+        }),
+        reconcile: Effect.fn(function* ({ id, news, output, bindings, session }) {
+            const name = output?.name ?? (yield* e2bName(id, news.name));
+            const { spec, plan } = yield* planOf(name, news, bindings);
+            // Observe
+            const observed = yield* observeTemplate(output?.templateId, name);
+            const sourceHash = bindings === undefined || bindings.length === 0
+                ? plan.hash
+                : (yield* planOf(name, news, undefined)).plan.hash;
+            // Ensure — build when there is no ready build of these exact inputs.
+            let attrs;
+            const upToDate = observed !== undefined &&
+                observed.buildStatus === "ready" &&
+                output?.buildHash === plan.hash &&
+                !news.force;
+            if (upToDate) {
+                attrs = {
+                    templateId: observed.templateID,
+                    name,
+                    buildId: observed.buildID,
+                    buildHash: plan.hash,
+                    sourceHash,
+                    names: [...observed.names],
+                    public: observed.public,
+                    cpuCount: observed.cpuCount,
+                    memoryMB: observed.memoryMB,
+                    mounts: boundMounts(bindings),
+                };
+            }
+            else {
+                yield* session.note(`Building template ${name}...`);
+                const built = yield* runTemplateBuild(spec, plan);
+                attrs = {
+                    templateId: built.templateId,
+                    name,
+                    buildId: built.buildId,
+                    buildHash: plan.hash,
+                    sourceHash,
+                    names: [...built.names],
+                    public: built.public,
+                    cpuCount: news.cpuCount,
+                    memoryMB: news.memoryMB,
+                    mounts: boundMounts(bindings),
+                };
+            }
+            // Sync — visibility.
+            const desiredPublic = news.public ?? false;
+            if (attrs.public !== desiredPublic) {
+                yield* templates.updateTemplate({
+                    templateID: attrs.templateId,
+                    public: desiredPublic,
+                });
+                attrs = { ...attrs, public: desiredPublic };
+            }
+            return attrs;
+        }),
+        delete: Effect.fn(function* ({ output }) {
+            // E2B refuses while sandboxes run on the template. A declared
+            // sandbox is deleted first, so retry a while; sandboxes created at
+            // run time are not deleted with the stack and keep failing it
+            // until they are killed or time out.
+            yield* templates.deleteTemplate({ templateID: output.templateId }).pipe(Effect.retry({
+                while: (error) => error._tag === "TemplateInUse",
+                schedule: Schedule.spaced("3 seconds"),
+                times: 10,
+            }), Effect.catchTag("NotFound", () => Effect.void));
+        }),
+        list: Effect.fn(function* () {
+            const all = Array.from(yield* Stream.runCollect(templates.listTemplates.items({ limit: 100 })));
+            return all
+                .filter((template) => template.aliases.some(isGeneratedName))
+                .map((template) => ({
+                templateId: template.templateID,
+                name: template.aliases.find(isGeneratedName) ?? template.templateID,
+                buildId: template.buildID,
+                buildHash: "",
+                sourceHash: "",
+                names: [...template.names],
+                public: template.public,
+                cpuCount: template.cpuCount,
+                memoryMB: template.memoryMB,
+                mounts: [],
+            }));
+        }),
+    };
+}));
+//# sourceMappingURL=Template.js.map

package/lib/Template.js.map

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

package/lib/Volume.d.ts

@@ -0,0 +1,88 @@
+import * as volumes from "@distilled.cloud/e2b/volumes";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import type { Providers } from "./Providers.ts";
+export interface VolumeProps {
+    /**
+     * Volume name, unique within the team. Letters, digits, `-` and `_`. If
+     * omitted, a unique name is generated from the stack, stage and logical ID.
+     * Changing it replaces the volume, and its files are lost.
+     */
+    name?: string;
+}
+export interface VolumeAttributes {
+    /** E2B's volume id. */
+    volumeId: string;
+    /** The volume's name. Sandboxes mount a volume by name. */
+    name: string;
+}
+export interface Volume extends Resource<"E2B.Volume", VolumeProps, VolumeAttributes, never, Providers, {
+    name: string;
+}> {
+}
+/**
+ * A persistent E2B volume: a team-wide filesystem that sandboxes mount at a
+ * path and that outlives every sandbox using it.
+ *
+ * Declare a volume when every sandbox shares it (a package cache, a
+ * dataset). Per-user and per-session volumes are created at runtime by name
+ * with `E2B.CreateVolume()`, and both kinds mount the same way.
+ *
+ * E2B volumes carry no labels, so Alchemy recognises its volumes by their
+ * generated name. A volume found under an explicit name without prior state
+ * is reported as unowned and is only adopted with `--adopt`.
+ *
+ * E2B enables volumes per team; on a team without them, a deploy fails
+ * with `VolumesNotEnabled`.
+ *
+ * ### Creating a Volume
+ * **Example:** A shared cache volume
+ * ```typescript
+ * export const Cache = E2B.Volume("Cache", {});
+ * ```
+ *
+ * **Example:** A volume with a fixed name
+ * ```typescript
+ * export const Datasets = E2B.Volume("Datasets", { name: "datasets" });
+ * ```
+ *
+ * ### Mounting a Volume
+ * **Example:** Mount it into a declared sandbox
+ * ```typescript
+ * export const Builder = E2B.Sandbox("Builder", {
+ *   template: Agent,
+ *   mounts: [{ volume: Cache, path: "/cache" }],
+ * });
+ * ```
+ *
+ * **Example:** Mount it into the sandboxes a Worker creates
+ * ```typescript
+ * const cache = yield* E2B.MountVolume(Cache, { path: "/cache" });
+ * const sandboxes = yield* E2B.CreateSandbox(Agent);
+ * // in fetch:
+ * const sandbox = yield* sandboxes.create({ mounts: [cache] });
+ * ```
+ *
+ * ### Reading files from outside a sandbox
+ * **Example:** Read a report the sandbox wrote
+ * ```typescript
+ * const reports = yield* E2B.ReadVolume(Reports);
+ * const report = yield* reports.readFile("/report.json");
+ * ```
+ *
+ * ### Referencing a volume the stack doesn't manage
+ * `E2B.Volume.lookup` finds an existing volume by name. Nothing is created,
+ * adopted or deleted.
+ *
+ * **Example:** Look one up by name
+ * ```typescript
+ * const datasets = E2B.Volume.lookup({ name: "datasets" });
+ * const files = yield* E2B.ReadVolume(datasets);
+ * ```
+ *
+ * @resource
+ * @product Volume
+ */
+export declare const Volume: import("alchemy/Resource").ResourceClass<Volume>;
+export declare const VolumeProvider: () => import("effect/Layer").Layer<Provider.Provider<Volume>, never, import("alchemy/Stack").Stack | import("alchemy/Stage").Stage | volumes.E2BOpContext>;
+//# 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,8BAA8B,CAAC;AAGxD,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAI5C,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,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,MAAO,SAAQ,QAAQ,CACtC,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,KAAK,EACL,SAAS,EACT;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CACjB;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,eAAO,MAAM,MAAM,kDAAiC,CAAC;AAmBrD,eAAO,MAAM,cAAc,4JAuDxB,CAAC"}

package/lib/Volume.js

@@ -0,0 +1,136 @@
+import * as volumes from "@distilled.cloud/e2b/volumes";
+import { Unowned } from "alchemy/AdoptPolicy";
+import { isResolved } from "alchemy/Diff";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Effect from "effect/Effect";
+import { E2BUnexpectedResponse } from "./Errors.js";
+import { e2bName, isGeneratedName } from "./internal/Ownership.js";
+/**
+ * A persistent E2B volume: a team-wide filesystem that sandboxes mount at a
+ * path and that outlives every sandbox using it.
+ *
+ * Declare a volume when every sandbox shares it (a package cache, a
+ * dataset). Per-user and per-session volumes are created at runtime by name
+ * with `E2B.CreateVolume()`, and both kinds mount the same way.
+ *
+ * E2B volumes carry no labels, so Alchemy recognises its volumes by their
+ * generated name. A volume found under an explicit name without prior state
+ * is reported as unowned and is only adopted with `--adopt`.
+ *
+ * E2B enables volumes per team; on a team without them, a deploy fails
+ * with `VolumesNotEnabled`.
+ *
+ * ### Creating a Volume
+ * **Example:** A shared cache volume
+ * ```typescript
+ * export const Cache = E2B.Volume("Cache", {});
+ * ```
+ *
+ * **Example:** A volume with a fixed name
+ * ```typescript
+ * export const Datasets = E2B.Volume("Datasets", { name: "datasets" });
+ * ```
+ *
+ * ### Mounting a Volume
+ * **Example:** Mount it into a declared sandbox
+ * ```typescript
+ * export const Builder = E2B.Sandbox("Builder", {
+ *   template: Agent,
+ *   mounts: [{ volume: Cache, path: "/cache" }],
+ * });
+ * ```
+ *
+ * **Example:** Mount it into the sandboxes a Worker creates
+ * ```typescript
+ * const cache = yield* E2B.MountVolume(Cache, { path: "/cache" });
+ * const sandboxes = yield* E2B.CreateSandbox(Agent);
+ * // in fetch:
+ * const sandbox = yield* sandboxes.create({ mounts: [cache] });
+ * ```
+ *
+ * ### Reading files from outside a sandbox
+ * **Example:** Read a report the sandbox wrote
+ * ```typescript
+ * const reports = yield* E2B.ReadVolume(Reports);
+ * const report = yield* reports.readFile("/report.json");
+ * ```
+ *
+ * ### Referencing a volume the stack doesn't manage
+ * `E2B.Volume.lookup` finds an existing volume by name. Nothing is created,
+ * adopted or deleted.
+ *
+ * **Example:** Look one up by name
+ * ```typescript
+ * const datasets = E2B.Volume.lookup({ name: "datasets" });
+ * const files = yield* E2B.ReadVolume(datasets);
+ * ```
+ *
+ * @resource
+ * @product Volume
+ */
+export const Volume = Resource("E2B.Volume");
+const toAttrs = (volume) => ({
+    volumeId: volume.volumeID,
+    name: volume.name,
+});
+/** The volume with this name, if any. E2B lists a team's volumes in one page. */
+const findByName = (name) => volumes.listVolumes({}).pipe(Effect.map((all) => all.find((volume) => volume.name === name)));
+const observe = (volumeId, name) => volumeId !== undefined
+    ? volumes.getVolume({ volumeID: volumeId }).pipe(Effect.map((volume) => volume), Effect.catchTag("NotFound", () => findByName(name)))
+    : findByName(name);
+export const VolumeProvider = () => Provider.effect(Volume, Effect.gen(function* () {
+    return {
+        stables: ["volumeId", "name"],
+        diff: Effect.fn(function* ({ id, olds, news, output }) {
+            if (!isResolved(news))
+                return undefined;
+            // Only an explicit name can force a rename; a generated name is
+            // engine-owned and never compared against a fresh computation.
+            if (news.name === undefined && olds?.name === undefined)
+                return undefined;
+            const name = output?.name ?? (yield* e2bName(id, olds?.name));
+            if (news.name !== name)
+                return { action: "replace" };
+            return undefined;
+        }),
+        lookup: Effect.fn(function* ({ name }) {
+            const volume = yield* observe(undefined, name);
+            return volume === undefined ? undefined : toAttrs(volume);
+        }),
+        read: Effect.fn(function* ({ id, olds, output }) {
+            const name = output?.name ?? (yield* e2bName(id, olds?.name));
+            const volume = yield* observe(output?.volumeId, name);
+            if (volume === undefined)
+                return undefined;
+            const attrs = toAttrs(volume);
+            return output !== undefined || olds?.name === undefined ? attrs : Unowned(attrs);
+        }),
+        reconcile: Effect.fn(function* ({ id, news, output, session }) {
+            const name = output?.name ?? (yield* e2bName(id, news.name));
+            // Observe
+            const observed = yield* observe(output?.volumeId, name);
+            if (observed !== undefined)
+                return toAttrs(observed);
+            // Ensure — a Conflict is a peer creating the same name: read it back.
+            yield* session.note(`Creating volume ${name}...`);
+            const created = yield* volumes.createVolume({ name }).pipe(Effect.map((volume) => volume), Effect.catchTag("Conflict", () => findByName(name)));
+            if (created === undefined) {
+                return yield* new E2BUnexpectedResponse({
+                    message: `E2B volume ${name} vanished after create`,
+                });
+            }
+            return toAttrs(created);
+        }),
+        delete: Effect.fn(function* ({ output }) {
+            yield* volumes
+                .deleteVolume({ volumeID: output.volumeId })
+                .pipe(Effect.catchTag("NotFound", () => Effect.void));
+        }),
+        list: Effect.fn(function* () {
+            const all = yield* volumes.listVolumes({});
+            return all.filter((volume) => isGeneratedName(volume.name)).map(toAttrs);
+        }),
+    };
+}));
+//# sourceMappingURL=Volume.js.map