v0

type BuildRequest struct {

	// Optional target scope: package path (e.g. "./handlers"), file, or empty for all.
	Target string `protobuf:"bytes,1,opt,name=target,proto3" json:"target,omitempty"`
	// selection is the authoritative structured scope. When present, runtimes
	// must apply it exactly or return an error; they must not broaden the build.
	Selection *ValidationSelection `protobuf:"bytes,2,opt,name=selection,proto3" json:"selection,omitempty"`
	// selection_id is required with selection and must be echoed only after the
	// runtime has honored the authoritative selection.
	SelectionId string `protobuf:"bytes,3,opt,name=selection_id,json=selectionId,proto3" json:"selection_id,omitempty"`
	// contains filtered or unexported fields
}

type BuildResponse struct {

	// status reports the lifecycle or operation status.
	Status *BuildStatus `protobuf:"bytes,1,opt,name=status,proto3" json:"status,omitempty"`
	// output is raw command, build, lint, or test output preserved for diagnostics.
	Output string `protobuf:"bytes,2,opt,name=output,proto3" json:"output,omitempty"`
	// requested_selection is the exact authoritative selection applied.
	RequestedSelection *ValidationSelection `protobuf:"bytes,3,opt,name=requested_selection,json=requestedSelection,proto3" json:"requested_selection,omitempty"`
	// selection_id echoes BuildRequest.selection_id after selection was honored.
	SelectionId string `protobuf:"bytes,4,opt,name=selection_id,json=selectionId,proto3" json:"selection_id,omitempty"`
	// contains filtered or unexported fields
}

type BuildStatus struct {

	// state is the machine-readable lifecycle state.
	State BuildStatus_Status `protobuf:"varint,1,opt,name=state,proto3,enum=codefly.services.runtime.v0.BuildStatus_Status" json:"state,omitempty"`
	// message is a human-readable status or diagnostic summary.
	Message string `protobuf:"bytes,2,opt,name=message,proto3" json:"message,omitempty"`
	// failure is the universal structured cause when state is ERROR.
	Failure *v0.Failure `protobuf:"bytes,3,opt,name=failure,proto3" json:"failure,omitempty"`
	// contains filtered or unexported fields
}

type BuildStatus_Status int32

type DesiredState struct {

	// stage is the next lifecycle stage the runtime should reach.
	Stage DesiredState_Stage `protobuf:"varint,1,opt,name=stage,proto3,enum=codefly.services.runtime.v0.DesiredState_Stage" json:"stage,omitempty"`
	// contains filtered or unexported fields
}

type DesiredState_Stage int32

type DestroyRequest struct {
	// contains filtered or unexported fields
}

type DestroyResponse struct {

	// status reports the lifecycle or operation status.
	Status *DestroyStatus `protobuf:"bytes,1,opt,name=status,proto3" json:"status,omitempty"`
	// contains filtered or unexported fields
}

type DestroyStatus struct {

	// state is the machine-readable lifecycle state.
	State DestroyStatus_Status `protobuf:"varint,1,opt,name=state,proto3,enum=codefly.services.runtime.v0.DestroyStatus_Status" json:"state,omitempty"`
	// message is a human-readable status or diagnostic summary.
	Message string `protobuf:"bytes,2,opt,name=message,proto3" json:"message,omitempty"`
	// failure is the universal structured cause when state is ERROR.
	Failure *v0.Failure `protobuf:"bytes,3,opt,name=failure,proto3" json:"failure,omitempty"`
	// contains filtered or unexported fields
}

type DestroyStatus_Status int32

type InformationRequest struct {
	// contains filtered or unexported fields
}

type InformationResponse struct {

	// desired_state is the next lifecycle transition requested by the orchestrator.
	DesiredState *DesiredState `protobuf:"bytes,1,opt,name=desired_state,json=desiredState,proto3" json:"desired_state,omitempty"`
	// load_status is the latest Load lifecycle status.
	LoadStatus *LoadStatus `protobuf:"bytes,2,opt,name=load_status,json=loadStatus,proto3" json:"load_status,omitempty"`
	// init_status is the latest Init lifecycle status.
	InitStatus *InitStatus `protobuf:"bytes,3,opt,name=init_status,json=initStatus,proto3" json:"init_status,omitempty"`
	// start_status is the latest Start lifecycle status.
	StartStatus *StartStatus `protobuf:"bytes,4,opt,name=start_status,json=startStatus,proto3" json:"start_status,omitempty"`
	// stop_status is the latest Stop lifecycle status.
	StopStatus *StopStatus `protobuf:"bytes,5,opt,name=stop_status,json=stopStatus,proto3" json:"stop_status,omitempty"`
	// destroy_status is the latest Destroy lifecycle status.
	DestroyStatus *DestroyStatus `protobuf:"bytes,6,opt,name=destroy_status,json=destroyStatus,proto3" json:"destroy_status,omitempty"`
	// test_status is the latest Test lifecycle status.
	TestStatus *TestStatus `protobuf:"bytes,7,opt,name=test_status,json=testStatus,proto3" json:"test_status,omitempty"`
	// build_status is the latest Build lifecycle status.
	BuildStatus *BuildStatus `protobuf:"bytes,8,opt,name=build_status,json=buildStatus,proto3" json:"build_status,omitempty"`
	// lint_status is the latest Lint lifecycle status.
	LintStatus *LintStatus `protobuf:"bytes,9,opt,name=lint_status,json=lintStatus,proto3" json:"lint_status,omitempty"`
	// contains filtered or unexported fields
}

type InitRequest struct {

	// runtime_context is the proposed execution environment for this service.
	RuntimeContext *v0.RuntimeContext `protobuf:"bytes,1,opt,name=runtime_context,json=runtimeContext,proto3" json:"runtime_context,omitempty"`
	// configuration is this service's own runtime configuration.
	Configuration *v0.Configuration `protobuf:"bytes,2,opt,name=configuration,proto3" json:"configuration,omitempty"`
	// proposed_network_mappings are logical-to-physical endpoint mappings suggested by core.
	ProposedNetworkMappings []*v0.NetworkMapping `` /* 132-byte string literal not displayed */
	// dependencies_endpoints are logical endpoints exposed by services this service consumes.
	DependenciesEndpoints []*v0.Endpoint `protobuf:"bytes,4,rep,name=dependencies_endpoints,json=dependenciesEndpoints,proto3" json:"dependencies_endpoints,omitempty"`
	// dependencies_configurations are configuration values exported by dependent services.
	DependenciesConfigurations []*v0.Configuration `` /* 139-byte string literal not displayed */
	// workspace_configurations are environment-level configuration values available to the service.
	WorkspaceConfigurations []*v0.Configuration `` /* 130-byte string literal not displayed */
	// contains filtered or unexported fields
}

type InitResponse struct {

	// status reports the lifecycle or operation status.
	Status *InitStatus `protobuf:"bytes,1,opt,name=status,proto3" json:"status,omitempty"`
	// runtime_context describes where the service runs, such as native, nix, container, or free.
	RuntimeContext *v0.RuntimeContext `protobuf:"bytes,2,opt,name=runtime_context,json=runtimeContext,proto3" json:"runtime_context,omitempty"`
	// network_mappings are the concrete mappings the service will use at runtime.
	NetworkMappings []*v0.NetworkMapping `protobuf:"bytes,3,rep,name=network_mappings,json=networkMappings,proto3" json:"network_mappings,omitempty"`
	// runtime_configurations are values this service exports to dependents.
	RuntimeConfigurations []*v0.Configuration `protobuf:"bytes,4,rep,name=runtime_configurations,json=runtimeConfigurations,proto3" json:"runtime_configurations,omitempty"`
	// contains filtered or unexported fields
}

type InitStatus struct {

	// state is the machine-readable lifecycle state.
	State InitStatus_Status `protobuf:"varint,1,opt,name=state,proto3,enum=codefly.services.runtime.v0.InitStatus_Status" json:"state,omitempty"`
	// message is a human-readable status or diagnostic summary.
	Message string `protobuf:"bytes,2,opt,name=message,proto3" json:"message,omitempty"`
	// failure is the universal structured cause when state is ERROR.
	Failure *v0.Failure `protobuf:"bytes,3,opt,name=failure,proto3" json:"failure,omitempty"`
	// contains filtered or unexported fields
}

type InitStatus_Status int32

type LintDiagnostic struct {

	// file is canonical and relative to the service source root when possible.
	File string `protobuf:"bytes,1,opt,name=file,proto3" json:"file,omitempty"`
	// line is one-based; zero means unavailable.
	Line int32 `protobuf:"varint,2,opt,name=line,proto3" json:"line,omitempty"`
	// column is one-based; zero means unavailable.
	Column int32 `protobuf:"varint,3,opt,name=column,proto3" json:"column,omitempty"`
	// end_line is the optional inclusive end line.
	EndLine int32 `protobuf:"varint,4,opt,name=end_line,json=endLine,proto3" json:"end_line,omitempty"`
	// end_column is the optional inclusive end column.
	EndColumn int32 `protobuf:"varint,5,opt,name=end_column,json=endColumn,proto3" json:"end_column,omitempty"`
	// severity is the normalized finding severity.
	Severity LintDiagnostic_Severity `` /* 127-byte string literal not displayed */
	// rule is the native linter rule identifier when available.
	Rule string `protobuf:"bytes,7,opt,name=rule,proto3" json:"rule,omitempty"`
	// message explains the finding.
	Message string `protobuf:"bytes,8,opt,name=message,proto3" json:"message,omitempty"`
	// fix_available reports whether the language Tooling/Code Fix RPC can address it.
	FixAvailable bool `protobuf:"varint,9,opt,name=fix_available,json=fixAvailable,proto3" json:"fix_available,omitempty"`
	// contains filtered or unexported fields
}

type LintDiagnostic_Severity int32

type LintRequest struct {

	// Optional target scope: package path, file, or empty for all.
	Target string `protobuf:"bytes,1,opt,name=target,proto3" json:"target,omitempty"`
	// selection is the authoritative structured scope. When present, runtimes
	// must apply it exactly or return an error; they must not broaden linting.
	Selection *ValidationSelection `protobuf:"bytes,3,opt,name=selection,proto3" json:"selection,omitempty"`
	// selection_id is required with selection and must be echoed only after the
	// runtime has honored the authoritative selection.
	SelectionId string `protobuf:"bytes,4,opt,name=selection_id,json=selectionId,proto3" json:"selection_id,omitempty"`
	// contains filtered or unexported fields
}

type LintResponse struct {

	// status reports the lifecycle or operation status.
	Status *LintStatus `protobuf:"bytes,1,opt,name=status,proto3" json:"status,omitempty"`
	// output is raw command, build, lint, or test output preserved for diagnostics.
	Output string `protobuf:"bytes,2,opt,name=output,proto3" json:"output,omitempty"`
	// diagnostics are structured findings suitable for reports and IDE links.
	Diagnostics []*LintDiagnostic `protobuf:"bytes,3,rep,name=diagnostics,proto3" json:"diagnostics,omitempty"`
	// requested_selection is the exact authoritative selection applied.
	RequestedSelection *ValidationSelection `protobuf:"bytes,4,opt,name=requested_selection,json=requestedSelection,proto3" json:"requested_selection,omitempty"`
	// selection_id echoes LintRequest.selection_id after selection was honored.
	SelectionId string `protobuf:"bytes,5,opt,name=selection_id,json=selectionId,proto3" json:"selection_id,omitempty"`
	// output_truncated is true when output was bounded by the agent.
	OutputTruncated bool `protobuf:"varint,6,opt,name=output_truncated,json=outputTruncated,proto3" json:"output_truncated,omitempty"`
	// contains filtered or unexported fields
}

type LintStatus struct {

	// state is the machine-readable lifecycle state.
	State LintStatus_Status `protobuf:"varint,1,opt,name=state,proto3,enum=codefly.services.runtime.v0.LintStatus_Status" json:"state,omitempty"`
	// message is a human-readable status or diagnostic summary.
	Message string `protobuf:"bytes,2,opt,name=message,proto3" json:"message,omitempty"`
	// failure is the universal structured cause when state is ERROR.
	Failure *v0.Failure `protobuf:"bytes,3,opt,name=failure,proto3" json:"failure,omitempty"`
	// contains filtered or unexported fields
}

type LintStatus_Status int32

type LoadRequest struct {

	// developer_debug enables agent-specific debug behavior for local development.
	DeveloperDebug bool `protobuf:"varint,1,opt,name=developer_debug,json=developerDebug,proto3" json:"developer_debug,omitempty"`
	// disable_catch disables agent panic/error recovery when debugging failures.
	DisableCatch bool `protobuf:"varint,2,opt,name=disable_catch,json=disableCatch,proto3" json:"disable_catch,omitempty"`
	// identity is the service instance the runtime agent should load.
	Identity *v0.ServiceIdentity `protobuf:"bytes,3,opt,name=identity,proto3" json:"identity,omitempty"`
	// environment is the Codefly environment in which the service will run.
	Environment *v0.Environment `protobuf:"bytes,4,opt,name=environment,proto3" json:"environment,omitempty"`
	// contains filtered or unexported fields
}

type LoadResponse struct {

	// version is the service version reported by the runtime agent after Load.
	Version *v0.Version `protobuf:"bytes,1,opt,name=version,proto3" json:"version,omitempty"`
	// status reports the lifecycle or operation status.
	Status *LoadStatus `protobuf:"bytes,2,opt,name=status,proto3" json:"status,omitempty"`
	// endpoints are logical endpoints exposed by the service implementation.
	Endpoints []*v0.Endpoint `protobuf:"bytes,3,rep,name=endpoints,proto3" json:"endpoints,omitempty"`
	// contains filtered or unexported fields
}

type LoadStatus struct {

	// state is the machine-readable lifecycle state.
	State LoadStatus_Status `protobuf:"varint,1,opt,name=state,proto3,enum=codefly.services.runtime.v0.LoadStatus_Status" json:"state,omitempty"`
	// message is a human-readable status or diagnostic summary.
	Message string `protobuf:"bytes,2,opt,name=message,proto3" json:"message,omitempty"`
	// failure is the universal structured cause when state is ERROR.
	Failure *v0.Failure `protobuf:"bytes,3,opt,name=failure,proto3" json:"failure,omitempty"`
	// contains filtered or unexported fields
}

type LoadStatus_Status int32

type RuntimeClient interface {
	// Load discovers service metadata before any runtime resources are allocated.
	Load(ctx context.Context, in *LoadRequest, opts ...grpc.CallOption) (*LoadResponse, error)
	// Init resolves configuration, dependency endpoints, and concrete network mappings.
	Init(ctx context.Context, in *InitRequest, opts ...grpc.CallOption) (*InitResponse, error)
	// Start launches the service process and returns once it is ready or failed.
	Start(ctx context.Context, in *StartRequest, opts ...grpc.CallOption) (*StartResponse, error)
	// Stop terminates the running service process.
	Stop(ctx context.Context, in *StopRequest, opts ...grpc.CallOption) (*StopResponse, error)
	// Destroy releases runtime resources such as containers, sockets, or temp state.
	Destroy(ctx context.Context, in *DestroyRequest, opts ...grpc.CallOption) (*DestroyResponse, error)
	// Build runs the service's native build or compile check.
	Build(ctx context.Context, in *BuildRequest, opts ...grpc.CallOption) (*BuildResponse, error)
	// Test runs the service's native test command and returns structured results.
	Test(ctx context.Context, in *TestRequest, opts ...grpc.CallOption) (*TestResponse, error)
	// Lint runs the service's native linter.
	Lint(ctx context.Context, in *LintRequest, opts ...grpc.CallOption) (*LintResponse, error)
	// Information returns the latest lifecycle statuses known by the agent.
	Information(ctx context.Context, in *InformationRequest, opts ...grpc.CallOption) (*InformationResponse, error)
	// Bidirectional streaming for interactive Q&A.
	// Plugin streams Questions, CLI streams Answers.
	Communicate(ctx context.Context, opts ...grpc.CallOption) (grpc.BidiStreamingClient[v0.Answer, v0.Question], error)
}

type RuntimeServer interface {
	// Load discovers service metadata before any runtime resources are allocated.
	Load(context.Context, *LoadRequest) (*LoadResponse, error)
	// Init resolves configuration, dependency endpoints, and concrete network mappings.
	Init(context.Context, *InitRequest) (*InitResponse, error)
	// Start launches the service process and returns once it is ready or failed.
	Start(context.Context, *StartRequest) (*StartResponse, error)
	// Stop terminates the running service process.
	Stop(context.Context, *StopRequest) (*StopResponse, error)
	// Destroy releases runtime resources such as containers, sockets, or temp state.
	Destroy(context.Context, *DestroyRequest) (*DestroyResponse, error)
	// Build runs the service's native build or compile check.
	Build(context.Context, *BuildRequest) (*BuildResponse, error)
	// Test runs the service's native test command and returns structured results.
	Test(context.Context, *TestRequest) (*TestResponse, error)
	// Lint runs the service's native linter.
	Lint(context.Context, *LintRequest) (*LintResponse, error)
	// Information returns the latest lifecycle statuses known by the agent.
	Information(context.Context, *InformationRequest) (*InformationResponse, error)
	// Bidirectional streaming for interactive Q&A.
	// Plugin streams Questions, CLI streams Answers.
	Communicate(grpc.BidiStreamingServer[v0.Answer, v0.Question]) error
	// contains filtered or unexported methods
}

type Runtime_CommunicateClient = grpc.BidiStreamingClient[v0.Answer, v0.Question]

type Runtime_CommunicateServer = grpc.BidiStreamingServer[v0.Answer, v0.Question]

type StartRequest struct {

	// specs are runtime knobs that affect how the agent starts the service.
	Specs *v0.Specs `protobuf:"bytes,1,opt,name=specs,proto3" json:"specs,omitempty"`
	// dependencies_network_mappings are concrete addresses for dependency endpoints.
	DependenciesNetworkMappings []*v0.NetworkMapping `` /* 144-byte string literal not displayed */
	// fixture selects optional fixture data or setup behavior for the start.
	Fixture string `protobuf:"bytes,3,opt,name=fixture,proto3" json:"fixture,omitempty"`
	// overrides are per-service environment variables (KEY=VAL) injected into
	// the service process at run time. Set via `codefly run ... --set <service>:KEY=VAL`.
	Overrides map[string]string `` /* 145-byte string literal not displayed */
	// contains filtered or unexported fields
}

type StartResponse struct {

	// status reports the lifecycle or operation status.
	Status *StartStatus `protobuf:"bytes,1,opt,name=status,proto3" json:"status,omitempty"`
	// contains filtered or unexported fields
}

type StartStatus struct {

	// state is the machine-readable lifecycle state.
	State StartStatus_Status `protobuf:"varint,1,opt,name=state,proto3,enum=codefly.services.runtime.v0.StartStatus_Status" json:"state,omitempty"`
	// message is a human-readable status or diagnostic summary.
	Message string `protobuf:"bytes,2,opt,name=message,proto3" json:"message,omitempty"`
	// failure is the universal structured cause when state is ERROR.
	Failure *v0.Failure `protobuf:"bytes,3,opt,name=failure,proto3" json:"failure,omitempty"`
	// contains filtered or unexported fields
}

type StartStatus_Status int32

type StopRequest struct {
	// contains filtered or unexported fields
}

type StopResponse struct {

	// status reports the lifecycle or operation status.
	Status *StopStatus `protobuf:"bytes,1,opt,name=status,proto3" json:"status,omitempty"`
	// contains filtered or unexported fields
}

type StopStatus struct {

	// state is the machine-readable lifecycle state.
	State StopStatus_Status `protobuf:"varint,1,opt,name=state,proto3,enum=codefly.services.runtime.v0.StopStatus_Status" json:"state,omitempty"`
	// message is a human-readable status or diagnostic summary.
	Message string `protobuf:"bytes,2,opt,name=message,proto3" json:"message,omitempty"`
	// failure is the universal structured cause when state is ERROR.
	Failure *v0.Failure `protobuf:"bytes,3,opt,name=failure,proto3" json:"failure,omitempty"`
	// contains filtered or unexported fields
}

type StopStatus_Status int32

type TestCase struct {

	// Local case name as the runner reports it.
	//
	//	Go:     "TestPolicy_Apply_DefaultsToDeny"
	//	Python: "test_user_creation"
	//	Jest:   "should reject expired tokens"
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Fully-qualified name across the workspace; useful for
	// de-duplication when the same `name` appears in multiple suites.
	//
	//	"github.com/codefly-dev/core/policy.TestPolicy_Apply_DefaultsToDeny"
	FullName string `protobuf:"bytes,2,opt,name=full_name,json=fullName,proto3" json:"full_name,omitempty"`
	// Per-case outcome.
	State TestCaseState `protobuf:"varint,3,opt,name=state,proto3,enum=codefly.services.runtime.v0.TestCaseState" json:"state,omitempty"`
	// Wall-clock duration of THIS case (excludes parent suite setup).
	Duration *durationpb.Duration `protobuf:"bytes,4,opt,name=duration,proto3" json:"duration,omitempty"`
	// Source location — file + line + (when known) function. Drives
	// IDE jump and makes Mind's "the failure is at X" actionable.
	Location *TestLocation `protobuf:"bytes,5,opt,name=location,proto3" json:"location,omitempty"`
	// Failure detail. Empty when state == PASSED. Required when state
	// is FAILED or ERRORED.
	Failure *TestFailure `protobuf:"bytes,6,opt,name=failure,proto3" json:"failure,omitempty"`
	// Stdout/stderr captured during the case execution. Populated for
	// FAILED/ERRORED. EMPTY for PASSED unless TestRequest.verbose was
	// set. The output retention policy is the load-bearing fix that
	// keeps response sizes manageable on large suites.
	CapturedOutput string `protobuf:"bytes,7,opt,name=captured_output,json=capturedOutput,proto3" json:"captured_output,omitempty"`
	// Tags / categories declared on the test (Go build tags, pytest
	// marks, Jest test.skip annotations). Useful for filtering in
	// reporting layers without re-running.
	Tags []string `protobuf:"bytes,8,rep,name=tags,proto3" json:"tags,omitempty"`
	// Retry attempts. Only set when the runner re-ran the case
	// (Jest's `retries`, Playwright's `retries`). Each entry is a
	// distinct attempt; the `state` of the final attempt matches
	// the case's top-level `state`.
	Retries []*TestRetry `protobuf:"bytes,9,rep,name=retries,proto3" json:"retries,omitempty"`
	// contains filtered or unexported fields
}

type TestCaseSelection struct {

	// package optionally narrows the case to one package/module/crate.
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// path optionally narrows the case to one workspace-relative file.
	Path string `protobuf:"bytes,2,opt,name=path,proto3" json:"path,omitempty"`
	// suite optionally narrows the case to one runtime-declared suite.
	Suite string `protobuf:"bytes,3,opt,name=suite,proto3" json:"suite,omitempty"`
	// qualified_name lists logical name segments from outermost to leaf case.
	QualifiedName []string `protobuf:"bytes,4,rep,name=qualified_name,json=qualifiedName,proto3" json:"qualified_name,omitempty"`
	// contains filtered or unexported fields
}

type TestCaseState int32

type TestCounts struct {

	// total is the aggregate number of cases represented.
	Total int32 `protobuf:"varint,1,opt,name=total,proto3" json:"total,omitempty"`
	// passed is the number of cases that passed.
	Passed int32 `protobuf:"varint,2,opt,name=passed,proto3" json:"passed,omitempty"`
	// failed is the number of cases that failed assertions.
	Failed int32 `protobuf:"varint,3,opt,name=failed,proto3" json:"failed,omitempty"`
	// skipped is the number of cases the runner skipped.
	Skipped int32 `protobuf:"varint,4,opt,name=skipped,proto3" json:"skipped,omitempty"`
	// errored is the number of cases that crashed or failed setup/teardown.
	Errored int32 `protobuf:"varint,5,opt,name=errored,proto3" json:"errored,omitempty"`
	// flaky is the number of cases that only passed after retry.
	Flaky int32 `protobuf:"varint,6,opt,name=flaky,proto3" json:"flaky,omitempty"`
	// contains filtered or unexported fields
}

type TestCoverage struct {

	// Overall coverage 0-100.
	TotalPct float32 `protobuf:"fixed32,1,opt,name=total_pct,json=totalPct,proto3" json:"total_pct,omitempty"`
	// Per-file breakdown. Conventionally sorted by lowest pct first
	// (most interesting to inspect).
	Files []*TestFileCoverage `protobuf:"bytes,2,rep,name=files,proto3" json:"files,omitempty"`
	// Path to the raw artifact (cover.out for Go, lcov.info for JS).
	// Optional — agents may or may not surface this. Consumers that
	// need finer detail (per-line marks, branch coverage) read this.
	RawArtifactPath string `protobuf:"bytes,3,opt,name=raw_artifact_path,json=rawArtifactPath,proto3" json:"raw_artifact_path,omitempty"`
	// Format identifier for the raw artifact.
	// Conventional values: "go-cover" | "lcov" | "cobertura" | "junit".
	RawArtifactFormat string `protobuf:"bytes,4,opt,name=raw_artifact_format,json=rawArtifactFormat,proto3" json:"raw_artifact_format,omitempty"`
	// contains filtered or unexported fields
}

type TestFailure struct {

	// One-line summary: "expected 3, got 5" or "panic: nil pointer dereference".
	Message string `protobuf:"bytes,1,opt,name=message,proto3" json:"message,omitempty"`
	// Multi-line detail: stack trace, full diff, expected vs actual.
	// Bounded by the agent's per-case output cap.
	Detail string `protobuf:"bytes,2,opt,name=detail,proto3" json:"detail,omitempty"`
	// Failure category. Drives Mind's diagnosis flow.
	Kind TestFailureKind `protobuf:"varint,3,opt,name=kind,proto3,enum=codefly.services.runtime.v0.TestFailureKind" json:"kind,omitempty"`
	// Location where the assertion fired or the panic occurred —
	// typically deeper than the case's declaration site.
	SourceLocation *TestLocation `protobuf:"bytes,4,opt,name=source_location,json=sourceLocation,proto3" json:"source_location,omitempty"`
	// Skip reason when the case was SKIPPED (not technically a
	// failure, but the explanation lives in the same struct so
	// consumers have one place to look).
	SkipReason string `protobuf:"bytes,5,opt,name=skip_reason,json=skipReason,proto3" json:"skip_reason,omitempty"`
	// contains filtered or unexported fields
}

type TestFailureKind int32

type TestFileCoverage struct {

	// file is a workspace- or service-relative source file path.
	File string `protobuf:"bytes,1,opt,name=file,proto3" json:"file,omitempty"`
	// pct is the file coverage percentage from 0 to 100.
	Pct float32 `protobuf:"fixed32,2,opt,name=pct,proto3" json:"pct,omitempty"`
	// lines_covered is the number of covered source lines.
	LinesCovered int32 `protobuf:"varint,3,opt,name=lines_covered,json=linesCovered,proto3" json:"lines_covered,omitempty"`
	// lines_total is the total number of coverable source lines.
	LinesTotal int32 `protobuf:"varint,4,opt,name=lines_total,json=linesTotal,proto3" json:"lines_total,omitempty"`
	// contains filtered or unexported fields
}

type TestFileSelection struct {

	// path is a canonical, workspace-relative path using forward slashes.
	Path string `protobuf:"bytes,1,opt,name=path,proto3" json:"path,omitempty"`
	// contains filtered or unexported fields
}

type TestFormula struct {

	// Test command argv (language-agnostic): ["pytest"], ["go","test","./..."],
	// ["python","tests/runtests.py","--verbosity=2"], ["npm","test"], …
	Command []string `protobuf:"bytes,1,rep,name=command,proto3" json:"command,omitempty"`
	// Output format → selects the structured parser. A FORMAT, not a framework:
	// "junit-xml", "unittest-text", "go-test-json", … The plugin owns the parser.
	Output string `protobuf:"bytes,2,opt,name=output,proto3" json:"output,omitempty"`
	// Extra environment variables for the run.
	Env map[string]string `` /* 133-byte string literal not displayed */
	// Provisioning hints the language plugin interprets — opaque to this layer so
	// the formula stays language-agnostic. Multi-valued entries are comma-joined.
	// The python/uv plugin understands: python=<v>, editable=true,
	// with=<spec,spec>, requirements=<file,file>, no_project=true.
	Provisioning map[string]string `` /* 151-byte string literal not displayed */
	// contains filtered or unexported fields
}

type TestLocation struct {

	// File path. Absolute or repo-relative — agent's choice; consumers
	// resolve via SourceLocation when needed.
	File string `protobuf:"bytes,1,opt,name=file,proto3" json:"file,omitempty"`
	// line is the 1-based source line number.
	Line int32 `protobuf:"varint,2,opt,name=line,proto3" json:"line,omitempty"`
	// column is the 1-based source column number when known.
	Column int32 `protobuf:"varint,3,opt,name=column,proto3" json:"column,omitempty"`
	// Function name when available (Go: TestFoo; pytest: test_foo).
	Function string `protobuf:"bytes,4,opt,name=function,proto3" json:"function,omitempty"`
	// contains filtered or unexported fields
}

type TestPackageSelection struct {

	// package is the package/module/crate identity understood by the plugin.
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// contains filtered or unexported fields
}

type TestRequest struct {

	// Optional target: package or directory scope (e.g. "./handlers" for Go,
	// "tests/unit" for Python). For name-pattern filtering, prefer `filters`.
	// Empty runs the agent's default scope.
	Target string `protobuf:"bytes,1,opt,name=target,proto3" json:"target,omitempty"`
	// Optional: run with verbose output.
	Verbose bool `protobuf:"varint,2,opt,name=verbose,proto3" json:"verbose,omitempty"`
	// Optional: run with race detector.
	Race bool `protobuf:"varint,3,opt,name=race,proto3" json:"race,omitempty"`
	// Optional: timeout per test (e.g. "30s"). Empty uses agent default.
	Timeout string `protobuf:"bytes,4,opt,name=timeout,proto3" json:"timeout,omitempty"`
	// Optional: run with coverage instrumentation. Off by default —
	// -cover roughly doubles compile time for test binaries.
	Coverage bool `protobuf:"varint,5,opt,name=coverage,proto3" json:"coverage,omitempty"`
	// Optional: name-pattern filters (regex). Multiple values are combined
	// with OR. Each agent maps these to its native filter mechanism:
	//
	//	Go (go test):       -run "(p1|p2|...)"
	//	JS (vitest/jest):   --testNamePattern "(p1|p2|...)"
	//	JS (playwright):    --grep "(p1|p2|...)"
	//	Python (pytest):    -k "p1 or p2 or ..."
	//
	// Empty list matches everything.
	Filters []string `protobuf:"bytes,6,rep,name=filters,proto3" json:"filters,omitempty"`
	// Optional: named test suite. Agents decide what each name means.
	// Conventional values:
	//
	//	"unit"        — fast, no infra (default if empty)
	//	"integration" — needs dependencies via withDependencies
	//	"e2e"         — full stack via Playwright/Cypress/etc.
	//	"smoke"       — minimal post-deploy checks
	//
	// Agents that only run one kind of test ignore this.
	Suite string `protobuf:"bytes,7,opt,name=suite,proto3" json:"suite,omitempty"`
	// Optional: extra args appended verbatim to the underlying test runner
	// command. Power-user escape hatch for flags codefly does not model.
	// Agents must NOT interpret these — pass through unchanged.
	ExtraArgs []string `protobuf:"bytes,8,rep,name=extra_args,json=extraArgs,proto3" json:"extra_args,omitempty"`
	// Optional: a test FORMULA. When set, the agent runs THIS exact formula
	// instead of detecting/choosing a runner — the caller (Mind) captured the
	// command from the project's own declarations and supplies the per-instance
	// provisioning as data. The agent hardcodes NO pytest/django command; it
	// renders the formula into `uv run …` and parses by `output`. Selectors come
	// from `target`/`filters`. This is how the brain stays framework-blind.
	Formula *TestFormula `protobuf:"bytes,9,opt,name=formula,proto3" json:"formula,omitempty"`
	// selection is the authoritative structured scope. When present, runtime
	// implementations MUST apply it exactly or return an ERRORED result; they
	// must never silently fall back to the broad/default test scope.
	Selection *TestSelection `protobuf:"bytes,10,opt,name=selection,proto3" json:"selection,omitempty"`
	// selection_id is an opaque, caller-generated identity for selection.
	// It is required whenever selection is present. A runtime echoes it in
	// TestRun.selection_id only after it has honored selection. Callers MUST
	// reject a response that does not echo the expected identity. This makes an
	// older peer that ignores the additive selection field fail closed instead
	// of accidentally certifying a broad test run.
	SelectionId string `protobuf:"bytes,11,opt,name=selection_id,json=selectionId,proto3" json:"selection_id,omitempty"`
	// Stop the underlying test runner after its first failure. CI uses this to
	// avoid spending the remainder of a long suite after a fail-closed external
	// replay miss or any other decisive runtime failure. Agents map this to the
	// native runner's fail-fast behavior; it is false for interactive/default
	// test requests so callers can still collect the complete failure set.
	FailFast bool `protobuf:"varint,12,opt,name=fail_fast,json=failFast,proto3" json:"fail_fast,omitempty"`
	// contains filtered or unexported fields
}

type TestResponse struct {

	// --- Legacy flat fields ---
	// Kept populated for backward compatibility while consumers migrate
	// to the structured tree below. New code SHOULD prefer `result`,
	// `counts`, and `suites`. The flat fields are computed from the
	// structured tree — single source of truth.
	//
	// Deprecated: Marked as deprecated in codefly/services/runtime/v0/runtime.proto.
	Status *TestStatus `protobuf:"bytes,1,opt,name=status,proto3" json:"status,omitempty"`
	// Legacy: full runner output dump. Wastes bandwidth + Mind context
	// on large suites. New consumers read per-case `captured_output`
	// from `suites[].cases[]` (populated only for FAILED/ERRORED cases
	// unless TestRequest.verbose is true).
	//
	// Deprecated: Marked as deprecated in codefly/services/runtime/v0/runtime.proto.
	Output string `protobuf:"bytes,2,opt,name=output,proto3" json:"output,omitempty"`
	// tests_run is the total number of tests executed.
	//
	// Deprecated: Marked as deprecated in codefly/services/runtime/v0/runtime.proto.
	TestsRun int32 `protobuf:"varint,3,opt,name=tests_run,json=testsRun,proto3" json:"tests_run,omitempty"`
	// tests_passed is the number of tests that passed.
	//
	// Deprecated: Marked as deprecated in codefly/services/runtime/v0/runtime.proto.
	TestsPassed int32 `protobuf:"varint,4,opt,name=tests_passed,json=testsPassed,proto3" json:"tests_passed,omitempty"`
	// tests_failed is the number of tests that failed.
	//
	// Deprecated: Marked as deprecated in codefly/services/runtime/v0/runtime.proto.
	TestsFailed int32 `protobuf:"varint,5,opt,name=tests_failed,json=testsFailed,proto3" json:"tests_failed,omitempty"`
	// tests_skipped is the number of tests skipped by the runner.
	//
	// Deprecated: Marked as deprecated in codefly/services/runtime/v0/runtime.proto.
	TestsSkipped int32 `protobuf:"varint,6,opt,name=tests_skipped,json=testsSkipped,proto3" json:"tests_skipped,omitempty"`
	// coverage_pct is the overall coverage percentage when available.
	//
	// Deprecated: Marked as deprecated in codefly/services/runtime/v0/runtime.proto.
	CoveragePct float32 `protobuf:"fixed32,7,opt,name=coverage_pct,json=coveragePct,proto3" json:"coverage_pct,omitempty"`
	// failures are concise failing test names or messages.
	//
	// Deprecated: Marked as deprecated in codefly/services/runtime/v0/runtime.proto.
	Failures []string `protobuf:"bytes,8,rep,name=failures,proto3" json:"failures,omitempty"`
	// Run-level metadata (which runner ran, how long, etc).
	Run *TestRun `protobuf:"bytes,9,opt,name=run,proto3" json:"run,omitempty"`
	// Overall outcome of the entire run. Independent from per-case
	// states because a run can ERROR (build failure, infra setup
	// failure) without any individual case running.
	Result *TestRunResult `protobuf:"bytes,10,opt,name=result,proto3" json:"result,omitempty"`
	// Aggregate counts. Computed from `suites`; surfaced top-level for
	// fast access (callers wanting "did the run pass?" don't have to
	// walk the tree).
	Counts *TestCounts `protobuf:"bytes,11,opt,name=counts,proto3" json:"counts,omitempty"`
	// Hierarchical results: a run contains suites; suites contain
	// sub-suites and/or cases. A "suite" is whatever the runner's
	// grouping primitive is — a Go package, a pytest test file, a
	// Jest describe block. Nesting allowed (Jest describe-in-describe,
	// pytest classes inside files).
	Suites []*TestSuite `protobuf:"bytes,12,rep,name=suites,proto3" json:"suites,omitempty"`
	// Optional coverage breakdown. Only set when TestRequest.coverage
	// was true.
	Coverage *TestCoverage `protobuf:"bytes,13,opt,name=coverage,proto3" json:"coverage,omitempty"`
	// Truncation metadata — surfaces when the runner emitted more
	// output than the agent's caps allow. Mind/CLI display the cap
	// and offer to fetch the full output for specific cases on demand.
	Truncation *TestTruncation `protobuf:"bytes,14,opt,name=truncation,proto3" json:"truncation,omitempty"`
	// contains filtered or unexported fields
}

type TestRetry struct {

	// attempt is the 1-based retry attempt number.
	Attempt int32 `protobuf:"varint,1,opt,name=attempt,proto3" json:"attempt,omitempty"` // 1-indexed
	// state is the machine-readable lifecycle state.
	State TestCaseState `protobuf:"varint,2,opt,name=state,proto3,enum=codefly.services.runtime.v0.TestCaseState" json:"state,omitempty"`
	// duration is wall-clock time spent on the run, suite, case, or operation.
	Duration *durationpb.Duration `protobuf:"bytes,3,opt,name=duration,proto3" json:"duration,omitempty"`
	// Failure detail if the attempt failed. Empty if it passed.
	Failure *TestFailure `protobuf:"bytes,4,opt,name=failure,proto3" json:"failure,omitempty"`
	// contains filtered or unexported fields
}