@toshicloud/sdk 0.5.0 → 0.5.1

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

@@ -0,0 +1,1099 @@
+import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { Duration, DurationJson, FieldMask, FieldMaskJson, Timestamp, TimestampJson } from "@bufbuild/protobuf/wkt";
+import type { Binding, BindingJson, Command, CommandJson } from "./workspace_pb.js";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file toshi/workspace/v1/triggers.proto.
+ */
+export declare const file_toshi_workspace_v1_triggers: GenFile;
+/**
+ * Trigger binds the events of one connection to an action.
+ *
+ * @generated from message toshi.workspace.v1.Trigger
+ */
+export type Trigger = Message<"toshi.workspace.v1.Trigger"> & {
+    /**
+     * Set by the server; ignored in a request. The workloads it makes carry it
+     * as the label toshi.trigger.
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * Set by the server from the request; ignored in the trigger a request
+     * carries.
+     *
+     * @generated from field: string project = 2;
+     */
+    project: string;
+    /**
+     * As project.
+     *
+     * @generated from field: string environment = 3;
+     */
+    environment: string;
+    /**
+     * A lower-case DNS label, unique among the project's triggers that are not
+     * deleted.
+     *
+     * @generated from field: string name = 4;
+     */
+    name: string;
+    /**
+     * The id of the connection whose events it matches.
+     *
+     * @generated from field: string source = 5;
+     */
+    source: string;
+    /**
+     * The event names it matches, exactly; at least one.
+     *
+     * @generated from field: repeated string events = 6;
+     */
+    events: string[];
+    /**
+     * Further limits on a pull request event; unset matches every one.
+     *
+     * @generated from field: toshi.workspace.v1.TriggerFilter filter = 7;
+     */
+    filter?: TriggerFilter | undefined;
+    /**
+     * @generated from field: toshi.workspace.v1.TriggerAction action = 8;
+     */
+    action: TriggerAction;
+    /**
+     * What CREATE makes, or the service DELIVER delivers to; unset for
+     * DELETE.
+     *
+     * @generated from field: toshi.workspace.v1.TriggerTarget target = 9;
+     */
+    target?: TriggerTarget | undefined;
+    /**
+     * A template over the event's data that names the workload an event is
+     * about: `{path}` is the value at that dot-separated path of the data, a
+     * string or an integer, and every other character is itself. The
+     * workloads it makes carry the result as the label toshi.trigger.key.
+     * Unset for pull request events, it is `{repository.full_name}#{number}`;
+     * unset for any other event, a create fails with INVALID_ARGUMENT.
+     * DELIVER takes none.
+     *
+     * @generated from field: string key = 10;
+     */
+    key: string;
+    /**
+     * How long a workload it made may go without a request before it is
+     * removed; unset is 2 hours. DELIVER takes none.
+     *
+     * @generated from field: google.protobuf.Duration idle_timeout = 11;
+     */
+    idleTimeout?: Duration | undefined;
+    /**
+     * What it does with a pull request whose head repository is not its base
+     * repository. DELIVER takes none.
+     *
+     * @generated from field: toshi.workspace.v1.TriggerForks forks = 12;
+     */
+    forks: TriggerForks;
+    /**
+     * Set by the server; ignored in a request.
+     *
+     * @generated from field: google.protobuf.Timestamp created_at = 13;
+     */
+    createdAt?: Timestamp | undefined;
+    /**
+     * Set by the server; ignored in a request.
+     *
+     * @generated from field: google.protobuf.Timestamp updated_at = 14;
+     */
+    updatedAt?: Timestamp | undefined;
+};
+/**
+ * Trigger binds the events of one connection to an action.
+ *
+ * @generated from message toshi.workspace.v1.Trigger
+ */
+export type TriggerJson = {
+    /**
+     * Set by the server; ignored in a request. The workloads it makes carry it
+     * as the label toshi.trigger.
+     *
+     * @generated from field: string id = 1;
+     */
+    id?: string;
+    /**
+     * Set by the server from the request; ignored in the trigger a request
+     * carries.
+     *
+     * @generated from field: string project = 2;
+     */
+    project?: string;
+    /**
+     * As project.
+     *
+     * @generated from field: string environment = 3;
+     */
+    environment?: string;
+    /**
+     * A lower-case DNS label, unique among the project's triggers that are not
+     * deleted.
+     *
+     * @generated from field: string name = 4;
+     */
+    name?: string;
+    /**
+     * The id of the connection whose events it matches.
+     *
+     * @generated from field: string source = 5;
+     */
+    source?: string;
+    /**
+     * The event names it matches, exactly; at least one.
+     *
+     * @generated from field: repeated string events = 6;
+     */
+    events?: string[];
+    /**
+     * Further limits on a pull request event; unset matches every one.
+     *
+     * @generated from field: toshi.workspace.v1.TriggerFilter filter = 7;
+     */
+    filter?: TriggerFilterJson;
+    /**
+     * @generated from field: toshi.workspace.v1.TriggerAction action = 8;
+     */
+    action?: TriggerActionJson;
+    /**
+     * What CREATE makes, or the service DELIVER delivers to; unset for
+     * DELETE.
+     *
+     * @generated from field: toshi.workspace.v1.TriggerTarget target = 9;
+     */
+    target?: TriggerTargetJson;
+    /**
+     * A template over the event's data that names the workload an event is
+     * about: `{path}` is the value at that dot-separated path of the data, a
+     * string or an integer, and every other character is itself. The
+     * workloads it makes carry the result as the label toshi.trigger.key.
+     * Unset for pull request events, it is `{repository.full_name}#{number}`;
+     * unset for any other event, a create fails with INVALID_ARGUMENT.
+     * DELIVER takes none.
+     *
+     * @generated from field: string key = 10;
+     */
+    key?: string;
+    /**
+     * How long a workload it made may go without a request before it is
+     * removed; unset is 2 hours. DELIVER takes none.
+     *
+     * @generated from field: google.protobuf.Duration idle_timeout = 11;
+     */
+    idleTimeout?: DurationJson;
+    /**
+     * What it does with a pull request whose head repository is not its base
+     * repository. DELIVER takes none.
+     *
+     * @generated from field: toshi.workspace.v1.TriggerForks forks = 12;
+     */
+    forks?: TriggerForksJson;
+    /**
+     * Set by the server; ignored in a request.
+     *
+     * @generated from field: google.protobuf.Timestamp created_at = 13;
+     */
+    createdAt?: TimestampJson;
+    /**
+     * Set by the server; ignored in a request.
+     *
+     * @generated from field: google.protobuf.Timestamp updated_at = 14;
+     */
+    updatedAt?: TimestampJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.Trigger.
+ * Use `create(TriggerSchema)` to create a new message.
+ */
+export declare const TriggerSchema: GenMessage<Trigger, {
+    jsonType: TriggerJson;
+}>;
+/**
+ * TriggerFilter limits the pull request events a trigger matches. Each
+ * list, when set, must hold the event's value; an empty list holds every
+ * value. An event that is not a pull request's is not filtered: it
+ * matches whatever the filter holds.
+ *
+ * @generated from message toshi.workspace.v1.TriggerFilter
+ */
+export type TriggerFilter = Message<"toshi.workspace.v1.TriggerFilter"> & {
+    /**
+     * Base repositories, as owner/name.
+     *
+     * @generated from field: repeated string repositories = 1;
+     */
+    repositories: string[];
+    /**
+     * Base branches, by name.
+     *
+     * @generated from field: repeated string base_branches = 2;
+     */
+    baseBranches: string[];
+};
+/**
+ * TriggerFilter limits the pull request events a trigger matches. Each
+ * list, when set, must hold the event's value; an empty list holds every
+ * value. An event that is not a pull request's is not filtered: it
+ * matches whatever the filter holds.
+ *
+ * @generated from message toshi.workspace.v1.TriggerFilter
+ */
+export type TriggerFilterJson = {
+    /**
+     * Base repositories, as owner/name.
+     *
+     * @generated from field: repeated string repositories = 1;
+     */
+    repositories?: string[];
+    /**
+     * Base branches, by name.
+     *
+     * @generated from field: repeated string base_branches = 2;
+     */
+    baseBranches?: string[];
+};
+/**
+ * Describes the message toshi.workspace.v1.TriggerFilter.
+ * Use `create(TriggerFilterSchema)` to create a new message.
+ */
+export declare const TriggerFilterSchema: GenMessage<TriggerFilter, {
+    jsonType: TriggerFilterJson;
+}>;
+/**
+ * TriggerTarget is the workload a trigger's CREATE makes, or the service
+ * its DELIVER delivers to.
+ *
+ * @generated from message toshi.workspace.v1.TriggerTarget
+ */
+export type TriggerTarget = Message<"toshi.workspace.v1.TriggerTarget"> & {
+    /**
+     * @generated from oneof toshi.workspace.v1.TriggerTarget.target
+     */
+    target: {
+        /**
+         * @generated from field: toshi.workspace.v1.TriggerSandbox sandbox = 1;
+         */
+        value: TriggerSandbox;
+        case: "sandbox";
+    } | {
+        /**
+         * @generated from field: toshi.workspace.v1.TriggerPreview preview = 2;
+         */
+        value: TriggerPreview;
+        case: "preview";
+    } | {
+        /**
+         * @generated from field: toshi.workspace.v1.TriggerServiceChannel service = 3;
+         */
+        value: TriggerServiceChannel;
+        case: "service";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * TriggerTarget is the workload a trigger's CREATE makes, or the service
+ * its DELIVER delivers to.
+ *
+ * @generated from message toshi.workspace.v1.TriggerTarget
+ */
+export type TriggerTargetJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.TriggerSandbox sandbox = 1;
+     */
+    sandbox?: TriggerSandboxJson;
+    /**
+     * @generated from field: toshi.workspace.v1.TriggerPreview preview = 2;
+     */
+    preview?: TriggerPreviewJson;
+    /**
+     * @generated from field: toshi.workspace.v1.TriggerServiceChannel service = 3;
+     */
+    service?: TriggerServiceChannelJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.TriggerTarget.
+ * Use `create(TriggerTargetSchema)` to create a new message.
+ */
+export declare const TriggerTargetSchema: GenMessage<TriggerTarget, {
+    jsonType: TriggerTargetJson;
+}>;
+/**
+ * TriggerServiceChannel is the event channel a trigger's DELIVER puts its
+ * events on.
+ *
+ * @generated from message toshi.workspace.v1.TriggerServiceChannel
+ */
+export type TriggerServiceChannel = Message<"toshi.workspace.v1.TriggerServiceChannel"> & {
+    /**
+     * A service of the trigger's project and environment, by name. Required.
+     *
+     * @generated from field: string service = 1;
+     */
+    service: string;
+    /**
+     * The name of one of the service's event channels. Required.
+     *
+     * @generated from field: string channel = 2;
+     */
+    channel: string;
+};
+/**
+ * TriggerServiceChannel is the event channel a trigger's DELIVER puts its
+ * events on.
+ *
+ * @generated from message toshi.workspace.v1.TriggerServiceChannel
+ */
+export type TriggerServiceChannelJson = {
+    /**
+     * A service of the trigger's project and environment, by name. Required.
+     *
+     * @generated from field: string service = 1;
+     */
+    service?: string;
+    /**
+     * The name of one of the service's event channels. Required.
+     *
+     * @generated from field: string channel = 2;
+     */
+    channel?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.TriggerServiceChannel.
+ * Use `create(TriggerServiceChannelSchema)` to create a new message.
+ */
+export declare const TriggerServiceChannelSchema: GenMessage<TriggerServiceChannel, {
+    jsonType: TriggerServiceChannelJson;
+}>;
+/**
+ * TriggerPreview is a sandbox per pull request that the repository
+ * describes in the file `.toshi/preview.toml`. The file is read from the
+ * tip of the pull request's base branch for every event, never from its
+ * head, so a pull request cannot change its own size, time limit or
+ * bindings; a change to the file applies once it is merged. The sandbox
+ * clones the pull request's head commit before its setup runs. A missing
+ * or invalid file makes no sandbox: the trigger records the event as
+ * failed with the reason `no_template` or `invalid_template`. A trigger
+ * with a preview target takes only the pull request events of a GITHUB
+ * connection.
+ *
+ * @generated from message toshi.workspace.v1.TriggerPreview
+ */
+export type TriggerPreview = Message<"toshi.workspace.v1.TriggerPreview"> & {};
+/**
+ * TriggerPreview is a sandbox per pull request that the repository
+ * describes in the file `.toshi/preview.toml`. The file is read from the
+ * tip of the pull request's base branch for every event, never from its
+ * head, so a pull request cannot change its own size, time limit or
+ * bindings; a change to the file applies once it is merged. The sandbox
+ * clones the pull request's head commit before its setup runs. A missing
+ * or invalid file makes no sandbox: the trigger records the event as
+ * failed with the reason `no_template` or `invalid_template`. A trigger
+ * with a preview target takes only the pull request events of a GITHUB
+ * connection.
+ *
+ * @generated from message toshi.workspace.v1.TriggerPreview
+ */
+export type TriggerPreviewJson = {};
+/**
+ * Describes the message toshi.workspace.v1.TriggerPreview.
+ * Use `create(TriggerPreviewSchema)` to create a new message.
+ */
+export declare const TriggerPreviewSchema: GenMessage<TriggerPreview, {
+    jsonType: TriggerPreviewJson;
+}>;
+/**
+ * TriggerSandbox is a sandbox a trigger makes.
+ *
+ * @generated from message toshi.workspace.v1.TriggerSandbox
+ */
+export type TriggerSandbox = Message<"toshi.workspace.v1.TriggerSandbox"> & {
+    /**
+     * The runner size of its VM, which picks its image, for example
+     * "toshi-linux-2x". Required.
+     *
+     * @generated from field: string size = 1;
+     */
+    size: string;
+    /**
+     * How long it may run, in whole minutes; unset is 24 hours, or the plan's
+     * sandbox cap when shorter. It cannot be longer than the cap: a create or
+     * update past it is refused.
+     *
+     * @generated from field: google.protobuf.Duration max_duration = 2;
+     */
+    maxDuration?: Duration | undefined;
+    /**
+     * What in its workspace it uses, as SandboxSpec's bindings.
+     *
+     * @generated from field: repeated toshi.workspace.v1.Binding bindings = 3;
+     */
+    bindings: Binding[];
+    /**
+     * Runs first, to exit 0.
+     *
+     * @generated from field: toshi.workspace.v1.Command setup = 4;
+     */
+    setup?: Command | undefined;
+    /**
+     * Runs after setup and is kept running for the sandbox's life.
+     *
+     * @generated from field: toshi.workspace.v1.Command process = 5;
+     */
+    process?: Command | undefined;
+    /**
+     * The http channel whose link the trigger reports. Empty reports the
+     * first preview the sandbox serves, and a sandbox that serves none is
+     * ready with no link.
+     *
+     * @generated from field: string channel = 6;
+     */
+    channel: string;
+    /**
+     * The container image the sandbox runs, as a sandbox's spec names it
+     * (`registry/repository:tag` or `@sha256:` digest); a tag is resolved when
+     * each sandbox is made. Empty runs none.
+     *
+     * @generated from field: string container_image = 7;
+     */
+    containerImage: string;
+};
+/**
+ * TriggerSandbox is a sandbox a trigger makes.
+ *
+ * @generated from message toshi.workspace.v1.TriggerSandbox
+ */
+export type TriggerSandboxJson = {
+    /**
+     * The runner size of its VM, which picks its image, for example
+     * "toshi-linux-2x". Required.
+     *
+     * @generated from field: string size = 1;
+     */
+    size?: string;
+    /**
+     * How long it may run, in whole minutes; unset is 24 hours, or the plan's
+     * sandbox cap when shorter. It cannot be longer than the cap: a create or
+     * update past it is refused.
+     *
+     * @generated from field: google.protobuf.Duration max_duration = 2;
+     */
+    maxDuration?: DurationJson;
+    /**
+     * What in its workspace it uses, as SandboxSpec's bindings.
+     *
+     * @generated from field: repeated toshi.workspace.v1.Binding bindings = 3;
+     */
+    bindings?: BindingJson[];
+    /**
+     * Runs first, to exit 0.
+     *
+     * @generated from field: toshi.workspace.v1.Command setup = 4;
+     */
+    setup?: CommandJson;
+    /**
+     * Runs after setup and is kept running for the sandbox's life.
+     *
+     * @generated from field: toshi.workspace.v1.Command process = 5;
+     */
+    process?: CommandJson;
+    /**
+     * The http channel whose link the trigger reports. Empty reports the
+     * first preview the sandbox serves, and a sandbox that serves none is
+     * ready with no link.
+     *
+     * @generated from field: string channel = 6;
+     */
+    channel?: string;
+    /**
+     * The container image the sandbox runs, as a sandbox's spec names it
+     * (`registry/repository:tag` or `@sha256:` digest); a tag is resolved when
+     * each sandbox is made. Empty runs none.
+     *
+     * @generated from field: string container_image = 7;
+     */
+    containerImage?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.TriggerSandbox.
+ * Use `create(TriggerSandboxSchema)` to create a new message.
+ */
+export declare const TriggerSandboxSchema: GenMessage<TriggerSandbox, {
+    jsonType: TriggerSandboxJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.CreateTriggerRequest
+ */
+export type CreateTriggerRequest = Message<"toshi.workspace.v1.CreateTriggerRequest"> & {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project: string;
+    /**
+     * @generated from field: string environment = 2;
+     */
+    environment: string;
+    /**
+     * The trigger; its id, project, environment and times are ignored.
+     *
+     * @generated from field: toshi.workspace.v1.Trigger trigger = 3;
+     */
+    trigger?: Trigger | undefined;
+    /**
+     * @generated from field: string request_key = 4;
+     */
+    requestKey: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.CreateTriggerRequest
+ */
+export type CreateTriggerRequestJson = {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project?: string;
+    /**
+     * @generated from field: string environment = 2;
+     */
+    environment?: string;
+    /**
+     * The trigger; its id, project, environment and times are ignored.
+     *
+     * @generated from field: toshi.workspace.v1.Trigger trigger = 3;
+     */
+    trigger?: TriggerJson;
+    /**
+     * @generated from field: string request_key = 4;
+     */
+    requestKey?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.CreateTriggerRequest.
+ * Use `create(CreateTriggerRequestSchema)` to create a new message.
+ */
+export declare const CreateTriggerRequestSchema: GenMessage<CreateTriggerRequest, {
+    jsonType: CreateTriggerRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.CreateTriggerResponse
+ */
+export type CreateTriggerResponse = Message<"toshi.workspace.v1.CreateTriggerResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.Trigger trigger = 1;
+     */
+    trigger?: Trigger | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.CreateTriggerResponse
+ */
+export type CreateTriggerResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.Trigger trigger = 1;
+     */
+    trigger?: TriggerJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.CreateTriggerResponse.
+ * Use `create(CreateTriggerResponseSchema)` to create a new message.
+ */
+export declare const CreateTriggerResponseSchema: GenMessage<CreateTriggerResponse, {
+    jsonType: CreateTriggerResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetTriggerRequest
+ */
+export type GetTriggerRequest = Message<"toshi.workspace.v1.GetTriggerRequest"> & {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project: string;
+    /**
+     * @generated from field: string environment = 2;
+     */
+    environment: string;
+    /**
+     * @generated from field: string id = 3;
+     */
+    id: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.GetTriggerRequest
+ */
+export type GetTriggerRequestJson = {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project?: string;
+    /**
+     * @generated from field: string environment = 2;
+     */
+    environment?: string;
+    /**
+     * @generated from field: string id = 3;
+     */
+    id?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.GetTriggerRequest.
+ * Use `create(GetTriggerRequestSchema)` to create a new message.
+ */
+export declare const GetTriggerRequestSchema: GenMessage<GetTriggerRequest, {
+    jsonType: GetTriggerRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetTriggerResponse
+ */
+export type GetTriggerResponse = Message<"toshi.workspace.v1.GetTriggerResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.Trigger trigger = 1;
+     */
+    trigger?: Trigger | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.GetTriggerResponse
+ */
+export type GetTriggerResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.Trigger trigger = 1;
+     */
+    trigger?: TriggerJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.GetTriggerResponse.
+ * Use `create(GetTriggerResponseSchema)` to create a new message.
+ */
+export declare const GetTriggerResponseSchema: GenMessage<GetTriggerResponse, {
+    jsonType: GetTriggerResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.ListTriggersRequest
+ */
+export type ListTriggersRequest = Message<"toshi.workspace.v1.ListTriggersRequest"> & {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project: string;
+    /**
+     * @generated from field: string environment = 2;
+     */
+    environment: string;
+    /**
+     * The most triggers 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.ListTriggersRequest
+ */
+export type ListTriggersRequestJson = {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project?: string;
+    /**
+     * @generated from field: string environment = 2;
+     */
+    environment?: string;
+    /**
+     * The most triggers 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.ListTriggersRequest.
+ * Use `create(ListTriggersRequestSchema)` to create a new message.
+ */
+export declare const ListTriggersRequestSchema: GenMessage<ListTriggersRequest, {
+    jsonType: ListTriggersRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.ListTriggersResponse
+ */
+export type ListTriggersResponse = Message<"toshi.workspace.v1.ListTriggersResponse"> & {
+    /**
+     * @generated from field: repeated toshi.workspace.v1.Trigger triggers = 1;
+     */
+    triggers: Trigger[];
+    /**
+     * Empty on the last page.
+     *
+     * @generated from field: string next_page_token = 2;
+     */
+    nextPageToken: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.ListTriggersResponse
+ */
+export type ListTriggersResponseJson = {
+    /**
+     * @generated from field: repeated toshi.workspace.v1.Trigger triggers = 1;
+     */
+    triggers?: TriggerJson[];
+    /**
+     * Empty on the last page.
+     *
+     * @generated from field: string next_page_token = 2;
+     */
+    nextPageToken?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.ListTriggersResponse.
+ * Use `create(ListTriggersResponseSchema)` to create a new message.
+ */
+export declare const ListTriggersResponseSchema: GenMessage<ListTriggersResponse, {
+    jsonType: ListTriggersResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.UpdateTriggerRequest
+ */
+export type UpdateTriggerRequest = Message<"toshi.workspace.v1.UpdateTriggerRequest"> & {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project: string;
+    /**
+     * @generated from field: string environment = 2;
+     */
+    environment: string;
+    /**
+     * @generated from field: string id = 3;
+     */
+    id: string;
+    /**
+     * Carries the new values of the fields update_mask names.
+     *
+     * @generated from field: toshi.workspace.v1.Trigger trigger = 4;
+     */
+    trigger?: Trigger | undefined;
+    /**
+     * @generated from field: google.protobuf.FieldMask update_mask = 5;
+     */
+    updateMask?: FieldMask | undefined;
+    /**
+     * @generated from field: string request_key = 6;
+     */
+    requestKey: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.UpdateTriggerRequest
+ */
+export type UpdateTriggerRequestJson = {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project?: string;
+    /**
+     * @generated from field: string environment = 2;
+     */
+    environment?: string;
+    /**
+     * @generated from field: string id = 3;
+     */
+    id?: string;
+    /**
+     * Carries the new values of the fields update_mask names.
+     *
+     * @generated from field: toshi.workspace.v1.Trigger trigger = 4;
+     */
+    trigger?: TriggerJson;
+    /**
+     * @generated from field: google.protobuf.FieldMask update_mask = 5;
+     */
+    updateMask?: FieldMaskJson;
+    /**
+     * @generated from field: string request_key = 6;
+     */
+    requestKey?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.UpdateTriggerRequest.
+ * Use `create(UpdateTriggerRequestSchema)` to create a new message.
+ */
+export declare const UpdateTriggerRequestSchema: GenMessage<UpdateTriggerRequest, {
+    jsonType: UpdateTriggerRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.UpdateTriggerResponse
+ */
+export type UpdateTriggerResponse = Message<"toshi.workspace.v1.UpdateTriggerResponse"> & {
+    /**
+     * @generated from field: toshi.workspace.v1.Trigger trigger = 1;
+     */
+    trigger?: Trigger | undefined;
+};
+/**
+ * @generated from message toshi.workspace.v1.UpdateTriggerResponse
+ */
+export type UpdateTriggerResponseJson = {
+    /**
+     * @generated from field: toshi.workspace.v1.Trigger trigger = 1;
+     */
+    trigger?: TriggerJson;
+};
+/**
+ * Describes the message toshi.workspace.v1.UpdateTriggerResponse.
+ * Use `create(UpdateTriggerResponseSchema)` to create a new message.
+ */
+export declare const UpdateTriggerResponseSchema: GenMessage<UpdateTriggerResponse, {
+    jsonType: UpdateTriggerResponseJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.DeleteTriggerRequest
+ */
+export type DeleteTriggerRequest = Message<"toshi.workspace.v1.DeleteTriggerRequest"> & {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project: string;
+    /**
+     * @generated from field: string environment = 2;
+     */
+    environment: string;
+    /**
+     * @generated from field: string id = 3;
+     */
+    id: string;
+    /**
+     * @generated from field: string request_key = 4;
+     */
+    requestKey: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.DeleteTriggerRequest
+ */
+export type DeleteTriggerRequestJson = {
+    /**
+     * @generated from field: string project = 1;
+     */
+    project?: string;
+    /**
+     * @generated from field: string environment = 2;
+     */
+    environment?: string;
+    /**
+     * @generated from field: string id = 3;
+     */
+    id?: string;
+    /**
+     * @generated from field: string request_key = 4;
+     */
+    requestKey?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.DeleteTriggerRequest.
+ * Use `create(DeleteTriggerRequestSchema)` to create a new message.
+ */
+export declare const DeleteTriggerRequestSchema: GenMessage<DeleteTriggerRequest, {
+    jsonType: DeleteTriggerRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.DeleteTriggerResponse
+ */
+export type DeleteTriggerResponse = Message<"toshi.workspace.v1.DeleteTriggerResponse"> & {};
+/**
+ * @generated from message toshi.workspace.v1.DeleteTriggerResponse
+ */
+export type DeleteTriggerResponseJson = {};
+/**
+ * Describes the message toshi.workspace.v1.DeleteTriggerResponse.
+ * Use `create(DeleteTriggerResponseSchema)` to create a new message.
+ */
+export declare const DeleteTriggerResponseSchema: GenMessage<DeleteTriggerResponse, {
+    jsonType: DeleteTriggerResponseJson;
+}>;
+/**
+ * TriggerAction is what a trigger does with an event it matches.
+ *
+ * @generated from enum toshi.workspace.v1.TriggerAction
+ */
+export declare enum TriggerAction {
+    /**
+     * @generated from enum value: TRIGGER_ACTION_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Makes the target workload for the event's key, replacing the one the
+     * key had: the new one first, and the older ones are deleted once it runs
+     * or has failed. An event older than the newest one the key has seen
+     * changes nothing.
+     *
+     * @generated from enum value: TRIGGER_ACTION_CREATE = 1;
+     */
+    CREATE = 1,
+    /**
+     * Deletes the workloads the environment's CREATE triggers of the same
+     * source made for the event's key.
+     *
+     * @generated from enum value: TRIGGER_ACTION_DELETE = 2;
+     */
+    DELETE = 2,
+    /**
+     * Puts the event on the target service's event channel, which wakes the
+     * service if it sleeps and posts the event to it. The message's source
+     * is the trigger, and the event's id makes its request key, so an event
+     * is put on the channel once.
+     *
+     * @generated from enum value: TRIGGER_ACTION_DELIVER = 3;
+     */
+    DELIVER = 3
+}
+/**
+ * TriggerAction is what a trigger does with an event it matches.
+ *
+ * @generated from enum toshi.workspace.v1.TriggerAction
+ */
+export type TriggerActionJson = "TRIGGER_ACTION_UNSPECIFIED" | "TRIGGER_ACTION_CREATE" | "TRIGGER_ACTION_DELETE" | "TRIGGER_ACTION_DELIVER";
+/**
+ * Describes the enum toshi.workspace.v1.TriggerAction.
+ */
+export declare const TriggerActionSchema: GenEnum<TriggerAction, TriggerActionJson>;
+/**
+ * TriggerForks is what a trigger does with a pull request from a fork.
+ *
+ * @generated from enum toshi.workspace.v1.TriggerForks
+ */
+export declare enum TriggerForks {
+    /**
+     * As LABEL.
+     *
+     * @generated from enum value: TRIGGER_FORKS_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Nothing runs until a person with write access to the base repository
+     * adds the label toshi:preview to the pull request. What runs then has no
+     * bindings, and a new commit to the pull request removes it.
+     *
+     * @generated from enum value: TRIGGER_FORKS_LABEL = 1;
+     */
+    LABEL = 1,
+    /**
+     * Nothing runs for a fork.
+     *
+     * @generated from enum value: TRIGGER_FORKS_NEVER = 2;
+     */
+    NEVER = 2
+}
+/**
+ * TriggerForks is what a trigger does with a pull request from a fork.
+ *
+ * @generated from enum toshi.workspace.v1.TriggerForks
+ */
+export type TriggerForksJson = "TRIGGER_FORKS_UNSPECIFIED" | "TRIGGER_FORKS_LABEL" | "TRIGGER_FORKS_NEVER";
+/**
+ * Describes the enum toshi.workspace.v1.TriggerForks.
+ */
+export declare const TriggerForksSchema: GenEnum<TriggerForks, TriggerForksJson>;
+/**
+ * TriggerService keeps a project's triggers: each binds the events one
+ * connection brings to an action on the project's workloads. A trigger
+ * matches an event on the events it names, the exact names, and on its
+ * filter; nothing else of the event is read, and no code of the
+ * workspace's runs in the control plane.
+ *
+ * A trigger belongs to a project and an environment, the environment its
+ * workloads run in, and every call names both, as WorkloadService's do.
+ * A trigger is owed the events written after it is created, from then
+ * on; it never acts on an event written before it.
+ *
+ * CreateTrigger, UpdateTrigger and DeleteTrigger take a request_key, with
+ * WorkloadService's rule: a retry with the same key and the same payload
+ * returns what the first call returned and changes nothing; the same key
+ * with a different payload fails with FAILED_PRECONDITION; an empty key
+ * means no retry protection.
+ *
+ * @generated from service toshi.workspace.v1.TriggerService
+ */
+export declare const TriggerService: GenService<{
+    /**
+     * CreateTrigger makes a trigger. A source that is not a connection of
+     * the workspace fails with NOT_FOUND, and so does a WEBHOOK connection of
+     * another project or environment. No events, an event name with the
+     * reserved prefix `trigger.`, no target for the action CREATE, a key
+     * that is not a template of the event data, a production environment for
+     * pull request events, or a preview target whose source is not a GITHUB
+     * connection or whose events are not all pull request events fails with
+     * INVALID_ARGUMENT, and a name another
+     * trigger of the project has with ALREADY_EXISTS.
+     *
+     * @generated from rpc toshi.workspace.v1.TriggerService.CreateTrigger
+     */
+    createTrigger: {
+        methodKind: "unary";
+        input: typeof CreateTriggerRequestSchema;
+        output: typeof CreateTriggerResponseSchema;
+    };
+    /**
+     * GetTrigger returns one trigger. One the project does not have, or one
+     * deleted, is NOT_FOUND.
+     *
+     * @generated from rpc toshi.workspace.v1.TriggerService.GetTrigger
+     */
+    getTrigger: {
+        methodKind: "unary";
+        input: typeof GetTriggerRequestSchema;
+        output: typeof GetTriggerResponseSchema;
+    };
+    /**
+     * ListTriggers returns the triggers of the project's environment, in name
+     * order.
+     *
+     * A page holds 100 triggers when page_size is zero, and 1000 at most.
+     *
+     * @generated from rpc toshi.workspace.v1.TriggerService.ListTriggers
+     */
+    listTriggers: {
+        methodKind: "unary";
+        input: typeof ListTriggersRequestSchema;
+        output: typeof ListTriggersResponseSchema;
+    };
+    /**
+     * UpdateTrigger sets the fields update_mask names: name, events, filter,
+     * action, target, key, idle_timeout and forks. A trigger's source, project
+     * and environment are fixed; a mask that names one fails with
+     * INVALID_ARGUMENT, and the new values are checked as CreateTrigger's are.
+     * The change applies to the events written after it.
+     *
+     * @generated from rpc toshi.workspace.v1.TriggerService.UpdateTrigger
+     */
+    updateTrigger: {
+        methodKind: "unary";
+        input: typeof UpdateTriggerRequestSchema;
+        output: typeof UpdateTriggerResponseSchema;
+    };
+    /**
+     * DeleteTrigger deletes a trigger: it acts on no further event, and the
+     * evaluator's next pass removes the workloads it made.
+     *
+     * @generated from rpc toshi.workspace.v1.TriggerService.DeleteTrigger
+     */
+    deleteTrigger: {
+        methodKind: "unary";
+        input: typeof DeleteTriggerRequestSchema;
+        output: typeof DeleteTriggerResponseSchema;
+    };
+}>;