v0

type AgentClient interface {
	// GetAgentInformation returns the agent manifest, capabilities, and configuration docs.
	GetAgentInformation(ctx context.Context, in *AgentInformationRequest, opts ...grpc.CallOption) (*AgentInformation, error)
	// ListCommands returns the commands this plugin agent provides.
	ListCommands(ctx context.Context, in *ListCommandsRequest, opts ...grpc.CallOption) (*ListCommandsResponse, error)
	// RunPluginCommand executes a plugin-provided command.
	RunPluginCommand(ctx context.Context, in *RunPluginCommandRequest, opts ...grpc.CallOption) (*RunPluginCommandResponse, error)
}

type AgentInformation struct {

	// capabilities describes which optional protocol features are supported.
	Capabilities []*Capability `protobuf:"bytes,2,rep,name=capabilities,proto3" json:"capabilities,omitempty"`
	// protocols are endpoint protocols the agent can expose.
	Protocols []*Protocol `protobuf:"bytes,3,rep,name=protocols,proto3" json:"protocols,omitempty"`
	// languages are source languages the agent can create, run, or analyze.
	Languages []*Language `protobuf:"bytes,4,rep,name=languages,proto3" json:"languages,omitempty"`
	// read_me is the agent README or equivalent human-facing documentation.
	ReadMe string `protobuf:"bytes,5,opt,name=read_me,json=readMe,proto3" json:"read_me,omitempty"`
	// configuration_details documents service YAML fields understood by the agent.
	ConfigurationDetails []*ConfigurationValueDetail `protobuf:"bytes,6,rep,name=configuration_details,json=configurationDetails,proto3" json:"configuration_details,omitempty"`
	// techniques are reusable workflows or prompts the agent can apply.
	Techniques []*AgentTechnique `protobuf:"bytes,7,rep,name=techniques,proto3" json:"techniques,omitempty"`
	// supported_backends are the execution environments the service can run in
	// (LOCAL/NIX/DOCKER), in PREFERENCE ORDER: element [0] is the backend the
	// plugin prefers, the rest are acceptable fallbacks in descending preference.
	// The CLI resolves a "free" service to the first supported backend that is
	// actually available in the environment (Docker reachable, nix installed,
	// toolchain present), unless the user overrides via preferences.yaml or an
	// explicit runtime context. Example: Go advertises [LOCAL, NIX, DOCKER] —
	// prefer native, then a nix shell, then a container.
	SupportedBackends []*Backend `protobuf:"bytes,8,rep,name=supported_backends,json=supportedBackends,proto3" json:"supported_backends,omitempty"`
	// toolchains are host toolchains the user must have available to run the
	// service in LOCAL mode (ignored for NIX/DOCKER backends).
	Toolchains []*Toolchain `protobuf:"bytes,9,rep,name=toolchains,proto3" json:"toolchains,omitempty"`
	// validation is the authoritative validation contract for new agents. It is
	// absent for legacy agents, which keeps compatibility RPC probing explicit.
	Validation *ValidationCapabilities `protobuf:"bytes,10,opt,name=validation,proto3" json:"validation,omitempty"`
	// contains filtered or unexported fields
}

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

type AgentServer interface {
	// GetAgentInformation returns the agent manifest, capabilities, and configuration docs.
	GetAgentInformation(context.Context, *AgentInformationRequest) (*AgentInformation, error)
	// ListCommands returns the commands this plugin agent provides.
	ListCommands(context.Context, *ListCommandsRequest) (*ListCommandsResponse, error)
	// RunPluginCommand executes a plugin-provided command.
	RunPluginCommand(context.Context, *RunPluginCommandRequest) (*RunPluginCommandResponse, error)
	// contains filtered or unexported methods
}

type AgentTechnique struct {

	// id is the stable identifier for this record.
	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// name is the technique display name.
	Name string `protobuf:"bytes,2,opt,name=name,proto3" json:"name,omitempty"`
	// description explains when the technique should be used.
	Description string `protobuf:"bytes,3,opt,name=description,proto3" json:"description,omitempty"`
	// tags are labels used for filtering, grouping, or display.
	Tags []string `protobuf:"bytes,4,rep,name=tags,proto3" json:"tags,omitempty"`
	// prompt is the reusable instruction text for this technique.
	Prompt string `protobuf:"bytes,5,opt,name=prompt,proto3" json:"prompt,omitempty"`
	// contains filtered or unexported fields
}

type Answer struct {

	// value is the concrete answer payload returned by the CLI.
	//
	// Types that are valid to be assigned to Value:
	//
	//	*Answer_Confirm
	//	*Answer_Input
	//	*Answer_Choice
	//	*Answer_Selection
	Value isAnswer_Value `protobuf_oneof:"value"`
	// contains filtered or unexported fields
}

type Answer_Choice struct {
	// choice carries the ChoiceAnswer variant for Answer.
	Choice *ChoiceAnswer `protobuf:"bytes,7,opt,name=choice,proto3,oneof"`
}

type Answer_Confirm struct {
	// confirm carries the ConfirmAnswer variant for Answer.
	Confirm *ConfirmAnswer `protobuf:"bytes,5,opt,name=confirm,proto3,oneof"`
}

type Answer_Input struct {
	// input carries a scalar input answer.
	Input *InputAnswer `protobuf:"bytes,6,opt,name=input,proto3,oneof"`
}

type Answer_Selection struct {
	// selection carries the SelectionAnswer variant for Answer.
	Selection *SelectionAnswer `protobuf:"bytes,8,opt,name=selection,proto3,oneof"`
}

type Backend struct {

	// type is a supported execution backend.
	Type Backend_Type `protobuf:"varint,1,opt,name=type,proto3,enum=codefly.services.agent.v0.Backend_Type" json:"type,omitempty"`
	// contains filtered or unexported fields
}

type Backend_Type int32

type Bom struct {

	// bom_format is the SBOM format name, normally CycloneDX.
	BomFormat string `protobuf:"bytes,1,opt,name=bom_format,json=bomFormat,proto3" json:"bom_format,omitempty"` // Always "CycloneDX"
	// spec_version is the CycloneDX specification version.
	SpecVersion string `protobuf:"bytes,2,opt,name=spec_version,json=specVersion,proto3" json:"spec_version,omitempty"`
	// serial_number is the unique SBOM serial number.
	SerialNumber string `protobuf:"bytes,3,opt,name=serial_number,json=serialNumber,proto3" json:"serial_number,omitempty"`
	// version is the SBOM document version.
	Version int32 `protobuf:"varint,4,opt,name=version,proto3" json:"version,omitempty"`
	// components are software components included in the SBOM.
	Components []*Component `protobuf:"bytes,5,rep,name=components,proto3" json:"components,omitempty"`
	// dependencies is the direct dependency graph keyed by component bom_ref.
	Dependencies []*Dependency `protobuf:"bytes,6,rep,name=dependencies,proto3" json:"dependencies,omitempty"`
	// metadata identifies the SBOM subject and generator.
	Metadata *Metadata `protobuf:"bytes,7,opt,name=metadata,proto3" json:"metadata,omitempty"`
	// contains filtered or unexported fields
}

type Capability struct {

	// type is the advertised capability.
	Type Capability_Type `protobuf:"varint,1,opt,name=type,proto3,enum=codefly.services.agent.v0.Capability_Type" json:"type,omitempty"`
	// contains filtered or unexported fields
}

type Capability_Type int32

type Choice struct {

	// options are the choices shown to the user.
	Options []*Message `protobuf:"bytes,1,rep,name=options,proto3" json:"options,omitempty"`
	// default_option is the stable option name selected by non-interactive
	// callers. Empty means no default was declared.
	DefaultOption string `protobuf:"bytes,2,opt,name=default_option,json=defaultOption,proto3" json:"default_option,omitempty"`
	// contains filtered or unexported fields
}

type ChoiceAnswer struct {

	// option is the selected choice value.
	Option string `protobuf:"bytes,1,opt,name=option,proto3" json:"option,omitempty"`
	// contains filtered or unexported fields
}

type CommandDefinition struct {

	// name is the command name exposed by the plugin.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` // e.g. "reset_db", "deploy", "migrate"
	// description tells users and agents when to run this command.
	Description string `protobuf:"bytes,2,opt,name=description,proto3" json:"description,omitempty"` // "Reset the database to a clean state"
	// usage is the command-line shape shown to users and agents.
	Usage string `protobuf:"bytes,3,opt,name=usage,proto3" json:"usage,omitempty"` // "! reset_db [--seed]"
	// aliases are alternate command names accepted by the plugin.
	Aliases []string `protobuf:"bytes,4,rep,name=aliases,proto3" json:"aliases,omitempty"` // ["reset-db", "db-reset"]
	// tags are labels used for filtering, grouping, or display.
	Tags []string `protobuf:"bytes,5,rep,name=tags,proto3" json:"tags,omitempty"` // ["database", "destructive"]
	// plugin identifies the plugin that provides this command; empty means built-in.
	Plugin string `protobuf:"bytes,6,opt,name=plugin,proto3" json:"plugin,omitempty"` // which plugin provides this command
	// destructive is true when the operation can mutate or delete user state.
	Destructive bool `protobuf:"varint,7,opt,name=destructive,proto3" json:"destructive,omitempty"` // if true, requires confirmation before execution
	// needs_gateway is true when the command must call through the Mind gateway.
	NeedsGateway bool `protobuf:"varint,8,opt,name=needs_gateway,json=needsGateway,proto3" json:"needs_gateway,omitempty"` // if true, requires a gateway connection
	// contains filtered or unexported fields
}

type Component struct {

	// name is the component name.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// version is the component version.
	Version string `protobuf:"bytes,2,opt,name=version,proto3" json:"version,omitempty"`
	// type is the CycloneDX component category.
	Type ComponentType `protobuf:"varint,3,opt,name=type,proto3,enum=codefly.services.agent.v0.ComponentType" json:"type,omitempty"`
	// group is the CycloneDX component group or package namespace.
	Group string `protobuf:"bytes,4,opt,name=group,proto3" json:"group,omitempty"` // Optional
	// purl is the package URL identifying a software component.
	Purl string `protobuf:"bytes,5,opt,name=purl,proto3" json:"purl,omitempty"` // Package URL
	// bom_ref is the stable identifier used by dependency relationships.
	BomRef string `protobuf:"bytes,6,opt,name=bom_ref,json=bomRef,proto3" json:"bom_ref,omitempty"`
	// licenses contains SPDX license identifiers declared by the component.
	Licenses []string `protobuf:"bytes,7,rep,name=licenses,proto3" json:"licenses,omitempty"`
	// hashes contains content digests when the package manager exposes them.
	Hashes []*Hash `protobuf:"bytes,8,rep,name=hashes,proto3" json:"hashes,omitempty"`
	// contains filtered or unexported fields
}

type ComponentType int32

type ConfigurationValueDetail struct {

	// name is the configuration detail group name.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// description explains the configuration group shown in generated docs.
	Description string `protobuf:"bytes,2,opt,name=description,proto3" json:"description,omitempty"`
	// fields are agent-specific structured settings from service YAML.
	Fields []*ConfigurationValueInformation `protobuf:"bytes,3,rep,name=fields,proto3" json:"fields,omitempty"`
	// contains filtered or unexported fields
}

type ConfigurationValueInformation struct {

	// name is the configuration field name.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// description explains how to fill this configuration field.
	Description string `protobuf:"bytes,2,opt,name=description,proto3" json:"description,omitempty"`
	// contains filtered or unexported fields
}

type Confirm struct {

	// default is the preselected answer shown to the user.
	Default bool `protobuf:"varint,1,opt,name=default,proto3" json:"default,omitempty"`
	// contains filtered or unexported fields
}

type ConfirmAnswer struct {

	// confirmed is the boolean answer returned by a confirmation prompt.
	Confirmed bool `protobuf:"varint,1,opt,name=confirmed,proto3" json:"confirmed,omitempty"`
	// contains filtered or unexported fields
}

type Dependency struct {

	// ref identifies the component whose dependencies are listed.
	Ref string `protobuf:"bytes,1,opt,name=ref,proto3" json:"ref,omitempty"`
	// depends_on contains bom_ref values for direct dependencies.
	DependsOn []string `protobuf:"bytes,2,rep,name=depends_on,json=dependsOn,proto3" json:"depends_on,omitempty"`
	// contains filtered or unexported fields
}

type Display struct {

	// data contains structured key/value details to display.
	Data map[string]string `` /* 135-byte string literal not displayed */
	// contains filtered or unexported fields
}

type Hash struct {

	// algorithm is the canonical digest name, for example SHA-256 or SHA-512.
	Algorithm string `protobuf:"bytes,1,opt,name=algorithm,proto3" json:"algorithm,omitempty"`
	// content is the lowercase hexadecimal digest.
	Content string `protobuf:"bytes,2,opt,name=content,proto3" json:"content,omitempty"`
	// contains filtered or unexported fields
}

type Input struct {

	// default is the optional prompt prefill.
	//
	// Types that are valid to be assigned to Default:
	//
	//	*Input_StringDefault
	//	*Input_IntDefault
	Default isInput_Default `protobuf_oneof:"default"`
	// contains filtered or unexported fields
}

type InputAnswer struct {

	// answer selects exactly one supported answer variant.
	//
	// Types that are valid to be assigned to Answer:
	//
	//	*InputAnswer_StringValue
	//	*InputAnswer_IntValue
	Answer isInputAnswer_Answer `protobuf_oneof:"answer"`
	// contains filtered or unexported fields
}

type InputAnswer_IntValue struct {
	// int_value carries the int32 variant for InputAnswer.
	IntValue int32 `protobuf:"varint,2,opt,name=int_value,json=intValue,proto3,oneof"`
}

type InputAnswer_StringValue struct {
	// string_value carries the string variant for InputAnswer.
	StringValue string `protobuf:"bytes,1,opt,name=string_value,json=stringValue,proto3,oneof"`
}

type Input_IntDefault struct {
	// int_default carries the int32 variant for Input.
	IntDefault int32 `protobuf:"varint,2,opt,name=int_default,json=intDefault,proto3,oneof"`
}

type Input_StringDefault struct {
	// string_default carries the string variant for Input.
	StringDefault string `protobuf:"bytes,1,opt,name=string_default,json=stringDefault,proto3,oneof"`
}

type Language struct {

	// type is the language represented by this entry.
	Type Language_Type `protobuf:"varint,1,opt,name=type,proto3,enum=codefly.services.agent.v0.Language_Type" json:"type,omitempty"`
	// contains filtered or unexported fields
}

type Language_Type int32

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

type ListCommandsResponse struct {

	// commands are plugin or built-in commands available to callers.
	Commands []*CommandDefinition `protobuf:"bytes,1,rep,name=commands,proto3" json:"commands,omitempty"`
	// contains filtered or unexported fields
}

type Message struct {

	// name is the stable option or field name.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// message is the primary text shown to the user.
	Message string `protobuf:"bytes,2,opt,name=message,proto3" json:"message,omitempty"`
	// description provides optional help text for the prompt.
	Description string `protobuf:"bytes,3,opt,name=description,proto3" json:"description,omitempty"`
	// contains filtered or unexported fields
}

type Metadata struct {

	// timestamp is an RFC3339 UTC generation time.
	Timestamp string `protobuf:"bytes,1,opt,name=timestamp,proto3" json:"timestamp,omitempty"`
	// component is the root application, module, or artifact being described.
	Component *Component `protobuf:"bytes,2,opt,name=component,proto3" json:"component,omitempty"`
	// tools identifies every generator involved in producing the document.
	Tools []*Tool `protobuf:"bytes,3,rep,name=tools,proto3" json:"tools,omitempty"`
	// contains filtered or unexported fields
}

type Protocol struct {

	// type is the protocol represented by this entry.
	Type Protocol_Type `protobuf:"varint,1,opt,name=type,proto3,enum=codefly.services.agent.v0.Protocol_Type" json:"type,omitempty"`
	// contains filtered or unexported fields
}

type Protocol_Type int32

type Question struct {

	// message is a human-readable status or diagnostic summary.
	Message *Message `protobuf:"bytes,3,opt,name=message,proto3" json:"message,omitempty"`
	// value is the concrete question payload the plugin wants answered.
	//
	// Types that are valid to be assigned to Value:
	//
	//	*Question_Display
	//	*Question_Confirm
	//	*Question_Input
	//	*Question_Choice
	//	*Question_Selection
	Value isQuestion_Value `protobuf_oneof:"value"`
	// contains filtered or unexported fields
}

type Question_Choice struct {
	// choice carries the Choice variant for Question.
	Choice *Choice `protobuf:"bytes,7,opt,name=choice,proto3,oneof"`
}

type Question_Confirm struct {
	// confirm carries the Confirm variant for Question.
	Confirm *Confirm `protobuf:"bytes,5,opt,name=confirm,proto3,oneof"`
}

type Question_Display struct {
	// display carries the Display variant for Question.
	Display *Display `protobuf:"bytes,4,opt,name=display,proto3,oneof"`
}

type Question_Input struct {
	// input carries a scalar input prompt.
	Input *Input `protobuf:"bytes,6,opt,name=input,proto3,oneof"`
}

type Question_Selection struct {
	// selection carries the Selection variant for Question.
	Selection *Selection `protobuf:"bytes,8,opt,name=selection,proto3,oneof"`
}

type RunPluginCommandRequest struct {

	// command is the plugin command name to run.
	Command string `protobuf:"bytes,1,opt,name=command,proto3" json:"command,omitempty"`
	// args are command arguments passed to the plugin command handler.
	Args []string `protobuf:"bytes,2,rep,name=args,proto3" json:"args,omitempty"`
	// contains filtered or unexported fields
}

type RunPluginCommandResponse struct {

	// success is true when the requested operation completed successfully.
	Success bool `protobuf:"varint,1,opt,name=success,proto3" json:"success,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"`
	// error explains why the operation failed; empty means success at this layer.
	Error string `protobuf:"bytes,3,opt,name=error,proto3" json:"error,omitempty"`
	// failure is the structured plugin-neutral cause when success is false.
	Failure *v0.Failure `protobuf:"bytes,4,opt,name=failure,proto3" json:"failure,omitempty"`
	// contains filtered or unexported fields
}

type Selection struct {

	// options are the choices shown to the user.
	Options []*Message `protobuf:"bytes,1,rep,name=options,proto3" json:"options,omitempty"`
	// default is the selection used by non-interactive callers. A present
	// message with no options is an explicitly empty default.
	Default *SelectionDefault `protobuf:"bytes,2,opt,name=default,proto3" json:"default,omitempty"`
	// contains filtered or unexported fields
}

type SelectionAnswer struct {

	// selected contains the option names chosen by the user.
	Selected []string `protobuf:"bytes,1,rep,name=selected,proto3" json:"selected,omitempty"`
	// contains filtered or unexported fields
}

type SelectionDefault struct {

	// options are stable Message.name values.
	Options []string `protobuf:"bytes,1,rep,name=options,proto3" json:"options,omitempty"`
	// contains filtered or unexported fields
}

type TestDependencyMode int32

type TestSuiteCapability struct {

	// name is the value accepted by Runtime.Test's suite selection.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// dependency_mode controls which services remain live during this suite.
	DependencyMode TestDependencyMode `` /* 154-byte string literal not displayed */
	// default_suite marks the suite selected when no explicit suite was supplied.
	DefaultSuite bool `protobuf:"varint,3,opt,name=default_suite,json=defaultSuite,proto3" json:"default_suite,omitempty"`
	// contains filtered or unexported fields
}

type TestValidationCapability struct {

	// supported is authoritative when AgentInformation.validation is present.
	Supported bool `protobuf:"varint,1,opt,name=supported,proto3" json:"supported,omitempty"`
	// scopes are the semantic granularities Runtime.Test accepts.
	Scopes []ValidationScope `protobuf:"varint,2,rep,packed,name=scopes,proto3,enum=codefly.services.agent.v0.ValidationScope" json:"scopes,omitempty"`
	// suites are the named test suites the agent understands.
	Suites []*TestSuiteCapability `protobuf:"bytes,3,rep,name=suites,proto3" json:"suites,omitempty"`
	// contains filtered or unexported fields
}

type Tool struct {

	// vendor is the tool publisher.
	Vendor string `protobuf:"bytes,1,opt,name=vendor,proto3" json:"vendor,omitempty"`
	// name is the tool name.
	Name string `protobuf:"bytes,2,opt,name=name,proto3" json:"name,omitempty"`
	// version is the exact tool version or protocol revision.
	Version string `protobuf:"bytes,3,opt,name=version,proto3" json:"version,omitempty"`
	// contains filtered or unexported fields
}

type Toolchain struct {

	// type is the required toolchain.
	Type Toolchain_Type `protobuf:"varint,1,opt,name=type,proto3,enum=codefly.services.agent.v0.Toolchain_Type" json:"type,omitempty"`
	// version is the semantic or service-specific version for this toolchain.
	Version string `protobuf:"bytes,2,opt,name=version,proto3" json:"version,omitempty"`
	// contains filtered or unexported fields
}

type Toolchain_Type int32

type UnimplementedAgentServer struct{}

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

type ValidationCapabilities struct {

	// lint describes the Runtime.Lint operation.
	Lint *ValidationOperationCapability `protobuf:"bytes,1,opt,name=lint,proto3" json:"lint,omitempty"`
	// compile describes Runtime.Build (native compile/typecheck/application build).
	Compile *ValidationOperationCapability `protobuf:"bytes,2,opt,name=compile,proto3" json:"compile,omitempty"`
	// test describes Runtime.Test, its scopes, and named suites.
	Test *TestValidationCapability `protobuf:"bytes,3,opt,name=test,proto3" json:"test,omitempty"`
	// audit describes Builder.Audit.
	Audit *ValidationOperationCapability `protobuf:"bytes,4,opt,name=audit,proto3" json:"audit,omitempty"`
	// artifact_build describes Builder.Build's deployable artifact operation.
	ArtifactBuild *ValidationOperationCapability `protobuf:"bytes,5,opt,name=artifact_build,json=artifactBuild,proto3" json:"artifact_build,omitempty"`
	// sbom describes Builder.SBOM's authoritative component inventory.
	Sbom *ValidationOperationCapability `protobuf:"bytes,6,opt,name=sbom,proto3" json:"sbom,omitempty"`
	// sync describes Builder.Sync, including non-mutating drift detection.
	Sync *ValidationOperationCapability `protobuf:"bytes,7,opt,name=sync,proto3" json:"sync,omitempty"`
	// source_package describes Builder.Package, which emits portable release
	// artifacts from the loaded source resource without deployment semantics.
	SourcePackage *ValidationOperationCapability `protobuf:"bytes,8,opt,name=source_package,json=sourcePackage,proto3" json:"source_package,omitempty"`
	// contains filtered or unexported fields
}

type ValidationOperationCapability struct {

	// supported is authoritative when AgentInformation.validation is present.
	Supported bool `protobuf:"varint,1,opt,name=supported,proto3" json:"supported,omitempty"`
	// scopes are the semantic granularities the operation accepts.
	Scopes []ValidationScope `protobuf:"varint,2,rep,packed,name=scopes,proto3,enum=codefly.services.agent.v0.ValidationScope" json:"scopes,omitempty"`
	// contains filtered or unexported fields
}

type ValidationScope int32