client

type APIError struct {
	Status int
	Detail string
}

type ActivityEntry struct {
	ArtifactId     *string   `json:"artifactId,omitempty"`
	ArtifactName   *string   `json:"artifactName,omitempty"`
	ArtifactType   *string   `json:"artifactType,omitempty"`
	CreatedAt      time.Time `json:"createdAt"`
	Digest         *string   `json:"digest,omitempty"`
	NamespaceId    string    `json:"namespaceId"`
	NamespaceName  string    `json:"namespaceName"`
	SbomId         string    `json:"sbomId"`
	SourceId       *string   `json:"sourceId,omitempty"`
	SourceKind     *string   `json:"sourceKind,omitempty"`
	SourceName     *string   `json:"sourceName,omitempty"`
	SubjectVersion *string   `json:"subjectVersion,omitempty"`
}

type AffectedArtifact struct {
	AffectedPurlCount int64   `json:"affectedPurlCount"`
	AffectedSbomCount int64   `json:"affectedSbomCount"`
	Group             *string `json:"group,omitempty"`
	Id                string  `json:"id"`
	Name              string  `json:"name"`
}

type AffectedComponent struct {
	AffectedVersionCount int64   `json:"affectedVersionCount"`
	FixedVersion         *string `json:"fixedVersion,omitempty"`
	Group                *string `json:"group,omitempty"`
	Name                 string  `json:"name"`
}

type ArtifactDetail struct {
	// Schema A URL to the JSON Schema for this object.
	Schema              *string      `json:"$schema,omitempty"`
	Cpe                 *string      `json:"cpe,omitempty"`
	CreatedAt           time.Time    `json:"createdAt"`
	Group               *string      `json:"group,omitempty"`
	Id                  string       `json:"id"`
	Name                string       `json:"name"`
	Purl                *string      `json:"purl,omitempty"`
	SbomCount           int64        `json:"sbomCount"`
	SigningStatus       string       `json:"signingStatus"`
	SufficientSbomCount int64        `json:"sufficientSbomCount"`
	Type                string       `json:"type"`
	VersionCount        int64        `json:"versionCount"`
	Vulns               *VulnSummary `json:"vulns,omitempty"`
	Watched             bool         `json:"watched"`
}

type ArtifactFilter struct {
	// Type is a CycloneDX component type, e.g. container or application.
	Type string
	// Name matches the artifact name.
	Name string
	// IncludeInsufficient also returns artifacts whose SBOMs are not enriched
	// enough to be trusted, which the server hides unless asked.
	IncludeInsufficient bool
}

type ArtifactRelation struct {
	ArtifactGroup  *string    `json:"artifactGroup,omitempty"`
	ArtifactId     string     `json:"artifactId"`
	ArtifactName   string     `json:"artifactName"`
	ArtifactType   string     `json:"artifactType"`
	CurrentVersion *string    `json:"currentVersion,omitempty"`
	Digest         *string    `json:"digest,omitempty"`
	Flavor         *string    `json:"flavor,omitempty"`
	IsCurrent      *bool      `json:"isCurrent,omitempty"`
	MatchedVersion *string    `json:"matchedVersion,omitempty"`
	ObservedAt     *time.Time `json:"observedAt,omitempty"`
	SbomId         string     `json:"sbomId"`
	SubjectVersion *string    `json:"subjectVersion,omitempty"`
}

type ArtifactSummary struct {
	Group               *string      `json:"group,omitempty"`
	Id                  string       `json:"id"`
	Name                string       `json:"name"`
	SbomCount           int64        `json:"sbomCount"`
	SigningStatus       string       `json:"signingStatus"`
	SufficientSbomCount int64        `json:"sufficientSbomCount"`
	Type                string       `json:"type"`
	Vulns               *VulnSummary `json:"vulns,omitempty"`
}

type ArtifactTypeCountEntry struct {
	ArtifactCount int64  `json:"artifact_count"`
	Type          string `json:"type"`
}

type ArtifactVersionSummary struct {
	Architectures *[]string  `json:"architectures"`
	BuildDate     *time.Time `json:"buildDate,omitempty"`
	CreatedAt     time.Time  `json:"createdAt"`
	ImageVersion  *string    `json:"imageVersion,omitempty"`
	Revision      *string    `json:"revision,omitempty"`

	// SbomCount Total number of SBOMs ingested for this version
	SbomCount int64  `json:"sbomCount"`
	SbomId    string `json:"sbomId"`

	// SigningStatus Signing status derived from provenance enrichment
	SigningStatus ArtifactVersionSummarySigningStatus `json:"signingStatus"`
	SourceUrl     *string                             `json:"sourceUrl,omitempty"`
	Sufficient    bool                                `json:"sufficient"`
	VersionKey    string                              `json:"versionKey"`
	Vulns         *VulnSummary                        `json:"vulns,omitempty"`
}

type ArtifactVersionSummarySigningStatus string

type ArtifactVulnEntry struct {
	AffectedPackageCount int64                  `json:"affectedPackageCount"`
	AffectedVersionCount int64                  `json:"affectedVersionCount"`
	AffectedVersions     *[]ArtifactVulnVersion `json:"affectedVersions"`
	CanonicalId          string                 `json:"canonicalId"`
	CvssScore            *float32               `json:"cvssScore,omitempty"`
	Id                   string                 `json:"id"`
	Severity             string                 `json:"severity"`
	Summary              *string                `json:"summary,omitempty"`
}

type ArtifactVulnVersion struct {
	AffectedPackageCount int64     `json:"affectedPackageCount"`
	PackageNames         *[]string `json:"packageNames"`
	SbomId               string    `json:"sbomId"`
	Version              string    `json:"version"`
}

type CategoryCountEntry struct {
	Category       string `json:"category"`
	ComponentCount int64  `json:"component_count"`
}

type ChangeCounts struct {
	Added      int64 `json:"added"`
	Downgraded int64 `json:"downgraded"`
	Modified   int64 `json:"modified"`
	Removed    int64 `json:"removed"`
	Upgraded   int64 `json:"upgraded"`
}

type ChangeSummary struct {
	Added      int64 `json:"added"`
	Downgraded int64 `json:"downgraded"`
	Modified   int64 `json:"modified"`
	Removed    int64 `json:"removed"`
	Upgraded   int64 `json:"upgraded"`
}

type Changelog struct {
	// Schema A URL to the JSON Schema for this object.
	Schema                 *string           `json:"$schema,omitempty"`
	ArtifactId             string            `json:"artifactId"`
	AvailableArchitectures *[]string         `json:"availableArchitectures"`
	AvailableFlavors       *[]string         `json:"availableFlavors"`
	Entries                *[]ChangelogEntry `json:"entries"`
	HasSemver              bool              `json:"hasSemver"`
	Pagination             PageMeta          `json:"pagination"`
	ResolvedMode           string            `json:"resolvedMode"`
}

type ChangelogEntry struct {
	// Schema A URL to the JSON Schema for this object.
	Schema  *string          `json:"$schema,omitempty"`
	Changes *[]ComponentDiff `json:"changes"`
	From    SBOMRef          `json:"from"`
	Summary ChangeSummary    `json:"summary"`
	To      SBOMRef          `json:"to"`
}

type Client interface {
	ListRegistries(ctx context.Context, opts PageOpts) (Page[RegistryResponse], error)
	GetRegistry(ctx context.Context, id string) (RegistryResponse, error)
	GetRegistryByName(ctx context.Context, name string) (RegistryResponse, error)
	CreateRegistry(ctx context.Context, body CreateRegistryInputBody) (CreateRegistryResponseBody, error)
	UpdateRegistry(ctx context.Context, id string, body UpdateRegistryInputBody) (RegistryResponse, error)
	DeleteRegistry(ctx context.Context, id string) error
	ScanRegistry(ctx context.Context, id string) (ScanRegistryOutputBody, error)
	PreviewRegistryConfig(ctx context.Context, body PreviewRegistryConfigInputBody) (RegistryPreview, error)
	GetRegistryPreview(ctx context.Context, id string) (RegistryPreview, error)
	TestRegistryConnection(ctx context.Context, body TestRegistryConnectionInputBody) (TestRegistryConnectionOutputBody, error)
	RegenerateWebhookSecret(ctx context.Context, id string) (RegenerateWebhookSecretOutputBody, error)

	ListNamespaces(ctx context.Context) ([]NamespaceResponse, error)
	GetNamespace(ctx context.Context, id string) (NamespaceResponse, error)
	GetNamespaceByName(ctx context.Context, name string) (NamespaceResponse, error)
	CreateNamespace(ctx context.Context, body CreateNamespaceInputBody) (NamespaceResponse, error)
	UpdateNamespace(ctx context.Context, id string, body UpdateNamespaceInputBody) (NamespaceResponse, error)
	DeleteNamespace(ctx context.Context, id string) error

	ListSources(ctx context.Context, namespaceID string) ([]SourceResponse, error)
	GetSource(ctx context.Context, id string) (SourceResponse, error)
	CreateSource(ctx context.Context, body CreateSourceInputBody) (SourceResponse, error)
	UpdateSource(ctx context.Context, id string, body UpdateSourceInputBody) (SourceResponse, error)
	DeleteSource(ctx context.Context, id string) error

	CreateAPIKey(ctx context.Context, body CreateAPIKeyInputBody) (CreateAPIKeyOutputBody, error)
	ListAPIKeys(ctx context.Context) ([]KeyMetaResponse, error)
	DeleteAPIKey(ctx context.Context, id string) error
	GetCurrentUser(ctx context.Context) (MeOutputBody, error)

	ListClusters(ctx context.Context, namespaceID string) ([]ClusterResponse, error)
	GetCluster(ctx context.Context, id string) (ClusterResponse, error)
	CreateCluster(ctx context.Context, body CreateClusterInputBody) (ClusterResponse, error)
	UpdateCluster(ctx context.Context, id string, body UpdateClusterInputBody) (ClusterResponse, error)
	DeleteCluster(ctx context.Context, id string) error
	PutInventory(ctx context.Context, clusterID string, workloads []InventoryWorkload) (PutInventoryOutputBody, error)
	ListClusterWorkloads(ctx context.Context, clusterID string) ([]ClusterWorkloadResponse, WorkloadCoverageResponse, error)

	IngestSBOM(ctx context.Context, data []byte, params IngestSbomParams) (IngestSBOMOutputBody, error)
	GetSBOM(ctx context.Context, id string, includeRaw bool) (SBOMDetail, error)
	ListSBOMs(ctx context.Context, filter SBOMFilter, opts PageOpts) (CursorPage[SBOMSummary], error)
	DeleteSBOM(ctx context.Context, id string) error
	DiffSBOMs(ctx context.Context, fromID, toID string) (ChangelogEntry, error)
	GetDiffTree(ctx context.Context, fromID, toID string) (DiffTree, error)

	ListArtifacts(ctx context.Context, filter ArtifactFilter, opts PageOpts) (CursorPage[ArtifactSummary], error)
	GetArtifact(ctx context.Context, id string) (ArtifactDetail, error)
	GetArtifactChangelog(ctx context.Context, id string, params GetArtifactChangelogParams) (Changelog, error)
	GetArtifactLicenseSummary(ctx context.Context, id string) (GetArtifactLicenseSummaryOutputBody, error)
	ListArtifactSBOMs(ctx context.Context, id string, opts PageOpts) (CursorPage[SBOMSummary], error)
	ListArtifactVersions(ctx context.Context, id string, opts PageOpts) (Page[ArtifactVersionSummary], error)

	LookupArtifact(ctx context.Context, params LookupArtifactParams) (ArtifactDetail, error)
	LookupSBOM(ctx context.Context, params LookupSbomParams) (SBOMDetail, error)
	LookupLicense(ctx context.Context, spdxID string) (LicenseCount, error)

	// Vulnerabilities. Resolved by artifact (severity histogram), by component
	// occurrence (the advisories hitting it), or by advisory id.
	GetArtifactVulnSummary(ctx context.Context, artifactID string) (VulnSummary, error)
	GetComponentVulns(ctx context.Context, componentID string) ([]ComponentVulnEntry, error)
	GetVulnerability(ctx context.Context, vulnID string, opts PageOpts) (GetVulnerabilityOutputBody, error)

	SearchComponents(ctx context.Context, filter ComponentFilter, opts PageOpts) (Page[ComponentSummary], error)
	SearchDistinctComponents(ctx context.Context, filter DistinctComponentFilter, opts PageOpts) (Page[DistinctComponentSummary], error)
	GetComponent(ctx context.Context, id string) (ComponentDetail, error)
	GetComponentVersions(ctx context.Context, params GetComponentVersionsParams) (GetComponentVersionsOutputBody, error)
	ListComponentPurlTypes(ctx context.Context) ([]string, error)
	ListSBOMComponents(ctx context.Context, sbomID string) ([]ComponentSummary, error)
	GetSBOMDependencies(ctx context.Context, sbomID string) (DependencyGraph, error)

	ListJobs(ctx context.Context, filter JobFilter, opts PageOpts) (Page[ScanJobResponse], error)
	GetJob(ctx context.Context, id string) (ScanJobResponse, error)
	RetryJob(ctx context.Context, id string) error

	GetDashboardStats(ctx context.Context) (DashboardStatsOutputBody, error)

	// GetOpenAPISpec returns the running server's own OpenAPI document, for
	// callers that need the full surface rather than the typed methods above.
	GetOpenAPISpec(ctx context.Context) (json.RawMessage, error)
}

type ClusterImageResponse struct {
	ArtifactId   *string `json:"artifact_id,omitempty"`
	ArtifactName *string `json:"artifact_name,omitempty"`
	ArtifactType *string `json:"artifact_type,omitempty"`
	ImageDigest  *string `json:"image_digest,omitempty"`
	ImageRef     string  `json:"image_ref"`
	LastSeenAt   string  `json:"last_seen_at"`

	// MatchState exact = digest matched an SBOM; index = matched a multi-arch image index, so the exact platform is unknown; unknown = real digest with no ingested SBOM (coverage gap); unresolvable = no digest could be read from the container (agent/runtime gap)
	MatchState ClusterImageResponseMatchState `json:"match_state"`

	// NamespaceCount Kubernetes namespaces the image appears in
	NamespaceCount int64 `json:"namespace_count"`

	// PodCount Running pods those workload-containers add up to
	PodCount        int64               `json:"pod_count"`
	SampleNamespace *string             `json:"sample_namespace,omitempty"`
	SampleWorkload  *string             `json:"sample_workload,omitempty"`
	SbomId          *string             `json:"sbom_id,omitempty"`
	SubjectVersion  *string             `json:"subject_version,omitempty"`
	Vulns           *WorkloadVulnCounts `json:"vulns,omitempty"`

	// WorkloadCount Workload-containers running this image
	WorkloadCount int64 `json:"workload_count"`
}

type ClusterImageResponseMatchState string

type ClusterResponse struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string `json:"$schema,omitempty"`

	// AutoIngest Submit a scan job for every running image with no SBOM whose host resolves to a registry in this cluster's namespace, on every accepted snapshot.
	AutoIngest  bool    `json:"auto_ingest"`
	CreatedAt   string  `json:"created_at"`
	Description *string `json:"description,omitempty"`
	Id          string  `json:"id"`

	// LastSeenAt When an agent last pushed a snapshot. Empty means no agent has ever reported: a cluster showing no workloads for this reason is not a cluster running nothing.
	LastSeenAt  *string `json:"last_seen_at,omitempty"`
	Name        string  `json:"name"`
	NamespaceId string  `json:"namespace_id"`

	// NamespaceName Owning namespace name; populated on list responses
	NamespaceName *string `json:"namespace_name,omitempty"`
	UpdatedAt     string  `json:"updated_at"`
}

type ClusterWorkloadResponse struct {
	ArtifactId    *string `json:"artifact_id,omitempty"`
	ArtifactName  *string `json:"artifact_name,omitempty"`
	ArtifactType  *string `json:"artifact_type,omitempty"`
	ClusterId     string  `json:"cluster_id"`
	ContainerName string  `json:"container_name"`
	FirstSeenAt   string  `json:"first_seen_at"`
	Id            string  `json:"id"`
	ImageDigest   *string `json:"image_digest,omitempty"`
	ImageRef      string  `json:"image_ref"`
	K8sNamespace  string  `json:"k8s_namespace"`
	LastSeenAt    string  `json:"last_seen_at"`

	// MatchState exact = digest matched an SBOM; index = matched a multi-arch image index, so the exact platform is unknown; unknown = real digest with no ingested SBOM (coverage gap); unresolvable = no digest could be read from the container (agent/runtime gap)
	MatchState     ClusterWorkloadResponseMatchState `json:"match_state"`
	PodCount       int32                             `json:"pod_count"`
	SbomId         *string                           `json:"sbom_id,omitempty"`
	SubjectVersion *string                           `json:"subject_version,omitempty"`
	Vulns          *WorkloadVulnCounts               `json:"vulns,omitempty"`
	WorkloadKind   string                            `json:"workload_kind"`
	WorkloadName   string                            `json:"workload_name"`
}

type ClusterWorkloadResponseMatchState string

type ComponentDetail struct {
	// Schema A URL to the JSON Schema for this object.
	Schema             *string             `json:"$schema,omitempty"`
	BomRef             *string             `json:"bomRef,omitempty"`
	Confidence         *string             `json:"confidence,omitempty"`
	Copyright          *string             `json:"copyright,omitempty"`
	Cpe                *string             `json:"cpe,omitempty"`
	CriticalCount      *int64              `json:"criticalCount,omitempty"`
	DescendantChanges  *ChangeCounts       `json:"descendantChanges,omitempty"`
	Description        *string             `json:"description,omitempty"`
	ExternalReferences *[]ExternalRefEntry `json:"externalReferences"`
	FoundBy            *string             `json:"foundBy,omitempty"`
	FromBaseImage      *bool               `json:"fromBaseImage,omitempty"`
	Group              *string             `json:"group,omitempty"`
	Hashes             *[]HashEntry        `json:"hashes"`
	HighCount          *int64              `json:"highCount,omitempty"`
	Id                 string              `json:"id"`
	IsDirect           bool                `json:"isDirect"`
	Layer              *int64              `json:"layer,omitempty"`
	LayerId            *string             `json:"layerId,omitempty"`
	Licenses           *[]LicenseSummary   `json:"licenses"`
	LowCount           *int64              `json:"lowCount,omitempty"`
	MaxSeverity        *string             `json:"maxSeverity,omitempty"`
	MediumCount        *int64              `json:"mediumCount,omitempty"`
	Name               string              `json:"name"`
	Publisher          *string             `json:"publisher,omitempty"`
	Purl               *string             `json:"purl,omitempty"`
	SbomId             string              `json:"sbomId"`
	Scope              *string             `json:"scope,omitempty"`
	SourcePackage      *string             `json:"sourcePackage,omitempty"`
	Type               string              `json:"type"`
	UnknownCount       *int64              `json:"unknownCount,omitempty"`
	Version            *string             `json:"version,omitempty"`
	VulnCount          *int64              `json:"vulnCount,omitempty"`
}

type ComponentDiff struct {
	Direction       string  `json:"direction"`
	Group           *string `json:"group,omitempty"`
	Name            string  `json:"name"`
	NodeRef         *string `json:"nodeRef,omitempty"`
	PreviousVersion *string `json:"previousVersion,omitempty"`
	Purl            *string `json:"purl,omitempty"`
	Type            string  `json:"type"`
	Version         *string `json:"version,omitempty"`
}

type ComponentFilter struct {
	Name string
	// Purl matches the package URL exactly (ADR-042 R6) — the cross-SBOM key
	// for a component, whose rows are otherwise SBOM-scoped.
	Purl    string
	Group   string
	Version string
}

type ComponentSummary struct {
	BomRef            *string       `json:"bomRef,omitempty"`
	CriticalCount     *int64        `json:"criticalCount,omitempty"`
	DescendantChanges *ChangeCounts `json:"descendantChanges,omitempty"`
	Group             *string       `json:"group,omitempty"`
	HighCount         *int64        `json:"highCount,omitempty"`
	Id                string        `json:"id"`
	IsDirect          bool          `json:"isDirect"`
	LowCount          *int64        `json:"lowCount,omitempty"`
	MaxSeverity       *string       `json:"maxSeverity,omitempty"`
	MediumCount       *int64        `json:"mediumCount,omitempty"`
	Name              string        `json:"name"`
	Purl              *string       `json:"purl,omitempty"`
	SbomId            string        `json:"sbomId"`
	Type              string        `json:"type"`
	UnknownCount      *int64        `json:"unknownCount,omitempty"`
	Version           *string       `json:"version,omitempty"`
	VulnCount         *int64        `json:"vulnCount,omitempty"`
}

type ComponentVersionEntry struct {
	Architecture   *string `json:"architecture,omitempty"`
	ArtifactId     *string `json:"artifactId,omitempty"`
	ArtifactName   *string `json:"artifactName,omitempty"`
	CriticalCount  *int64  `json:"criticalCount,omitempty"`
	Group          *string `json:"group,omitempty"`
	HighCount      *int64  `json:"highCount,omitempty"`
	Id             string  `json:"id"`
	LowCount       *int64  `json:"lowCount,omitempty"`
	MaxSeverity    *string `json:"maxSeverity,omitempty"`
	MediumCount    *int64  `json:"mediumCount,omitempty"`
	Name           string  `json:"name"`
	Purl           *string `json:"purl,omitempty"`
	SbomCreatedAt  string  `json:"sbomCreatedAt"`
	SbomDigest     *string `json:"sbomDigest,omitempty"`
	SbomId         string  `json:"sbomId"`
	SubjectVersion *string `json:"subjectVersion,omitempty"`
	Type           string  `json:"type"`
	UnknownCount   *int64  `json:"unknownCount,omitempty"`
	Version        *string `json:"version,omitempty"`
	VulnCount      int64   `json:"vulnCount"`
}

type ComponentVulnEntry struct {
	CanonicalId      string   `json:"canonicalId"`
	CvssScore        *float32 `json:"cvssScore,omitempty"`
	FixState         *string  `json:"fixState,omitempty"`
	FixedVersion     *string  `json:"fixedVersion,omitempty"`
	Id               string   `json:"id"`
	MatchedViaSource bool     `json:"matchedViaSource"`
	Severity         string   `json:"severity"`
	Summary          *string  `json:"summary,omitempty"`
}

type Config struct {
	BaseURL    string       // API base URL, e.g. "http://localhost:8080"; no trailing slash
	APIKey     string       // Bearer token (ocidex_<token>); empty for unauthenticated
	HTTPClient *http.Client // nil uses http.DefaultClient
}

type ConflictError struct {
	Detail     string
	Candidates []LookupCandidate
}

type CreateAPIKeyInputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string `json:"$schema,omitempty"`

	// Capabilities Capabilities this key may exercise, intersected with the owner's live namespace roles. Empty means all of them.
	Capabilities *[]CreateAPIKeyInputBodyCapabilities `json:"capabilities,omitempty"`

	// Name Human-readable label for this key
	Name string `json:"name"`
}

type CreateAPIKeyInputBodyCapabilities string

type CreateAPIKeyOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string `json:"$schema,omitempty"`

	// Key Full API key — shown once, store securely
	Key string `json:"key"`
}

type CreateApiKeyJSONRequestBody = CreateAPIKeyInputBody

type CreateClusterInputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema      *string `json:"$schema,omitempty"`
	Description *string `json:"description,omitempty"`

	// Name Cluster name, unique within the namespace
	Name string `json:"name"`

	// NamespaceId Owning namespace UUID
	NamespaceId openapi_types.UUID `json:"namespace_id"`
}

type CreateClusterJSONRequestBody = CreateClusterInputBody

type CreateNamespaceInputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string `json:"$schema,omitempty"`

	// Name Human-readable namespace name
	Name string `json:"name"`

	// Visibility Namespace visibility; defaults to private
	Visibility *CreateNamespaceInputBodyVisibility `json:"visibility,omitempty"`
}

type CreateNamespaceInputBodyVisibility string

type CreateNamespaceJSONRequestBody = CreateNamespaceInputBody

type CreateRegistryInputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string `json:"$schema,omitempty"`

	// AuthToken Token or PAT for registry authentication; omit for anonymous access
	AuthToken *string `json:"auth_token,omitempty"`

	// AuthUsername Username for registry authentication; omit for anonymous access
	AuthUsername *string `json:"auth_username,omitempty"`

	// IncludeUntagged Scan untagged manifests via registry-specific APIs (supported: zot, harbor, ghcr)
	IncludeUntagged *bool `json:"include_untagged,omitempty"`

	// Insecure Allow HTTP (non-TLS) connections
	Insecure bool `json:"insecure"`

	// ManagedBy External system that owns this registry's configuration (e.g. kubernetes); set by that system's controller, not by hand
	ManagedBy *string `json:"managed_by,omitempty"`

	// ManagedRef Identifier within the managing system, e.g. '<namespace>/<name>' of the OCIRegistry resource
	ManagedRef *string `json:"managed_ref,omitempty"`

	// MaxTagAgeDays Skip tags whose image is older than this many days; needs the created order. 0 = no age limit
	MaxTagAgeDays *int64 `json:"max_tag_age_days,omitempty"`

	// Name Human-readable registry name
	Name string `json:"name"`

	// Namespace Namespace to create the registry in, created on first use; omit to give the registry a namespace of its own named after it
	Namespace *string `json:"namespace,omitempty"`

	// PollIntervalMinutes Minutes between polls
	PollIntervalMinutes *int64 `json:"poll_interval_minutes,omitempty"`

	// Repositories Explicit repositories to walk; bypasses /v2/_catalog discovery when non-empty
	Repositories *[]string `json:"repositories,omitempty"`

	// RepositoryPatterns Glob patterns for repositories to ingest; empty = all
	RepositoryPatterns *[]string `json:"repository_patterns,omitempty"`

	// ScanMode Scanning mode
	ScanMode *CreateRegistryInputBodyScanMode `json:"scan_mode,omitempty"`

	// TagLimit Newest tags kept per repository (ADR-0053); 0 = unlimited. Defaults to 50
	TagLimit *int64 `json:"tag_limit,omitempty"`

	// TagOrder How 'newest' is decided; auto (the default) = semver when tag_patterns contains semver, created otherwise
	TagOrder *CreateRegistryInputBodyTagOrder `json:"tag_order,omitempty"`

	// TagPatterns Glob patterns or 'semver' for tags to ingest; empty = all
	TagPatterns *[]string `json:"tag_patterns,omitempty"`

	// TrustIdentity Regex matched against the Fulcio certificate SAN; required when verification_mode is keyless
	TrustIdentity *string `json:"trust_identity,omitempty"`

	// TrustIssuer Expected OIDC issuer URL; required when verification_mode is keyless
	TrustIssuer *string `json:"trust_issuer,omitempty"`

	// TrustPublicKey PEM-encoded EC public key; required when verification_mode is public_key
	TrustPublicKey *string `json:"trust_public_key,omitempty"`

	// Type Registry type
	Type CreateRegistryInputBodyType `json:"type"`

	// Url Registry address (e.g. zot:5000)
	Url string `json:"url"`

	// VerificationMode Signature verification mode; defaults to none
	VerificationMode *CreateRegistryInputBodyVerificationMode `json:"verification_mode,omitempty"`

	// Visibility Registry visibility
	Visibility *CreateRegistryInputBodyVisibility `json:"visibility,omitempty"`

	// WebhookSecret Bearer token required on incoming webhooks; omit to disable auth
	WebhookSecret *string `json:"webhook_secret,omitempty"`
}

type CreateRegistryInputBodyScanMode string

type CreateRegistryInputBodyTagOrder string

type CreateRegistryInputBodyType string

type CreateRegistryInputBodyVerificationMode string

type CreateRegistryInputBodyVisibility string

type CreateRegistryJSONRequestBody = CreateRegistryInputBody

type CreateRegistryResponseBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema    *string `json:"$schema,omitempty"`
	CreatedAt string  `json:"created_at"`
	Enabled   bool    `json:"enabled"`
	HasAuth   bool    `json:"has_auth"`
	HasSecret bool    `json:"has_secret"`
	Id        string  `json:"id"`

	// IncludeUntagged Scan untagged manifests via registry-specific APIs (supported: zot, harbor, ghcr)
	IncludeUntagged bool       `json:"include_untagged"`
	Insecure        bool       `json:"insecure"`
	LastPolledAt    *string    `json:"last_polled_at,omitempty"`
	LastWalk        *WalkStats `json:"last_walk,omitempty"`

	// ManagedBy External system that owns this registry's configuration (e.g. kubernetes); absent when managed through this API
	ManagedBy *string `json:"managed_by,omitempty"`

	// ManagedRef Identifier within the managing system, e.g. '<namespace>/<name>' of the OCIRegistry resource
	ManagedRef *string `json:"managed_ref,omitempty"`

	// MaxTagAgeDays Tags whose image is older than this many days are skipped; 0 = no age limit
	MaxTagAgeDays       int64  `json:"max_tag_age_days"`
	Name                string `json:"name"`
	PollIntervalMinutes int64  `json:"poll_interval_minutes"`

	// Repositories Explicit repositories to walk; overrides catalog discovery when non-empty
	Repositories *[]string `json:"repositories"`

	// RepositoryPatterns Glob patterns for repositories to ingest; empty = all
	RepositoryPatterns *[]string `json:"repository_patterns"`
	ScanMode           string    `json:"scan_mode"`

	// TagLimit Newest tags kept per repository (ADR-0053); 0 = unlimited
	TagLimit int64 `json:"tag_limit"`

	// TagOrder How 'newest' is decided; auto = semver when tag_patterns contains semver, created otherwise
	TagOrder CreateRegistryResponseBodyTagOrder `json:"tag_order"`

	// TagPatterns Glob patterns or 'semver' for tags to ingest; empty = all
	TagPatterns *[]string `json:"tag_patterns"`

	// TrustIdentity Regex matched against the Fulcio certificate SAN; required for keyless verification mode
	TrustIdentity *string `json:"trust_identity,omitempty"`

	// TrustIssuer Expected OIDC issuer URL; required for keyless verification mode
	TrustIssuer *string `json:"trust_issuer,omitempty"`

	// TrustPublicKey PEM-encoded EC public key for public_key verification mode
	TrustPublicKey *string `json:"trust_public_key,omitempty"`
	Type           string  `json:"type"`
	UpdatedAt      string  `json:"updated_at"`
	Url            string  `json:"url"`

	// VerificationMode Signature verification mode
	VerificationMode CreateRegistryResponseBodyVerificationMode `json:"verification_mode"`

	// Visibility Registry visibility: public or private
	Visibility string `json:"visibility"`

	// WebhookSecret Generated webhook secret — shown once only. Store it securely; it cannot be retrieved again.
	WebhookSecret *string `json:"webhook_secret,omitempty"`
	WebhookUrl    string  `json:"webhook_url"`
}

type CreateRegistryResponseBodyTagOrder string

type CreateRegistryResponseBodyVerificationMode string

type CreateSourceInputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string `json:"$schema,omitempty"`

	// Name Source name, unique within the namespace
	Name string `json:"name"`

	// NamespaceId Owning namespace UUID
	NamespaceId openapi_types.UUID `json:"namespace_id"`
}

type CreateSourceJSONRequestBody = CreateSourceInputBody

type CursorMeta struct {
	// HasMore Whether more results exist after this page
	HasMore bool `json:"hasMore"`

	// Limit The limit that was applied
	Limit int32 `json:"limit"`

	// NextCursor Opaque cursor to fetch the next page; null when hasMore is false
	NextCursor *string `json:"nextCursor,omitempty"`
}

type CursorPage[T any] struct {
	Data       []T
	Pagination CursorMeta
}

type DBStatus struct {
	LatencyMs int64 `json:"latency_ms"`
	Ok        bool  `json:"ok"`
}

type DailyCountEntry struct {
	Count int64  `json:"count"`
	Day   string `json:"day"`
}

type DashboardStatsOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema                *string                   `json:"$schema,omitempty"`
	ArtifactCount         int64                     `json:"artifact_count"`
	ArtifactTypes         *[]ArtifactTypeCountEntry `json:"artifact_types"`
	IngestionTimeline     *[]DailyCountEntry        `json:"ingestion_timeline"`
	LicenseCategories     *[]CategoryCountEntry     `json:"license_categories"`
	LicenseCount          int64                     `json:"license_count"`
	PackageCount          int64                     `json:"package_count"`
	PackageGrowthTimeline *[]DailyCountEntry        `json:"package_growth_timeline"`
	SbomCount             int64                     `json:"sbom_count"`
	TopPackages           *[]PackageSummaryEntry    `json:"top_packages"`
	VersionCount          int64                     `json:"version_count"`
	VersionGrowthTimeline *[]DailyCountEntry        `json:"version_growth_timeline"`
	VulnCount             int64                     `json:"vuln_count"`
	VulnSeverity          VulnSeverityEntry         `json:"vuln_severity"`

	// Warming No snapshot is available yet and every count is a zero placeholder; render a loading state and retry
	Warming bool `json:"warming"`
}

type DependencyEdge struct {
	From string `json:"from"`
	To   string `json:"to"`
}

type DependencyGraph struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string             `json:"$schema,omitempty"`
	Edges  *[]DependencyEdge   `json:"edges"`
	Nodes  *[]ComponentSummary `json:"nodes"`
	Roots  *[]string           `json:"roots"`
}

type DiffSbomsParams struct {
	// From UUID of the source SBOM
	From openapi_types.UUID `form:"from" json:"from"`

	// To UUID of the target SBOM
	To openapi_types.UUID `form:"to" json:"to"`
}

type DiffTree struct {
	// Schema A URL to the JSON Schema for this object.
	Schema  *string             `json:"$schema,omitempty"`
	Changes *[]ComponentDiff    `json:"changes"`
	Edges   *[]DependencyEdge   `json:"edges"`
	From    SBOMRef             `json:"from"`
	Nodes   *[]ComponentSummary `json:"nodes"`
	Roots   *[]string           `json:"roots"`
	Summary ChangeSummary       `json:"summary"`
	To      SBOMRef             `json:"to"`
}

type DiffTreeParams struct {
	// From UUID of the source SBOM
	From openapi_types.UUID `form:"from" json:"from"`

	// To UUID of the target SBOM
	To openapi_types.UUID `form:"to" json:"to"`
}

type DiscoverArtifact struct {
	Group        *string    `json:"group,omitempty"`
	Id           string     `json:"id"`
	LastSeenAt   *time.Time `json:"lastSeenAt,omitempty"`
	Name         string     `json:"name"`
	Purl         *string    `json:"purl,omitempty"`
	SbomCount    int64      `json:"sbomCount"`
	Score        float64    `json:"score"`
	Type         string     `json:"type"`
	UsageCount   int64      `json:"usageCount"`
	VersionCount int64      `json:"versionCount"`
}

type DiscoverLicense struct {
	Category       string  `json:"category"`
	ComponentCount int64   `json:"componentCount"`
	Id             string  `json:"id"`
	Name           string  `json:"name"`
	SpdxId         *string `json:"spdxId,omitempty"`
}

type DiscoverRecent struct {
	ArtifactId     string    `json:"artifactId"`
	CreatedAt      time.Time `json:"createdAt"`
	Digest         *string   `json:"digest,omitempty"`
	Flavor         *string   `json:"flavor,omitempty"`
	Group          *string   `json:"group,omitempty"`
	Name           string    `json:"name"`
	SbomId         string    `json:"sbomId"`
	SubjectVersion *string   `json:"subjectVersion,omitempty"`
	Type           string    `json:"type"`
}

type DiscoverVuln struct {
	AffectedArtifactCount int64      `json:"affectedArtifactCount"`
	AffectedSbomCount     int64      `json:"affectedSbomCount"`
	CanonicalId           string     `json:"canonicalId"`
	CvssScore             *float32   `json:"cvssScore,omitempty"`
	Id                    string     `json:"id"`
	PublishedAt           *time.Time `json:"publishedAt,omitempty"`
	Severity              string     `json:"severity"`
	Summary               *string    `json:"summary,omitempty"`
}

type DiscoveryOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string `json:"$schema,omitempty"`

	// GeneratedAt When this snapshot was computed; absent while warming
	GeneratedAt *string `json:"generated_at,omitempty"`

	// LicenseSpread License distribution across public content, by distinct package identity
	LicenseSpread *[]DiscoverLicense `json:"license_spread"`

	// RecentArtifacts Most recently updated public artifacts, one row per artifact
	RecentArtifacts *[]DiscoverRecent `json:"recent_artifacts"`

	// TopArtifacts Artifacts ranked by how widely they are used, how many versions are tracked, and how recently they were seen
	TopArtifacts *[]DiscoverArtifact `json:"top_artifacts"`

	// TopVulnerabilities Vulnerabilities ranked by how many public artifacts they affect
	TopVulnerabilities *[]DiscoverVuln `json:"top_vulnerabilities"`

	// Warming No snapshot is available yet, so every section is empty because nothing is known — not because the catalog is empty; render a loading state and retry
	Warming bool `json:"warming"`
}

type DistinctComponentFilter struct {
	Name     string
	Group    string
	Type     string
	PurlType string
	Sort     string
	SortDir  string
}

type DistinctComponentSummary struct {
	Group        *string     `json:"group,omitempty"`
	Name         string      `json:"name"`
	PurlTypes    *[]string   `json:"purlTypes,omitempty"`
	SbomCount    int64       `json:"sbomCount"`
	Type         string      `json:"type"`
	VersionCount int64       `json:"versionCount"`
	Vulns        VulnSummary `json:"vulns"`
}

type EnrichmentJobResponse struct {
	// ArtifactName Name of the artifact, for display
	ArtifactName *string `json:"artifact_name,omitempty"`
	Attempts     int32   `json:"attempts"`
	CreatedAt    string  `json:"created_at"`

	// EnricherName Which enricher this job runs
	EnricherName EnrichmentJobResponseEnricherName `json:"enricher_name"`
	FinishedAt   *string                           `json:"finished_at,omitempty"`

	// Id Job UUID
	Id            string  `json:"id"`
	LastAttemptAt *string `json:"last_attempt_at,omitempty"`
	LastError     *string `json:"last_error,omitempty"`

	// SbomDigest Digest of the SBOM's image, for display
	SbomDigest *string `json:"sbom_digest,omitempty"`

	// SbomId SBOM being enriched
	SbomId    *string                    `json:"sbom_id,omitempty"`
	StartedAt *string                    `json:"started_at,omitempty"`
	State     EnrichmentJobResponseState `json:"state"`

	// WorkerId Pod hostname that is processing this job
	WorkerId *string `json:"worker_id,omitempty"`
}

type EnrichmentJobResponseEnricherName string

type EnrichmentJobResponseState string

type EnrichmentJobSummaryRow struct {
	Count        int64  `json:"count"`
	EnricherName string `json:"enricher_name"`
	State        string `json:"state"`
}

type EnrichmentJobsSummaryOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string                    `json:"$schema,omitempty"`
	Data   *[]EnrichmentJobSummaryRow `json:"data"`
}

type EnrichmentStatus struct {
	Enabled   bool  `json:"enabled"`
	QueueSize int64 `json:"queue_size"`
	Workers   int64 `json:"workers"`
}

type ErrorDetail struct {
	// Location Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
	Location *string `json:"location,omitempty"`

	// Message Error message text
	Message *string `json:"message,omitempty"`

	// Value The value at the given location
	Value interface{} `json:"value,omitempty"`
}

type ErrorModel struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string `json:"$schema,omitempty"`

	// Detail A human-readable explanation specific to this occurrence of the problem.
	Detail *string `json:"detail,omitempty"`

	// Errors Optional list of individual error details
	Errors *[]ErrorDetail `json:"errors,omitempty"`

	// Instance A URI reference that identifies the specific occurrence of the problem.
	Instance *string `json:"instance,omitempty"`

	// Status HTTP status code
	Status *int64 `json:"status,omitempty"`

	// Title A short, human-readable summary of the problem type. This value should not change between occurrences of the error.
	Title *string `json:"title,omitempty"`

	// Type A URI reference to human-readable documentation for the error.
	Type *string `json:"type,omitempty"`
}

type ExternalRefEntry struct {
	Comment *string `json:"comment,omitempty"`
	Type    string  `json:"type"`
	Url     string  `json:"url"`
}

type FakeClient struct {
	// Registry + auth
	ListRegistriesFn          func(ctx context.Context, opts PageOpts) (Page[RegistryResponse], error)
	GetRegistryFn             func(ctx context.Context, id string) (RegistryResponse, error)
	GetRegistryByNameFn       func(ctx context.Context, name string) (RegistryResponse, error)
	CreateRegistryFn          func(ctx context.Context, body CreateRegistryInputBody) (CreateRegistryResponseBody, error)
	UpdateRegistryFn          func(ctx context.Context, id string, body UpdateRegistryInputBody) (RegistryResponse, error)
	DeleteRegistryFn          func(ctx context.Context, id string) error
	ScanRegistryFn            func(ctx context.Context, id string) (ScanRegistryOutputBody, error)
	PreviewRegistryConfigFn   func(ctx context.Context, body PreviewRegistryConfigInputBody) (RegistryPreview, error)
	GetRegistryPreviewFn      func(ctx context.Context, id string) (RegistryPreview, error)
	TestRegistryConnectionFn  func(ctx context.Context, body TestRegistryConnectionInputBody) (TestRegistryConnectionOutputBody, error)
	RegenerateWebhookSecretFn func(ctx context.Context, id string) (RegenerateWebhookSecretOutputBody, error)

	// Namespace + source
	ListNamespacesFn     func(ctx context.Context) ([]NamespaceResponse, error)
	GetNamespaceFn       func(ctx context.Context, id string) (NamespaceResponse, error)
	GetNamespaceByNameFn func(ctx context.Context, name string) (NamespaceResponse, error)
	CreateNamespaceFn    func(ctx context.Context, body CreateNamespaceInputBody) (NamespaceResponse, error)
	UpdateNamespaceFn    func(ctx context.Context, id string, body UpdateNamespaceInputBody) (NamespaceResponse, error)
	DeleteNamespaceFn    func(ctx context.Context, id string) error

	ListSourcesFn  func(ctx context.Context, namespaceID string) ([]SourceResponse, error)
	GetSourceFn    func(ctx context.Context, id string) (SourceResponse, error)
	CreateSourceFn func(ctx context.Context, body CreateSourceInputBody) (SourceResponse, error)
	UpdateSourceFn func(ctx context.Context, id string, body UpdateSourceInputBody) (SourceResponse, error)
	DeleteSourceFn func(ctx context.Context, id string) error

	CreateAPIKeyFn   func(ctx context.Context, body CreateAPIKeyInputBody) (CreateAPIKeyOutputBody, error)
	ListAPIKeysFn    func(ctx context.Context) ([]KeyMetaResponse, error)
	DeleteAPIKeyFn   func(ctx context.Context, id string) error
	GetCurrentUserFn func(ctx context.Context) (MeOutputBody, error)

	// Cluster inventory
	ListClustersFn         func(ctx context.Context, namespaceID string) ([]ClusterResponse, error)
	GetClusterFn           func(ctx context.Context, id string) (ClusterResponse, error)
	CreateClusterFn        func(ctx context.Context, body CreateClusterInputBody) (ClusterResponse, error)
	UpdateClusterFn        func(ctx context.Context, id string, body UpdateClusterInputBody) (ClusterResponse, error)
	DeleteClusterFn        func(ctx context.Context, id string) error
	PutInventoryFn         func(ctx context.Context, clusterID string, workloads []InventoryWorkload) (PutInventoryOutputBody, error)
	ListClusterWorkloadsFn func(ctx context.Context, clusterID string) ([]ClusterWorkloadResponse, WorkloadCoverageResponse, error)

	// SBOM + artifact
	IngestSBOMFn                func(ctx context.Context, data []byte, params IngestSbomParams) (IngestSBOMOutputBody, error)
	GetSBOMFn                   func(ctx context.Context, id string, includeRaw bool) (SBOMDetail, error)
	ListSBOMsFn                 func(ctx context.Context, filter SBOMFilter, opts PageOpts) (CursorPage[SBOMSummary], error)
	DeleteSBOMFn                func(ctx context.Context, id string) error
	DiffSBOMsFn                 func(ctx context.Context, fromID, toID string) (ChangelogEntry, error)
	GetDiffTreeFn               func(ctx context.Context, fromID, toID string) (DiffTree, error)
	ListArtifactsFn             func(ctx context.Context, filter ArtifactFilter, opts PageOpts) (CursorPage[ArtifactSummary], error)
	GetArtifactFn               func(ctx context.Context, id string) (ArtifactDetail, error)
	GetArtifactChangelogFn      func(ctx context.Context, id string, params GetArtifactChangelogParams) (Changelog, error)
	GetArtifactLicenseSummaryFn func(ctx context.Context, id string) (GetArtifactLicenseSummaryOutputBody, error)
	ListArtifactSBOMsFn         func(ctx context.Context, id string, opts PageOpts) (CursorPage[SBOMSummary], error)
	ListArtifactVersionsFn      func(ctx context.Context, id string, opts PageOpts) (Page[ArtifactVersionSummary], error)

	// Name-keyed resolvers (ADR-042)
	LookupArtifactFn func(ctx context.Context, params LookupArtifactParams) (ArtifactDetail, error)
	LookupSBOMFn     func(ctx context.Context, params LookupSbomParams) (SBOMDetail, error)
	LookupLicenseFn  func(ctx context.Context, spdxID string) (LicenseCount, error)

	// Vulnerabilities
	GetArtifactVulnSummaryFn func(ctx context.Context, artifactID string) (VulnSummary, error)
	GetComponentVulnsFn      func(ctx context.Context, componentID string) ([]ComponentVulnEntry, error)
	GetVulnerabilityFn       func(ctx context.Context, vulnID string, opts PageOpts) (GetVulnerabilityOutputBody, error)

	// Component + job + stats
	SearchComponentsFn         func(ctx context.Context, filter ComponentFilter, opts PageOpts) (Page[ComponentSummary], error)
	SearchDistinctComponentsFn func(ctx context.Context, filter DistinctComponentFilter, opts PageOpts) (Page[DistinctComponentSummary], error)
	GetComponentFn             func(ctx context.Context, id string) (ComponentDetail, error)
	GetComponentVersionsFn     func(ctx context.Context, params GetComponentVersionsParams) (GetComponentVersionsOutputBody, error)
	ListComponentPurlTypesFn   func(ctx context.Context) ([]string, error)
	ListSBOMComponentsFn       func(ctx context.Context, sbomID string) ([]ComponentSummary, error)
	GetSBOMDependenciesFn      func(ctx context.Context, sbomID string) (DependencyGraph, error)

	ListJobsFn          func(ctx context.Context, filter JobFilter, opts PageOpts) (Page[ScanJobResponse], error)
	GetJobFn            func(ctx context.Context, id string) (ScanJobResponse, error)
	RetryJobFn          func(ctx context.Context, id string) error
	GetDashboardStatsFn func(ctx context.Context) (DashboardStatsOutputBody, error)

	GetOpenAPISpecFn func(ctx context.Context) (json.RawMessage, error)
}

type GetArtifactChangelogParams struct {
	// SubjectVersion Filter by subject version
	SubjectVersion *string `form:"subject_version,omitempty" json:"subject_version,omitempty"`

	// Arch Architecture to show timeline for (e.g. amd64)
	Arch *string `form:"arch,omitempty" json:"arch,omitempty"`

	// Flavor Flavor to show timeline for (e.g. standard, fips)
	Flavor *string `form:"flavor,omitempty" json:"flavor,omitempty"`

	// Mode Sort/filter mode: 'semver' (semver versions, semver order), 'all' (every version, build-time order). Empty auto-selects semver when available.
	Mode *GetArtifactChangelogParamsMode `form:"mode,omitempty" json:"mode,omitempty"`

	// Limit Maximum number of changelog entries per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of entries to skip, counting from the newest
	Offset *int32 `form:"offset,omitempty" json:"offset,omitempty"`
}

type GetArtifactChangelogParamsMode string

type GetArtifactContainsOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema   *string             `json:"$schema,omitempty"`
	Contains *[]ArtifactRelation `json:"contains"`
}

type GetArtifactLicenseSummaryOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema   *string         `json:"$schema,omitempty"`
	Licenses *[]LicenseCount `json:"licenses"`
}

type GetArtifactUsagesOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string             `json:"$schema,omitempty"`
	Usages *[]ArtifactRelation `json:"usages"`
}

type GetArtifactVulnSummaryOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema  *string     `json:"$schema,omitempty"`
	Summary VulnSummary `json:"summary"`
}

type GetComponentVersionsOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string `json:"$schema,omitempty"`

	// ArtifactCount Distinct artifacts whose SBOMs contain this component, across every page
	ArtifactCount int64          `json:"artifactCount"`
	Pagination    PaginationMeta `json:"pagination"`

	// VersionCount Distinct versions under this identity, across every page
	VersionCount int64                    `json:"versionCount"`
	Versions     *[]ComponentVersionEntry `json:"versions"`
}

type GetComponentVersionsParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of results to skip
	Offset *int32 `form:"offset,omitempty" json:"offset,omitempty"`

	// Name Component name
	Name string `form:"name" json:"name"`

	// Group Filter by component group
	Group *string `form:"group,omitempty" json:"group,omitempty"`

	// Version Filter by component version
	Version *string `form:"version,omitempty" json:"version,omitempty"`

	// Type Filter by component type
	Type *string `form:"type,omitempty" json:"type,omitempty"`
}

type GetComponentVulnsOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string               `json:"$schema,omitempty"`
	Data   *[]ComponentVulnEntry `json:"data"`
}

type GetRegistryTrustSummaryOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string               `json:"$schema,omitempty"`
	Data   *[]RegistryTrustCount `json:"data"`
}

type GetSbomParams struct {
	// Include Set to 'raw' to include the raw BOM JSON
	Include *string `form:"include,omitempty" json:"include,omitempty"`
}

type GetVulnerabilityOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema               *string              `json:"$schema,omitempty"`
	AffectedArtifacts    *[]AffectedArtifact  `json:"affectedArtifacts"`
	AffectedComponents   *[]AffectedComponent `json:"affectedComponents"`
	ComponentsPagination PaginationMeta       `json:"componentsPagination"`

	// NamespaceCount Namespaces visible to the caller that hold at least one affected SBOM
	NamespaceCount int64          `json:"namespaceCount"`
	Pagination     PaginationMeta `json:"pagination"`
	Vulnerability  VulnDetail     `json:"vulnerability"`
}

type GetVulnerabilityParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of results to skip
	Offset *int32 `form:"offset,omitempty" json:"offset,omitempty"`
}

type HashEntry struct {
	Algorithm string `json:"algorithm"`
	Value     string `json:"value"`
}

type HealthCheckOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string `json:"$schema,omitempty"`

	// Status Health status
	Status string `json:"status"`
}

type IdentityResponse struct {
	CreatedAt time.Time `json:"created_at"`

	// DisplayName Label for the issuer
	DisplayName string `json:"display_name"`

	// Email Address this issuer released, if any
	Email *string `json:"email,omitempty"`

	// Id Identity UUID
	Id string `json:"id"`

	// Provider Issuer key: 'github', or 'oidc:<name>'
	Provider string `json:"provider"`

	// Subject The issuer's stable identifier for this account
	Subject string `json:"subject"`
}

type IngestClusterUnknownImagesJSONRequestBody = IngestUnknownInputBody

type IngestSBOMOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string `json:"$schema,omitempty"`

	// ComponentCount Number of components in the SBOM
	ComponentCount int64 `json:"componentCount"`

	// Id UUID of the created SBOM
	Id string `json:"id"`

	// SerialNumber SBOM serial number
	SerialNumber *string `json:"serialNumber,omitempty"`

	// SpecVersion CycloneDX spec version
	SpecVersion string `json:"specVersion"`

	// Status Ingestion status
	Status string `json:"status"`
}

type IngestSbomParams struct {
	// Source Ingest channel this SBOM arrived through, as a source UUID or <namespace>/<name>. Required — the source's namespace owns the SBOM.
	Source *string `form:"source,omitempty" json:"source,omitempty"`

	// Version Image version/tag (overrides BOM-extracted value for subject_version and imageVersion)
	Version *string `form:"version,omitempty" json:"version,omitempty"`

	// Architecture Image architecture (e.g. amd64, arm64)
	Architecture *string `form:"architecture,omitempty" json:"architecture,omitempty"`

	// BuildDate Image build date (RFC3339 or date string)
	BuildDate *string `form:"build_date,omitempty" json:"build_date,omitempty"`

	// SubjectType CycloneDX component type of the subject (e.g. application, library, file)
	SubjectType *string `form:"subject_type,omitempty" json:"subject_type,omitempty"`

	// SubjectName Subject name (e.g. ocidex)
	SubjectName *string `form:"subject_name,omitempty" json:"subject_name,omitempty"`

	// SubjectGroup Subject group/namespace (e.g. github.com/pfenerty)
	SubjectGroup *string `form:"subject_group,omitempty" json:"subject_group,omitempty"`

	// SubjectPurl Subject package URL (e.g. pkg:golang/github.com/pfenerty/ocidex@v1.2.3)
	SubjectPurl *string `form:"subject_purl,omitempty" json:"subject_purl,omitempty"`

	// Digest sha256 of the artifact file itself, not of this SBOM document. Required for a non-container subject.
	Digest *string `form:"digest,omitempty" json:"digest,omitempty"`
}

type IngestUnknownInputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string `json:"$schema,omitempty"`

	// ImageDigests Limit the run to these running image digests. Omit to ingest every unknown image the cluster reports.
	ImageDigests *[]string `json:"image_digests,omitempty"`
}

type IngestUnknownOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string `json:"$schema,omitempty"`

	// Considered Unknown images looked at; the counts below account for all of them
	Considered int64 `json:"considered"`

	// Failed Submission errored against a reachable registry — transient, unlike the skips
	Failed int64 `json:"failed"`

	// Queued Scan jobs enqueued. A multi-arch image expands into one job per platform, so this can exceed the image count.
	Queued int64 `json:"queued"`

	// SkippedNoRegistry No registry in this cluster's namespace is configured for the image's host
	SkippedNoRegistry int64 `json:"skipped_no_registry"`

	// SkippedPatternExcluded The registry's repository patterns exclude this repository
	SkippedPatternExcluded int64 `json:"skipped_pattern_excluded"`

	// SkippedRegistryDisabled The host matches a registry that is switched off
	SkippedRegistryDisabled int64 `json:"skipped_registry_disabled"`

	// SkippedUnparseableRef The reported reference carries no host to resolve against
	SkippedUnparseableRef int64 `json:"skipped_unparseable_ref"`
}

type InventoryWorkload struct {
	ContainerName string `json:"container_name"`

	// ImageDigest Normalized digest from status.containerStatuses[].imageID. Omit when the agent could not extract one — that is reported as 'unresolvable', not silently dropped.
	ImageDigest *string `json:"image_digest,omitempty"`

	// ImageRef Image reference, for display only. Never used as an identity: a tag is mutable.
	ImageRef string `json:"image_ref"`

	// K8sNamespace Kubernetes namespace the workload runs in
	K8sNamespace string `json:"k8s_namespace"`

	// PodCount Running pods carrying this container at this digest
	PodCount int32 `json:"pod_count"`

	// WorkloadKind Owning workload kind (Deployment, StatefulSet, DaemonSet, Job, CronJob, Pod)
	WorkloadKind string `json:"workload_kind"`
	WorkloadName string `json:"workload_name"`
}

type JobFilter struct {
	// State is one of queued, running, succeeded, or failed.
	State string
}

type KeyMetaResponse struct {
	// Capabilities Capabilities this key may exercise, before intersection with the owner's live namespace roles
	Capabilities *[]string `json:"capabilities"`
	CreatedAt    time.Time `json:"created_at"`

	// Id Key UUID
	Id         string     `json:"id"`
	LastUsedAt *time.Time `json:"last_used_at,omitempty"`
	Name       string     `json:"name"`

	// Prefix First 8 characters of the key
	Prefix string `json:"prefix"`
}

type LicenseCount struct {
	// Schema A URL to the JSON Schema for this object.
	Schema         *string `json:"$schema,omitempty"`
	Category       string  `json:"category"`
	ComponentCount int64   `json:"componentCount"`
	Id             string  `json:"id"`
	Name           string  `json:"name"`
	SpdxId         *string `json:"spdxId,omitempty"`
	Url            *string `json:"url,omitempty"`
}

type LicenseSummary struct {
	Id     string  `json:"id"`
	Name   string  `json:"name"`
	SpdxId *string `json:"spdxId,omitempty"`
	Url    *string `json:"url,omitempty"`
}

type LinkIdentityJSONRequestBody = StartIdentityLinkInputBody

type ListAPIKeysOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string            `json:"$schema,omitempty"`
	Keys   *[]KeyMetaResponse `json:"keys"`
}

type ListArtifactSBOMsOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string        `json:"$schema,omitempty"`
	Data       *[]SBOMSummary `json:"data"`
	Pagination CursorMeta     `json:"pagination"`
}

type ListArtifactSbomsParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Cursor Opaque cursor from a previous response's nextCursor; omit for the first page
	Cursor *string `form:"cursor,omitempty" json:"cursor,omitempty"`

	// SubjectVersion Filter by subject version
	SubjectVersion *string `form:"subject_version,omitempty" json:"subject_version,omitempty"`

	// ImageVersion Filter by image version
	ImageVersion *string `form:"image_version,omitempty" json:"image_version,omitempty"`
}

type ListArtifactVersionsOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string                   `json:"$schema,omitempty"`
	Data   *[]ArtifactVersionSummary `json:"data"`

	// HasSemver Whether the artifact has any semver-parseable version
	HasSemver  bool           `json:"hasSemver"`
	Pagination PaginationMeta `json:"pagination"`

	// ResolvedMode Concrete sort mode applied after auto-resolution
	ResolvedMode ListArtifactVersionsOutputBodyResolvedMode `json:"resolvedMode"`
}

type ListArtifactVersionsOutputBodyResolvedMode string

type ListArtifactVersionsParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of results to skip
	Offset *int32 `form:"offset,omitempty" json:"offset,omitempty"`

	// Mode Sort/filter mode: 'semver' (semver versions, semver order), 'all' (every version, build-time order). Empty auto-selects semver when available.
	Mode *ListArtifactVersionsParamsMode `form:"mode,omitempty" json:"mode,omitempty"`

	// Sort Column to sort by, applied on top of mode. Empty keeps the mode's own ordering.
	Sort *ListArtifactVersionsParamsSort `form:"sort,omitempty" json:"sort,omitempty"`

	// Dir Sort direction; defaults to desc (worst first) when sort is set.
	Dir *ListArtifactVersionsParamsDir `form:"dir,omitempty" json:"dir,omitempty"`
}

type ListArtifactVersionsParamsDir string

type ListArtifactVersionsParamsMode string

type ListArtifactVersionsParamsSort string

type ListArtifactVulnsOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema        *string              `json:"$schema,omitempty"`
	Data          *[]ArtifactVulnEntry `json:"data"`
	Pagination    PaginationMeta       `json:"pagination"`
	TotalVersions int64                `json:"totalVersions"`
	VersionScope  int32                `json:"versionScope"`
}

type ListArtifactVulnsParams struct {
	// Severity Filter by severity
	Severity *ListArtifactVulnsParamsSeverity `form:"severity,omitempty" json:"severity,omitempty"`

	// Vuln Filter to a single advisory, by canonical id or native OSV id
	Vuln *string `form:"vuln,omitempty" json:"vuln,omitempty"`

	// Sort Column to sort by. Unset means worst first: severity, then CVSS.
	Sort *ListArtifactVulnsParamsSort `form:"sort,omitempty" json:"sort,omitempty"`

	// Dir Sort direction (default asc). Applies to sort only — with sort unset the worst-first default ordering ignores it.
	Dir *ListArtifactVulnsParamsDir `form:"dir,omitempty" json:"dir,omitempty"`

	// VersionScope How many of the artifact's most recent versions to scan
	VersionScope *int32 `form:"versionScope,omitempty" json:"versionScope,omitempty"`

	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of results to skip
	Offset *int32 `form:"offset,omitempty" json:"offset,omitempty"`
}

type ListArtifactVulnsParamsDir string

type ListArtifactVulnsParamsSeverity string

type ListArtifactVulnsParamsSort string

type ListArtifactsOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string            `json:"$schema,omitempty"`
	Data       *[]ArtifactSummary `json:"data"`
	Pagination CursorMeta         `json:"pagination"`
}

type ListArtifactsParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Cursor Opaque cursor from a previous response's nextCursor; omit for the first page
	Cursor *string `form:"cursor,omitempty" json:"cursor,omitempty"`

	// Type Filter by artifact type
	Type *string `form:"type,omitempty" json:"type,omitempty"`

	// Name Filter by artifact name
	Name *string `form:"name,omitempty" json:"name,omitempty"`

	// Sufficient Filter to artifacts with sufficiently enriched SBOMs; pass 'false' to include all (default: true)
	Sufficient *string `form:"sufficient,omitempty" json:"sufficient,omitempty"`

	// Sort Column to sort by. Empty orders by name. Changing it invalidates any cursor already held.
	Sort *ListArtifactsParamsSort `form:"sort,omitempty" json:"sort,omitempty"`

	// Dir Sort direction; defaults to desc (worst first) when sort is set.
	Dir *ListArtifactsParamsDir `form:"dir,omitempty" json:"dir,omitempty"`
}

type ListArtifactsParamsDir string

type ListArtifactsParamsSort string

type ListClusterImagesOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string                  `json:"$schema,omitempty"`
	Coverage   WorkloadCoverageResponse `json:"coverage"`
	Data       *[]ClusterImageResponse  `json:"data"`
	Pagination PaginationMeta           `json:"pagination"`
}

type ListClusterImagesParams struct {
	// K8sNamespace Filter to one Kubernetes namespace
	K8sNamespace *string `form:"k8s_namespace,omitempty" json:"k8s_namespace,omitempty"`

	// MatchState Filter by SBOM match state
	MatchState *ListClusterImagesParamsMatchState `form:"match_state,omitempty" json:"match_state,omitempty"`

	// Q Substring match over workload name, container name and image reference
	Q *string `form:"q,omitempty" json:"q,omitempty"`

	// Sort Column to sort by. vuln_count orders by severity, worst first, and sorts unassessed images last in either direction. Unset means image reference order.
	Sort *ListClusterImagesParamsSort `form:"sort,omitempty" json:"sort,omitempty"`

	// Dir Sort direction (default asc). Applies to sort only — with sort unset the default ordering ignores it.
	Dir *ListClusterImagesParamsDir `form:"dir,omitempty" json:"dir,omitempty"`

	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of results to skip
	Offset *int32 `form:"offset,omitempty" json:"offset,omitempty"`
}

type ListClusterImagesParamsDir string

type ListClusterImagesParamsMatchState string

type ListClusterImagesParamsSort string

type ListClusterNamespacesOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string                   `json:"$schema,omitempty"`
	Data   *[]NamespaceFacetResponse `json:"data"`
}

type ListClusterUnknownImagesOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string                 `json:"$schema,omitempty"`
	Data   *[]UnknownImageResponse `json:"data"`

	// Hosts The entire gap grouped by registry scope, biggest first; independent of the page returned
	Hosts      *[]UnknownHostResponse   `json:"hosts"`
	Pagination PaginationMeta           `json:"pagination"`
	Reasons    UnknownImageReasonCounts `json:"reasons"`
}

type ListClusterUnknownImagesParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of results to skip
	Offset *int32 `form:"offset,omitempty" json:"offset,omitempty"`
}

type ListClusterVulnsOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string                  `json:"$schema,omitempty"`
	Coverage   WorkloadCoverageResponse `json:"coverage"`
	Data       *[]RunningVulnResponse   `json:"data"`
	Pagination PaginationMeta           `json:"pagination"`
}

type ListClusterVulnsParams struct {
	// Severity Filter by severity
	Severity *ListClusterVulnsParamsSeverity `form:"severity,omitempty" json:"severity,omitempty"`

	// Sort Column to sort by. Unset means worst first: severity, then CVSS.
	Sort *ListClusterVulnsParamsSort `form:"sort,omitempty" json:"sort,omitempty"`

	// Dir Sort direction (default asc). Applies to sort only — with sort unset the worst-first default ordering ignores it.
	Dir *ListClusterVulnsParamsDir `form:"dir,omitempty" json:"dir,omitempty"`

	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of results to skip
	Offset *int32 `form:"offset,omitempty" json:"offset,omitempty"`
}

type ListClusterVulnsParamsDir string

type ListClusterVulnsParamsSeverity string

type ListClusterVulnsParamsSort string

type ListClusterWorkloadsOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string                    `json:"$schema,omitempty"`
	Coverage   WorkloadCoverageResponse   `json:"coverage"`
	Data       *[]ClusterWorkloadResponse `json:"data"`
	Pagination PaginationMeta             `json:"pagination"`
}

type ListClusterWorkloadsParams struct {
	// K8sNamespace Filter to one Kubernetes namespace
	K8sNamespace *string `form:"k8s_namespace,omitempty" json:"k8s_namespace,omitempty"`

	// MatchState Filter by SBOM match state
	MatchState *ListClusterWorkloadsParamsMatchState `form:"match_state,omitempty" json:"match_state,omitempty"`

	// Q Substring match over workload name, container name and image reference
	Q *string `form:"q,omitempty" json:"q,omitempty"`

	// Sort Column to sort by. vuln_count orders by severity, worst first, and sorts unmatched workloads last in either direction. Unset means namespace, then workload, then container.
	Sort *ListClusterWorkloadsParamsSort `form:"sort,omitempty" json:"sort,omitempty"`

	// Dir Sort direction (default asc). Applies to sort only — with sort unset the default ordering ignores it.
	Dir *ListClusterWorkloadsParamsDir `form:"dir,omitempty" json:"dir,omitempty"`

	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of results to skip
	Offset *int32 `form:"offset,omitempty" json:"offset,omitempty"`
}

type ListClusterWorkloadsParamsDir string

type ListClusterWorkloadsParamsMatchState string

type ListClusterWorkloadsParamsSort string

type ListClustersOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string            `json:"$schema,omitempty"`
	Data   *[]ClusterResponse `json:"data"`
}

type ListClustersParams struct {
	// NamespaceId Limit to clusters in one namespace
	NamespaceId *string `form:"namespace_id,omitempty" json:"namespace_id,omitempty"`
}

type ListComponentPurlTypesOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string   `json:"$schema,omitempty"`
	Types  *[]string `json:"types"`
}

type ListComponentsByLicenseOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string             `json:"$schema,omitempty"`
	Data       *[]ComponentSummary `json:"data"`
	Pagination PaginationMeta      `json:"pagination"`
}

type ListComponentsByLicenseParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of results to skip
	Offset *int32 `form:"offset,omitempty" json:"offset,omitempty"`
}

type ListEnrichmentJobsOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string                  `json:"$schema,omitempty"`
	Data       *[]EnrichmentJobResponse `json:"data"`
	Pagination PaginationMeta           `json:"pagination"`
}

type ListEnrichmentJobsParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of results to skip
	Offset *int32 `form:"offset,omitempty" json:"offset,omitempty"`

	// State Filter by job state
	State *ListEnrichmentJobsParamsState `form:"state,omitempty" json:"state,omitempty"`

	// EnricherName Filter by enricher
	EnricherName *ListEnrichmentJobsParamsEnricherName `form:"enricher_name,omitempty" json:"enricher_name,omitempty"`
}

type ListEnrichmentJobsParamsEnricherName string

type ListEnrichmentJobsParamsState string

type ListIdentitiesOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string             `json:"$schema,omitempty"`
	Identities *[]IdentityResponse `json:"identities"`
}

type ListLicensesOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string         `json:"$schema,omitempty"`
	Data       *[]LicenseCount `json:"data"`
	Pagination PaginationMeta  `json:"pagination"`
}

type ListLicensesParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of results to skip
	Offset *int32 `form:"offset,omitempty" json:"offset,omitempty"`

	// SpdxId Filter by SPDX identifier
	SpdxId *string `form:"spdx_id,omitempty" json:"spdx_id,omitempty"`

	// Name Filter by license name
	Name *string `form:"name,omitempty" json:"name,omitempty"`

	// Category Filter by license category
	Category *string `form:"category,omitempty" json:"category,omitempty"`
}

type ListMyActivityOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string          `json:"$schema,omitempty"`
	Data       *[]ActivityEntry `json:"data"`
	Pagination CursorMeta       `json:"pagination"`
}

type ListMyActivityParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Cursor Opaque cursor from a previous response's nextCursor; omit for the first page
	Cursor *string `form:"cursor,omitempty" json:"cursor,omitempty"`
}

type ListMyArtifactsParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Cursor Opaque cursor from a previous response's nextCursor; omit for the first page
	Cursor *string `form:"cursor,omitempty" json:"cursor,omitempty"`

	// Type Filter by artifact type
	Type *string `form:"type,omitempty" json:"type,omitempty"`

	// Name Filter by artifact name
	Name *string `form:"name,omitempty" json:"name,omitempty"`

	// Sufficient Filter to artifacts with sufficiently enriched SBOMs; pass 'false' to include all (default: true)
	Sufficient *string `form:"sufficient,omitempty" json:"sufficient,omitempty"`

	// Sort Column to sort by. Empty orders by name. Changing it invalidates any cursor already held.
	Sort *ListMyArtifactsParamsSort `form:"sort,omitempty" json:"sort,omitempty"`

	// Dir Sort direction; defaults to desc (worst first) when sort is set.
	Dir *ListMyArtifactsParamsDir `form:"dir,omitempty" json:"dir,omitempty"`
}

type ListMyArtifactsParamsDir string

type ListMyArtifactsParamsSort string

type ListMyDriftFeedParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Cursor Opaque cursor from a previous response's nextCursor; omit for the first page
	Cursor *string `form:"cursor,omitempty" json:"cursor,omitempty"`
}

type ListMyRegistriesParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of results to skip
	Offset *int32 `form:"offset,omitempty" json:"offset,omitempty"`
}

type ListMyVulnerabilitiesParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of results to skip
	Offset *int32 `form:"offset,omitempty" json:"offset,omitempty"`

	// Q Filter by vulnerability id (CVE/GHSA/OSV), substring match against the canonical id and its aliases
	Q *string `form:"q,omitempty" json:"q,omitempty"`

	// Severity Filter by severity
	Severity *ListMyVulnerabilitiesParamsSeverity `form:"severity,omitempty" json:"severity,omitempty"`

	// Sort Sort field
	Sort *ListMyVulnerabilitiesParamsSort `form:"sort,omitempty" json:"sort,omitempty"`

	// SortDir Sort direction (asc or desc)
	SortDir *ListMyVulnerabilitiesParamsSortDir `form:"sort_dir,omitempty" json:"sort_dir,omitempty"`
}

type ListMyVulnerabilitiesParamsSeverity string

type ListMyVulnerabilitiesParamsSort string

type ListMyVulnerabilitiesParamsSortDir string

type ListMyWatchFeedOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string       `json:"$schema,omitempty"`
	Data       *[]WatchEvent `json:"data"`
	Pagination CursorMeta    `json:"pagination"`
}

type ListMyWatchFeedParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Cursor Opaque cursor from a previous response's nextCursor; omit for the first page
	Cursor *string `form:"cursor,omitempty" json:"cursor,omitempty"`
}

type ListMyWatchesOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string       `json:"$schema,omitempty"`
	Data       *[]WatchEntry `json:"data"`
	Pagination CursorMeta    `json:"pagination"`
}

type ListMyWatchesParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Cursor Opaque cursor from a previous response's nextCursor; omit for the first page
	Cursor *string `form:"cursor,omitempty" json:"cursor,omitempty"`
}

type ListNamespaceMembersOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string                    `json:"$schema,omitempty"`
	Data   *[]NamespaceMemberResponse `json:"data"`
}

type ListNamespacesOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string              `json:"$schema,omitempty"`
	Data   *[]NamespaceResponse `json:"data"`
}

type ListProvidersOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema    *string             `json:"$schema,omitempty"`
	Providers *[]ProviderResponse `json:"providers"`
}

type ListRecentDriftOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string             `json:"$schema,omitempty"`
	Data       *[]RecentDriftEntry `json:"data"`
	Pagination CursorMeta          `json:"pagination"`
}

type ListRecentDriftParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Cursor Opaque cursor from a previous response's nextCursor; omit for the first page
	Cursor *string `form:"cursor,omitempty" json:"cursor,omitempty"`
}

type ListRegistriesOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string             `json:"$schema,omitempty"`
	Data       *[]RegistryResponse `json:"data"`
	Pagination PaginationMeta      `json:"pagination"`
}

type ListRegistriesParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of results to skip
	Offset *int32 `form:"offset,omitempty" json:"offset,omitempty"`
}

type ListSBOMComponentsOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string             `json:"$schema,omitempty"`
	Components *[]ComponentSummary `json:"components"`
	Pagination CursorMeta          `json:"pagination"`
}

type ListSBOMDriftHistoryOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string                   `json:"$schema,omitempty"`
	Data       *[]ProvenanceDriftSummary `json:"data"`
	Pagination CursorMeta                `json:"pagination"`
}

type ListSBOMVulnsOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string          `json:"$schema,omitempty"`
	Data       *[]SBOMVulnEntry `json:"data"`
	Pagination PaginationMeta   `json:"pagination"`
}

type ListSBOMsOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string        `json:"$schema,omitempty"`
	Data       *[]SBOMSummary `json:"data"`
	Pagination CursorMeta     `json:"pagination"`
}

type ListSbomComponentsParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Cursor Opaque cursor from a previous response's nextCursor; omit for the first page
	Cursor *string `form:"cursor,omitempty" json:"cursor,omitempty"`

	// Sort Column to sort by. Empty orders by name. Changing it invalidates any cursor already held.
	Sort *ListSbomComponentsParamsSort `form:"sort,omitempty" json:"sort,omitempty"`

	// Dir Sort direction; defaults to desc (worst first) when sort is set.
	Dir *ListSbomComponentsParamsDir `form:"dir,omitempty" json:"dir,omitempty"`
}

type ListSbomComponentsParamsDir string

type ListSbomComponentsParamsSort string

type ListSbomDriftHistoryParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Cursor Opaque cursor from a previous response's nextCursor; omit for the first page
	Cursor *string `form:"cursor,omitempty" json:"cursor,omitempty"`
}

type ListSbomVulnsParams struct {
	// Severity Filter by severity
	Severity *ListSbomVulnsParamsSeverity `form:"severity,omitempty" json:"severity,omitempty"`

	// Sort Column to sort by. Unset means worst first: severity, then CVSS.
	Sort *ListSbomVulnsParamsSort `form:"sort,omitempty" json:"sort,omitempty"`

	// Dir Sort direction (default asc). Applies to sort only — with sort unset the worst-first default ordering ignores it.
	Dir *ListSbomVulnsParamsDir `form:"dir,omitempty" json:"dir,omitempty"`

	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of results to skip
	Offset *int32 `form:"offset,omitempty" json:"offset,omitempty"`
}

type ListSbomVulnsParamsDir string

type ListSbomVulnsParamsSeverity string

type ListSbomVulnsParamsSort string

type ListSbomsParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Cursor Opaque cursor from a previous response's nextCursor; omit for the first page
	Cursor *string `form:"cursor,omitempty" json:"cursor,omitempty"`

	// SerialNumber Filter by serial number
	SerialNumber *string `form:"serial_number,omitempty" json:"serial_number,omitempty"`

	// Digest Filter by image digest
	Digest *string `form:"digest,omitempty" json:"digest,omitempty"`
}

type ListScanJobsOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string            `json:"$schema,omitempty"`
	Data       *[]ScanJobResponse `json:"data"`
	Pagination PaginationMeta     `json:"pagination"`
}

type ListScanJobsParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of results to skip
	Offset *int32 `form:"offset,omitempty" json:"offset,omitempty"`

	// State Filter by job state
	State *ListScanJobsParamsState `form:"state,omitempty" json:"state,omitempty"`
}

type ListScanJobsParamsState string

type ListSourcesOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string           `json:"$schema,omitempty"`
	Data   *[]SourceResponse `json:"data"`
}

type ListSourcesParams struct {
	// NamespaceId Limit to sources in this namespace
	NamespaceId *string `form:"namespace_id,omitempty" json:"namespace_id,omitempty"`
}

type ListTopVulnerabilitiesOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema     *string         `json:"$schema,omitempty"`
	Data       *[]TopVulnEntry `json:"data"`
	Pagination PaginationMeta  `json:"pagination"`
}

type ListTopVulnerabilitiesParams struct {
	// Limit Maximum number of results per page
	Limit *int32 `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of results to skip
	Offset *int32 `form:"offset,omitempty" json:"offset,omitempty"`

	// Q Filter by vulnerability id (CVE/GHSA/OSV), substring match against the canonical id and its aliases
	Q *string `form:"q,omitempty" json:"q,omitempty"`

	// Severity Filter by severity
	Severity *ListTopVulnerabilitiesParamsSeverity `form:"severity,omitempty" json:"severity,omitempty"`

	// Sort Sort field
	Sort *ListTopVulnerabilitiesParamsSort `form:"sort,omitempty" json:"sort,omitempty"`

	// SortDir Sort direction (asc or desc)
	SortDir *ListTopVulnerabilitiesParamsSortDir `form:"sort_dir,omitempty" json:"sort_dir,omitempty"`
}

type ListTopVulnerabilitiesParamsSeverity string

type ListTopVulnerabilitiesParamsSort string

type ListTopVulnerabilitiesParamsSortDir string

type ListUsersOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string         `json:"$schema,omitempty"`
	Users  *[]UserResponse `json:"users"`
}

type ListVulnWorkloadsOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string                    `json:"$schema,omitempty"`
	Data   *[]RunningWorkloadResponse `json:"data"`
}

type ListVulnerabilityWorkloadsParams struct {
	// ClusterId Limit to one cluster. Omitted, the answer spans every cluster the caller can see.
	ClusterId *string `form:"cluster_id,omitempty" json:"cluster_id,omitempty"`
	Limit     *int32  `form:"limit,omitempty" json:"limit,omitempty"`
}

type LookupArtifactParams struct {
	// Name Exact artifact name, e.g. ghcr.io/pfenerty/ocidex
	Name string `form:"name" json:"name"`

	// Type Optional artifact type qualifier; omit or leave empty to match any type
	Type *string `form:"type,omitempty" json:"type,omitempty"`

	// Group Optional artifact group qualifier; omit or leave empty to match any group
	Group *string `form:"group,omitempty" json:"group,omitempty"`
}

type LookupCandidate struct {
	// Id Canonical UUID of the matching resource
	Id string `json:"id"`

	// Qualifiers Qualifier values that distinguish this candidate, keyed by resolver query parameter
	Qualifiers map[string]string `json:"qualifiers"`
}

type LookupConflictError struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string `json:"$schema,omitempty"`

	// Candidates Matching resources; retry one rung further down the qualifier ladder to select one
	Candidates *[]LookupCandidate `json:"candidates"`

	// Detail Explanation of the ambiguity
	Detail string `json:"detail"`

	// Status HTTP status code
	Status int64 `json:"status"`

	// Title Short, human-readable summary
	Title string `json:"title"`
}

type LookupLicenseParams struct {
	// SpdxId SPDX license identifier, e.g. Apache-2.0
	SpdxId string `form:"spdxId" json:"spdxId"`
}

type LookupSbomParams struct {
	// Artifact Exact artifact name, e.g. ghcr.io/pfenerty/ocidex; required unless digest is given
	Artifact *string `form:"artifact,omitempty" json:"artifact,omitempty"`

	// Version Artifact version, e.g. 1.2.3; required unless digest is given
	Version *string `form:"version,omitempty" json:"version,omitempty"`

	// Arch Optional architecture qualifier; omit or leave empty to match any architecture
	Arch *string `form:"arch,omitempty" json:"arch,omitempty"`

	// Flavor Optional image flavor qualifier (ADR-020); omit or leave empty to match any flavor
	Flavor *string `form:"flavor,omitempty" json:"flavor,omitempty"`

	// Digest SBOM digest. Unique by construction, so this form never returns 409; supply it instead of artifact and version
	Digest *string `form:"digest,omitempty" json:"digest,omitempty"`

	// Include Set to 'raw' to include the raw BOM JSON
	Include *string `form:"include,omitempty" json:"include,omitempty"`
}

type MeOutputBody struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string `json:"$schema,omitempty"`

	// DisplayName Name to show for this user; supplied by whichever issuer last signed them in
	DisplayName string `json:"display_name"`

	// Id User UUID
	Id string `json:"id"`

	// Memberships The caller's namespace memberships, for UI emphasis only
	Memberships *[]MyMembership `json:"memberships"`

	// Role User role: admin, member, or viewer
	Role string `json:"role"`
}

type MyMembership struct {
	// NamespaceId Namespace UUID
	NamespaceId string `json:"namespace_id"`

	// Role The caller's role in that namespace
	Role MyMembershipRole `json:"role"`
}

type MyMembershipRole string

type NATSStatus struct {
	Enabled bool   `json:"enabled"`
	Url     string `json:"url"`
}

type NamespaceFacetResponse struct {
	K8sNamespace string `json:"k8s_namespace"`

	// WorkloadCount Containers reported in this namespace
	WorkloadCount int64 `json:"workload_count"`
}

type NamespaceMemberResponse struct {
	// Schema A URL to the JSON Schema for this object.
	Schema *string `json:"$schema,omitempty"`

	// Capabilities Capabilities the role grants, for display
	Capabilities *[]string `json:"capabilities"`
	CreatedAt    string    `json:"created_at"`

	// Role The member's role in this namespace
	Role NamespaceMemberResponseRole `json:"role"`

	// UserId UUID of the member
	UserId string `json:"user_id"`

	// Username GitHub username of the member
	Username string `json:"username"`
}

type NamespaceMemberResponseRole string

type NamespaceResponse struct {
	// Schema A URL to the JSON Schema for this object.
	Schema    *string `json:"$schema,omitempty"`
	CreatedAt string  `json:"created_at"`
	Id        string  `json:"id"`
	Name      string  `json:"name"`

	// OwnerId UUID of the namespace owner
	OwnerId *string `json:"owner_id,omitempty"`

	// OwnerUsername GitHub username of the namespace owner
	OwnerUsername *string `json:"owner_username,omitempty"`
	UpdatedAt     string  `json:"updated_at"`

	// Visibility Namespace visibility: public or private
	Visibility NamespaceResponseVisibility `json:"visibility"`
}

type NamespaceResponseVisibility string