[scheduler]: ACLs phase 1 - per Job ACL specification and enforcement.

scheduler/appengine/messages/cron.pb.go

 // Code generated by protoc-gen-go. DO NOT EDIT.
 // source: github.com/luci/luci-go/scheduler/appengine/messages/cron.proto
 
 /*
 Package messages is a generated protocol buffer package.
 
 It is generated from these files:
         github.com/luci/luci-go/scheduler/appengine/messages/cron.proto
 
 It has these top-level messages:
+        Acl
+        AclSet
         Job
         Trigger
         NoopTask
         GitilesTask
         UrlFetchTask
         SwarmingTask
         BuildbucketTask
         ProjectConfig
         TaskDefWrapper
 */
 package messages
 
 import proto "github.com/golang/protobuf/proto"
 import fmt "fmt"
 import math "math"
 
 // Reference imports to suppress errors if they are not otherwise used.
 var _ = proto.Marshal
 var _ = fmt.Errorf
 var _ = math.Inf
 
 // This is a compile-time assertion to ensure that this generated file
 // is compatible with the proto package it is being compiled against.
 // A compilation error at this line likely means your copy of the
 // proto package needs to be updated.
 const _ = proto.ProtoPackageIsVersion2 // please upgrade the proto package
 
+type Acl_Role int32
+
+const (
+        // Can do read-only operations, such as listing invocations of a Job.
+        Acl_READER Acl_Role = 0
+        // Same as READER + can modify state of a Job or Invocation such as
+        // triggering or aborting them.
+        // LUCI scheduler (this service) is an OWNER of each `Job` and `Trigger`, thus
+        // `Trigger`s are allowed to trigger all `Job`s defined in the same
+        // project, regardless of their respective ACLs.
+        Acl_OWNER Acl_Role = 1
+)
+
+var Acl_Role_name = map[int32]string{
+        0: "READER",
+        1: "OWNER",
+}
+var Acl_Role_value = map[string]int32{
+        "READER": 0,
+        "OWNER":  1,
+}
+
+func (x Acl_Role) String() string {
+        return proto.EnumName(Acl_Role_name, int32(x))
+}
+func (Acl_Role) EnumDescriptor() ([]byte, []int) { return fileDescriptor0, []int{0, 0} }
+
+// A single access control rule.
+//
+// WARNING: until ACLs are fully deployed, DO NOT rely on READER Role
+// limiting access to your project. Follow crbug/736770 if in doubt.
+// TODO(tandrii): REMOVE THIS WARNING once deployment is complete.
+type Acl struct {
+        // Role denotes a list of actions that an identity can perform.
+        Role Acl_Role `protobuf:"varint,1,opt,name=role,enum=messages.Acl_Role" json:"role,omitempty"`
+        // Either email or "group:xyz" or auth service identity string "kind:name".
+        GrantedTo string `protobuf:"bytes,2,opt,name=granted_to,json=grantedTo" json:"granted_to,omitempty"`
+}
+
+func (m *Acl) Reset()                    { *m = Acl{} }
+func (m *Acl) String() string            { return proto.CompactTextString(m) }
+func (*Acl) ProtoMessage()               {}
+func (*Acl) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{0} }
+
+func (m *Acl) GetRole() Acl_Role {
+        if m != nil {
+                return m.Role
+        }
+        return Acl_READER
+}
+
+func (m *Acl) GetGrantedTo() string {
+        if m != nil {
+                return m.GrantedTo
+        }
+        return ""
+}
+
+// A set of Acl messages. Can be referenced in a Job or Trigger by name.
+type AclSet struct {
+        // A name of the ACL set, unique for a project.
+        // Required. Must match regex '^[0-9A-Za-z_\-\.]{1,100}$'.
+        Name string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
+        // List of access control rules.
+        // The order does not matter.
+        Acls []*Acl `protobuf:"bytes,2,rep,name=acls" json:"acls,omitempty"`
+}
+
+func (m *AclSet) Reset()                    { *m = AclSet{} }
+func (m *AclSet) String() string            { return proto.CompactTextString(m) }
+func (*AclSet) ProtoMessage()               {}
+func (*AclSet) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{1} }
+
+func (m *AclSet) GetName() string {
+        if m != nil {
+                return m.Name
+        }
+        return ""
+}
+
+func (m *AclSet) GetAcls() []*Acl {
+        if m != nil {
+                return m.Acls
+        }
+        return nil
+}
+
 // Job specifies a single regular job belonging to a project.
 //
 // Such jobs runs on a schedule or can be triggered by some trigger.
 type Job struct {
         // Id is a name of the job (unique for the project).
         //
         // Must match '^[0-9A-Za-z_\-\.]{1,100}$'.
         Id string `protobuf:"bytes,1,opt,name=id" json:"id,omitempty"`
         // Schedule describes when to run the job.
         //
         // Supported kinds of schedules (illustrated by examples):
         //   - "* 0 * * * *": standard cron-like expression. Cron engine will attempt
         //     to start a job at specified moments in time (based on UTC clock). If
         //     when triggering a job, previous invocation is still running, an overrun
         //     will be recorded (and next attempt to start a job happens based on the
         //     schedule, not when the previous invocation finishes). This is absolute
         //     schedule (i.e. doesn't depend on job state).
         //   - "with 10s interval": runs invocations in a loop, waiting 10s after
         //     finishing invocation before starting a new one. This is relative
         //     schedule. Overruns are not possible.
         //   - "continuously" is alias for "with 0s interval", meaning the job will
         //     run in a loop without any pauses.
-        //   - "triggered" schedule indicates that job is always started via "Run now"
+        //   - "triggered" schedule indicates that job is only started via "Run now"
         //     button or via a trigger.
         //
         // Default is "triggered".
         Schedule string `protobuf:"bytes,2,opt,name=schedule" json:"schedule,omitempty"`
         // Disabled is true to disable this job.
         Disabled bool `protobuf:"varint,3,opt,name=disabled" json:"disabled,omitempty"`
         // Task defines what exactly to execute.
         //
         // TODO(vadimsh): Remove this field once all configs are updated not to
         // use it.
         Task *TaskDefWrapper `protobuf:"bytes,4,opt,name=task" json:"task,omitempty"`
+        // List of access control rules for the Job.
+        // The order does not matter.
+        // There can be at most 32 different acls for a Job, including those from
+        // acl_sets.
+        Acls []*Acl `protobuf:"bytes,5,rep,name=acls" json:"acls,omitempty"`
+        // A list of ACL set names. Each ACL in each referenced ACL set will be
+        // included in this Job.
+        // The order does not matter.
+        AclSets []string `protobuf:"bytes,6,rep,name=acl_sets,json=aclSets" json:"acl_sets,omitempty"`
         // Noop is used for testing. It is "do nothing" task.
         Noop *NoopTask `protobuf:"bytes,100,opt,name=noop" json:"noop,omitempty"`
         // UrlFetch can be used to make a simple HTTP call.
         UrlFetch *UrlFetchTask `protobuf:"bytes,101,opt,name=url_fetch,json=urlFetch" json:"url_fetch,omitempty"`
         // SwarmingTask can be used to schedule swarming job.
         Swarming *SwarmingTask `protobuf:"bytes,102,opt,name=swarming" json:"swarming,omitempty"`
         // BuildbucketTask can be used to schedule buildbucket job.
         Buildbucket *BuildbucketTask `protobuf:"bytes,103,opt,name=buildbucket" json:"buildbucket,omitempty"`
 }
 
 func (m *Job) Reset()                    { *m = Job{} }
 func (m *Job) String() string            { return proto.CompactTextString(m) }
 func (*Job) ProtoMessage()               {}
-func (*Job) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{0} }
+func (*Job) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{2} }
 
 func (m *Job) GetId() string {
         if m != nil {
                 return m.Id
         }
         return ""
 }
 
 func (m *Job) GetSchedule() string {
         if m != nil {
                 return m.Schedule
         }
         return ""
 }
 
 func (m *Job) GetDisabled() bool {
         if m != nil {
                 return m.Disabled
         }
         return false
 }
 
 func (m *Job) GetTask() *TaskDefWrapper {
         if m != nil {
                 return m.Task
         }
         return nil
 }
 
+func (m *Job) GetAcls() []*Acl {
+        if m != nil {
+                return m.Acls
+        }
+        return nil
+}
+
+func (m *Job) GetAclSets() []string {
+        if m != nil {
+                return m.AclSets
+        }
+        return nil
+}
+
 func (m *Job) GetNoop() *NoopTask {
         if m != nil {
                 return m.Noop
         }
         return nil
 }
 
 func (m *Job) GetUrlFetch() *UrlFetchTask {
         if m != nil {
                 return m.UrlFetch
@@ skipping 24 matching lines @@
         //
         // Must match '^[0-9A-Za-z_\-\.]{1,100}$'. It's in the same namespace as
         // regular jobs.
         Id string `protobuf:"bytes,1,opt,name=id" json:"id,omitempty"`
         // Schedule describes when to run this triggering job.
         //
         // See Job.schedule fro more info. Default is "with 30s interval".
         Schedule string `protobuf:"bytes,2,opt,name=schedule" json:"schedule,omitempty"`
         // Disabled is true to disable this job.
         Disabled bool `protobuf:"varint,3,opt,name=disabled" json:"disabled,omitempty"`
+        // List of access control rules for the Job.
+        // The order does not matter.
+        // There can be at most 32 different acls for a Job, including those from
+        // acl_sets.
+        Acls []*Acl `protobuf:"bytes,4,rep,name=acls" json:"acls,omitempty"`
+        // A list of ACL set names. Each ACL in each referenced ACL set will be
+        // included in this Job.
+        // The order does not matter.
+        AclSets []string `protobuf:"bytes,5,rep,name=acl_sets,json=aclSets" json:"acl_sets,omitempty"`
         // Noop is used for testing. It is "do nothing" trigger.
         Noop *NoopTask `protobuf:"bytes,100,opt,name=noop" json:"noop,omitempty"`
         // Gitiles is used to trigger jobs for new commits on Gitiles.
         Gitiles *GitilesTask `protobuf:"bytes,101,opt,name=gitiles" json:"gitiles,omitempty"`
 }
 
 func (m *Trigger) Reset()                    { *m = Trigger{} }
 func (m *Trigger) String() string            { return proto.CompactTextString(m) }
 func (*Trigger) ProtoMessage()               {}
-func (*Trigger) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{1} }
+func (*Trigger) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{3} }
 
 func (m *Trigger) GetId() string {
         if m != nil {
                 return m.Id
         }
         return ""
 }
 
 func (m *Trigger) GetSchedule() string {
         if m != nil {
                 return m.Schedule
         }
         return ""
 }
 
 func (m *Trigger) GetDisabled() bool {
         if m != nil {
                 return m.Disabled
         }
         return false
 }
 
+func (m *Trigger) GetAcls() []*Acl {
+        if m != nil {
+                return m.Acls
+        }
+        return nil
+}
+
+func (m *Trigger) GetAclSets() []string {
+        if m != nil {
+                return m.AclSets
+        }
+        return nil
+}
+
 func (m *Trigger) GetNoop() *NoopTask {
         if m != nil {
                 return m.Noop
         }
         return nil
 }
 
 func (m *Trigger) GetGitiles() *GitilesTask {
         if m != nil {
                 return m.Gitiles
         }
         return nil
 }
 
 // NoopTask is used for testing. It is "do nothing" task.
 type NoopTask struct {
 }
 
 func (m *NoopTask) Reset()                    { *m = NoopTask{} }
 func (m *NoopTask) String() string            { return proto.CompactTextString(m) }
 func (*NoopTask) ProtoMessage()               {}
-func (*NoopTask) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{2} }
+func (*NoopTask) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{4} }
 
 // GitilesTask specifies parameters of Swarming-based jobs.
 type GitilesTask struct {
         // Repo is the URL of the Gitiles repository.
         Repo string `protobuf:"bytes,1,opt,name=repo" json:"repo,omitempty"`
         // List of Git references to track.
         Refs []string `protobuf:"bytes,2,rep,name=refs" json:"refs,omitempty"`
 }
 
 func (m *GitilesTask) Reset()                    { *m = GitilesTask{} }
 func (m *GitilesTask) String() string            { return proto.CompactTextString(m) }
 func (*GitilesTask) ProtoMessage()               {}
-func (*GitilesTask) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{3} }
+func (*GitilesTask) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{5} }
 
 func (m *GitilesTask) GetRepo() string {
         if m != nil {
                 return m.Repo
         }
         return ""
 }
 
 func (m *GitilesTask) GetRefs() []string {
         if m != nil {
                 return m.Refs
         }
         return nil
 }
 
 // UrlFetchTask specifies parameters for simple HTTP call.
 type UrlFetchTask struct {
         // Method is HTTP method to use, such as "GET" or "POST". Default is "GET".
         Method string `protobuf:"bytes,1,opt,name=method" json:"method,omitempty"`
         // Url to send the request to.
         Url string `protobuf:"bytes,2,opt,name=url" json:"url,omitempty"`
         // Timeout is how long to wait for request to complete. Default is 60 sec.
         TimeoutSec int32 `protobuf:"varint,3,opt,name=timeout_sec,json=timeoutSec" json:"timeout_sec,omitempty"`
 }
 
 func (m *UrlFetchTask) Reset()                    { *m = UrlFetchTask{} }
 func (m *UrlFetchTask) String() string            { return proto.CompactTextString(m) }
 func (*UrlFetchTask) ProtoMessage()               {}
-func (*UrlFetchTask) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{4} }
+func (*UrlFetchTask) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{6} }
 
 func (m *UrlFetchTask) GetMethod() string {
         if m != nil {
                 return m.Method
         }
         return ""
 }
 
 func (m *UrlFetchTask) GetUrl() string {
         if m != nil {
@@ skipping 28 matching lines @@
         Priority int32 `protobuf:"varint,8,opt,name=priority" json:"priority,omitempty"`
         // Timeouts. All optional. The scheduler will set reasonable default values.
         ExecutionTimeoutSecs int32 `protobuf:"varint,9,opt,name=execution_timeout_secs,json=executionTimeoutSecs" json:"execution_timeout_secs,omitempty"`
         GracePeriodSecs      int32 `protobuf:"varint,10,opt,name=grace_period_secs,json=gracePeriodSecs" json:"grace_period_secs,omitempty"`
         IoTimeoutSecs        int32 `protobuf:"varint,11,opt,name=io_timeout_secs,json=ioTimeoutSecs" json:"io_timeout_secs,omitempty"`
 }
 
 func (m *SwarmingTask) Reset()                    { *m = SwarmingTask{} }
 func (m *SwarmingTask) String() string            { return proto.CompactTextString(m) }
 func (*SwarmingTask) ProtoMessage()               {}
-func (*SwarmingTask) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{5} }
+func (*SwarmingTask) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{7} }
 
 func (m *SwarmingTask) GetServer() string {
         if m != nil {
                 return m.Server
         }
         return ""
 }
 
 func (m *SwarmingTask) GetCommand() []string {
         if m != nil {
@@ skipping 69 matching lines @@
 // an .isolated file
 type SwarmingTask_IsolatedRef struct {
         Isolated       string `protobuf:"bytes,1,opt,name=isolated" json:"isolated,omitempty"`
         IsolatedServer string `protobuf:"bytes,2,opt,name=isolated_server,json=isolatedServer" json:"isolated_server,omitempty"`
         Namespace      string `protobuf:"bytes,3,opt,name=namespace" json:"namespace,omitempty"`
 }
 
 func (m *SwarmingTask_IsolatedRef) Reset()                    { *m = SwarmingTask_IsolatedRef{} }
 func (m *SwarmingTask_IsolatedRef) String() string            { return proto.CompactTextString(m) }
 func (*SwarmingTask_IsolatedRef) ProtoMessage()               {}
-func (*SwarmingTask_IsolatedRef) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{5, 0} }
+func (*SwarmingTask_IsolatedRef) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{7, 0} }
 
 func (m *SwarmingTask_IsolatedRef) GetIsolated() string {
         if m != nil {
                 return m.Isolated
         }
         return ""
 }
 
 func (m *SwarmingTask_IsolatedRef) GetIsolatedServer() string {
         if m != nil {
@@ skipping 19 matching lines @@
         Builder string `protobuf:"bytes,3,opt,name=builder" json:"builder,omitempty"`
         // Properties is arbitrary "key:value" pairs describing the task.
         Properties []string `protobuf:"bytes,4,rep,name=properties" json:"properties,omitempty"`
         // Tags is a list of tags (as "key:value" pairs) to assign to the task.
         Tags []string `protobuf:"bytes,5,rep,name=tags" json:"tags,omitempty"`
 }
 
 func (m *BuildbucketTask) Reset()                    { *m = BuildbucketTask{} }
 func (m *BuildbucketTask) String() string            { return proto.CompactTextString(m) }
 func (*BuildbucketTask) ProtoMessage()               {}
-func (*BuildbucketTask) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{6} }
+func (*BuildbucketTask) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{8} }
 
 func (m *BuildbucketTask) GetServer() string {
         if m != nil {
                 return m.Server
         }
         return ""
 }
 
 func (m *BuildbucketTask) GetBucket() string {
         if m != nil {
@@ skipping 23 matching lines @@
         return nil
 }
 
 // ProjectConfig defines a schema for config file that describe jobs belonging
 // to some project.
 type ProjectConfig struct {
         // Job is a set of jobs defined in the project.
         Job []*Job `protobuf:"bytes,1,rep,name=job" json:"job,omitempty"`
         // Trigger is a set of triggering jobs defined in the project.
         Trigger []*Trigger `protobuf:"bytes,2,rep,name=trigger" json:"trigger,omitempty"`
+        // A list of ACL sets. Names must be unique.
+        AclSets []*AclSet `protobuf:"bytes,3,rep,name=acl_sets,json=aclSets" json:"acl_sets,omitempty"`
 }
 
 func (m *ProjectConfig) Reset()                    { *m = ProjectConfig{} }
 func (m *ProjectConfig) String() string            { return proto.CompactTextString(m) }
 func (*ProjectConfig) ProtoMessage()               {}
-func (*ProjectConfig) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{7} }
+func (*ProjectConfig) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{9} }
 
 func (m *ProjectConfig) GetJob() []*Job {
         if m != nil {
                 return m.Job
         }
         return nil
 }
 
 func (m *ProjectConfig) GetTrigger() []*Trigger {
         if m != nil {
                 return m.Trigger
         }
         return nil
 }
 
+func (m *ProjectConfig) GetAclSets() []*AclSet {
+        if m != nil {
+                return m.AclSets
+        }
+        return nil
+}
+
 // TaskDefWrapper is a union type of all possible tasks known to the scheduler.
 //
 // It is used internally when storing jobs in the datastore.
 //
 // TODO(vadimsh): Remove '_task' suffixes once TaskDefWrapper is no longer
 // a part of 'Job' proto.
 type TaskDefWrapper struct {
         Noop            *NoopTask        `protobuf:"bytes,1,opt,name=noop" json:"noop,omitempty"`
         UrlFetch        *UrlFetchTask    `protobuf:"bytes,2,opt,name=url_fetch,json=urlFetch" json:"url_fetch,omitempty"`
         SwarmingTask    *SwarmingTask    `protobuf:"bytes,3,opt,name=swarming_task,json=swarmingTask" json:"swarming_task,omitempty"`
         BuildbucketTask *BuildbucketTask `protobuf:"bytes,4,opt,name=buildbucket_task,json=buildbucketTask" json:"buildbucket_task,omitempty"`
         GitilesTask     *GitilesTask     `protobuf:"bytes,5,opt,name=gitiles_task,json=gitilesTask" json:"gitiles_task,omitempty"`
 }
 
 func (m *TaskDefWrapper) Reset()                    { *m = TaskDefWrapper{} }
 func (m *TaskDefWrapper) String() string            { return proto.CompactTextString(m) }
 func (*TaskDefWrapper) ProtoMessage()               {}
-func (*TaskDefWrapper) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{8} }
+func (*TaskDefWrapper) Descriptor() ([]byte, []int) { return fileDescriptor0, []int{10} }
 
 func (m *TaskDefWrapper) GetNoop() *NoopTask {
         if m != nil {
                 return m.Noop
         }
         return nil
 }
 
 func (m *TaskDefWrapper) GetUrlFetch() *UrlFetchTask {
         if m != nil {
@@ skipping 17 matching lines @@
 }
 
 func (m *TaskDefWrapper) GetGitilesTask() *GitilesTask {
         if m != nil {
                 return m.GitilesTask
         }
         return nil
 }
 
 func init() {
+        proto.RegisterType((*Acl)(nil), "messages.Acl")
+        proto.RegisterType((*AclSet)(nil), "messages.AclSet")
         proto.RegisterType((*Job)(nil), "messages.Job")
         proto.RegisterType((*Trigger)(nil), "messages.Trigger")
         proto.RegisterType((*NoopTask)(nil), "messages.NoopTask")
         proto.RegisterType((*GitilesTask)(nil), "messages.GitilesTask")
         proto.RegisterType((*UrlFetchTask)(nil), "messages.UrlFetchTask")
         proto.RegisterType((*SwarmingTask)(nil), "messages.SwarmingTask")
         proto.RegisterType((*SwarmingTask_IsolatedRef)(nil), "messages.SwarmingTask.IsolatedRef")
         proto.RegisterType((*BuildbucketTask)(nil), "messages.BuildbucketTask")
         proto.RegisterType((*ProjectConfig)(nil), "messages.ProjectConfig")
         proto.RegisterType((*TaskDefWrapper)(nil), "messages.TaskDefWrapper")
+        proto.RegisterEnum("messages.Acl_Role", Acl_Role_name, Acl_Role_value)
 }
 
 func init() {
         proto.RegisterFile("github.com/luci/luci-go/scheduler/appengine/messages/cron.proto", fileDescriptor0)
 }
 
 var fileDescriptor0 = []byte{
-        // 780 bytes of a gzipped FileDescriptorProto
-        0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xac, 0x55, 0x4b, 0x6f, 0xf3, 0x44,
-        0x14, 0x95, 0xf3, 0xce, 0x75, 0xd2, 0xb4, 0x23, 0x88, 0x86, 0x0a, 0x68, 0xe4, 0x45, 0x89, 0x78,
-        0x24, 0x52, 0x0a, 0x12, 0x52, 0x17, 0x08, 0x28, 0x20, 0xba, 0x40, 0x95, 0x5b, 0x84, 0x58, 0x20,
-        0xcb, 0x8f, 0x6b, 0x67, 0x5a, 0xdb, 0x63, 0xcd, 0x8c, 0x4b, 0xd9, 0xb3, 0xe7, 0x7f, 0xf4, 0x9f,
-        0xf0, 0xaf, 0x90, 0xc7, 0xcf, 0x56, 0x7c, 0x55, 0x3f, 0xe9, 0xdb, 0x44, 0xbe, 0xe7, 0x9e, 0x7b,
-        0x67, 0xe6, 0xdc, 0x99, 0x13, 0xf8, 0x26, 0x62, 0x6a, 0x9f, 0x7b, 0x1b, 0x9f, 0x27, 0xdb, 0x38,
-        0xf7, 0x99, 0xfe, 0xf9, 0x22, 0xe2, 0x5b, 0xe9, 0xef, 0x31, 0xc8, 0x63, 0x14, 0x5b, 0x37, 0xcb,
-        0x30, 0x8d, 0x58, 0x8a, 0xdb, 0x04, 0xa5, 0x74, 0x23, 0x94, 0x5b, 0x5f, 0xf0, 0x74, 0x93, 0x09,
-        0xae, 0x38, 0x99, 0xd4, 0xa0, 0xf5, 0x6f, 0x0f, 0xfa, 0x97, 0xdc, 0x23, 0x07, 0xd0, 0x63, 0x01,
-        0x35, 0x56, 0xc6, 0x7a, 0x6a, 0xf7, 0x58, 0x40, 0x8e, 0x61, 0x52, 0x37, 0xa3, 0x3d, 0x8d, 0x36,
-        0x71, 0x91, 0x0b, 0x98, 0x74, 0xbd, 0x18, 0x03, 0xda, 0x5f, 0x19, 0xeb, 0x89, 0xdd, 0xc4, 0xe4,
-        0x73, 0x18, 0x28, 0x57, 0xde, 0xd1, 0xc1, 0xca, 0x58, 0x9b, 0x3b, 0xba, 0xa9, 0x17, 0xda, 0xdc,
-        0xb8, 0xf2, 0xee, 0x02, 0xc3, 0xdf, 0x44, 0xb1, 0x33, 0x61, 0x6b, 0x16, 0x39, 0x85, 0x41, 0xca,
-        0x79, 0x46, 0x03, 0xcd, 0x26, 0x2d, 0xfb, 0x17, 0xce, 0xb3, 0xa2, 0xc2, 0xd6, 0x79, 0x72, 0x06,
-        0xd3, 0x5c, 0xc4, 0x4e, 0x88, 0xca, 0xdf, 0x53, 0xd4, 0xe4, 0x65, 0x4b, 0xfe, 0x55, 0xc4, 0x3f,
-        0x16, 0x19, 0x5d, 0x30, 0xc9, 0xab, 0x88, 0xec, 0x60, 0x22, 0xff, 0x74, 0x45, 0xc2, 0xd2, 0x88,
-        0x86, 0xcf, 0x6b, 0xae, 0xab, 0x4c, 0x59, 0x53, 0xf3, 0xc8, 0x39, 0x98, 0x5e, 0xce, 0xe2, 0xc0,
-        0xcb, 0xfd, 0x3b, 0x54, 0x34, 0xd2, 0x65, 0x1f, 0xb4, 0x65, 0xdf, 0xb5, 0x49, 0x5d, 0xd9, 0x65,
-        0x5b, 0x8f, 0x06, 0x8c, 0x6f, 0x04, 0x8b, 0x22, 0x14, 0xef, 0x4c, 0xcf, 0xd7, 0x2a, 0xb4, 0x85,
-        0x71, 0xc4, 0x14, 0x8b, 0x51, 0x56, 0xfa, 0xbc, 0xdf, 0x52, 0x7f, 0x2a, 0x13, 0x9a, 0x5d, 0xb3,
-        0x2c, 0x80, 0x49, 0xdd, 0xc2, 0xfa, 0x0a, 0xcc, 0x0e, 0x87, 0x10, 0x18, 0x08, 0xcc, 0x78, 0xb5,
-        0x7b, 0xfd, 0x5d, 0x62, 0xa1, 0xa4, 0xbd, 0x55, 0xbf, 0xc4, 0x42, 0x69, 0xfd, 0x0e, 0xb3, 0xae,
-        0xf4, 0x64, 0x09, 0xa3, 0x04, 0xd5, 0x9e, 0xd7, 0xe7, 0xae, 0x22, 0x72, 0x08, 0xfd, 0x5c, 0xc4,
-        0xd5, 0xb1, 0x8b, 0x4f, 0x72, 0x02, 0xa6, 0x62, 0x09, 0xf2, 0x5c, 0x39, 0x12, 0x7d, 0x7d, 0xe8,
-        0xa1, 0x0d, 0x15, 0x74, 0x8d, 0xbe, 0xf5, 0xf7, 0x00, 0x66, 0xdd, 0x11, 0x15, 0xbd, 0x25, 0x8a,
-        0x7b, 0x14, 0x75, 0xef, 0x32, 0x22, 0x14, 0xc6, 0x3e, 0x4f, 0x12, 0x37, 0x0d, 0xaa, 0xad, 0xd5,
-        0x21, 0xf9, 0x01, 0x66, 0x4c, 0xf2, 0xd8, 0x55, 0x18, 0x38, 0x02, 0x43, 0xbd, 0x88, 0xb9, 0xb3,
-        0xfe, 0xff, 0x0a, 0x6c, 0x7e, 0xae, 0xa8, 0x36, 0x86, 0xb6, 0xc9, 0xda, 0x80, 0x7c, 0x04, 0x80,
-        0x0f, 0x4a, 0xb8, 0x8e, 0x2b, 0x22, 0x49, 0x07, 0x7a, 0x8d, 0xa9, 0x46, 0xbe, 0x15, 0x91, 0x2c,
-        0xce, 0x86, 0xe9, 0x3d, 0x1d, 0x6a, 0xbc, 0xf8, 0x24, 0x1f, 0x03, 0x04, 0x2c, 0xc1, 0x54, 0x32,
-        0x9e, 0x4a, 0x3a, 0xd2, 0x89, 0x0e, 0x52, 0x28, 0xa9, 0xdc, 0x48, 0xd2, 0x71, 0xa9, 0x64, 0xf1,
-        0x5d, 0xdc, 0x80, 0x4c, 0x30, 0x2e, 0x98, 0xfa, 0x8b, 0x4e, 0xb4, 0x18, 0x4d, 0x4c, 0xbe, 0x84,
-        0x25, 0x3e, 0xa0, 0x9f, 0x2b, 0xc6, 0x53, 0xa7, 0xa3, 0x9a, 0xa4, 0x53, 0xcd, 0x7c, 0xaf, 0xc9,
-        0xde, 0x34, 0xfa, 0x49, 0xf2, 0x29, 0x1c, 0x45, 0xc2, 0xf5, 0xd1, 0xc9, 0x50, 0x30, 0x1e, 0x94,
-        0x05, 0xa0, 0x0b, 0x16, 0x3a, 0x71, 0xa5, 0x71, 0xcd, 0x3d, 0x85, 0x05, 0xe3, 0x4f, 0x5b, 0x9b,
-        0x9a, 0x39, 0x67, 0xbc, 0xd3, 0xf3, 0x38, 0x03, 0xb3, 0x23, 0x53, 0xb1, 0xe9, 0x5a, 0xa8, 0x6a,
-        0x28, 0x4d, 0x4c, 0x3e, 0x81, 0x45, 0x23, 0x7e, 0x35, 0xb7, 0x72, 0xfc, 0x07, 0x35, 0x7c, 0x5d,
-        0xce, 0xef, 0x43, 0x98, 0xa6, 0x6e, 0x82, 0x32, 0x73, 0x7d, 0xd4, 0x23, 0x9a, 0xda, 0x2d, 0x60,
-        0xfd, 0x63, 0xc0, 0xe2, 0xd9, 0x93, 0x7b, 0xe3, 0x4d, 0x58, 0xc2, 0xa8, 0x7a, 0xb5, 0xe5, 0x4a,
-        0x55, 0x54, 0xdc, 0x10, 0xfd, 0x48, 0x51, 0x54, 0xfd, 0xeb, 0xb0, 0x98, 0x54, 0x26, 0x78, 0x86,
-        0x42, 0x31, 0xac, 0x47, 0xdb, 0x41, 0x9a, 0x49, 0x0d, 0xdb, 0x49, 0x59, 0x7f, 0xc0, 0xfc, 0x4a,
-        0xf0, 0x5b, 0xf4, 0xd5, 0xf7, 0x3c, 0x0d, 0x59, 0x44, 0x4e, 0xa0, 0x7f, 0xcb, 0x3d, 0x6a, 0xac,
-        0xfa, 0x6b, 0x73, 0x37, 0x6f, 0x6f, 0xd7, 0x25, 0xf7, 0xec, 0x22, 0x43, 0x3e, 0x83, 0xb1, 0x2a,
-        0x4d, 0x41, 0xdf, 0x50, 0x73, 0x77, 0xd4, 0x31, 0xc5, 0x32, 0x61, 0xd7, 0x0c, 0xeb, 0xb1, 0x07,
-        0x07, 0x4f, 0x9d, 0xb2, 0x71, 0x00, 0xe3, 0x6d, 0x3c, 0xb2, 0xf7, 0x4a, 0x8f, 0x3c, 0x87, 0x79,
-        0xed, 0x7d, 0x8e, 0xf6, 0xed, 0xfe, 0x8b, 0x46, 0x39, 0x93, 0xdd, 0x37, 0x79, 0x01, 0x87, 0x1d,
-        0xfb, 0x73, 0x3a, 0xbe, 0xff, 0x82, 0x63, 0x2e, 0xbc, 0x67, 0xf3, 0xfc, 0x1a, 0x66, 0x95, 0x27,
-        0x95, 0x1d, 0x86, 0x2f, 0xd9, 0x97, 0x19, 0xb5, 0x81, 0x37, 0xd2, 0x7f, 0x66, 0x67, 0xff, 0x05,
-        0x00, 0x00, 0xff, 0xff, 0x1e, 0xac, 0x47, 0x5b, 0x0f, 0x07, 0x00, 0x00,
+        // 922 bytes of a gzipped FileDescriptorProto
+        0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xac, 0x56, 0x5d, 0x8f, 0xdb, 0x44,
+        0x14, 0xc5, 0x71, 0xbe, 0x7c, 0xbd, 0xbb, 0x49, 0x47, 0xb0, 0x72, 0x2b, 0x4a, 0x83, 0x1f, 0x4a,
+        0x44, 0x21, 0x91, 0x52, 0x90, 0x90, 0xfa, 0x50, 0x05, 0x76, 0x41, 0xf4, 0xa1, 0x54, 0x93, 0x45,
+        0x15, 0x4f, 0x91, 0x63, 0xdf, 0x78, 0xa7, 0xeb, 0x78, 0xac, 0x99, 0x71, 0x29, 0xef, 0x48, 0x48,
+        0xbc, 0xf0, 0x3f, 0xf8, 0x65, 0xfc, 0x0c, 0x34, 0xe3, 0xf1, 0xc7, 0xae, 0xe8, 0xaa, 0x20, 0x5e,
+        0xa2, 0xb9, 0xf7, 0x9e, 0x3b, 0x33, 0x3e, 0x67, 0xe6, 0x4c, 0xe0, 0x69, 0xca, 0xd4, 0x65, 0xb9,
+        0x5b, 0xc4, 0xfc, 0xb0, 0xcc, 0xca, 0x98, 0x99, 0x9f, 0xcf, 0x53, 0xbe, 0x94, 0xf1, 0x25, 0x26,
+        0x65, 0x86, 0x62, 0x19, 0x15, 0x05, 0xe6, 0x29, 0xcb, 0x71, 0x79, 0x40, 0x29, 0xa3, 0x14, 0xe5,
+        0x32, 0x16, 0x3c, 0x5f, 0x14, 0x82, 0x2b, 0x4e, 0xc6, 0x75, 0x32, 0xbc, 0x02, 0x77, 0x1d, 0x67,
+        0xe4, 0x21, 0xf4, 0x05, 0xcf, 0x30, 0x70, 0x66, 0xce, 0xfc, 0x64, 0x45, 0x16, 0x75, 0x7d, 0xb1,
+        0x8e, 0xb3, 0x05, 0xe5, 0x19, 0x52, 0x53, 0x27, 0xf7, 0x01, 0x52, 0x11, 0xe5, 0x0a, 0x93, 0xad,
+        0xe2, 0x41, 0x6f, 0xe6, 0xcc, 0x3d, 0xea, 0xd9, 0xcc, 0x05, 0x0f, 0xef, 0x43, 0x5f, 0x83, 0x09,
+        0xc0, 0x90, 0x9e, 0xaf, 0xcf, 0xce, 0xe9, 0xf4, 0x3d, 0xe2, 0xc1, 0xe0, 0x87, 0x97, 0xcf, 0xcf,
+        0xe9, 0xd4, 0x09, 0x9f, 0xc2, 0x70, 0x1d, 0x67, 0x1b, 0x54, 0x84, 0x40, 0x3f, 0x8f, 0x0e, 0xd5,
+        0x7a, 0x1e, 0x35, 0x63, 0xf2, 0x31, 0xf4, 0xa3, 0x38, 0x93, 0x41, 0x6f, 0xe6, 0xce, 0xfd, 0xd5,
+        0xf1, 0xb5, 0x3d, 0x50, 0x53, 0x0a, 0x7f, 0x73, 0xc1, 0x7d, 0xc6, 0x77, 0xe4, 0x04, 0x7a, 0x2c,
+        0xb1, 0xcd, 0x3d, 0x96, 0x90, 0x7b, 0x30, 0xae, 0x3f, 0xdd, 0x6e, 0xaa, 0x89, 0x75, 0x2d, 0x61,
+        0x32, 0xda, 0x65, 0x98, 0x04, 0xee, 0xcc, 0x99, 0x8f, 0x69, 0x13, 0x93, 0xcf, 0xa0, 0xaf, 0x22,
+        0x79, 0x15, 0xf4, 0x67, 0xce, 0xdc, 0x5f, 0x05, 0xed, 0x92, 0x17, 0x91, 0xbc, 0x3a, 0xc3, 0xfd,
+        0x4b, 0xa1, 0x79, 0x14, 0xd4, 0xa0, 0x9a, 0x0d, 0x0e, 0xde, 0xba, 0x41, 0x72, 0x17, 0xc6, 0x51,
+        0x9c, 0x6d, 0x25, 0x2a, 0x19, 0x0c, 0x67, 0xee, 0xdc, 0xa3, 0xa3, 0xc8, 0x7c, 0xb1, 0xd4, 0x14,
+        0xe7, 0x9c, 0x17, 0x41, 0x62, 0xd6, 0xea, 0x50, 0xfc, 0x9c, 0xf3, 0x42, 0xaf, 0x47, 0x4d, 0x9d,
+        0x3c, 0x06, 0xaf, 0x14, 0xd9, 0x76, 0x8f, 0x2a, 0xbe, 0x0c, 0xd0, 0x80, 0x4f, 0x5b, 0xf0, 0x8f,
+        0x22, 0xfb, 0x56, 0x57, 0x4c, 0xc3, 0xb8, 0xb4, 0x11, 0x59, 0xc1, 0x58, 0xfe, 0x1c, 0x89, 0x03,
+        0xcb, 0xd3, 0x60, 0x7f, 0xb3, 0x67, 0x63, 0x2b, 0x55, 0x4f, 0x8d, 0x23, 0x4f, 0xc0, 0xdf, 0x95,
+        0x2c, 0x4b, 0x76, 0x65, 0x7c, 0x85, 0x2a, 0x48, 0x4d, 0xdb, 0xdd, 0xb6, 0xed, 0xeb, 0xb6, 0x68,
+        0x3a, 0xbb, 0xe8, 0xf0, 0x2f, 0x07, 0x46, 0x17, 0x82, 0xa5, 0x29, 0x8a, 0xff, 0x4d, 0x8d, 0x9a,
+        0xdf, 0xfe, 0xbb, 0xf1, 0x3b, 0xf8, 0x6f, 0xfc, 0x2e, 0x61, 0x94, 0x32, 0xc5, 0x32, 0x94, 0x96,
+        0xdd, 0x0f, 0x5a, 0xe8, 0x77, 0x55, 0xc1, 0xa0, 0x6b, 0x54, 0x08, 0x30, 0xae, 0xa7, 0x08, 0xbf,
+        0x04, 0xbf, 0x83, 0xd1, 0xc7, 0x58, 0x60, 0xc1, 0xeb, 0x63, 0xac, 0xc7, 0x55, 0x6e, 0x5f, 0x1d,
+        0x63, 0x93, 0xdb, 0xcb, 0xf0, 0x27, 0x38, 0xea, 0x0a, 0x47, 0x4e, 0x61, 0x78, 0x40, 0x75, 0xc9,
+        0x6b, 0xd6, 0x6c, 0x44, 0xa6, 0xe0, 0x96, 0x22, 0xb3, 0xa4, 0xe9, 0x21, 0x79, 0x00, 0xbe, 0x62,
+        0x07, 0xe4, 0xa5, 0xda, 0x4a, 0x8c, 0x0d, 0x65, 0x03, 0x0a, 0x36, 0xb5, 0xc1, 0x38, 0xfc, 0xb5,
+        0x0f, 0x47, 0x5d, 0x81, 0xf5, 0xdc, 0x12, 0xc5, 0x6b, 0x14, 0xf5, 0xdc, 0x55, 0x44, 0x02, 0x18,
+        0xc5, 0xfc, 0x70, 0x88, 0xf2, 0xc4, 0x6e, 0xad, 0x0e, 0xc9, 0x39, 0x1c, 0x31, 0xc9, 0xb3, 0x48,
+        0xdf, 0x6a, 0x81, 0x7b, 0xb3, 0x88, 0xbf, 0x0a, 0xff, 0xf9, 0x00, 0x2d, 0xbe, 0xb7, 0x50, 0x8a,
+        0x7b, 0xea, 0xb3, 0x36, 0xd0, 0xde, 0x80, 0x6f, 0x94, 0x88, 0xb6, 0x91, 0x48, 0x2b, 0x11, 0x3d,
+        0xea, 0x99, 0xcc, 0x5a, 0xa4, 0x52, 0x7f, 0x1b, 0xe6, 0xaf, 0xad, 0x6a, 0x7a, 0x48, 0x3e, 0x02,
+        0x48, 0xd8, 0x01, 0x73, 0xc9, 0x78, 0x5e, 0x5f, 0x97, 0x4e, 0x46, 0x33, 0xa9, 0xa2, 0x54, 0x06,
+        0xa3, 0x8a, 0x49, 0x3d, 0xd6, 0xe7, 0xa7, 0x10, 0x8c, 0x0b, 0xa6, 0x7e, 0x09, 0xc6, 0x86, 0x8c,
+        0x26, 0x26, 0x5f, 0xc0, 0x29, 0xbe, 0xc1, 0xb8, 0x54, 0x8c, 0xe7, 0xdb, 0x0e, 0x6b, 0x32, 0xf0,
+        0x0c, 0xf2, 0xfd, 0xa6, 0x7a, 0xd1, 0xf0, 0x27, 0xc9, 0xa7, 0x70, 0x27, 0x15, 0x51, 0x8c, 0xdb,
+        0x02, 0x05, 0xe3, 0x49, 0xd5, 0x00, 0xa6, 0x61, 0x62, 0x0a, 0x2f, 0x4c, 0xde, 0x60, 0x1f, 0xc2,
+        0x84, 0xf1, 0xeb, 0x53, 0xfb, 0x06, 0x79, 0xcc, 0x78, 0x67, 0xce, 0x7b, 0x05, 0xf8, 0x1d, 0x9a,
+        0xf4, 0xa6, 0x6b, 0xa2, 0xac, 0x28, 0x4d, 0x4c, 0x3e, 0x81, 0x49, 0x43, 0xbe, 0xd5, 0xad, 0x92,
+        0xff, 0xa4, 0x4e, 0x6f, 0x2a, 0xfd, 0x3e, 0x04, 0x4f, 0xdb, 0xa4, 0x2c, 0xa2, 0x18, 0x8d, 0x44,
+        0x1e, 0x6d, 0x13, 0xe1, 0x1f, 0x0e, 0x4c, 0x6e, 0x5c, 0xd8, 0xb7, 0x9e, 0x84, 0x53, 0x18, 0xda,
+        0x3b, 0x5f, 0xad, 0x64, 0x23, 0x7d, 0x42, 0xcc, 0x15, 0x47, 0x61, 0xe7, 0xaf, 0x43, 0xad, 0x54,
+        0x21, 0x78, 0x81, 0x42, 0x31, 0xac, 0xa5, 0xed, 0x64, 0x1a, 0xa5, 0x06, 0xad, 0x52, 0xe1, 0xef,
+        0x0e, 0x1c, 0xbf, 0x10, 0xfc, 0x15, 0xc6, 0xea, 0x1b, 0x9e, 0xef, 0x59, 0x4a, 0x1e, 0x80, 0xfb,
+        0x8a, 0xef, 0x02, 0xe7, 0xe6, 0xf5, 0x7e, 0xc6, 0x77, 0x54, 0x57, 0xc8, 0x23, 0x18, 0xa9, 0xca,
+        0x53, 0xec, 0x23, 0x70, 0xa7, 0xe3, 0xc8, 0x55, 0x81, 0xd6, 0x08, 0xf2, 0xa8, 0x63, 0x05, 0xae,
+        0x41, 0x4f, 0xaf, 0x39, 0xc6, 0x06, 0x55, 0x63, 0x0e, 0xe1, 0x9f, 0x3d, 0x38, 0xb9, 0xee, 0xe9,
+        0x8d, 0x5f, 0x38, 0xff, 0xc6, 0x8f, 0x7b, 0xef, 0xe8, 0xc7, 0x4f, 0xe0, 0xb8, 0xf6, 0xd9, 0xad,
+        0x79, 0x61, 0xdc, 0x5b, 0x4d, 0xf9, 0x48, 0x76, 0x6f, 0xf0, 0x19, 0x4c, 0x3b, 0x56, 0xbb, 0xed,
+        0xbc, 0x50, 0xb7, 0xb8, 0xf3, 0x64, 0x77, 0x43, 0xfd, 0xaf, 0xe0, 0xc8, 0x3a, 0x58, 0x35, 0xc3,
+        0xe0, 0x36, 0xb3, 0xf3, 0xd3, 0x36, 0xd8, 0x0d, 0xcd, 0x9f, 0x84, 0xc7, 0x7f, 0x07, 0x00, 0x00,
+        0xff, 0xff, 0x9f, 0x8d, 0xe3, 0xa2, 0x67, 0x08, 0x00, 0x00,
 }