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

package/lib/Sandbox.js

@@ -0,0 +1,351 @@
+import { Credentials } from "@distilled.cloud/e2b/Credentials";
+import * as sandboxes from "@distilled.cloud/e2b/sandboxes";
+import { Unowned } from "alchemy/AdoptPolicy";
+import { isResolved } from "alchemy/Diff";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import * as Stream from "effect/Stream";
+import { E2BUnexpectedResponse } from "./Errors.js";
+import { declarable } from "./internal/Declared.js";
+import { hasOwnershipMetadata, ownershipMetadata, userMetadata } from "./internal/Ownership.js";
+import { denyUnlisted } from "./internal/SandboxHandle.js";
+/**
+ * An E2B sandbox the stack owns: one long-lived sandbox that pauses when it
+ * is idle and resumes when it is used, instead of one per request.
+ *
+ * Use it for a workspace that outlives requests (an agent's home, a dev
+ * box) or to serve a template program at a stable URL. The sandbox runs for
+ * `timeout` after it starts or resumes, then E2B pauses it with its memory
+ * and files. A request to one of its URLs resumes it (`autoResume`), and so
+ * does `resume()` on `E2B.ConnectSandbox`.
+ *
+ * Alchemy stamps its stack, stage and logical ID into the sandbox's
+ * metadata to recognise the sandboxes it owns.
+ *
+ * :::caution
+ * Replacing the sandbox (a new or rebuilt `template`, or new `env`,
+ * `metadata`, `mounts`, `memory`, `autoResume`, `allowPublicTraffic`,
+ * `maskRequestHost` or `httpsPorts`) starts a
+ * fresh sandbox and kills the old one with its files. If E2B no longer has
+ * the sandbox, the next deploy that updates it (or `alchemy drift`) creates
+ * a new one.
+ * :::
+ *
+ * ### Creating a Sandbox
+ * **Example:** A dev box from a template
+ * ```typescript
+ * import * as E2B from "@alchemy.run/e2b";
+ * import * as Effect from "effect/Effect";
+ *
+ * export const Node = E2B.Template("Node", { image: "node:22" });
+ *
+ * export const DevBox = E2B.Sandbox("DevBox", {
+ *   template: Node,
+ *   timeout: "10 minutes",
+ * });
+ * ```
+ *
+ * ### Serving a template program
+ * A template program starts when its sandbox boots. Declare one sandbox for
+ * it: each new build of the program replaces the sandbox, so it always runs
+ * the current one.
+ *
+ * **Example:** The program at a stable URL
+ * ```typescript
+ * import * as E2B from "@alchemy.run/e2b";
+ * import * as Output from "alchemy/Output";
+ * import * as Effect from "effect/Effect";
+ * import Api from "./src/api.ts";
+ *
+ * export const ApiSandbox = Effect.gen(function* () {
+ *   const sandbox = yield* E2B.Sandbox("Api", { template: Api });
+ *   return { url: Output.interpolate`https://3000-${sandbox.sandboxId}.${sandbox.domain}` };
+ * });
+ * ```
+ *
+ * ### Private URLs
+ * **Example:** Require the traffic token
+ * ```typescript
+ * const sandbox = yield* E2B.Sandbox("Private", {
+ *   template: Node,
+ *   network: { allowPublicTraffic: false },
+ * });
+ * // send sandbox.trafficAccessToken in the `e2b-traffic-access-token` header
+ * ```
+ *
+ * ### Egress through your own proxy
+ * E2B sends the sandbox's outbound TCP through a SOCKS5 proxy you run,
+ * after its allow and deny rules. Code in the sandbox can't tell, and
+ * can't go around it.
+ *
+ * **Example:** A proxy over TLS, with a password
+ * ```typescript
+ * import * as E2B from "@alchemy.run/e2b";
+ * import * as Config from "effect/Config";
+ * import { Node } from "./Node.ts";
+ *
+ * export const Proxied = E2B.Sandbox("Proxied", {
+ *   template: Node,
+ *   network: {
+ *     egressProxy: {
+ *       address: "proxy.example.com:1080",
+ *       username: "sandbox",
+ *       password: Config.Redacted("PROXY_PASSWORD"),
+ *       tls: { enabled: true },
+ *     },
+ *   },
+ * });
+ * ```
+ *
+ * ### Using it at runtime
+ * **Example:** Run a command in it from a Worker
+ * ```typescript
+ * const devBox = yield* E2B.ConnectSandbox(DevBox);
+ * // in fetch:
+ * yield* devBox.resume();
+ * const result = yield* devBox.exec("git pull && npm test", { cwd: "/home/user/repo" });
+ * ```
+ *
+ * ### Mounting volumes
+ * **Example:** A shared cache volume
+ * ```typescript
+ * export const Cache = E2B.Volume("Cache", {});
+ *
+ * export const Builder = E2B.Sandbox("Builder", {
+ *   template: Node,
+ *   mounts: [{ volume: Cache, path: "/cache" }],
+ * });
+ * ```
+ *
+ * ### Referencing a sandbox the stack doesn't manage
+ * **Example:** Look one up by id
+ * ```typescript
+ * const shared = E2B.Sandbox.lookup({ sandboxId: "i1a2b3c4d5e6f7g8h9" });
+ * const box = yield* E2B.ConnectSandbox(shared);
+ * ```
+ *
+ * @resource
+ * @product Sandbox
+ */
+export const Sandbox = declarable()(Resource("E2B.Sandbox"));
+const DEFAULT_TIMEOUT_SECONDS = 300;
+const secondsOf = (timeout) => timeout === undefined
+    ? DEFAULT_TIMEOUT_SECONDS
+    : Math.max(1, Math.round(Duration.toMillis(Duration.fromInputUnsafe(timeout)) / 1000));
+const redact = (token) => token === undefined || token === null
+    ? undefined
+    : Redacted.isRedacted(token)
+        ? token
+        : Redacted.make(token);
+/** The E2B domain the credentials address; sandboxes on it report no domain of their own. */
+const configuredDomain = Effect.gen(function* () {
+    const credentials = yield* Credentials;
+    return (yield* credentials).domain;
+});
+/** A sandbox's details, or `undefined` when E2B no longer has it. */
+const observeSandbox = (sandboxId) => sandboxes.getSandbox({ sandboxID: sandboxId }).pipe(Effect.map((detail) => detail), Effect.catchTag("NotFound", () => Effect.undefined));
+const toAttributes = (detail, stored, fallbackDomain) => ({
+    sandboxId: detail.sandboxID,
+    templateId: detail.templateID,
+    templateBuild: stored.templateBuild,
+    mounts: stored.mounts,
+    domain: detail.domain ?? fallbackDomain,
+    trafficAccessToken: stored.trafficAccessToken,
+    metadata: userMetadata(detail.metadata),
+    cpuCount: detail.cpuCount,
+    memoryMB: detail.memoryMB,
+});
+/** The network fields `updateSandboxNetwork` can change, as E2B stores them. */
+const mutableNetwork = (network) => {
+    const desired = network === undefined ? {} : denyUnlisted(network);
+    return {
+        allowOut: [...(desired.allowOut ?? [])].sort(),
+        denyOut: [...(desired.denyOut ?? [])].sort(),
+        dnsServers: desired.dnsServers === undefined ? undefined : [...desired.dnsServers].sort(),
+        rules: desired.rules ?? {},
+        egressProxy: proxyIdentity(desired.egressProxy),
+    };
+};
+const plain = (value) => Redacted.isRedacted(value) ? Redacted.value(value) : value;
+/** An egress proxy without its password, which E2B never returns. */
+const proxyIdentity = (proxy) => proxy === undefined || proxy === null
+    ? undefined
+    : {
+        address: proxy.address,
+        username: proxy.username ?? undefined,
+        tls: proxy.tls?.enabled
+            ? {
+                serverName: proxy.tls.serverName ?? undefined,
+                caCert: proxy.tls.caCert ?? undefined,
+            }
+            : undefined,
+    };
+const sameJson = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+/** The template's mounts and the sandbox's own, by path (the sandbox's win). */
+const mountsOf = (props) => [
+    ...new Map([...(props.template.mounts ?? []), ...(props.mounts ?? [])].map((mount) => [mount.path, { volume: { name: mount.volume.name }, path: mount.path }])).values(),
+].sort((a, b) => a.path.localeCompare(b.path));
+const templateBuildOf = (props) => props.template.buildId ?? props.template.setupHash;
+/** Props whose change means a new sandbox (E2B can't change them on a live one). */
+const replacingProps = (props) => ({
+    template: props.template.templateId,
+    build: templateBuildOf(props),
+    autoResume: props.autoResume ?? true,
+    memory: props.memory ?? true,
+    env: props.env ?? {},
+    metadata: props.metadata ?? {},
+    mounts: mountsOf(props),
+    allowPublicTraffic: props.network?.allowPublicTraffic ?? true,
+    maskRequestHost: props.network?.maskRequestHost,
+    httpsPorts: [...(props.network?.httpsPorts ?? [])].sort((a, b) => a - b),
+});
+export const SandboxProvider = () => Provider.effect(Sandbox, Effect.gen(function* () {
+    return {
+        stables: ["sandboxId", "templateId", "domain"],
+        diff: Effect.fn(function* ({ news, olds }) {
+            if (!isResolved(news) || olds === undefined)
+                return undefined;
+            if (!sameJson(replacingProps(olds), replacingProps(news))) {
+                return { action: "replace" };
+            }
+            return undefined;
+        }),
+        read: Effect.fn(function* ({ id, output }) {
+            if (output === undefined)
+                return undefined;
+            const detail = yield* observeSandbox(output.sandboxId);
+            if (detail === undefined)
+                return undefined;
+            const attrs = toAttributes(detail, output, yield* configuredDomain);
+            const ours = yield* hasOwnershipMetadata(id, detail.metadata);
+            return ours ? attrs : Unowned(attrs);
+        }),
+        lookup: Effect.fn(function* ({ sandboxId }) {
+            const detail = yield* observeSandbox(sandboxId);
+            if (detail === undefined)
+                return undefined;
+            return toAttributes(detail, { templateBuild: undefined, trafficAccessToken: undefined, mounts: [] }, yield* configuredDomain);
+        }),
+        reconcile: Effect.fn(function* ({ id, news, olds, output, session }) {
+            const timeout = secondsOf(news.timeout);
+            const memory = news.memory ?? true;
+            const autoResume = news.autoResume ?? true;
+            const mounts = mountsOf(news);
+            const templateBuild = templateBuildOf(news);
+            // Observe — `output` caches the id; the sandbox may be gone.
+            let detail = output === undefined ? undefined : yield* observeSandbox(output.sandboxId);
+            let trafficAccessToken = output?.trafficAccessToken;
+            // Ensure
+            if (detail === undefined) {
+                yield* session.note(`Creating sandbox from ${news.template.templateId}...`);
+                const created = yield* sandboxes.createSandbox({
+                    templateID: news.template.templateId,
+                    timeout,
+                    autoPause: true,
+                    autoPauseMemory: memory,
+                    autoResume: { enabled: autoResume },
+                    metadata: { ...news.metadata, ...(yield* ownershipMetadata(id)) },
+                    ...(news.env === undefined ? {} : { envVars: news.env }),
+                    ...(news.network === undefined ? {} : { network: denyUnlisted(news.network) }),
+                    ...(mounts.length === 0
+                        ? {}
+                        : {
+                            volumeMounts: mounts.map((mount) => ({
+                                name: mount.volume.name,
+                                path: mount.path,
+                            })),
+                        }),
+                });
+                trafficAccessToken = redact(created.trafficAccessToken);
+                detail = yield* observeSandbox(created.sandboxID);
+                if (detail === undefined) {
+                    return yield* new E2BUnexpectedResponse({
+                        message: `E2B sandbox ${created.sandboxID} vanished after create`,
+                    });
+                }
+                return toAttributes(detail, { templateBuild, trafficAccessToken, mounts }, created.domain ?? (yield* configuredDomain));
+            }
+            // Sync — egress rules, observed against what E2B stores.
+            const desiredNetwork = mutableNetwork(news.network);
+            const observedNetwork = mutableNetwork(detail.network);
+            const dnsMatches = desiredNetwork.dnsServers === undefined ||
+                sameJson(desiredNetwork.dnsServers, observedNetwork.dnsServers);
+            if (!sameJson(desiredNetwork.allowOut, observedNetwork.allowOut) ||
+                !sameJson(desiredNetwork.denyOut, observedNetwork.denyOut) ||
+                !sameJson(desiredNetwork.rules, observedNetwork.rules) ||
+                !sameJson(desiredNetwork.egressProxy, observedNetwork.egressProxy) ||
+                // The proxy's password can't be observed, so `olds` is the only
+                // signal it changed.
+                (olds !== undefined &&
+                    plain(olds.network?.egressProxy?.password) !==
+                        plain(news.network?.egressProxy?.password)) ||
+                !dnsMatches) {
+                yield* session.note(`Updating sandbox ${detail.sandboxID} network...`);
+                yield* sandboxes.updateSandboxNetwork({
+                    sandboxID: detail.sandboxID,
+                    allowOut: desiredNetwork.allowOut,
+                    denyOut: desiredNetwork.denyOut,
+                    rules: desiredNetwork.rules,
+                    // An update replaces the whole configuration: a field left
+                    // out is cleared.
+                    ...(news.network?.egressProxy === undefined
+                        ? {}
+                        : { egressProxy: news.network.egressProxy }),
+                    ...(desiredNetwork.dnsServers === undefined
+                        ? {}
+                        : { dnsServers: desiredNetwork.dnsServers }),
+                });
+            }
+            // Sync — the run's timeout. E2B doesn't report the configured
+            // timeout, so `olds` is the only signal it changed.
+            if (olds !== undefined && secondsOf(olds.timeout) !== timeout) {
+                if (detail.state === "paused") {
+                    // Resuming takes the new timeout; the sandbox pauses again after it.
+                    const resumed = yield* sandboxes.connectSandbox({
+                        sandboxID: detail.sandboxID,
+                        timeout,
+                    });
+                    trafficAccessToken = redact(resumed.trafficAccessToken) ?? trafficAccessToken;
+                }
+                else {
+                    yield* sandboxes.setSandboxTimeout({ sandboxID: detail.sandboxID, timeout });
+                }
+            }
+            return toAttributes(detail, { templateBuild, trafficAccessToken, mounts }, yield* configuredDomain);
+        }),
+        delete: Effect.fn(function* ({ output }) {
+            yield* sandboxes
+                .deleteSandbox({ sandboxID: output.sandboxId })
+                .pipe(Effect.catchTag("NotFound", () => Effect.void));
+        }),
+        list: Effect.fn(function* () {
+            const domain = yield* configuredDomain;
+            const all = Array.from(yield* Stream.runCollect(sandboxes.listSandboxes.items({
+                state: ["running", "paused"],
+                limit: 100,
+            })));
+            return (all
+                // Declared sandboxes and the ones bindings create at run time
+                // both carry `alchemy::stack`, so `nuke` finds both.
+                .filter((sandbox) => sandbox.metadata?.["alchemy::stack"] !== undefined)
+                .map((sandbox) => ({
+                sandboxId: sandbox.sandboxID,
+                templateId: sandbox.templateID,
+                templateBuild: undefined,
+                mounts: (sandbox.volumeMounts ?? []).map((mount) => ({
+                    volume: { name: mount.name },
+                    path: mount.path,
+                })),
+                domain,
+                trafficAccessToken: undefined,
+                metadata: userMetadata(sandbox.metadata),
+                cpuCount: sandbox.cpuCount,
+                memoryMB: sandbox.memoryMB,
+            })));
+        }),
+    };
+}));
+//# sourceMappingURL=Sandbox.js.map

package/lib/Sandbox.js.map

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

package/lib/SandboxClient.d.ts

@@ -0,0 +1,226 @@
+import type * as E2B from "@distilled.cloud/e2b";
+import type * as envd from "@distilled.cloud/e2b/envd";
+import type * as filesystem from "@distilled.cloud/e2b/filesystem";
+import type * as process from "@distilled.cloud/e2b/process";
+import type * as sandboxes from "@distilled.cloud/e2b/sandboxes";
+import type * as templates from "@distilled.cloud/e2b/templates";
+import type * as volumes from "@distilled.cloud/e2b/volumes";
+import type { RuntimeContext } from "alchemy/RuntimeContext";
+import type * as Sandbox from "alchemy/Sandbox";
+import type * as Duration from "effect/Duration";
+import type * as Effect from "effect/Effect";
+import type * as Scope from "effect/Scope";
+import type * as Stream from "effect/Stream";
+import type { E2BUnexpectedResponse, ExecTimedOut, SandboxBaseMissing } from "./Errors.ts";
+/** Errors an E2B call can fail with. */
+export type E2BError = E2B.E2BOpError | templates.TemplateInUse | volumes.VolumesNotEnabled | process.ConnectStreamError | process.SandboxNotRunning | filesystem.SandboxNotRunning | envd.SandboxNotRunning | SandboxBaseMissing | ExecTimedOut | E2BUnexpectedResponse;
+/** A process inside a sandbox, by pid or by the tag it was started with. */
+export type ProcessSelector = process.ConnectProcessRequest["process"];
+/** An event from a watched directory. */
+export type WatchEvent = filesystem.WatchDirEvent;
+/** A file or directory inside a sandbox. */
+export type EntryInfo = filesystem.EntryInfo;
+/** A running process inside a sandbox, as `processes.list()` reports it. */
+export type ProcessInfo = process.ProcessInfo;
+/**
+ * A command: a shell command line (run with `bash -l -c`), or an argument
+ * vector run directly.
+ */
+export type Command = Sandbox.Command;
+/**
+ * `cwd` defaults to the sandbox user's home; `timeout` kills the command and
+ * fails with `ExecTimedOut`.
+ */
+export type ExecOptions = Sandbox.ExecOptions;
+/** What a finished command printed, and its exit code. A non-zero exit code is returned, not failed. */
+export interface ExecResult extends Sandbox.ExecResult {
+    readonly pid: number;
+    /** envd's error for a process that could not run (e.g. the executable is missing). */
+    readonly error: string | undefined;
+}
+export interface StartOptions {
+    /** Working directory. @default the sandbox user's home */
+    readonly cwd?: string;
+    /** Environment variables for the command. */
+    readonly env?: Readonly<Record<string, string>>;
+    /** A tag to find the process by with `processes.attach({ tag })`. */
+    readonly tag?: string;
+    /** Keep stdin open for `write`. @default false */
+    readonly stdin?: boolean;
+}
+/** A chunk of a process's output. */
+export type ProcessOutput = Sandbox.ProcessOutput;
+/**
+ * A process started (or attached to) in the current scope. Closing the
+ * scope detaches: the process keeps running until it exits or is killed.
+ * `id` is its pid as a string.
+ */
+export interface Process extends Sandbox.Process<E2BError> {
+    readonly pid: number;
+    /** stdout and stderr, from now until the process exits. Read it once. */
+    readonly output: Stream.Stream<ProcessOutput, E2BError>;
+    /** Writes to stdin (the process must have been started with `stdin: true`). */
+    write(data: string | Uint8Array): Effect.Effect<void, E2BError, RuntimeContext>;
+    /** Closes stdin. */
+    closeStdin(): Effect.Effect<void, E2BError, RuntimeContext>;
+    /** Signals the process. @default "SIGKILL" */
+    kill(signal?: "SIGTERM" | "SIGKILL"): Effect.Effect<void, E2BError, RuntimeContext>;
+    /** Waits for the process to exit, with everything it printed since it was started or attached. */
+    readonly wait: Effect.Effect<ExecResult, E2BError>;
+}
+/** The processes running in the sandbox. */
+export interface Processes {
+    list(): Effect.Effect<ReadonlyArray<ProcessInfo>, E2BError, RuntimeContext>;
+    /** Re-attaches to a running process, by pid or tag; output streams from now on. */
+    attach(process: ProcessSelector): Effect.Effect<Process, E2BError, RuntimeContext | Scope.Scope>;
+}
+export interface PtyOptions extends Sandbox.PtyOptions {
+    /** A tag to find the terminal's process by. */
+    readonly tag?: string;
+}
+/** A pseudo-terminal opened in the current scope. Closing the scope detaches. `id` is its pid as a string. */
+export interface PtyConnection extends Sandbox.PtyConnection<E2BError> {
+    readonly pid: number;
+    /** The terminal's output. Read it once. */
+    readonly output: Stream.Stream<Uint8Array, E2BError>;
+    /** Types into the terminal. */
+    write(data: string | Uint8Array): Effect.Effect<void, E2BError, RuntimeContext>;
+    resize(size: {
+        readonly cols: number;
+        readonly rows: number;
+    }): Effect.Effect<void, E2BError, RuntimeContext>;
+    /** Kills the terminal's process. */
+    kill(): Effect.Effect<void, E2BError, RuntimeContext>;
+    /** Waits for the terminal's process to exit. */
+    readonly wait: Effect.Effect<{
+        readonly exitCode: number;
+    }, E2BError>;
+}
+/** Pseudo-terminals inside the sandbox. */
+export interface Pty extends Sandbox.Pty<E2BError, PtyOptions> {
+    open(options: PtyOptions): Effect.Effect<PtyConnection, E2BError, RuntimeContext | Scope.Scope>;
+}
+/** The sandbox's filesystem, through envd. Relative paths resolve in the user's home. */
+export interface Files extends Sandbox.Files<E2BError, EntryInfo> {
+    read(path: string): Effect.Effect<Uint8Array, E2BError, RuntimeContext>;
+    readText(path: string): Effect.Effect<string, E2BError, RuntimeContext>;
+    /** Writes a file, creating parent directories. */
+    write(path: string, data: string | Uint8Array): Effect.Effect<void, E2BError, RuntimeContext>;
+    list(path: string, options?: {
+        readonly depth?: number;
+    }): Effect.Effect<ReadonlyArray<EntryInfo>, E2BError, RuntimeContext>;
+    stat(path: string): Effect.Effect<EntryInfo, E2BError, RuntimeContext>;
+    remove(path: string): Effect.Effect<void, E2BError, RuntimeContext>;
+    /** Creates the directory and its parents. */
+    makeDir(path: string): Effect.Effect<void, E2BError, RuntimeContext>;
+    exists(path: string): Effect.Effect<boolean, E2BError, RuntimeContext>;
+    move(source: string, destination: string): Effect.Effect<EntryInfo, E2BError, RuntimeContext>;
+    /** Concatenates files into `destination`. */
+    compose(sources: ReadonlyArray<string>, destination: string): Effect.Effect<void, E2BError, RuntimeContext>;
+    /** Streams changes under a directory until interrupted. */
+    watch(path: string, options?: {
+        readonly recursive?: boolean;
+        readonly includeEntry?: boolean;
+    }): Stream.Stream<WatchEvent, E2BError, RuntimeContext>;
+}
+/** One fork's outcome: the new sandbox, or why it could not start. */
+export type ForkResult = {
+    readonly _tag: "Forked";
+    readonly sandbox: E2BSandbox;
+} | {
+    readonly _tag: "ForkFailed";
+    readonly code: number | undefined;
+    readonly message: string;
+};
+/** Network rules for a running sandbox (`updateSandboxNetwork`), in E2B's shape. */
+export type SandboxNetworkUpdate = Omit<sandboxes.UpdateSandboxNetworkRequest, "sandboxID">;
+/**
+ * A port inside an E2B sandbox, served at `https://<port>-<sandboxId>.<domain>`.
+ * `fetch` sends a client request to it, or proxies a server request there.
+ */
+export interface Port extends Sandbox.SandboxPort<E2BError> {
+    /** The host E2B serves the port on: `<port>-<sandboxId>.<domain>`. */
+    readonly host: string;
+    /** `https://<host>`. Public unless the sandbox requires its traffic token. */
+    readonly url: string;
+}
+/**
+ * What you can do with a sandbox, however you got it. Calls that reach
+ * inside a paused sandbox (`exec`, `start`, `files`, `pty`) fail with
+ * `SandboxNotRunning`: `resume()` it first. A sandbox created with
+ * `autoResume` is the exception: E2B resumes it on any request.
+ */
+export interface SandboxOperations extends Sandbox.SandboxExec<E2BError, ExecResult, ExecOptions>, Sandbox.SandboxProcesses<E2BError, StartOptions>, Sandbox.SandboxFiles<E2BError, EntryInfo>, Sandbox.SandboxPty<E2BError, PtyOptions>, Sandbox.SandboxPorts<E2BError, Port> {
+    /** Runs a command to completion. */
+    exec(command: Command, options?: ExecOptions): Effect.Effect<ExecResult, E2BError, RuntimeContext>;
+    /** Starts a command in the current scope. */
+    start(command: Command, options?: StartOptions): Effect.Effect<Process, E2BError, RuntimeContext | Scope.Scope>;
+    readonly processes: Processes;
+    readonly files: Files;
+    readonly pty: Pty;
+    /**
+     * A port inside the sandbox. Its `fetch` adds the sandbox's traffic token
+     * when the sandbox's URLs are not public.
+     */
+    getTcpPort(port: number): Effect.Effect<Port, E2BError, RuntimeContext>;
+    /** Live details: state, resources, network, metadata. */
+    describe(): Effect.Effect<sandboxes.SandboxDetail, E2BError, RuntimeContext>;
+    /** Pauses the sandbox, keeping its memory and files. */
+    pause(): Effect.Effect<void, E2BError, RuntimeContext>;
+    /**
+     * Resumes a paused sandbox (a no-op on a running one). `timeout` sets how
+     * long it runs before it is paused or killed again.
+     */
+    resume(options?: {
+        readonly timeout?: Duration.Input;
+    }): Effect.Effect<void, E2BError, RuntimeContext>;
+    /** Kills the sandbox. Killing one that is gone succeeds. */
+    kill(): Effect.Effect<void, E2BError, RuntimeContext>;
+    /** Sets the time left before the sandbox is killed (or paused, with `autoPause`). */
+    setTimeout(timeout: Duration.Input): Effect.Effect<void, E2BError, RuntimeContext>;
+    /** Extends the sandbox's lifetime by `duration`. */
+    refresh(duration?: Duration.Input): Effect.Effect<void, E2BError, RuntimeContext>;
+    /** Replaces the sandbox's egress rules (E2B's `updateSandboxNetwork`). */
+    updateNetwork(network: SandboxNetworkUpdate): Effect.Effect<void, E2BError, RuntimeContext>;
+    /**
+     * Snapshots the sandbox into a named template (memory and disk by
+     * default). Sandboxes created from it start where this one is now.
+     */
+    snapshot(options?: {
+        readonly name?: string;
+        readonly memory?: boolean;
+    }): Effect.Effect<sandboxes.SnapshotInfo, E2BError, RuntimeContext>;
+    /**
+     * Checkpoints the sandbox (it keeps running) and starts `count` copies of
+     * it. Each fork succeeds or fails on its own.
+     */
+    fork(options?: {
+        readonly count?: number;
+        readonly timeout?: Duration.Input;
+    }): Effect.Effect<ReadonlyArray<ForkResult>, E2BError, RuntimeContext>;
+    /** CPU, memory and disk metrics. */
+    metrics(): Effect.Effect<ReadonlyArray<sandboxes.SandboxMetric>, E2BError, RuntimeContext>;
+    /** The sandbox's logs. */
+    logs(options?: Omit<sandboxes.ListSandboxLogsRequest, "sandboxID">): Effect.Effect<sandboxes.SandboxLogsV2Response, E2BError, RuntimeContext>;
+}
+/**
+ * A sandbox created or connected at runtime (`CreateSandbox`). Holds only
+ * ids and tokens, so it can be rebuilt from its id with `connect(id)` in
+ * any request.
+ */
+export interface E2BSandbox extends SandboxOperations {
+    readonly sandboxId: string;
+    readonly templateId: string;
+    /** The domain the sandbox's ports are served under (`<port>-<sandboxId>.<domain>`). */
+    readonly domain: string;
+    /** What E2B returned for the sandbox when it was created or connected. */
+    readonly info: sandboxes.Sandbox;
+}
+/**
+ * A sandbox declared in the stack (`ConnectSandbox`). The same operations
+ * as {@link E2BSandbox}; its id is read at runtime.
+ */
+export interface ConnectedSandbox extends SandboxOperations {
+    readonly sandboxId: Effect.Effect<string, never, RuntimeContext>;
+}
+//# sourceMappingURL=SandboxClient.d.ts.map

package/lib/SandboxClient.d.ts.map

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

package/lib/SandboxClient.js

@@ -0,0 +1 @@
+//# sourceMappingURL=SandboxClient.js.map

package/lib/SandboxClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SandboxClient.js","sources":["../src/SandboxClient.ts"],"names":[],"mappings":""}