v0

type AuditFinding struct {

	// severity is the diagnostic level such as error, warning, information, or hint.
	Severity AuditFinding_Severity `protobuf:"varint,1,opt,name=severity,proto3,enum=codefly.services.builder.v0.AuditFinding_Severity" json:"severity,omitempty"`
	// id is the stable identifier for this record.
	Id string `protobuf:"bytes,2,opt,name=id,proto3" json:"id,omitempty"` // CVE-2025-xxxx, GHSA-xxxx-xxxx, OSV id
	// package is the package, dependency, or artifact name.
	Package string `protobuf:"bytes,3,opt,name=package,proto3" json:"package,omitempty"`
	// current_version is the vulnerable or outdated version currently installed.
	CurrentVersion string `protobuf:"bytes,4,opt,name=current_version,json=currentVersion,proto3" json:"current_version,omitempty"`
	// fixed_version is the version that resolves the reported finding.
	FixedVersion string `protobuf:"bytes,5,opt,name=fixed_version,json=fixedVersion,proto3" json:"fixed_version,omitempty"`
	// summary is the compact natural-language result or state description.
	Summary string `protobuf:"bytes,6,opt,name=summary,proto3" json:"summary,omitempty"`
	// url links to advisory, package, or documentation details for the item.
	Url string `protobuf:"bytes,7,opt,name=url,proto3" json:"url,omitempty"`
	// contains filtered or unexported fields
}

type AuditFinding_Severity int32

type AuditRequest struct {

	// include_outdated reports patch+minor "available" upgrades alongside
	// CVEs. Default true. Set false for a vuln-only scan.
	IncludeOutdated bool `protobuf:"varint,1,opt,name=include_outdated,json=includeOutdated,proto3" json:"include_outdated,omitempty"`
	// fail_on_vuln makes the agent return state=ERROR if any finding has
	// severity HIGH or above. Default false (report-only).
	FailOnVuln bool `protobuf:"varint,2,opt,name=fail_on_vuln,json=failOnVuln,proto3" json:"fail_on_vuln,omitempty"`
	// contains filtered or unexported fields
}

type AuditResponse struct {

	// state is the machine-readable lifecycle state.
	State *AuditStatus `protobuf:"bytes,1,opt,name=state,proto3" json:"state,omitempty"`
	// findings are vulnerability or security findings returned by the audit.
	Findings []*AuditFinding `protobuf:"bytes,2,rep,name=findings,proto3" json:"findings,omitempty"`
	// outdated are dependency update opportunities returned by the audit.
	Outdated []*OutdatedDep `protobuf:"bytes,3,rep,name=outdated,proto3" json:"outdated,omitempty"`
	// tool identifies what produced the report, e.g. "govulncheck+go-list-u",
	// "npm-audit+outdated", "pip-audit", "trivy", or "missing" when the
	// required tool is not installed (still returns a successful empty scan).
	Tool string `protobuf:"bytes,4,opt,name=tool,proto3" json:"tool,omitempty"`
	// language is the source language the agent audited (matches
	// core/languages constants: GO, PYTHON, TYPESCRIPT, RUST, DOCKER).
	Language string `protobuf:"bytes,5,opt,name=language,proto3" json:"language,omitempty"`
	// contains filtered or unexported fields
}

type AuditStatus struct {

	// state is the machine-readable lifecycle state.
	State AuditStatus_Status `protobuf:"varint,1,opt,name=state,proto3,enum=codefly.services.builder.v0.AuditStatus_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"`
	// contains filtered or unexported fields
}

type AuditStatus_Status int32

type BuildContext struct {

	// kind selects one build-context implementation.
	//
	// Types that are valid to be assigned to Kind:
	//
	//	*BuildContext_DockerBuildContext
	Kind isBuildContext_Kind `protobuf_oneof:"kind"`
	// contains filtered or unexported fields
}

type BuildContext_DockerBuildContext struct {
	// docker_build_context carries the DockerBuildContext variant for BuildContext.
	DockerBuildContext *DockerBuildContext `protobuf:"bytes,1,opt,name=docker_build_context,json=dockerBuildContext,proto3,oneof"`
}

type BuildRequest struct {

	// build_context is the container build context supplied to the builder.
	BuildContext *BuildContext `protobuf:"bytes,1,opt,name=build_context,json=buildContext,proto3" json:"build_context,omitempty"`
	// contains filtered or unexported fields
}

type BuildResponse struct {

	// state is the machine-readable lifecycle state.
	State *BuildStatus `protobuf:"bytes,1,opt,name=state,proto3" json:"state,omitempty"`
	// result is the structured operation outcome.
	Result *BuildResult `protobuf:"bytes,2,opt,name=result,proto3" json:"result,omitempty"`
	// contains filtered or unexported fields
}

type BuildResult struct {

	// version is the semantic or service-specific version for this resource.
	Version string `protobuf:"bytes,1,opt,name=version,proto3" json:"version,omitempty"`
	// running_hash identifies the runtime artifact built for execution.
	RunningHash string `protobuf:"bytes,2,opt,name=running_hash,json=runningHash,proto3" json:"running_hash,omitempty"`
	// api_hash identifies the API surface used to detect contract changes.
	ApiHash string `protobuf:"bytes,3,opt,name=api_hash,json=apiHash,proto3" json:"api_hash,omitempty"`
	// kind selects one build-result implementation.
	//
	// Types that are valid to be assigned to Kind:
	//
	//	*BuildResult_DockerBuildResult
	Kind isBuildResult_Kind `protobuf_oneof:"kind"`
	// contains filtered or unexported fields
}

type BuildResult_DockerBuildResult struct {
	// docker_build_result carries the DockerBuildResult variant for BuildResult.
	DockerBuildResult *DockerBuildResult `protobuf:"bytes,4,opt,name=docker_build_result,json=dockerBuildResult,proto3,oneof"`
}

type BuildStatus struct {

	// state is the machine-readable lifecycle state.
	State BuildStatus_Status `protobuf:"varint,1,opt,name=state,proto3,enum=codefly.services.builder.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"`
	// contains filtered or unexported fields
}

type BuildStatus_Status int32

type BuilderClient interface {
	// Load reads service metadata and prepares the builder agent.
	Load(ctx context.Context, in *LoadRequest, opts ...grpc.CallOption) (*LoadResponse, error)
	// Init prepares dependency metadata and builder state.
	Init(ctx context.Context, in *InitRequest, opts ...grpc.CallOption) (*InitResponse, error)
	// Create scaffolds service source code.
	Create(ctx context.Context, in *CreateRequest, opts ...grpc.CallOption) (*CreateResponse, error)
	// Update refreshes an existing service from agent rules or templates.
	Update(ctx context.Context, in *UpdateRequest, opts ...grpc.CallOption) (*UpdateResponse, error)
	// Sync regenerates configuration-derived or template-derived service files.
	Sync(ctx context.Context, in *SyncRequest, opts ...grpc.CallOption) (*SyncResponse, error)
	// Build compiles or packages the service artifact.
	Build(ctx context.Context, in *BuildRequest, opts ...grpc.CallOption) (*BuildResponse, error)
	// Deploy emits or applies deployment artifacts for the target environment.
	Deploy(ctx context.Context, in *DeploymentRequest, opts ...grpc.CallOption) (*DeploymentResponse, error)
	// Audit runs dependency and image vulnerability checks.
	Audit(ctx context.Context, in *AuditRequest, opts ...grpc.CallOption) (*AuditResponse, error)
	// Upgrade applies or previews dependency version bumps.
	Upgrade(ctx context.Context, in *UpgradeRequest, opts ...grpc.CallOption) (*UpgradeResponse, error)
	// Bidirectional streaming for interactive Q&A (e.g. during Create/Sync).
	// Plugin streams Questions, CLI streams Answers.
	Communicate(ctx context.Context, opts ...grpc.CallOption) (grpc.BidiStreamingClient[v0.Answer, v0.Question], error)
}

type BuilderServer interface {
	// Load reads service metadata and prepares the builder agent.
	Load(context.Context, *LoadRequest) (*LoadResponse, error)
	// Init prepares dependency metadata and builder state.
	Init(context.Context, *InitRequest) (*InitResponse, error)
	// Create scaffolds service source code.
	Create(context.Context, *CreateRequest) (*CreateResponse, error)
	// Update refreshes an existing service from agent rules or templates.
	Update(context.Context, *UpdateRequest) (*UpdateResponse, error)
	// Sync regenerates configuration-derived or template-derived service files.
	Sync(context.Context, *SyncRequest) (*SyncResponse, error)
	// Build compiles or packages the service artifact.
	Build(context.Context, *BuildRequest) (*BuildResponse, error)
	// Deploy emits or applies deployment artifacts for the target environment.
	Deploy(context.Context, *DeploymentRequest) (*DeploymentResponse, error)
	// Audit runs dependency and image vulnerability checks.
	Audit(context.Context, *AuditRequest) (*AuditResponse, error)
	// Upgrade applies or previews dependency version bumps.
	Upgrade(context.Context, *UpgradeRequest) (*UpgradeResponse, error)
	// Bidirectional streaming for interactive Q&A (e.g. during Create/Sync).
	// Plugin streams Questions, CLI streams Answers.
	Communicate(grpc.BidiStreamingServer[v0.Answer, v0.Question]) error
	// contains filtered or unexported methods
}

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

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

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

type CreateResponse struct {

	// state is the machine-readable lifecycle state.
	State *CreateStatus `protobuf:"bytes,1,opt,name=state,proto3" json:"state,omitempty"`
	// endpoints are logical APIs created by the scaffolded service.
	Endpoints []*v0.Endpoint `protobuf:"bytes,2,rep,name=endpoints,proto3" json:"endpoints,omitempty"` // The endpoints of the created service
	// contains filtered or unexported fields
}

type CreateStatus struct {

	// state is the machine-readable lifecycle state.
	State CreateStatus_Status `protobuf:"varint,1,opt,name=state,proto3,enum=codefly.services.builder.v0.CreateStatus_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"`
	// contains filtered or unexported fields
}

type CreateStatus_Status int32

type CreationMode struct {

	// communicate enables interactive agent questions during this mode.
	Communicate bool `protobuf:"varint,1,opt,name=communicate,proto3" json:"communicate,omitempty"`
	// contains filtered or unexported fields
}

type Deployment struct {

	// kind selects one deployment implementation.
	//
	// Types that are valid to be assigned to Kind:
	//
	//	*Deployment_Kubernetes
	Kind isDeployment_Kind `protobuf_oneof:"kind"`
	// contains filtered or unexported fields
}

type DeploymentKind int32

type DeploymentOutput struct {

	// kind selects one deployment output implementation.
	//
	// Types that are valid to be assigned to Kind:
	//
	//	*DeploymentOutput_Kubernetes
	Kind isDeploymentOutput_Kind `protobuf_oneof:"kind"`
	// contains filtered or unexported fields
}

type DeploymentOutput_Kubernetes struct {
	// kubernetes carries the KubernetesDeploymentOutput variant for DeploymentOutput.
	Kubernetes *KubernetesDeploymentOutput `protobuf:"bytes,2,opt,name=kubernetes,proto3,oneof"`
}

type DeploymentRequest struct {

	// environment is the target Codefly environment such as local, staging, or production.
	Environment *v0.Environment `protobuf:"bytes,1,opt,name=environment,proto3" json:"environment,omitempty"`
	// deployment is the deployment target and payload handled by the builder.
	Deployment *Deployment `protobuf:"bytes,2,opt,name=deployment,proto3" json:"deployment,omitempty"`
	// configuration is the service or workspace configuration payload.
	Configuration *v0.Configuration `protobuf:"bytes,3,opt,name=configuration,proto3" json:"configuration,omitempty"`
	// dependencies_configurations are configuration values exposed by upstream services.
	DependenciesConfigurations []*v0.Configuration `` /* 139-byte string literal not displayed */
	// network_mappings map logical endpoints to concrete network instances.
	NetworkMappings []*v0.NetworkMapping `protobuf:"bytes,5,rep,name=network_mappings,json=networkMappings,proto3" json:"network_mappings,omitempty"`
	// dependencies_network_mappings are reachable addresses for upstream services.
	DependenciesNetworkMappings []*v0.NetworkMapping `` /* 144-byte string literal not displayed */
	// contains filtered or unexported fields
}

type DeploymentResponse struct {

	// state is the machine-readable lifecycle state.
	State *DeploymentStatus `protobuf:"bytes,1,opt,name=state,proto3" json:"state,omitempty"`
	// configuration is the service or workspace configuration payload.
	Configuration *v0.Configuration `protobuf:"bytes,2,opt,name=configuration,proto3" json:"configuration,omitempty"`
	// deployment is the deployment target and payload handled by the builder.
	Deployment *DeploymentOutput `protobuf:"bytes,3,opt,name=deployment,proto3" json:"deployment,omitempty"`
	// contains filtered or unexported fields
}

type DeploymentStatus struct {

	// state is the machine-readable lifecycle state.
	State DeploymentStatus_Status `protobuf:"varint,1,opt,name=state,proto3,enum=codefly.services.builder.v0.DeploymentStatus_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"`
	// contains filtered or unexported fields
}

type DeploymentStatus_Status int32

type Deployment_Kubernetes struct {
	// kubernetes carries the KubernetesDeployment variant for Deployment.
	Kubernetes *KubernetesDeployment `protobuf:"bytes,2,opt,name=kubernetes,proto3,oneof"`
}

type DockerBuildContext struct {

	// docker_repository is the image repository used for Docker builds.
	DockerRepository string `protobuf:"bytes,1,opt,name=docker_repository,json=dockerRepository,proto3" json:"docker_repository,omitempty"`
	// contains filtered or unexported fields
}

type DockerBuildResult struct {

	// images are image tags or digests produced by the Docker build.
	Images []string `protobuf:"bytes,1,rep,name=images,proto3" json:"images,omitempty"`
	// contains filtered or unexported fields
}

type InitRequest struct {

	// dependencies_endpoints are logical endpoints exposed by upstream services.
	DependenciesEndpoints []*v0.Endpoint `protobuf:"bytes,1,rep,name=dependencies_endpoints,json=dependenciesEndpoints,proto3" json:"dependencies_endpoints,omitempty"`
	// contains filtered or unexported fields
}

type InitResponse struct {

	// state is the machine-readable lifecycle state.
	State *InitStatus `protobuf:"bytes,1,opt,name=state,proto3" json:"state,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.builder.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"`
	// contains filtered or unexported fields
}

type InitStatus_Status int32

type KubernetesDeployment struct {

	// namespace is the Kubernetes namespace used for deployment.
	Namespace string `protobuf:"bytes,1,opt,name=namespace,proto3" json:"namespace,omitempty"`
	// destination is the deployment destination path or environment.
	Destination string `protobuf:"bytes,2,opt,name=destination,proto3" json:"destination,omitempty"`
	// build_context is the Docker image build context used by the deployment.
	BuildContext *DockerBuildContext `protobuf:"bytes,3,opt,name=build_context,json=buildContext,proto3" json:"build_context,omitempty"`
	// contains filtered or unexported fields
}

type KubernetesDeploymentOutput struct {

	// kind identifies the generated Kubernetes artifact format.
	Kind KubernetesDeploymentOutput_Kind `` /* 127-byte string literal not displayed */
	// contains filtered or unexported fields
}

type KubernetesDeploymentOutput_Kind int32

type LoadRequest struct {

	// developer_debug enables agent-side debug behavior.
	DeveloperDebug bool `protobuf:"varint,1,opt,name=developer_debug,json=developerDebug,proto3" json:"developer_debug,omitempty"`
	// disable_catch disables agent panic/error catching for debugging.
	DisableCatch bool `protobuf:"varint,2,opt,name=disable_catch,json=disableCatch,proto3" json:"disable_catch,omitempty"`
	// Identity of the service
	Identity *v0.ServiceIdentity `protobuf:"bytes,3,opt,name=identity,proto3" json:"identity,omitempty"`
	// creation_mode configures interactive scaffolding behavior.
	CreationMode *CreationMode `protobuf:"bytes,4,opt,name=creation_mode,json=creationMode,proto3" json:"creation_mode,omitempty"`
	// sync_mode configures interactive synchronization behavior.
	SyncMode *SyncMode `protobuf:"bytes,5,opt,name=sync_mode,json=syncMode,proto3" json:"sync_mode,omitempty"`
	// contains filtered or unexported fields
}

type LoadResponse struct {

	// state is the machine-readable lifecycle state.
	State *LoadStatus `protobuf:"bytes,1,opt,name=state,proto3" json:"state,omitempty"`
	// version is the semantic or service-specific version for this resource.
	Version *v0.Version `protobuf:"bytes,2,opt,name=version,proto3" json:"version,omitempty"`
	// endpoints are logical endpoints the builder knows the service will expose.
	Endpoints []*v0.Endpoint `protobuf:"bytes,3,rep,name=endpoints,proto3" json:"endpoints,omitempty"`
	// getting_started is human-facing guidance printed after scaffolding or loading.
	GettingStarted string `protobuf:"bytes,4,opt,name=getting_started,json=gettingStarted,proto3" json:"getting_started,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.builder.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"`
	// contains filtered or unexported fields
}

type LoadStatus_Status int32

type OutdatedDep struct {

	// package is the package, dependency, or artifact name.
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// current is the currently installed dependency version.
	Current string `protobuf:"bytes,2,opt,name=current,proto3" json:"current,omitempty"`
	// latest_safe is the newest compatible version that should not require a breaking upgrade.
	LatestSafe string `protobuf:"bytes,3,opt,name=latest_safe,json=latestSafe,proto3" json:"latest_safe,omitempty"` // newest patch+minor without crossing major
	// latest_major is the newest major version discovered by the audit.
	LatestMajor string `protobuf:"bytes,4,opt,name=latest_major,json=latestMajor,proto3" json:"latest_major,omitempty"` // newest including major bump
	// contains filtered or unexported fields
}

type SyncMode struct {

	// communicate enables interactive agent questions during this mode.
	Communicate bool `protobuf:"varint,1,opt,name=communicate,proto3" json:"communicate,omitempty"`
	// contains filtered or unexported fields
}

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

type SyncResponse struct {

	// state is the machine-readable lifecycle state.
	State *SyncStatus `protobuf:"bytes,1,opt,name=state,proto3" json:"state,omitempty"`
	// contains filtered or unexported fields
}

type SyncStatus struct {

	// state is the machine-readable lifecycle state.
	State SyncStatus_Status `protobuf:"varint,1,opt,name=state,proto3,enum=codefly.services.builder.v0.SyncStatus_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"`
	// contains filtered or unexported fields
}

type SyncStatus_Status int32

type UnimplementedBuilderServer struct{}

type UnsafeBuilderServer interface {
	// contains filtered or unexported methods
}

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

type UpdateResponse struct {

	// state is the machine-readable lifecycle state.
	State *UpdateStatus `protobuf:"bytes,1,opt,name=state,proto3" json:"state,omitempty"`
	// contains filtered or unexported fields
}

type UpdateStatus struct {

	// state is the machine-readable lifecycle state.
	State UpdateStatus_Status `protobuf:"varint,1,opt,name=state,proto3,enum=codefly.services.builder.v0.UpdateStatus_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"`
	// contains filtered or unexported fields
}

type UpdateStatus_Status int32

type UpgradeChange struct {

	// package is the package, dependency, or artifact name.
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// from is the currently installed version.
	From string `protobuf:"bytes,2,opt,name=from,proto3" json:"from,omitempty"`
	// to is the version selected by the upgrade.
	To string `protobuf:"bytes,3,opt,name=to,proto3" json:"to,omitempty"`
	// contains filtered or unexported fields
}

type UpgradeRequest struct {

	// include_major also bumps across major-version boundaries. Default false.
	IncludeMajor bool `protobuf:"varint,1,opt,name=include_major,json=includeMajor,proto3" json:"include_major,omitempty"`
	// dry_run reports the changes that would be made without modifying
	// any files. The response still has fully-populated `changes`.
	DryRun bool `protobuf:"varint,2,opt,name=dry_run,json=dryRun,proto3" json:"dry_run,omitempty"`
	// only restricts upgrades to the named packages. Empty = all eligible.
	Only []string `protobuf:"bytes,3,rep,name=only,proto3" json:"only,omitempty"`
	// contains filtered or unexported fields
}

type UpgradeResponse struct {

	// state is the machine-readable lifecycle state.
	State *UpgradeStatus `protobuf:"bytes,1,opt,name=state,proto3" json:"state,omitempty"`
	// changes are dependency updates applied or proposed by the upgrade.
	Changes []*UpgradeChange `protobuf:"bytes,2,rep,name=changes,proto3" json:"changes,omitempty"`
	// lockfile_diff is a free-form summary (e.g. truncated `git diff`)
	// for the human-facing CLI output. Optional.
	LockfileDiff string `protobuf:"bytes,3,opt,name=lockfile_diff,json=lockfileDiff,proto3" json:"lockfile_diff,omitempty"`
	// contains filtered or unexported fields
}

type UpgradeStatus struct {

	// state is the machine-readable lifecycle state.
	State UpgradeStatus_Status `protobuf:"varint,1,opt,name=state,proto3,enum=codefly.services.builder.v0.UpgradeStatus_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"`
	// contains filtered or unexported fields
}

type UpgradeStatus_Status int32