kubernetes

type AgentDetected struct {
	MetricsServer bool          `json:"metrics_server"`
	Traces        *TraceBackend `json:"traces"`
	Workloads     int           `json:"workloads"`
	Namespaces    int           `json:"namespaces"`
}

type AgentSettings struct {
	breaklogs.Settings
	Sources             []breaklogs.Source `json:"sources"`
	Detected            AgentDetected      `json:"detected"`
	LinkedSourceMissing bool               `json:"linked_source_missing"`
	CanWrite            bool               `json:"can_write"`
}

type AuthOptions struct {
	Mode, Endpoint, CAFile, CAData, ServerName, Token, TokenFile              string
	CertificateFile, KeyFile, CertificateData, KeyData                        string
	KubeconfigPath, KubeconfigContext                                         string
	EKSClusterName, EKSRegion, EKSRoleARN, EKSProfile                         string
	AKSCredentialMode, AKSServerID, AKSTenantID, AKSClientID, AKSClientSecret string
	AKSFederatedTokenFile, AKSEnvironment, GKECredentialsFile                 string
}

type BreakLogContainer struct {
	Name string `json:"name"`
	Init bool   `json:"init,omitempty"`
	Main bool   `json:"main,omitempty"`
}

type BreakLogCounts struct {
	Errors   int `json:"errors"`
	Warnings int `json:"warnings"`
	All      int `json:"all"`
}

type BreakLogLine struct {
	Pod       string    `json:"pod,omitempty"`
	At        time.Time `json:"at"`
	PodUID    string    `json:"pod_uid"`
	Container string    `json:"container"`
	Init      bool      `json:"init"`
	Slot      string    `json:"slot"`
	Level     string    `json:"level"`
	Text      string    `json:"text"`
	Source    string    `json:"source"`
}

type BreakLogMarker struct {
	Type  string    `json:"type"`
	At    time.Time `json:"at"`
	Label string    `json:"label"`
}

type BreakLogPage struct {
	Window   BreakLogWindow     `json:"window"`
	Pods     []BreakLogPod      `json:"pods"`
	Lines    []BreakLogLine     `json:"lines"`
	Markers  []BreakLogMarker   `json:"markers"`
	Counts   BreakLogCounts     `json:"counts"`
	Rate     []BreakLogRate     `json:"rate"`
	Patterns []BreakLogPattern  `json:"patterns"`
	Sources  []BreakLogSource   `json:"sources"`
	Coverage breaklogs.Coverage `json:"coverage"`
	Next     string             `json:"next,omitempty"`
	// Container is the applied filter: a container name, or "*" for all.
	Container     string              `json:"container"`
	MainContainer string              `json:"main_container,omitempty"`
	Containers    []BreakLogContainer `json:"containers"`
	PatternInput  []BreakLogLine      `json:"-"`
}

type BreakLogPattern struct {
	Template string `json:"template"`
	Level    string `json:"level"`
	Count    int    `json:"count"`
}

type BreakLogPod struct {
	Name  string `json:"name"`
	UID   string `json:"uid"`
	State string `json:"state"`
	Short string `json:"short"`
}

type BreakLogRate struct {
	Minute time.Time `json:"minute"`
	Total  int       `json:"total"`
	Errors int       `json:"errors"`
}

type BreakLogSource struct {
	Kind string    `json:"kind"`
	Name string    `json:"name"`
	Type string    `json:"type,omitempty"`
	At   time.Time `json:"at"`
}

type BreakLogWindow struct {
	From time.Time `json:"from"`
	To   time.Time `json:"to"`
}

type BrokenTotals struct {
	Total      int            `json:"total"`
	BySeverity map[string]int `json:"by_severity"`
}

type CaptureStatus struct {
	Mode         string                       `json:"mode"`
	Reason       string                       `json:"reason,omitempty"`
	LastCycleAt  *time.Time                   `json:"last_cycle_at,omitempty"`
	Behind       bool                         `json:"behind"`
	Verification *projectedVerificationStatus `json:"verification,omitempty"`
}

type Change = kubechanges.Change

type ChangeFieldChange = kubechanges.FieldChange

type ChangePage struct {
	Items     []Change          `json:"items"`
	Next      string            `json:"next,omitempty"`
	Truncated bool              `json:"truncated"`
	Partial   []PartialFailure  `json:"partial_failures,omitempty"`
	Gaps      []kubechanges.Gap `json:"gaps"`
	Sync      SyncStatus        `json:"sync"`
}

type ChangeQuery = kubechanges.Query

type ChangeType = kubechanges.Type

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

type ClusterEntry struct {
	Info    ClusterInfo
	Service *Service
	Err     error
}

type ClusterInfo struct {
	ID          string `json:"id"`
	DisplayName string `json:"display_name,omitempty"`
	Provider    string `json:"provider"`
}

type ClusterSummary struct {
	ClusterInfo
	Version      string       `json:"version,omitempty"`
	Health       string       `json:"health"`
	Nodes        int          `json:"nodes"`
	ReadyNodes   int          `json:"ready_nodes"`
	Pods         int          `json:"pods"`
	RunningPods  int          `json:"running_pods"`
	Warnings     int          `json:"warnings"`
	Issues       *int         `json:"issues,omitempty"`
	Broken       *int         `json:"broken,omitempty"`
	LastChangeAt *time.Time   `json:"last_change_at,omitempty"`
	Sync         SyncStatus   `json:"sync"`
	ObservedAt   time.Time    `json:"observed_at"`
	Error        *ErrorDetail `json:"error,omitempty"`
}

type Condition struct {
	Type         string    `json:"type"`
	Status       string    `json:"status"`
	Reason       string    `json:"reason,omitempty"`
	TransitionAt time.Time `json:"last_transition_at,omitempty,omitzero"`
}

type Config struct {
	Namespace            string
	Endpoint             string
	TokenFile            string
	CAFile               string
	CAData               []byte
	ServerName           string
	Credentials          CredentialSource
	Timeout              time.Duration
	MaxBodyBytes         int64
	AllowLoopbackHTTP    bool
	AllowLoopback        bool
	AllowPrivateNetworks bool
	EndpointCIDRs        []string
}

type CrashPage struct {
	kubechanges.CrashPage
	Capture CaptureStatus `json:"capture"`
	Sync    SyncStatus    `json:"sync"`
}

type CredentialSource interface {
	Authorization(context.Context) (string, error)
	ClientCertificate(*tls.CertificateRequestInfo) (*tls.Certificate, error)
}

type DiagnoseOptions struct {
	ResourceID   string
	Kind         string
	Namespace    string
	Name         string
	LogTail      int
	ChangeWindow time.Duration
}

type Diagnosis struct {
	Workload      WorkloadDetail      `json:"workload"`
	WarningEvents []ProjectedResource `json:"warning_events,omitempty"`
	WorstPodLogs  *PodLogs            `json:"worst_pod_logs,omitempty"`
	Changes       []Change            `json:"changes"`
	Neighborhood  kubegraph.Graph     `json:"neighborhood"`
	Partial       []PartialFailure    `json:"partial_failures,omitempty"`
	Omitted       []string            `json:"omitted_categories,omitempty"`
	Truncated     bool                `json:"truncated"`
	Sync          SyncStatus          `json:"sync"`
	Break         *Issue              `json:"break,omitempty"`
}

type Discovery struct {
	ObservedAt time.Time            `json:"observed_at"`
	Resources  []ResourceDefinition `json:"resources"`
	Partial    []PartialFailure     `json:"partial_failures,omitempty"`
	// contains filtered or unexported fields
}

type ErrThrottled struct{ RetryAfter time.Duration }

type ErrorDetail struct {
	Code      string `json:"code"`
	Message   string `json:"message"`
	Action    string `json:"action"`
	Retryable bool   `json:"retryable"`
}

type EventOptions struct {
	Namespace string
	Type      string
	Kind      string
	Name      string
	UID       string
	Continue  string
	Cursor    string
	Limit     int
}

type EventPage struct {
	Items            []ProjectedResource `json:"items"`
	Next             string              `json:"next,omitempty"`
	Truncated        bool                `json:"truncated"`
	Partial          []PartialFailure    `json:"partial_failures,omitempty"`
	EncodedTruncated bool                `json:"-"`
	Omitted          []string            `json:"-"`
}

type GitOpsApp struct {
	Tool       string    `json:"tool"`
	Kind       string    `json:"kind"`
	Namespace  string    `json:"namespace"`
	Name       string    `json:"name"`
	Sync       string    `json:"sync"`
	Health     string    `json:"health"`
	Revision   string    `json:"revision,omitempty"`
	LastSyncAt time.Time `json:"last_sync_at,omitempty"`
	Message    string    `json:"message,omitempty"`
	Source     string    `json:"source,omitempty"`
	Suspended  bool      `json:"suspended"`
}

type GitOpsAppOptions struct {
	Namespace string
	Tool      string
	Status    string
	Limit     int
	Cursor    string
}

type GitOpsAppPage struct {
	Items     []GitOpsApp      `json:"items"`
	Available bool             `json:"available"`
	Reason    string           `json:"reason,omitempty"`
	Next      string           `json:"next,omitempty"`
	Partial   []PartialFailure `json:"partial_failures,omitempty"`
	Truncated bool             `json:"truncated"`
}

type GraphQuery struct {
	Namespace     string
	GroupBy       string
	MaxNodes      int
	ConnectedOnly bool
	Complete      bool
	Limit         int
	Cursor        string
	// contains filtered or unexported fields
}

type HelmRelease struct {
	Namespace string         `json:"namespace"`
	Name      string         `json:"name"`
	Current   HelmRevision   `json:"current"`
	History   []HelmRevision `json:"history"`
	Health    string         `json:"health"`
}

type HelmReleaseOptions struct {
	Namespace string
	Status    string
	Limit     int
	Cursor    string
}

type HelmReleasePage struct {
	Items     []HelmRelease    `json:"items"`
	Next      string           `json:"next,omitempty"`
	Truncated bool             `json:"truncated"`
	Partial   []PartialFailure `json:"partial_failures,omitempty"`
}

type HelmRevision struct {
	Revision int       `json:"revision"`
	Status   string    `json:"status"`
	Created  time.Time `json:"created,omitempty"`
}

type Issue struct {
	Root          ObjectRef                 `json:"root"`
	Rule          string                    `json:"rule"`
	Severity      string                    `json:"severity"`
	Count         int                       `json:"count"`
	Examples      []ObjectRef               `json:"examples,omitempty"`
	FirstSeen     time.Time                 `json:"first_seen,omitempty"`
	LastSeen      time.Time                 `json:"last_seen,omitempty"`
	Broken        bool                      `json:"broken,omitempty"`
	Of            int                       `json:"of,omitempty"`
	BrokeAt       *time.Time                `json:"broke_at,omitempty"`
	BrokeAtSource string                    `json:"broke_at_source,omitempty"`
	Evidence      *kubebreaks.Evidence      `json:"evidence,omitempty"`
	Changes       []kubebreaks.LinkedChange `json:"changes,omitempty"`
	MoreChanges   int                       `json:"more_changes,omitempty"`
	History       string                    `json:"history,omitempty"`
	Gaps          []kubechanges.Gap         `json:"gaps,omitempty"`
	Rebuilt       []string                  `json:"rebuilt,omitempty"`
	Untracked     []string                  `json:"untracked,omitempty"`
	Partial       bool                      `json:"partial,omitempty"`
	// Pending lists resource IDs whose evidence is still loading; History
	// and Changes may fill in once they are listed.
	Pending []string `json:"pending,omitempty"`
}

type IssueAlert struct {
	OrgID                                                           string
	Cluster, Namespace, WorkloadKind, Workload, RootUID, ResourceID string
	Rule, RuleLabel, Severity                                       string
	Count, Of                                                       int
	BrokeAt                                                         time.Time
	Evidence, Changes                                               []string
	HistoryIncomplete                                               bool
	RollupCount                                                     int
}

type IssueAlertSettings struct {
	Enabled         bool      `json:"enabled"`
	Level           string    `json:"level"`
	EnabledAt       time.Time `json:"enabled_at"`
	CanWrite        bool      `json:"can_write"`
	Available       bool      `json:"available"`
	Reason          string    `json:"reason"`
	LinksReady      bool      `json:"links_ready"`
	ChannelsEnabled bool      `json:"channels_enabled"`
}

type IssueOptions struct {
	Namespace      string
	Severity       string
	Kind           string
	Limit          int
	Cursor         string
	Broken         bool
	IncludeChanges bool
	RootUID        string
	// contains filtered or unexported fields
}

type IssuePage struct {
	Items     []Issue          `json:"items"`
	Totals    map[string]int   `json:"totals"`
	Truncated bool             `json:"truncated"`
	Next      string           `json:"next,omitempty"`
	Partial   []PartialFailure `json:"partial_failures,omitempty"`
	Sync      SyncStatus       `json:"sync"`
	Broken    BrokenTotals     `json:"broken"`
}

type ListOptions struct {
	ResourceID string
	Namespace  string
	Labels     string
	Fields     string
	Continue   string
	Limit      int
}

type MetricsSourceStatus struct {
	Availability string     `json:"availability"`
	Fresh        bool       `json:"fresh"`
	Complete     bool       `json:"complete"`
	Total        int        `json:"total"`
	CPU          string     `json:"cpu,omitempty"`
	Memory       string     `json:"memory,omitempty"`
	ObservedAt   *time.Time `json:"observed_at,omitempty"`
}

type NamespacePage struct {
	Items   []string         `json:"items"`
	Sync    SyncStatus       `json:"sync"`
	Partial []PartialFailure `json:"partial_failures,omitempty"`
}

type NeighborhoodQuery struct {
	ResourceID string
	Kind       string
	Namespace  string
	Name       string
	Hops       int
	MaxNodes   int
}

type ObjectRef struct {
	APIVersion string `json:"api_version,omitempty"`
	Kind       string `json:"kind"`
	Namespace  string `json:"namespace,omitempty"`
	Name       string `json:"name"`
	UID        string `json:"uid,omitempty"`
	// contains filtered or unexported fields
}

type Outcome struct {
	IncidentID          string
	NotificationOutcome string
}

type Overview struct {
	Connector         string           `json:"connector"`
	ClusterID         string           `json:"cluster_id"`
	ObservedAt        time.Time        `json:"observed_at"`
	Nodes             int              `json:"nodes"`
	ReadyNodes        int              `json:"ready_nodes"`
	Pods              int              `json:"pods"`
	RunningPods       int              `json:"running_pods"`
	Namespaces        int              `json:"namespaces"`
	ActiveNamespaces  int              `json:"active_namespaces"`
	Workloads         int              `json:"workloads"`
	Warnings          int              `json:"warnings"`
	RequestedCPU      string           `json:"requested_cpu,omitempty"`
	LimitedCPU        string           `json:"limited_cpu,omitempty"`
	AllocatableCPU    string           `json:"allocatable_cpu,omitempty"`
	RequestedMemory   string           `json:"requested_memory,omitempty"`
	LimitedMemory     string           `json:"limited_memory,omitempty"`
	AllocatableMemory string           `json:"allocatable_memory,omitempty"`
	UsageCPU          string           `json:"usage_cpu,omitempty"`
	UsageMemory       string           `json:"usage_memory,omitempty"`
	UsageSource       string           `json:"usage_source"`
	MetricsStatus     string           `json:"metrics_status"`
	MetricsObservedAt *time.Time       `json:"metrics_observed_at,omitempty"`
	MetricsFresh      bool             `json:"metrics_fresh"`
	Truncated         bool             `json:"truncated"`
	Omitted           []string         `json:"omitted_categories,omitempty"`
	Partial           []PartialFailure `json:"partial_failures,omitempty"`
	Sync              SyncStatus       `json:"sync"`
}

type PartialFailure struct {
	ResourceID   string `json:"resource_id,omitempty"`
	Scope        string `json:"scope,omitempty"`
	GroupVersion string `json:"group_version,omitempty"`
	Class        string `json:"class"`
}

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

type PodLogStreamEvent struct {
	Event           string `json:"-"`
	Text            string `json:"text"`
	Container       string `json:"container"`
	Timestamp       string `json:"timestamp,omitempty"`
	Sequence        uint64 `json:"sequence,omitempty"`
	Ordinal         uint64 `json:"ordinal,omitempty"`
	Cursor          string `json:"cursor,omitempty"`
	Reason          string `json:"reason,omitempty"`
	Code            string `json:"code,omitempty"`
	Message         string `json:"message,omitempty"`
	Action          string `json:"action,omitempty"`
	Retryable       bool   `json:"retryable,omitempty"`
	ReplayUncertain bool   `json:"replay_uncertain,omitempty"`
	// CursorLagging marks a terminal limit event whose cursor never caught up
	// with the newest line this stream sent: rotating from that cursor alone
	// replays the same bytes and stops at the same limit. NewestTimestamp is the
	// newest emitted line's timestamp, bounded and free of line text, so a viewer
	// resumes from the line instead of guessing. Both are absent when the cursor
	// is current.
	CursorLagging   bool   `json:"cursor_lagging,omitempty"`
	NewestTimestamp string `json:"newest_timestamp,omitempty"`
}

type PodLogStreamOptions struct {
	Namespace    string
	Pod          string
	Container    string
	SinceSeconds int
	TailLines    int
	// SinceTime resumes from a timestamp instead of a cursor, the way kubectl
	// logs -f does. It is the resume a client keeps when the line-level cursor
	// would not fit in the request budget.
	SinceTime  time.Time
	Timestamps bool
	Previous   bool
	Cursor     string
	// contains filtered or unexported fields
}

type PodLogs struct {
	ClusterID    string `json:"cluster_id"`
	Namespace    string `json:"namespace"`
	Pod          string `json:"pod"`
	Container    string `json:"container"`
	Previous     bool   `json:"previous"`
	SinceSeconds int    `json:"since_seconds"`
	TailLines    int    `json:"tail_lines"`
	Text         string `json:"text"`
	Truncated    bool   `json:"truncated"`
}

type ProjectedResource struct {
	ResourceID          string            `json:"resource_id"`
	APIVersion          string            `json:"api_version"`
	Kind                string            `json:"kind"`
	Namespace           string            `json:"namespace,omitempty"`
	Name                string            `json:"name"`
	UID                 string            `json:"uid,omitempty"`
	CreatedAt           time.Time         `json:"created_at,omitempty,omitzero"`
	Labels              map[string]string `json:"labels,omitempty"`
	Owners              []ObjectRef       `json:"owners,omitempty"`
	Summary             map[string]any    `json:"summary,omitempty"`
	Conditions          []Condition       `json:"conditions,omitempty"`
	ProjectionTruncated []string          `json:"projection_truncated,omitempty"`
	// contains filtered or unexported fields
}

type ResourceDefinition struct {
	ID         string   `json:"resource_id"`
	Group      string   `json:"group,omitempty"`
	Version    string   `json:"version"`
	Resource   string   `json:"resource"`
	Kind       string   `json:"kind"`
	Namespaced bool     `json:"namespaced"`
	Aliases    []string `json:"aliases,omitempty"`
	Verbs      []string `json:"verbs,omitempty"`
	Available  bool     `json:"available"`
	Reason     string   `json:"reason,omitempty"`
}

type ResourceDescription struct {
	Resource    ProjectedResource   `json:"resource"`
	Related     []ObjectRef         `json:"related_resources,omitempty"`
	Events      []ProjectedResource `json:"events,omitempty"`
	Usage       *ResourceUsage      `json:"usage,omitempty"`
	UsageStatus string              `json:"usage_status"`
	Truncated   bool                `json:"truncated"`
	Omitted     []string            `json:"omitted_categories,omitempty"`
	Partial     []PartialFailure    `json:"partial_failures,omitempty"`
}

type ResourcePage struct {
	Sync             SyncStatus          `json:"sync"`
	Items            []ProjectedResource `json:"items"`
	Continue         string              `json:"continue,omitempty"`
	Truncated        bool                `json:"truncated"`
	EncodedTruncated bool                `json:"encoded_truncated"`
	Omitted          []string            `json:"omitted_categories,omitempty"`
	Partial          []PartialFailure    `json:"partial_failures,omitempty"`
}

type ResourceUsage struct {
	Kind      string    `json:"kind"`
	Namespace string    `json:"namespace,omitempty"`
	Name      string    `json:"name"`
	Timestamp time.Time `json:"timestamp,omitempty"`
	Window    string    `json:"window,omitempty"`
	CPU       string    `json:"cpu,omitempty"`
	Memory    string    `json:"memory,omitempty"`
}

type Rollout struct {
	Namespace  string `json:"namespace"`
	Name       string `json:"name"`
	Phase      string `json:"phase"`
	Strategy   string `json:"strategy,omitempty"`
	Step       int    `json:"step"`
	TotalSteps int    `json:"total_steps"`
	StableRS   string `json:"stable_rs,omitempty"`
	CanaryRS   string `json:"canary_rs,omitempty"`
	Weight     int    `json:"weight,omitempty"`
	Message    string `json:"message,omitempty"`
}

type RolloutListOptions struct {
	Namespace string
	Limit     int
	Cursor    string
}

type RolloutPage struct {
	Items     []Rollout        `json:"items"`
	Available bool             `json:"available"`
	Reason    string           `json:"reason,omitempty"`
	Next      string           `json:"next,omitempty"`
	Truncated bool             `json:"truncated"`
	Partial   []PartialFailure `json:"partial_failures,omitempty"`
}

type Scope struct {
	OrgID        string `json:"org_id,omitempty"`
	ClusterID    string `json:"cluster_id"`
	CredentialID string `json:"-"`
}

type Scrubber interface{ Scrub(string) string }

type SearchOptions struct {
	Query        string
	Namespace    string
	Category     string
	Labels       string
	Fields       string
	PerKindLimit int
	TotalLimit   int
}

type SearchResult struct {
	Items         []ProjectedResource `json:"items"`
	Continuations map[string]string   `json:"continuations,omitempty"`
	Requests      int                 `json:"requests"`
	RequestBudget int                 `json:"request_budget"`
	Truncated     bool                `json:"truncated"`
	Omitted       []string            `json:"omitted_categories,omitempty"`
	Partial       []PartialFailure    `json:"partial_failures,omitempty"`
}

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

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

type SyncHealth struct {
	Progress *SyncProgress `json:"progress,omitempty"`
	State    string        `json:"state"`
	Partial  bool          `json:"partial"`
	// FirstReadyAt is when this cluster first recorded a ready generation. It is
	// recorded once, kept with the cluster's inventory metadata, and carried
	// forward from then on, so a credential fault, a restart, a re-index, or any
	// later syncing, partial, stale, or error report still says the cluster has
	// been ready before. It is a property of the cluster, not of the process, and
	// the moment it keeps is always the first one. A cluster that has never been
	// ready omits it.
	FirstReadyAt time.Time `json:"first_ready_at,omitzero"`
	// Class names why the whole read failed, drawn from the same closed
	// vocabulary a kind's own failure class uses, so a surface gets one word it
	// already knows. It is set only on an error report and stays empty otherwise.
	Class string `json:"class,omitempty"`
	// AgeSeconds is how old the snapshot this report describes is, in seconds:
	// the oldest observation it stands behind. It is absent when no snapshot has
	// ever been published, because zero seconds would claim the empty screen is
	// current data.
	AgeSeconds *float64 `json:"age_s,omitempty"`
	// Kinds carries one entry per known kind. A kind the cluster does not serve is
	// present with Absent set, so it is never confused with a missing kind.
	Kinds map[string]kubeindex.KindStatus `json:"kinds"`
	// Failing lists the kinds whose latest listing did not finish cleanly, ready
	// for a surface to render: name, class, counts, and since when. It carries the
	// blocking faults only.
	Failing []SyncKindProblem `json:"failing"`
	// Unreadable lists the kinds this connector identity is not allowed to read.
	// A capability gap is not a sync fault: these kinds are excluded from Failing
	// and from the aggregate state, so a least-privilege install still reaches
	// ready and can show everything it is allowed to see.
	Unreadable []SyncKindProblem `json:"unreadable"`
	// TotalKinds counts every kind before the payload bound is applied.
	TotalKinds      int  `json:"total_kinds"`
	ReadyKinds      int  `json:"ready_kinds"`
	FailingKinds    int  `json:"failing_kinds"`
	UnreadableKinds int  `json:"unreadable_kinds"`
	PendingKinds    int  `json:"pending_kinds"`
	Truncated       bool `json:"truncated"`
	// OmittedKinds names the kinds the bound dropped, bounded itself.
	OmittedKinds []string `json:"omitted_kinds,omitempty"`
}

type SyncKindProblem struct {
	Kind    string `json:"kind"`
	State   string `json:"state"`
	Class   string `json:"class,omitempty"`
	Skipped int    `json:"skipped,omitempty"`
	Records int    `json:"records"`
	// Since is when this failure began, kept until the kind recovers. A zero time
	// is omitted rather than rendered as a date.
	Since time.Time `json:"since,omitzero"`
	// ObservedAt is the last successful listing start, omitted when there is none.
	ObservedAt time.Time `json:"observed_at,omitzero"`
}

type SyncProgress = kubeindex.SyncProgress

type SyncStatus struct {
	State      string  `json:"state"`
	AgeSeconds float64 `json:"age_s"`
	Partial    bool    `json:"partial"`
	// Progress is present only during a cluster's first sync.
	Progress *SyncProgress `json:"progress,omitempty"`
	// Pending lists resource IDs this view needs that are still loading after
	// the core generation; PendingKinds counts all resource types still loading.
	Pending      []string `json:"pending,omitempty"`
	PendingKinds int      `json:"pending_kinds,omitempty"`
}

type TestLinkRequest struct {
	Source string           `json:"source"`
	Fields breaklogs.Fields `json:"fields"`
}

type TestLinkResult struct {
	Lines      int    `json:"lines"`
	Namespace  string `json:"namespace"`
	Workload   string `json:"workload"`
	DurationMS int64  `json:"duration_ms"`
	Preview    string `json:"preview"`
	Truncated  bool   `json:"truncated"`
}

type TimelineItem struct {
	Type   string                  `json:"type"`
	ID     string                  `json:"id"`
	At     time.Time               `json:"at"`
	Change *Change                 `json:"change,omitempty"`
	Crash  *kubechanges.CrashEvent `json:"crash,omitempty"`
	Issue  *Issue                  `json:"issue,omitempty"`
}

type TimelinePage struct {
	Items      []TimelineItem    `json:"items"`
	Next       string            `json:"next,omitempty"`
	Sync       SyncStatus        `json:"sync"`
	Partial    []PartialFailure  `json:"partial_failures,omitempty"`
	Gaps       []kubechanges.Gap `json:"gaps"`
	CrashCount int               `json:"crash_count"`
	Total      int               `json:"total"`
	Counts     map[string]int    `json:"counts"`
	Since      time.Time         `json:"since"`
	Until      time.Time         `json:"until"`
	BreaksOnly bool              `json:"breaks_only,omitempty"`
}

type TimelineQuery struct {
	Since, Until                                  time.Time
	Namespace, Kind, RootUID, PodUID, ResourceUID string
	Limit                                         int
	Cursor                                        string
	// BreaksOnly keeps only break items, so paging, totals and counts cover
	// breaks alone. Cursors are bound to it.
	BreaksOnly bool
}

type TopItem struct {
	ResourceUsage
	RequestCPU    string     `json:"request_cpu,omitempty"`
	RequestMemory string     `json:"request_memory,omitempty"`
	Owner         *ObjectRef `json:"owner,omitempty"`
}

type TopOptions struct {
	Kind      string
	Namespace string
	Sort      string
	Limit     int
}

type TopPage struct {
	Items        []TopItem        `json:"items"`
	Total        int              `json:"total"`
	Truncated    bool             `json:"truncated"`
	Availability string           `json:"availability"`
	Fresh        bool             `json:"fresh"`
	Partial      []PartialFailure `json:"partial_failures,omitempty"`
	Sync         SyncStatus       `json:"sync"`
}

type TraceBackend struct {
	Kind      string `json:"kind"`
	Namespace string `json:"namespace"`
}

type Traffic struct {
	Available  bool          `json:"available"`
	Reason     string        `json:"reason,omitempty"`
	Source     string        `json:"source,omitempty"`
	Window     string        `json:"window"`
	ObservedAt time.Time     `json:"observed_at,omitempty"`
	Edges      []TrafficEdge `json:"edges,omitempty"`
	Unmapped   int           `json:"unmapped"`
	External   []string      `json:"external,omitempty"`
	Truncated  bool          `json:"truncated"`
}

type TrafficContributor interface {
	ReadTraffic(context.Context, TrafficQuery) (Traffic, error)
}

type TrafficEdge struct {
	From        TrafficWorkload `json:"from"`
	To          TrafficWorkload `json:"to"`
	RatePerSec  *float64        `json:"rate_per_sec"`
	ErrorRate   *float64        `json:"error_rate"`
	P95Ms       *float64        `json:"p95_ms"`
	BytesPerSec *float64        `json:"bytes_per_sec"`
}

type TrafficQuery struct {
	Namespace string
	Source    string
	Window    string
}

type TrafficWorkload struct {
	Namespace string `json:"namespace"`
	Kind      string `json:"kind"`
	Name      string `json:"name"`
}

type Usage struct {
	Next         string              `json:"next,omitempty"`
	ObservedAt   time.Time           `json:"observed_at"`
	Availability string              `json:"availability"`
	Fresh        bool                `json:"fresh"`
	PodMetrics   MetricsSourceStatus `json:"pod_metrics"`
	NodeMetrics  MetricsSourceStatus `json:"node_metrics"`
	Pods         []ResourceUsage     `json:"pods,omitempty"`
	Nodes        []ResourceUsage     `json:"nodes,omitempty"`
	Truncated    bool                `json:"truncated"`
	Omitted      []string            `json:"omitted_categories,omitempty"`
	Partial      []PartialFailure    `json:"partial_failures,omitempty"`
}

type UsageHistory struct {
	ObservedAt       time.Time     `json:"observed_at"`
	Source           string        `json:"source"`
	Availability     string        `json:"availability"`
	LiveSince        time.Time     `json:"live_since"`
	Samples          []UsageSample `json:"samples"`
	RetentionSeconds int           `json:"retention_seconds"`
}

type UsageSample struct {
	Timestamp   time.Time `json:"timestamp"`
	CPUMilli    float64   `json:"cpu_milli"`
	MemoryBytes float64   `json:"memory_bytes"`
}

type WorkloadContainer struct {
	Name     string            `json:"name"`
	Image    string            `json:"image,omitempty"`
	Probes   []string          `json:"probes,omitempty"`
	Requests map[string]string `json:"requests,omitempty"`
	Limits   map[string]string `json:"limits,omitempty"`
}

type WorkloadDetail struct {
	UID                string              `json:"uid,omitempty"`
	ResourceID         string              `json:"resource_id"`
	Kind               string              `json:"kind"`
	Namespace          string              `json:"namespace,omitempty"`
	Name               string              `json:"name"`
	Desired            *int64              `json:"desired,omitempty"`
	Current            *int64              `json:"current,omitempty"`
	Ready              *int64              `json:"ready,omitempty"`
	Available          *int64              `json:"available,omitempty"`
	Unavailable        *int64              `json:"unavailable,omitempty"`
	Succeeded          *int64              `json:"succeeded,omitempty"`
	Failed             *int64              `json:"failed,omitempty"`
	Active             *int64              `json:"active,omitempty"`
	Generation         *int64              `json:"generation,omitempty"`
	ObservedGeneration *int64              `json:"observed_generation,omitempty"`
	UpdateStrategy     string              `json:"update_strategy,omitempty"`
	Conditions         []Condition         `json:"conditions,omitempty"`
	Containers         []WorkloadContainer `json:"containers,omitempty"`
	Pods               []WorkloadPod       `json:"pods,omitempty"`
	Nodes              []string            `json:"nodes,omitempty"`
	NodeSelector       map[string]string   `json:"node_selector,omitempty"`
	Affinity           []string            `json:"affinity,omitempty"`
	TopologySpread     []string            `json:"topology_spread,omitempty"`
	TerminationGrace   *int64              `json:"termination_grace_seconds,omitempty"`
	HPAs               []ObjectRef         `json:"hpas,omitempty"`
	PDBs               []ObjectRef         `json:"pdbs,omitempty"`
	Usage              []ResourceUsage     `json:"usage,omitempty"`
	Truncated          bool                `json:"truncated"`
	Omitted            []string            `json:"omitted_categories,omitempty"`
	Partial            []PartialFailure    `json:"partial_failures,omitempty"`
}

type WorkloadListOptions struct {
	Namespace string
	Kind      string
	Query     string
	Limit     int
	Cursor    string
}

type WorkloadLogLine struct {
	Pod       string    `json:"pod"`
	Container string    `json:"container,omitempty"`
	At        time.Time `json:"at,omitempty"`
	Text      string    `json:"text"`
}

type WorkloadLogOptions struct {
	Namespace    string
	Kind         string
	Name         string
	Pod          string
	Container    string
	Previous     bool
	SinceSeconds int
	TailLines    int
	Grep         string
	MaxPods      int
}

type WorkloadLogPod struct {
	UID             string   `json:"uid"`
	Name            string   `json:"name"`
	Containers      []string `json:"containers"`
	InitContainers  []string `json:"init_containers"`
	MainContainer   string   `json:"main_container,omitempty"`
	Admitted        bool     `json:"admitted"`
	Truncated       bool     `json:"truncated,omitempty"`
	Reason          string   `json:"reason,omitempty"`
	AllPodsAdmitted bool     `json:"all_pods_admitted"`
	AllPodsReason   string   `json:"all_pods_reason,omitempty"`
}

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

type WorkloadLogSource struct {
	SourceID    string `json:"source_id"`
	PodUID      string `json:"pod_uid"`
	Pod         string `json:"pod"`
	Namespace   string `json:"namespace"`
	Container   string `json:"container"`
	Incarnation string `json:"incarnation"`
	Admitted    bool   `json:"admitted"`
	Reason      string `json:"reason,omitempty"`
}

type WorkloadLogStreamEvent struct {
	PodLogStreamEvent
	WorkloadUID string              `json:"workload_uid"`
	PodUID      string              `json:"pod_uid,omitempty"`
	Pod         string              `json:"pod,omitempty"`
	Namespace   string              `json:"namespace,omitempty"`
	Incarnation string              `json:"incarnation,omitempty"`
	SourceID    string              `json:"source_id,omitempty"`
	Sources     []WorkloadLogSource `json:"sources,omitempty"`
	Pods        []WorkloadLogPod    `json:"pods,omitempty"`
	Truncated   bool                `json:"truncated,omitempty"`
}

type WorkloadLogStreamOptions struct {
	Kind, Name, Namespace, UID string
	PodUIDs                    []string
	Container                  string
	SinceSeconds, TailLines    int
	// SinceTime resumes every source from a caller's timestamp, the way
	// kubectl logs -f does. It replaces the resume cursor: a reconnect carries a
	// timestamp, so a request stays small no matter how many sources a workload
	// has.
	SinceTime            time.Time
	Previous, Timestamps bool
}

type WorkloadLogs struct {
	Pods        []string          `json:"pods"`
	Lines       []WorkloadLogLine `json:"lines"`
	Truncated   bool              `json:"truncated"`
	OmittedPods []string          `json:"omitted_pods"`
	Partial     []PartialFailure  `json:"partial_failures,omitempty"`
}

type WorkloadPage struct {
	Sync      SyncStatus          `json:"sync"`
	Items     []ProjectedResource `json:"items"`
	Counts    map[string]int      `json:"counts,omitempty"`
	Next      string              `json:"next,omitempty"`
	Truncated bool                `json:"truncated"`
	Omitted   []string            `json:"omitted_categories,omitempty"`
	Partial   []PartialFailure    `json:"partial_failures,omitempty"`
}

type WorkloadPod struct {
	Name         string    `json:"name"`
	UID          string    `json:"uid,omitempty"`
	StartedAt    time.Time `json:"started_at,omitempty,omitzero"`
	Phase        string    `json:"phase,omitempty"`
	Node         string    `json:"node,omitempty"`
	RestartCount int64     `json:"restart_count"`
	CreatedAt    time.Time `json:"created_at,omitempty,omitzero"`
}