@alchemy.run/e2b 0.0.0-stage → 2.0.0-beta.86

package/lib/CreateTemplate.d.ts

@@ -0,0 +1,96 @@
+import type * as tags from "@distilled.cloud/e2b/tags";
+import type * as templates from "@distilled.cloud/e2b/templates";
+import type * as unstable from "@distilled.cloud/e2b/unstable";
+import * as Binding from "alchemy/Binding";
+import type { RuntimeContext } from "alchemy/RuntimeContext";
+import type * as Effect from "effect/Effect";
+import type * as PlatformError from "effect/PlatformError";
+import type { TemplateBuildFailed } from "./Errors.ts";
+import type { TemplateBuildSpec } from "./internal/TemplateBuild.ts";
+import type { E2BError } from "./SandboxClient.ts";
+/**
+ * What a runtime build takes: E2B's own build inputs (a base `image` or
+ * `fromTemplate`, then `env`, `files` and `run` steps), with no Dockerfile.
+ * Files come from memory; there is no build-context directory where a
+ * Worker runs.
+ */
+export type RuntimeTemplateSpec = TemplateBuildSpec;
+/** A built template. */
+export interface TemplateInfo {
+    readonly templateId: string;
+    readonly buildId: string;
+    /** Fully qualified names, e.g. `my-team/my-template:default`. */
+    readonly names: ReadonlyArray<string>;
+}
+/** Errors a runtime build can fail with. */
+export type TemplateBuildError = E2BError | TemplateBuildFailed | PlatformError.PlatformError;
+/** E2B templates: build, look up, tag and delete them at runtime. */
+export interface TemplatesClient {
+    /** Builds a template and waits until it is ready. */
+    build(spec: RuntimeTemplateSpec): Effect.Effect<TemplateInfo, TemplateBuildError, RuntimeContext>;
+    /**
+     * Builds a template unless a ready build of these exact inputs exists.
+     * Each build is tagged with its content hash, so a repeat call is one
+     * lookup.
+     */
+    getOrBuild(spec: RuntimeTemplateSpec): Effect.Effect<TemplateInfo, TemplateBuildError, RuntimeContext>;
+    /** A template by id or name (alias), or `undefined`. */
+    get(nameOrId: string): Effect.Effect<templates.GetTemplateResponse | undefined, E2BError, RuntimeContext>;
+    /** The team's templates. */
+    list(options?: Omit<templates.ListTemplatesRequest, "teamID" | "nextToken">): Effect.Effect<ReadonlyArray<templates.Template>, E2BError, RuntimeContext>;
+    /** E2B's public base templates. */
+    listDefaults(): Effect.Effect<templates.ListDefaultTemplatesResponse, E2BError, RuntimeContext>;
+    /** Templates matching a search. */
+    search(options: unstable.SearchTemplatesRequest): Effect.Effect<unstable.TemplateSearchResponse, E2BError, RuntimeContext>;
+    /** Whether other teams can create sandboxes from the template. */
+    setPublic(templateId: string, isPublic: boolean): Effect.Effect<void, E2BError, RuntimeContext>;
+    /** A build's status, with its newest log lines. */
+    buildStatus(templateId: string, buildId: string, options?: Omit<templates.GetTemplateBuildStatusRequest, "templateID" | "buildID">): Effect.Effect<templates.TemplateBuildInfo, E2BError, RuntimeContext>;
+    /** A build's logs. */
+    buildLogs(templateId: string, buildId: string, options?: Omit<templates.ListTemplateBuildLogsRequest, "templateID" | "buildID">): Effect.Effect<templates.TemplateBuildLogsResponse, E2BError, RuntimeContext>;
+    /** Deletes a template. Deleting one that is gone succeeds. */
+    delete(templateId: string): Effect.Effect<void, E2BError, RuntimeContext>;
+    /** Tags on builds: `name:tag` names a build sandboxes are created from. */
+    readonly tags: {
+        /** Assigns tags to the build `target` (`name:tag` or `name`) points at. */
+        assign(target: string, tags: ReadonlyArray<string>): Effect.Effect<tags.AssignedTemplateTags, E2BError, RuntimeContext>;
+        /** Removes tags from a template by name. */
+        remove(name: string, tags: ReadonlyArray<string>): Effect.Effect<void, E2BError, RuntimeContext>;
+        list(templateId: string): Effect.Effect<tags.ListTemplateTagsResponse, E2BError, RuntimeContext>;
+        exists(templateId: string, tag: string): Effect.Effect<boolean, E2BError, RuntimeContext>;
+        count(templateId: string): Effect.Effect<number, E2BError, RuntimeContext>;
+        groups(templateId: string, options?: Omit<tags.ListTemplateTagGroupsRequest, "templateID">): Effect.Effect<tags.TemplateTagGroupsResponse, E2BError, RuntimeContext>;
+        assignments(templateId: string, tag: string, options?: Omit<tags.ListTemplateTagAssignmentsRequest, "templateID" | "tag">): Effect.Effect<tags.TemplateTagAssignmentsResponse, E2BError, RuntimeContext>;
+    };
+}
+/**
+ * Build E2B templates at runtime from E2B's own build inputs: a template
+ * per repository, per customer image, per agent configuration.
+ * E2B builds remotely, so this works from a Worker.
+ *
+ * Templates built at runtime carry no metadata, so they are not deleted
+ * when the host is destroyed. Delete them with `delete` when their owner
+ * goes away.
+ *
+ * ### Building at runtime
+ * **Example:** A template per repository, built once
+ * ```typescript
+ * const templates = yield* E2B.CreateTemplate();
+ * const sandboxes = yield* E2B.CreateSandbox();
+ * // in fetch:
+ * const template = yield* templates.getOrBuild({
+ *   name: `repo-${slug}`,
+ *   image: "node:22-bookworm",
+ *   files: [{ path: "/home/user/app/package.json", contents: packageJson }],
+ *   run: ["cd /home/user/app && npm install"],
+ * });
+ * const sandbox = yield* sandboxes.create({ templateID: template.templateId });
+ * ```
+ *
+ * @binding
+ * @product Template
+ */
+export interface CreateTemplate extends Binding.Service<CreateTemplate, "E2B.CreateTemplate", () => Effect.Effect<TemplatesClient>> {
+}
+export declare const CreateTemplate: CreateTemplate;
+//# sourceMappingURL=CreateTemplate.d.ts.map

package/lib/CreateTemplate.d.ts.map

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

package/lib/CreateTemplate.js

@@ -0,0 +1,3 @@
+import * as Binding from "alchemy/Binding";
+export const CreateTemplate = Binding.Service("E2B.CreateTemplate");
+//# sourceMappingURL=CreateTemplate.js.map

package/lib/CreateTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateTemplate.js","sources":["../src/CreateTemplate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAmI3C,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAiB,oBAAoB,CAAC,CAAC"}

package/lib/CreateTemplateHttp.d.ts

@@ -0,0 +1,20 @@
+import * as Layer from "effect/Layer";
+import { CreateTemplate } from "./CreateTemplate.ts";
+/**
+ * HTTP implementation of {@link CreateTemplate}. Works on any host.
+ *
+ * ### Provide the layer
+ * **Example:** On a Worker
+ * ```typescript
+ * Effect.gen(function* () {
+ *   const templates = yield* E2B.CreateTemplate();
+ *   // ...
+ * }).pipe(Effect.provide(E2B.CreateTemplateHttp))
+ * ```
+ *
+ * @layer
+ * @product Template
+ * @provides E2B.CreateTemplate
+ */
+export declare const CreateTemplateHttp: Layer.Layer<CreateTemplate, never, never>;
+//# sourceMappingURL=CreateTemplateHttp.d.ts.map

package/lib/CreateTemplateHttp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateTemplateHttp.d.ts","sources":["../src/CreateTemplateHttp.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,EACL,cAAc,EAIf,MAAM,qBAAqB,CAAC;AAO7B;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,kBAAkB,2CAqH9B,CAAC"}

package/lib/CreateTemplateHttp.js

@@ -0,0 +1,99 @@
+import * as tags from "@distilled.cloud/e2b/tags";
+import * as templates from "@distilled.cloud/e2b/templates";
+import * as unstable from "@distilled.cloud/e2b/unstable";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Stream from "effect/Stream";
+import { CreateTemplate, } from "./CreateTemplate.js";
+import { bindE2B } from "./E2BBindings.js";
+import { planTemplateBuild, runTemplateBuild } from "./internal/TemplateBuild.js";
+/** The tag a build of these inputs carries. */
+const hashTag = (hash) => `alchemy-${hash.slice(0, 16)}`;
+/**
+ * HTTP implementation of {@link CreateTemplate}. Works on any host.
+ *
+ * ### Provide the layer
+ * **Example:** On a Worker
+ * ```typescript
+ * Effect.gen(function* () {
+ *   const templates = yield* E2B.CreateTemplate();
+ *   // ...
+ * }).pipe(Effect.provide(E2B.CreateTemplateHttp))
+ * ```
+ *
+ * @layer
+ * @product Template
+ * @provides E2B.CreateTemplate
+ */
+export const CreateTemplateHttp = Layer.succeed(CreateTemplate, Effect.fn("E2B.CreateTemplate")(function* () {
+    const auth = yield* bindE2B;
+    const get = (nameOrId) => auth
+        .authorize(templates
+        .getTemplate({ templateID: nameOrId })
+        .pipe(Effect.catchTag("NotFound", () => templates
+        .getTemplateByAlias({ alias: nameOrId })
+        .pipe(Effect.flatMap((alias) => templates.getTemplate({ templateID: alias.templateID }))))))
+        .pipe(Effect.map((template) => template), Effect.catchTag("NotFound", () => Effect.undefined));
+    const build = Effect.fn("E2B.CreateTemplate.build")(function* (spec) {
+        const plan = yield* planTemplateBuild(spec);
+        const built = yield* auth.authorize(
+        // E2B builds the `default` tag only when no tags are given, so keep it
+        // next to the hash tag unless the caller chose its own.
+        runTemplateBuild({ ...spec, tags: [...(spec.tags ?? ["default"]), hashTag(plan.hash)] }, plan));
+        return {
+            templateId: built.templateId,
+            buildId: built.buildId,
+            names: built.names,
+        };
+    });
+    const client = {
+        build,
+        getOrBuild: Effect.fn("E2B.CreateTemplate.getOrBuild")(function* (spec) {
+            const plan = yield* planTemplateBuild(spec);
+            const existing = yield* get(spec.name);
+            if (existing !== undefined) {
+                const tagged = yield* auth.authorize(tags.getTemplateTagExists({ templateID: existing.templateID, tag: hashTag(plan.hash) }));
+                const ready = existing.builds.find((b) => b.buildID === existing.buildID)?.status === "ready";
+                if (tagged.exists && ready) {
+                    return {
+                        templateId: existing.templateID,
+                        buildId: existing.buildID,
+                        names: existing.names,
+                    };
+                }
+            }
+            return yield* build(spec);
+        }),
+        get,
+        list: (options) => auth
+            .authorize(Stream.runCollect(templates.listTemplates.items({ ...options })))
+            .pipe(Effect.map((all) => Array.from(all))),
+        listDefaults: () => auth.authorize(templates.listDefaultTemplates({})),
+        search: (options) => auth.authorize(unstable.searchTemplates(options)),
+        setPublic: (templateId, isPublic) => auth
+            .authorize(templates.updateTemplate({ templateID: templateId, public: isPublic }))
+            .pipe(Effect.asVoid),
+        buildStatus: (templateId, buildId, options) => auth.authorize(templates.getTemplateBuildStatus({
+            ...options,
+            templateID: templateId,
+            buildID: buildId,
+        })),
+        buildLogs: (templateId, buildId, options) => auth.authorize(templates.listTemplateBuildLogs({ ...options, templateID: templateId, buildID: buildId })),
+        delete: (templateId) => auth.authorize(templates.deleteTemplate({ templateID: templateId })).pipe(Effect.asVoid, Effect.catchTag("NotFound", () => Effect.void)),
+        tags: {
+            assign: (target, assigned) => auth.authorize(tags.createTemplateTag({ target, tags: [...assigned] })),
+            remove: (name, removed) => auth.authorize(tags.deleteTemplateTags({ name, tags: [...removed] })).pipe(Effect.asVoid),
+            list: (templateId) => auth.authorize(tags.listTemplateTags({ templateID: templateId })),
+            exists: (templateId, tag) => auth
+                .authorize(tags.getTemplateTagExists({ templateID: templateId, tag }))
+                .pipe(Effect.map((res) => res.exists)),
+            count: (templateId) => auth
+                .authorize(tags.getTemplateTagCount({ templateID: templateId }))
+                .pipe(Effect.map((res) => res.total)),
+            groups: (templateId, options) => auth.authorize(tags.listTemplateTagGroups({ ...options, templateID: templateId })),
+            assignments: (templateId, tag, options) => auth.authorize(tags.listTemplateTagAssignments({ ...options, templateID: templateId, tag })),
+        },
+    };
+    return client;
+}));
+//# sourceMappingURL=CreateTemplateHttp.js.map

package/lib/CreateTemplateHttp.js.map

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

package/lib/CreateVolume.d.ts

@@ -0,0 +1,58 @@
+import * as Binding from "alchemy/Binding";
+import type { RuntimeContext } from "alchemy/RuntimeContext";
+import type * as Effect from "effect/Effect";
+import type { E2BError } from "./SandboxClient.ts";
+import type { ReadWriteVolumeClient } from "./VolumeFiles.ts";
+/** A volume created or found at runtime, with its files. */
+export interface VolumeHandle {
+    /** E2B's volume id. */
+    readonly volumeId: string;
+    /** The volume's name. Mount it with `mounts: [{ volume, path }]`. */
+    readonly name: string;
+    /** The volume's files, readable and writable without a sandbox. */
+    readonly files: ReadWriteVolumeClient;
+}
+/** E2B volumes by name: create, look up, list and delete them. */
+export interface VolumesClient {
+    /** Creates a volume. Fails with `Conflict` when the name is taken. */
+    create(name: string): Effect.Effect<VolumeHandle, E2BError, RuntimeContext>;
+    /** The volume with this name or id, or `undefined`. */
+    get(nameOrId: string): Effect.Effect<VolumeHandle | undefined, E2BError, RuntimeContext>;
+    /** The volume with this name, created if missing. Safe to race. */
+    getOrCreate(name: string): Effect.Effect<VolumeHandle, E2BError, RuntimeContext>;
+    /** Every volume in the team. */
+    list(): Effect.Effect<ReadonlyArray<{
+        readonly volumeId: string;
+        readonly name: string;
+    }>, E2BError, RuntimeContext>;
+    /** Deletes a volume and its files. Deleting one that is gone succeeds. */
+    delete(volumeId: string): Effect.Effect<void, E2BError, RuntimeContext>;
+}
+/**
+ * Create and manage E2B volumes at runtime, by name: a home directory per
+ * user, a workspace per session. Mount one into a sandbox by its `name`, and
+ * read or write its files with `files` without a sandbox.
+ *
+ * E2B volumes carry no metadata, so the volumes a host creates at runtime
+ * are not deleted when the host is destroyed. Delete them with `delete` when
+ * their owner goes away.
+ *
+ * ### Per-user volumes
+ * **Example:** A home volume per user, mounted into their sandbox
+ * ```typescript
+ * const volumes = yield* E2B.CreateVolume();
+ * const sandboxes = yield* E2B.CreateSandbox(Agent);
+ * // in fetch:
+ * const home = yield* volumes.getOrCreate(`user-${user}`);
+ * const sandbox = yield* sandboxes.create({
+ *   mounts: [{ volume: home, path: "/home/user/work" }],
+ * });
+ * ```
+ *
+ * @binding
+ * @product Volume
+ */
+export interface CreateVolume extends Binding.Service<CreateVolume, "E2B.CreateVolume", () => Effect.Effect<VolumesClient>> {
+}
+export declare const CreateVolume: CreateVolume;
+//# sourceMappingURL=CreateVolume.d.ts.map

package/lib/CreateVolume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateVolume.d.ts","sources":["../src/CreateVolume.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;CACvC;AAED,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC5E,uDAAuD;IACvD,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,GAAG,SAAS,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IACzF,mEAAmE;IACnE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IACjF,gCAAgC;IAChC,IAAI,IAAI,MAAM,CAAC,MAAM,CACnB,aAAa,CAAC;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,EACnE,QAAQ,EACR,cAAc,CACf,CAAC;IACF,0EAA0E;IAC1E,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;CACzE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,YAAa,SAAQ,OAAO,CAAC,OAAO,CACnD,YAAY,EACZ,kBAAkB,EAClB,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CACnC;CAAG;AAEJ,eAAO,MAAM,YAAY,cAAoD,CAAC"}

package/lib/CreateVolume.js

@@ -0,0 +1,3 @@
+import * as Binding from "alchemy/Binding";
+export const CreateVolume = Binding.Service("E2B.CreateVolume");
+//# sourceMappingURL=CreateVolume.js.map

package/lib/CreateVolume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateVolume.js","sources":["../src/CreateVolume.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAgE3C,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAe,kBAAkB,CAAC,CAAC"}

package/lib/CreateVolumeHttp.d.ts

@@ -0,0 +1,20 @@
+import * as Layer from "effect/Layer";
+import { CreateVolume } from "./CreateVolume.ts";
+/**
+ * HTTP implementation of {@link CreateVolume}. Works on any host.
+ *
+ * ### Provide the layer
+ * **Example:** On a Worker
+ * ```typescript
+ * Effect.gen(function* () {
+ *   const volumes = yield* E2B.CreateVolume();
+ *   // ...
+ * }).pipe(Effect.provide(E2B.CreateVolumeHttp))
+ * ```
+ *
+ * @layer
+ * @product Volume
+ * @provides E2B.CreateVolume
+ */
+export declare const CreateVolumeHttp: Layer.Layer<CreateVolume, never, never>;
+//# sourceMappingURL=CreateVolumeHttp.d.ts.map

package/lib/CreateVolumeHttp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateVolumeHttp.d.ts","sources":["../src/CreateVolumeHttp.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,YAAY,EAAyC,MAAM,mBAAmB,CAAC;AAUxF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB,yCAkD5B,CAAC"}

package/lib/CreateVolumeHttp.js

@@ -0,0 +1,51 @@
+import * as volumes from "@distilled.cloud/e2b/volumes";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { CreateVolume } from "./CreateVolume.js";
+import { bindE2B } from "./E2BBindings.js";
+import { makeVolumeFiles } from "./internal/VolumeHttp.js";
+const handleOf = (auth, volume) => ({
+    volumeId: volume.volumeID,
+    name: volume.name,
+    files: makeVolumeFiles(auth, Effect.succeed(volume.volumeID)),
+});
+/**
+ * HTTP implementation of {@link CreateVolume}. Works on any host.
+ *
+ * ### Provide the layer
+ * **Example:** On a Worker
+ * ```typescript
+ * Effect.gen(function* () {
+ *   const volumes = yield* E2B.CreateVolume();
+ *   // ...
+ * }).pipe(Effect.provide(E2B.CreateVolumeHttp))
+ * ```
+ *
+ * @layer
+ * @product Volume
+ * @provides E2B.CreateVolume
+ */
+export const CreateVolumeHttp = Layer.succeed(CreateVolume, Effect.fn("E2B.CreateVolume")(function* () {
+    const auth = yield* bindE2B;
+    const findByName = (name) => auth
+        .authorize(volumes.listVolumes({}))
+        .pipe(Effect.map((all) => all.find((volume) => volume.name === name)));
+    const get = (nameOrId) => auth.authorize(volumes.getVolume({ volumeID: nameOrId })).pipe(Effect.map((volume) => volume), Effect.catchTag("NotFound", () => findByName(nameOrId)), Effect.map((volume) => (volume === undefined ? undefined : handleOf(auth, volume))));
+    const client = {
+        create: (name) => auth
+            .authorize(volumes.createVolume({ name }))
+            .pipe(Effect.map((volume) => handleOf(auth, volume))),
+        get,
+        getOrCreate: (name) => Effect.flatMap(get(name), (existing) => existing !== undefined
+            ? Effect.succeed(existing)
+            : auth.authorize(volumes.createVolume({ name })).pipe(Effect.map((volume) => handleOf(auth, volume)), 
+            // A concurrent create won the name: use theirs.
+            Effect.catchTag("Conflict", (error) => Effect.flatMap(get(name), (raced) => raced === undefined ? Effect.fail(error) : Effect.succeed(raced))))),
+        list: () => auth
+            .authorize(volumes.listVolumes({}))
+            .pipe(Effect.map((all) => all.map((volume) => ({ volumeId: volume.volumeID, name: volume.name })))),
+        delete: (volumeId) => auth.authorize(volumes.deleteVolume({ volumeID: volumeId })).pipe(Effect.asVoid, Effect.catchTag("NotFound", () => Effect.void)),
+    };
+    return client;
+}));
+//# sourceMappingURL=CreateVolumeHttp.js.map

package/lib/CreateVolumeHttp.js.map

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

package/lib/Credentials.d.ts

@@ -0,0 +1,18 @@
+import { ConfigError } from "@distilled.cloud/core/errors";
+import { Credentials, type Config } from "@distilled.cloud/e2b/Credentials";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+export { Credentials, CredentialsFromEnv, credentials, DEFAULT_DOMAIN, type Config as CredentialsConfig, } from "@distilled.cloud/e2b/Credentials";
+/**
+ * Fills in the team id for an access token that came without one: E2B
+ * lists the token's teams, and the default team is the one it acts on.
+ */
+export declare const withTeamId: (config: Config) => Effect.Effect<Config, ConfigError, never>;
+/**
+ * Build a `Credentials` layer that resolves E2B credentials via the current
+ * Alchemy profile, or directly from environment variables in CI. An access
+ * token without a team id gets its default team's id. A browser login's
+ * token is re-resolved (and refreshed) before it expires.
+ */
+export declare const fromAuthProvider: () => Layer.Layer<Credentials, never, import("alchemy/Auth/Registry").AuthProviders | import("alchemy/Auth/Profile").ProfileStore>;
+//# sourceMappingURL=Credentials.d.ts.map

package/lib/Credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Credentials.d.ts","sources":["../src/Credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,EAEL,WAAW,EAEX,KAAK,MAAM,EACZ,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,KAAK,MAAM,IAAI,iBAAiB,GACjC,MAAM,kCAAkC,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,UAAU,+DAqBrB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,oIAyB1B,CAAC"}

package/lib/Credentials.js

@@ -0,0 +1,55 @@
+import { ConfigError } from "@distilled.cloud/core/errors";
+import * as auth from "@distilled.cloud/e2b/auth";
+import { apiBaseUrlFor, Credentials, credentials, } from "@distilled.cloud/e2b/Credentials";
+import { lazyCredentials } from "alchemy/Auth/Resolve";
+import * as Effect from "effect/Effect";
+import * as FetchHttpClient from "effect/http/FetchHttpClient";
+import * as Layer from "effect/Layer";
+import { E2B_AUTH_PROVIDER_NAME } from "./AuthProvider.js";
+export { Credentials, CredentialsFromEnv, credentials, DEFAULT_DOMAIN, } from "@distilled.cloud/e2b/Credentials";
+/**
+ * Fills in the team id for an access token that came without one: E2B
+ * lists the token's teams, and the default team is the one it acts on.
+ */
+export const withTeamId = Effect.fn(function* (config) {
+    if (config.accessToken === undefined || (config.teamId ?? "") !== "")
+        return config;
+    const teams = yield* auth.listTeams({}).pipe(Effect.provide(Layer.mergeAll(credentials(config), FetchHttpClient.layer)), Effect.mapError((cause) => new ConfigError({
+        message: `Failed to look up the E2B team for the access token: ${cause.message}`,
+    })));
+    const team = teams.find((t) => t.isDefault) ?? (teams.length === 1 ? teams[0] : undefined);
+    if (team === undefined) {
+        return yield* new ConfigError({
+            message: teams.length === 0
+                ? "The E2B access token belongs to no team"
+                : `The E2B access token belongs to ${teams.length} teams and none is the default: set teamId (E2B_TEAM_ID)`,
+        });
+    }
+    return { ...config, teamId: team.teamID };
+});
+/**
+ * Build a `Credentials` layer that resolves E2B credentials via the current
+ * Alchemy profile, or directly from environment variables in CI. An access
+ * token without a team id gets its default team's id. A browser login's
+ * token is re-resolved (and refreshed) before it expires.
+ */
+export const fromAuthProvider = () => Layer.effect(Credentials, Effect.gen(function* () {
+    const resolve = yield* lazyCredentials()(E2B_AUTH_PROVIDER_NAME, (creds) => ({
+        ...(creds.apiKey === undefined ? {} : { apiKey: creds.apiKey }),
+        ...(creds.accessToken === undefined ? {} : { accessToken: creds.accessToken }),
+        ...(creds.teamId === undefined ? {} : { teamId: creds.teamId }),
+        domain: creds.domain,
+        apiBaseUrl: apiBaseUrlFor(creds.domain),
+    }), { expiresAt: (creds) => creds.expires });
+    // The team lookup runs once; a failed one is retried on the next call.
+    let teamId;
+    return Effect.gen(function* () {
+        const config = yield* resolve;
+        if (teamId !== undefined && (config.teamId ?? "") === "")
+            return { ...config, teamId };
+        const withTeam = yield* withTeamId(config);
+        teamId = withTeam.teamId;
+        return withTeam;
+    });
+}));
+//# sourceMappingURL=Credentials.js.map

package/lib/Credentials.js.map

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

package/lib/E2BBindings.d.ts

@@ -0,0 +1,35 @@
+import { Credentials } from "@distilled.cloud/e2b/Credentials";
+import * as Output from "alchemy/Output";
+import type { RuntimeContext } from "alchemy/RuntimeContext";
+import * as Effect from "effect/Effect";
+import type * as HttpClient from "effect/http/HttpClient";
+/** The `alchemy::*` metadata on objects a host creates at run time. */
+export type OwnerTags = Readonly<Record<string, string>>;
+/** E2B's `metadata` filter: `key=value&…`. */
+export declare const metadataQuery: (metadata: Readonly<Record<string, string>>) => string;
+export interface E2BAuth {
+    /** Runs a distilled call with the bound credentials and an HTTP client. */
+    readonly authorize: <A, E>(effect: Effect.Effect<A, E, Credentials | HttpClient.HttpClient>) => Effect.Effect<A, E, RuntimeContext>;
+    /** The E2B domain sandboxes are addressed under. */
+    readonly domain: Effect.Effect<string>;
+    /** The team the host's key belongs to. */
+    readonly teamId: Effect.Effect<string>;
+}
+/**
+ * Mints the current host's API key and binds it, the domain and the
+ * ownership stamp onto the host, and returns runtime accessors for them.
+ * Call it in a binding's construction; every binding on a host shares the
+ * one key.
+ */
+export declare const bindE2B: Effect.Effect<{
+    authorize: <A, E>(effect: Effect.Effect<A, E, Credentials | HttpClient.HttpClient>) => Effect.Effect<A, E, never>;
+    domain: Effect.Effect<string, never, never>;
+    teamId: Output.Accessor<string>;
+}, never, never>;
+/**
+ * Binds the host's `alchemy::stack` / `alchemy::stage` / `alchemy::id` into
+ * it, and returns them at run time for `create` to put on what it makes.
+ * Without a host (a script) there are none.
+ */
+export declare const bindOwnerTags: Effect.Effect<Effect.Effect<Readonly<Record<string, string>>, never, never>, never, never>;
+//# sourceMappingURL=E2BBindings.d.ts.map

package/lib/E2BBindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"E2BBindings.d.ts","sources":["../src/E2BBindings.ts"],"names":[],"mappings":"AAmBA,OAAO,EAEL,WAAW,EAGZ,MAAM,kCAAkC,CAAC;AAI1C,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,KAAK,UAAU,MAAM,wBAAwB,CAAC;AAU1D,uEAAuE;AACvE,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEzD,8CAA8C;AAC9C,eAAO,MAAM,aAAa,aAAc,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,WACd,CAAC;AAE3D,MAAM,WAAW,OAAO;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,UAAU,CAAC,KAC7D,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,cAAc,CAAC,CAAC;IACzC,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvC,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;CACxC;AAsBD;;;;;GAKG;AACH,eAAO,MAAM,OAAO;gBAnCG,CAAC,EAAE,CAAC;;;gBAyEzB,CAAC;AAUH;;;;GAIG;AACH,eAAO,MAAM,aAAa,4FAkBxB,CAAC"}