@toshicloud/sdk 0.5.0 → 0.6.0

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

@@ -0,0 +1,1616 @@
+import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { Duration, DurationJson, FieldMask, FieldMaskJson, Timestamp, TimestampJson } from "@bufbuild/protobuf/wkt";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file toshi/workspace/v1/connections.proto.
+ */
+export declare const file_toshi_workspace_v1_connections: GenFile;
+/**
+ * Connection is one source of a workspace's events.
+ *
+ * @generated from message toshi.workspace.v1.Connection
+ */
+export type Connection = Message<"toshi.workspace.v1.Connection"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * @generated from field: toshi.workspace.v1.ConnectionKind kind = 2;
+     */
+    kind: ConnectionKind;
+    /**
+     * Unique among the workspace's live connections of its kind, WEBHOOK or
+     * MAIL; for GITHUB, the login of the account the App is installed on.
+     *
+     * @generated from field: string name = 3;
+     */
+    name: string;
+    /**
+     * The project and environment a WEBHOOK or MAIL connection's events belong
+     * to; empty for GITHUB, whose events belong to their repository's project.
+     *
+     * @generated from field: string project = 4;
+     */
+    project: string;
+    /**
+     * @generated from field: string environment = 5;
+     */
+    environment: string;
+    /**
+     * The GitHub App installation of a GITHUB connection; zero otherwise.
+     *
+     * @generated from field: int64 installation_id = 6;
+     */
+    installationId: bigint;
+    /**
+     * @generated from field: google.protobuf.Timestamp created_at = 7;
+     */
+    createdAt?: Timestamp | undefined;
+    /**
+     * Until when a rotated WEBHOOK connection's previous secret still
+     * verifies; unset when there is none.
+     *
+     * @generated from field: google.protobuf.Timestamp previous_secret_expires_at = 8;
+     */
+    previousSecretExpiresAt?: Timestamp | undefined;
+    /**
+     * Where a WEBHOOK connection's deliveries are posted in place of the
+     * event log; unset when they become events.
+     *
+     * @generated from field: toshi.workspace.v1.ConnectionTarget target = 10;
+     */
+    target?: ConnectionTarget | undefined;
+    /**
+     * The inbound address a WEBHOOK connection's sender POSTs to: the
+     * deployment's public address and /ingress/ with the connection's
+     * address token. Empty for GITHUB and MAIL, and when the deployment names
+     * no public address.
+     *
+     * @generated from field: string ingress_url = 11;
+     */
+    ingressUrl: string;
+    /**
+     * Who manages this object: "manifest" when the project manifest declares
+     * it, empty when nothing does. A manifest apply sets managed_by,
+     * manifest_digest, manifest_origin and managed_fields together.
+     *
+     * @generated from field: string managed_by = 12;
+     */
+    managedBy: string;
+    /**
+     * The SHA-256 of the manifest file that last set this object, as 64
+     * lowercase hex characters. Empty when managed_by is empty.
+     *
+     * @generated from field: string manifest_digest = 13;
+     */
+    manifestDigest: string;
+    /**
+     * The fields of this object the manifest declares, as update mask paths.
+     * Empty when managed_by is empty.
+     *
+     * @generated from field: repeated string managed_fields = 14;
+     */
+    managedFields: string[];
+    /**
+     * How the manifest came to manage this object: "created" when a manifest
+     * apply created it, "adopted" when an apply took over an object that
+     * already existed. Empty when managed_by is empty.
+     *
+     * @generated from field: string manifest_origin = 15;
+     */
+    manifestOrigin: string;
+    /**
+     * Where a MAIL connection receives mail and where it sends it; unset for
+     * the other kinds.
+     *
+     * @generated from field: toshi.workspace.v1.MailConnection mail = 16;
+     */
+    mail?: MailConnection | undefined;
+};
+/**
+ * Connection is one source of a workspace's events.
+ *
+ * @generated from message toshi.workspace.v1.Connection
+ */
+export type ConnectionJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+    /**
+     * @generated from field: toshi.workspace.v1.ConnectionKind kind = 2;
+     */
+    kind?: ConnectionKindJson;
+    /**
+     * Unique among the workspace's live connections of its kind, WEBHOOK or
+     * MAIL; for GITHUB, the login of the account the App is installed on.
+     *
+     * @generated from field: string name = 3;
+     */
+    name?: string;
+    /**
+     * The project and environment a WEBHOOK or MAIL connection's events belong
+     * to; empty for GITHUB, whose events belong to their repository's project.
+     *
+     * @generated from field: string project = 4;
+     */
+    project?: string;
+    /**
+     * @generated from field: string environment = 5;
+     */
+    environment?: string;
+    /**
+     * The GitHub App installation of a GITHUB connection; zero otherwise.
+     *
+     * @generated from field: int64 installation_id = 6;
+     */
+    installationId?: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp created_at = 7;
+     */
+    createdAt?: TimestampJson;
+    /**
+     * Until when a rotated WEBHOOK connection's previous secret still
+     * verifies; unset when there is none.
+     *
+     * @generated from field: google.protobuf.Timestamp previous_secret_expires_at = 8;
+     */
+    previousSecretExpiresAt?: TimestampJson;
+    /**
+     * Where a WEBHOOK connection's deliveries are posted in place of the
+     * event log; unset when they become events.
+     *
+     * @generated from field: toshi.workspace.v1.ConnectionTarget target = 10;
+     */
+    target?: ConnectionTargetJson;
+    /**
+     * The inbound address a WEBHOOK connection's sender POSTs to: the
+     * deployment's public address and /ingress/ with the connection's
+     * address token. Empty for GITHUB and MAIL, and when the deployment names
+     * no public address.
+     *
+     * @generated from field: string ingress_url = 11;
+     */
+    ingressUrl?: string;
+    /**
+     * Who manages this object: "manifest" when the project manifest declares
+     * it, empty when nothing does. A manifest apply sets managed_by,
+     * manifest_digest, manifest_origin and managed_fields together.
+     *
+     * @generated from field: string managed_by = 12;
+     */
+    managedBy?: string;
+    /**
+     * The SHA-256 of the manifest file that last set this object, as 64
+     * lowercase hex characters. Empty when managed_by is empty.
+     *
+     * @generated from field: string manifest_digest = 13;
+     */
+    manifestDigest?: string;
+    /**
+     * The fields of this object the manifest declares, as update mask paths.
+     * Empty when managed_by is empty.
+     *
+     * @generated from field: repeated string managed_fields = 14;
+     */
+    managedFields?: string[];
+    /**
+     * How the manifest came to manage this object: "created" when a manifest
+     * apply created it, "adopted" when an apply took over an object that
+     * already existed. Empty when managed_by is empty.
+     *
+     * @generated from field: string manifest_origin = 15;
+     */
+    manifestOrigin?: string;
+    /**
+     * Where a MAIL connection receives mail and where it sends it; unset for
+     * the other kinds.
+     *
+     * @generated from field: toshi.workspace.v1.MailConnection mail = 16;
+     */
+    mail?: MailConnectionJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.Connection.
+ * Use `create(ConnectionSchema)` to create a new message.
+ */
+export declare const ConnectionSchema: GenMessage<Connection, {
+    jsonType: ConnectionJson;
+}>;
+/**
+ * MailConnection is where a MAIL connection receives mail and where it
+ * sends it.
+ *
+ * @generated from message toshi.workspace.v1.MailConnection
+ */
+export type MailConnection = Message<"toshi.workspace.v1.MailConnection"> & {
+    /**
+     * Output only. The address mail is received at: the connection's name,
+     * "@", the workspace's ID and the deployment's inbound mail domain, all
+     * lowercase.
+     *
+     * @generated from field: string address = 1;
+     */
+    address: string;
+    /**
+     * The service, by its ID, whose event channel the mail goes to.
+     *
+     * @generated from field: string service = 2;
+     */
+    service: string;
+    /**
+     * The name of that service's event channel.
+     *
+     * @generated from field: string channel = 3;
+     */
+    channel: string;
+    /**
+     * Output only. The mail provider that receives for the address, such as
+     * "ses".
+     *
+     * @generated from field: string provider = 4;
+     */
+    provider: string;
+};
+/**
+ * MailConnection is where a MAIL connection receives mail and where it
+ * sends it.
+ *
+ * @generated from message toshi.workspace.v1.MailConnection
+ */
+export type MailConnectionJson = {
+    /**
+     * Output only. The address mail is received at: the connection's name,
+     * "@", the workspace's ID and the deployment's inbound mail domain, all
+     * lowercase.
+     *
+     * @generated from field: string address = 1;
+     */
+    address?: string;
+    /**
+     * The service, by its ID, whose event channel the mail goes to.
+     *
+     * @generated from field: string service = 2;
+     */
+    service?: string;
+    /**
+     * The name of that service's event channel.
+     *
+     * @generated from field: string channel = 3;
+     */
+    channel?: string;
+    /**
+     * Output only. The mail provider that receives for the address, such as
+     * "ses".
+     *
+     * @generated from field: string provider = 4;
+     */
+    provider?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.MailConnection.
+ * Use `create(MailConnectionSchema)` to create a new message.
+ */
+export declare const MailConnectionSchema: GenMessage<MailConnection, {
+    jsonType: MailConnectionJson;
+}>;
+/**
+ * ConnectionTarget is the URL a WEBHOOK connection's deliveries are posted
+ * to: each delivery's event, as the event log would hold it, signed as
+ * Standard Webhooks does with the target's own secret, until the URL
+ * answers 2xx or the tries run out.
+ *
+ * @generated from message toshi.workspace.v1.ConnectionTarget
+ */
+export type ConnectionTarget = Message<"toshi.workspace.v1.ConnectionTarget"> & {
+    /**
+     * url is the https URL the events are posted to.
+     *
+     * @generated from field: string url = 1;
+     */
+    url: string;
+    /**
+     * secret is the signing secret: "whsec_" and the base64 of 24 to 64
+     * bytes. Input only: no call returns it.
+     *
+     * @generated from field: string secret = 2;
+     */
+    secret: string;
+    /**
+     * updated_by is who set it last, as the audit log names them.
+     *
+     * @generated from field: string updated_by = 3;
+     */
+    updatedBy: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp updated_at = 4;
+     */
+    updatedAt?: Timestamp | undefined;
+};
+/**
+ * ConnectionTarget is the URL a WEBHOOK connection's deliveries are posted
+ * to: each delivery's event, as the event log would hold it, signed as
+ * Standard Webhooks does with the target's own secret, until the URL
+ * answers 2xx or the tries run out.
+ *
+ * @generated from message toshi.workspace.v1.ConnectionTarget
+ */
+export type ConnectionTargetJson = {
+    /**
+     * url is the https URL the events are posted to.
+     *
+     * @generated from field: string url = 1;
+     */
+    url?: string;
+    /**
+     * secret is the signing secret: "whsec_" and the base64 of 24 to 64
+     * bytes. Input only: no call returns it.
+     *
+     * @generated from field: string secret = 2;
+     */
+    secret?: string;
+    /**
+     * updated_by is who set it last, as the audit log names them.
+     *
+     * @generated from field: string updated_by = 3;
+     */
+    updatedBy?: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp updated_at = 4;
+     */
+    updatedAt?: TimestampJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.ConnectionTarget.
+ * Use `create(ConnectionTargetSchema)` to create a new message.
+ */
+export declare const ConnectionTargetSchema: GenMessage<ConnectionTarget, {
+    jsonType: ConnectionTargetJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.ListConnectionsRequest
+ */
+export type ListConnectionsRequest = Message<"toshi.workspace.v1.ListConnectionsRequest"> & {
+    /**
+     * The most connections in one page; zero lets the server choose.
+     *
+     * @generated from field: int32 page_size = 1;
+     */
+    pageSize: number;
+    /**
+     * From an earlier response's next_page_token; empty for the first page.
+     *
+     * @generated from field: string page_token = 2;
+     */
+    pageToken: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.ListConnectionsRequest
+ */
+export type ListConnectionsRequestJson = {
+    /**
+     * The most connections in one page; zero lets the server choose.
+     *
+     * @generated from field: int32 page_size = 1;
+     */
+    pageSize?: number;
+    /**
+     * From an earlier response's next_page_token; empty for the first page.
+     *
+     * @generated from field: string page_token = 2;
+     */
+    pageToken?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.ListConnectionsRequest.
+ * Use `create(ListConnectionsRequestSchema)` to create a new message.
+ */
+export declare const ListConnectionsRequestSchema: GenMessage<ListConnectionsRequest, {
+    jsonType: ListConnectionsRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.ListConnectionsResponse
+ */
+export type ListConnectionsResponse = Message<"toshi.workspace.v1.ListConnectionsResponse"> & {
+    /**
+     * @generated from field: repeated toshi.workspace.v1.Connection connections = 1;
+     */
+    connections: Connection[];
+    /**
+     * Empty on the last page.
+     *
+     * @generated from field: string next_page_token = 2;
+     */
+    nextPageToken: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.ListConnectionsResponse
+ */
+export type ListConnectionsResponseJson = {
+    /**
+     * @generated from field: repeated toshi.workspace.v1.Connection connections = 1;
+     */
+    connections?: ConnectionJson[];
+    /**
+     * Empty on the last page.
+     *
+     * @generated from field: string next_page_token = 2;
+     */
+    nextPageToken?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.ListConnectionsResponse.
+ * Use `create(ListConnectionsResponseSchema)` to create a new message.
+ */
+export declare const ListConnectionsResponseSchema: GenMessage<ListConnectionsResponse, {
+    jsonType: ListConnectionsResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetConnectionRequest
+ */
+export type GetConnectionRequest = Message<"toshi.workspace.v1.GetConnectionRequest"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.GetConnectionRequest
+ */
+export type GetConnectionRequestJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.GetConnectionRequest.
+ * Use `create(GetConnectionRequestSchema)` to create a new message.
+ */
+export declare const GetConnectionRequestSchema: GenMessage<GetConnectionRequest, {
+    jsonType: GetConnectionRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetConnectionResponse
+ */
+export type GetConnectionResponse = Message<"toshi.workspace.v1.GetConnectionResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.Connection connection = 1;
+     */
+    connection?: Connection | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.GetConnectionResponse
+ */
+export type GetConnectionResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.Connection connection = 1;
+     */
+    connection?: ConnectionJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.GetConnectionResponse.
+ * Use `create(GetConnectionResponseSchema)` to create a new message.
+ */
+export declare const GetConnectionResponseSchema: GenMessage<GetConnectionResponse, {
+    jsonType: GetConnectionResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.CreateConnectionRequest
+ */
+export type CreateConnectionRequest = Message<"toshi.workspace.v1.CreateConnectionRequest"> & {
+    /**
+     * The kind to create: WEBHOOK or MAIL. Installing the GitHub App creates
+     * a GITHUB connection.
+     *
+     * @generated from field: toshi.workspace.v1.ConnectionKind kind = 1;
+     */
+    kind: ConnectionKind;
+    /**
+     * A lowercase DNS label of at most 63 characters.
+     *
+     * @generated from field: string name = 2;
+     */
+    name: string;
+    /**
+     * The project and environment the connection's events belong to. Both
+     * are required for WEBHOOK. For MAIL they are optional, and when set must
+     * be the service's.
+     *
+     * @generated from field: string project = 3;
+     */
+    project: string;
+    /**
+     * @generated from field: string environment = 4;
+     */
+    environment: string;
+    /**
+     * @generated from field: string request_key = 5;
+     */
+    requestKey: string;
+    /**
+     * The mail address and where its mail goes, for a MAIL connection; unset
+     * for WEBHOOK. service and channel are required; address and provider are
+     * output only, and ignored on input.
+     *
+     * @generated from field: toshi.workspace.v1.MailConnection mail = 6;
+     */
+    mail?: MailConnection | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.CreateConnectionRequest
+ */
+export type CreateConnectionRequestJson = {
+    /**
+     * The kind to create: WEBHOOK or MAIL. Installing the GitHub App creates
+     * a GITHUB connection.
+     *
+     * @generated from field: toshi.workspace.v1.ConnectionKind kind = 1;
+     */
+    kind?: ConnectionKindJson;
+    /**
+     * A lowercase DNS label of at most 63 characters.
+     *
+     * @generated from field: string name = 2;
+     */
+    name?: string;
+    /**
+     * The project and environment the connection's events belong to. Both
+     * are required for WEBHOOK. For MAIL they are optional, and when set must
+     * be the service's.
+     *
+     * @generated from field: string project = 3;
+     */
+    project?: string;
+    /**
+     * @generated from field: string environment = 4;
+     */
+    environment?: string;
+    /**
+     * @generated from field: string request_key = 5;
+     */
+    requestKey?: string;
+    /**
+     * The mail address and where its mail goes, for a MAIL connection; unset
+     * for WEBHOOK. service and channel are required; address and provider are
+     * output only, and ignored on input.
+     *
+     * @generated from field: toshi.workspace.v1.MailConnection mail = 6;
+     */
+    mail?: MailConnectionJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.CreateConnectionRequest.
+ * Use `create(CreateConnectionRequestSchema)` to create a new message.
+ */
+export declare const CreateConnectionRequestSchema: GenMessage<CreateConnectionRequest, {
+    jsonType: CreateConnectionRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.CreateConnectionResponse
+ */
+export type CreateConnectionResponse = Message<"toshi.workspace.v1.CreateConnectionResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.Connection connection = 1;
+     */
+    connection?: Connection | undefined;
+    /**
+     * The signing secret in its whsec_ form, for the sender to sign its
+     * requests with; empty for a MAIL connection. Shown only in this answer
+     * and an identical retry's.
+     *
+     * @generated from field: string secret = 2;
+     */
+    secret: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.CreateConnectionResponse
+ */
+export type CreateConnectionResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.Connection connection = 1;
+     */
+    connection?: ConnectionJson;
+    /**
+     * The signing secret in its whsec_ form, for the sender to sign its
+     * requests with; empty for a MAIL connection. Shown only in this answer
+     * and an identical retry's.
+     *
+     * @generated from field: string secret = 2;
+     */
+    secret?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.CreateConnectionResponse.
+ * Use `create(CreateConnectionResponseSchema)` to create a new message.
+ */
+export declare const CreateConnectionResponseSchema: GenMessage<CreateConnectionResponse, {
+    jsonType: CreateConnectionResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.DeleteConnectionRequest
+ */
+export type DeleteConnectionRequest = Message<"toshi.workspace.v1.DeleteConnectionRequest"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * @generated from field: string request_key = 2;
+     */
+    requestKey: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.DeleteConnectionRequest
+ */
+export type DeleteConnectionRequestJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+    /**
+     * @generated from field: string request_key = 2;
+     */
+    requestKey?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.DeleteConnectionRequest.
+ * Use `create(DeleteConnectionRequestSchema)` to create a new message.
+ */
+export declare const DeleteConnectionRequestSchema: GenMessage<DeleteConnectionRequest, {
+    jsonType: DeleteConnectionRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.DeleteConnectionResponse
+ */
+export type DeleteConnectionResponse = Message<"toshi.workspace.v1.DeleteConnectionResponse"> & {};
+/**
+ * @generated from message toshi.workspace.v1.DeleteConnectionResponse
+ */
+export type DeleteConnectionResponseJson = {};
+/**
+ * Describes the message toshi.workspace.v1.DeleteConnectionResponse.
+ * Use `create(DeleteConnectionResponseSchema)` to create a new message.
+ */
+export declare const DeleteConnectionResponseSchema: GenMessage<DeleteConnectionResponse, {
+    jsonType: DeleteConnectionResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.RotateConnectionSecretRequest
+ */
+export type RotateConnectionSecretRequest = Message<"toshi.workspace.v1.RotateConnectionSecretRequest"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * How long the previous secret still verifies; unset is 24 hours, zero
+     * stops it at once, and 7 days is the most.
+     *
+     * @generated from field: google.protobuf.Duration overlap = 2;
+     */
+    overlap?: Duration | undefined;
+    /**
+     * @generated from field: string request_key = 3;
+     */
+    requestKey: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.RotateConnectionSecretRequest
+ */
+export type RotateConnectionSecretRequestJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+    /**
+     * How long the previous secret still verifies; unset is 24 hours, zero
+     * stops it at once, and 7 days is the most.
+     *
+     * @generated from field: google.protobuf.Duration overlap = 2;
+     */
+    overlap?: DurationJson;
+    /**
+     * @generated from field: string request_key = 3;
+     */
+    requestKey?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.RotateConnectionSecretRequest.
+ * Use `create(RotateConnectionSecretRequestSchema)` to create a new message.
+ */
+export declare const RotateConnectionSecretRequestSchema: GenMessage<RotateConnectionSecretRequest, {
+    jsonType: RotateConnectionSecretRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.RotateConnectionSecretResponse
+ */
+export type RotateConnectionSecretResponse = Message<"toshi.workspace.v1.RotateConnectionSecretResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.Connection connection = 1;
+     */
+    connection?: Connection | undefined;
+    /**
+     * The new signing secret in its whsec_ form. Shown only in this answer
+     * and an identical retry's.
+     *
+     * @generated from field: string secret = 2;
+     */
+    secret: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.RotateConnectionSecretResponse
+ */
+export type RotateConnectionSecretResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.Connection connection = 1;
+     */
+    connection?: ConnectionJson;
+    /**
+     * The new signing secret in its whsec_ form. Shown only in this answer
+     * and an identical retry's.
+     *
+     * @generated from field: string secret = 2;
+     */
+    secret?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.RotateConnectionSecretResponse.
+ * Use `create(RotateConnectionSecretResponseSchema)` to create a new message.
+ */
+export declare const RotateConnectionSecretResponseSchema: GenMessage<RotateConnectionSecretResponse, {
+    jsonType: RotateConnectionSecretResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.UpdateConnectionRequest
+ */
+export type UpdateConnectionRequest = Message<"toshi.workspace.v1.UpdateConnectionRequest"> & {
+    /**
+     * id names the connection; the fields update_mask names carry the new
+     * values.
+     *
+     * @generated from field: toshi.workspace.v1.Connection connection = 1;
+     */
+    connection?: Connection | undefined;
+    /**
+     * The paths managed_by, manifest_digest, manifest_origin and managed_fields
+     * set the management mark and go together: all four or none, and on their
+     * own; managed_by "manifest" needs the digest, an origin and at least one
+     * field path, and an empty managed_by clears all four.
+     *
+     * @generated from field: google.protobuf.FieldMask update_mask = 2;
+     */
+    updateMask?: FieldMask | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.UpdateConnectionRequest
+ */
+export type UpdateConnectionRequestJson = {
+    /**
+     * id names the connection; the fields update_mask names carry the new
+     * values.
+     *
+     * @generated from field: toshi.workspace.v1.Connection connection = 1;
+     */
+    connection?: ConnectionJson;
+    /**
+     * The paths managed_by, manifest_digest, manifest_origin and managed_fields
+     * set the management mark and go together: all four or none, and on their
+     * own; managed_by "manifest" needs the digest, an origin and at least one
+     * field path, and an empty managed_by clears all four.
+     *
+     * @generated from field: google.protobuf.FieldMask update_mask = 2;
+     */
+    updateMask?: FieldMaskJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.UpdateConnectionRequest.
+ * Use `create(UpdateConnectionRequestSchema)` to create a new message.
+ */
+export declare const UpdateConnectionRequestSchema: GenMessage<UpdateConnectionRequest, {
+    jsonType: UpdateConnectionRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.UpdateConnectionResponse
+ */
+export type UpdateConnectionResponse = Message<"toshi.workspace.v1.UpdateConnectionResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.Connection connection = 1;
+     */
+    connection?: Connection | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.UpdateConnectionResponse
+ */
+export type UpdateConnectionResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.Connection connection = 1;
+     */
+    connection?: ConnectionJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.UpdateConnectionResponse.
+ * Use `create(UpdateConnectionResponseSchema)` to create a new message.
+ */
+export declare const UpdateConnectionResponseSchema: GenMessage<UpdateConnectionResponse, {
+    jsonType: UpdateConnectionResponseJson;
+}>;
+/**
+ * ConnectionDelivery is one message a WEBHOOK connection's sender sent:
+ * the tries that carried one webhook id.
+ *
+ * @generated from message toshi.workspace.v1.ConnectionDelivery
+ */
+export type ConnectionDelivery = Message<"toshi.workspace.v1.ConnectionDelivery"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * @generated from field: string connection_id = 2;
+     */
+    connectionId: string;
+    /**
+     * The sender's webhook-id header.
+     *
+     * @generated from field: string webhook_id = 3;
+     */
+    webhookId: string;
+    /**
+     * @generated from field: toshi.workspace.v1.ConnectionDeliveryState state = 4;
+     */
+    state: ConnectionDeliveryState;
+    /**
+     * Why it was dropped or failed, such as delivery_failed or store_error;
+     * empty otherwise.
+     *
+     * @generated from field: string reason = 5;
+     */
+    reason: string;
+    /**
+     * The time the sender signed; when the ingress stored it.
+     *
+     * @generated from field: google.protobuf.Timestamp sent_at = 6;
+     */
+    sentAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp received_at = 7;
+     */
+    receivedAt?: Timestamp | undefined;
+    /**
+     * When it was processed, dropped or failed; unset while received.
+     *
+     * @generated from field: google.protobuf.Timestamp processed_at = 8;
+     */
+    processedAt?: Timestamp | undefined;
+    /**
+     * Tries a worker made since it was last received or replayed.
+     *
+     * @generated from field: int32 attempts = 9;
+     */
+    attempts: number;
+    /**
+     * The request's Content-Type header.
+     *
+     * @generated from field: string content_type = 10;
+     */
+    contentType: string;
+    /**
+     * The hex SHA-256 of the body.
+     *
+     * @generated from field: string body_digest = 11;
+     */
+    bodyDigest: string;
+    /**
+     * When the workspace's retention removed the body; unset while it is
+     * kept. A delivery without its body is not replayed.
+     *
+     * @generated from field: google.protobuf.Timestamp body_expired_at = 12;
+     */
+    bodyExpiredAt?: Timestamp | undefined;
+    /**
+     * How many times it was replayed.
+     *
+     * @generated from field: int32 replays = 14;
+     */
+    replays: number;
+    /**
+     * Who asked for the latest replay; empty before one.
+     *
+     * @generated from field: string replayed_by = 15;
+     */
+    replayedBy: string;
+    /**
+     * The name of the event the delivery carries, such as
+     * github.pull_request.opened for a GitHub connection's; empty when the
+     * sender named none, as for a webhook connection's.
+     *
+     * @generated from field: string event_name = 16;
+     */
+    eventName: string;
+};
+/**
+ * ConnectionDelivery is one message a WEBHOOK connection's sender sent:
+ * the tries that carried one webhook id.
+ *
+ * @generated from message toshi.workspace.v1.ConnectionDelivery
+ */
+export type ConnectionDeliveryJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+    /**
+     * @generated from field: string connection_id = 2;
+     */
+    connectionId?: string;
+    /**
+     * The sender's webhook-id header.
+     *
+     * @generated from field: string webhook_id = 3;
+     */
+    webhookId?: string;
+    /**
+     * @generated from field: toshi.workspace.v1.ConnectionDeliveryState state = 4;
+     */
+    state?: ConnectionDeliveryStateJson;
+    /**
+     * Why it was dropped or failed, such as delivery_failed or store_error;
+     * empty otherwise.
+     *
+     * @generated from field: string reason = 5;
+     */
+    reason?: string;
+    /**
+     * The time the sender signed; when the ingress stored it.
+     *
+     * @generated from field: google.protobuf.Timestamp sent_at = 6;
+     */
+    sentAt?: TimestampJson;
+    /**
+     * @generated from field: google.protobuf.Timestamp received_at = 7;
+     */
+    receivedAt?: TimestampJson;
+    /**
+     * When it was processed, dropped or failed; unset while received.
+     *
+     * @generated from field: google.protobuf.Timestamp processed_at = 8;
+     */
+    processedAt?: TimestampJson;
+    /**
+     * Tries a worker made since it was last received or replayed.
+     *
+     * @generated from field: int32 attempts = 9;
+     */
+    attempts?: number;
+    /**
+     * The request's Content-Type header.
+     *
+     * @generated from field: string content_type = 10;
+     */
+    contentType?: string;
+    /**
+     * The hex SHA-256 of the body.
+     *
+     * @generated from field: string body_digest = 11;
+     */
+    bodyDigest?: string;
+    /**
+     * When the workspace's retention removed the body; unset while it is
+     * kept. A delivery without its body is not replayed.
+     *
+     * @generated from field: google.protobuf.Timestamp body_expired_at = 12;
+     */
+    bodyExpiredAt?: TimestampJson;
+    /**
+     * How many times it was replayed.
+     *
+     * @generated from field: int32 replays = 14;
+     */
+    replays?: number;
+    /**
+     * Who asked for the latest replay; empty before one.
+     *
+     * @generated from field: string replayed_by = 15;
+     */
+    replayedBy?: string;
+    /**
+     * The name of the event the delivery carries, such as
+     * github.pull_request.opened for a GitHub connection's; empty when the
+     * sender named none, as for a webhook connection's.
+     *
+     * @generated from field: string event_name = 16;
+     */
+    eventName?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.ConnectionDelivery.
+ * Use `create(ConnectionDeliverySchema)` to create a new message.
+ */
+export declare const ConnectionDeliverySchema: GenMessage<ConnectionDelivery, {
+    jsonType: ConnectionDeliveryJson;
+}>;
+/**
+ * ConnectionDeliveryRun is one time a worker ran a delivery to its end.
+ *
+ * @generated from message toshi.workspace.v1.ConnectionDeliveryRun
+ */
+export type ConnectionDeliveryRun = Message<"toshi.workspace.v1.ConnectionDeliveryRun"> & {
+    /**
+     * 1 for the first run, counting up.
+     *
+     * @generated from field: int32 run = 1;
+     */
+    run: number;
+    /**
+     * event, delivered, delivery_failed, connection_deleted, body_not_json,
+     * invalid_event, unnamed or failed.
+     *
+     * @generated from field: string outcome = 4;
+     */
+    outcome: string;
+    /**
+     * The event the run wrote or found; empty when it wrote none.
+     *
+     * @generated from field: string event_id = 5;
+     */
+    eventId: string;
+    /**
+     * What failed, for a target that took the delivery on no try or a store
+     * that failed.
+     *
+     * @generated from field: string error = 7;
+     */
+    error: string;
+    /**
+     * @generated from field: google.protobuf.Duration duration = 8;
+     */
+    duration?: Duration | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp finished_at = 9;
+     */
+    finishedAt?: Timestamp | undefined;
+    /**
+     * Who asked for the replay the run ran; empty for the sender's message.
+     *
+     * @generated from field: string actor = 10;
+     */
+    actor: string;
+    /**
+     * The outbound delivery that posted it to the connection's target, for
+     * delivered and delivery_failed.
+     *
+     * @generated from field: string target_delivery_id = 11;
+     */
+    targetDeliveryId: string;
+};
+/**
+ * ConnectionDeliveryRun is one time a worker ran a delivery to its end.
+ *
+ * @generated from message toshi.workspace.v1.ConnectionDeliveryRun
+ */
+export type ConnectionDeliveryRunJson = {
+    /**
+     * 1 for the first run, counting up.
+     *
+     * @generated from field: int32 run = 1;
+     */
+    run?: number;
+    /**
+     * event, delivered, delivery_failed, connection_deleted, body_not_json,
+     * invalid_event, unnamed or failed.
+     *
+     * @generated from field: string outcome = 4;
+     */
+    outcome?: string;
+    /**
+     * The event the run wrote or found; empty when it wrote none.
+     *
+     * @generated from field: string event_id = 5;
+     */
+    eventId?: string;
+    /**
+     * What failed, for a target that took the delivery on no try or a store
+     * that failed.
+     *
+     * @generated from field: string error = 7;
+     */
+    error?: string;
+    /**
+     * @generated from field: google.protobuf.Duration duration = 8;
+     */
+    duration?: DurationJson;
+    /**
+     * @generated from field: google.protobuf.Timestamp finished_at = 9;
+     */
+    finishedAt?: TimestampJson;
+    /**
+     * Who asked for the replay the run ran; empty for the sender's message.
+     *
+     * @generated from field: string actor = 10;
+     */
+    actor?: string;
+    /**
+     * The outbound delivery that posted it to the connection's target, for
+     * delivered and delivery_failed.
+     *
+     * @generated from field: string target_delivery_id = 11;
+     */
+    targetDeliveryId?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.ConnectionDeliveryRun.
+ * Use `create(ConnectionDeliveryRunSchema)` to create a new message.
+ */
+export declare const ConnectionDeliveryRunSchema: GenMessage<ConnectionDeliveryRun, {
+    jsonType: ConnectionDeliveryRunJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.ListConnectionDeliveriesRequest
+ */
+export type ListConnectionDeliveriesRequest = Message<"toshi.workspace.v1.ListConnectionDeliveriesRequest"> & {
+    /**
+     * @generated from field: string connection_id = 1;
+     */
+    connectionId: string;
+    /**
+     * Only the deliveries in this state; unspecified lists every state.
+     *
+     * @generated from field: toshi.workspace.v1.ConnectionDeliveryState state = 2;
+     */
+    state: ConnectionDeliveryState;
+    /**
+     * The most deliveries 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.ListConnectionDeliveriesRequest
+ */
+export type ListConnectionDeliveriesRequestJson = {
+    /**
+     * @generated from field: string connection_id = 1;
+     */
+    connectionId?: string;
+    /**
+     * Only the deliveries in this state; unspecified lists every state.
+     *
+     * @generated from field: toshi.workspace.v1.ConnectionDeliveryState state = 2;
+     */
+    state?: ConnectionDeliveryStateJson;
+    /**
+     * The most deliveries 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.ListConnectionDeliveriesRequest.
+ * Use `create(ListConnectionDeliveriesRequestSchema)` to create a new message.
+ */
+export declare const ListConnectionDeliveriesRequestSchema: GenMessage<ListConnectionDeliveriesRequest, {
+    jsonType: ListConnectionDeliveriesRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.ListConnectionDeliveriesResponse
+ */
+export type ListConnectionDeliveriesResponse = Message<"toshi.workspace.v1.ListConnectionDeliveriesResponse"> & {
+    /**
+     * @generated from field: repeated toshi.workspace.v1.ConnectionDelivery deliveries = 1;
+     */
+    deliveries: ConnectionDelivery[];
+    /**
+     * Empty on the last page.
+     *
+     * @generated from field: string next_page_token = 2;
+     */
+    nextPageToken: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.ListConnectionDeliveriesResponse
+ */
+export type ListConnectionDeliveriesResponseJson = {
+    /**
+     * @generated from field: repeated toshi.workspace.v1.ConnectionDelivery deliveries = 1;
+     */
+    deliveries?: ConnectionDeliveryJson[];
+    /**
+     * Empty on the last page.
+     *
+     * @generated from field: string next_page_token = 2;
+     */
+    nextPageToken?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.ListConnectionDeliveriesResponse.
+ * Use `create(ListConnectionDeliveriesResponseSchema)` to create a new message.
+ */
+export declare const ListConnectionDeliveriesResponseSchema: GenMessage<ListConnectionDeliveriesResponse, {
+    jsonType: ListConnectionDeliveriesResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetConnectionDeliveryRequest
+ */
+export type GetConnectionDeliveryRequest = Message<"toshi.workspace.v1.GetConnectionDeliveryRequest"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.GetConnectionDeliveryRequest
+ */
+export type GetConnectionDeliveryRequestJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.GetConnectionDeliveryRequest.
+ * Use `create(GetConnectionDeliveryRequestSchema)` to create a new message.
+ */
+export declare const GetConnectionDeliveryRequestSchema: GenMessage<GetConnectionDeliveryRequest, {
+    jsonType: GetConnectionDeliveryRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetConnectionDeliveryResponse
+ */
+export type GetConnectionDeliveryResponse = Message<"toshi.workspace.v1.GetConnectionDeliveryResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.ConnectionDelivery delivery = 1;
+     */
+    delivery?: ConnectionDelivery | undefined;
+    /**
+     * @generated from field: repeated toshi.workspace.v1.ConnectionDeliveryRun runs = 2;
+     */
+    runs: ConnectionDeliveryRun[];
+};
+/**
+ * @generated from message toshi.workspace.v1.GetConnectionDeliveryResponse
+ */
+export type GetConnectionDeliveryResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.ConnectionDelivery delivery = 1;
+     */
+    delivery?: ConnectionDeliveryJson;
+    /**
+     * @generated from field: repeated toshi.workspace.v1.ConnectionDeliveryRun runs = 2;
+     */
+    runs?: ConnectionDeliveryRunJson[];
+};
+/**
+ * Describes the message toshi.workspace.v1.GetConnectionDeliveryResponse.
+ * Use `create(GetConnectionDeliveryResponseSchema)` to create a new message.
+ */
+export declare const GetConnectionDeliveryResponseSchema: GenMessage<GetConnectionDeliveryResponse, {
+    jsonType: GetConnectionDeliveryResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.ReplayConnectionDeliveryRequest
+ */
+export type ReplayConnectionDeliveryRequest = Message<"toshi.workspace.v1.ReplayConnectionDeliveryRequest"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * @generated from field: string request_key = 2;
+     */
+    requestKey: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.ReplayConnectionDeliveryRequest
+ */
+export type ReplayConnectionDeliveryRequestJson = {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+    /**
+     * @generated from field: string request_key = 2;
+     */
+    requestKey?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.ReplayConnectionDeliveryRequest.
+ * Use `create(ReplayConnectionDeliveryRequestSchema)` to create a new message.
+ */
+export declare const ReplayConnectionDeliveryRequestSchema: GenMessage<ReplayConnectionDeliveryRequest, {
+    jsonType: ReplayConnectionDeliveryRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.ReplayConnectionDeliveryResponse
+ */
+export type ReplayConnectionDeliveryResponse = Message<"toshi.workspace.v1.ReplayConnectionDeliveryResponse"> & {
+    /**
+     * The delivery as the replay left it: received, its replays counted.
+     *
+     * @generated from field: toshi.workspace.v1.ConnectionDelivery delivery = 1;
+     */
+    delivery?: ConnectionDelivery | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.ReplayConnectionDeliveryResponse
+ */
+export type ReplayConnectionDeliveryResponseJson = {
+    /**
+     * The delivery as the replay left it: received, its replays counted.
+     *
+     * @generated from field: toshi.workspace.v1.ConnectionDelivery delivery = 1;
+     */
+    delivery?: ConnectionDeliveryJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.ReplayConnectionDeliveryResponse.
+ * Use `create(ReplayConnectionDeliveryResponseSchema)` to create a new message.
+ */
+export declare const ReplayConnectionDeliveryResponseSchema: GenMessage<ReplayConnectionDeliveryResponse, {
+    jsonType: ReplayConnectionDeliveryResponseJson;
+}>;
+/**
+ * ConnectionKind is the kind of source a connection receives events from.
+ *
+ * @generated from enum toshi.workspace.v1.ConnectionKind
+ */
+export declare enum ConnectionKind {
+    /**
+     * @generated from enum value: CONNECTION_KIND_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * A GitHub App installation.
+     *
+     * @generated from enum value: CONNECTION_KIND_GITHUB = 1;
+     */
+    GITHUB = 1,
+    /**
+     * A sender that signs its requests as Standard Webhooks does.
+     *
+     * @generated from enum value: CONNECTION_KIND_WEBHOOK = 2;
+     */
+    WEBHOOK = 2,
+    /**
+     * An inbound mail address. The deployment's mail provider receives the
+     * messages; each is stored as a receipt before it goes to a service's
+     * event channel.
+     *
+     * @generated from enum value: CONNECTION_KIND_MAIL = 3;
+     */
+    MAIL = 3
+}
+/**
+ * ConnectionKind is the kind of source a connection receives events from.
+ *
+ * @generated from enum toshi.workspace.v1.ConnectionKind
+ */
+export type ConnectionKindJson = "CONNECTION_KIND_UNSPECIFIED" | "CONNECTION_KIND_GITHUB" | "CONNECTION_KIND_WEBHOOK" | "CONNECTION_KIND_MAIL";
+/**
+ * Describes the enum toshi.workspace.v1.ConnectionKind.
+ */
+export declare const ConnectionKindSchema: GenEnum<ConnectionKind, ConnectionKindJson>;
+/**
+ * ConnectionDeliveryState is where a WEBHOOK connection's delivery stands.
+ *
+ * @generated from enum toshi.workspace.v1.ConnectionDeliveryState
+ */
+export declare enum ConnectionDeliveryState {
+    /**
+     * @generated from enum value: CONNECTION_DELIVERY_STATE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Stored and waiting for a worker, or being run.
+     *
+     * @generated from enum value: CONNECTION_DELIVERY_STATE_RECEIVED = 1;
+     */
+    RECEIVED = 1,
+    /**
+     * It became an event, or its connection's target took it.
+     *
+     * @generated from enum value: CONNECTION_DELIVERY_STATE_PROCESSED = 2;
+     */
+    PROCESSED = 2,
+    /**
+     * It became no event, for the reason the delivery names.
+     *
+     * @generated from enum value: CONNECTION_DELIVERY_STATE_DROPPED = 3;
+     */
+    DROPPED = 3,
+    /**
+     * The store failed on every try to write its event, or its connection's
+     * target took it on no try.
+     *
+     * @generated from enum value: CONNECTION_DELIVERY_STATE_FAILED = 4;
+     */
+    FAILED = 4
+}
+/**
+ * ConnectionDeliveryState is where a WEBHOOK connection's delivery stands.
+ *
+ * @generated from enum toshi.workspace.v1.ConnectionDeliveryState
+ */
+export type ConnectionDeliveryStateJson = "CONNECTION_DELIVERY_STATE_UNSPECIFIED" | "CONNECTION_DELIVERY_STATE_RECEIVED" | "CONNECTION_DELIVERY_STATE_PROCESSED" | "CONNECTION_DELIVERY_STATE_DROPPED" | "CONNECTION_DELIVERY_STATE_FAILED";
+/**
+ * Describes the enum toshi.workspace.v1.ConnectionDeliveryState.
+ */
+export declare const ConnectionDeliveryStateSchema: GenEnum<ConnectionDeliveryState, ConnectionDeliveryStateJson>;
+/**
+ * ConnectionService keeps a workspace's connections: the sources of the
+ * events it owns. A GitHub App installation is a connection of the kind
+ * GITHUB, which installing the App creates and removing it deletes; the
+ * calls here list it and cannot create or delete it. A WEBHOOK connection
+ * receives events from a sender that signs its requests as Standard
+ * Webhooks does, with a secret the connection keeps. A MAIL connection
+ * receives mail at an address the deployment's inbound mail provider
+ * serves; each message is stored as a receipt before it goes to a
+ * service's event channel.
+ *
+ * The caller's credential names the workspace, as for WorkloadService.
+ * CreateConnection and RotateConnectionSecret require a request_key, which
+ * works as WorkloadService's do: a retry with the same key and the same
+ * request returns what the first call returned and changes nothing. A
+ * signing secret is shown once, in the answer that made it and an identical
+ * retry's; no read returns it. A retry after the connection is deleted, or
+ * after its secret was rotated again, fails with FAILED_PRECONDITION.
+ *
+ * @generated from service toshi.workspace.v1.ConnectionService
+ */
+export declare const ConnectionService: GenService<{
+    /**
+     * ListConnections returns the workspace's connections, ordered by id.
+     *
+     * A page holds 100 connections when page_size is zero, and 1000 at most.
+     *
+     * @generated from rpc toshi.workspace.v1.ConnectionService.ListConnections
+     */
+    listConnections: {
+        methodKind: "unary";
+        input: typeof ListConnectionsRequestSchema;
+        output: typeof ListConnectionsResponseSchema;
+    };
+    /**
+     * GetConnection returns one connection. One the workspace does not have,
+     * or one deleted, is NOT_FOUND.
+     *
+     * @generated from rpc toshi.workspace.v1.ConnectionService.GetConnection
+     */
+    getConnection: {
+        methodKind: "unary";
+        input: typeof GetConnectionRequestSchema;
+        output: typeof GetConnectionResponseSchema;
+    };
+    /**
+     * CreateConnection creates a WEBHOOK or MAIL connection. A WEBHOOK
+     * connection's events belong to a project's environment, and the call
+     * returns it with its signing secret. A MAIL connection receives mail at
+     * an address the deployment's inbound mail provider serves and sends each
+     * message to a service's event channel; it has no secret. A kind other
+     * than WEBHOOK or MAIL fails with INVALID_ARGUMENT, as does a missing
+     * required field, a name a live connection of the workspace has with
+     * ALREADY_EXISTS, and an environment the project does not have with
+     * NOT_FOUND.
+     *
+     * @generated from rpc toshi.workspace.v1.ConnectionService.CreateConnection
+     */
+    createConnection: {
+        methodKind: "unary";
+        input: typeof CreateConnectionRequestSchema;
+        output: typeof CreateConnectionResponseSchema;
+    };
+    /**
+     * DeleteConnection deletes a WEBHOOK or MAIL connection: its events are no
+     * longer received, and a mail connection's address takes no more mail. A
+     * GITHUB connection fails with FAILED_PRECONDITION, as only removing the
+     * GitHub App deletes it, as does one that live triggers match events from,
+     * naming them as project/name, and one the workspace does not have with
+     * NOT_FOUND.
+     *
+     * @generated from rpc toshi.workspace.v1.ConnectionService.DeleteConnection
+     */
+    deleteConnection: {
+        methodKind: "unary";
+        input: typeof DeleteConnectionRequestSchema;
+        output: typeof DeleteConnectionResponseSchema;
+    };
+    /**
+     * RotateConnectionSecret gives a WEBHOOK connection a new signing secret
+     * and returns it. For the overlap after the rotation, the previous secret
+     * still verifies, so the sender can switch over; with an overlap of zero
+     * it stops verifying at once. While a previous secret still verifies, a
+     * rotation with an overlap fails with FAILED_PRECONDITION; one with an
+     * overlap of zero always runs. An overlap above 7 days or below zero fails
+     * with INVALID_ARGUMENT, a GITHUB connection with FAILED_PRECONDITION,
+     * and one the workspace does not have with NOT_FOUND.
+     *
+     * @generated from rpc toshi.workspace.v1.ConnectionService.RotateConnectionSecret
+     */
+    rotateConnectionSecret: {
+        methodKind: "unary";
+        input: typeof RotateConnectionSecretRequestSchema;
+        output: typeof RotateConnectionSecretResponseSchema;
+    };
+    /**
+     * UpdateConnection sets the fields of connection.id's connection that
+     * update_mask names. The one field it sets is target, the URL a WEBHOOK
+     * connection's deliveries are posted to in place of the event log: its
+     * url and secret, both required, or an empty url to clear it. An unset
+     * update_mask names the fields connection carries. An empty one, an
+     * unset one with no target, "*" and a path of another field are
+     * INVALID_ARGUMENT. The
+     * secret is sealed under the workspace's data key and never returned; a
+     * deployment with no keyring refuses it with FAILED_PRECONDITION. A
+     * GITHUB connection is FAILED_PRECONDITION, and one the workspace does
+     * not have NOT_FOUND.
+     *
+     * @generated from rpc toshi.workspace.v1.ConnectionService.UpdateConnection
+     */
+    updateConnection: {
+        methodKind: "unary";
+        input: typeof UpdateConnectionRequestSchema;
+        output: typeof UpdateConnectionResponseSchema;
+    };
+    /**
+     * ListConnectionDeliveries returns a WEBHOOK connection's deliveries: the
+     * messages its sender sent, one for each webhook id, newest received
+     * first. A delivery never carries its body. A connection the workspace
+     * does not have is NOT_FOUND; a deleted one's deliveries are still
+     * listed, and a deleted one with none is NOT_FOUND.
+     *
+     * A page holds 100 deliveries when page_size is zero, and 1000 at most.
+     *
+     * @generated from rpc toshi.workspace.v1.ConnectionService.ListConnectionDeliveries
+     */
+    listConnectionDeliveries: {
+        methodKind: "unary";
+        input: typeof ListConnectionDeliveriesRequestSchema;
+        output: typeof ListConnectionDeliveriesResponseSchema;
+    };
+    /**
+     * GetConnectionDelivery returns one delivery, without its body, and its
+     * runs: each time a worker made it an event, posted it to its
+     * connection's target, dropped it or failed it, oldest first. A delivery the workspace does not have is NOT_FOUND.
+     *
+     * @generated from rpc toshi.workspace.v1.ConnectionService.GetConnectionDelivery
+     */
+    getConnectionDelivery: {
+        methodKind: "unary";
+        input: typeof GetConnectionDeliveryRequestSchema;
+        output: typeof GetConnectionDeliveryResponseSchema;
+    };
+    /**
+     * ReplayConnectionDelivery sends a processed, dropped or failed delivery
+     * through its connection again, as a new message under the same webhook
+     * id: it goes to the connection's target then, or to the event log when
+     * it has none, and its run records the caller. A delivery still received, whose receipt or body
+     * expired, or whose connection is deleted is FAILED_PRECONDITION, as is
+     * one another replay counted since this call read it. A delivery the
+     * workspace does not have is NOT_FOUND.
+     *
+     * request_key is required: a retry with the same key and the same
+     * request returns what the first call returned and replays nothing.
+     *
+     * @generated from rpc toshi.workspace.v1.ConnectionService.ReplayConnectionDelivery
+     */
+    replayConnectionDelivery: {
+        methodKind: "unary";
+        input: typeof ReplayConnectionDeliveryRequestSchema;
+        output: typeof ReplayConnectionDeliveryResponseSchema;
+    };
+}>;