resultpb

type Artifact struct {

	// Can be used to refer to this artifact.
	// Format:
	//   - For invocation-level artifacts:
	//     "invocations/{INVOCATION_ID}/artifacts/{ARTIFACT_ID}".
	//   - For test-result-level artifacts:
	//     "invocations/{INVOCATION_ID}/tests/{URL_ESCAPED_TEST_ID}/results/{RESULT_ID}/artifacts/{ARTIFACT_ID}".
	//
	// where URL_ESCAPED_TEST_ID is the test_id escaped with
	// https://golang.org/pkg/net/url/#PathEscape (see also https://aip.dev/122),
	// and ARTIFACT_ID is documented below.
	// Examples: "screenshot.png", "traces/a.txt".
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// A local identifier of the artifact, unique within the parent resource.
	// MAY have slashes, but MUST NOT start with a slash.
	// SHOULD not use backslashes.
	// Regex: ^(?:[[:word:]]|\.)([\p{L}\p{M}\p{N}\p{P}\p{S}\p{Zs}]{0,254}[[:word:]])?$
	ArtifactId string `protobuf:"bytes,2,opt,name=artifact_id,json=artifactId,proto3" json:"artifact_id,omitempty"`
	// A signed short-lived URL to fetch the contents of the artifact.
	// See also fetch_url_expiration.
	FetchUrl string `protobuf:"bytes,3,opt,name=fetch_url,json=fetchUrl,proto3" json:"fetch_url,omitempty"`
	// When fetch_url expires. If expired, re-request this Artifact.
	FetchUrlExpiration *timestamppb.Timestamp `protobuf:"bytes,4,opt,name=fetch_url_expiration,json=fetchUrlExpiration,proto3" json:"fetch_url_expiration,omitempty"`
	// Media type of the artifact.
	// Logs are typically "text/plain" and screenshots are typically "image/png".
	// Optional.
	ContentType string `protobuf:"bytes,5,opt,name=content_type,json=contentType,proto3" json:"content_type,omitempty"`
	// Size of the file.
	// Can be used in UI to decide between displaying the artifact inline or only
	// showing a link if it is too large.
	// If you are using the gcs_uri, this field is not verified, but only treated as a hint.
	SizeBytes int64 `protobuf:"varint,6,opt,name=size_bytes,json=sizeBytes,proto3" json:"size_bytes,omitempty"`
	// Contents of the artifact.
	// This is INPUT_ONLY, and taken by BatchCreateArtifacts().
	// All getter RPCs, such as ListArtifacts(), do not populate values into
	// the field in the response.
	// If specified, `gcs_uri` must be empty.
	Contents []byte `protobuf:"bytes,7,opt,name=contents,proto3" json:"contents,omitempty"`
	// The GCS URI of the artifact if it's stored in GCS.  If specified, `contents` must be empty.
	GcsUri string `protobuf:"bytes,8,opt,name=gcs_uri,json=gcsUri,proto3" json:"gcs_uri,omitempty"`
	// Status of the test result that the artifact belongs to.
	// This is only applicable for test-level artifacts, not invocation-level artifacts.
	// We need this field because when an artifact is created (for example, with BatchCreateArtifact),
	// the containing test result may or may not be created yet, as they
	// are created in different channels from result sink.
	// Having the test status here allows setting the correct status of artifact in BigQuery.
	TestStatus TestStatus `protobuf:"varint,9,opt,name=test_status,json=testStatus,proto3,enum=luci.resultdb.v1.TestStatus" json:"test_status,omitempty"`
	// contains filtered or unexported fields
}

type ArtifactPredicate struct {

	// Specifies which edges to follow when retrieving directly/indirectly
	// included artifacts.
	// For example,
	//   - to retrieve only invocation-level artifacts, use
	//     {included_invocations: true}.
	//   - to retrieve only test-result-level artifacts, use {test_results: true}.
	//
	// By default, follows all edges.
	FollowEdges *ArtifactPredicate_EdgeTypeSet `protobuf:"bytes,1,opt,name=follow_edges,json=followEdges,proto3" json:"follow_edges,omitempty"` // defaults to All.
	// If an Artifact belongs to a TestResult, then the test result must satisfy
	// this predicate.
	// Note: this predicate does NOT apply to invocation-level artifacts.
	// To exclude them from the response, use follow_edges.
	TestResultPredicate *TestResultPredicate `protobuf:"bytes,2,opt,name=test_result_predicate,json=testResultPredicate,proto3" json:"test_result_predicate,omitempty"`
	// An artifact must have a content type matching this regular expression
	// entirely, i.e. the expression is implicitly wrapped with ^ and $.
	// Defaults to ".*".
	ContentTypeRegexp string `protobuf:"bytes,3,opt,name=content_type_regexp,json=contentTypeRegexp,proto3" json:"content_type_regexp,omitempty"`
	// An artifact must have an ID matching this regular expression entirely, i.e.
	// the expression is implicitly wrapped with ^ and $.  Defaults to ".*".
	ArtifactIdRegexp string `protobuf:"bytes,4,opt,name=artifact_id_regexp,json=artifactIdRegexp,proto3" json:"artifact_id_regexp,omitempty"`
	// contains filtered or unexported fields
}

type ArtifactPredicate_EdgeTypeSet struct {

	// The edges represented by Invocation.included_invocations field.
	IncludedInvocations bool `protobuf:"varint,1,opt,name=included_invocations,json=includedInvocations,proto3" json:"included_invocations,omitempty"`
	// The parent-child relationship between Invocation and TestResult.
	TestResults bool `protobuf:"varint,2,opt,name=test_results,json=testResults,proto3" json:"test_results,omitempty"`
	// contains filtered or unexported fields
}

type BatchCreateArtifactsRequest struct {

	// Requests to create Artifacts.
	// The sum of the content lengths MUST be <= 10MiB.
	// The parents of all the requests must be derived from the same invocation.
	//
	// Up to 500 requests.
	Requests []*CreateArtifactRequest `protobuf:"bytes,2,rep,name=requests,proto3" json:"requests,omitempty"`
	// contains filtered or unexported fields
}

type BatchCreateArtifactsResponse struct {

	// Artifacts created.
	Artifacts []*Artifact `protobuf:"bytes,1,rep,name=artifacts,proto3" json:"artifacts,omitempty"`
	// contains filtered or unexported fields
}

type BatchCreateInvocationsRequest struct {

	// requests[i].request_id MUST be either empty or equal to request_id in
	// this message.
	//
	// Up to 500 requests.
	Requests []*CreateInvocationRequest `protobuf:"bytes,1,rep,name=requests,proto3" json:"requests,omitempty"`
	// A unique identifier for this request. Restricted to 36 ASCII characters.
	// A random UUID is recommended.
	// This request is only idempotent if a `request_id` is provided, so it is
	// strongly recommended to populate this field.
	RequestId string `protobuf:"bytes,2,opt,name=request_id,json=requestId,proto3" json:"request_id,omitempty"`
	// contains filtered or unexported fields
}

type BatchCreateInvocationsResponse struct {

	// Invocations created.
	Invocations []*Invocation `protobuf:"bytes,1,rep,name=invocations,proto3" json:"invocations,omitempty"`
	// One token per each created invocation.
	// These are passed in the response instead of as metadata, because large
	// batches increase the size of the response headers beyond allowed limits and
	// cause failures like crbug.com/1064496
	// update_tokens[i] corresponds to invocations[i].
	// *Do not log these values*.
	UpdateTokens []string `protobuf:"bytes,2,rep,name=update_tokens,json=updateTokens,proto3" json:"update_tokens,omitempty"`
	// contains filtered or unexported fields
}

type BatchCreateTestExonerationsRequest struct {

	// Name of the parent invocation, see Invocation.name.
	Invocation string `protobuf:"bytes,1,opt,name=invocation,proto3" json:"invocation,omitempty"`
	// Requests to create TestExonerations.
	// requests[i].invocation MUST be either empty or equal to invocation in this
	// message.
	// requests[i].request_id MUST be either empty or equal to request_id in
	// this message.
	//
	// Up to 500 requests.
	Requests []*CreateTestExonerationRequest `protobuf:"bytes,2,rep,name=requests,proto3" json:"requests,omitempty"`
	// A unique identifier for this request. Restricted to 36 ASCII characters.
	// A random UUID is recommended.
	// This request is only idempotent if a `request_id` is provided, so it is
	// strongly recommended to populate this field.
	RequestId string `protobuf:"bytes,3,opt,name=request_id,json=requestId,proto3" json:"request_id,omitempty"`
	// contains filtered or unexported fields
}

type BatchCreateTestExonerationsResponse struct {

	// Test exonerations created.
	TestExonerations []*TestExoneration `protobuf:"bytes,1,rep,name=test_exonerations,json=testExonerations,proto3" json:"test_exonerations,omitempty"`
	// contains filtered or unexported fields
}

type BatchCreateTestResultsRequest struct {

	// Name of the parent invocation, see Invocation.name.
	Invocation string `protobuf:"bytes,1,opt,name=invocation,proto3" json:"invocation,omitempty"`
	// Requests to create test results.
	// requests[i].invocation MUST be either empty or equal to invocation in this
	// message.
	// requests[i].request_id MUST be either empty or equal to request_id in
	// this message.
	//
	// Up to 500 requests.
	Requests []*CreateTestResultRequest `protobuf:"bytes,2,rep,name=requests,proto3" json:"requests,omitempty"`
	// A unique identifier for this request. Restricted to 36 ASCII characters.
	// A random UUID is recommended.
	// This request is only idempotent if a `request_id` is provided, so it is
	// strongly recommended to populate this field.
	RequestId string `protobuf:"bytes,3,opt,name=request_id,json=requestId,proto3" json:"request_id,omitempty"`
	// contains filtered or unexported fields
}

type BatchCreateTestResultsResponse struct {

	// Test results created.
	TestResults []*TestResult `protobuf:"bytes,1,rep,name=test_results,json=testResults,proto3" json:"test_results,omitempty"`
	// contains filtered or unexported fields
}

type BatchGetTestVariantsRequest struct {

	// Name of the invocation that the test variants are in.
	Invocation string `protobuf:"bytes,1,opt,name=invocation,proto3" json:"invocation,omitempty"`
	// A list of test IDs and variant hashes, identifying the requested test
	// variants. Size is limited to 500. Any request for more than 500 variants
	// will return an error.
	TestVariants []*BatchGetTestVariantsRequest_TestVariantIdentifier `protobuf:"bytes,2,rep,name=test_variants,json=testVariants,proto3" json:"test_variants,omitempty"`
	// The maximum number of test results to be included in a test variant.
	//
	// If a test variant has more results than the limit, the remaining results
	// will not be returned.
	// If unspecified, at most 10 results will be included in a test variant.
	// The maximum value is 100; values above 100 will be coerced to 100.
	ResultLimit int32 `protobuf:"varint,3,opt,name=result_limit,json=resultLimit,proto3" json:"result_limit,omitempty"`
	// contains filtered or unexported fields
}

type BatchGetTestVariantsRequest_TestVariantIdentifier struct {

	// The unique identifier of the test in a LUCI project. See the comment on
	// TestResult.test_id for full documentation.
	TestId string `protobuf:"bytes,1,opt,name=test_id,json=testId,proto3" json:"test_id,omitempty"`
	// Hash of the variant. See the comment on TestResult.variant_hash for full
	// documentation.
	VariantHash string `protobuf:"bytes,2,opt,name=variant_hash,json=variantHash,proto3" json:"variant_hash,omitempty"`
	// contains filtered or unexported fields
}

type BatchGetTestVariantsResponse struct {

	// Test variants matching the requests. Any variants that weren't found are
	// omitted from the response. Clients shouldn't rely on the ordering of this
	// field, as no particular order is guaranteed.
	TestVariants []*TestVariant `protobuf:"bytes,1,rep,name=test_variants,json=testVariants,proto3" json:"test_variants,omitempty"`
	// The code sources tested by the returned test variants. The sources are keyed
	// by an ID which allows them to be cross-referenced from TestVariant.sources_id.
	//
	// The sources are returned via this map instead of directly on the TestVariant
	// to avoid excessive response size. Each source message could be up to a few
	// kilobytes and there are usually no more than a handful of different sources
	// tested in an invocation, so deduplicating them here reduces response size.
	Sources map[string]*Sources `` /* 155-byte string literal not displayed */
	// contains filtered or unexported fields
}

type BigQueryExport struct {

	// Name of the BigQuery project.
	Project string `protobuf:"bytes,1,opt,name=project,proto3" json:"project,omitempty"`
	// Name of the BigQuery Dataset.
	Dataset string `protobuf:"bytes,2,opt,name=dataset,proto3" json:"dataset,omitempty"`
	// Name of the BigQuery Table.
	Table string `protobuf:"bytes,3,opt,name=table,proto3" json:"table,omitempty"`
	// Types that are assignable to ResultType:
	//
	//	*BigQueryExport_TestResults_
	//	*BigQueryExport_TextArtifacts_
	ResultType isBigQueryExport_ResultType `protobuf_oneof:"result_type"`
	// contains filtered or unexported fields
}

type BigQueryExport_TestResults struct {

	// Use predicate to query test results that should be exported to
	// BigQuery table.
	Predicate *TestResultPredicate `protobuf:"bytes,1,opt,name=predicate,proto3" json:"predicate,omitempty"`
	// contains filtered or unexported fields
}

type BigQueryExport_TestResults_ struct {
	TestResults *BigQueryExport_TestResults `protobuf:"bytes,4,opt,name=test_results,json=testResults,proto3,oneof"`
}

type BigQueryExport_TextArtifacts struct {

	// Use predicate to query artifacts that should be exported to
	// BigQuery table.
	//
	// Sub-field predicate.content_type_regexp defaults to "text/.*".
	Predicate *ArtifactPredicate `protobuf:"bytes,1,opt,name=predicate,proto3" json:"predicate,omitempty"`
	// contains filtered or unexported fields
}

type BigQueryExport_TextArtifacts_ struct {
	TextArtifacts *BigQueryExport_TextArtifacts `protobuf:"bytes,6,opt,name=text_artifacts,json=textArtifacts,proto3,oneof"`
}

type BugComponent struct {

	// Types that are assignable to System:
	//
	//	*BugComponent_IssueTracker
	//	*BugComponent_Monorail
	System isBugComponent_System `protobuf_oneof:"system"`
	// contains filtered or unexported fields
}

type BugComponent_IssueTracker struct {
	// The Google Issue Tracker component.
	IssueTracker *IssueTrackerComponent `protobuf:"bytes,1,opt,name=issue_tracker,json=issueTracker,proto3,oneof"`
}

type BugComponent_Monorail struct {
	// The monorail component.
	Monorail *MonorailComponent `protobuf:"bytes,2,opt,name=monorail,proto3,oneof"`
}

type CreateArtifactRequest struct {

	// Name of the parent resource where the artifact will be created.
	//
	// For invocation-level artifacts, it is the invocation name.
	// For test-result-level artifacts, it is the TestResult name.
	Parent string `protobuf:"bytes,1,opt,name=parent,proto3" json:"parent,omitempty"`
	// Artifact to upload.
	// The length of the artifact contents MUST be <= 512KiB.
	// artifact.artifact_id MUST be set.
	// artifact.name will be ignored.
	Artifact *Artifact `protobuf:"bytes,2,opt,name=artifact,proto3" json:"artifact,omitempty"`
	// contains filtered or unexported fields
}

type CreateInvocationRequest struct {

	// Invocation identifier, becomes a part of the invocation.name.
	// LUCI systems MAY create invocations with nicely formatted IDs, such as
	// "build-1234567890". All other clients MUST use GUIDs.
	//
	// Regex: ^[a-z][a-z0-9_\-]*$.
	InvocationId string `protobuf:"bytes,1,opt,name=invocation_id,json=invocationId,proto3" json:"invocation_id,omitempty"`
	// Invocation data to insert.
	Invocation *Invocation `protobuf:"bytes,2,opt,name=invocation,proto3" json:"invocation,omitempty"`
	// A unique identifier for this request. Restricted to 36 ASCII characters.
	// A random UUID is recommended.
	// This request is only idempotent if a `request_id` is provided.
	RequestId string `protobuf:"bytes,3,opt,name=request_id,json=requestId,proto3" json:"request_id,omitempty"`
	// contains filtered or unexported fields
}

type CreateTestExonerationRequest struct {

	// Name of the parent invocation, see Invocation.name.
	Invocation string `protobuf:"bytes,1,opt,name=invocation,proto3" json:"invocation,omitempty"`
	// The TestExoneration to create.
	TestExoneration *TestExoneration `protobuf:"bytes,2,opt,name=test_exoneration,json=testExoneration,proto3" json:"test_exoneration,omitempty"`
	// A unique identifier for this request. Restricted to 36 ASCII characters.
	// A random UUID is recommended.
	// This request is only idempotent if a `request_id` is provided.
	RequestId string `protobuf:"bytes,3,opt,name=request_id,json=requestId,proto3" json:"request_id,omitempty"`
	// contains filtered or unexported fields
}

type CreateTestResultRequest struct {

	// Name of the parent invocation, see Invocation.name.
	Invocation string `protobuf:"bytes,1,opt,name=invocation,proto3" json:"invocation,omitempty"`
	// The test result to create.
	// Test id and result id are used to dedupe requests, i.e.
	// if a test result with the same test id and result id already exists in
	// the invocation, then the requests succeeds as opposed to returns with
	// ALREADY_EXISTS error.
	TestResult *TestResult `protobuf:"bytes,2,opt,name=test_result,json=testResult,proto3" json:"test_result,omitempty"`
	// A unique identifier for this request. Restricted to 36 ASCII characters.
	// A random UUID is recommended.
	// This request is only idempotent if a `request_id` is provided, so it is
	// strongly recommended to populate this field.
	//
	// Impl note: this field is used to compute the spanner-level result id, which
	// will encode tuple (request_id, index_of_request)", where
	//   - request_id is a random GUID if not provided by the user
	//   - index_of_request is 0 in CreateTestResult RPC, or index of the request
	//     in BatchCreateTestResultsRequest in the batch RPC.
	//
	// TODO(jchinlee): remove this impl note when it is converted into code.
	RequestId string `protobuf:"bytes,3,opt,name=request_id,json=requestId,proto3" json:"request_id,omitempty"`
	// contains filtered or unexported fields
}

type DecoratedRecorder struct {
	// Service is the service to decorate.
	Service RecorderServer
	// Prelude is called for each method before forwarding the call to Service.
	// If Prelude returns an error, then the call is skipped and the error is
	// processed via the Postlude (if one is defined), or it is returned directly.
	Prelude func(ctx context.Context, methodName string, req proto.Message) (context.Context, error)
	// Postlude is called for each method after Service has processed the call, or
	// after the Prelude has returned an error. This takes the Service's
	// response proto (which may be nil) and/or any error. The decorated
	// service will return the response (possibly mutated) and error that Postlude
	// returns.
	Postlude func(ctx context.Context, methodName string, rsp proto.Message, err error) error
}

type DecoratedResultDB struct {
	// Service is the service to decorate.
	Service ResultDBServer
	// Prelude is called for each method before forwarding the call to Service.
	// If Prelude returns an error, then the call is skipped and the error is
	// processed via the Postlude (if one is defined), or it is returned directly.
	Prelude func(ctx context.Context, methodName string, req proto.Message) (context.Context, error)
	// Postlude is called for each method after Service has processed the call, or
	// after the Prelude has returned an error. This takes the Service's
	// response proto (which may be nil) and/or any error. The decorated
	// service will return the response (possibly mutated) and error that Postlude
	// returns.
	Postlude func(ctx context.Context, methodName string, rsp proto.Message, err error) error
}

type ExonerationReason int32

type FailureReason struct {

	// The error message that ultimately caused the test to fail. This should
	// only be the error message and should not include any stack traces.
	// An example would be the message from an Exception in a Java test.
	// In the case that a test failed due to multiple expectation failures, any
	// immediately fatal failure should be chosen, or otherwise the first
	// expectation failure.
	// If this field is empty, other fields (including those from the TestResult)
	// may be used to cluster the failure instead.
	//
	// The size of the message must be equal to or smaller than 1024 bytes in
	// UTF-8.
	PrimaryErrorMessage string `protobuf:"bytes,1,opt,name=primary_error_message,json=primaryErrorMessage,proto3" json:"primary_error_message,omitempty"`
	// The error(s) that caused the test to fail.
	//
	// If there is more than one error (e.g. due to multiple expectation failures),
	// a stable sorting should be used. A recommended form of stable sorting is:
	//   - Fatal errors (errors that cause the test to terminate immediately first,
	//     then
	//   - Within fatal/non-fatal errors, sort by chronological order
	//     (earliest error first).
	//
	// Where this field is populated, errors[0].message shall match
	// primary_error_message.
	//
	// The total combined size of all errors (as measured by proto.Size()) must
	// not exceed 3,172 bytes.
	Errors []*FailureReason_Error `protobuf:"bytes,2,rep,name=errors,proto3" json:"errors,omitempty"`
	// The number of errors that are truncated from the errors list above due to
	// the size limits.
	TruncatedErrorsCount int32 `protobuf:"varint,3,opt,name=truncated_errors_count,json=truncatedErrorsCount,proto3" json:"truncated_errors_count,omitempty"`
	// contains filtered or unexported fields
}

type FailureReason_Error struct {

	// The error message. This should only be the error message and
	// should not include any stack traces. An example would be the
	// message from an Exception in a Java test.
	//
	// This message may be used to cluster related failures together.
	//
	// The size of the message must be equal to or smaller than 1024 bytes in
	// UTF-8.
	Message string `protobuf:"bytes,1,opt,name=message,proto3" json:"message,omitempty"`
	// contains filtered or unexported fields
}

type FinalizeInvocationRequest struct {

	// Name of the invocation to finalize.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// contains filtered or unexported fields
}

type GerritChange struct {

	// Gerrit hostname, e.g. "chromium-review.googlesource.com".
	Host string `protobuf:"bytes,1,opt,name=host,proto3" json:"host,omitempty"`
	// Gerrit project, e.g. "chromium/src".
	Project string `protobuf:"bytes,2,opt,name=project,proto3" json:"project,omitempty"`
	// Change number, e.g. 12345.
	Change int64 `protobuf:"varint,3,opt,name=change,proto3" json:"change,omitempty"`
	// Patch set number, e.g. 1.
	Patchset int64 `protobuf:"varint,4,opt,name=patchset,proto3" json:"patchset,omitempty"`
	// contains filtered or unexported fields
}

type GetArtifactRequest struct {

	// The name of the artifact to request, see Artifact.name.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// contains filtered or unexported fields
}

type GetInvocationRequest struct {

	// The name of the invocation to request, see Invocation.name.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// contains filtered or unexported fields
}

type GetTestExonerationRequest struct {

	// The name of the test exoneration to request, see TestExoneration.name.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// contains filtered or unexported fields
}

type GetTestResultRequest struct {

	// The name of the test result to request, see TestResult.name.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// contains filtered or unexported fields
}

type GitilesCommit struct {

	// The identity of the gitiles host, e.g. "chromium.googlesource.com".
	// Mandatory.
	Host string `protobuf:"bytes,1,opt,name=host,proto3" json:"host,omitempty"`
	// Repository name on the host, e.g. "chromium/src". Mandatory.
	Project string `protobuf:"bytes,2,opt,name=project,proto3" json:"project,omitempty"`
	// Commit ref, e.g. "refs/heads/main" from which the commit was fetched.
	// Not the branch name, use "refs/heads/branch"
	// Mandatory.
	Ref string `protobuf:"bytes,3,opt,name=ref,proto3" json:"ref,omitempty"`
	// Commit HEX SHA1. All lowercase. Mandatory.
	CommitHash string `protobuf:"bytes,4,opt,name=commit_hash,json=commitHash,proto3" json:"commit_hash,omitempty"`
	// Defines a total order of commits on the ref.
	// A positive, monotonically increasing integer. The recommended
	// way of obtaining this is by using the goto.google.com/git-numberer
	// Gerrit plugin. Other solutions can be used as well, so long
	// as the same scheme is used consistently for a ref.
	// Mandatory.
	Position int64 `protobuf:"varint,5,opt,name=position,proto3" json:"position,omitempty"`
	// contains filtered or unexported fields
}

type GitilesRef struct {

	// The gitiles host, e.g. "chromium.googlesource.com".
	Host string `protobuf:"bytes,1,opt,name=host,proto3" json:"host,omitempty"`
	// The project on the gitiles host, e.g. "chromium/src".
	Project string `protobuf:"bytes,2,opt,name=project,proto3" json:"project,omitempty"`
	// Commit ref, e.g. "refs/heads/main" from which the commit was fetched.
	// Not the branch name, use "refs/heads/branch"
	Ref string `protobuf:"bytes,3,opt,name=ref,proto3" json:"ref,omitempty"`
	// contains filtered or unexported fields
}

type HistoryOptions struct {

	// Set this to index the results by the containing invocation's create_time.
	UseInvocationTimestamp bool `` /* 130-byte string literal not displayed */
	// Set this to index by commit position.
	// It's up to the creator of the invocation to set this consistently over
	// time across the same test variant.
	Commit *CommitPosition `protobuf:"bytes,2,opt,name=commit,proto3" json:"commit,omitempty"`
	// contains filtered or unexported fields
}

type Instruction struct {

	// ID of the instruction, used for step instruction.
	// It is consumer-defined and is unique within the build-level invocation.
	// For test instruction, we will ignore this field.
	// Included invocation may have the same instruction id with the parent invocation.
	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// List of instruction for different targets.
	// There is at most 1 instruction per target.
	// If there is more than 1, an error will be returned.
	TargetedInstructions []*TargetedInstruction `protobuf:"bytes,2,rep,name=targeted_instructions,json=targetedInstructions,proto3" json:"targeted_instructions,omitempty"`
	// contains filtered or unexported fields
}

type InstructionDependency struct {

	// The build ID of the instruction being depended on.
	// This can be a build id or a templated string with placeholders.
	// Because test results instructions are stored in leaf invocation,
	// we can use placeholders to refer to the top-level build.
	// For example, "{{build_tags.parent_build_id}}" to refer to the parent build.
	// If not specified, assuming to be of the same build.
	// Limit: 100 bytes
	BuildId string `protobuf:"bytes,1,opt,name=build_id,json=buildId,proto3" json:"build_id,omitempty"`
	// The step name of the instruction being depended on.
	// If this is a nested step, this field should contain both
	// parent and child step names, separated by "|".
	// For example "parent_step_name|child_step_name".
	// Limit: 1024 bytes
	StepName string `protobuf:"bytes,2,opt,name=step_name,json=stepName,proto3" json:"step_name,omitempty"`
	// Optional: In case there are more than one step with the same name
	// in the build, the step_tag is used to select the exact step to depend on.
	// This have the same size limit as step tag, 256 bytes for the key,
	// and 1024 bytes for the value.
	StepTag *StringPair `protobuf:"bytes,3,opt,name=step_tag,json=stepTag,proto3" json:"step_tag,omitempty"`
	// contains filtered or unexported fields
}

type InstructionTarget int32

type Instructions struct {
	Instructions []*Instruction `protobuf:"bytes,1,rep,name=instructions,proto3" json:"instructions,omitempty"`
	// contains filtered or unexported fields
}

type Invocation struct {

	// Can be used to refer to this invocation, e.g. in ResultDB.GetInvocation
	// RPC.
	// Format: invocations/{INVOCATION_ID}
	// See also https://aip.dev/122.
	//
	// Output only.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Current state of the invocation.
	//
	// At creation time this can be set to FINALIZING e.g. if this invocation is
	// a simple wrapper of another and will itself not be modified.
	//
	// Otherwise this is an output only field.
	State Invocation_State `protobuf:"varint,2,opt,name=state,proto3,enum=luci.resultdb.v1.Invocation_State" json:"state,omitempty"`
	// When the invocation was created.
	// Output only.
	CreateTime *timestamppb.Timestamp `protobuf:"bytes,4,opt,name=create_time,json=createTime,proto3" json:"create_time,omitempty"`
	// Invocation-level string key-value pairs.
	// A key can be repeated.
	Tags []*StringPair `protobuf:"bytes,5,rep,name=tags,proto3" json:"tags,omitempty"`
	// When the invocation started to finalize, i.e. transitioned to FINALIZING
	// state. This means the invocation is immutable but directly or indirectly
	// included invocations may not be.
	//
	// Output only.
	FinalizeStartTime *timestamppb.Timestamp `protobuf:"bytes,19,opt,name=finalize_start_time,json=finalizeStartTime,proto3" json:"finalize_start_time,omitempty"`
	// When the invocation was finalized, i.e. transitioned to FINALIZED state.
	// If this field is set, implies that the invocation is finalized. This
	// means the invocation and directly or indirectly included invocations
	// are immutable.
	//
	// Output only.
	FinalizeTime *timestamppb.Timestamp `protobuf:"bytes,6,opt,name=finalize_time,json=finalizeTime,proto3" json:"finalize_time,omitempty"`
	// Timestamp when the invocation will be forcefully finalized.
	// Can be extended with UpdateInvocation until finalized.
	Deadline *timestamppb.Timestamp `protobuf:"bytes,7,opt,name=deadline,proto3" json:"deadline,omitempty"`
	// Names of invocations included into this one. Overall results of this
	// invocation is a UNION of results directly included into this invocation
	// and results from the included invocations, recursively.
	// For example, a Buildbucket build invocation may include invocations of its
	// child swarming tasks and represent overall result of the build,
	// encapsulating the internal structure of the build.
	//
	// The graph is directed.
	// There can be at most one edge between a given pair of invocations.
	// The shape of the graph does not matter. What matters is only the set of
	// reachable invocations. Thus cycles are allowed and are noop.
	//
	// QueryTestResults returns test results from the transitive closure of
	// invocations.
	//
	// This field can be set under Recorder.CreateInvocationsRequest to include
	// existing invocations at the moment of invocation creation.
	// New invocations created in the same batch (via
	// Recorder.BatchCreateInvocationsRequest) are also allowed.
	// Otherwise, this field is to be treated as Output only.
	//
	// To modify included invocations, use Recorder.UpdateIncludedInvocations in
	// all other cases.
	IncludedInvocations []string `protobuf:"bytes,8,rep,name=included_invocations,json=includedInvocations,proto3" json:"included_invocations,omitempty"`
	// Whether this invocation is a root of the invocation graph for export purposes.
	//
	// To help downstream systems (like LUCI Analysis) make sense of test results,
	// and gather overall context for a result, ResultDB data export is centered
	// around export roots.
	// The export roots typically represent a top-level buildbucket build, like a
	// postsubmit build or presubmit tryjob. Test results are only exported if
	// they are included from a root. They may be exported multiple times of they
	// are included by multiple roots (e.g. in case of re-used test results).
	// Re-used test results can be identified because the parent invocation of the
	// test result will be the same even though the export root will be different.
	//
	// N.B. Export roots do not affect legacy BigQuery exports configured by the
	// BigQueryExports field.
	IsExportRoot bool `protobuf:"varint,21,opt,name=is_export_root,json=isExportRoot,proto3" json:"is_export_root,omitempty"`
	// bigquery_exports indicates what BigQuery table(s) that results in this
	// invocation should export to.
	//
	// Legacy feature: Prefer to use LUCI Analysis exports instead.
	BigqueryExports []*BigQueryExport `protobuf:"bytes,9,rep,name=bigquery_exports,json=bigqueryExports,proto3" json:"bigquery_exports,omitempty"`
	// LUCI identity (e.g. "user:<email>") who created the invocation.
	// Typically, a LUCI service account (e.g.
	// "user:cr-buildbucket@appspot.gserviceaccount.com"), but can also be a user
	// (e.g. "user:johndoe@example.com").
	//
	// Output only.
	CreatedBy string `protobuf:"bytes,10,opt,name=created_by,json=createdBy,proto3" json:"created_by,omitempty"`
	// Full name of the resource that produced results in this invocation.
	// See also https://aip.dev/122#full-resource-names
	// Typical examples:
	// - Swarming task: "//chromium-swarm.appspot.com/tasks/deadbeef"
	// - Buildbucket build: "//cr-buildbucket.appspot.com/builds/1234567890".
	ProducerResource string `protobuf:"bytes,11,opt,name=producer_resource,json=producerResource,proto3" json:"producer_resource,omitempty"`
	// Realm that the invocation exists under.
	// See https://chromium.googlesource.com/infra/luci/luci-py/+/refs/heads/master/appengine/auth_service/proto/realms_config.proto
	Realm string `protobuf:"bytes,12,opt,name=realm,proto3" json:"realm,omitempty"`
	// Deprecated. Values specified here are ignored.
	HistoryOptions *HistoryOptions `protobuf:"bytes,13,opt,name=history_options,json=historyOptions,proto3" json:"history_options,omitempty"`
	// Arbitrary JSON object that contains structured, domain-specific properties
	// of the invocation.
	//
	// The serialized size must be <= 16 KB.
	Properties *structpb.Struct `protobuf:"bytes,14,opt,name=properties,proto3" json:"properties,omitempty"`
	// The code sources which were tested by this invocation.
	// This is used to index test results for test history, and for
	// related analyses (e.g. culprit analysis / changepoint analyses).
	//
	// The sources specified here applies only to:
	//   - the test results directly contained in this invocation, and
	//   - any directly included invocations which set their source_spec.inherit to
	//     true.
	//
	// Clients should be careful to ensure the uploaded source spec is consistent
	// between included invocations that upload the same test variants.
	// Verdicts are associated with the sources of *any* of their constituent
	// test results, so if there is inconsistency between included invocations,
	// the position of the verdict becomes not well defined.
	//
	// Note that the sources specified here are shared with included invocations
	// regardless of the realm of those included invocations.
	//
	// Attempting to update this field to a value other than its current value
	// after is_source_spec_final is set will generate an error.
	SourceSpec *SourceSpec `protobuf:"bytes,15,opt,name=source_spec,json=sourceSpec,proto3" json:"source_spec,omitempty"`
	// Whether the code sources specified by source_spec are final (immutable).
	//
	// To facilitate rapid export of invocations inheriting sources from this
	// invocation, this property should be set to true as soon as possible
	// after the invocation's sources are fixed. In most cases, clients
	// will want to set this property to true at the same time as they set
	// source_spec.
	//
	// This field is client owned. Consistent with https://google.aip.dev/129,
	// it will not be forced to true when the invocation starts to finalize, even
	// if its effective value will always be true at that point.
	IsSourceSpecFinal bool `protobuf:"varint,20,opt,name=is_source_spec_final,json=isSourceSpecFinal,proto3" json:"is_source_spec_final,omitempty"`
	// A user-specified baseline identifier that maps to a set of test variants.
	// Often, this will be the source that generated the test result, such as the
	// builder name for Chromium. For example, the baseline identifier may be
	// try:linux-rel. The supported syntax for a baseline identifier is
	// ^[a-z0-9\-_.]{1,100}:[a-zA-Z0-9\-_.\(\) ]{1,128}`$. This syntax was selected
	// to allow <buildbucket bucket name>:<buildbucket builder name> as a valid
	// baseline ID.
	// See go/src/go.chromium.org/luci/buildbucket/proto/builder_common.proto for
	// character lengths for buildbucket bucket name and builder name.
	//
	// Baselines are used to identify new tests; a subtraction between the set of
	// test variants for a baseline in the Baselines table and test variants from
	// a given invocation determines whether a test is new.
	//
	// The caller must have `resultdb.baselines.put` to be able to
	// modify this field.
	BaselineId string `protobuf:"bytes,16,opt,name=baseline_id,json=baselineId,proto3" json:"baseline_id,omitempty"`
	// Instruction for the invocation.
	// Only applicable to test results directly contained in this invocation,
	// i.e. it does not apply to test results in included invocations.
	TestInstruction *Instruction `protobuf:"bytes,17,opt,name=test_instruction,json=testInstruction,proto3" json:"test_instruction,omitempty"`
	// Instructions for the steps.
	// Only useful for a build-level invocation.
	// It contains all instructions of steps which belong to the build.
	StepInstructions *Instructions `protobuf:"bytes,18,opt,name=step_instructions,json=stepInstructions,proto3" json:"step_instructions,omitempty"`
	// contains filtered or unexported fields
}

type InvocationFinalizedNotification struct {

	// The name of the invocation that was finalized.
	// Format: invocations/{INVOCATION_ID}.
	Invocation string `protobuf:"bytes,1,opt,name=invocation,proto3" json:"invocation,omitempty"`
	// The LUCI realm that owns the invocation.
	// E.g. "chromium:ci".
	Realm string `protobuf:"bytes,2,opt,name=realm,proto3" json:"realm,omitempty"`
	// contains filtered or unexported fields
}

type InvocationReadyForExportNotification struct {

	// The export root with respect to which the export is occurring.
	//
	// Format: invocations/{ROOT_INVOCATION_ID}.
	RootInvocation string `protobuf:"bytes,1,opt,name=root_invocation,json=rootInvocation,proto3" json:"root_invocation,omitempty"`
	// The LUCI realm that owns the root invocation.
	RootInvocationRealm string `protobuf:"bytes,2,opt,name=root_invocation_realm,json=rootInvocationRealm,proto3" json:"root_invocation_realm,omitempty"`
	// The name of the ResultDB invocation included by root_invocation whose
	// immediate properties, test results and artifacts are now immutable
	// (in FINALIZING OR FINALIZED state). Note that child invocations included
	// by `invocation` may not yet be immutable.
	//
	// This may be equal to root_invocation, to indicate test results, artifacts
	// and properties immediately inside root_invocation are immutable and ready
	// for ingestion.
	//
	// Format: invocations/{INVOCATION_ID}.
	Invocation string `protobuf:"bytes,3,opt,name=invocation,proto3" json:"invocation,omitempty"`
	// The LUCI realm that owns `invocation`.
	InvocationRealm string `protobuf:"bytes,4,opt,name=invocation_realm,json=invocationRealm,proto3" json:"invocation_realm,omitempty"`
	// The resolved sources for `invocation`, if any.
	//
	// As sources may be inherited, the sources resolved for the same
	// invocation may vary between export roots. This typically occurs when
	// a project uses testing task deduplication, and the different sources
	// deduplicate to the same testing task as they compile to
	// byte-for-byte-identical testing artifacts.
	Sources *Sources `protobuf:"bytes,5,opt,name=sources,proto3" json:"sources,omitempty"`
	// contains filtered or unexported fields
}

type Invocation_State int32