inventoryv1

type CollectInventoryOptions struct {

	// Ecosystems limits extraction to specific package ecosystems.
	// Empty means all supported ecosystems.
	// Values: go, npm, pypi, maven, rubygems, cargo, nuget, hex, pub, cocoapods, packagist, github-actions
	Ecosystems []string `protobuf:"bytes,1,rep,name=ecosystems,proto3" json:"ecosystems,omitempty"`
	// Ref is a Git reference for repository targets.
	// Examples: "HEAD", "main", "v1.0.0", "abc123"
	Ref string `protobuf:"bytes,2,opt,name=ref,proto3" json:"ref,omitempty"`
	// Platform specifies container image platform.
	// Example: "linux/amd64"
	Platform string `protobuf:"bytes,3,opt,name=platform,proto3" json:"platform,omitempty"`
	// IncludeLicenses enriches packages with license information.
	// This may require additional network requests to deps.dev.
	IncludeLicenses bool `protobuf:"varint,4,opt,name=include_licenses,json=includeLicenses,proto3" json:"include_licenses,omitempty"`
	// EnabledExtractors limits which extractors run.
	// Empty means all available extractors.
	EnabledExtractors []string `protobuf:"bytes,5,rep,name=enabled_extractors,json=enabledExtractors,proto3" json:"enabled_extractors,omitempty"`
	// contains filtered or unexported fields
}

type CollectInventoryProgress struct {

	// Phase indicates the current collection phase.
	Phase CollectPhase `protobuf:"varint,1,opt,name=phase,proto3,enum=deputy.inventory.v1.CollectPhase" json:"phase,omitempty"`
	// Message provides human-readable status.
	Message string `protobuf:"bytes,2,opt,name=message,proto3" json:"message,omitempty"`
	// PackagesFound is the count of packages discovered so far.
	PackagesFound int32 `protobuf:"varint,3,opt,name=packages_found,json=packagesFound,proto3" json:"packages_found,omitempty"`
	// ExtractorName identifies the active extractor.
	ExtractorName string `protobuf:"bytes,4,opt,name=extractor_name,json=extractorName,proto3" json:"extractor_name,omitempty"`
	// Result is populated when phase is PHASE_COMPLETED.
	Result *CollectInventoryResponse `protobuf:"bytes,5,opt,name=result,proto3" json:"result,omitempty"`
	// Error is populated when phase is PHASE_FAILED.
	Error string `protobuf:"bytes,6,opt,name=error,proto3" json:"error,omitempty"`
	// contains filtered or unexported fields
}

type CollectInventoryRequest struct {

	// Target is the path, URL, or reference to scan.
	// Examples:
	//   - "." (current directory)
	//   - "/path/to/project"
	//   - "https://github.com/owner/repo"
	//   - "docker://nginx:1.25"
	//   - "ghcr.io/owner/app:v1"
	Target string `protobuf:"bytes,1,opt,name=target,proto3" json:"target,omitempty"`
	// Options configure collection behavior.
	Options *CollectInventoryOptions `protobuf:"bytes,2,opt,name=options,proto3" json:"options,omitempty"`
	// contains filtered or unexported fields
}

type CollectInventoryResponse struct {

	// Target describes what was scanned.
	Target *v1.Target `protobuf:"bytes,1,opt,name=target,proto3" json:"target,omitempty"`
	// GeneratedAt is when the inventory was collected.
	GeneratedAt *timestamppb.Timestamp `protobuf:"bytes,2,opt,name=generated_at,json=generatedAt,proto3" json:"generated_at,omitempty"`
	// Packages lists all discovered dependencies.
	Packages []*v11.Package `protobuf:"bytes,3,rep,name=packages,proto3" json:"packages,omitempty"`
	// Stats summarizes the collection.
	Stats *InventoryStats `protobuf:"bytes,4,opt,name=stats,proto3" json:"stats,omitempty"`
	// ImageInfo contains container image metadata when applicable.
	ImageInfo *v12.ImageInfo `protobuf:"bytes,5,opt,name=image_info,json=imageInfo,proto3" json:"image_info,omitempty"`
	// Dockerfile contains parsed Dockerfile data when applicable.
	DockerfileInfo *DockerfileInfo `protobuf:"bytes,6,opt,name=dockerfile_info,json=dockerfileInfo,proto3" json:"dockerfile_info,omitempty"`
	// ExtractorsUsed lists which extractors produced results.
	ExtractorsUsed []string `protobuf:"bytes,7,rep,name=extractors_used,json=extractorsUsed,proto3" json:"extractors_used,omitempty"`
	// contains filtered or unexported fields
}

type CollectPhase int32

type DockerfileAnalysis struct {
	StageCount          int32    `protobuf:"varint,1,opt,name=stage_count,json=stageCount,proto3" json:"stage_count,omitempty"`
	HasMultiStage       bool     `protobuf:"varint,2,opt,name=has_multi_stage,json=hasMultiStage,proto3" json:"has_multi_stage,omitempty"`
	BuilderStageCount   int32    `protobuf:"varint,3,opt,name=builder_stage_count,json=builderStageCount,proto3" json:"builder_stage_count,omitempty"`
	FinalStageIsRoot    bool     `protobuf:"varint,4,opt,name=final_stage_is_root,json=finalStageIsRoot,proto3" json:"final_stage_is_root,omitempty"`
	FinalStageIsScratch bool     `protobuf:"varint,5,opt,name=final_stage_is_scratch,json=finalStageIsScratch,proto3" json:"final_stage_is_scratch,omitempty"`
	SensitiveEnvVars    []string `protobuf:"bytes,6,rep,name=sensitive_env_vars,json=sensitiveEnvVars,proto3" json:"sensitive_env_vars,omitempty"`
	HasAddUrl           bool     `protobuf:"varint,7,opt,name=has_add_url,json=hasAddUrl,proto3" json:"has_add_url,omitempty"`
	// contains filtered or unexported fields
}

type DockerfileInfo struct {

	// Path is the Dockerfile path.
	Path string `protobuf:"bytes,1,opt,name=path,proto3" json:"path,omitempty"`
	// Stages lists all build stages.
	Stages []*DockerfileStage `protobuf:"bytes,2,rep,name=stages,proto3" json:"stages,omitempty"`
	// FinalStage is the last (output) stage.
	FinalStage *DockerfileStage `protobuf:"bytes,3,opt,name=final_stage,json=finalStage,proto3" json:"final_stage,omitempty"`
	// Args are ARG instructions with defaults.
	Args map[string]string `` /* 135-byte string literal not displayed */
	// Analysis contains static analysis results.
	Analysis *DockerfileAnalysis `protobuf:"bytes,5,opt,name=analysis,proto3" json:"analysis,omitempty"`
	// contains filtered or unexported fields
}

type DockerfileStage struct {

	// Index is the 0-based stage position.
	Index int32 `protobuf:"varint,1,opt,name=index,proto3" json:"index,omitempty"`
	// Name is the AS alias (empty if unnamed).
	Name string `protobuf:"bytes,2,opt,name=name,proto3" json:"name,omitempty"`
	// BaseImage is the FROM image reference.
	BaseImage string `protobuf:"bytes,3,opt,name=base_image,json=baseImage,proto3" json:"base_image,omitempty"`
	// BaseImageResolved is the parsed image reference.
	BaseImageResolved *ImageReference `protobuf:"bytes,4,opt,name=base_image_resolved,json=baseImageResolved,proto3" json:"base_image_resolved,omitempty"`
	// Platform is the --platform flag value.
	Platform string `protobuf:"bytes,5,opt,name=platform,proto3" json:"platform,omitempty"`
	// IsScratch is true if FROM scratch.
	IsScratch bool `protobuf:"varint,6,opt,name=is_scratch,json=isScratch,proto3" json:"is_scratch,omitempty"`
	// IsBuilderStage is true if only used as COPY source.
	IsBuilderStage bool `protobuf:"varint,7,opt,name=is_builder_stage,json=isBuilderStage,proto3" json:"is_builder_stage,omitempty"`
	// User is the final USER directive value.
	User string `protobuf:"bytes,8,opt,name=user,proto3" json:"user,omitempty"`
	// IsRoot is true if running as root.
	IsRoot bool `protobuf:"varint,9,opt,name=is_root,json=isRoot,proto3" json:"is_root,omitempty"`
	// Workdir is the WORKDIR value.
	Workdir string `protobuf:"bytes,10,opt,name=workdir,proto3" json:"workdir,omitempty"`
	// EnvVars are ENV declarations.
	EnvVars map[string]string `` /* 157-byte string literal not displayed */
	// SensitiveEnv lists env vars matching secret patterns.
	SensitiveEnv []string `protobuf:"bytes,12,rep,name=sensitive_env,json=sensitiveEnv,proto3" json:"sensitive_env,omitempty"`
	// ExposedPorts are EXPOSE ports.
	ExposedPorts []string `protobuf:"bytes,13,rep,name=exposed_ports,json=exposedPorts,proto3" json:"exposed_ports,omitempty"`
	// Labels are LABEL key-value pairs.
	Labels map[string]string `` /* 140-byte string literal not displayed */
	// contains filtered or unexported fields
}

type ExtractRequest struct {

	// Path is the file path relative to scan root.
	Path string `protobuf:"bytes,1,opt,name=path,proto3" json:"path,omitempty"`
	// Contents is the file's raw bytes.
	Contents []byte `protobuf:"bytes,2,opt,name=contents,proto3" json:"contents,omitempty"`
	// Root is the scan root path (for resolving relative paths).
	Root string `protobuf:"bytes,3,opt,name=root,proto3" json:"root,omitempty"`
	// contains filtered or unexported fields
}

type ExtractResponse struct {

	// Packages are the dependencies discovered in this file.
	Packages []*v11.Package `protobuf:"bytes,1,rep,name=packages,proto3" json:"packages,omitempty"`
	// contains filtered or unexported fields
}

type ExtractorInfo struct {

	// Name is the extractor identifier (e.g., "go/gomod", "javascript/packagejson").
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// DisplayName is a human-readable name.
	DisplayName string `protobuf:"bytes,2,opt,name=display_name,json=displayName,proto3" json:"display_name,omitempty"`
	// Ecosystem is the package ecosystem this extractor supports.
	Ecosystem string `protobuf:"bytes,3,opt,name=ecosystem,proto3" json:"ecosystem,omitempty"`
	// Version is the extractor version.
	Version int32 `protobuf:"varint,4,opt,name=version,proto3" json:"version,omitempty"`
	// Description provides context about the extractor.
	Description string `protobuf:"bytes,5,opt,name=description,proto3" json:"description,omitempty"`
	// FilePatterns lists recognized file patterns.
	FilePatterns []string `protobuf:"bytes,6,rep,name=file_patterns,json=filePatterns,proto3" json:"file_patterns,omitempty"`
	// Source indicates where the extractor comes from.
	Source ExtractorSource `protobuf:"varint,7,opt,name=source,proto3,enum=deputy.inventory.v1.ExtractorSource" json:"source,omitempty"`
	// contains filtered or unexported fields
}

type ExtractorSource int32

type FileRequiredRequest struct {

	// Path is the file path relative to scan root.
	Path string `protobuf:"bytes,1,opt,name=path,proto3" json:"path,omitempty"`
	// IsDir indicates if the path is a directory.
	IsDir bool `protobuf:"varint,2,opt,name=is_dir,json=isDir,proto3" json:"is_dir,omitempty"`
	// Mode is the file permission mode (Unix-style).
	Mode uint32 `protobuf:"varint,3,opt,name=mode,proto3" json:"mode,omitempty"`
	// Size is the file size in bytes.
	Size int64 `protobuf:"varint,4,opt,name=size,proto3" json:"size,omitempty"`
	// contains filtered or unexported fields
}

type FileRequiredResponse struct {

	// Required is true if Extract should be called for this file.
	Required bool `protobuf:"varint,1,opt,name=required,proto3" json:"required,omitempty"`
	// contains filtered or unexported fields
}

type ImageReference struct {
	Registry   string `protobuf:"bytes,1,opt,name=registry,proto3" json:"registry,omitempty"`
	Repository string `protobuf:"bytes,2,opt,name=repository,proto3" json:"repository,omitempty"`
	Tag        string `protobuf:"bytes,3,opt,name=tag,proto3" json:"tag,omitempty"`
	Digest     string `protobuf:"bytes,4,opt,name=digest,proto3" json:"digest,omitempty"`
	// contains filtered or unexported fields
}

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

type InfoResponse struct {

	// Info describes the extractor.
	Info *ExtractorInfo `protobuf:"bytes,1,opt,name=info,proto3" json:"info,omitempty"`
	// contains filtered or unexported fields
}

type InventoryStats struct {

	// TotalPackages is the total count of packages.
	TotalPackages int32 `protobuf:"varint,1,opt,name=total_packages,json=totalPackages,proto3" json:"total_packages,omitempty"`
	// DirectPackages is the count of direct dependencies.
	DirectPackages int32 `protobuf:"varint,2,opt,name=direct_packages,json=directPackages,proto3" json:"direct_packages,omitempty"`
	// TransitivePackages is the count of transitive dependencies.
	TransitivePackages int32 `protobuf:"varint,3,opt,name=transitive_packages,json=transitivePackages,proto3" json:"transitive_packages,omitempty"`
	// ByEcosystem maps ecosystem names to package counts.
	ByEcosystem map[string]int32 `` /* 169-byte string literal not displayed */
	// DurationMs is the collection time in milliseconds.
	DurationMs int64 `protobuf:"varint,5,opt,name=duration_ms,json=durationMs,proto3" json:"duration_ms,omitempty"`
	// contains filtered or unexported fields
}

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

type ListExtractorsResponse struct {

	// Extractors lists all available inventory extractors.
	Extractors []*ExtractorInfo `protobuf:"bytes,1,rep,name=extractors,proto3" json:"extractors,omitempty"`
	// contains filtered or unexported fields
}

type RegisterExtractorRequest struct {

	// Info describes the extractor being registered.
	Info *ExtractorInfo `protobuf:"bytes,1,opt,name=info,proto3" json:"info,omitempty"`
	// PluginAddress is the pluginrpc address for the extractor.
	// Example: "unix:///tmp/my-extractor.sock"
	PluginAddress string `protobuf:"bytes,2,opt,name=plugin_address,json=pluginAddress,proto3" json:"plugin_address,omitempty"`
	// contains filtered or unexported fields
}

type RegisterExtractorResponse struct {

	// Registered is true if registration succeeded.
	Registered bool `protobuf:"varint,1,opt,name=registered,proto3" json:"registered,omitempty"`
	// contains filtered or unexported fields
}

type UnregisterExtractorRequest struct {

	// Name is the extractor identifier to unregister.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// contains filtered or unexported fields
}

type UnregisterExtractorResponse struct {

	// Unregistered is true if the plugin was found and removed.
	Unregistered bool `protobuf:"varint,1,opt,name=unregistered,proto3" json:"unregistered,omitempty"`
	// contains filtered or unexported fields
}