gatewayv1

type AddDependencyRequest struct {

	// service is the Codefly service name, optionally scoped by module in callers.
	Service string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`
	// package_name is the package or dependency identifier used by the native manager.
	PackageName string `protobuf:"bytes,2,opt,name=package_name,json=packageName,proto3" json:"package_name,omitempty"`
	// version is the semantic or service-specific version for this resource.
	Version string `protobuf:"bytes,3,opt,name=version,proto3" json:"version,omitempty"`
	// contains filtered or unexported fields
}

type AddDependencyResponse struct {

	// success is true when the requested operation completed successfully.
	Success bool `protobuf:"varint,1,opt,name=success,proto3" json:"success,omitempty"`
	// error explains why the operation failed; empty means success at this layer.
	Error string `protobuf:"bytes,2,opt,name=error,proto3" json:"error,omitempty"`
	// installed_version is the version resolved by the package manager.
	InstalledVersion string `protobuf:"bytes,3,opt,name=installed_version,json=installedVersion,proto3" json:"installed_version,omitempty"`
	// contains filtered or unexported fields
}

type ApplyEditRequest struct {

	// service is the Codefly service name, optionally scoped by module in callers.
	Service string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`
	// file is a workspace- or service-relative source file path.
	File string `protobuf:"bytes,2,opt,name=file,proto3" json:"file,omitempty"` // relative to service root
	// find is the text or pattern to locate before applying an edit.
	Find string `protobuf:"bytes,3,opt,name=find,proto3" json:"find,omitempty"` // text to find (smart matching at plugin level)
	// replace is the replacement text used by an edit operation.
	Replace string `protobuf:"bytes,4,opt,name=replace,proto3" json:"replace,omitempty"` // replacement text
	// auto_fix asks the agent to run language fixers after editing.
	AutoFix bool `protobuf:"varint,5,opt,name=auto_fix,json=autoFix,proto3" json:"auto_fix,omitempty"` // if true, plugin runs fixers after edit
	// contains filtered or unexported fields
}

type ApplyEditResponse struct {

	// success is true when the requested operation completed successfully.
	Success bool `protobuf:"varint,1,opt,name=success,proto3" json:"success,omitempty"`
	// content is the file content after the edit and optional fixers.
	Content string `protobuf:"bytes,2,opt,name=content,proto3" json:"content,omitempty"` // file content after edit + fix
	// error explains why the operation failed; empty means success at this layer.
	Error string `protobuf:"bytes,3,opt,name=error,proto3" json:"error,omitempty"` // why the edit failed
	// strategy names the edit or execution strategy that produced the result.
	Strategy string `protobuf:"bytes,4,opt,name=strategy,proto3" json:"strategy,omitempty"` // which matching strategy
	// fix_actions names formatters or import fixers that ran after the edit.
	FixActions []string `protobuf:"bytes,5,rep,name=fix_actions,json=fixActions,proto3" json:"fix_actions,omitempty"` // fixers that ran
	// contains filtered or unexported fields
}

type AvailableCommand struct {

	// name is the command name accepted by the gateway.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` // e.g. "reset_db"
	// description tells users and agents when this command is useful.
	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"`
	// tags are labels used for filtering, grouping, or display.
	Tags []string `protobuf:"bytes,5,rep,name=tags,proto3" json:"tags,omitempty"`
	// 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, empty for built-in
	// 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 user confirmation
	// contains filtered or unexported fields
}

type BatchApplyEditsRequest struct {

	// edits are the requested edits, potentially spanning services.
	Edits []*ApplyEditRequest `protobuf:"bytes,1,rep,name=edits,proto3" json:"edits,omitempty"`
	// contains filtered or unexported fields
}

type BatchApplyEditsResponse struct {

	// results are per-item outcomes returned by the operation.
	Results []*EditResult `protobuf:"bytes,1,rep,name=results,proto3" json:"results,omitempty"`
	// succeeded is the number of edits that applied successfully.
	Succeeded int32 `protobuf:"varint,2,opt,name=succeeded,proto3" json:"succeeded,omitempty"`
	// failed is the number of edits that failed.
	Failed int32 `protobuf:"varint,3,opt,name=failed,proto3" json:"failed,omitempty"`
	// contains filtered or unexported fields
}

type BuildError struct {

	// file is a workspace- or service-relative source file path.
	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"`
	// message is the diagnostic text returned by the build or lint tool.
	Message string `protobuf:"bytes,4,opt,name=message,proto3" json:"message,omitempty"`
	// severity is the diagnostic or finding level reported by the producer.
	Severity string `protobuf:"bytes,5,opt,name=severity,proto3" json:"severity,omitempty"` // "error" | "warning"
	// contains filtered or unexported fields
}

type BuildRequest struct {

	// service is the Codefly service name, optionally scoped by module in callers.
	Service string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`
	// contains filtered or unexported fields
}

type BuildResponse struct {

	// success is true when the requested operation completed successfully.
	Success bool `protobuf:"varint,1,opt,name=success,proto3" json:"success,omitempty"`
	// errors are structured build diagnostics.
	Errors []*BuildError `protobuf:"bytes,2,rep,name=errors,proto3" json:"errors,omitempty"`
	// output is raw command, build, lint, or test output retained for diagnosis.
	Output string `protobuf:"bytes,3,opt,name=output,proto3" json:"output,omitempty"` // raw build output
	// contains filtered or unexported fields
}

type Check struct {

	// name is a caller-chosen identifier for this check.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// check_type selects exactly one supported check type variant.
	//
	// Types that are valid to be assigned to CheckType:
	//
	//	*Check_Command
	//	*Check_Http
	//	*Check_PluginBuild
	//	*Check_PluginTest
	//	*Check_PluginLint
	CheckType isCheck_CheckType `protobuf_oneof:"check_type"`
	// contains filtered or unexported fields
}

type CheckResult struct {

	// name matches the requested check name.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// passed is true when the check met its expected condition.
	Passed bool `protobuf:"varint,2,opt,name=passed,proto3" json:"passed,omitempty"`
	// output is raw command, build, lint, or test output preserved for diagnostics.
	Output string `protobuf:"bytes,3,opt,name=output,proto3" json:"output,omitempty"`
	// error explains why the operation failed; empty means success at this layer.
	Error string `protobuf:"bytes,4,opt,name=error,proto3" json:"error,omitempty"`
	// contains filtered or unexported fields
}

type Check_Command struct {
	// command runs a shell command and evaluates exit code or output.
	Command *CommandCheck `protobuf:"bytes,2,opt,name=command,proto3,oneof"`
}

type Check_Http struct {
	// http calls a service endpoint and evaluates the response.
	Http *HttpCheck `protobuf:"bytes,3,opt,name=http,proto3,oneof"`
}

type Check_PluginBuild struct {
	// plugin_build delegates to the service plugin's Build RPC.
	PluginBuild *PluginCheck `protobuf:"bytes,4,opt,name=plugin_build,json=pluginBuild,proto3,oneof"`
}

type Check_PluginLint struct {
	// plugin_lint delegates to the service plugin's Lint RPC.
	PluginLint *PluginCheck `protobuf:"bytes,6,opt,name=plugin_lint,json=pluginLint,proto3,oneof"`
}

type Check_PluginTest struct {
	// plugin_test delegates to the service plugin's Test RPC.
	PluginTest *PluginCheck `protobuf:"bytes,5,opt,name=plugin_test,json=pluginTest,proto3,oneof"`
}

type CommandCheck struct {

	// run is the command line executed by a command check.
	Run string `protobuf:"bytes,1,opt,name=run,proto3" json:"run,omitempty"`
	// expected_exit_code is the process status required for success.
	ExpectedExitCode int32 `protobuf:"varint,2,opt,name=expected_exit_code,json=expectedExitCode,proto3" json:"expected_exit_code,omitempty"`
	// output_contains is text that must appear in command output.
	OutputContains string `protobuf:"bytes,3,opt,name=output_contains,json=outputContains,proto3" json:"output_contains,omitempty"`
	// contains filtered or unexported fields
}

type CreateFileRequest struct {

	// service is the Codefly service name, optionally scoped by module in callers.
	Service string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`
	// path is a workspace- or service-relative filesystem path.
	Path string `protobuf:"bytes,2,opt,name=path,proto3" json:"path,omitempty"`
	// content is the initial file body to write.
	Content string `protobuf:"bytes,3,opt,name=content,proto3" json:"content,omitempty"`
	// overwrite allows CreateFile to replace an existing file when true.
	Overwrite bool `protobuf:"varint,4,opt,name=overwrite,proto3" json:"overwrite,omitempty"`
	// contains filtered or unexported fields
}

type CreateFileResponse struct {

	// success is true when the requested operation completed successfully.
	Success bool `protobuf:"varint,1,opt,name=success,proto3" json:"success,omitempty"`
	// error explains why the operation failed; empty means success at this layer.
	Error string `protobuf:"bytes,2,opt,name=error,proto3" json:"error,omitempty"`
	// contains filtered or unexported fields
}

type DeleteFileRequest struct {

	// service is the Codefly service name, optionally scoped by module in callers.
	Service string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`
	// path is a workspace- or service-relative filesystem path.
	Path string `protobuf:"bytes,2,opt,name=path,proto3" json:"path,omitempty"` // relative to service root
	// contains filtered or unexported fields
}

type DeleteFileResponse struct {

	// success is true when the requested operation completed successfully.
	Success bool `protobuf:"varint,1,opt,name=success,proto3" json:"success,omitempty"`
	// error explains why the operation failed; empty means success at this layer.
	Error string `protobuf:"bytes,2,opt,name=error,proto3" json:"error,omitempty"`
	// contains filtered or unexported fields
}

type Dependency struct {

	// name is the package, module, or dependency identifier.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// version is the semantic or service-specific version for this resource.
	Version string `protobuf:"bytes,2,opt,name=version,proto3" json:"version,omitempty"`
	// direct is true when the dependency is declared directly rather than transitively inferred.
	Direct bool `protobuf:"varint,3,opt,name=direct,proto3" json:"direct,omitempty"`
	// contains filtered or unexported fields
}

type Diagnostic struct {

	// file is a workspace- or service-relative source file path.
	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"`
	// end_line is the 1-based ending source line for a range.
	EndLine int32 `protobuf:"varint,4,opt,name=end_line,json=endLine,proto3" json:"end_line,omitempty"`
	// end_column is the 1-based ending source column for a range.
	EndColumn int32 `protobuf:"varint,5,opt,name=end_column,json=endColumn,proto3" json:"end_column,omitempty"`
	// message is the diagnostic text returned by the compiler, linter, or language server.
	Message string `protobuf:"bytes,6,opt,name=message,proto3" json:"message,omitempty"`
	// severity is the diagnostic or finding level reported by the producer.
	Severity string `protobuf:"bytes,7,opt,name=severity,proto3" json:"severity,omitempty"` // "error", "warning", "information", "hint"
	// source identifies the compiler, linter, language server, or tool that produced the item.
	Source string `protobuf:"bytes,8,opt,name=source,proto3" json:"source,omitempty"` // e.g. "gopls", "pylsp"
	// code is the diagnostic or rule identifier from the producing tool.
	Code string `protobuf:"bytes,9,opt,name=code,proto3" json:"code,omitempty"` // diagnostic code
	// contains filtered or unexported fields
}

type EditResult struct {

	// service is the Codefly service name, optionally scoped by module in callers.
	Service string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`
	// file is a workspace- or service-relative source file path.
	File string `protobuf:"bytes,2,opt,name=file,proto3" json:"file,omitempty"`
	// success is true when the requested operation completed successfully.
	Success bool `protobuf:"varint,3,opt,name=success,proto3" json:"success,omitempty"`
	// error explains why the operation failed; empty means success at this layer.
	Error string `protobuf:"bytes,4,opt,name=error,proto3" json:"error,omitempty"`
	// strategy names the edit or execution strategy that produced the result.
	Strategy string `protobuf:"bytes,5,opt,name=strategy,proto3" json:"strategy,omitempty"`
	// contains filtered or unexported fields
}

type FileInfo struct {

	// path is a workspace- or service-relative filesystem path.
	Path string `protobuf:"bytes,1,opt,name=path,proto3" json:"path,omitempty"` // relative path within the service
	// size_bytes is the file size in bytes.
	SizeBytes int64 `protobuf:"varint,2,opt,name=size_bytes,json=sizeBytes,proto3" json:"size_bytes,omitempty"`
	// is_directory is true when the path is a directory.
	IsDirectory bool `protobuf:"varint,3,opt,name=is_directory,json=isDirectory,proto3" json:"is_directory,omitempty"`
	// contains filtered or unexported fields
}

type FindReferencesRequest struct {

	// service is the Codefly service name, optionally scoped by module in callers.
	Service string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`
	// file is a workspace- or service-relative source file path.
	File string `protobuf:"bytes,2,opt,name=file,proto3" json:"file,omitempty"`
	// line is the 1-based source line number.
	Line int32 `protobuf:"varint,3,opt,name=line,proto3" json:"line,omitempty"`
	// column is the 1-based source column number when known.
	Column int32 `protobuf:"varint,4,opt,name=column,proto3" json:"column,omitempty"`
	// contains filtered or unexported fields
}

type FindReferencesResponse struct {

	// locations are reference locations returned by the language server.
	Locations []*Location `protobuf:"bytes,1,rep,name=locations,proto3" json:"locations,omitempty"`
	// error explains why the operation failed; empty means success at this layer.
	Error string `protobuf:"bytes,2,opt,name=error,proto3" json:"error,omitempty"`
	// contains filtered or unexported fields
}

type FixRequest struct {

	// service is the Codefly service name, optionally scoped by module in callers.
	Service string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`
	// path is a workspace- or service-relative filesystem path.
	Path string `protobuf:"bytes,2,opt,name=path,proto3" json:"path,omitempty"` // relative to service root
	// contains filtered or unexported fields
}

type FixResponse struct {

	// success is true when the requested operation completed successfully.
	Success bool `protobuf:"varint,1,opt,name=success,proto3" json:"success,omitempty"`
	// content is the fixed file content; it may be empty when no rewrite was needed.
	Content string `protobuf:"bytes,2,opt,name=content,proto3" json:"content,omitempty"` // the fixed file content (empty if unchanged)
	// error explains why the operation failed; empty means success at this layer.
	Error string `protobuf:"bytes,3,opt,name=error,proto3" json:"error,omitempty"` // non-fatal: fixer not available, etc.
	// actions are native formatter, fixer, or lifecycle actions performed by the agent.
	Actions []string `protobuf:"bytes,4,rep,name=actions,proto3" json:"actions,omitempty"` // what was done: "goimports", "gofmt", etc.
	// contains filtered or unexported fields
}

type GatewayClient interface {
	// ListServices returns all services known to the gateway.
	ListServices(ctx context.Context, in *ListServicesRequest, opts ...grpc.CallOption) (*ListServicesResponse, error)
	// ReadFile reads a file from a service's source tree.
	ReadFile(ctx context.Context, in *ReadFileRequest, opts ...grpc.CallOption) (*ReadFileResponse, error)
	// WriteFile writes (creates or overwrites) a file in a service's source tree.
	WriteFile(ctx context.Context, in *WriteFileRequest, opts ...grpc.CallOption) (*WriteFileResponse, error)
	// ListFiles lists files in a service's source tree.
	ListFiles(ctx context.Context, in *ListFilesRequest, opts ...grpc.CallOption) (*ListFilesResponse, error)
	// DeleteFile removes a file from a service's source tree.
	DeleteFile(ctx context.Context, in *DeleteFileRequest, opts ...grpc.CallOption) (*DeleteFileResponse, error)
	// MoveFile renames or moves a file, optionally updating imports.
	MoveFile(ctx context.Context, in *MoveFileRequest, opts ...grpc.CallOption) (*MoveFileResponse, error)
	// CreateFile creates a new file (fails if exists unless overwrite set).
	CreateFile(ctx context.Context, in *CreateFileRequest, opts ...grpc.CallOption) (*CreateFileResponse, error)
	// ListSymbols returns code symbols from a service via LSP.
	// If service is empty, returns symbols across all services.
	ListSymbols(ctx context.Context, in *ListSymbolsRequest, opts ...grpc.CallOption) (*ListSymbolsResponse, error)
	// GetDiagnostics returns compiler/linter diagnostics from the language server.
	GetDiagnostics(ctx context.Context, in *GetDiagnosticsRequest, opts ...grpc.CallOption) (*GetDiagnosticsResponse, error)
	// GoToDefinition finds where a symbol at a given position is defined.
	GoToDefinition(ctx context.Context, in *GoToDefinitionRequest, opts ...grpc.CallOption) (*GoToDefinitionResponse, error)
	// FindReferences finds all usages of a symbol at a given position.
	FindReferences(ctx context.Context, in *FindReferencesRequest, opts ...grpc.CallOption) (*FindReferencesResponse, error)
	// RenameSymbol performs a language-aware rename across all files.
	RenameSymbol(ctx context.Context, in *RenameSymbolRequest, opts ...grpc.CallOption) (*RenameSymbolResponse, error)
	// GetHoverInfo returns type info and documentation at a position.
	GetHoverInfo(ctx context.Context, in *GetHoverInfoRequest, opts ...grpc.CallOption) (*GetHoverInfoResponse, error)
	// Fix runs language-specific fixers on a file (goimports, gofmt, prettier, etc.).
	Fix(ctx context.Context, in *FixRequest, opts ...grpc.CallOption) (*FixResponse, error)
	// ApplyEdit performs a smart FIND/REPLACE on a file.
	ApplyEdit(ctx context.Context, in *ApplyEditRequest, opts ...grpc.CallOption) (*ApplyEditResponse, error)
	// BatchApplyEdits applies multiple edits atomically across files/services.
	BatchApplyEdits(ctx context.Context, in *BatchApplyEditsRequest, opts ...grpc.CallOption) (*BatchApplyEditsResponse, error)
	// Search performs text search across a service's source tree.
	Search(ctx context.Context, in *SearchRequest, opts ...grpc.CallOption) (*SearchResponse, error)
	// Build compiles the service (and its dependencies if needed).
	Build(ctx context.Context, in *BuildRequest, opts ...grpc.CallOption) (*BuildResponse, error)
	// Lint runs the configured lint command on the service.
	Lint(ctx context.Context, in *LintRequest, opts ...grpc.CallOption) (*LintResponse, error)
	// Test runs the configured test command on the service.
	Test(ctx context.Context, in *TestRequest, opts ...grpc.CallOption) (*TestResponse, error)
	// RunCommand executes an arbitrary command in the service context.
	RunCommand(ctx context.Context, in *RunCommandRequest, opts ...grpc.CallOption) (*RunCommandResponse, error)
	// ListAllCommands returns commands from all loaded plugins plus built-in ones.
	ListAllCommands(ctx context.Context, in *ListAllCommandsRequest, opts ...grpc.CallOption) (*ListAllCommandsResponse, error)
	// RunChecks executes a set of verification checks against the service.
	RunChecks(ctx context.Context, in *RunChecksRequest, opts ...grpc.CallOption) (*RunChecksResponse, error)
	// GitStatus returns the current git status of modified/staged/untracked files.
	GitStatus(ctx context.Context, in *GitStatusRequest, opts ...grpc.CallOption) (*GitStatusResponse, error)
	// GitDiff shows changes (unstaged or staged).
	GitDiff(ctx context.Context, in *GitDiffRequest, opts ...grpc.CallOption) (*GitDiffResponse, error)
	// GitLog returns recent commit history.
	GitLog(ctx context.Context, in *GitLogRequest, opts ...grpc.CallOption) (*GitLogResponse, error)
	// GitCommit commits staged changes.
	GitCommit(ctx context.Context, in *GitCommitRequest, opts ...grpc.CallOption) (*GitCommitResponse, error)
	// ListDependencies returns all dependencies with versions.
	ListDependencies(ctx context.Context, in *ListDependenciesRequest, opts ...grpc.CallOption) (*ListDependenciesResponse, error)
	// AddDependency adds a package via the language package manager.
	AddDependency(ctx context.Context, in *AddDependencyRequest, opts ...grpc.CallOption) (*AddDependencyResponse, error)
	// RemoveDependency removes a package via the language package manager.
	RemoveDependency(ctx context.Context, in *RemoveDependencyRequest, opts ...grpc.CallOption) (*RemoveDependencyResponse, error)
	// GetProjectInfo returns rich project metadata: module, packages, deps, file hashes.
	GetProjectInfo(ctx context.Context, in *GetProjectInfoRequest, opts ...grpc.CallOption) (*GetProjectInfoResponse, error)
}

type GatewayServer interface {
	// ListServices returns all services known to the gateway.
	ListServices(context.Context, *ListServicesRequest) (*ListServicesResponse, error)
	// ReadFile reads a file from a service's source tree.
	ReadFile(context.Context, *ReadFileRequest) (*ReadFileResponse, error)
	// WriteFile writes (creates or overwrites) a file in a service's source tree.
	WriteFile(context.Context, *WriteFileRequest) (*WriteFileResponse, error)
	// ListFiles lists files in a service's source tree.
	ListFiles(context.Context, *ListFilesRequest) (*ListFilesResponse, error)
	// DeleteFile removes a file from a service's source tree.
	DeleteFile(context.Context, *DeleteFileRequest) (*DeleteFileResponse, error)
	// MoveFile renames or moves a file, optionally updating imports.
	MoveFile(context.Context, *MoveFileRequest) (*MoveFileResponse, error)
	// CreateFile creates a new file (fails if exists unless overwrite set).
	CreateFile(context.Context, *CreateFileRequest) (*CreateFileResponse, error)
	// ListSymbols returns code symbols from a service via LSP.
	// If service is empty, returns symbols across all services.
	ListSymbols(context.Context, *ListSymbolsRequest) (*ListSymbolsResponse, error)
	// GetDiagnostics returns compiler/linter diagnostics from the language server.
	GetDiagnostics(context.Context, *GetDiagnosticsRequest) (*GetDiagnosticsResponse, error)
	// GoToDefinition finds where a symbol at a given position is defined.
	GoToDefinition(context.Context, *GoToDefinitionRequest) (*GoToDefinitionResponse, error)
	// FindReferences finds all usages of a symbol at a given position.
	FindReferences(context.Context, *FindReferencesRequest) (*FindReferencesResponse, error)
	// RenameSymbol performs a language-aware rename across all files.
	RenameSymbol(context.Context, *RenameSymbolRequest) (*RenameSymbolResponse, error)
	// GetHoverInfo returns type info and documentation at a position.
	GetHoverInfo(context.Context, *GetHoverInfoRequest) (*GetHoverInfoResponse, error)
	// Fix runs language-specific fixers on a file (goimports, gofmt, prettier, etc.).
	Fix(context.Context, *FixRequest) (*FixResponse, error)
	// ApplyEdit performs a smart FIND/REPLACE on a file.
	ApplyEdit(context.Context, *ApplyEditRequest) (*ApplyEditResponse, error)
	// BatchApplyEdits applies multiple edits atomically across files/services.
	BatchApplyEdits(context.Context, *BatchApplyEditsRequest) (*BatchApplyEditsResponse, error)
	// Search performs text search across a service's source tree.
	Search(context.Context, *SearchRequest) (*SearchResponse, error)
	// Build compiles the service (and its dependencies if needed).
	Build(context.Context, *BuildRequest) (*BuildResponse, error)
	// Lint runs the configured lint command on the service.
	Lint(context.Context, *LintRequest) (*LintResponse, error)
	// Test runs the configured test command on the service.
	Test(context.Context, *TestRequest) (*TestResponse, error)
	// RunCommand executes an arbitrary command in the service context.
	RunCommand(context.Context, *RunCommandRequest) (*RunCommandResponse, error)
	// ListAllCommands returns commands from all loaded plugins plus built-in ones.
	ListAllCommands(context.Context, *ListAllCommandsRequest) (*ListAllCommandsResponse, error)
	// RunChecks executes a set of verification checks against the service.
	RunChecks(context.Context, *RunChecksRequest) (*RunChecksResponse, error)
	// GitStatus returns the current git status of modified/staged/untracked files.
	GitStatus(context.Context, *GitStatusRequest) (*GitStatusResponse, error)
	// GitDiff shows changes (unstaged or staged).
	GitDiff(context.Context, *GitDiffRequest) (*GitDiffResponse, error)
	// GitLog returns recent commit history.
	GitLog(context.Context, *GitLogRequest) (*GitLogResponse, error)
	// GitCommit commits staged changes.
	GitCommit(context.Context, *GitCommitRequest) (*GitCommitResponse, error)
	// ListDependencies returns all dependencies with versions.
	ListDependencies(context.Context, *ListDependenciesRequest) (*ListDependenciesResponse, error)
	// AddDependency adds a package via the language package manager.
	AddDependency(context.Context, *AddDependencyRequest) (*AddDependencyResponse, error)
	// RemoveDependency removes a package via the language package manager.
	RemoveDependency(context.Context, *RemoveDependencyRequest) (*RemoveDependencyResponse, error)
	// GetProjectInfo returns rich project metadata: module, packages, deps, file hashes.
	GetProjectInfo(context.Context, *GetProjectInfoRequest) (*GetProjectInfoResponse, error)
	// contains filtered or unexported methods
}

type GetDiagnosticsRequest struct {

	// service is the Codefly service name, optionally scoped by module in callers.
	Service string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`
	// file is a workspace- or service-relative source file path.
	File string `protobuf:"bytes,2,opt,name=file,proto3" json:"file,omitempty"` // optional: restrict to a single file
	// contains filtered or unexported fields
}

type GetDiagnosticsResponse struct {

	// diagnostics are compiler, linter, or language-server findings.
	Diagnostics []*Diagnostic `protobuf:"bytes,1,rep,name=diagnostics,proto3" json:"diagnostics,omitempty"`
	// error explains why the operation failed; empty means success at this layer.
	Error string `protobuf:"bytes,2,opt,name=error,proto3" json:"error,omitempty"`
	// contains filtered or unexported fields
}

type GetHoverInfoRequest struct {

	// service is the Codefly service name, optionally scoped by module in callers.
	Service string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`
	// file is a workspace- or service-relative source file path.
	File string `protobuf:"bytes,2,opt,name=file,proto3" json:"file,omitempty"`
	// line is the 1-based source line number.
	Line int32 `protobuf:"varint,3,opt,name=line,proto3" json:"line,omitempty"`
	// column is the 1-based source column number when known.
	Column int32 `protobuf:"varint,4,opt,name=column,proto3" json:"column,omitempty"`
	// contains filtered or unexported fields
}

type GetHoverInfoResponse struct {

	// content is hover content, often markdown from the language server.
	Content string `protobuf:"bytes,1,opt,name=content,proto3" json:"content,omitempty"`
	// language is the implementation language reported by tooling or project metadata.
	Language string `protobuf:"bytes,2,opt,name=language,proto3" json:"language,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 GetProjectInfoRequest struct {

	// service is the Codefly service name, optionally scoped by module in callers.
	Service string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`
	// contains filtered or unexported fields
}

type GetProjectInfoResponse struct {

	// module is the Codefly module name that groups services.
	Module string `protobuf:"bytes,1,opt,name=module,proto3" json:"module,omitempty"` // e.g. "github.com/codefly-dev/mind"
	// language is the implementation language detected for this service or project.
	Language string `protobuf:"bytes,2,opt,name=language,proto3" json:"language,omitempty"` // e.g. "go"
	// language_version is the detected compiler or runtime version.
	LanguageVersion string `protobuf:"bytes,3,opt,name=language_version,json=languageVersion,proto3" json:"language_version,omitempty"` // e.g. "1.25"
	// packages describes the package or module layout within the service.
	Packages []*PackageInfo `protobuf:"bytes,4,rep,name=packages,proto3" json:"packages,omitempty"` // package structure
	// dependencies are packages discovered from manifests or lock files.
	Dependencies []*Dependency `protobuf:"bytes,5,rep,name=dependencies,proto3" json:"dependencies,omitempty"` // reuse existing Dependency message
	// file_hashes maps source paths to content hashes for change detection.
	FileHashes map[string]string `` // path -> SHA-256 for change detection
	/* 165-byte string literal not displayed */
	// error explains why the operation failed; empty means success at this layer.
	Error string `protobuf:"bytes,7,opt,name=error,proto3" json:"error,omitempty"`
	// contains filtered or unexported fields
}

type GitCommitInfo struct {

	// hash is the full git commit or content hash.
	Hash string `protobuf:"bytes,1,opt,name=hash,proto3" json:"hash,omitempty"`
	// short_hash is the abbreviated git commit hash.
	ShortHash string `protobuf:"bytes,2,opt,name=short_hash,json=shortHash,proto3" json:"short_hash,omitempty"`
	// author is the commit author identity.
	Author string `protobuf:"bytes,3,opt,name=author,proto3" json:"author,omitempty"`
	// message is the first line of the commit message.
	Message string `protobuf:"bytes,4,opt,name=message,proto3" json:"message,omitempty"`
	// date is the commit timestamp as reported by git.
	Date string `protobuf:"bytes,5,opt,name=date,proto3" json:"date,omitempty"`
	// contains filtered or unexported fields
}

type GitCommitRequest struct {

	// message is the commit message to use.
	Message string `protobuf:"bytes,1,opt,name=message,proto3" json:"message,omitempty"`
	// paths optionally restrict the commit to specific files.
	Paths []string `protobuf:"bytes,2,rep,name=paths,proto3" json:"paths,omitempty"` // optional: specific files to commit
	// contains filtered or unexported fields
}

type GitCommitResponse struct {

	// success is true when the requested operation completed successfully.
	Success bool `protobuf:"varint,1,opt,name=success,proto3" json:"success,omitempty"`
	// hash is the full git commit or content hash.
	Hash string `protobuf:"bytes,2,opt,name=hash,proto3" json:"hash,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 GitDiffRequest struct {

	// service is the Codefly service name, optionally scoped by module in callers.
	Service string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`
	// path is a workspace- or service-relative filesystem path.
	Path string `protobuf:"bytes,2,opt,name=path,proto3" json:"path,omitempty"` // optional: restrict to a file
	// staged selects or reports the git index instead of the worktree.
	Staged bool `protobuf:"varint,3,opt,name=staged,proto3" json:"staged,omitempty"` // if true, show staged changes
	// contains filtered or unexported fields
}

type GitDiffResponse struct {

	// diff is the unified git diff text.
	Diff string `protobuf:"bytes,1,opt,name=diff,proto3" json:"diff,omitempty"`
	// error explains why the operation failed; empty means success at this layer.
	Error string `protobuf:"bytes,2,opt,name=error,proto3" json:"error,omitempty"`
	// contains filtered or unexported fields
}

type GitFileStatus struct {

	// path is a workspace- or service-relative filesystem path.
	Path string `protobuf:"bytes,1,opt,name=path,proto3" json:"path,omitempty"`
	// status is the git, lifecycle, diagnostic, or operation state for this item.
	Status string `protobuf:"bytes,2,opt,name=status,proto3" json:"status,omitempty"` // "modified", "added", "deleted", "untracked", "renamed", "copied"
	// staged selects or reports the git index instead of the worktree.
	Staged bool `protobuf:"varint,3,opt,name=staged,proto3" json:"staged,omitempty"`
	// contains filtered or unexported fields
}

type GitLogRequest struct {

	// service is the Codefly service name, optionally scoped by module in callers.
	Service string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`
	// count limits how many records should be returned.
	Count int32 `protobuf:"varint,2,opt,name=count,proto3" json:"count,omitempty"` // number of commits (default 10)
	// contains filtered or unexported fields
}

type GitLogResponse struct {

	// commits are git history entries ordered newest first.
	Commits []*GitCommitInfo `protobuf:"bytes,1,rep,name=commits,proto3" json:"commits,omitempty"`
	// error explains why the operation failed; empty means success at this layer.
	Error string `protobuf:"bytes,2,opt,name=error,proto3" json:"error,omitempty"`
	// contains filtered or unexported fields
}

type GitStatusRequest struct {

	// service is the Codefly service name, optionally scoped by module in callers.
	Service string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"` // optional: filter to service directory
	// contains filtered or unexported fields
}

type GitStatusResponse struct {

	// files are changed files reported by git status.
	Files []*GitFileStatus `protobuf:"bytes,1,rep,name=files,proto3" json:"files,omitempty"`
	// branch is the current git branch name.
	Branch string `protobuf:"bytes,2,opt,name=branch,proto3" json:"branch,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 GoToDefinitionRequest struct {

	// service is the Codefly service name, optionally scoped by module in callers.
	Service string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`
	// file is a workspace- or service-relative source file path.
	File string `protobuf:"bytes,2,opt,name=file,proto3" json:"file,omitempty"`
	// line is the 1-based source line number.
	Line int32 `protobuf:"varint,3,opt,name=line,proto3" json:"line,omitempty"`
	// column is the 1-based source column number when known.
	Column int32 `protobuf:"varint,4,opt,name=column,proto3" json:"column,omitempty"`
	// contains filtered or unexported fields
}

type GoToDefinitionResponse struct {

	// locations are declaration locations returned by the language server.
	Locations []*Location `protobuf:"bytes,1,rep,name=locations,proto3" json:"locations,omitempty"`
	// error explains why the operation failed; empty means success at this layer.
	Error string `protobuf:"bytes,2,opt,name=error,proto3" json:"error,omitempty"`
	// contains filtered or unexported fields
}

type HttpCheck struct {

	// method is the HTTP verb used by the check or API description.
	Method string `protobuf:"bytes,1,opt,name=method,proto3" json:"method,omitempty"`
	// path is the HTTP path to request on the service endpoint.
	Path string `protobuf:"bytes,2,opt,name=path,proto3" json:"path,omitempty"`
	// body is the request or response payload.
	Body string `protobuf:"bytes,3,opt,name=body,proto3" json:"body,omitempty"`
	// expected_status is the HTTP status code required for success.
	ExpectedStatus int32 `protobuf:"varint,4,opt,name=expected_status,json=expectedStatus,proto3" json:"expected_status,omitempty"`
	// body_contains is text that must appear in the HTTP response body.
	BodyContains string `protobuf:"bytes,5,opt,name=body_contains,json=bodyContains,proto3" json:"body_contains,omitempty"`
	// contains filtered or unexported fields
}

type LintRequest struct {

	// service is the Codefly service name, optionally scoped by module in callers.
	Service string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`
	// contains filtered or unexported fields
}

type LintResponse struct {

	// success is true when the requested operation completed successfully.
	Success bool `protobuf:"varint,1,opt,name=success,proto3" json:"success,omitempty"`
	// errors are structured lint diagnostics.
	Errors []*BuildError `protobuf:"bytes,2,rep,name=errors,proto3" json:"errors,omitempty"` // reuse BuildError for lint diagnostics
	// output is raw command, build, lint, or test output retained for diagnosis.
	Output string `protobuf:"bytes,3,opt,name=output,proto3" json:"output,omitempty"` // raw lint output
	// contains filtered or unexported fields
}

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

type ListAllCommandsResponse struct {

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

type ListDependenciesRequest struct {

	// service is the Codefly service name, optionally scoped by module in callers.
	Service string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`
	// contains filtered or unexported fields
}

type ListDependenciesResponse struct {

	// dependencies are packages or services required by this resource.
	Dependencies []*Dependency `protobuf:"bytes,1,rep,name=dependencies,proto3" json:"dependencies,omitempty"`
	// error explains why the operation failed; empty means success at this layer.
	Error string `protobuf:"bytes,2,opt,name=error,proto3" json:"error,omitempty"`
	// contains filtered or unexported fields
}

type ListFilesRequest struct {

	// service is the Codefly service name, optionally scoped by module in callers.
	Service string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`
	// path is a workspace- or service-relative filesystem path.
	Path string `protobuf:"bytes,2,opt,name=path,proto3" json:"path,omitempty"` // optional: subdirectory (empty = root)
	// extensions restrict file results to the listed suffixes.
	Extensions []string `protobuf:"bytes,3,rep,name=extensions,proto3" json:"extensions,omitempty"` // optional: filter by extension (e.g. ".go", ".py")
	// recursive includes nested directories when true.
	Recursive bool `protobuf:"varint,4,opt,name=recursive,proto3" json:"recursive,omitempty"`
	// contains filtered or unexported fields
}

type ListFilesResponse struct {

	// files are files or directories under the requested service path.
	Files []*FileInfo `protobuf:"bytes,1,rep,name=files,proto3" json:"files,omitempty"`
	// contains filtered or unexported fields
}