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 {

	// runtime_requirements are toolchains the user must have available.
	RuntimeRequirements []*Runtime `protobuf:"bytes,1,rep,name=runtime_requirements,json=runtimeRequirements,proto3" json:"runtime_requirements,omitempty"`
	// 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"`
	// 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 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"` // Add other fields like metadata, dependencies, vulnerabilities, etc.
	// 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"`
	// 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
	// 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 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 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 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"`
	// contains filtered or unexported fields
}

type Runtime struct {

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

type Runtime_Type int32

type Selection struct {

	// options are the choices shown to the user.
	Options []*Message `protobuf:"bytes,1,rep,name=options,proto3" json:"options,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 UnimplementedAgentServer struct{}

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