@toshicloud/sdk 0.4.0 → 0.5.1

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

@@ -0,0 +1,1297 @@
+import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { FieldMask, FieldMaskJson, Timestamp, TimestampJson } from "@bufbuild/protobuf/wkt";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file toshi/workspace/v1/grants.proto.
+ */
+export declare const file_toshi_workspace_v1_grants: GenFile;
+/**
+ * Grant is one workspace's grant to another. Both sides read the same
+ * message.
+ *
+ * @generated from message toshi.workspace.v1.Grant
+ */
+export type Grant = Message<"toshi.workspace.v1.Grant"> & {
+    /**
+     * Assigned by the server.
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * The workspace that gave it.
+     *
+     * @generated from field: toshi.workspace.v1.GrantWorkspace owner = 2;
+     */
+    owner?: GrantWorkspace | undefined;
+    /**
+     * The workspace it was given to.
+     *
+     * @generated from field: toshi.workspace.v1.GrantWorkspace grantee = 3;
+     */
+    grantee?: GrantWorkspace | undefined;
+    /**
+     * What it covers, in the owner's workspace.
+     *
+     * @generated from oneof toshi.workspace.v1.Grant.target
+     */
+    target: {
+        /**
+         * Every sandbox of one environment.
+         *
+         * @generated from field: toshi.workspace.v1.GrantEnvironmentTarget environment = 4;
+         */
+        value: GrantEnvironmentTarget;
+        case: "environment";
+    } | {
+        /**
+         * One sandbox.
+         *
+         * @generated from field: toshi.workspace.v1.GrantSandboxTarget sandbox = 5;
+         */
+        value: GrantSandboxTarget;
+        case: "sandbox";
+    } | {
+        /**
+         * One preview of one sandbox, at VIEW only.
+         *
+         * @generated from field: toshi.workspace.v1.GrantPreviewTarget preview = 6;
+         */
+        value: GrantPreviewTarget;
+        case: "preview";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+    /**
+     * @generated from field: toshi.workspace.v1.GrantLevel level = 7;
+     */
+    level: GrantLevel;
+    /**
+     * @generated from field: toshi.workspace.v1.GrantState state = 8;
+     */
+    state: GrantState;
+    /**
+     * Who offered it, as the audit log names them.
+     *
+     * @generated from field: string offered_by = 9;
+     */
+    offeredBy: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp offered_at = 10;
+     */
+    offeredAt?: Timestamp | undefined;
+    /**
+     * When an offer not answered lapses.
+     *
+     * @generated from field: google.protobuf.Timestamp lapses_at = 11;
+     */
+    lapsesAt?: Timestamp | undefined;
+    /**
+     * Unset until it is accepted.
+     *
+     * @generated from field: google.protobuf.Timestamp accepted_at = 12;
+     */
+    acceptedAt?: Timestamp | undefined;
+    /**
+     * Unset until something reaches the target through it.
+     *
+     * @generated from field: google.protobuf.Timestamp last_used_at = 13;
+     */
+    lastUsedAt?: Timestamp | undefined;
+    /**
+     * Unset when it has no expiry.
+     *
+     * @generated from field: google.protobuf.Timestamp expires_at = 14;
+     */
+    expiresAt?: Timestamp | undefined;
+    /**
+     * Unset while it is live.
+     *
+     * @generated from field: google.protobuf.Timestamp ended_at = 15;
+     */
+    endedAt?: Timestamp | undefined;
+    /**
+     * Who ended it: "owner", "grantee" or "system"; empty while it is live.
+     *
+     * @generated from field: string ended_by = 16;
+     */
+    endedBy: string;
+};
+/**
+ * Grant is one workspace's grant to another. Both sides read the same
+ * message.
+ *
+ * @generated from message toshi.workspace.v1.Grant
+ */
+export type GrantJson = {
+    /**
+     * Assigned by the server.
+     *
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+    /**
+     * The workspace that gave it.
+     *
+     * @generated from field: toshi.workspace.v1.GrantWorkspace owner = 2;
+     */
+    owner?: GrantWorkspaceJson;
+    /**
+     * The workspace it was given to.
+     *
+     * @generated from field: toshi.workspace.v1.GrantWorkspace grantee = 3;
+     */
+    grantee?: GrantWorkspaceJson;
+    /**
+     * Every sandbox of one environment.
+     *
+     * @generated from field: toshi.workspace.v1.GrantEnvironmentTarget environment = 4;
+     */
+    environment?: GrantEnvironmentTargetJson;
+    /**
+     * One sandbox.
+     *
+     * @generated from field: toshi.workspace.v1.GrantSandboxTarget sandbox = 5;
+     */
+    sandbox?: GrantSandboxTargetJson;
+    /**
+     * One preview of one sandbox, at VIEW only.
+     *
+     * @generated from field: toshi.workspace.v1.GrantPreviewTarget preview = 6;
+     */
+    preview?: GrantPreviewTargetJson;
+    /**
+     * @generated from field: toshi.workspace.v1.GrantLevel level = 7;
+     */
+    level?: GrantLevelJson;
+    /**
+     * @generated from field: toshi.workspace.v1.GrantState state = 8;
+     */
+    state?: GrantStateJson;
+    /**
+     * Who offered it, as the audit log names them.
+     *
+     * @generated from field: string offered_by = 9;
+     */
+    offeredBy?: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp offered_at = 10;
+     */
+    offeredAt?: TimestampJson;
+    /**
+     * When an offer not answered lapses.
+     *
+     * @generated from field: google.protobuf.Timestamp lapses_at = 11;
+     */
+    lapsesAt?: TimestampJson;
+    /**
+     * Unset until it is accepted.
+     *
+     * @generated from field: google.protobuf.Timestamp accepted_at = 12;
+     */
+    acceptedAt?: TimestampJson;
+    /**
+     * Unset until something reaches the target through it.
+     *
+     * @generated from field: google.protobuf.Timestamp last_used_at = 13;
+     */
+    lastUsedAt?: TimestampJson;
+    /**
+     * Unset when it has no expiry.
+     *
+     * @generated from field: google.protobuf.Timestamp expires_at = 14;
+     */
+    expiresAt?: TimestampJson;
+    /**
+     * Unset while it is live.
+     *
+     * @generated from field: google.protobuf.Timestamp ended_at = 15;
+     */
+    endedAt?: TimestampJson;
+    /**
+     * Who ended it: "owner", "grantee" or "system"; empty while it is live.
+     *
+     * @generated from field: string ended_by = 16;
+     */
+    endedBy?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.Grant.
+ * Use `create(GrantSchema)` to create a new message.
+ */
+export declare const GrantSchema: GenMessage<Grant, {
+    jsonType: GrantJson;
+}>;
+/**
+ * SharedAccess is what a grant gives the grantee on one sandbox.
+ *
+ * @generated from message toshi.workspace.v1.SharedAccess
+ */
+export type SharedAccess = Message<"toshi.workspace.v1.SharedAccess"> & {
+    /**
+     * The grant the sandbox was read through.
+     *
+     * @generated from field: string grant_id = 1;
+     */
+    grantId: string;
+    /**
+     * The grant's level.
+     *
+     * @generated from field: toshi.workspace.v1.GrantLevel grant_level = 2;
+     */
+    grantLevel: GrantLevel;
+    /**
+     * The level on this sandbox: the grant's, or VIEW for a sandbox with
+     * bindings or a state volume, or while the owner's workspace is
+     * suspended.
+     *
+     * @generated from field: toshi.workspace.v1.GrantLevel level = 3;
+     */
+    level: GrantLevel;
+    /**
+     * The workspace that owns the sandbox.
+     *
+     * @generated from field: toshi.workspace.v1.GrantWorkspace owner = 4;
+     */
+    owner?: GrantWorkspace | undefined;
+};
+/**
+ * SharedAccess is what a grant gives the grantee on one sandbox.
+ *
+ * @generated from message toshi.workspace.v1.SharedAccess
+ */
+export type SharedAccessJson = {
+    /**
+     * The grant the sandbox was read through.
+     *
+     * @generated from field: string grant_id = 1;
+     */
+    grantId?: string;
+    /**
+     * The grant's level.
+     *
+     * @generated from field: toshi.workspace.v1.GrantLevel grant_level = 2;
+     */
+    grantLevel?: GrantLevelJson;
+    /**
+     * The level on this sandbox: the grant's, or VIEW for a sandbox with
+     * bindings or a state volume, or while the owner's workspace is
+     * suspended.
+     *
+     * @generated from field: toshi.workspace.v1.GrantLevel level = 3;
+     */
+    level?: GrantLevelJson;
+    /**
+     * The workspace that owns the sandbox.
+     *
+     * @generated from field: toshi.workspace.v1.GrantWorkspace owner = 4;
+     */
+    owner?: GrantWorkspaceJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.SharedAccess.
+ * Use `create(SharedAccessSchema)` to create a new message.
+ */
+export declare const SharedAccessSchema: GenMessage<SharedAccess, {
+    jsonType: SharedAccessJson;
+}>;
+/**
+ * GrantWorkspace is one side of a grant.
+ *
+ * @generated from message toshi.workspace.v1.GrantWorkspace
+ */
+export type GrantWorkspace = Message<"toshi.workspace.v1.GrantWorkspace"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * Empty once the workspace is deleted.
+     *
+     * @generated from field: string name = 2;
+     */
+    name: string;
+};
+/**
+ * GrantWorkspace is one side of a grant.
+ *
+ * @generated from message toshi.workspace.v1.GrantWorkspace
+ */
+export type GrantWorkspaceJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+    /**
+     * Empty once the workspace is deleted.
+     *
+     * @generated from field: string name = 2;
+     */
+    name?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.GrantWorkspace.
+ * Use `create(GrantWorkspaceSchema)` to create a new message.
+ */
+export declare const GrantWorkspaceSchema: GenMessage<GrantWorkspace, {
+    jsonType: GrantWorkspaceJson;
+}>;
+/**
+ * GrantEnvironmentTarget covers every sandbox of one environment.
+ *
+ * @generated from message toshi.workspace.v1.GrantEnvironmentTarget
+ */
+export type GrantEnvironmentTarget = Message<"toshi.workspace.v1.GrantEnvironmentTarget"> & {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project: string;
+    /**
+     * @generated from field: string environment = 2;
+     */
+    environment: string;
+};
+/**
+ * GrantEnvironmentTarget covers every sandbox of one environment.
+ *
+ * @generated from message toshi.workspace.v1.GrantEnvironmentTarget
+ */
+export type GrantEnvironmentTargetJson = {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project?: string;
+    /**
+     * @generated from field: string environment = 2;
+     */
+    environment?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.GrantEnvironmentTarget.
+ * Use `create(GrantEnvironmentTargetSchema)` to create a new message.
+ */
+export declare const GrantEnvironmentTargetSchema: GenMessage<GrantEnvironmentTarget, {
+    jsonType: GrantEnvironmentTargetJson;
+}>;
+/**
+ * GrantSandboxTarget covers one sandbox.
+ *
+ * @generated from message toshi.workspace.v1.GrantSandboxTarget
+ */
+export type GrantSandboxTarget = Message<"toshi.workspace.v1.GrantSandboxTarget"> & {
+    /**
+     * @generated from field: string sandbox_id = 1;
+     */
+    sandboxId: string;
+    /**
+     * The sandbox's project and environment, set by the server.
+     *
+     * @generated from field: string project = 2;
+     */
+    project: string;
+    /**
+     * @generated from field: string environment = 3;
+     */
+    environment: string;
+};
+/**
+ * GrantSandboxTarget covers one sandbox.
+ *
+ * @generated from message toshi.workspace.v1.GrantSandboxTarget
+ */
+export type GrantSandboxTargetJson = {
+    /**
+     * @generated from field: string sandbox_id = 1;
+     */
+    sandboxId?: string;
+    /**
+     * The sandbox's project and environment, set by the server.
+     *
+     * @generated from field: string project = 2;
+     */
+    project?: string;
+    /**
+     * @generated from field: string environment = 3;
+     */
+    environment?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.GrantSandboxTarget.
+ * Use `create(GrantSandboxTargetSchema)` to create a new message.
+ */
+export declare const GrantSandboxTargetSchema: GenMessage<GrantSandboxTarget, {
+    jsonType: GrantSandboxTargetJson;
+}>;
+/**
+ * GrantPreviewTarget covers one preview of one sandbox.
+ *
+ * @generated from message toshi.workspace.v1.GrantPreviewTarget
+ */
+export type GrantPreviewTarget = Message<"toshi.workspace.v1.GrantPreviewTarget"> & {
+    /**
+     * @generated from field: string sandbox_id = 1;
+     */
+    sandboxId: string;
+    /**
+     * The channel whose preview it covers: `preview` for the sandbox's own
+     * hostname, or another of its http channels.
+     *
+     * @generated from field: string channel = 2;
+     */
+    channel: string;
+    /**
+     * The sandbox's project and environment, set by the server.
+     *
+     * @generated from field: string project = 3;
+     */
+    project: string;
+    /**
+     * @generated from field: string environment = 4;
+     */
+    environment: string;
+};
+/**
+ * GrantPreviewTarget covers one preview of one sandbox.
+ *
+ * @generated from message toshi.workspace.v1.GrantPreviewTarget
+ */
+export type GrantPreviewTargetJson = {
+    /**
+     * @generated from field: string sandbox_id = 1;
+     */
+    sandboxId?: string;
+    /**
+     * The channel whose preview it covers: `preview` for the sandbox's own
+     * hostname, or another of its http channels.
+     *
+     * @generated from field: string channel = 2;
+     */
+    channel?: string;
+    /**
+     * The sandbox's project and environment, set by the server.
+     *
+     * @generated from field: string project = 3;
+     */
+    project?: string;
+    /**
+     * @generated from field: string environment = 4;
+     */
+    environment?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.GrantPreviewTarget.
+ * Use `create(GrantPreviewTargetSchema)` to create a new message.
+ */
+export declare const GrantPreviewTargetSchema: GenMessage<GrantPreviewTarget, {
+    jsonType: GrantPreviewTargetJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.CreateGrantRequest
+ */
+export type CreateGrantRequest = Message<"toshi.workspace.v1.CreateGrantRequest"> & {
+    /**
+     * The id of the workspace the grant is offered to.
+     *
+     * @generated from field: string grantee_workspace = 1;
+     */
+    granteeWorkspace: string;
+    /**
+     * What it covers, in the caller's workspace.
+     *
+     * @generated from oneof toshi.workspace.v1.CreateGrantRequest.target
+     */
+    target: {
+        /**
+         * @generated from field: toshi.workspace.v1.GrantEnvironmentTarget environment = 2;
+         */
+        value: GrantEnvironmentTarget;
+        case: "environment";
+    } | {
+        /**
+         * @generated from field: toshi.workspace.v1.GrantSandboxTarget sandbox = 3;
+         */
+        value: GrantSandboxTarget;
+        case: "sandbox";
+    } | {
+        /**
+         * @generated from field: toshi.workspace.v1.GrantPreviewTarget preview = 4;
+         */
+        value: GrantPreviewTarget;
+        case: "preview";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+    /**
+     * VIEW for a preview.
+     *
+     * @generated from field: toshi.workspace.v1.GrantLevel level = 5;
+     */
+    level: GrantLevel;
+    /**
+     * Unset for no expiry.
+     *
+     * @generated from field: google.protobuf.Timestamp expires_at = 6;
+     */
+    expiresAt?: Timestamp | undefined;
+    /**
+     * @generated from field: string request_key = 7;
+     */
+    requestKey: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.CreateGrantRequest
+ */
+export type CreateGrantRequestJson = {
+    /**
+     * The id of the workspace the grant is offered to.
+     *
+     * @generated from field: string grantee_workspace = 1;
+     */
+    granteeWorkspace?: string;
+    /**
+     * @generated from field: toshi.workspace.v1.GrantEnvironmentTarget environment = 2;
+     */
+    environment?: GrantEnvironmentTargetJson;
+    /**
+     * @generated from field: toshi.workspace.v1.GrantSandboxTarget sandbox = 3;
+     */
+    sandbox?: GrantSandboxTargetJson;
+    /**
+     * @generated from field: toshi.workspace.v1.GrantPreviewTarget preview = 4;
+     */
+    preview?: GrantPreviewTargetJson;
+    /**
+     * VIEW for a preview.
+     *
+     * @generated from field: toshi.workspace.v1.GrantLevel level = 5;
+     */
+    level?: GrantLevelJson;
+    /**
+     * Unset for no expiry.
+     *
+     * @generated from field: google.protobuf.Timestamp expires_at = 6;
+     */
+    expiresAt?: TimestampJson;
+    /**
+     * @generated from field: string request_key = 7;
+     */
+    requestKey?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.CreateGrantRequest.
+ * Use `create(CreateGrantRequestSchema)` to create a new message.
+ */
+export declare const CreateGrantRequestSchema: GenMessage<CreateGrantRequest, {
+    jsonType: CreateGrantRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.CreateGrantResponse
+ */
+export type CreateGrantResponse = Message<"toshi.workspace.v1.CreateGrantResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.Grant grant = 1;
+     */
+    grant?: Grant | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.CreateGrantResponse
+ */
+export type CreateGrantResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.Grant grant = 1;
+     */
+    grant?: GrantJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.CreateGrantResponse.
+ * Use `create(CreateGrantResponseSchema)` to create a new message.
+ */
+export declare const CreateGrantResponseSchema: GenMessage<CreateGrantResponse, {
+    jsonType: CreateGrantResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetGrantRequest
+ */
+export type GetGrantRequest = Message<"toshi.workspace.v1.GetGrantRequest"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.GetGrantRequest
+ */
+export type GetGrantRequestJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.GetGrantRequest.
+ * Use `create(GetGrantRequestSchema)` to create a new message.
+ */
+export declare const GetGrantRequestSchema: GenMessage<GetGrantRequest, {
+    jsonType: GetGrantRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetGrantResponse
+ */
+export type GetGrantResponse = Message<"toshi.workspace.v1.GetGrantResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.Grant grant = 1;
+     */
+    grant?: Grant | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.GetGrantResponse
+ */
+export type GetGrantResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.Grant grant = 1;
+     */
+    grant?: GrantJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.GetGrantResponse.
+ * Use `create(GetGrantResponseSchema)` to create a new message.
+ */
+export declare const GetGrantResponseSchema: GenMessage<GetGrantResponse, {
+    jsonType: GetGrantResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.ListGrantsRequest
+ */
+export type ListGrantsRequest = Message<"toshi.workspace.v1.ListGrantsRequest"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.GrantSide side = 1;
+     */
+    side: GrantSide;
+    /**
+     * The states to list; empty lists every state.
+     *
+     * @generated from field: repeated toshi.workspace.v1.GrantState states = 2;
+     */
+    states: GrantState[];
+    /**
+     * The most grants 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.ListGrantsRequest
+ */
+export type ListGrantsRequestJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.GrantSide side = 1;
+     */
+    side?: GrantSideJson;
+    /**
+     * The states to list; empty lists every state.
+     *
+     * @generated from field: repeated toshi.workspace.v1.GrantState states = 2;
+     */
+    states?: GrantStateJson[];
+    /**
+     * The most grants 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.ListGrantsRequest.
+ * Use `create(ListGrantsRequestSchema)` to create a new message.
+ */
+export declare const ListGrantsRequestSchema: GenMessage<ListGrantsRequest, {
+    jsonType: ListGrantsRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.ListGrantsResponse
+ */
+export type ListGrantsResponse = Message<"toshi.workspace.v1.ListGrantsResponse"> & {
+    /**
+     * @generated from field: repeated toshi.workspace.v1.Grant grants = 1;
+     */
+    grants: Grant[];
+    /**
+     * Empty on the last page.
+     *
+     * @generated from field: string next_page_token = 2;
+     */
+    nextPageToken: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.ListGrantsResponse
+ */
+export type ListGrantsResponseJson = {
+    /**
+     * @generated from field: repeated toshi.workspace.v1.Grant grants = 1;
+     */
+    grants?: GrantJson[];
+    /**
+     * Empty on the last page.
+     *
+     * @generated from field: string next_page_token = 2;
+     */
+    nextPageToken?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.ListGrantsResponse.
+ * Use `create(ListGrantsResponseSchema)` to create a new message.
+ */
+export declare const ListGrantsResponseSchema: GenMessage<ListGrantsResponse, {
+    jsonType: ListGrantsResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.AcceptGrantRequest
+ */
+export type AcceptGrantRequest = Message<"toshi.workspace.v1.AcceptGrantRequest"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.AcceptGrantRequest
+ */
+export type AcceptGrantRequestJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.AcceptGrantRequest.
+ * Use `create(AcceptGrantRequestSchema)` to create a new message.
+ */
+export declare const AcceptGrantRequestSchema: GenMessage<AcceptGrantRequest, {
+    jsonType: AcceptGrantRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.AcceptGrantResponse
+ */
+export type AcceptGrantResponse = Message<"toshi.workspace.v1.AcceptGrantResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.Grant grant = 1;
+     */
+    grant?: Grant | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.AcceptGrantResponse
+ */
+export type AcceptGrantResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.Grant grant = 1;
+     */
+    grant?: GrantJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.AcceptGrantResponse.
+ * Use `create(AcceptGrantResponseSchema)` to create a new message.
+ */
+export declare const AcceptGrantResponseSchema: GenMessage<AcceptGrantResponse, {
+    jsonType: AcceptGrantResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.DeclineGrantRequest
+ */
+export type DeclineGrantRequest = Message<"toshi.workspace.v1.DeclineGrantRequest"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.DeclineGrantRequest
+ */
+export type DeclineGrantRequestJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.DeclineGrantRequest.
+ * Use `create(DeclineGrantRequestSchema)` to create a new message.
+ */
+export declare const DeclineGrantRequestSchema: GenMessage<DeclineGrantRequest, {
+    jsonType: DeclineGrantRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.DeclineGrantResponse
+ */
+export type DeclineGrantResponse = Message<"toshi.workspace.v1.DeclineGrantResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.Grant grant = 1;
+     */
+    grant?: Grant | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.DeclineGrantResponse
+ */
+export type DeclineGrantResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.Grant grant = 1;
+     */
+    grant?: GrantJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.DeclineGrantResponse.
+ * Use `create(DeclineGrantResponseSchema)` to create a new message.
+ */
+export declare const DeclineGrantResponseSchema: GenMessage<DeclineGrantResponse, {
+    jsonType: DeclineGrantResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.UpdateGrantRequest
+ */
+export type UpdateGrantRequest = Message<"toshi.workspace.v1.UpdateGrantRequest"> & {
+    /**
+     * id names the grant; expires_at is the one field set.
+     *
+     * @generated from field: toshi.workspace.v1.Grant grant = 1;
+     */
+    grant?: Grant | undefined;
+    /**
+     * @generated from field: google.protobuf.FieldMask update_mask = 2;
+     */
+    updateMask?: FieldMask | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.UpdateGrantRequest
+ */
+export type UpdateGrantRequestJson = {
+    /**
+     * id names the grant; expires_at is the one field set.
+     *
+     * @generated from field: toshi.workspace.v1.Grant grant = 1;
+     */
+    grant?: GrantJson;
+    /**
+     * @generated from field: google.protobuf.FieldMask update_mask = 2;
+     */
+    updateMask?: FieldMaskJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.UpdateGrantRequest.
+ * Use `create(UpdateGrantRequestSchema)` to create a new message.
+ */
+export declare const UpdateGrantRequestSchema: GenMessage<UpdateGrantRequest, {
+    jsonType: UpdateGrantRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.UpdateGrantResponse
+ */
+export type UpdateGrantResponse = Message<"toshi.workspace.v1.UpdateGrantResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.Grant grant = 1;
+     */
+    grant?: Grant | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.UpdateGrantResponse
+ */
+export type UpdateGrantResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.Grant grant = 1;
+     */
+    grant?: GrantJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.UpdateGrantResponse.
+ * Use `create(UpdateGrantResponseSchema)` to create a new message.
+ */
+export declare const UpdateGrantResponseSchema: GenMessage<UpdateGrantResponse, {
+    jsonType: UpdateGrantResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.RevokeGrantRequest
+ */
+export type RevokeGrantRequest = Message<"toshi.workspace.v1.RevokeGrantRequest"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.RevokeGrantRequest
+ */
+export type RevokeGrantRequestJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.RevokeGrantRequest.
+ * Use `create(RevokeGrantRequestSchema)` to create a new message.
+ */
+export declare const RevokeGrantRequestSchema: GenMessage<RevokeGrantRequest, {
+    jsonType: RevokeGrantRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.RevokeGrantResponse
+ */
+export type RevokeGrantResponse = Message<"toshi.workspace.v1.RevokeGrantResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.Grant grant = 1;
+     */
+    grant?: Grant | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.RevokeGrantResponse
+ */
+export type RevokeGrantResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.Grant grant = 1;
+     */
+    grant?: GrantJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.RevokeGrantResponse.
+ * Use `create(RevokeGrantResponseSchema)` to create a new message.
+ */
+export declare const RevokeGrantResponseSchema: GenMessage<RevokeGrantResponse, {
+    jsonType: RevokeGrantResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.LeaveGrantRequest
+ */
+export type LeaveGrantRequest = Message<"toshi.workspace.v1.LeaveGrantRequest"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.LeaveGrantRequest
+ */
+export type LeaveGrantRequestJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.LeaveGrantRequest.
+ * Use `create(LeaveGrantRequestSchema)` to create a new message.
+ */
+export declare const LeaveGrantRequestSchema: GenMessage<LeaveGrantRequest, {
+    jsonType: LeaveGrantRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.LeaveGrantResponse
+ */
+export type LeaveGrantResponse = Message<"toshi.workspace.v1.LeaveGrantResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.Grant grant = 1;
+     */
+    grant?: Grant | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.LeaveGrantResponse
+ */
+export type LeaveGrantResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.Grant grant = 1;
+     */
+    grant?: GrantJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.LeaveGrantResponse.
+ * Use `create(LeaveGrantResponseSchema)` to create a new message.
+ */
+export declare const LeaveGrantResponseSchema: GenMessage<LeaveGrantResponse, {
+    jsonType: LeaveGrantResponseJson;
+}>;
+/**
+ * GrantLevel is what a grant lets the grantee do; each level includes the
+ * one before.
+ *
+ * @generated from enum toshi.workspace.v1.GrantLevel
+ */
+export declare enum GrantLevel {
+    /**
+     * @generated from enum value: GRANT_LEVEL_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * List, get and watch the sandboxes the grant covers; sign in to their
+     * previews.
+     *
+     * @generated from enum value: GRANT_LEVEL_VIEW = 1;
+     */
+    VIEW = 1,
+    /**
+     * Also connect to their channels, open forwards and display sessions.
+     *
+     * @generated from enum value: GRANT_LEVEL_CONNECT = 2;
+     */
+    CONNECT = 2,
+    /**
+     * Also run and cancel executions, raise a sandbox's cap within the
+     * owner's plan, and expose channels and delete the ones it exposed.
+     *
+     * @generated from enum value: GRANT_LEVEL_OPERATE = 3;
+     */
+    OPERATE = 3
+}
+/**
+ * GrantLevel is what a grant lets the grantee do; each level includes the
+ * one before.
+ *
+ * @generated from enum toshi.workspace.v1.GrantLevel
+ */
+export type GrantLevelJson = "GRANT_LEVEL_UNSPECIFIED" | "GRANT_LEVEL_VIEW" | "GRANT_LEVEL_CONNECT" | "GRANT_LEVEL_OPERATE";
+/**
+ * Describes the enum toshi.workspace.v1.GrantLevel.
+ */
+export declare const GrantLevelSchema: GenEnum<GrantLevel, GrantLevelJson>;
+/**
+ * GrantState is where a grant is in its life. OFFERED and ACTIVE are
+ * live; every other state is final.
+ *
+ * @generated from enum toshi.workspace.v1.GrantState
+ */
+export declare enum GrantState {
+    /**
+     * @generated from enum value: GRANT_STATE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Offered and not yet answered.
+     *
+     * @generated from enum value: GRANT_STATE_OFFERED = 1;
+     */
+    OFFERED = 1,
+    /**
+     * Accepted: the grantee reaches the target.
+     *
+     * @generated from enum value: GRANT_STATE_ACTIVE = 2;
+     */
+    ACTIVE = 2,
+    /**
+     * The grantee declined the offer.
+     *
+     * @generated from enum value: GRANT_STATE_DECLINED = 3;
+     */
+    DECLINED = 3,
+    /**
+     * The offer was not answered in time, or a side stopped being active
+     * while it was open.
+     *
+     * @generated from enum value: GRANT_STATE_LAPSED = 4;
+     */
+    LAPSED = 4,
+    /**
+     * The owner revoked it, or the grantee left it.
+     *
+     * @generated from enum value: GRANT_STATE_REVOKED = 5;
+     */
+    REVOKED = 5,
+    /**
+     * Its expiry passed.
+     *
+     * @generated from enum value: GRANT_STATE_EXPIRED = 6;
+     */
+    EXPIRED = 6,
+    /**
+     * One of the two workspaces was deleted.
+     *
+     * @generated from enum value: GRANT_STATE_ENDED = 7;
+     */
+    ENDED = 7
+}
+/**
+ * GrantState is where a grant is in its life. OFFERED and ACTIVE are
+ * live; every other state is final.
+ *
+ * @generated from enum toshi.workspace.v1.GrantState
+ */
+export type GrantStateJson = "GRANT_STATE_UNSPECIFIED" | "GRANT_STATE_OFFERED" | "GRANT_STATE_ACTIVE" | "GRANT_STATE_DECLINED" | "GRANT_STATE_LAPSED" | "GRANT_STATE_REVOKED" | "GRANT_STATE_EXPIRED" | "GRANT_STATE_ENDED";
+/**
+ * Describes the enum toshi.workspace.v1.GrantState.
+ */
+export declare const GrantStateSchema: GenEnum<GrantState, GrantStateJson>;
+/**
+ * GrantSide is which of a workspace's grants a list returns.
+ *
+ * @generated from enum toshi.workspace.v1.GrantSide
+ */
+export declare enum GrantSide {
+    /**
+     * Both the grants it gave and those it received.
+     *
+     * @generated from enum value: GRANT_SIDE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * The grants it gave, as the owner.
+     *
+     * @generated from enum value: GRANT_SIDE_GIVEN = 1;
+     */
+    GIVEN = 1,
+    /**
+     * The grants it received, as the grantee.
+     *
+     * @generated from enum value: GRANT_SIDE_RECEIVED = 2;
+     */
+    RECEIVED = 2
+}
+/**
+ * GrantSide is which of a workspace's grants a list returns.
+ *
+ * @generated from enum toshi.workspace.v1.GrantSide
+ */
+export type GrantSideJson = "GRANT_SIDE_UNSPECIFIED" | "GRANT_SIDE_GIVEN" | "GRANT_SIDE_RECEIVED";
+/**
+ * Describes the enum toshi.workspace.v1.GrantSide.
+ */
+export declare const GrantSideSchema: GenEnum<GrantSide, GrantSideJson>;
+/**
+ * GrantService keeps the grants between workspaces: one workspace, the
+ * owner, lets another, the grantee, reach one of its environments,
+ * sandboxes or previews at a level. The owner offers a grant to the
+ * grantee's workspace id, and nothing is shared until a person of the
+ * grantee accepts it. Either side ends it at once: the owner revokes it,
+ * the grantee leaves it. An offer not answered lapses, and a grant with
+ * an expiry expires when it passes.
+ *
+ * The caller's credential names the workspace, as for WorkloadService.
+ * Each call answers for the caller's side only: a grant the workspace
+ * neither gave nor received, or one the call does not act on from the
+ * caller's side, is NOT_FOUND. Offering, accepting, declining and
+ * changing the expiry take a person's session: an API token is refused
+ * with PERMISSION_DENIED, as only a person may open a workspace to
+ * another. A workspace that is not active can neither offer nor be
+ * offered a grant (FAILED_PRECONDITION).
+ *
+ * Every change writes an audit event into both workspaces' logs, with the
+ * same request id; each names the other workspace in its details.
+ *
+ * @generated from service toshi.workspace.v1.GrantService
+ */
+export declare const GrantService: GenService<{
+    /**
+     * CreateGrant offers a grant on the caller's workspace to the workspace
+     * grantee_workspace names, and returns it in the state OFFERED. A
+     * sandbox with bindings or a state volume is offered at VIEW only:
+     * CONNECT or OPERATE for it is FAILED_PRECONDITION. A grantee that is
+     * the caller's own workspace is INVALID_ARGUMENT, an environment or
+     * sandbox the workspace does not have NOT_FOUND, and an offer on a plan
+     * with no grants, or past the plan's grants at once or offers a day,
+     * RESOURCE_EXHAUSTED.
+     *
+     * @generated from rpc toshi.workspace.v1.GrantService.CreateGrant
+     */
+    createGrant: {
+        methodKind: "unary";
+        input: typeof CreateGrantRequestSchema;
+        output: typeof CreateGrantResponseSchema;
+    };
+    /**
+     * GetGrant returns one grant the workspace gave or received.
+     *
+     * @generated from rpc toshi.workspace.v1.GrantService.GetGrant
+     */
+    getGrant: {
+        methodKind: "unary";
+        input: typeof GetGrantRequestSchema;
+        output: typeof GetGrantResponseSchema;
+    };
+    /**
+     * ListGrants returns the grants the workspace gave, received, or both,
+     * newest offered first, in the states the request names (all when it
+     * names none).
+     *
+     * A page holds 100 grants when page_size is zero, and 1000 at most.
+     *
+     * @generated from rpc toshi.workspace.v1.GrantService.ListGrants
+     */
+    listGrants: {
+        methodKind: "unary";
+        input: typeof ListGrantsRequestSchema;
+        output: typeof ListGrantsResponseSchema;
+    };
+    /**
+     * AcceptGrant accepts an offer the workspace received: the grant becomes
+     * ACTIVE. An offer no longer OFFERED is FAILED_PRECONDITION.
+     *
+     * @generated from rpc toshi.workspace.v1.GrantService.AcceptGrant
+     */
+    acceptGrant: {
+        methodKind: "unary";
+        input: typeof AcceptGrantRequestSchema;
+        output: typeof AcceptGrantResponseSchema;
+    };
+    /**
+     * DeclineGrant declines an offer the workspace received: the grant
+     * becomes DECLINED. An offer no longer OFFERED is FAILED_PRECONDITION.
+     *
+     * @generated from rpc toshi.workspace.v1.GrantService.DeclineGrant
+     */
+    declineGrant: {
+        methodKind: "unary";
+        input: typeof DeclineGrantRequestSchema;
+        output: typeof DeclineGrantResponseSchema;
+    };
+    /**
+     * UpdateGrant sets the fields of grant.id's grant that update_mask
+     * names, on a grant the workspace gave that is OFFERED or ACTIVE. The
+     * one field it sets is expires_at: a time in the future, or unset for
+     * no expiry. An unset update_mask names the fields grant carries. An
+     * empty one, an unset one with no expires_at, "*" and a path of another
+     * field are INVALID_ARGUMENT. A grant that has ended is FAILED_PRECONDITION.
+     *
+     * @generated from rpc toshi.workspace.v1.GrantService.UpdateGrant
+     */
+    updateGrant: {
+        methodKind: "unary";
+        input: typeof UpdateGrantRequestSchema;
+        output: typeof UpdateGrantResponseSchema;
+    };
+    /**
+     * RevokeGrant ends a grant the workspace gave, OFFERED or ACTIVE: it
+     * becomes REVOKED, and nothing reaches the target through it again. A
+     * token limited to a project or an environment may revoke a grant whose
+     * target lies inside its limit. A grant that has ended is returned as it
+     * is.
+     *
+     * @generated from rpc toshi.workspace.v1.GrantService.RevokeGrant
+     */
+    revokeGrant: {
+        methodKind: "unary";
+        input: typeof RevokeGrantRequestSchema;
+        output: typeof RevokeGrantResponseSchema;
+    };
+    /**
+     * LeaveGrant ends a grant the workspace received and accepted: it
+     * becomes REVOKED, recorded as ended by the grantee. A grant that has
+     * ended is returned as it is; an offer is declined, not left
+     * (FAILED_PRECONDITION).
+     *
+     * @generated from rpc toshi.workspace.v1.GrantService.LeaveGrant
+     */
+    leaveGrant: {
+        methodKind: "unary";
+        input: typeof LeaveGrantRequestSchema;
+        output: typeof LeaveGrantResponseSchema;
+    };
+}>;