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

package/lib/BranchDisk.d.ts

@@ -0,0 +1,42 @@
+import * as Binding from "alchemy/Binding";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { type BranchDiskClient } from "./Clients.ts";
+import type { Disk } from "./Disk.ts";
+export type { BranchDiskClient } from "./Clients.ts";
+/**
+ * Fork one disk per session or task at run time: each branch is an
+ * independent, writable copy started from a committed checkpoint in about
+ * 35 ms, whatever the disk's size. Seed the disk once at deploy time with an
+ * {@link Checkpoint}, then branch from it per request.
+ *
+ * Mount a branch on your own machines with `MountDisk` and `branch`.
+ * Branches share the disk's credentials. Sandboxes can't mount a branch.
+ *
+ * ### Branching per Session
+ * **Example:** A fresh workspace for every session
+ * ```typescript
+ * export default class Api extends Cloudflare.Worker<Api>()(
+ *   "Api",
+ *   { main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     const seeds = yield* Archil.BranchDisk(Seed);
+ *     return {
+ *       fetch: Effect.gen(function* () {
+ *         const branch = yield* seeds.branch({ name: "session-42", fromCheckpoint: "base" });
+ *         return yield* HttpServerResponse.json(branch);
+ *       }),
+ *     };
+ *   }).pipe(Effect.provide(Archil.BranchDiskHttp)),
+ * ) {}
+ * ```
+ *
+ * @binding
+ * @product Disk
+ */
+export interface BranchDisk extends Binding.Service<BranchDisk, "Archil.BranchDisk", (disk: Disk) => Effect.Effect<BranchDiskClient>> {
+}
+export declare const BranchDisk: BranchDisk;
+/** {@link BranchDisk} over Archil's HTTP API, usable from any host. */
+export declare const BranchDiskHttp: Layer.Layer<BranchDisk, never, never>;
+//# sourceMappingURL=BranchDisk.d.ts.map

package/lib/BranchDisk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BranchDisk.d.ts","sources":["../src/BranchDisk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,UAAW,SAAQ,OAAO,CAAC,OAAO,CACjD,UAAU,EACV,mBAAmB,EACnB,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAChD;CAAG;AAEJ,eAAO,MAAM,UAAU,YAAmD,CAAC;AAE3E,uEAAuE;AACvE,eAAO,MAAM,cAAc,uCAQ1B,CAAC"}

package/lib/BranchDisk.js

@@ -0,0 +1,14 @@
+import * as Binding from "alchemy/Binding";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { ApiAccess } from "./ArchilBindings.js";
+import { makeBranchDiskClient } from "./Clients.js";
+export const BranchDisk = Binding.Service("Archil.BranchDisk");
+/** {@link BranchDisk} over Archil's HTTP API, usable from any host. */
+export const BranchDiskHttp = Layer.effect(BranchDisk, Effect.gen(function* () {
+    const access = yield* ApiAccess;
+    return Effect.fn(function* (disk) {
+        return makeBranchDiskClient(yield* disk.diskId, yield* access());
+    });
+}));
+//# sourceMappingURL=BranchDisk.js.map

package/lib/BranchDisk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BranchDisk.js","sources":["../src/BranchDisk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAyB,MAAM,cAAc,CAAC;AAyC3E,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAa,mBAAmB,CAAC,CAAC;AAE3E,uEAAuE;AACvE,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CACxC,UAAU,EACV,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAChC,OAAO,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAU;QACpC,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CACH,CAAC"}

package/lib/Checkpoint.d.ts

@@ -0,0 +1,78 @@
+import * as archil from "@distilled.cloud/archil";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Effect from "effect/Effect";
+import type { Providers } from "./Providers.ts";
+declare const CheckpointSetupFailed_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Archil.CheckpointSetupFailed";
+} & Readonly<A>;
+/** A checkpoint's setup command exited non-zero. */
+export declare class CheckpointSetupFailed extends CheckpointSetupFailed_base<{
+    readonly checkpoint: string;
+    readonly exitCode: number;
+    readonly stderr: string;
+}> {
+}
+export interface CheckpointProps {
+    /** Id of the disk to checkpoint (e.g. `disk.diskId`). Changing it replaces the checkpoint. */
+    disk: string;
+    /**
+     * Checkpoint name, unique within its branch. If omitted, a unique name
+     * is generated from the stack, stage, and logical ID. Changing it
+     * replaces the checkpoint.
+     */
+    name?: string;
+    /**
+     * Shell commands that seed the disk before the checkpoint is taken. They
+     * run in a serverless microVM with the disk mounted at `/mnt/archil` (the
+     * working directory). Changing them takes a new checkpoint.
+     */
+    run?: string[];
+}
+export interface CheckpointAttributes {
+    /** Id of the disk. */
+    diskId: string;
+    /** Checkpoint name. Pass it to a {@link Branch} or `BranchDisk` as `fromCheckpoint`. */
+    name: string;
+}
+export type Checkpoint = Resource<"Archil.Checkpoint", CheckpointProps, CheckpointAttributes, never, Providers>;
+/**
+ * A named, point-in-time snapshot of a disk, the seeded base that branches
+ * fork from. Alchemy runs the `run` commands against the disk, then takes
+ * the checkpoint in the same microVM, so the checkpoint holds exactly what
+ * they produced. A checkpoint takes about 15 ms whatever the disk's size,
+ * and never changes after it's taken.
+ *
+ * Archil can't delete checkpoints yet, so destroying the resource only
+ * removes it from Alchemy's state.
+ * @see https://docs.archil.com/concepts/branches-and-checkpoints
+ *
+ * ### Seeding a Base
+ * **Example:** Clone and install once, branch per session
+ * ```typescript
+ * export const Seed = Archil.Disk("Seed", {});
+ * export const Base = Effect.gen(function* () {
+ *   const seed = yield* Seed;
+ *   return yield* Archil.Checkpoint("Base", {
+ *     disk: seed.diskId,
+ *     name: "base",
+ *     run: [
+ *       "git clone --depth 1 https://github.com/alchemy-run/alchemy repo",
+ *       "cd repo && corepack enable && pnpm install --frozen-lockfile",
+ *     ],
+ *   });
+ * });
+ * ```
+ *
+ * @resource
+ * @product Disk
+ */
+export declare const Checkpoint: import("alchemy").ResourceClass<Checkpoint>;
+/** Seed a disk and take a checkpoint of it in one serverless exec. */
+export declare const takeCheckpoint: (diskId: string, name: string, run: readonly string[]) => Effect.Effect<{
+    diskId: string;
+    name: string;
+}, CheckpointSetupFailed | archil.ExecDiskError, archil.ArchilOpContext>;
+export declare const CheckpointProvider: () => import("effect/Layer").Layer<Provider.Provider<Checkpoint>, never, import("alchemy").Stack | import("alchemy").Stage | archil.ArchilOpContext>;
+export {};
+//# sourceMappingURL=Checkpoint.d.ts.map

package/lib/Checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Checkpoint.d.ts","sources":["../src/Checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,yBAAyB,CAAC;AAGlD,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;;;;AAEhD,oDAAoD;AACpD,qBAAa,qBAAsB,SAAQ,2BAAiD;IAC1F,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;CAAG;AAEL,MAAM,WAAW,eAAe;IAC9B,8FAA8F;IAC9F,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,CAC/B,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,KAAK,EACL,SAAS,CACV,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,UAAU,6CAA4C,CAAC;AAOpE,sEAAsE;AACtE,eAAO,MAAM,cAAc;;;wEAqBzB,CAAC;AAEH,eAAO,MAAM,kBAAkB,sJAkC5B,CAAC"}

package/lib/Checkpoint.js

@@ -0,0 +1,95 @@
+import * as archil from "@distilled.cloud/archil";
+import { deepEqual, isResolved } from "alchemy/Diff";
+import { createPhysicalName } from "alchemy/PhysicalName";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+/** A checkpoint's setup command exited non-zero. */
+export class CheckpointSetupFailed extends Data.TaggedError("Archil.CheckpointSetupFailed") {
+}
+/**
+ * A named, point-in-time snapshot of a disk, the seeded base that branches
+ * fork from. Alchemy runs the `run` commands against the disk, then takes
+ * the checkpoint in the same microVM, so the checkpoint holds exactly what
+ * they produced. A checkpoint takes about 15 ms whatever the disk's size,
+ * and never changes after it's taken.
+ *
+ * Archil can't delete checkpoints yet, so destroying the resource only
+ * removes it from Alchemy's state.
+ * @see https://docs.archil.com/concepts/branches-and-checkpoints
+ *
+ * ### Seeding a Base
+ * **Example:** Clone and install once, branch per session
+ * ```typescript
+ * export const Seed = Archil.Disk("Seed", {});
+ * export const Base = Effect.gen(function* () {
+ *   const seed = yield* Seed;
+ *   return yield* Archil.Checkpoint("Base", {
+ *     disk: seed.diskId,
+ *     name: "base",
+ *     run: [
+ *       "git clone --depth 1 https://github.com/alchemy-run/alchemy repo",
+ *       "cd repo && corepack enable && pnpm install --frozen-lockfile",
+ *     ],
+ *   });
+ * });
+ * ```
+ *
+ * @resource
+ * @product Disk
+ */
+export const Checkpoint = Resource("Archil.Checkpoint");
+const checkpointName = (id, name) => name ? Effect.succeed(name) : createPhysicalName({ id, maxLength: 63, delimiter: "-" });
+const shellQuote = (value) => `'${value.replaceAll("'", `'"'"'`)}'`;
+/** Seed a disk and take a checkpoint of it in one serverless exec. */
+export const takeCheckpoint = Effect.fn(function* (diskId, name, run) {
+    const script = [
+        "set -e",
+        "cd /mnt/archil",
+        ...run.map((command) => `(${command})`),
+        "sync",
+        `archil checkpoints create /mnt/archil ${shellQuote(name)}`,
+    ].join("\n");
+    const { data } = yield* archil.execDisk({ id: diskId, command: script });
+    if (data.exitCode !== 0) {
+        return yield* new CheckpointSetupFailed({
+            checkpoint: name,
+            exitCode: data.exitCode,
+            stderr: data.stderr,
+        });
+    }
+    return { diskId, name };
+});
+export const CheckpointProvider = () => Provider.effect(Checkpoint, Effect.gen(function* () {
+    return {
+        stables: ["diskId", "name"],
+        // No list or delete API: checkpoints go with their disk.
+        nuke: { skip: true },
+        diff: Effect.fn(function* ({ id, olds, news, output }) {
+            if (!isResolved(news) || olds === undefined)
+                return undefined;
+            const name = output?.name ?? (yield* checkpointName(id, olds.name));
+            if (news.disk !== olds.disk ||
+                (news.name !== undefined && news.name !== name) ||
+                !deepEqual(news.run ?? [], olds.run ?? [])) {
+                return { action: "replace" };
+            }
+            return undefined;
+        }),
+        // Checkpoints have no read API; state is authoritative.
+        read: Effect.fn(function* ({ output }) {
+            return output;
+        }),
+        reconcile: Effect.fn(function* ({ id, news, output, session }) {
+            if (output && output.diskId === news.disk)
+                return output;
+            const name = yield* checkpointName(id, news.name);
+            yield* session.note(`Seeding disk and taking checkpoint ${name}...`);
+            return yield* takeCheckpoint(news.disk, name, news.run ?? []);
+        }),
+        // Archil has no checkpoint delete API.
+        delete: () => Effect.void,
+    };
+}));
+//# sourceMappingURL=Checkpoint.js.map

package/lib/Checkpoint.js.map

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

package/lib/Clients.d.ts

@@ -0,0 +1,369 @@
+/**
+ * The run-time handles Archil bindings return. A disk or sandbox handle is
+ * the same shape whether it came from a deploy-time resource
+ * (`ExecDisk(Dataset)`, `ConnectSandbox(Preview)`) or was created at run
+ * time (`CreateDisk`, `CreateSandbox`), and takes Archil's own parameters.
+ */
+import * as archil from "@distilled.cloud/archil";
+import * as Objects from "@distilled.cloud/archil/Objects";
+import * as Process from "@distilled.cloud/archil/Process";
+import type { RuntimeContext } from "alchemy/RuntimeContext";
+import * as SandboxBase from "alchemy/Sandbox";
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import type * as Scope from "effect/Scope";
+import * as Stream from "effect/Stream";
+import type { Authorize, ObjectsRunner } from "./ArchilBindings.ts";
+import type { BranchAttributes } from "./Branch.ts";
+import type { DiskAttributes } from "./Disk.ts";
+import type { DiskUserAttributes } from "./DiskUser.ts";
+import { type DiskUserSpec, type DiskUserUnexpectedResponse } from "./DiskUser.ts";
+import { deleteSandbox, type SandboxAttributes } from "./Sandbox.ts";
+import { type SandboxEgress } from "./SandboxOptions.ts";
+import type { SandboxPortTokenAttributes } from "./SandboxPortToken.ts";
+type R = RuntimeContext;
+/** What a serverless exec printed, and its exit code. */
+export interface ExecResult {
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+    /** Where the time went, as Archil reports it. */
+    readonly timing: archil.ExecTiming;
+}
+/** Search options for `grep`. */
+export interface GrepOptions {
+    /** Directory on the disk to search. @default "/" */
+    readonly directory?: string;
+    /** Regular expression. */
+    readonly pattern: string;
+    /** Search subdirectories. @default false */
+    readonly recursive?: boolean;
+    /** Stop after this many seconds. @default 30 */
+    readonly maxDurationSeconds?: number;
+    /** Workers to fan out to. @default 50 */
+    readonly concurrency?: number;
+    /** Stop after this many matches. @default 1000 */
+    readonly maxResults?: number;
+}
+/** Serverless commands and search against one disk. */
+export interface ExecDiskClient {
+    /**
+     * Run a shell command in a fresh microVM with the disk mounted at
+     * `/mnt/archil`. Blocks until it exits (up to five minutes).
+     */
+    exec(command: string): Effect.Effect<ExecResult, archil.ExecDiskError, R>;
+    /** Constant-time parallel grep across the disk's files. */
+    grep(options: GrepOptions): Effect.Effect<archil.GrepDiskResult, archil.GrepDiskError, R>;
+}
+/** Read the disk's files as objects. */
+export interface ReadDiskClient {
+    /** A file's bytes, optionally a byte range (`bytes=0-1023`). */
+    get(key: string, options?: {
+        readonly range?: string;
+    }): Effect.Effect<Uint8Array, Objects.ObjectsFailure | ObjectsTransportError, R>;
+    /** A file as UTF-8 text. */
+    getText(key: string): Effect.Effect<string, Objects.ObjectsFailure | ObjectsTransportError, R>;
+    /** A file's bytes as a stream, for files too big to hold in memory. */
+    getStream(key: string): Stream.Stream<Uint8Array, Objects.ObjectsFailure | ObjectsTransportError, R>;
+    /** A file's metadata, or `undefined` when it doesn't exist. */
+    head(key: string): Effect.Effect<Objects.ObjectMetadata | undefined, Objects.ObjectsFailure | ObjectsTransportError, R>;
+    /** Every file under a prefix, lazily paginated. */
+    list(prefix?: string, options?: {
+        readonly recursive?: boolean;
+    }): Stream.Stream<Objects.ObjectSummary, Objects.ObjectsFailure | ObjectsTransportError, R>;
+    /**
+     * A signed URL anyone can download one file from, valid for
+     * `expiresInSeconds` (1 to 604800; default one hour).
+     */
+    share(key: string, expiresInSeconds?: number): Effect.Effect<Redacted.Redacted<string>, ShareError, R>;
+}
+/** What creating a share URL can fail with. */
+export type ShareError = archil.CreateShareUrlError | Effect.Error<ReturnType<typeof Objects.presignGetObject>>;
+/** Write the disk's files as objects. */
+export interface WriteDiskClient {
+    /** Write a file (≤ 5 GiB). */
+    put(key: string, body: Uint8Array | string, options?: {
+        readonly contentType?: string;
+    } & Objects.PosixAttributes): Effect.Effect<{
+        etag: string | undefined;
+    }, Objects.ObjectsFailure | ObjectsTransportError, R>;
+    /** Append to a file, creating it when missing (≤ 1 MiB per call). */
+    append(key: string, body: Uint8Array | string): Effect.Effect<{
+        etag: string | undefined;
+    }, Objects.ObjectsFailure | ObjectsTransportError, R>;
+    /** Delete a file. Deleting a missing file succeeds. */
+    delete(key: string): Effect.Effect<void, Objects.ObjectsFailure | ObjectsTransportError, R>;
+    /** Delete many files; per-file failures are returned. */
+    deleteMany(keys: ReadonlyArray<string>): Effect.Effect<{
+        deleted: string[];
+        errors: Array<{
+            readonly key: string;
+            readonly code?: string;
+            readonly message?: string;
+        }>;
+    }, Objects.ObjectsFailure | ObjectsTransportError, R>;
+    /** Copy a file within the disk. */
+    copy(sourceKey: string, key: string): Effect.Effect<{
+        etag: string | undefined;
+    }, Objects.ObjectsFailure | ObjectsTransportError, R>;
+    /**
+     * Write a file of any size from a stream, as a multipart upload in
+     * 8 MiB parts. A failed upload is aborted, so no parts are left behind.
+     */
+    upload<E>(key: string, body: Stream.Stream<Uint8Array, E>, options?: {
+        readonly contentType?: string;
+    } & Objects.PosixAttributes): Effect.Effect<{
+        etag: string | undefined;
+    }, Objects.ObjectsFailure | ObjectsTransportError | E, R>;
+}
+/** Write delegations on a disk: the paths a mounted client holds for writing. */
+export interface DiskDelegationsClient {
+    /** Write delegations held on the disk, e.g. by a crashed mount. */
+    delegations(): Effect.Effect<archil.DelegationEntry[], archil.ListDelegationsError, R>;
+    /** Reclaim write access from a client that is gone. */
+    revokeDelegation(delegation: Pick<archil.DelegationEntry, "clientId" | "inodeId">): Effect.Effect<void, archil.RevokeDelegationError, R>;
+}
+/** Both {@link ReadDiskClient} and {@link WriteDiskClient}. */
+export interface ReadWriteDiskClient extends ReadDiskClient, WriteDiskClient {
+}
+/** Errors from the HTTP transport underneath the objects API. */
+export type ObjectsTransportError = Effect.Error<ReturnType<typeof Objects.headObject>>;
+/** Branches of one disk. */
+export interface BranchDiskClient {
+    /**
+     * Create a writable branch from a committed checkpoint, or return the
+     * branch with that name.
+     */
+    branch(options: {
+        readonly name: string;
+        readonly fromCheckpoint: string;
+        readonly fromBranch?: string;
+    }): Effect.Effect<BranchAttributes, archil.CreateBranchError | archil.GetBranchError, R>;
+    /** A branch, or `undefined` when it doesn't exist. */
+    getBranch(name: string): Effect.Effect<BranchAttributes | undefined, archil.GetBranchError, R>;
+    /** Every branch of the disk, including branches of branches. */
+    listBranches(): Effect.Effect<BranchAttributes[], archil.ListBranchesError, R>;
+}
+/** One disk, with everything a run-time client can do to it. */
+export interface DiskHandle extends ExecDiskClient, ReadWriteDiskClient, BranchDiskClient, DiskDelegationsClient {
+    readonly diskId: string;
+    readonly name: string;
+    /**
+     * A disk token for mounting this disk only, e.g. to hand to a machine
+     * that mounts with `MountDisk()`. `readOnly`, `expiresAt` and `oneUse`
+     * narrow it. Revoke it with `removeToken`.
+     */
+    createToken(nickname: string, options?: Pick<DiskUserSpec, "readOnly" | "expiresAt" | "oneUse">): Effect.Effect<DiskUserAttributes, archil.AddDiskUserError | DiskUserUnexpectedResponse, R>;
+    /** Revoke a disk token. */
+    removeToken(identifier: string): Effect.Effect<void, archil.RemoveDiskUserError, R>;
+}
+/** A command: one shell line, or an argument vector (quoted for you). */
+export type Command = SandboxBase.Command;
+/** Options for a command run in a sandbox (`timeout` rounds up to whole seconds). */
+export type ExecOptions = SandboxBase.ExecOptions;
+/** Options for a process started in the background. */
+export type StartOptions = Omit<ExecOptions, "stdin">;
+/**
+ * What a process call on a sandbox handle can fail with. A paused sandbox
+ * is resumed first, so resuming can fail too.
+ */
+export type ProcessCallError = Process.ProcessError | archil.CreateSandboxConnectionError | archil.GetSandboxError | archil.ResumeSandboxError;
+/** A chunk of process output, with its offset in the combined output (for `attach`). */
+export interface SandboxProcessOutput extends SandboxBase.ProcessOutput {
+    readonly offset: number;
+}
+/** How an Archil process ended. */
+export interface SandboxProcessExit {
+    /**
+     * The exit code. Archil reports none for a process it killed (a timeout,
+     * or `kill`); that is `-1` here, and `status` / `exitReason` say why.
+     */
+    readonly exitCode: number;
+    readonly status: string;
+    readonly exitReason: string | undefined;
+    /** Output offset at exit, for a later `attach`. */
+    readonly cursor: number;
+}
+/**
+ * A process running in a sandbox, attached over one connection. Closing
+ * the scope that started it detaches; the process keeps running and can be
+ * re-attached by `id`.
+ */
+export interface SandboxProcess extends SandboxBase.Process<ProcessCallError> {
+    readonly output: Stream.Stream<SandboxProcessOutput, ProcessCallError, R>;
+    /**
+     * Kill the process. Archil's process API kills without a choice of
+     * signal, so `signal` is ignored.
+     */
+    kill(signal?: "SIGTERM" | "SIGKILL"): Effect.Effect<void, ProcessCallError, R>;
+    readonly wait: Effect.Effect<SandboxProcessExit, ProcessCallError, R>;
+    /** Close stdin. */
+    readonly closeStdin: Effect.Effect<void, ProcessCallError, R>;
+}
+/** A shell (or command) on a pseudo-terminal. */
+export interface PtyConnection extends SandboxBase.PtyConnection<ProcessCallError> {
+    /** Kill the terminal's process. */
+    kill(): Effect.Effect<void, ProcessCallError, R>;
+    /** Wait for the terminal's process to exit. */
+    readonly wait: Effect.Effect<SandboxProcessExit, ProcessCallError, R>;
+}
+/** Options for a pseudo-terminal. `command` may also be an argument vector. */
+export interface PtyOptions extends Omit<SandboxBase.PtyOptions, "command"> {
+    /** @default "bash" */
+    readonly command?: Command;
+}
+/**
+ * Files in the sandbox. Archil's process protocol has no file calls of its
+ * own: these run small POSIX shell commands over it (as Archil's own SDK
+ * does for uploads and downloads), so they work on any image with `sh`,
+ * `cat`, `stat`, `rm` and `mkdir`.
+ */
+export interface SandboxFiles extends SandboxBase.Files<ProcessCallError> {
+    /** Write a file (atomically: a temp file, then a rename), creating its directory. */
+    write(path: string, data: string | Uint8Array, options?: {
+        readonly mode?: number;
+    }): Effect.Effect<void, ProcessCallError, R>;
+}
+declare const SandboxPortNotExposed_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Archil.SandboxPortNotExposed";
+} & Readonly<A>;
+/** The sandbox doesn't serve this port publicly (`exposePort` it first). */
+export declare class SandboxPortNotExposed extends SandboxPortNotExposed_base<{
+    readonly port: number;
+    readonly message: string;
+}> {
+}
+/** Why `getTcpPort` can fail. */
+export type SandboxPortError = SandboxPortNotExposed | archil.ListSandboxPortsError;
+/**
+ * A port the sandbox serves publicly, at its own `archil.app` hostname.
+ * `fetch` sends a client request there, or proxies the server request a
+ * handler received; either way the method, path, query, headers and body
+ * are kept. Anyone with the URL can call a public port, so hand browsers a
+ * port token (`createPortToken`) rather than your key.
+ */
+export interface SandboxPort extends SandboxBase.SandboxPort<SandboxPortError> {
+    /** The port inside the sandbox. */
+    readonly port: number;
+    /** Archil's public hostname for this port, e.g. `3000-<route>.<zone>.archil.app`. */
+    readonly hostname: string;
+    /** `https://` + `hostname`. */
+    readonly url: string;
+}
+/** Everything a run-time client can do to one sandbox. */
+export interface SandboxOps extends SandboxBase.SandboxExec<ProcessCallError, Process.ProcessResult, ExecOptions>, SandboxBase.SandboxProcesses<ProcessCallError, StartOptions>, SandboxBase.SandboxFiles<ProcessCallError>, SandboxBase.SandboxPty<ProcessCallError, PtyOptions>, SandboxBase.SandboxPorts<SandboxPortError, SandboxPort> {
+    /** The sandbox's current attributes. */
+    refresh(): Effect.Effect<SandboxAttributes, archil.GetSandboxError, R>;
+    /**
+     * Run a command to completion and collect its output. A non-zero exit is
+     * returned in `exitCode`, not failed.
+     */
+    exec(command: Command, options?: ExecOptions): Effect.Effect<Process.ProcessResult, ProcessCallError, R>;
+    /**
+     * Start a command in the background and attach to it. Closing the scope
+     * detaches; the process keeps running and can be re-attached by id.
+     */
+    start(command: Command, options?: StartOptions): Effect.Effect<SandboxProcess, ProcessCallError, R | Scope.Scope>;
+    /** Re-attach to a running process, resuming its output at `offset`. */
+    attach(processId: string, offset?: number): Effect.Effect<SandboxProcess, ProcessCallError, R | Scope.Scope>;
+    /** Files in the sandbox. */
+    readonly files: SandboxFiles;
+    /** Pseudo-terminals. */
+    readonly pty: {
+        /** Open a shell (or `command`) on a terminal of `cols` × `rows`. */
+        open(options: PtyOptions): Effect.Effect<PtyConnection, ProcessCallError, R | Scope.Scope>;
+    };
+    /**
+     * A port the sandbox serves publicly. Fails with `SandboxPortNotExposed`
+     * until the port is exposed (`ports` on the resource, or `exposePort`).
+     */
+    getTcpPort(port: number): Effect.Effect<SandboxPort, SandboxPortError, R>;
+    /** Start a stopped sandbox (Archil's `start`). */
+    boot(): Effect.Effect<SandboxAttributes, archil.StartSandboxError, R>;
+    /** Stop the sandbox (its disk survives; memory doesn't). */
+    stop(): Effect.Effect<SandboxAttributes, archil.StopSandboxError, R>;
+    /** Pause the sandbox, keeping its memory. */
+    pause(): Effect.Effect<SandboxAttributes, archil.PauseSandboxError, R>;
+    /** Resume a paused sandbox. */
+    resume(): Effect.Effect<SandboxAttributes, archil.ResumeSandboxError, R>;
+    /**
+     * Fork the sandbox (memory and disk) into a new one. Archil only forks a
+     * sandbox with mounts while it is stopped.
+     */
+    fork(options?: {
+        readonly name?: string;
+        readonly checkpoint?: string;
+    }): Effect.Effect<SandboxHandle, archil.ForkSandboxError, R>;
+    /**
+     * Pause after `timeoutSeconds` from now, and/or after `idleTtlSeconds`
+     * without a connection (`0` disables idle expiry).
+     */
+    setTimeout(options: {
+        readonly timeoutSeconds?: number;
+        readonly idleTtlSeconds?: number;
+    }): Effect.Effect<SandboxAttributes, archil.SetSandboxTimeoutError, R>;
+    /** Serve a port publicly. */
+    exposePort(port: number): Effect.Effect<{
+        port: number;
+        hostname: string;
+    }, archil.ExposeSandboxPortError, R>;
+    /** Stop serving a port. */
+    unexposePort(port: number): Effect.Effect<void, archil.DeleteSandboxPortError, R>;
+    /** Ports the sandbox serves. */
+    ports(): Effect.Effect<Array<{
+        port: number;
+        hostname: string;
+    }>, archil.ListSandboxPortsError, R>;
+    /** A token that opens one port for a client that shouldn't hold an API key. */
+    createPortToken(port: number, ttl?: string): Effect.Effect<SandboxPortTokenAttributes, archil.CreateSandboxPortTokenError, R>;
+    /** Revoke a port token. */
+    revokePortToken(tokenId: string): Effect.Effect<void, archil.DeleteSandboxPortTokenError, R>;
+    /**
+     * The sandbox's port tokens, without their secret values (Archil only
+     * shows a token when it's created).
+     */
+    listPortTokens(): Stream.Stream<archil.SandboxPortToken, archil.ListSandboxPortTokensError, R>;
+    /** Replace the outbound network policy. Applies at once. */
+    setEgress(egress: SandboxEgress): Effect.Effect<void, archil.UpdateSandboxNetworkError, R>;
+    /**
+     * Stop (if it's live) and delete the sandbox. Deleting a missing sandbox
+     * succeeds.
+     */
+    delete(): Effect.Effect<void, Effect.Error<ReturnType<typeof deleteSandbox>>, R>;
+}
+/** One sandbox known by id and name, with everything a run-time client can do to it. */
+export interface SandboxHandle extends SandboxOps {
+    readonly sandboxId: string;
+    readonly name: string;
+}
+/** Serverless exec + grep on a disk whose id resolves at run time. */
+export declare const makeExecDiskClient: (diskId: Effect.Effect<string, never, R>, authorize: Authorize) => ExecDiskClient;
+/** How a read client makes share URLs. */
+export type ShareStrategy = (ref: Objects.DiskRef, key: string, expiresInSeconds: number) => Effect.Effect<Redacted.Redacted<string>, ShareError, R>;
+/** Share URLs presigned with the client's own S3 user keys. */
+export declare const presignedShare: (run: ObjectsRunner) => ShareStrategy;
+/** Share URLs from Archil's control plane (needs the API key). */
+export declare const controlPlaneShare: (authorize: Authorize) => ShareStrategy;
+/** Object reads on a disk (or branch) whose id resolves at run time. */
+export declare const makeReadDiskClient: (ref: Effect.Effect<Objects.DiskRef, never, R>, run: ObjectsRunner, share: ShareStrategy) => ReadDiskClient;
+/** Object writes on a disk (or branch) whose id resolves at run time. */
+export declare const makeWriteDiskClient: (ref: Effect.Effect<Objects.DiskRef, never, R>, run: ObjectsRunner) => WriteDiskClient;
+/** Write delegations on a disk whose id resolves at run time (needs the API key). */
+export declare const makeDiskDelegationsClient: (ref: Effect.Effect<Objects.DiskRef, never, R>, authorize: Authorize) => DiskDelegationsClient;
+/** Branches of a disk whose id resolves at run time. */
+export declare const makeBranchDiskClient: (diskId: Effect.Effect<string, never, R>, authorize: Authorize) => BranchDiskClient;
+/** A full handle on a disk known by id and name. */
+export declare const makeDiskHandle: (disk: Pick<DiskAttributes, "diskId" | "name">, authorize: Authorize) => DiskHandle;
+/**
+ * Everything a run-time client can do to the sandbox `sid` resolves to.
+ * `forkName` maps a fork's name (a binding puts its owner prefix on it,
+ * like on the sandboxes it creates).
+ */
+export declare const makeSandboxOps: (sid: Effect.Effect<string, never, R>, authorize: Authorize, forkName?: (name: string | undefined) => Effect.Effect<string | undefined>) => SandboxOps;
+/** A full handle on a sandbox known by id and name. */
+export declare const makeSandboxHandle: (sandbox: {
+    readonly sandboxId: string;
+    readonly name: string;
+}, authorize: Authorize, forkName?: (name: string | undefined) => Effect.Effect<string | undefined>) => SandboxHandle;
+export {};
+//# sourceMappingURL=Clients.d.ts.map

package/lib/Clients.d.ts.map

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