@toshicloud/sdk 0.5.0 → 0.5.1

package/dist/gen/toshi/workspace/v1/volumes_pb.d.ts

@@ -1,5 +1,5 @@
 import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
-import type { Timestamp, TimestampJson } from "@bufbuild/protobuf/wkt";
+import type { Duration, DurationJson, FieldMask, FieldMaskJson, Timestamp, TimestampJson } from "@bufbuild/protobuf/wkt";
 import type { Message } from "@bufbuild/protobuf";
 /**
  * Describes the file toshi/workspace/v1/volumes.proto.
@@ -54,6 +54,125 @@ export type Volume = Message<"toshi.workspace.v1.Volume"> & {
      * @generated from field: string attached_workload_id = 8;
      */
     attachedWorkloadId: string;
+    /**
+     * The number of its newest saved version; zero when it has none.
+     *
+     * @generated from field: int64 latest_version = 9;
+     */
+    latestVersion: bigint;
+    /**
+     * When its newest version was saved; unset when it has none.
+     *
+     * @generated from field: google.protobuf.Timestamp latest_version_time = 10;
+     */
+    latestVersionTime?: Timestamp | undefined;
+    /**
+     * When it was lost: it had no saved version when the host that held its
+     * only copy was removed, and no run mounts it again. Unset while it is
+     * not lost.
+     *
+     * @generated from field: google.protobuf.Timestamp lost_time = 11;
+     */
+    lostTime?: Timestamp | undefined;
+    /**
+     * What its newest version's data can be trusted for; unspecified when it
+     * has none.
+     *
+     * @generated from field: toshi.workspace.v1.VolumeConsistency latest_version_consistency = 12;
+     */
+    latestVersionConsistency: VolumeConsistency;
+    /**
+     * How often the service, sandbox or CI job that mounts it snapshots it
+     * while its VM runs: its workspace's interval. Unset for a volume that is not a
+     * state volume, for one kept as a directory, which is never snapshotted,
+     * and when the workspace takes no snapshots or saves no versions.
+     *
+     * @generated from field: google.protobuf.Duration snapshot_interval = 13;
+     */
+    snapshotInterval?: Duration | undefined;
+    /**
+     * Why its newest failed save or snapshot saved no version: a pre_save
+     * hook that failed, or a copy its host could not take or upload. Empty
+     * when none failed. A later version does not clear it: compare
+     * last_save_failure_time with latest_version_time.
+     *
+     * @generated from field: string last_save_failure = 14;
+     */
+    lastSaveFailure: string;
+    /**
+     * When that save or snapshot failed; unset when none failed.
+     *
+     * @generated from field: google.protobuf.Timestamp last_save_failure_time = 15;
+     */
+    lastSaveFailureTime?: Timestamp | undefined;
+    /**
+     * How hosts keep a state volume, fixed by the first run that mounts it:
+     * a disk on the VM tiers, a directory on the container tier. Later runs
+     * go only to hosts that keep it the same way. Unspecified until a run
+     * mounted it, and for a volume that is not a state volume.
+     *
+     * @generated from field: toshi.workspace.v1.VolumeFormat format = 16;
+     */
+    format: VolumeFormat;
+    /**
+     * Set when the volume holds a browser profile: it was made as the state
+     * volume of a browser service. A volume made before this field is one
+     * when it was attached to a browser service then. Read-only; it never
+     * changes.
+     *
+     * @generated from field: bool profile = 17;
+     */
+    profile: boolean;
+    /**
+     * The kind of the workload it is attached to, service or sandbox, and
+     * that workload's environment, which GetService and GetSandbox take;
+     * both empty when it is attached to none.
+     *
+     * @generated from field: string attached_workload_kind = 18;
+     */
+    attachedWorkloadKind: string;
+    /**
+     * @generated from field: string attached_environment = 19;
+     */
+    attachedEnvironment: string;
+    /**
+     * Who manages this object: "manifest" when the project manifest declares
+     * it, empty when nothing does. A manifest apply sets managed_by,
+     * manifest_digest, manifest_origin and managed_fields together.
+     *
+     * @generated from field: string managed_by = 20;
+     */
+    managedBy: string;
+    /**
+     * The SHA-256 of the manifest file that last set this object, as 64
+     * lowercase hex characters. Empty when managed_by is empty.
+     *
+     * @generated from field: string manifest_digest = 21;
+     */
+    manifestDigest: string;
+    /**
+     * The fields of this object the manifest declares, as update mask paths.
+     * Empty when managed_by is empty.
+     *
+     * @generated from field: repeated string managed_fields = 22;
+     */
+    managedFields: string[];
+    /**
+     * How the manifest came to manage this object: "created" when a manifest
+     * apply created it, "adopted" when an apply took over an object that
+     * already existed. Empty when managed_by is empty.
+     *
+     * @generated from field: string manifest_origin = 23;
+     */
+    manifestOrigin: string;
+    /**
+     * Set when its newest version is larger than size_cap_bytes: a run that
+     * held it while the cap was lowered saved more. No run mounts it until
+     * the cap is raised or a version within the cap is restored.
+     *
+     * @generated from field: bool latest_version_over_cap = 24;
+     */
+    latestVersionOverCap: boolean;
 };
 /**
  * Volume is a disk of a project.
@@ -104,6 +223,125 @@ export type VolumeJson = {
      * @generated from field: string attached_workload_id = 8;
      */
     attachedWorkloadId?: string;
+    /**
+     * The number of its newest saved version; zero when it has none.
+     *
+     * @generated from field: int64 latest_version = 9;
+     */
+    latestVersion?: string;
+    /**
+     * When its newest version was saved; unset when it has none.
+     *
+     * @generated from field: google.protobuf.Timestamp latest_version_time = 10;
+     */
+    latestVersionTime?: TimestampJson;
+    /**
+     * When it was lost: it had no saved version when the host that held its
+     * only copy was removed, and no run mounts it again. Unset while it is
+     * not lost.
+     *
+     * @generated from field: google.protobuf.Timestamp lost_time = 11;
+     */
+    lostTime?: TimestampJson;
+    /**
+     * What its newest version's data can be trusted for; unspecified when it
+     * has none.
+     *
+     * @generated from field: toshi.workspace.v1.VolumeConsistency latest_version_consistency = 12;
+     */
+    latestVersionConsistency?: VolumeConsistencyJson;
+    /**
+     * How often the service, sandbox or CI job that mounts it snapshots it
+     * while its VM runs: its workspace's interval. Unset for a volume that is not a
+     * state volume, for one kept as a directory, which is never snapshotted,
+     * and when the workspace takes no snapshots or saves no versions.
+     *
+     * @generated from field: google.protobuf.Duration snapshot_interval = 13;
+     */
+    snapshotInterval?: DurationJson;
+    /**
+     * Why its newest failed save or snapshot saved no version: a pre_save
+     * hook that failed, or a copy its host could not take or upload. Empty
+     * when none failed. A later version does not clear it: compare
+     * last_save_failure_time with latest_version_time.
+     *
+     * @generated from field: string last_save_failure = 14;
+     */
+    lastSaveFailure?: string;
+    /**
+     * When that save or snapshot failed; unset when none failed.
+     *
+     * @generated from field: google.protobuf.Timestamp last_save_failure_time = 15;
+     */
+    lastSaveFailureTime?: TimestampJson;
+    /**
+     * How hosts keep a state volume, fixed by the first run that mounts it:
+     * a disk on the VM tiers, a directory on the container tier. Later runs
+     * go only to hosts that keep it the same way. Unspecified until a run
+     * mounted it, and for a volume that is not a state volume.
+     *
+     * @generated from field: toshi.workspace.v1.VolumeFormat format = 16;
+     */
+    format?: VolumeFormatJson;
+    /**
+     * Set when the volume holds a browser profile: it was made as the state
+     * volume of a browser service. A volume made before this field is one
+     * when it was attached to a browser service then. Read-only; it never
+     * changes.
+     *
+     * @generated from field: bool profile = 17;
+     */
+    profile?: boolean;
+    /**
+     * The kind of the workload it is attached to, service or sandbox, and
+     * that workload's environment, which GetService and GetSandbox take;
+     * both empty when it is attached to none.
+     *
+     * @generated from field: string attached_workload_kind = 18;
+     */
+    attachedWorkloadKind?: string;
+    /**
+     * @generated from field: string attached_environment = 19;
+     */
+    attachedEnvironment?: string;
+    /**
+     * Who manages this object: "manifest" when the project manifest declares
+     * it, empty when nothing does. A manifest apply sets managed_by,
+     * manifest_digest, manifest_origin and managed_fields together.
+     *
+     * @generated from field: string managed_by = 20;
+     */
+    managedBy?: string;
+    /**
+     * The SHA-256 of the manifest file that last set this object, as 64
+     * lowercase hex characters. Empty when managed_by is empty.
+     *
+     * @generated from field: string manifest_digest = 21;
+     */
+    manifestDigest?: string;
+    /**
+     * The fields of this object the manifest declares, as update mask paths.
+     * Empty when managed_by is empty.
+     *
+     * @generated from field: repeated string managed_fields = 22;
+     */
+    managedFields?: string[];
+    /**
+     * How the manifest came to manage this object: "created" when a manifest
+     * apply created it, "adopted" when an apply took over an object that
+     * already existed. Empty when managed_by is empty.
+     *
+     * @generated from field: string manifest_origin = 23;
+     */
+    manifestOrigin?: string;
+    /**
+     * Set when its newest version is larger than size_cap_bytes: a run that
+     * held it while the cap was lowered saved more. No run mounts it until
+     * the cap is raised or a version within the cap is restored.
+     *
+     * @generated from field: bool latest_version_over_cap = 24;
+     */
+    latestVersionOverCap?: boolean;
 };
 /**
  * Describes the message toshi.workspace.v1.Volume.
@@ -112,6 +350,111 @@ export type VolumeJson = {
 export declare const VolumeSchema: GenMessage<Volume, {
     jsonType: VolumeJson;
 }>;
+/**
+ * VolumeVersion is a saved copy of a state volume's data.
+ *
+ * @generated from message toshi.workspace.v1.VolumeVersion
+ */
+export type VolumeVersion = Message<"toshi.workspace.v1.VolumeVersion"> & {
+    /**
+     * One higher than the volume's previous version; the first is 1.
+     *
+     * @generated from field: int64 number = 1;
+     */
+    number: bigint;
+    /**
+     * @generated from field: google.protobuf.Timestamp create_time = 2;
+     */
+    createTime?: Timestamp | undefined;
+    /**
+     * The length of the saved copy, in bytes: the disk image, or for a
+     * volume kept as a directory the compressed tar of it.
+     *
+     * @generated from field: int64 size_bytes = 3;
+     */
+    sizeBytes: bigint;
+    /**
+     * The hex SHA-256 of the saved copy.
+     *
+     * @generated from field: string sha256 = 4;
+     */
+    sha256: string;
+    /**
+     * The version RestoreVolume copied this one from; zero for one a run
+     * saved.
+     *
+     * @generated from field: int64 restored_from = 5;
+     */
+    restoredFrom: bigint;
+    /**
+     * Whether a run saved it when it ended or snapshotted it while it ran.
+     *
+     * @generated from field: toshi.workspace.v1.VolumeVersionKind kind = 6;
+     */
+    kind: VolumeVersionKind;
+    /**
+     * What its data can be trusted for.
+     *
+     * @generated from field: toshi.workspace.v1.VolumeConsistency consistency = 7;
+     */
+    consistency: VolumeConsistency;
+};
+/**
+ * VolumeVersion is a saved copy of a state volume's data.
+ *
+ * @generated from message toshi.workspace.v1.VolumeVersion
+ */
+export type VolumeVersionJson = {
+    /**
+     * One higher than the volume's previous version; the first is 1.
+     *
+     * @generated from field: int64 number = 1;
+     */
+    number?: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp create_time = 2;
+     */
+    createTime?: TimestampJson;
+    /**
+     * The length of the saved copy, in bytes: the disk image, or for a
+     * volume kept as a directory the compressed tar of it.
+     *
+     * @generated from field: int64 size_bytes = 3;
+     */
+    sizeBytes?: string;
+    /**
+     * The hex SHA-256 of the saved copy.
+     *
+     * @generated from field: string sha256 = 4;
+     */
+    sha256?: string;
+    /**
+     * The version RestoreVolume copied this one from; zero for one a run
+     * saved.
+     *
+     * @generated from field: int64 restored_from = 5;
+     */
+    restoredFrom?: string;
+    /**
+     * Whether a run saved it when it ended or snapshotted it while it ran.
+     *
+     * @generated from field: toshi.workspace.v1.VolumeVersionKind kind = 6;
+     */
+    kind?: VolumeVersionKindJson;
+    /**
+     * What its data can be trusted for.
+     *
+     * @generated from field: toshi.workspace.v1.VolumeConsistency consistency = 7;
+     */
+    consistency?: VolumeConsistencyJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.VolumeVersion.
+ * Use `create(VolumeVersionSchema)` to create a new message.
+ */
+export declare const VolumeVersionSchema: GenMessage<VolumeVersion, {
+    jsonType: VolumeVersionJson;
+}>;
 /**
  * @generated from message toshi.workspace.v1.ListVolumesRequest
  */
@@ -132,6 +475,12 @@ export type ListVolumesRequest = Message<"toshi.workspace.v1.ListVolumesRequest"
      * @generated from field: string page_token = 3;
      */
     pageToken: string;
+    /**
+     * True lists only the volumes that hold a browser profile (profile set).
+     *
+     * @generated from field: bool profile = 4;
+     */
+    profile: boolean;
 };
 /**
  * @generated from message toshi.workspace.v1.ListVolumesRequest
@@ -146,57 +495,347 @@ export type ListVolumesRequestJson = {
      *
      * @generated from field: int32 page_size = 2;
      */
-    pageSize?: number;
+    pageSize?: number;
+    /**
+     * From an earlier response's next_page_token; empty for the first page.
+     *
+     * @generated from field: string page_token = 3;
+     */
+    pageToken?: string;
+    /**
+     * True lists only the volumes that hold a browser profile (profile set).
+     *
+     * @generated from field: bool profile = 4;
+     */
+    profile?: boolean;
+};
+/**
+ * Describes the message toshi.workspace.v1.ListVolumesRequest.
+ * Use `create(ListVolumesRequestSchema)` to create a new message.
+ */
+export declare const ListVolumesRequestSchema: GenMessage<ListVolumesRequest, {
+    jsonType: ListVolumesRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.ListVolumesResponse
+ */
+export type ListVolumesResponse = Message<"toshi.workspace.v1.ListVolumesResponse"> & {
+    /**
+     * @generated from field: repeated toshi.workspace.v1.Volume volumes = 1;
+     */
+    volumes: Volume[];
+    /**
+     * Empty on the last page.
+     *
+     * @generated from field: string next_page_token = 2;
+     */
+    nextPageToken: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.ListVolumesResponse
+ */
+export type ListVolumesResponseJson = {
+    /**
+     * @generated from field: repeated toshi.workspace.v1.Volume volumes = 1;
+     */
+    volumes?: VolumeJson[];
+    /**
+     * Empty on the last page.
+     *
+     * @generated from field: string next_page_token = 2;
+     */
+    nextPageToken?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.ListVolumesResponse.
+ * Use `create(ListVolumesResponseSchema)` to create a new message.
+ */
+export declare const ListVolumesResponseSchema: GenMessage<ListVolumesResponse, {
+    jsonType: ListVolumesResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetVolumeRequest
+ */
+export type GetVolumeRequest = Message<"toshi.workspace.v1.GetVolumeRequest"> & {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project: string;
+    /**
+     * @generated from field: string volume_id = 2;
+     */
+    volumeId: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.GetVolumeRequest
+ */
+export type GetVolumeRequestJson = {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project?: string;
+    /**
+     * @generated from field: string volume_id = 2;
+     */
+    volumeId?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.GetVolumeRequest.
+ * Use `create(GetVolumeRequestSchema)` to create a new message.
+ */
+export declare const GetVolumeRequestSchema: GenMessage<GetVolumeRequest, {
+    jsonType: GetVolumeRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetVolumeResponse
+ */
+export type GetVolumeResponse = Message<"toshi.workspace.v1.GetVolumeResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.Volume volume = 1;
+     */
+    volume?: Volume | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.GetVolumeResponse
+ */
+export type GetVolumeResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.Volume volume = 1;
+     */
+    volume?: VolumeJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.GetVolumeResponse.
+ * Use `create(GetVolumeResponseSchema)` to create a new message.
+ */
+export declare const GetVolumeResponseSchema: GenMessage<GetVolumeResponse, {
+    jsonType: GetVolumeResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.CreateVolumeRequest
+ */
+export type CreateVolumeRequest = Message<"toshi.workspace.v1.CreateVolumeRequest"> & {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project: string;
+    /**
+     * Unique among the project's volumes that are not deleted.
+     *
+     * @generated from field: string name = 2;
+     */
+    name: string;
+    /**
+     * @generated from field: toshi.workspace.v1.VolumeMode mode = 3;
+     */
+    mode: VolumeMode;
+    /**
+     * The most it holds, in bytes; zero is 10 GiB.
+     *
+     * @generated from field: int64 size_cap_bytes = 4;
+     */
+    sizeCapBytes: bigint;
+    /**
+     * Required: the same key on every retry of this create.
+     *
+     * @generated from field: string request_key = 5;
+     */
+    requestKey: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.CreateVolumeRequest
+ */
+export type CreateVolumeRequestJson = {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project?: string;
+    /**
+     * Unique among the project's volumes that are not deleted.
+     *
+     * @generated from field: string name = 2;
+     */
+    name?: string;
+    /**
+     * @generated from field: toshi.workspace.v1.VolumeMode mode = 3;
+     */
+    mode?: VolumeModeJson;
+    /**
+     * The most it holds, in bytes; zero is 10 GiB.
+     *
+     * @generated from field: int64 size_cap_bytes = 4;
+     */
+    sizeCapBytes?: string;
+    /**
+     * Required: the same key on every retry of this create.
+     *
+     * @generated from field: string request_key = 5;
+     */
+    requestKey?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.CreateVolumeRequest.
+ * Use `create(CreateVolumeRequestSchema)` to create a new message.
+ */
+export declare const CreateVolumeRequestSchema: GenMessage<CreateVolumeRequest, {
+    jsonType: CreateVolumeRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.CreateVolumeResponse
+ */
+export type CreateVolumeResponse = Message<"toshi.workspace.v1.CreateVolumeResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.Volume volume = 1;
+     */
+    volume?: Volume | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.CreateVolumeResponse
+ */
+export type CreateVolumeResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.Volume volume = 1;
+     */
+    volume?: VolumeJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.CreateVolumeResponse.
+ * Use `create(CreateVolumeResponseSchema)` to create a new message.
+ */
+export declare const CreateVolumeResponseSchema: GenMessage<CreateVolumeResponse, {
+    jsonType: CreateVolumeResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.UpdateVolumeRequest
+ */
+export type UpdateVolumeRequest = Message<"toshi.workspace.v1.UpdateVolumeRequest"> & {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project: string;
+    /**
+     * id names the volume; the fields update_mask names carry the new
+     * values.
+     *
+     * @generated from field: toshi.workspace.v1.Volume volume = 2;
+     */
+    volume?: Volume | undefined;
+    /**
+     * name, size_cap_bytes, or both. The paths managed_by, manifest_digest,
+     * manifest_origin and managed_fields set the management mark and go
+     * together: all four or none, and on their own; managed_by "manifest"
+     * needs the digest, an origin and at least one field path, and an empty
+     * managed_by clears all four.
+     *
+     * @generated from field: google.protobuf.FieldMask update_mask = 3;
+     */
+    updateMask?: FieldMask | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.UpdateVolumeRequest
+ */
+export type UpdateVolumeRequestJson = {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project?: string;
+    /**
+     * id names the volume; the fields update_mask names carry the new
+     * values.
+     *
+     * @generated from field: toshi.workspace.v1.Volume volume = 2;
+     */
+    volume?: VolumeJson;
+    /**
+     * name, size_cap_bytes, or both. The paths managed_by, manifest_digest,
+     * manifest_origin and managed_fields set the management mark and go
+     * together: all four or none, and on their own; managed_by "manifest"
+     * needs the digest, an origin and at least one field path, and an empty
+     * managed_by clears all four.
+     *
+     * @generated from field: google.protobuf.FieldMask update_mask = 3;
+     */
+    updateMask?: FieldMaskJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.UpdateVolumeRequest.
+ * Use `create(UpdateVolumeRequestSchema)` to create a new message.
+ */
+export declare const UpdateVolumeRequestSchema: GenMessage<UpdateVolumeRequest, {
+    jsonType: UpdateVolumeRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.UpdateVolumeResponse
+ */
+export type UpdateVolumeResponse = Message<"toshi.workspace.v1.UpdateVolumeResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.Volume volume = 1;
+     */
+    volume?: Volume | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.UpdateVolumeResponse
+ */
+export type UpdateVolumeResponseJson = {
     /**
-     * From an earlier response's next_page_token; empty for the first page.
-     *
-     * @generated from field: string page_token = 3;
+     * @generated from field: toshi.workspace.v1.Volume volume = 1;
      */
-    pageToken?: string;
+    volume?: VolumeJson;
 };
 /**
- * Describes the message toshi.workspace.v1.ListVolumesRequest.
- * Use `create(ListVolumesRequestSchema)` to create a new message.
+ * Describes the message toshi.workspace.v1.UpdateVolumeResponse.
+ * Use `create(UpdateVolumeResponseSchema)` to create a new message.
  */
-export declare const ListVolumesRequestSchema: GenMessage<ListVolumesRequest, {
-    jsonType: ListVolumesRequestJson;
+export declare const UpdateVolumeResponseSchema: GenMessage<UpdateVolumeResponse, {
+    jsonType: UpdateVolumeResponseJson;
 }>;
 /**
- * @generated from message toshi.workspace.v1.ListVolumesResponse
+ * @generated from message toshi.workspace.v1.DeleteVolumeRequest
  */
-export type ListVolumesResponse = Message<"toshi.workspace.v1.ListVolumesResponse"> & {
+export type DeleteVolumeRequest = Message<"toshi.workspace.v1.DeleteVolumeRequest"> & {
     /**
-     * @generated from field: repeated toshi.workspace.v1.Volume volumes = 1;
+     * @generated from field: string project = 1;
      */
-    volumes: Volume[];
+    project: string;
     /**
-     * Empty on the last page.
-     *
-     * @generated from field: string next_page_token = 2;
+     * @generated from field: string volume_id = 2;
      */
-    nextPageToken: string;
+    volumeId: string;
 };
 /**
- * @generated from message toshi.workspace.v1.ListVolumesResponse
+ * @generated from message toshi.workspace.v1.DeleteVolumeRequest
  */
-export type ListVolumesResponseJson = {
+export type DeleteVolumeRequestJson = {
     /**
-     * @generated from field: repeated toshi.workspace.v1.Volume volumes = 1;
+     * @generated from field: string project = 1;
      */
-    volumes?: VolumeJson[];
+    project?: string;
     /**
-     * Empty on the last page.
-     *
-     * @generated from field: string next_page_token = 2;
+     * @generated from field: string volume_id = 2;
      */
-    nextPageToken?: string;
+    volumeId?: string;
 };
 /**
- * Describes the message toshi.workspace.v1.ListVolumesResponse.
- * Use `create(ListVolumesResponseSchema)` to create a new message.
+ * Describes the message toshi.workspace.v1.DeleteVolumeRequest.
+ * Use `create(DeleteVolumeRequestSchema)` to create a new message.
  */
-export declare const ListVolumesResponseSchema: GenMessage<ListVolumesResponse, {
-    jsonType: ListVolumesResponseJson;
+export declare const DeleteVolumeRequestSchema: GenMessage<DeleteVolumeRequest, {
+    jsonType: DeleteVolumeRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.DeleteVolumeResponse
+ */
+export type DeleteVolumeResponse = Message<"toshi.workspace.v1.DeleteVolumeResponse"> & {};
+/**
+ * @generated from message toshi.workspace.v1.DeleteVolumeResponse
+ */
+export type DeleteVolumeResponseJson = {};
+/**
+ * Describes the message toshi.workspace.v1.DeleteVolumeResponse.
+ * Use `create(DeleteVolumeResponseSchema)` to create a new message.
+ */
+export declare const DeleteVolumeResponseSchema: GenMessage<DeleteVolumeResponse, {
+    jsonType: DeleteVolumeResponseJson;
 }>;
 /**
  * @generated from message toshi.workspace.v1.AttachVolumeRequest
@@ -326,6 +965,182 @@ export type DetachVolumeResponseJson = {
 export declare const DetachVolumeResponseSchema: GenMessage<DetachVolumeResponse, {
     jsonType: DetachVolumeResponseJson;
 }>;
+/**
+ * @generated from message toshi.workspace.v1.ListVolumeVersionsRequest
+ */
+export type ListVolumeVersionsRequest = Message<"toshi.workspace.v1.ListVolumeVersionsRequest"> & {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project: string;
+    /**
+     * @generated from field: string volume_id = 2;
+     */
+    volumeId: string;
+    /**
+     * The most versions in one page; zero lets the server choose.
+     *
+     * @generated from field: int32 page_size = 3;
+     */
+    pageSize: number;
+    /**
+     * From an earlier response's next_page_token; empty for the first page.
+     *
+     * @generated from field: string page_token = 4;
+     */
+    pageToken: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.ListVolumeVersionsRequest
+ */
+export type ListVolumeVersionsRequestJson = {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project?: string;
+    /**
+     * @generated from field: string volume_id = 2;
+     */
+    volumeId?: string;
+    /**
+     * The most versions in one page; zero lets the server choose.
+     *
+     * @generated from field: int32 page_size = 3;
+     */
+    pageSize?: number;
+    /**
+     * From an earlier response's next_page_token; empty for the first page.
+     *
+     * @generated from field: string page_token = 4;
+     */
+    pageToken?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.ListVolumeVersionsRequest.
+ * Use `create(ListVolumeVersionsRequestSchema)` to create a new message.
+ */
+export declare const ListVolumeVersionsRequestSchema: GenMessage<ListVolumeVersionsRequest, {
+    jsonType: ListVolumeVersionsRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.ListVolumeVersionsResponse
+ */
+export type ListVolumeVersionsResponse = Message<"toshi.workspace.v1.ListVolumeVersionsResponse"> & {
+    /**
+     * @generated from field: repeated toshi.workspace.v1.VolumeVersion versions = 1;
+     */
+    versions: VolumeVersion[];
+    /**
+     * Empty on the last page.
+     *
+     * @generated from field: string next_page_token = 2;
+     */
+    nextPageToken: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.ListVolumeVersionsResponse
+ */
+export type ListVolumeVersionsResponseJson = {
+    /**
+     * @generated from field: repeated toshi.workspace.v1.VolumeVersion versions = 1;
+     */
+    versions?: VolumeVersionJson[];
+    /**
+     * Empty on the last page.
+     *
+     * @generated from field: string next_page_token = 2;
+     */
+    nextPageToken?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.ListVolumeVersionsResponse.
+ * Use `create(ListVolumeVersionsResponseSchema)` to create a new message.
+ */
+export declare const ListVolumeVersionsResponseSchema: GenMessage<ListVolumeVersionsResponse, {
+    jsonType: ListVolumeVersionsResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.RestoreVolumeRequest
+ */
+export type RestoreVolumeRequest = Message<"toshi.workspace.v1.RestoreVolumeRequest"> & {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project: string;
+    /**
+     * @generated from field: string volume_id = 2;
+     */
+    volumeId: string;
+    /**
+     * The number of the version to copy.
+     *
+     * @generated from field: int64 version = 3;
+     */
+    version: bigint;
+};
+/**
+ * @generated from message toshi.workspace.v1.RestoreVolumeRequest
+ */
+export type RestoreVolumeRequestJson = {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project?: string;
+    /**
+     * @generated from field: string volume_id = 2;
+     */
+    volumeId?: string;
+    /**
+     * The number of the version to copy.
+     *
+     * @generated from field: int64 version = 3;
+     */
+    version?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.RestoreVolumeRequest.
+ * Use `create(RestoreVolumeRequestSchema)` to create a new message.
+ */
+export declare const RestoreVolumeRequestSchema: GenMessage<RestoreVolumeRequest, {
+    jsonType: RestoreVolumeRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.RestoreVolumeResponse
+ */
+export type RestoreVolumeResponse = Message<"toshi.workspace.v1.RestoreVolumeResponse"> & {
+    /**
+     * The version the restore recorded.
+     *
+     * @generated from field: toshi.workspace.v1.VolumeVersion version = 1;
+     */
+    version?: VolumeVersion | undefined;
+    /**
+     * @generated from field: toshi.workspace.v1.Volume volume = 2;
+     */
+    volume?: Volume | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.RestoreVolumeResponse
+ */
+export type RestoreVolumeResponseJson = {
+    /**
+     * The version the restore recorded.
+     *
+     * @generated from field: toshi.workspace.v1.VolumeVersion version = 1;
+     */
+    version?: VolumeVersionJson;
+    /**
+     * @generated from field: toshi.workspace.v1.Volume volume = 2;
+     */
+    volume?: VolumeJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.RestoreVolumeResponse.
+ * Use `create(RestoreVolumeResponseSchema)` to create a new message.
+ */
+export declare const RestoreVolumeResponseSchema: GenMessage<RestoreVolumeResponse, {
+    jsonType: RestoreVolumeResponseJson;
+}>;
 /**
  * VolumeMode is what a volume holds and how runs use it.
  *
@@ -373,6 +1188,113 @@ export type VolumeModeJson = "VOLUME_MODE_UNSPECIFIED" | "VOLUME_MODE_CACHE" | "
  * Describes the enum toshi.workspace.v1.VolumeMode.
  */
 export declare const VolumeModeSchema: GenEnum<VolumeMode, VolumeModeJson>;
+/**
+ * VolumeFormat is how hosts keep a state volume, and so what its saved
+ * versions hold.
+ *
+ * @generated from enum toshi.workspace.v1.VolumeFormat
+ */
+export declare enum VolumeFormat {
+    /**
+     * @generated from enum value: VOLUME_FORMAT_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * A disk image a VM attaches. A version holds the image.
+     *
+     * @generated from enum value: VOLUME_FORMAT_DISK = 1;
+     */
+    DISK = 1,
+    /**
+     * A directory a container mounts. A version holds a tar of it.
+     *
+     * @generated from enum value: VOLUME_FORMAT_DIRECTORY = 2;
+     */
+    DIRECTORY = 2
+}
+/**
+ * VolumeFormat is how hosts keep a state volume, and so what its saved
+ * versions hold.
+ *
+ * @generated from enum toshi.workspace.v1.VolumeFormat
+ */
+export type VolumeFormatJson = "VOLUME_FORMAT_UNSPECIFIED" | "VOLUME_FORMAT_DISK" | "VOLUME_FORMAT_DIRECTORY";
+/**
+ * Describes the enum toshi.workspace.v1.VolumeFormat.
+ */
+export declare const VolumeFormatSchema: GenEnum<VolumeFormat, VolumeFormatJson>;
+/**
+ * VolumeVersionKind is how a run made a volume version.
+ *
+ * @generated from enum toshi.workspace.v1.VolumeVersionKind
+ */
+export declare enum VolumeVersionKind {
+    /**
+     * @generated from enum value: VOLUME_VERSION_KIND_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Saved when the run that mounted the volume ended, or restored from
+     * such a version.
+     *
+     * @generated from enum value: VOLUME_VERSION_KIND_SAVE = 1;
+     */
+    SAVE = 1,
+    /**
+     * Taken while the run's VM ran. A run's complete snapshot, and its save,
+     * replace its earlier snapshots; an incremental snapshot keeps the ones
+     * it is based on.
+     *
+     * @generated from enum value: VOLUME_VERSION_KIND_SNAPSHOT = 2;
+     */
+    SNAPSHOT = 2
+}
+/**
+ * VolumeVersionKind is how a run made a volume version.
+ *
+ * @generated from enum toshi.workspace.v1.VolumeVersionKind
+ */
+export type VolumeVersionKindJson = "VOLUME_VERSION_KIND_UNSPECIFIED" | "VOLUME_VERSION_KIND_SAVE" | "VOLUME_VERSION_KIND_SNAPSHOT";
+/**
+ * Describes the enum toshi.workspace.v1.VolumeVersionKind.
+ */
+export declare const VolumeVersionKindSchema: GenEnum<VolumeVersionKind, VolumeVersionKindJson>;
+/**
+ * VolumeConsistency is what a volume version's data can be trusted for.
+ *
+ * @generated from enum toshi.workspace.v1.VolumeConsistency
+ */
+export declare enum VolumeConsistency {
+    /**
+     * @generated from enum value: VOLUME_CONSISTENCY_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * The data as a power cut would leave it: a file system recovers it, an
+     * application may need to repair what it was writing.
+     *
+     * @generated from enum value: VOLUME_CONSISTENCY_CRASH = 1;
+     */
+    CRASH = 1,
+    /**
+     * The application settled it first: the service's pre_snapshot hook
+     * exited 0 before the snapshot, the run's pre_save hook exited 0 before
+     * the save, or the guest unmounted the volume cleanly before the save.
+     *
+     * @generated from enum value: VOLUME_CONSISTENCY_APPLICATION = 2;
+     */
+    APPLICATION = 2
+}
+/**
+ * VolumeConsistency is what a volume version's data can be trusted for.
+ *
+ * @generated from enum toshi.workspace.v1.VolumeConsistency
+ */
+export type VolumeConsistencyJson = "VOLUME_CONSISTENCY_UNSPECIFIED" | "VOLUME_CONSISTENCY_CRASH" | "VOLUME_CONSISTENCY_APPLICATION";
+/**
+ * Describes the enum toshi.workspace.v1.VolumeConsistency.
+ */
+export declare const VolumeConsistencySchema: GenEnum<VolumeConsistency, VolumeConsistencyJson>;
 /**
  * VolumeService keeps a workspace's volumes: each belongs to one project,
  * and a state volume attaches to one service or sandbox of that project at
@@ -387,9 +1309,11 @@ export declare const VolumeModeSchema: GenEnum<VolumeMode, VolumeModeJson>;
  * whether the workspace has it or not, and a workload of another project
  * is NOT_FOUND.
  *
- * The calls take no request_key: attaching a volume to the workload it is
- * attached to, while no run holds it, and detaching a detached volume
- * return it as it is.
+ * CreateVolume takes a request_key; the other calls take none: attaching a
+ * volume to the workload it is attached to, while no run holds it, and
+ * detaching a detached volume return it as it is. UpdateVolume sent twice
+ * ends with the same values. RestoreVolume sent twice records two
+ * versions, each a copy of the one it names.
  *
  * @generated from service toshi.workspace.v1.VolumeService
  */
@@ -407,6 +1331,51 @@ export declare const VolumeService: GenService<{
         input: typeof ListVolumesRequestSchema;
         output: typeof ListVolumesResponseSchema;
     };
+    /**
+     * GetVolume returns one of the project's volumes that is not deleted.
+     *
+     * @generated from rpc toshi.workspace.v1.VolumeService.GetVolume
+     */
+    getVolume: {
+        methodKind: "unary";
+        input: typeof GetVolumeRequestSchema;
+        output: typeof GetVolumeResponseSchema;
+    };
+    /**
+     * CreateVolume makes a volume in the project, in any of the four modes:
+     * empty, with no version, and attached to nothing. A name another of the
+     * project's volumes has, deleted ones aside, fails with ALREADY_EXISTS. A
+     * name a service could not take, a missing mode and a negative size cap
+     * fail with INVALID_ARGUMENT; a size cap of zero is 10 GiB.
+     *
+     * The same request sent again with its request_key returns the volume the
+     * first one made; the key with a different request fails with
+     * FAILED_PRECONDITION.
+     *
+     * @generated from rpc toshi.workspace.v1.VolumeService.CreateVolume
+     */
+    createVolume: {
+        methodKind: "unary";
+        input: typeof CreateVolumeRequestSchema;
+        output: typeof CreateVolumeResponseSchema;
+    };
+    /**
+     * UpdateVolume renames a volume or changes its size cap, the two paths
+     * update_mask may name; its mode is fixed. A name another of the
+     * project's volumes has, deleted ones aside, fails with ALREADY_EXISTS.
+     * A size cap below the newest version's size, a negative one, a mode
+     * path and any other path fail with INVALID_ARGUMENT; a size cap of zero
+     * is 10 GiB. A volume may be renamed while attached or held by a run; an
+     * environment that allows a CI job's state volume by its old name no
+     * longer matches it.
+     *
+     * @generated from rpc toshi.workspace.v1.VolumeService.UpdateVolume
+     */
+    updateVolume: {
+        methodKind: "unary";
+        input: typeof UpdateVolumeRequestSchema;
+        output: typeof UpdateVolumeResponseSchema;
+    };
     /**
      * AttachVolume attaches a state volume to a service or sandbox: the
      * service's next run mounts it, and a sandbox mounts it when it starts.
@@ -441,4 +1410,54 @@ export declare const VolumeService: GenService<{
         input: typeof DetachVolumeRequestSchema;
         output: typeof DetachVolumeResponseSchema;
     };
+    /**
+     * DeleteVolume deletes a volume with its saved versions and their data.
+     * A volume attached to a service or sandbox, one a run holds and one a
+     * job that has not ended names fail with FAILED_PRECONDITION. Its name is
+     * free for a new volume at once, and its versions' data is removed from
+     * object storage shortly after. An environment that allows a CI job's
+     * state volume by name keeps that name, and a later volume of the name
+     * matches it.
+     *
+     * @generated from rpc toshi.workspace.v1.VolumeService.DeleteVolume
+     */
+    deleteVolume: {
+        methodKind: "unary";
+        input: typeof DeleteVolumeRequestSchema;
+        output: typeof DeleteVolumeResponseSchema;
+    };
+    /**
+     * ListVolumeVersions returns a state volume's saved versions, newest
+     * first. A run that releases the volume saves its data as the next
+     * version when the workspace has object storage. The volume keeps its
+     * five newest saves and any version after the oldest of them, the one a
+     * run holding it started from and any a kept version is based on; the
+     * others expire and are not listed.
+     *
+     * A page holds 100 versions when page_size is zero, and 1000 at most.
+     *
+     * @generated from rpc toshi.workspace.v1.VolumeService.ListVolumeVersions
+     */
+    listVolumeVersions: {
+        methodKind: "unary";
+        input: typeof ListVolumeVersionsRequestSchema;
+        output: typeof ListVolumeVersionsResponseSchema;
+    };
+    /**
+     * RestoreVolume copies one of a state volume's versions as its next
+     * version, so the next run that mounts the volume starts from that data.
+     * The new version names the version it was copied from. A volume a run
+     * holds fails with FAILED_PRECONDITION, as do a volume that is not a
+     * state volume and an expired version, and so does a control plane that
+     * keeps no versions. A version below 1 fails with INVALID_ARGUMENT, and
+     * one the volume does not have is NOT_FOUND. A copy the storage provider
+     * cannot make fails with UNAVAILABLE.
+     *
+     * @generated from rpc toshi.workspace.v1.VolumeService.RestoreVolume
+     */
+    restoreVolume: {
+        methodKind: "unary";
+        input: typeof RestoreVolumeRequestSchema;
+        output: typeof RestoreVolumeResponseSchema;
+    };
 }>;