pilot

type AppInfo struct {
	Contributor string `json:"contributor"`
	DisplayName string `json:"displayName"`
	Slug        string `json:"slug,omitempty"`
	Root        bool   `json:"root,omitempty"`
	Icon        string `json:"icon,omitempty"`
	Priority    int    `json:"priority"`
	Home        string `json:"home,omitempty"`
}

type AppsListResponse struct {
	Apps []AppInfo `json:"apps"`
}

type AuditListInput struct {
	Limit       int    `json:"limit,omitempty"`
	Contributor string `json:"contributor,omitempty"`
	Intent      string `json:"intent,omitempty"`
	User        string `json:"user,omitempty"`
	Result      string `json:"result,omitempty"`
}

type AuditListResponse struct {
	Records []AuditRecordDTO `json:"records"`
	Total   int              `json:"total"`
}

type AuditProvider interface {
	List(filter contract.AuditFilter) []contract.AuditRecord
	Subscribe() (<-chan contract.AuditRecord, func())
}

type AuditRecordDTO struct {
	Time          string `json:"time"`
	Contributor   string `json:"contributor"`
	Intent        string `json:"intent"`
	IntentVersion int    `json:"intentVersion,omitempty"`
	Subject       string `json:"subject,omitempty"`
	User          string `json:"user,omitempty"`
	Result        string `json:"result"`
	LatencyMs     int64  `json:"latencyMs"`
	CorrelationID string `json:"correlationID,omitempty"`
}

type CollectorEntry struct {
	Name           string `json:"name"`
	Type           string `json:"type"`
	MetricsCount   int    `json:"metricsCount"`
	Status         string `json:"status"`
	LastCollection string `json:"lastCollection,omitempty"`
}

type Deps struct {
	Extensions    ExtensionsProvider
	Services      ServicesProvider
	Metrics       MetricsProvider
	Overview      OverviewProvider
	Health        HealthProvider
	MetricsReport MetricsReportProvider
	Traces        TracesProvider
	// Audit is the slice (k) audit store. nil yields CodeUnavailable on
	// audit.list / audit.tail; the rest of the pilot stays functional.
	Audit AuditProvider
	// MetricsInterval is how often metrics.summary emits. Zero defaults to
	// DefaultMetricsInterval. Tests use millisecond values.
	MetricsInterval time.Duration
}

type ExtensionInfo struct {
	Name        string `json:"name"`
	DisplayName string `json:"displayName"`
	Version     string `json:"version"`
	Description string `json:"description,omitempty"`
	// PageCount and WidgetCount counted server-rendered dashboard pages and
	// widgets, which no longer exist. Both are always zero. They stay in the
	// payload only so clients that still read them keep working.
	PageCount   int `json:"pageCount"`
	WidgetCount int `json:"widgetCount"`
}

type ExtensionsList struct {
	Extensions []ExtensionInfo `json:"extensions"`
}

type ExtensionsProvider interface {
	ListExtensions() []ExtensionInfo
}

type HealthEntry struct {
	Name       string `json:"name"`
	Status     string `json:"status"`
	Message    string `json:"message,omitempty"`
	DurationMs int64  `json:"durationMs"`
	Critical   bool   `json:"critical"`
}

type HealthList struct {
	OverallStatus  string        `json:"overallStatus"`
	HealthySummary int           `json:"healthySummary"`
	Total          int           `json:"total"`
	Services       []HealthEntry `json:"services"`
}

type HealthProvider interface {
	CollectHealth(ctx context.Context) *collector.HealthData
}

type MetricEntryDTO struct {
	Name  string `json:"name"`
	Type  string `json:"type"`
	Value any    `json:"value,omitempty"`
}

type MetricsProvider interface {
	CollectMetrics(ctx context.Context) *collector.MetricsData
}

type MetricsReportProvider interface {
	CollectMetricsReport(ctx context.Context) *collector.MetricsReport
}

type MetricsReportResponse struct {
	TotalMetrics  int              `json:"totalMetrics"`
	MetricsByType map[string]int   `json:"metricsByType"`
	Collectors    []CollectorEntry `json:"collectors"`
	TopMetrics    []MetricEntryDTO `json:"topMetrics"`
}

type MetricsSummary struct {
	TotalMetrics int   `json:"totalMetrics"`
	Counters     int   `json:"counters"`
	Gauges       int   `json:"gauges"`
	Histograms   int   `json:"histograms"`
	TS           int64 `json:"ts"` // unix seconds
}

type OverviewProvider interface {
	CollectOverview(ctx context.Context) *collector.OverviewData
}

type OverviewResponse struct {
	OverallHealth   string         `json:"overallHealth"`
	TotalServices   int            `json:"totalServices"`
	HealthyServices int            `json:"healthyServices"`
	TotalMetrics    int            `json:"totalMetrics"`
	UptimeSeconds   int64          `json:"uptimeSeconds"`
	Version         string         `json:"version"`
	Environment     string         `json:"environment"`
	Summary         map[string]any `json:"summary,omitempty"`
}

type ServiceDetailInput struct {
	Name string `json:"name"`
}

type ServiceDetailResponse = collector.ServiceDetail

type ServicesList struct {
	Services []collector.ServiceInfo `json:"services"`
}

type ServicesProvider interface {
	CollectServices(ctx context.Context) []collector.ServiceInfo
	CollectServiceDetail(ctx context.Context, name string) *collector.ServiceDetail
}

type TraceDetailInput struct {
	ID string `json:"id"`
}

type TraceDetailResponse = collector.TraceDetail

type TraceSummaryDTO struct {
	TraceID      string `json:"traceID"`
	RootSpanName string `json:"rootSpanName"`
	SpanCount    int    `json:"spanCount"`
	DurationMs   int64  `json:"durationMs"`
	Status       string `json:"status"`
	StartTime    string `json:"startTime"`
	Protocol     string `json:"protocol"`
}

type TracesList struct {
	Traces []TraceSummaryDTO `json:"traces"`
	Total  int               `json:"total"`
}

type TracesProvider interface {
	ListTraces(filter collector.TraceFilter) ([]collector.TraceSummary, collector.TraceStats)
	GetTrace(traceID string) *collector.TraceDetail
}