plugins

type Category = manifest.DisplayCategory

type ConfigureError struct {
	Message string
}

type EnricherCapabilities struct {
	MediaTypes []string `json:"media_types"`
	Provides   []string `json:"provides"`
	IsLocal    bool     `json:"is_local"`
	RateLimit  int      `json:"rate_limit"`
	Requires   []string `json:"requires,omitempty"`
}

type ErrBuiltinPlugin struct {
	PluginID string
}

type ErrPluginNotFound struct {
	PluginID string
}

type FilterTab struct {
	ID    string `json:"id"`    // Tab identifier (e.g., "all", "enrichers")
	Label string `json:"label"` // Display label
	Count int    `json:"count"` // Number of plugins matching this filter
}

type InstallProgress struct {
	PluginID string        `json:"plugin_id"`
	Status   InstallStatus `json:"status"`
	Progress int           `json:"progress"` // 0-100
	Message  string        `json:"message,omitempty"`
	Error    string        `json:"error,omitempty"`
	Version  string        `json:"version,omitempty"`
}

type InstallRequest struct {
	PluginID string `json:"plugin_id" binding:"required"`
	Version  string `json:"version,omitempty"` // Empty means latest
}

type InstallStatus string

type LogEntry struct {
	Timestamp time.Time         `json:"timestamp"`
	Level     string            `json:"level"`
	Message   string            `json:"message"`
	Fields    map[string]string `json:"fields,omitempty"`
}

type LogOptions struct {
	Limit int       // Max entries to return (default 100)
	Level string    // Filter by level (e.g., "error", "warn")
	Since time.Time // Only entries after this time
}

type MarketplaceCatalog struct {
	Plugins   []MarketplacePlugin `json:"plugins"`
	UpdatedAt time.Time           `json:"updated_at"`
	CacheAge  string              `json:"cache_age,omitempty"` // Human-readable, e.g. "5m ago"
}

type MarketplaceConfig struct {
	// Enabled controls whether marketplace features are available.
	Enabled bool

	// CacheTTL is how long to cache the plugin catalog.
	CacheTTL time.Duration

	// PluginDir is where plugins are installed.
	PluginDir string

	// TempDir is for temporary downloads.
	TempDir string
}

type MarketplacePlugin struct {
	ID               string   `json:"id"`
	Name             string   `json:"name"`
	Description      string   `json:"description"`
	Author           string   `json:"author,omitempty"`
	LatestVersion    string   `json:"latest_version"`
	InstalledVersion string   `json:"installed_version,omitempty"`
	IsInstalled      bool     `json:"is_installed"`
	HasUpdate        bool     `json:"has_update"`
	Capabilities     []string `json:"capabilities,omitempty"`
	DownloadCount    int64    `json:"download_count,omitempty"`
	PublishedAt      string   `json:"published_at,omitempty"` // RFC3339
}

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

type Plugin struct {
	ID             string
	Name           string
	Version        string
	Description    string
	Author         string
	License        string
	Homepage       string
	Capabilities   string // JSON array of capability strings
	IsBuiltin      bool
	Enabled        bool
	Path           string
	HealthStatus   string
	LastHeartbeat  time.Time
	RestartCount   int
	Settings       string // JSON string of plugin settings
	SettingsSchema string // JSON Schema for plugin settings
	InstalledAt    time.Time
	UpdatedAt      time.Time
}

type PluginDetail struct {
	PluginSummary
	License       string    `json:"license"`
	Homepage      string    `json:"homepage"`
	InstalledAt   time.Time `json:"installed_at"`
	UpdatedAt     time.Time `json:"updated_at"`
	RestartCount  int       `json:"restart_count"`
	LastHeartbeat time.Time `json:"last_heartbeat"`
	HealthMessage string    `json:"health_message,omitempty"`

	// EnricherCapabilities contains enricher-specific capabilities (nil for non-enrichers)
	EnricherCapabilities *EnricherCapabilities `json:"enricher_capabilities,omitempty"`
}

type PluginHealthDetail struct {
	Status        string    `json:"status"`
	Message       string    `json:"message"`
	LastHeartbeat time.Time `json:"last_heartbeat"`
	ErrorRate     float64   `json:"error_rate"`
	AvgLatencyMs  int64     `json:"avg_latency_ms"`
	Restarts      int       `json:"restarts"`
	UptimeSeconds int64     `json:"uptime_seconds"`
}

type PluginQueries interface {
	ListPlugins(ctx context.Context) ([]Plugin, error)
	GetPlugin(ctx context.Context, id string) (Plugin, error)
	EnablePlugin(ctx context.Context, id string) error
	DisablePlugin(ctx context.Context, id string) error
	UpsertPlugin(ctx context.Context, p Plugin) error
	DeletePlugin(ctx context.Context, id string) error
	GetPluginSettings(ctx context.Context, id string) (string, error)
	UpdatePluginSettings(ctx context.Context, id string, settings string) error
	UpdatePluginSettingsSchema(ctx context.Context, id string, schema string) error
}

type PluginSettings struct {
	PluginID string          `json:"plugin_id"`
	Schema   json.RawMessage `json:"schema"`
	Values   json.RawMessage `json:"values"`
}

type PluginSource string

type PluginSummary struct {
	ID          string         `json:"id"`
	Name        string         `json:"name"`
	Version     string         `json:"version"`
	Description string         `json:"description"`
	Author      string         `json:"author"`
	Enabled     bool           `json:"enabled"`
	IsBuiltin   bool           `json:"is_builtin"`
	Health      string         `json:"health"`                // "healthy", "degraded", "unhealthy", "unknown"
	ProviderID  string         `json:"provider_id,omitempty"` // Provider ID if this is a provider plugin (e.g., "ollama")
	Meta        map[string]any `json:"meta,omitempty"`        // x-viewra-meta from settings schema

	// Settings availability
	HasSettings bool `json:"has_settings"` // Whether this plugin has configurable settings

	// Capabilities this plugin provides (e.g., "search", "embedding", "chat")
	Capabilities []string `json:"capabilities,omitempty"`

	// Dependencies this plugin requires but are not currently available
	// Used to show warnings in the UI about missing capabilities
	MissingDependencies []string `json:"missing_dependencies,omitempty"`

	// DisplayCategory is the computed category for UI grouping
	// Determined by: builtin → "Local", provider capability → "AI Providers",
	// search capability → "Search", enricher category → "Enrichers", else "Other"
	DisplayCategory string `json:"display_category"`
}

type SchemaParser struct{}

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

type UpdateInfo struct {
	PluginID         string `json:"plugin_id"`
	PluginName       string `json:"plugin_name"`
	InstalledVersion string `json:"installed_version"`
	LatestVersion    string `json:"latest_version"`
}

type UpdatesResponse struct {
	Updates []UpdateInfo `json:"updates"`
	Count   int          `json:"count"`
}