@toshicloud/sdk 0.2.0 → 0.3.1

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

@@ -0,0 +1,2048 @@
+import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { Timestamp, TimestampJson } from "@bufbuild/protobuf/wkt";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file toshi/workspace/v1/hostjobs.proto.
+ */
+export declare const file_toshi_workspace_v1_hostjobs: GenFile;
+/**
+ * @generated from message toshi.workspace.v1.ListHostJobsRequest
+ */
+export type ListHostJobsRequest = Message<"toshi.workspace.v1.ListHostJobsRequest"> & {
+    /**
+     * Host jobs in any of these states; empty for every state.
+     *
+     * @generated from field: repeated toshi.workspace.v1.HostJobState states = 1;
+     */
+    states: HostJobState[];
+    /**
+     * Host jobs of this repository, as "owner/name"; empty for every one.
+     *
+     * @generated from field: string repository = 2;
+     */
+    repository: string;
+    /**
+     * The host jobs of this workload: a job's, a sandbox's or a service's id.
+     * Empty for every host job.
+     *
+     * @generated from field: string workload_id = 3;
+     */
+    workloadId: string;
+    /**
+     * The most host jobs in one page; zero lets the server choose.
+     *
+     * @generated from field: int32 page_size = 4;
+     */
+    pageSize: number;
+    /**
+     * From an earlier response's next_page_token; empty for the first page.
+     *
+     * @generated from field: string page_token = 5;
+     */
+    pageToken: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.ListHostJobsRequest
+ */
+export type ListHostJobsRequestJson = {
+    /**
+     * Host jobs in any of these states; empty for every state.
+     *
+     * @generated from field: repeated toshi.workspace.v1.HostJobState states = 1;
+     */
+    states?: HostJobStateJson[];
+    /**
+     * Host jobs of this repository, as "owner/name"; empty for every one.
+     *
+     * @generated from field: string repository = 2;
+     */
+    repository?: string;
+    /**
+     * The host jobs of this workload: a job's, a sandbox's or a service's id.
+     * Empty for every host job.
+     *
+     * @generated from field: string workload_id = 3;
+     */
+    workloadId?: string;
+    /**
+     * The most host jobs in one page; zero lets the server choose.
+     *
+     * @generated from field: int32 page_size = 4;
+     */
+    pageSize?: number;
+    /**
+     * From an earlier response's next_page_token; empty for the first page.
+     *
+     * @generated from field: string page_token = 5;
+     */
+    pageToken?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.ListHostJobsRequest.
+ * Use `create(ListHostJobsRequestSchema)` to create a new message.
+ */
+export declare const ListHostJobsRequestSchema: GenMessage<ListHostJobsRequest, {
+    jsonType: ListHostJobsRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.ListHostJobsResponse
+ */
+export type ListHostJobsResponse = Message<"toshi.workspace.v1.ListHostJobsResponse"> & {
+    /**
+     * @generated from field: repeated toshi.workspace.v1.HostJob host_jobs = 1;
+     */
+    hostJobs: HostJob[];
+    /**
+     * Empty on the last page.
+     *
+     * @generated from field: string next_page_token = 2;
+     */
+    nextPageToken: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.ListHostJobsResponse
+ */
+export type ListHostJobsResponseJson = {
+    /**
+     * @generated from field: repeated toshi.workspace.v1.HostJob host_jobs = 1;
+     */
+    hostJobs?: HostJobJson[];
+    /**
+     * Empty on the last page.
+     *
+     * @generated from field: string next_page_token = 2;
+     */
+    nextPageToken?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.ListHostJobsResponse.
+ * Use `create(ListHostJobsResponseSchema)` to create a new message.
+ */
+export declare const ListHostJobsResponseSchema: GenMessage<ListHostJobsResponse, {
+    jsonType: ListHostJobsResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetHostJobRequest
+ */
+export type GetHostJobRequest = Message<"toshi.workspace.v1.GetHostJobRequest"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.GetHostJobRequest
+ */
+export type GetHostJobRequestJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.GetHostJobRequest.
+ * Use `create(GetHostJobRequestSchema)` to create a new message.
+ */
+export declare const GetHostJobRequestSchema: GenMessage<GetHostJobRequest, {
+    jsonType: GetHostJobRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetHostJobResponse
+ */
+export type GetHostJobResponse = Message<"toshi.workspace.v1.GetHostJobResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.HostJob host_job = 1;
+     */
+    hostJob?: HostJob | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.GetHostJobResponse
+ */
+export type GetHostJobResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.HostJob host_job = 1;
+     */
+    hostJob?: HostJobJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.GetHostJobResponse.
+ * Use `create(GetHostJobResponseSchema)` to create a new message.
+ */
+export declare const GetHostJobResponseSchema: GenMessage<GetHostJobResponse, {
+    jsonType: GetHostJobResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.CancelHostJobRequest
+ */
+export type CancelHostJobRequest = Message<"toshi.workspace.v1.CancelHostJobRequest"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.CancelHostJobRequest
+ */
+export type CancelHostJobRequestJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.CancelHostJobRequest.
+ * Use `create(CancelHostJobRequestSchema)` to create a new message.
+ */
+export declare const CancelHostJobRequestSchema: GenMessage<CancelHostJobRequest, {
+    jsonType: CancelHostJobRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.CancelHostJobResponse
+ */
+export type CancelHostJobResponse = Message<"toshi.workspace.v1.CancelHostJobResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.HostJob host_job = 1;
+     */
+    hostJob?: HostJob | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.CancelHostJobResponse
+ */
+export type CancelHostJobResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.HostJob host_job = 1;
+     */
+    hostJob?: HostJobJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.CancelHostJobResponse.
+ * Use `create(CancelHostJobResponseSchema)` to create a new message.
+ */
+export declare const CancelHostJobResponseSchema: GenMessage<CancelHostJobResponse, {
+    jsonType: CancelHostJobResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetHostJobFailureRequest
+ */
+export type GetHostJobFailureRequest = Message<"toshi.workspace.v1.GetHostJobFailureRequest"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.GetHostJobFailureRequest
+ */
+export type GetHostJobFailureRequestJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.GetHostJobFailureRequest.
+ * Use `create(GetHostJobFailureRequestSchema)` to create a new message.
+ */
+export declare const GetHostJobFailureRequestSchema: GenMessage<GetHostJobFailureRequest, {
+    jsonType: GetHostJobFailureRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetHostJobFailureResponse
+ */
+export type GetHostJobFailureResponse = Message<"toshi.workspace.v1.GetHostJobFailureResponse"> & {
+    /**
+     * Toshi's cause in one word, such as "out_of_memory", "time_limit",
+     * "vm_died" or "step_failed"; "none" for a host job that succeeded and
+     * "not_ended" for one that has not ended. The full list: "none",
+     * "not_ended", "out_of_memory", "refused", "time_limit", "cancelled",
+     * "cancelled_by_tenant", "cancelled_by_operator", "cancelled_by_uninstall",
+     * "vm_died", "host_lost", "host_revoked", "stop_unconfirmed",
+     * "runner_not_started", "runner_exited", "failed", "too_small",
+     * "throttled", "step_failed", "timed_out", "cancelled_on_github" and
+     * "unknown".
+     *
+     * @generated from field: string cause = 1;
+     */
+    cause: string;
+    /**
+     * The cause in one sentence. Where the dashboard's Jobs table shows why
+     * the host job ended, this is the same text. A host job that ran out of
+     * time with a cold cache or without its cache disk gets a second sentence
+     * saying so.
+     *
+     * @generated from field: string explanation = 2;
+     */
+    explanation: string;
+    /**
+     * GitHub's conclusion for the host job, such as "success" or "failure".
+     * Empty when GitHub has not concluded it.
+     *
+     * @generated from field: string conclusion = 3;
+     */
+    conclusion: string;
+    /**
+     * The same as HostJobTelemetrySummary.verdict and verdict_reason.
+     *
+     * @generated from field: string verdict = 4;
+     */
+    verdict: string;
+    /**
+     * @generated from field: string verdict_reason = 5;
+     */
+    verdictReason: string;
+    /**
+     * One line on what to do next.
+     *
+     * @generated from field: string what_to_do = 6;
+     */
+    whatToDo: string;
+    /**
+     * The host job's page on GitHub, and its page on the dashboard. Each is
+     * empty when Toshi does not know it.
+     *
+     * @generated from field: string github_url = 7;
+     */
+    githubUrl: string;
+    /**
+     * @generated from field: string dashboard_url = 8;
+     */
+    dashboardUrl: string;
+    /**
+     * How earlier failures of the same job went when they were re-run on
+     * GitHub. Unset for a host job that succeeded, has not ended or was
+     * refused, and for one without a name.
+     *
+     * @generated from field: toshi.workspace.v1.HostJobFailureHistory history = 9;
+     */
+    history?: HostJobFailureHistory | undefined;
+    /**
+     * The host job's cache line, as HostJob.cache.line. Empty when its host
+     * reported nothing about a cache disk.
+     *
+     * @generated from field: string cache = 10;
+     */
+    cache: string;
+    /**
+     * The host job's tier line, as HostJob.tier_line. Empty for one that ran
+     * in a VM.
+     *
+     * @generated from field: string tier_line = 11;
+     */
+    tierLine: string;
+    /**
+     * The host job's id.
+     *
+     * @generated from field: string job_id = 12;
+     */
+    jobId: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.GetHostJobFailureResponse
+ */
+export type GetHostJobFailureResponseJson = {
+    /**
+     * Toshi's cause in one word, such as "out_of_memory", "time_limit",
+     * "vm_died" or "step_failed"; "none" for a host job that succeeded and
+     * "not_ended" for one that has not ended. The full list: "none",
+     * "not_ended", "out_of_memory", "refused", "time_limit", "cancelled",
+     * "cancelled_by_tenant", "cancelled_by_operator", "cancelled_by_uninstall",
+     * "vm_died", "host_lost", "host_revoked", "stop_unconfirmed",
+     * "runner_not_started", "runner_exited", "failed", "too_small",
+     * "throttled", "step_failed", "timed_out", "cancelled_on_github" and
+     * "unknown".
+     *
+     * @generated from field: string cause = 1;
+     */
+    cause?: string;
+    /**
+     * The cause in one sentence. Where the dashboard's Jobs table shows why
+     * the host job ended, this is the same text. A host job that ran out of
+     * time with a cold cache or without its cache disk gets a second sentence
+     * saying so.
+     *
+     * @generated from field: string explanation = 2;
+     */
+    explanation?: string;
+    /**
+     * GitHub's conclusion for the host job, such as "success" or "failure".
+     * Empty when GitHub has not concluded it.
+     *
+     * @generated from field: string conclusion = 3;
+     */
+    conclusion?: string;
+    /**
+     * The same as HostJobTelemetrySummary.verdict and verdict_reason.
+     *
+     * @generated from field: string verdict = 4;
+     */
+    verdict?: string;
+    /**
+     * @generated from field: string verdict_reason = 5;
+     */
+    verdictReason?: string;
+    /**
+     * One line on what to do next.
+     *
+     * @generated from field: string what_to_do = 6;
+     */
+    whatToDo?: string;
+    /**
+     * The host job's page on GitHub, and its page on the dashboard. Each is
+     * empty when Toshi does not know it.
+     *
+     * @generated from field: string github_url = 7;
+     */
+    githubUrl?: string;
+    /**
+     * @generated from field: string dashboard_url = 8;
+     */
+    dashboardUrl?: string;
+    /**
+     * How earlier failures of the same job went when they were re-run on
+     * GitHub. Unset for a host job that succeeded, has not ended or was
+     * refused, and for one without a name.
+     *
+     * @generated from field: toshi.workspace.v1.HostJobFailureHistory history = 9;
+     */
+    history?: HostJobFailureHistoryJson;
+    /**
+     * The host job's cache line, as HostJob.cache.line. Empty when its host
+     * reported nothing about a cache disk.
+     *
+     * @generated from field: string cache = 10;
+     */
+    cache?: string;
+    /**
+     * The host job's tier line, as HostJob.tier_line. Empty for one that ran
+     * in a VM.
+     *
+     * @generated from field: string tier_line = 11;
+     */
+    tierLine?: string;
+    /**
+     * The host job's id.
+     *
+     * @generated from field: string job_id = 12;
+     */
+    jobId?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.GetHostJobFailureResponse.
+ * Use `create(GetHostJobFailureResponseSchema)` to create a new message.
+ */
+export declare const GetHostJobFailureResponseSchema: GenMessage<GetHostJobFailureResponse, {
+    jsonType: GetHostJobFailureResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetHostJobTelemetryRequest
+ */
+export type GetHostJobTelemetryRequest = Message<"toshi.workspace.v1.GetHostJobTelemetryRequest"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.GetHostJobTelemetryRequest
+ */
+export type GetHostJobTelemetryRequestJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.GetHostJobTelemetryRequest.
+ * Use `create(GetHostJobTelemetryRequestSchema)` to create a new message.
+ */
+export declare const GetHostJobTelemetryRequestSchema: GenMessage<GetHostJobTelemetryRequest, {
+    jsonType: GetHostJobTelemetryRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetHostJobTelemetryResponse
+ */
+export type GetHostJobTelemetryResponse = Message<"toshi.workspace.v1.GetHostJobTelemetryResponse"> & {
+    /**
+     * The host job's runner size and its VM's vCPUs and memory, to scale the
+     * samples by.
+     *
+     * @generated from field: string size = 1;
+     */
+    size: string;
+    /**
+     * @generated from field: int32 vcpus = 2;
+     */
+    vcpus: number;
+    /**
+     * @generated from field: int64 memory_mib = 3;
+     */
+    memoryMib: bigint;
+    /**
+     * Unset when the host job has no samples.
+     *
+     * @generated from field: toshi.workspace.v1.HostJobTelemetrySummary summary = 4;
+     */
+    summary?: HostJobTelemetrySummary | undefined;
+    /**
+     * Oldest first.
+     *
+     * @generated from field: repeated toshi.workspace.v1.HostJobTelemetrySample samples = 5;
+     */
+    samples: HostJobTelemetrySample[];
+};
+/**
+ * @generated from message toshi.workspace.v1.GetHostJobTelemetryResponse
+ */
+export type GetHostJobTelemetryResponseJson = {
+    /**
+     * The host job's runner size and its VM's vCPUs and memory, to scale the
+     * samples by.
+     *
+     * @generated from field: string size = 1;
+     */
+    size?: string;
+    /**
+     * @generated from field: int32 vcpus = 2;
+     */
+    vcpus?: number;
+    /**
+     * @generated from field: int64 memory_mib = 3;
+     */
+    memoryMib?: string;
+    /**
+     * Unset when the host job has no samples.
+     *
+     * @generated from field: toshi.workspace.v1.HostJobTelemetrySummary summary = 4;
+     */
+    summary?: HostJobTelemetrySummaryJson;
+    /**
+     * Oldest first.
+     *
+     * @generated from field: repeated toshi.workspace.v1.HostJobTelemetrySample samples = 5;
+     */
+    samples?: HostJobTelemetrySampleJson[];
+};
+/**
+ * Describes the message toshi.workspace.v1.GetHostJobTelemetryResponse.
+ * Use `create(GetHostJobTelemetryResponseSchema)` to create a new message.
+ */
+export declare const GetHostJobTelemetryResponseSchema: GenMessage<GetHostJobTelemetryResponse, {
+    jsonType: GetHostJobTelemetryResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetHostJobDebugAccessRequest
+ */
+export type GetHostJobDebugAccessRequest = Message<"toshi.workspace.v1.GetHostJobDebugAccessRequest"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.GetHostJobDebugAccessRequest
+ */
+export type GetHostJobDebugAccessRequestJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.GetHostJobDebugAccessRequest.
+ * Use `create(GetHostJobDebugAccessRequestSchema)` to create a new message.
+ */
+export declare const GetHostJobDebugAccessRequestSchema: GenMessage<GetHostJobDebugAccessRequest, {
+    jsonType: GetHostJobDebugAccessRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetHostJobDebugAccessResponse
+ */
+export type GetHostJobDebugAccessResponse = Message<"toshi.workspace.v1.GetHostJobDebugAccessResponse"> & {
+    /**
+     * The guest's login user.
+     *
+     * @generated from field: string user = 1;
+     */
+    user: string;
+    /**
+     * The session's ed25519 private key in OpenSSH format. It is returned
+     * only here, once per session.
+     *
+     * @generated from field: bytes private_key = 2;
+     */
+    privateKey: Uint8Array;
+    /**
+     * The relay's path on the control plane, "/debug/<host job id>/ssh". A
+     * GET with "Connection: Upgrade" and "Upgrade: toshi-debug-ssh", carrying
+     * the same token or session as this call, becomes a byte stream to the
+     * guest's ssh server.
+     *
+     * @generated from field: string relay_path = 3;
+     */
+    relayPath: string;
+    /**
+     * When the session ends.
+     *
+     * @generated from field: google.protobuf.Timestamp expires_at = 4;
+     */
+    expiresAt?: Timestamp | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.GetHostJobDebugAccessResponse
+ */
+export type GetHostJobDebugAccessResponseJson = {
+    /**
+     * The guest's login user.
+     *
+     * @generated from field: string user = 1;
+     */
+    user?: string;
+    /**
+     * The session's ed25519 private key in OpenSSH format. It is returned
+     * only here, once per session.
+     *
+     * @generated from field: bytes private_key = 2;
+     */
+    privateKey?: string;
+    /**
+     * The relay's path on the control plane, "/debug/<host job id>/ssh". A
+     * GET with "Connection: Upgrade" and "Upgrade: toshi-debug-ssh", carrying
+     * the same token or session as this call, becomes a byte stream to the
+     * guest's ssh server.
+     *
+     * @generated from field: string relay_path = 3;
+     */
+    relayPath?: string;
+    /**
+     * When the session ends.
+     *
+     * @generated from field: google.protobuf.Timestamp expires_at = 4;
+     */
+    expiresAt?: TimestampJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.GetHostJobDebugAccessResponse.
+ * Use `create(GetHostJobDebugAccessResponseSchema)` to create a new message.
+ */
+export declare const GetHostJobDebugAccessResponseSchema: GenMessage<GetHostJobDebugAccessResponse, {
+    jsonType: GetHostJobDebugAccessResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.StopHostJobDebugRequest
+ */
+export type StopHostJobDebugRequest = Message<"toshi.workspace.v1.StopHostJobDebugRequest"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.StopHostJobDebugRequest
+ */
+export type StopHostJobDebugRequestJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.StopHostJobDebugRequest.
+ * Use `create(StopHostJobDebugRequestSchema)` to create a new message.
+ */
+export declare const StopHostJobDebugRequestSchema: GenMessage<StopHostJobDebugRequest, {
+    jsonType: StopHostJobDebugRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.StopHostJobDebugResponse
+ */
+export type StopHostJobDebugResponse = Message<"toshi.workspace.v1.StopHostJobDebugResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.HostJob host_job = 1;
+     */
+    hostJob?: HostJob | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.StopHostJobDebugResponse
+ */
+export type StopHostJobDebugResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.HostJob host_job = 1;
+     */
+    hostJob?: HostJobJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.StopHostJobDebugResponse.
+ * Use `create(StopHostJobDebugResponseSchema)` to create a new message.
+ */
+export declare const StopHostJobDebugResponseSchema: GenMessage<StopHostJobDebugResponse, {
+    jsonType: StopHostJobDebugResponseJson;
+}>;
+/**
+ * HostJob is one run on a host: a GitHub Actions workflow job, or the run of
+ * a workload's job, sandbox or service, in a VM or on a container tier
+ * host. A timestamp the host job has not reached yet is unset.
+ *
+ * @generated from message toshi.workspace.v1.HostJob
+ */
+export type HostJob = Message<"toshi.workspace.v1.HostJob"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * The repository as "owner/name".
+     *
+     * @generated from field: string repository = 2;
+     */
+    repository: string;
+    /**
+     * @generated from field: int64 workflow_job_id = 3;
+     */
+    workflowJobId: bigint;
+    /**
+     * @generated from field: int64 run_id = 4;
+     */
+    runId: bigint;
+    /**
+     * The GitHub App installation that the job came from.
+     *
+     * @generated from field: int64 installation_id = 5;
+     */
+    installationId: bigint;
+    /**
+     * The runs-on labels.
+     *
+     * @generated from field: repeated string labels = 6;
+     */
+    labels: string[];
+    /**
+     * @generated from field: string os = 7;
+     */
+    os: string;
+    /**
+     * @generated from field: string size = 8;
+     */
+    size: string;
+    /**
+     * @generated from field: toshi.workspace.v1.HostJobState state = 9;
+     */
+    state: HostJobState;
+    /**
+     * The host the job is assigned to, when it is one of the workspace's own
+     * hosts. Empty while the job is queued, and for a host Toshi runs for
+     * many workspaces.
+     *
+     * @generated from field: string host_id = 10;
+     */
+    hostId: string;
+    /**
+     * The VM the job runs in; empty until the host starts one.
+     *
+     * @generated from field: string instance_id = 11;
+     */
+    instanceId: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp queued_at = 12;
+     */
+    queuedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp assigned_at = 13;
+     */
+    assignedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp started_at = 14;
+     */
+    startedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp finished_at = 15;
+     */
+    finishedAt?: Timestamp | undefined;
+    /**
+     * GitHub's conclusion for a completed job, such as "success".
+     *
+     * @generated from field: string conclusion = 16;
+     */
+    conclusion: string;
+    /**
+     * Why Toshi could not run the job, for a failed job.
+     *
+     * @generated from field: string error = 17;
+     */
+    error: string;
+    /**
+     * Why the job was stopped: github_cancelled, max_duration, operator,
+     * github_completed, runner_not_started, runner_unconfirmed, debug_ended,
+     * ran_elsewhere, or for a sandbox spend_cap, tenant_suspended or
+     * tenant_deleted. Empty if it never was.
+     *
+     * @generated from field: string stop_reason = 18;
+     */
+    stopReason: string;
+    /**
+     * When the control plane asked the host to stop the job. Unset if it
+     * never did.
+     *
+     * @generated from field: google.protobuf.Timestamp stop_requested_at = 19;
+     */
+    stopRequestedAt?: Timestamp | undefined;
+    /**
+     * Why the scheduler last held the job while it was queued:
+     * tenant_suspended, tenant_cap, tenant_vcpu, free_allowance, spend_cap,
+     * jobs_per_hour, burst_guard, plan_os, installation_suspended,
+     * overflow_wait, no_own_capacity or no_capacity. Empty when the job was
+     * never held. It is kept after the job starts.
+     *
+     * @generated from field: string hold_reason = 20;
+     */
+    holdReason: string;
+    /**
+     * Whether the job was placed on a host its workspace owns. Such a job sends no
+     * meter event.
+     *
+     * @generated from field: bool own_host = 21;
+     */
+    ownHost: boolean;
+    /**
+     * The debug session the job asked for with a toshi-debug-<minutes> label,
+     * in minutes; 0 when it asked for none.
+     *
+     * @generated from field: int32 debug_requested_minutes = 22;
+     */
+    debugRequestedMinutes: number;
+    /**
+     * The minutes the plan granted: the request clamped to the plan's
+     * debug_minutes; 0 when none.
+     *
+     * @generated from field: int32 debug_minutes = 23;
+     */
+    debugMinutes: number;
+    /**
+     * Why a request was ignored or clamped; empty otherwise.
+     *
+     * @generated from field: string debug_note = 24;
+     */
+    debugNote: string;
+    /**
+     * When the debug session started and when it expires; unset for a job
+     * that never had one.
+     *
+     * @generated from field: google.protobuf.Timestamp debug_started_at = 25;
+     */
+    debugStartedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp debug_until = 26;
+     */
+    debugUntil?: Timestamp | undefined;
+    /**
+     * What the job's resource samples add up to; unset when it has none.
+     *
+     * @generated from field: toshi.workspace.v1.HostJobTelemetrySummary telemetry = 27;
+     */
+    telemetry?: HostJobTelemetrySummary | undefined;
+    /**
+     * Why the latest runner started for the job exited without running it,
+     * as its listener's log says: "listener exit code 0: Acknowledge returned
+     * job-not-found ...". Empty when none did or its guest did not say.
+     *
+     * @generated from field: string runner_exit_reason = 28;
+     */
+    runnerExitReason: string;
+    /**
+     * The job is assigned to, or ran on, an overflow host.
+     *
+     * @generated from field: bool overflow = 29;
+     */
+    overflow: boolean;
+    /**
+     * Since when the control plane has been waiting for GitHub to answer the
+     * request for this job's runner. Unset when no request is in
+     * flight. Kept in memory: unset after a restart of the control plane.
+     *
+     * @generated from field: google.protobuf.Timestamp runner_request_since = 30;
+     */
+    runnerRequestSince?: Timestamp | undefined;
+    /**
+     * Toshi's own word for a job Toshi ended itself: time_limit,
+     * cancelled_by_tenant, cancelled_by_operator, cancelled_by_uninstall,
+     * cancelled or failed. Empty for every other job. The conclusion stays
+     * GitHub's word.
+     *
+     * @generated from field: string outcome = 31;
+     */
+    outcome: string;
+    /**
+     * The kind of the job's host when it is not a host agent's machine: "cloud"
+     * for a cloud host or a cloud pool. Empty otherwise,
+     * and for a job without a host.
+     *
+     * @generated from field: string host_kind = 32;
+     */
+    hostKind: string;
+    /**
+     * The cloud pool's name when the job started on a warm instance of the
+     * pool's previous image or runner, because the cloud refused a launch on
+     * the current one. Empty otherwise. Set by GetHostJob only.
+     *
+     * @generated from field: string previous_pool_image = 33;
+     */
+    previousPoolImage: string;
+    /**
+     * The whole minutes the job counts in the usage report: from started_at
+     * to stop_requested_at when the job was asked to stop, else to
+     * finished_at, rounded up. 0 for a job that has not ended or never started,
+     * a job on its workspace's own host and a dispatch filler's job, which are not
+     * billed.
+     *
+     * @generated from field: int64 billable_minutes = 34;
+     */
+    billableMinutes: bigint;
+    /**
+     * The job's page on GitHub, on the configured GitHub web URL. Empty when
+     * the job has no repository, run or workflow job id.
+     *
+     * @generated from field: string github_url = 35;
+     */
+    githubUrl: string;
+    /**
+     * The name of the job's workflow, from the workflow_job webhook Toshi
+     * made the job from. Empty when the webhook did not carry it, for a job
+     * Toshi did not make from a webhook, and for one stored before the name
+     * was recorded.
+     *
+     * @generated from field: string workflow_name = 36;
+     */
+    workflowName: string;
+    /**
+     * What the job's cache disk did, as its host reported it.
+     * Unset when the host reported nothing, as for a job without a cache.
+     *
+     * @generated from field: toshi.workspace.v1.HostJobCache cache = 37;
+     */
+    cache?: HostJobCache | undefined;
+    /**
+     * When the host reported that the job's runner exited before GitHub
+     * reported the job in progress; the job then waits for GitHub.
+     * Unset when the runner exited after that, or has not exited.
+     *
+     * @generated from field: google.protobuf.Timestamp runner_exited_at = 38;
+     */
+    runnerExitedAt?: Timestamp | undefined;
+    /**
+     * The conclusion the host reported with that exit, such as "success".
+     * Set only with runner_exited_at. Kept in memory: empty after a restart
+     * of the control plane.
+     *
+     * @generated from field: string runner_conclusion = 39;
+     */
+    runnerConclusion: string;
+    /**
+     * The tier of the host the job was assigned to: "container"
+     * for a container tier host, empty for a VM. The job keeps it after its
+     * host is removed; a requeue clears it.
+     *
+     * @generated from field: string tier = 40;
+     */
+    tier: string;
+    /**
+     * The memory limit the job's host gave it in MiB, when that is not its
+     * runner size's memory: on a container tier host, its share of the host by
+     * CPUs: the host's memory less the agent's memory reserve, times the size's
+     * CPUs over the host's CPUs. A host that reports no CPUs, or no more memory
+     * than that reserve, keeps each size's configured memory. 0 means the
+     * size's memory, and for a tier job that its host has not reported the
+     * limit yet.
+     *
+     * @generated from field: int64 memory_limit_mib = 41;
+     */
+    memoryLimitMib: bigint;
+    /**
+     * The tier in one line, as the dashboard's job page and
+     * GetHostJobFailure show it, such as "ran on a container tier
+     * host, which isolates less than a VM (the job shares the host's
+     * kernel); memory limit 6971 MiB". Empty for a job that ran in a VM.
+     *
+     * @generated from field: string tier_line = 42;
+     */
+    tierLine: string;
+    /**
+     * The job's kind: HOST_JOB_KIND_SANDBOX for a Workspace API sandbox's job,
+     * HOST_JOB_KIND_SERVICE for a run of a Workspace API service, HOST_JOB_KIND_JOB
+     * for every other. Set when the job is made; it never changes.
+     *
+     * @generated from field: toshi.workspace.v1.HostJobKind kind = 43;
+     */
+    kind: HostJobKind;
+    /**
+     * The Workspace API workload the job runs: a sandbox's or a service's
+     * id, or the id of a job workload run on a host. Empty for a
+     * CI job.
+     *
+     * @generated from field: string workload_id = 44;
+     */
+    workloadId: string;
+    /**
+     * The project the job belongs to, by name: the project that
+     * claimed the job's repository when the job was stored, else the
+     * workspace's default project; a Workspace API job's is its workload's.
+     * Empty for a job stored before projects.
+     *
+     * @generated from field: string project = 45;
+     */
+    project: string;
+    /**
+     * The job's environment, by name. A CI job's is empty until the job's
+     * assignment mints a workload token or receives secrets, and a new
+     * assignment re-resolves it; a Workspace API job's is its
+     * workload's.
+     *
+     * @generated from field: string environment = 46;
+     */
+    environment: string;
+};
+/**
+ * HostJob is one run on a host: a GitHub Actions workflow job, or the run of
+ * a workload's job, sandbox or service, in a VM or on a container tier
+ * host. A timestamp the host job has not reached yet is unset.
+ *
+ * @generated from message toshi.workspace.v1.HostJob
+ */
+export type HostJobJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+    /**
+     * The repository as "owner/name".
+     *
+     * @generated from field: string repository = 2;
+     */
+    repository?: string;
+    /**
+     * @generated from field: int64 workflow_job_id = 3;
+     */
+    workflowJobId?: string;
+    /**
+     * @generated from field: int64 run_id = 4;
+     */
+    runId?: string;
+    /**
+     * The GitHub App installation that the job came from.
+     *
+     * @generated from field: int64 installation_id = 5;
+     */
+    installationId?: string;
+    /**
+     * The runs-on labels.
+     *
+     * @generated from field: repeated string labels = 6;
+     */
+    labels?: string[];
+    /**
+     * @generated from field: string os = 7;
+     */
+    os?: string;
+    /**
+     * @generated from field: string size = 8;
+     */
+    size?: string;
+    /**
+     * @generated from field: toshi.workspace.v1.HostJobState state = 9;
+     */
+    state?: HostJobStateJson;
+    /**
+     * The host the job is assigned to, when it is one of the workspace's own
+     * hosts. Empty while the job is queued, and for a host Toshi runs for
+     * many workspaces.
+     *
+     * @generated from field: string host_id = 10;
+     */
+    hostId?: string;
+    /**
+     * The VM the job runs in; empty until the host starts one.
+     *
+     * @generated from field: string instance_id = 11;
+     */
+    instanceId?: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp queued_at = 12;
+     */
+    queuedAt?: TimestampJson;
+    /**
+     * @generated from field: google.protobuf.Timestamp assigned_at = 13;
+     */
+    assignedAt?: TimestampJson;
+    /**
+     * @generated from field: google.protobuf.Timestamp started_at = 14;
+     */
+    startedAt?: TimestampJson;
+    /**
+     * @generated from field: google.protobuf.Timestamp finished_at = 15;
+     */
+    finishedAt?: TimestampJson;
+    /**
+     * GitHub's conclusion for a completed job, such as "success".
+     *
+     * @generated from field: string conclusion = 16;
+     */
+    conclusion?: string;
+    /**
+     * Why Toshi could not run the job, for a failed job.
+     *
+     * @generated from field: string error = 17;
+     */
+    error?: string;
+    /**
+     * Why the job was stopped: github_cancelled, max_duration, operator,
+     * github_completed, runner_not_started, runner_unconfirmed, debug_ended,
+     * ran_elsewhere, or for a sandbox spend_cap, tenant_suspended or
+     * tenant_deleted. Empty if it never was.
+     *
+     * @generated from field: string stop_reason = 18;
+     */
+    stopReason?: string;
+    /**
+     * When the control plane asked the host to stop the job. Unset if it
+     * never did.
+     *
+     * @generated from field: google.protobuf.Timestamp stop_requested_at = 19;
+     */
+    stopRequestedAt?: TimestampJson;
+    /**
+     * Why the scheduler last held the job while it was queued:
+     * tenant_suspended, tenant_cap, tenant_vcpu, free_allowance, spend_cap,
+     * jobs_per_hour, burst_guard, plan_os, installation_suspended,
+     * overflow_wait, no_own_capacity or no_capacity. Empty when the job was
+     * never held. It is kept after the job starts.
+     *
+     * @generated from field: string hold_reason = 20;
+     */
+    holdReason?: string;
+    /**
+     * Whether the job was placed on a host its workspace owns. Such a job sends no
+     * meter event.
+     *
+     * @generated from field: bool own_host = 21;
+     */
+    ownHost?: boolean;
+    /**
+     * The debug session the job asked for with a toshi-debug-<minutes> label,
+     * in minutes; 0 when it asked for none.
+     *
+     * @generated from field: int32 debug_requested_minutes = 22;
+     */
+    debugRequestedMinutes?: number;
+    /**
+     * The minutes the plan granted: the request clamped to the plan's
+     * debug_minutes; 0 when none.
+     *
+     * @generated from field: int32 debug_minutes = 23;
+     */
+    debugMinutes?: number;
+    /**
+     * Why a request was ignored or clamped; empty otherwise.
+     *
+     * @generated from field: string debug_note = 24;
+     */
+    debugNote?: string;
+    /**
+     * When the debug session started and when it expires; unset for a job
+     * that never had one.
+     *
+     * @generated from field: google.protobuf.Timestamp debug_started_at = 25;
+     */
+    debugStartedAt?: TimestampJson;
+    /**
+     * @generated from field: google.protobuf.Timestamp debug_until = 26;
+     */
+    debugUntil?: TimestampJson;
+    /**
+     * What the job's resource samples add up to; unset when it has none.
+     *
+     * @generated from field: toshi.workspace.v1.HostJobTelemetrySummary telemetry = 27;
+     */
+    telemetry?: HostJobTelemetrySummaryJson;
+    /**
+     * Why the latest runner started for the job exited without running it,
+     * as its listener's log says: "listener exit code 0: Acknowledge returned
+     * job-not-found ...". Empty when none did or its guest did not say.
+     *
+     * @generated from field: string runner_exit_reason = 28;
+     */
+    runnerExitReason?: string;
+    /**
+     * The job is assigned to, or ran on, an overflow host.
+     *
+     * @generated from field: bool overflow = 29;
+     */
+    overflow?: boolean;
+    /**
+     * Since when the control plane has been waiting for GitHub to answer the
+     * request for this job's runner. Unset when no request is in
+     * flight. Kept in memory: unset after a restart of the control plane.
+     *
+     * @generated from field: google.protobuf.Timestamp runner_request_since = 30;
+     */
+    runnerRequestSince?: TimestampJson;
+    /**
+     * Toshi's own word for a job Toshi ended itself: time_limit,
+     * cancelled_by_tenant, cancelled_by_operator, cancelled_by_uninstall,
+     * cancelled or failed. Empty for every other job. The conclusion stays
+     * GitHub's word.
+     *
+     * @generated from field: string outcome = 31;
+     */
+    outcome?: string;
+    /**
+     * The kind of the job's host when it is not a host agent's machine: "cloud"
+     * for a cloud host or a cloud pool. Empty otherwise,
+     * and for a job without a host.
+     *
+     * @generated from field: string host_kind = 32;
+     */
+    hostKind?: string;
+    /**
+     * The cloud pool's name when the job started on a warm instance of the
+     * pool's previous image or runner, because the cloud refused a launch on
+     * the current one. Empty otherwise. Set by GetHostJob only.
+     *
+     * @generated from field: string previous_pool_image = 33;
+     */
+    previousPoolImage?: string;
+    /**
+     * The whole minutes the job counts in the usage report: from started_at
+     * to stop_requested_at when the job was asked to stop, else to
+     * finished_at, rounded up. 0 for a job that has not ended or never started,
+     * a job on its workspace's own host and a dispatch filler's job, which are not
+     * billed.
+     *
+     * @generated from field: int64 billable_minutes = 34;
+     */
+    billableMinutes?: string;
+    /**
+     * The job's page on GitHub, on the configured GitHub web URL. Empty when
+     * the job has no repository, run or workflow job id.
+     *
+     * @generated from field: string github_url = 35;
+     */
+    githubUrl?: string;
+    /**
+     * The name of the job's workflow, from the workflow_job webhook Toshi
+     * made the job from. Empty when the webhook did not carry it, for a job
+     * Toshi did not make from a webhook, and for one stored before the name
+     * was recorded.
+     *
+     * @generated from field: string workflow_name = 36;
+     */
+    workflowName?: string;
+    /**
+     * What the job's cache disk did, as its host reported it.
+     * Unset when the host reported nothing, as for a job without a cache.
+     *
+     * @generated from field: toshi.workspace.v1.HostJobCache cache = 37;
+     */
+    cache?: HostJobCacheJson;
+    /**
+     * When the host reported that the job's runner exited before GitHub
+     * reported the job in progress; the job then waits for GitHub.
+     * Unset when the runner exited after that, or has not exited.
+     *
+     * @generated from field: google.protobuf.Timestamp runner_exited_at = 38;
+     */
+    runnerExitedAt?: TimestampJson;
+    /**
+     * The conclusion the host reported with that exit, such as "success".
+     * Set only with runner_exited_at. Kept in memory: empty after a restart
+     * of the control plane.
+     *
+     * @generated from field: string runner_conclusion = 39;
+     */
+    runnerConclusion?: string;
+    /**
+     * The tier of the host the job was assigned to: "container"
+     * for a container tier host, empty for a VM. The job keeps it after its
+     * host is removed; a requeue clears it.
+     *
+     * @generated from field: string tier = 40;
+     */
+    tier?: string;
+    /**
+     * The memory limit the job's host gave it in MiB, when that is not its
+     * runner size's memory: on a container tier host, its share of the host by
+     * CPUs: the host's memory less the agent's memory reserve, times the size's
+     * CPUs over the host's CPUs. A host that reports no CPUs, or no more memory
+     * than that reserve, keeps each size's configured memory. 0 means the
+     * size's memory, and for a tier job that its host has not reported the
+     * limit yet.
+     *
+     * @generated from field: int64 memory_limit_mib = 41;
+     */
+    memoryLimitMib?: string;
+    /**
+     * The tier in one line, as the dashboard's job page and
+     * GetHostJobFailure show it, such as "ran on a container tier
+     * host, which isolates less than a VM (the job shares the host's
+     * kernel); memory limit 6971 MiB". Empty for a job that ran in a VM.
+     *
+     * @generated from field: string tier_line = 42;
+     */
+    tierLine?: string;
+    /**
+     * The job's kind: HOST_JOB_KIND_SANDBOX for a Workspace API sandbox's job,
+     * HOST_JOB_KIND_SERVICE for a run of a Workspace API service, HOST_JOB_KIND_JOB
+     * for every other. Set when the job is made; it never changes.
+     *
+     * @generated from field: toshi.workspace.v1.HostJobKind kind = 43;
+     */
+    kind?: HostJobKindJson;
+    /**
+     * The Workspace API workload the job runs: a sandbox's or a service's
+     * id, or the id of a job workload run on a host. Empty for a
+     * CI job.
+     *
+     * @generated from field: string workload_id = 44;
+     */
+    workloadId?: string;
+    /**
+     * The project the job belongs to, by name: the project that
+     * claimed the job's repository when the job was stored, else the
+     * workspace's default project; a Workspace API job's is its workload's.
+     * Empty for a job stored before projects.
+     *
+     * @generated from field: string project = 45;
+     */
+    project?: string;
+    /**
+     * The job's environment, by name. A CI job's is empty until the job's
+     * assignment mints a workload token or receives secrets, and a new
+     * assignment re-resolves it; a Workspace API job's is its
+     * workload's.
+     *
+     * @generated from field: string environment = 46;
+     */
+    environment?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.HostJob.
+ * Use `create(HostJobSchema)` to create a new message.
+ */
+export declare const HostJobSchema: GenMessage<HostJob, {
+    jsonType: HostJobJson;
+}>;
+/**
+ * HostJobTelemetrySummary sums up a job VM's resource samples.
+ *
+ * @generated from message toshi.workspace.v1.HostJobTelemetrySummary
+ */
+export type HostJobTelemetrySummary = Message<"toshi.workspace.v1.HostJobTelemetrySummary"> & {
+    /**
+     * Whether the guest kernel's out-of-memory killer killed a process
+     * during the job.
+     *
+     * @generated from field: bool oom_killed = 1;
+     */
+    oomKilled: boolean;
+    /**
+     * How long the VM's threads waited for a host CPU, as a percentage of the
+     * CPU time they used plus that wait. 0 when they never waited.
+     *
+     * @generated from field: double cpu_throttled_pct = 2;
+     */
+    cpuThrottledPct: number;
+    /**
+     * The most memory in use inside the guest, in MiB; the host's resident
+     * memory of the VM when the guest does not report it.
+     *
+     * @generated from field: int64 peak_memory_mib = 3;
+     */
+    peakMemoryMib: bigint;
+    /**
+     * CPU time used as a percentage of the VM's vCPUs over the sampled time.
+     *
+     * @generated from field: double cpu_utilisation_pct = 4;
+     */
+    cpuUtilisationPct: number;
+    /**
+     * How many samples the job has.
+     *
+     * @generated from field: int32 samples = 5;
+     */
+    samples: number;
+    /**
+     * The job's memory limit in MiB: the memory its runner size gives its VM,
+     * or on a container tier host the limit the host gave it, its share of
+     * the host; 0 when neither is known.
+     *
+     * @generated from field: int64 memory_limit_mib = 6;
+     */
+    memoryLimitMib: bigint;
+    /**
+     * The CPU time the VM used, in milliseconds: the sum of the job's stored
+     * samples.
+     *
+     * @generated from field: int64 cpu_ms = 7;
+     */
+    cpuMs: bigint;
+    /**
+     * Why the job ran out of memory, when it ended without succeeding and its
+     * samples counted a kill: "out of memory (peak X MiB of limit Y MiB)",
+     * without the limit when the size is unknown. Empty otherwise.
+     *
+     * @generated from field: string oom_reason = 8;
+     */
+    oomReason: string;
+    /**
+     * Whether the runner size suited the job: "fits", "too big", "too small",
+     * "throttled" or "out of memory". Empty for a job that has not ended, and
+     * for a size this release does not know unless the job ran out of memory
+     * or was throttled.
+     *
+     * @generated from field: string verdict = 9;
+     */
+    verdict: string;
+    /**
+     * The verdict in one sentence with its numbers, such as "used 20 % of 4
+     * vCPUs and 4 GiB of 16 GiB: a size smaller, toshi-linux-2x, would fit".
+     * Empty when the verdict is.
+     *
+     * @generated from field: string verdict_reason = 10;
+     */
+    verdictReason: string;
+};
+/**
+ * HostJobTelemetrySummary sums up a job VM's resource samples.
+ *
+ * @generated from message toshi.workspace.v1.HostJobTelemetrySummary
+ */
+export type HostJobTelemetrySummaryJson = {
+    /**
+     * Whether the guest kernel's out-of-memory killer killed a process
+     * during the job.
+     *
+     * @generated from field: bool oom_killed = 1;
+     */
+    oomKilled?: boolean;
+    /**
+     * How long the VM's threads waited for a host CPU, as a percentage of the
+     * CPU time they used plus that wait. 0 when they never waited.
+     *
+     * @generated from field: double cpu_throttled_pct = 2;
+     */
+    cpuThrottledPct?: number | "NaN" | "Infinity" | "-Infinity";
+    /**
+     * The most memory in use inside the guest, in MiB; the host's resident
+     * memory of the VM when the guest does not report it.
+     *
+     * @generated from field: int64 peak_memory_mib = 3;
+     */
+    peakMemoryMib?: string;
+    /**
+     * CPU time used as a percentage of the VM's vCPUs over the sampled time.
+     *
+     * @generated from field: double cpu_utilisation_pct = 4;
+     */
+    cpuUtilisationPct?: number | "NaN" | "Infinity" | "-Infinity";
+    /**
+     * How many samples the job has.
+     *
+     * @generated from field: int32 samples = 5;
+     */
+    samples?: number;
+    /**
+     * The job's memory limit in MiB: the memory its runner size gives its VM,
+     * or on a container tier host the limit the host gave it, its share of
+     * the host; 0 when neither is known.
+     *
+     * @generated from field: int64 memory_limit_mib = 6;
+     */
+    memoryLimitMib?: string;
+    /**
+     * The CPU time the VM used, in milliseconds: the sum of the job's stored
+     * samples.
+     *
+     * @generated from field: int64 cpu_ms = 7;
+     */
+    cpuMs?: string;
+    /**
+     * Why the job ran out of memory, when it ended without succeeding and its
+     * samples counted a kill: "out of memory (peak X MiB of limit Y MiB)",
+     * without the limit when the size is unknown. Empty otherwise.
+     *
+     * @generated from field: string oom_reason = 8;
+     */
+    oomReason?: string;
+    /**
+     * Whether the runner size suited the job: "fits", "too big", "too small",
+     * "throttled" or "out of memory". Empty for a job that has not ended, and
+     * for a size this release does not know unless the job ran out of memory
+     * or was throttled.
+     *
+     * @generated from field: string verdict = 9;
+     */
+    verdict?: string;
+    /**
+     * The verdict in one sentence with its numbers, such as "used 20 % of 4
+     * vCPUs and 4 GiB of 16 GiB: a size smaller, toshi-linux-2x, would fit".
+     * Empty when the verdict is.
+     *
+     * @generated from field: string verdict_reason = 10;
+     */
+    verdictReason?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.HostJobTelemetrySummary.
+ * Use `create(HostJobTelemetrySummarySchema)` to create a new message.
+ */
+export declare const HostJobTelemetrySummarySchema: GenMessage<HostJobTelemetrySummary, {
+    jsonType: HostJobTelemetrySummaryJson;
+}>;
+/**
+ * HostJobCache is what a job's cache disk did.
+ *
+ * @generated from message toshi.workspace.v1.HostJobCache
+ */
+export type HostJobCache = Message<"toshi.workspace.v1.HostJobCache"> & {
+    /**
+     * "attached", or "not_attached" when the disk never reached the job's VM
+     * and the job ran without it.
+     *
+     * @generated from field: string attach = 1;
+     */
+    attach: string;
+    /**
+     * The generation the disk was attached from; 0 is the blank disk.
+     *
+     * @generated from field: int64 base_generation = 2;
+     */
+    baseGeneration: bigint;
+    /**
+     * "committed" or "skipped"; empty until the host reports the write-back,
+     * after the job's VM is gone, and when the disk was not attached.
+     *
+     * @generated from field: string write_back = 3;
+     */
+    writeBack: string;
+    /**
+     * Why the write-back was skipped: "untrusted", "failed", "job_failed",
+     * "no_result", "unclean", "stale", "size_cap", "host_disk" or "error",
+     * or a reason this control plane does not know, from a newer agent, as
+     * the agent sent it.
+     *
+     * @generated from field: string skip_reason = 4;
+     */
+    skipReason: string;
+    /**
+     * The size of the committed generation in bytes, and how long the
+     * write-back took in milliseconds.
+     *
+     * @generated from field: int64 generation_bytes = 5;
+     */
+    generationBytes: bigint;
+    /**
+     * @generated from field: int64 write_back_ms = 6;
+     */
+    writeBackMs: bigint;
+    /**
+     * The fields above in one line, as the dashboard's job page and
+     * GetHostJobFailure show it, such as "warm
+     * from generation 3 on host h1; wrote generation 4 (1.2 GiB in 14 s)".
+     *
+     * @generated from field: string line = 7;
+     */
+    line: string;
+};
+/**
+ * HostJobCache is what a job's cache disk did.
+ *
+ * @generated from message toshi.workspace.v1.HostJobCache
+ */
+export type HostJobCacheJson = {
+    /**
+     * "attached", or "not_attached" when the disk never reached the job's VM
+     * and the job ran without it.
+     *
+     * @generated from field: string attach = 1;
+     */
+    attach?: string;
+    /**
+     * The generation the disk was attached from; 0 is the blank disk.
+     *
+     * @generated from field: int64 base_generation = 2;
+     */
+    baseGeneration?: string;
+    /**
+     * "committed" or "skipped"; empty until the host reports the write-back,
+     * after the job's VM is gone, and when the disk was not attached.
+     *
+     * @generated from field: string write_back = 3;
+     */
+    writeBack?: string;
+    /**
+     * Why the write-back was skipped: "untrusted", "failed", "job_failed",
+     * "no_result", "unclean", "stale", "size_cap", "host_disk" or "error",
+     * or a reason this control plane does not know, from a newer agent, as
+     * the agent sent it.
+     *
+     * @generated from field: string skip_reason = 4;
+     */
+    skipReason?: string;
+    /**
+     * The size of the committed generation in bytes, and how long the
+     * write-back took in milliseconds.
+     *
+     * @generated from field: int64 generation_bytes = 5;
+     */
+    generationBytes?: string;
+    /**
+     * @generated from field: int64 write_back_ms = 6;
+     */
+    writeBackMs?: string;
+    /**
+     * The fields above in one line, as the dashboard's job page and
+     * GetHostJobFailure show it, such as "warm
+     * from generation 3 on host h1; wrote generation 4 (1.2 GiB in 14 s)".
+     *
+     * @generated from field: string line = 7;
+     */
+    line?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.HostJobCache.
+ * Use `create(HostJobCacheSchema)` to create a new message.
+ */
+export declare const HostJobCacheSchema: GenMessage<HostJobCache, {
+    jsonType: HostJobCacheJson;
+}>;
+/**
+ * HostJobTelemetrySample is the same as toshi.agent.v1.TelemetrySample: one
+ * window of a job VM's resource use.
+ *
+ * @generated from message toshi.workspace.v1.HostJobTelemetrySample
+ */
+export type HostJobTelemetrySample = Message<"toshi.workspace.v1.HostJobTelemetrySample"> & {
+    /**
+     * @generated from field: google.protobuf.Timestamp at = 1;
+     */
+    at?: Timestamp | undefined;
+    /**
+     * @generated from field: int32 window_ms = 2;
+     */
+    windowMs: number;
+    /**
+     * @generated from field: int64 cpu_ms = 3;
+     */
+    cpuMs: bigint;
+    /**
+     * @generated from field: int64 cpu_wait_ms = 4;
+     */
+    cpuWaitMs: bigint;
+    /**
+     * @generated from field: optional int64 guest_memory_mib = 5;
+     */
+    guestMemoryMib?: bigint | undefined;
+    /**
+     * @generated from field: int64 host_memory_mib = 6;
+     */
+    hostMemoryMib: bigint;
+    /**
+     * @generated from field: int64 disk_read_bytes = 7;
+     */
+    diskReadBytes: bigint;
+    /**
+     * @generated from field: int64 disk_write_bytes = 8;
+     */
+    diskWriteBytes: bigint;
+    /**
+     * @generated from field: optional int64 net_rx_bytes = 9;
+     */
+    netRxBytes?: bigint | undefined;
+    /**
+     * @generated from field: optional int64 net_tx_bytes = 10;
+     */
+    netTxBytes?: bigint | undefined;
+    /**
+     * @generated from field: optional int32 oom_kills = 11;
+     */
+    oomKills?: number | undefined;
+};
+/**
+ * HostJobTelemetrySample is the same as toshi.agent.v1.TelemetrySample: one
+ * window of a job VM's resource use.
+ *
+ * @generated from message toshi.workspace.v1.HostJobTelemetrySample
+ */
+export type HostJobTelemetrySampleJson = {
+    /**
+     * @generated from field: google.protobuf.Timestamp at = 1;
+     */
+    at?: TimestampJson;
+    /**
+     * @generated from field: int32 window_ms = 2;
+     */
+    windowMs?: number;
+    /**
+     * @generated from field: int64 cpu_ms = 3;
+     */
+    cpuMs?: string;
+    /**
+     * @generated from field: int64 cpu_wait_ms = 4;
+     */
+    cpuWaitMs?: string;
+    /**
+     * @generated from field: optional int64 guest_memory_mib = 5;
+     */
+    guestMemoryMib?: string;
+    /**
+     * @generated from field: int64 host_memory_mib = 6;
+     */
+    hostMemoryMib?: string;
+    /**
+     * @generated from field: int64 disk_read_bytes = 7;
+     */
+    diskReadBytes?: string;
+    /**
+     * @generated from field: int64 disk_write_bytes = 8;
+     */
+    diskWriteBytes?: string;
+    /**
+     * @generated from field: optional int64 net_rx_bytes = 9;
+     */
+    netRxBytes?: string;
+    /**
+     * @generated from field: optional int64 net_tx_bytes = 10;
+     */
+    netTxBytes?: string;
+    /**
+     * @generated from field: optional int32 oom_kills = 11;
+     */
+    oomKills?: number;
+};
+/**
+ * Describes the message toshi.workspace.v1.HostJobTelemetrySample.
+ * Use `create(HostJobTelemetrySampleSchema)` to create a new message.
+ */
+export declare const HostJobTelemetrySampleSchema: GenMessage<HostJobTelemetrySample, {
+    jsonType: HostJobTelemetrySampleJson;
+}>;
+/**
+ * HostJobFailureHistory counts the failures of the jobs with the same
+ * repository and job name, in the last `days` days, whose re-run on
+ * GitHub passed or failed again. A failure that passed on any re-run
+ * counts as passed; one with a failed re-run and none passed counts as
+ * failed again. Toshi re-runs and hides nothing for it.
+ *
+ * @generated from message toshi.workspace.v1.HostJobFailureHistory
+ */
+export type HostJobFailureHistory = Message<"toshi.workspace.v1.HostJobFailureHistory"> & {
+    /**
+     * @generated from field: int32 days = 1;
+     */
+    days: number;
+    /**
+     * @generated from field: int32 passed_on_rerun = 2;
+     */
+    passedOnRerun: number;
+    /**
+     * @generated from field: int32 failed_again = 3;
+     */
+    failedAgain: number;
+    /**
+     * The job's failing step, and the counts of the failures at a step of
+     * the same name. Empty and 0 when Toshi knows no failing step.
+     *
+     * @generated from field: string step = 4;
+     */
+    step: string;
+    /**
+     * @generated from field: int32 step_passed_on_rerun = 5;
+     */
+    stepPassedOnRerun: number;
+    /**
+     * @generated from field: int32 step_failed_again = 6;
+     */
+    stepFailedAgain: number;
+    /**
+     * The counts in a sentence or two; it says the failure is likely a
+     * flake only when the job failed on its own and passed on re-run at
+     * least twice. Empty when every count is 0.
+     *
+     * @generated from field: string sentence = 7;
+     */
+    sentence: string;
+};
+/**
+ * HostJobFailureHistory counts the failures of the jobs with the same
+ * repository and job name, in the last `days` days, whose re-run on
+ * GitHub passed or failed again. A failure that passed on any re-run
+ * counts as passed; one with a failed re-run and none passed counts as
+ * failed again. Toshi re-runs and hides nothing for it.
+ *
+ * @generated from message toshi.workspace.v1.HostJobFailureHistory
+ */
+export type HostJobFailureHistoryJson = {
+    /**
+     * @generated from field: int32 days = 1;
+     */
+    days?: number;
+    /**
+     * @generated from field: int32 passed_on_rerun = 2;
+     */
+    passedOnRerun?: number;
+    /**
+     * @generated from field: int32 failed_again = 3;
+     */
+    failedAgain?: number;
+    /**
+     * The job's failing step, and the counts of the failures at a step of
+     * the same name. Empty and 0 when Toshi knows no failing step.
+     *
+     * @generated from field: string step = 4;
+     */
+    step?: string;
+    /**
+     * @generated from field: int32 step_passed_on_rerun = 5;
+     */
+    stepPassedOnRerun?: number;
+    /**
+     * @generated from field: int32 step_failed_again = 6;
+     */
+    stepFailedAgain?: number;
+    /**
+     * The counts in a sentence or two; it says the failure is likely a
+     * flake only when the job failed on its own and passed on re-run at
+     * least twice. Empty when every count is 0.
+     *
+     * @generated from field: string sentence = 7;
+     */
+    sentence?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.HostJobFailureHistory.
+ * Use `create(HostJobFailureHistorySchema)` to create a new message.
+ */
+export declare const HostJobFailureHistorySchema: GenMessage<HostJobFailureHistory, {
+    jsonType: HostJobFailureHistoryJson;
+}>;
+/**
+ * HostJobState is where a host job is in its life cycle.
+ *
+ * @generated from enum toshi.workspace.v1.HostJobState
+ */
+export declare enum HostJobState {
+    /**
+     * @generated from enum value: HOST_JOB_STATE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Waiting for a host.
+     *
+     * @generated from enum value: HOST_JOB_STATE_QUEUED = 1;
+     */
+    QUEUED = 1,
+    /**
+     * Assigned to a host that has not started its VM yet.
+     *
+     * @generated from enum value: HOST_JOB_STATE_ASSIGNED = 2;
+     */
+    ASSIGNED = 2,
+    /**
+     * The host is starting the VM.
+     *
+     * @generated from enum value: HOST_JOB_STATE_STARTING = 3;
+     */
+    STARTING = 3,
+    /**
+     * The runner in the VM is running the job.
+     *
+     * @generated from enum value: HOST_JOB_STATE_RUNNING = 4;
+     */
+    RUNNING = 4,
+    /**
+     * The job finished; conclusion says how.
+     *
+     * @generated from enum value: HOST_JOB_STATE_COMPLETED = 5;
+     */
+    COMPLETED = 5,
+    /**
+     * Toshi could not run the job; error says why.
+     *
+     * @generated from enum value: HOST_JOB_STATE_FAILED = 6;
+     */
+    FAILED = 6,
+    /**
+     * The job was cancelled before it finished.
+     *
+     * @generated from enum value: HOST_JOB_STATE_CANCELLED = 7;
+     */
+    CANCELLED = 7,
+    /**
+     * The job is being stopped: its host destroys the VM after a grace period.
+     *
+     * @generated from enum value: HOST_JOB_STATE_STOPPING = 8;
+     */
+    STOPPING = 8,
+    /**
+     * GitHub concluded the job failed and its host keeps the VM for a debug
+     * session until debug_until. It counts as running.
+     *
+     * @generated from enum value: HOST_JOB_STATE_DEBUGGING = 9;
+     */
+    DEBUGGING = 9
+}
+/**
+ * HostJobState is where a host job is in its life cycle.
+ *
+ * @generated from enum toshi.workspace.v1.HostJobState
+ */
+export type HostJobStateJson = "HOST_JOB_STATE_UNSPECIFIED" | "HOST_JOB_STATE_QUEUED" | "HOST_JOB_STATE_ASSIGNED" | "HOST_JOB_STATE_STARTING" | "HOST_JOB_STATE_RUNNING" | "HOST_JOB_STATE_COMPLETED" | "HOST_JOB_STATE_FAILED" | "HOST_JOB_STATE_CANCELLED" | "HOST_JOB_STATE_STOPPING" | "HOST_JOB_STATE_DEBUGGING";
+/**
+ * Describes the enum toshi.workspace.v1.HostJobState.
+ */
+export declare const HostJobStateSchema: GenEnum<HostJobState, HostJobStateJson>;
+/**
+ * HostJobKind is the kind of workload a host job runs.
+ *
+ * @generated from enum toshi.workspace.v1.HostJobKind
+ */
+export declare enum HostJobKind {
+    /**
+     * @generated from enum value: HOST_JOB_KIND_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * A job: it ends when its runner exits or at its time limit.
+     *
+     * @generated from enum value: HOST_JOB_KIND_JOB = 1;
+     */
+    JOB = 1,
+    /**
+     * A Workspace API sandbox's job: it runs until its owner stops it or
+     * Toshi stops it. Its workload_id is the sandbox.
+     *
+     * @generated from enum value: HOST_JOB_KIND_SANDBOX = 2;
+     */
+    SANDBOX = 2,
+    /**
+     * A run of a Workspace API service: it runs until it exits
+     * or its service stops it. Its workload_id is the service.
+     *
+     * @generated from enum value: HOST_JOB_KIND_SERVICE = 3;
+     */
+    SERVICE = 3
+}
+/**
+ * HostJobKind is the kind of workload a host job runs.
+ *
+ * @generated from enum toshi.workspace.v1.HostJobKind
+ */
+export type HostJobKindJson = "HOST_JOB_KIND_UNSPECIFIED" | "HOST_JOB_KIND_JOB" | "HOST_JOB_KIND_SANDBOX" | "HOST_JOB_KIND_SERVICE";
+/**
+ * Describes the enum toshi.workspace.v1.HostJobKind.
+ */
+export declare const HostJobKindSchema: GenEnum<HostJobKind, HostJobKindJson>;
+/**
+ * HostJobService reads and stops the workspace's host jobs: each run of a
+ * runner or a workload on a host, as the scheduler placed it. A host job of
+ * another workspace is NOT_FOUND.
+ *
+ * A workspace's API token acts on its own workspace; a dashboard session
+ * names one of its workspaces in the Toshi-Workspace header. A
+ * token limited to a project or an environment is refused with
+ * PERMISSION_DENIED: these calls act in the whole workspace. A suspended
+ * workspace reads its host jobs, and every other call is refused for it
+ * with FAILED_PRECONDITION.
+ *
+ * @generated from service toshi.workspace.v1.HostJobService
+ */
+export declare const HostJobService: GenService<{
+    /**
+     * ListHostJobs returns the host jobs that match every filter field that
+     * is set, oldest queued first.
+     *
+     * A page holds 100 host jobs when page_size is zero, and 1000 at most.
+     *
+     * @generated from rpc toshi.workspace.v1.HostJobService.ListHostJobs
+     */
+    listHostJobs: {
+        methodKind: "unary";
+        input: typeof ListHostJobsRequestSchema;
+        output: typeof ListHostJobsResponseSchema;
+    };
+    /**
+     * GetHostJob returns one host job. An unknown ID fails with NOT_FOUND.
+     *
+     * @generated from rpc toshi.workspace.v1.HostJobService.GetHostJob
+     */
+    getHostJob: {
+        methodKind: "unary";
+        input: typeof GetHostJobRequestSchema;
+        output: typeof GetHostJobResponseSchema;
+    };
+    /**
+     * CancelHostJob cancels a queued host job at once. An assigned, starting
+     * or running host job moves to HOST_JOB_STATE_STOPPING: its host stops
+     * the runner after a grace period, destroys the VM and reports the host
+     * job HOST_JOB_STATE_CANCELLED. A stopping host job is returned
+     * unchanged; a finished one fails with FAILED_PRECONDITION.
+     *
+     * @generated from rpc toshi.workspace.v1.HostJobService.CancelHostJob
+     */
+    cancelHostJob: {
+        methodKind: "unary";
+        input: typeof CancelHostJobRequestSchema;
+        output: typeof CancelHostJobResponseSchema;
+    };
+    /**
+     * GetHostJobFailure says why a host job ended the way it did and what to
+     * do next, from what Toshi stored. An empty ID fails with
+     * INVALID_ARGUMENT; an unknown ID fails with NOT_FOUND.
+     *
+     * @generated from rpc toshi.workspace.v1.HostJobService.GetHostJobFailure
+     */
+    getHostJobFailure: {
+        methodKind: "unary";
+        input: typeof GetHostJobFailureRequestSchema;
+        output: typeof GetHostJobFailureResponseSchema;
+    };
+    /**
+     * GetHostJobTelemetry returns the resource samples of one host job's VM
+     * and their summary. An unknown ID fails with NOT_FOUND; a host job
+     * without samples returns none.
+     *
+     * @generated from rpc toshi.workspace.v1.HostJobService.GetHostJobTelemetry
+     */
+    getHostJobTelemetry: {
+        methodKind: "unary";
+        input: typeof GetHostJobTelemetryRequestSchema;
+        output: typeof GetHostJobTelemetryResponseSchema;
+    };
+    /**
+     * GetHostJobDebugAccess returns the key that opens a debugging host job's
+     * guest ssh through the control plane's relay. The host job's host makes
+     * the key and gives it out once per session; the control plane does not
+     * keep it. A host job that is not debugging fails with
+     * FAILED_PRECONDITION, a key already issued with ALREADY_EXISTS, and a
+     * host that does not answer with UNAVAILABLE. It is not a read: a
+     * suspended workspace is refused it.
+     *
+     * @generated from rpc toshi.workspace.v1.HostJobService.GetHostJobDebugAccess
+     */
+    getHostJobDebugAccess: {
+        methodKind: "unary";
+        input: typeof GetHostJobDebugAccessRequestSchema;
+        output: typeof GetHostJobDebugAccessResponseSchema;
+    };
+    /**
+     * StopHostJobDebug ends a host job's debug session before its expiry: the
+     * host job moves to HOST_JOB_STATE_STOPPING with stop_reason debug_ended,
+     * its host destroys the kept VM and the host job finishes completed with
+     * its conclusion unchanged. A host job that is not debugging fails with
+     * FAILED_PRECONDITION; one already stopping is returned unchanged.
+     *
+     * @generated from rpc toshi.workspace.v1.HostJobService.StopHostJobDebug
+     */
+    stopHostJobDebug: {
+        methodKind: "unary";
+        input: typeof StopHostJobDebugRequestSchema;
+        output: typeof StopHostJobDebugResponseSchema;
+    };
+}>;