@gjermundgaraba/clankerbox-sdk 0.4.1 → 0.12.1

package/dist/index.d.mts

@@ -0,0 +1,573 @@
+import { A as hostErrors, C as HostError, D as NotFound, E as Invalid, O as Precondition, S as ErrorTag, T as Internal, _ as version, a as ActionName, b as Conflict, c as CreateRequest, d as MachineSpec, f as Profile, g as release, h as SshEndpoint, i as client_d_exports, k as Unavailable, l as Host, m as Setup, o as ActionRecord, p as Runtime, s as Checkpoint, u as Machine, v as Capacity, w as HostErrorTag, x as ConflictKind, y as ClankerboxError } from "./client-BVzrg2pq.mjs";
+import * as Action from "@gjermundgaraba/effect-actions/Action";
+import * as ActionGroup from "@gjermundgaraba/effect-actions/ActionGroup";
+import * as ActionHttp from "@gjermundgaraba/effect-actions/ActionHttp";
+import { Duration, Effect, FileSystem, Path, Schema } from "effect";
+import { ChildProcessSpawner } from "effect/process";
+//#region src/api.d.ts
+/**
+ * How long a client waits for a read's reply from one host, unless it sets its own. A host
+ * bounds its own reads of runtime state under it, so a list answers in time.
+ */
+export declare const readTimeout: Duration.Duration;
+/**
+ * The header every client request carries the SDK's `version` in. A host refuses a request
+ * whose release (major.minor) differs from its own, or that carries none, before it runs
+ * anything.
+ */
+export declare const versionHeader = "clankerbox-version";
+export declare const MachineGroup: ActionGroup.Group<"machine", readonly [Action.Action<"list", Schema.$Record<Schema.String, Schema.Never>, Schema.$Array<Schema.Struct<{
+  readonly id: Schema.String;
+  readonly runtime: Schema.Literals<readonly ["smolvm", "tart", "boat"]>;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly state: Schema.Literals<readonly ["running", "stopped", "missing", "unknown"]>;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+  readonly ssh: Schema.optionalKey<Schema.Struct<{
+    readonly host: Schema.String;
+    readonly port: Schema.Int;
+  }>>;
+  readonly hostKey: Schema.optionalKey<Schema.String>;
+}>>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "read", undefined>, Action.Action<"get", Schema.Struct<{
+  readonly id: Schema.String;
+}>, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly runtime: Schema.Literals<readonly ["smolvm", "tart", "boat"]>;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly state: Schema.Literals<readonly ["running", "stopped", "missing", "unknown"]>;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+  readonly ssh: Schema.optionalKey<Schema.Struct<{
+    readonly host: Schema.String;
+    readonly port: Schema.Int;
+  }>>;
+  readonly hostKey: Schema.optionalKey<Schema.String>;
+}>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "read", undefined>, Action.Action<"create", Schema.Struct<{
+  readonly base: Schema.String;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly setup: Schema.optionalKey<Schema.Struct<{
+    readonly script: Schema.String;
+    readonly timeoutSeconds: Schema.Int;
+  }>>;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly id: Schema.String;
+}>, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly runtime: Schema.Literals<readonly ["smolvm", "tart", "boat"]>;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly state: Schema.Literals<readonly ["running", "stopped", "missing", "unknown"]>;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+  readonly ssh: Schema.optionalKey<Schema.Struct<{
+    readonly host: Schema.String;
+    readonly port: Schema.Int;
+  }>>;
+  readonly hostKey: Schema.optionalKey<Schema.String>;
+}>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "write", undefined>, Action.Action<"start", Schema.Struct<{
+  readonly id: Schema.String;
+}>, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly runtime: Schema.Literals<readonly ["smolvm", "tart", "boat"]>;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly state: Schema.Literals<readonly ["running", "stopped", "missing", "unknown"]>;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+  readonly ssh: Schema.optionalKey<Schema.Struct<{
+    readonly host: Schema.String;
+    readonly port: Schema.Int;
+  }>>;
+  readonly hostKey: Schema.optionalKey<Schema.String>;
+}>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "write", undefined>, Action.Action<"stop", Schema.Struct<{
+  readonly id: Schema.String;
+}>, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly runtime: Schema.Literals<readonly ["smolvm", "tart", "boat"]>;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly state: Schema.Literals<readonly ["running", "stopped", "missing", "unknown"]>;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+  readonly ssh: Schema.optionalKey<Schema.Struct<{
+    readonly host: Schema.String;
+    readonly port: Schema.Int;
+  }>>;
+  readonly hostKey: Schema.optionalKey<Schema.String>;
+}>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "write", undefined>, Action.Action<"delete", Schema.Struct<{
+  readonly id: Schema.String;
+}>, Schema.Void, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "write", undefined>, Action.Action<"fork", Schema.Struct<{
+  readonly machine: Schema.String;
+  readonly name: Schema.String;
+}>, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly runtime: Schema.Literals<readonly ["smolvm", "tart", "boat"]>;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly state: Schema.Literals<readonly ["running", "stopped", "missing", "unknown"]>;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+  readonly ssh: Schema.optionalKey<Schema.Struct<{
+    readonly host: Schema.String;
+    readonly port: Schema.Int;
+  }>>;
+  readonly hostKey: Schema.optionalKey<Schema.String>;
+}>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "write", undefined>, Action.Action<"restore", Schema.Struct<{
+  readonly checkpoint: Schema.String;
+  readonly name: Schema.String;
+}>, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly runtime: Schema.Literals<readonly ["smolvm", "tart", "boat"]>;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly state: Schema.Literals<readonly ["running", "stopped", "missing", "unknown"]>;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+  readonly ssh: Schema.optionalKey<Schema.Struct<{
+    readonly host: Schema.String;
+    readonly port: Schema.Int;
+  }>>;
+  readonly hostKey: Schema.optionalKey<Schema.String>;
+}>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "write", undefined>], typeof Invalid | typeof Internal>;
+export declare const CheckpointGroup: ActionGroup.Group<"checkpoint", readonly [Action.Action<"list", Schema.$Record<Schema.String, Schema.Never>, Schema.$Array<Schema.Struct<{
+  readonly id: Schema.String;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly machine: Schema.String;
+  readonly kind: Schema.Literals<readonly ["ram", "disk"]>;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+}>>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "read", undefined>, Action.Action<"get", Schema.Struct<{
+  readonly id: Schema.String;
+}>, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly machine: Schema.String;
+  readonly kind: Schema.Literals<readonly ["ram", "disk"]>;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+}>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "read", undefined>, Action.Action<"capture", Schema.Struct<{
+  readonly machine: Schema.String;
+  readonly name: Schema.String;
+}>, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly machine: Schema.String;
+  readonly kind: Schema.Literals<readonly ["ram", "disk"]>;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+}>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "write", undefined>, Action.Action<"delete", Schema.Struct<{
+  readonly id: Schema.String;
+}>, Schema.Void, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "write", undefined>], typeof Invalid | typeof Internal>;
+export declare const HostGroup: ActionGroup.Group<"host", readonly [Action.Action<"get", Schema.$Record<Schema.String, Schema.Never>, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly runtime: Schema.Literals<readonly ["smolvm", "tart", "boat"]>;
+  readonly version: Schema.String;
+  readonly runtimeVersion: Schema.String;
+  readonly bases: Schema.$Array<Schema.String>;
+}>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "read", undefined>], typeof Invalid | typeof Internal>;
+export declare const Http: ActionHttp.Http<readonly [ActionGroup.Group<"machine", readonly [Action.Action<"list", Schema.$Record<Schema.String, Schema.Never>, Schema.$Array<Schema.Struct<{
+  readonly id: Schema.String;
+  readonly runtime: Schema.Literals<readonly ["smolvm", "tart", "boat"]>;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly state: Schema.Literals<readonly ["running", "stopped", "missing", "unknown"]>;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+  readonly ssh: Schema.optionalKey<Schema.Struct<{
+    readonly host: Schema.String;
+    readonly port: Schema.Int;
+  }>>;
+  readonly hostKey: Schema.optionalKey<Schema.String>;
+}>>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "read", undefined>, Action.Action<"get", Schema.Struct<{
+  readonly id: Schema.String;
+}>, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly runtime: Schema.Literals<readonly ["smolvm", "tart", "boat"]>;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly state: Schema.Literals<readonly ["running", "stopped", "missing", "unknown"]>;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+  readonly ssh: Schema.optionalKey<Schema.Struct<{
+    readonly host: Schema.String;
+    readonly port: Schema.Int;
+  }>>;
+  readonly hostKey: Schema.optionalKey<Schema.String>;
+}>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "read", undefined>, Action.Action<"create", Schema.Struct<{
+  readonly base: Schema.String;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly setup: Schema.optionalKey<Schema.Struct<{
+    readonly script: Schema.String;
+    readonly timeoutSeconds: Schema.Int;
+  }>>;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly id: Schema.String;
+}>, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly runtime: Schema.Literals<readonly ["smolvm", "tart", "boat"]>;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly state: Schema.Literals<readonly ["running", "stopped", "missing", "unknown"]>;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+  readonly ssh: Schema.optionalKey<Schema.Struct<{
+    readonly host: Schema.String;
+    readonly port: Schema.Int;
+  }>>;
+  readonly hostKey: Schema.optionalKey<Schema.String>;
+}>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "write", undefined>, Action.Action<"start", Schema.Struct<{
+  readonly id: Schema.String;
+}>, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly runtime: Schema.Literals<readonly ["smolvm", "tart", "boat"]>;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly state: Schema.Literals<readonly ["running", "stopped", "missing", "unknown"]>;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+  readonly ssh: Schema.optionalKey<Schema.Struct<{
+    readonly host: Schema.String;
+    readonly port: Schema.Int;
+  }>>;
+  readonly hostKey: Schema.optionalKey<Schema.String>;
+}>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "write", undefined>, Action.Action<"stop", Schema.Struct<{
+  readonly id: Schema.String;
+}>, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly runtime: Schema.Literals<readonly ["smolvm", "tart", "boat"]>;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly state: Schema.Literals<readonly ["running", "stopped", "missing", "unknown"]>;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+  readonly ssh: Schema.optionalKey<Schema.Struct<{
+    readonly host: Schema.String;
+    readonly port: Schema.Int;
+  }>>;
+  readonly hostKey: Schema.optionalKey<Schema.String>;
+}>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "write", undefined>, Action.Action<"delete", Schema.Struct<{
+  readonly id: Schema.String;
+}>, Schema.Void, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "write", undefined>, Action.Action<"fork", Schema.Struct<{
+  readonly machine: Schema.String;
+  readonly name: Schema.String;
+}>, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly runtime: Schema.Literals<readonly ["smolvm", "tart", "boat"]>;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly state: Schema.Literals<readonly ["running", "stopped", "missing", "unknown"]>;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+  readonly ssh: Schema.optionalKey<Schema.Struct<{
+    readonly host: Schema.String;
+    readonly port: Schema.Int;
+  }>>;
+  readonly hostKey: Schema.optionalKey<Schema.String>;
+}>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "write", undefined>, Action.Action<"restore", Schema.Struct<{
+  readonly checkpoint: Schema.String;
+  readonly name: Schema.String;
+}>, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly runtime: Schema.Literals<readonly ["smolvm", "tart", "boat"]>;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly state: Schema.Literals<readonly ["running", "stopped", "missing", "unknown"]>;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+  readonly ssh: Schema.optionalKey<Schema.Struct<{
+    readonly host: Schema.String;
+    readonly port: Schema.Int;
+  }>>;
+  readonly hostKey: Schema.optionalKey<Schema.String>;
+}>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "write", undefined>], typeof Invalid | typeof Internal>, ActionGroup.Group<"checkpoint", readonly [Action.Action<"list", Schema.$Record<Schema.String, Schema.Never>, Schema.$Array<Schema.Struct<{
+  readonly id: Schema.String;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly machine: Schema.String;
+  readonly kind: Schema.Literals<readonly ["ram", "disk"]>;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+}>>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "read", undefined>, Action.Action<"get", Schema.Struct<{
+  readonly id: Schema.String;
+}>, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly machine: Schema.String;
+  readonly kind: Schema.Literals<readonly ["ram", "disk"]>;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+}>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "read", undefined>, Action.Action<"capture", Schema.Struct<{
+  readonly machine: Schema.String;
+  readonly name: Schema.String;
+}>, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly createdAt: Schema.DateTimeUtcFromString;
+  readonly machine: Schema.String;
+  readonly kind: Schema.Literals<readonly ["ram", "disk"]>;
+  readonly base: Schema.String;
+  readonly profile: Schema.optionalKey<Schema.String>;
+  readonly cpu: Schema.Int;
+  readonly ramMib: Schema.Int;
+  readonly diskGib: Schema.Int;
+  readonly action: Schema.Struct<{
+    readonly name: Schema.Literals<readonly ["create", "start", "stop", "delete", "fork", "restore", "capture"]>;
+    readonly status: Schema.Literals<readonly ["running", "failed", "done"]>;
+    readonly error: Schema.optionalKey<Schema.Struct<{
+      readonly tag: Schema.Literals<("Capacity" | "Conflict" | "Internal" | "Invalid" | "NotFound" | "Precondition")[]>;
+      readonly message: Schema.String;
+    }>>;
+  }>;
+}>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "write", undefined>, Action.Action<"delete", Schema.Struct<{
+  readonly id: Schema.String;
+}>, Schema.Void, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "write", undefined>], typeof Invalid | typeof Internal>, ActionGroup.Group<"host", readonly [Action.Action<"get", Schema.$Record<Schema.String, Schema.Never>, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly runtime: Schema.Literals<readonly ["smolvm", "tart", "boat"]>;
+  readonly version: Schema.String;
+  readonly runtimeVersion: Schema.String;
+  readonly bases: Schema.$Array<Schema.String>;
+}>, readonly [typeof Invalid, typeof NotFound, typeof Conflict, typeof Precondition, typeof Capacity, typeof Internal], "read", undefined>], typeof Invalid | typeof Internal>], []>;
+//#endregion
+//#region src/ids.d.ts
+/** A host's part of every ID it holds. */
+export declare const HostId: Schema.String;
+/** A machine's or checkpoint's name, unique per host and per resource type. */
+export declare const Name: Schema.String;
+/** The parts of an ID: the host that holds the resource and the resource's name there. */
+export interface IdParts {
+  readonly host: string;
+  readonly name: string;
+}
+/** A full `<host>_<name>` ID. */
+export declare const Id: Schema.String;
+/** Whether `create`'s target is a full ID rather than a bare name: a name has no `_`. */
+export declare const isId: (target: string) => boolean;
+/** Splits an ID at its `_` into host and name. */
+export declare const parseId: (id: string) => Effect.Effect<IdParts, Invalid>;
+/** Checks a name on its own, before it is joined to a host. */
+export declare const parseName: (name: string) => Effect.Effect<string, Invalid>;
+/** Joins a host ID and a name into the resource's ID, checking both parts and the whole. */
+export declare const formatId: (host: string, name: string) => Effect.Effect<string, Invalid>;
+//#endregion
+//#region src/profile.d.ts
+/** A profile file as read: its fields, with `setup.path` resolved, and its name as `label`. */
+export interface LoadedProfile extends Profile {
+  readonly label: string;
+}
+/**
+ * Reads the profile file at `file`. Its name, the file name without `.json`, is the machine's
+ * `profile` label, and its `setup.path` is resolved against the file's directory. The setup
+ * itself is read by whoever sends it, with `readSetup`.
+ */
+export declare const loadProfile: (file: string) => Effect.Effect<LoadedProfile, Invalid, FileSystem.FileSystem | Path.Path>;
+//#endregion
+//#region src/setup.d.ts
+/**
+ * Packs a recipe directory into one self-extracting script: a base64 tar that unpacks into a
+ * temporary directory, then runs `setup.sh` from there. `COPYFILE_DISABLE=1` and
+ * `--no-xattrs` keep macOS `tar` from adding `._*` files and provenance headers.
+ */
+export declare const packRecipe: (directory: string) => Effect.Effect<string, Invalid, FileSystem.FileSystem | ChildProcessSpawner.ChildProcessSpawner>;
+/** Reads a setup: a script file's text, or a recipe directory packed into one script. */
+export declare const readSetup: (path: string) => Effect.Effect<string, Invalid, FileSystem.FileSystem | ChildProcessSpawner.ChildProcessSpawner>;
+//#endregion
+export { ActionName, ActionRecord, Capacity, Checkpoint, ClankerboxError, client_d_exports as Client, Conflict, ConflictKind, CreateRequest, ErrorTag, Host, HostError, HostErrorTag, Internal, Invalid, Machine, MachineSpec, NotFound, Precondition, Profile, Runtime, Setup, SshEndpoint, Unavailable, hostErrors, release, version };