plugins

type AddonCat struct {
	Key  string `json:"key"`
	Type string `json:"type"`
	ID   string `json:"id"`
	Name string `json:"name"`
}

type AddonConfig struct {
	Configurable bool               `json:"configurable"`
	Required     bool               `json:"required"`
	Configured   bool               `json:"configured"`
	Layer        string             `json:"layer"` // declared, decoded, page, none
	Fields       []AddonConfigField `json:"fields"`
	Host         string             `json:"host"`
}

type AddonConfigChange struct {
	Values map[string]any `json:"values"`
	Link   string         `json:"link"`
}

type AddonConfigField struct {
	Key      string              `json:"key"`
	Label    string              `json:"label"`
	Kind     string              `json:"kind"` // text, number, switch, list, secret, select, fixed
	Value    any                 `json:"value,omitempty"`
	Set      bool                `json:"set,omitempty"` // a secret has a value (never sent)
	Options  []AddonConfigOption `json:"options,omitempty"`
	Required bool                `json:"required,omitempty"`
	Summary  string              `json:"summary,omitempty"` // fixed (structured) values, described
	// Group names the nested setting a field belongs to ("Languages"); its
	// Key is then a path ("languages/preferred").
	Group string `json:"group,omitempty"`
}

type AddonConfigOption struct {
	Value string `json:"value"`
	Label string `json:"label"`
}

type AddonConfigResult struct {
	Name     string   `json:"name"`
	Added    []string `json:"added,omitempty"`   // catalogues it would add
	Removed  []string `json:"removed,omitempty"` // catalogues it would drop
	Roles    []string `json:"roles"`             // what it would do in Ether
	Sample   string   `json:"sample,omitempty"`  // a live result, in words
	Problems []string `json:"problems,omitempty"`
}

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

type AddonInstall struct {
	Link    string
	Name    string
	Roles   []Capability
	Offline []string
	// Exclusive turns every other role off on a newly created record
	// (migrations keep exactly what the legacy entry did).
	Exclusive bool
}

type AddonPreview struct {
	ID               string      `json:"id"`
	Name             string      `json:"name"`
	Description      string      `json:"description,omitempty"`
	Logo             string      `json:"logo,omitempty"`
	Version          string      `json:"version,omitempty"`
	Host             string      `json:"host"`
	Roles            []RoleState `json:"roles"`
	Catalogs         []AddonCat  `json:"catalogs,omitempty"`
	AlreadyInstalled bool        `json:"alreadyInstalled,omitempty"`
	ConfigureFirst   bool        `json:"configureFirst,omitempty"`
}

type Author struct {
	Name string `json:"name,omitempty"`
	URL  string `json:"url,omitempty"`
}

type Backends struct {
	CatalogSearch func(ctx context.Context, query string, limit, offset int) (json.RawMessage, error)
	CatalogGet    func(ctx context.Context, id string) (json.RawMessage, error)
	ViewerHistory func(ctx context.Context, viewerID int64, limit, offset int) (json.RawMessage, error)
	ViewerNames   func(ctx context.Context, ids []int64) (json.RawMessage, error)
	// SetWatchState applies a watch-state write and returns its inverse
	// (the previous state) for the journal.
	SetWatchState func(ctx context.Context, viewerID int64, titleID string, watched bool) (previous bool, err error)
	// CollectionsUpsert creates or updates a collection and returns the
	// previous document (empty when new) for the journal.
	CollectionsUpsert func(ctx context.Context, doc json.RawMessage) (previous json.RawMessage, err error)
	// CollectionsDelete removes a collection by the id in its document;
	// used by undo for a create.
	CollectionsDelete func(ctx context.Context, doc json.RawMessage) error
	// Notice posts a console notice ("console notice" in SPEC §5.2).
	Notice func(text string)
}

type CallRecord struct {
	ID       int64     `json:"id"`
	Plugin   string    `json:"plugin"`
	Route    string    `json:"route"`
	Method   string    `json:"method"`
	Status   int       `json:"status"`
	MS       int64     `json:"ms"`
	Error    string    `json:"error,omitempty"`
	Request  string    `json:"request,omitempty"`
	Response string    `json:"response,omitempty"`
	Created  time.Time `json:"created"`
}

type CandidateFacts struct {
	ReleaseID     string     `json:"releaseId"`
	Name          string     `json:"name"`
	Size          int64      `json:"size,omitempty"`
	Protocol      string     `json:"protocol,omitempty"` // usenet|torrent|direct
	SourceClass   string     `json:"sourceClass,omitempty"`
	Indexer       string     `json:"indexer,omitempty"`
	Resolution    string     `json:"resolution,omitempty"`
	HDR           []string   `json:"hdr,omitempty"`
	VideoCodec    string     `json:"videoCodec,omitempty"`
	AudioCodecs   []string   `json:"audioCodecs,omitempty"`
	AudioChannels string     `json:"audioChannels,omitempty"`
	Languages     []string   `json:"languages,omitempty"`
	Subtitles     []string   `json:"subtitles,omitempty"`
	ReleaseType   string     `json:"releaseType,omitempty"`
	Group         string     `json:"group,omitempty"`
	Cached        bool       `json:"cached,omitempty"`
	Verified      bool       `json:"verified,omitempty"`
	ClientCaps    ClientCaps `json:"clientCaps,omitempty"`
}

type Capability string

type Catalogue interface {
	http.Handler
	// Resolve looks up a plugin in the verified catalogue by plugin ID (or
	// artifact URL) and optional version (empty means latest). It fails when
	// the plugin is not in the catalogue or is revoked.
	Resolve(ctx context.Context, idOrURL, version string) (CatalogueArtifact, error)
}

type CatalogueArtifact struct {
	ID           string
	Version      string
	URL          string
	SHA256       string
	Kind         Kind
	Permissions  Permissions
	Capabilities []Capability
}

type ChannelsMeta struct {
	Refresh string `json:"refresh,omitempty"`
	Test    bool   `json:"test"`
}

type ClientCaps struct {
	MaxHeight int      `json:"maxHeight,omitempty"`
	HDR       []string `json:"hdr,omitempty"`
	Codecs    []string `json:"codecs,omitempty"`
}

type CollectionInputError struct{ Message string }

type CommandMeta struct {
	Key    string `json:"key"`
	Label  string `json:"label"`
	Action string `json:"action"` // plugin action name
}

type Contributes struct {
	Directories    []DirectoryMeta     `json:"directories,omitempty"`
	Metadata       *MetadataMeta       `json:"metadata,omitempty"`
	Source         *SourceMeta         `json:"source,omitempty"`
	Channels       *ChannelsMeta       `json:"channels,omitempty"`
	Subtitles      *SubtitlesMeta      `json:"subtitles,omitempty"`
	Markers        *MarkersMeta        `json:"markers,omitempty"`
	Notification   *NotificationMeta   `json:"notification,omitempty"`
	Events         *EventsMeta         `json:"events,omitempty"`
	Integration    *IntegrationMeta    `json:"integration,omitempty"`
	ListSources    []ListSourceMeta    `json:"listSources,omitempty"`
	RankingSteps   []RankingStepMeta   `json:"rankingSteps,omitempty"`
	RuleConditions []RuleConditionMeta `json:"ruleConditions,omitempty"`
	Tools          []ToolMeta          `json:"tools,omitempty"`
	Pages          []PageMeta          `json:"pages,omitempty"`
	Slots          []SlotMeta          `json:"slots,omitempty"`
	Commands       []CommandMeta       `json:"commands,omitempty"`
}

type Deps struct {
	DB            *sql.DB
	Sealer        config.FieldSealer
	Registry      *extend.Registry
	Tools         *tools.Catalogue
	Notifications *notify.Service
	Logger        *slog.Logger
	// IsLeader reports cluster leadership; nil means always leader.
	IsLeader func() bool
	// Bus broadcasts invalidate:plugins; nil disables it.
	Bus clusterbus.Bus
	// FetchClient fetches manifests and artifacts; nil builds one from
	// safefetch and egress CapPlugins. Tests inject an httptest client.
	FetchClient *http.Client
	// CheckPackage runs the conformance kit during install previews.
	CheckPackage func(context.Context, []byte, map[string][]byte) error
	Backends     Backends
	Now          func() time.Time
}

type Detail struct {
	Summary
	Manifest    Manifest `json:"manifest"`
	Permissions struct {
		Lines        []string    `json:"lines"`
		Declared     Permissions `json:"declared"`
		Grants       Grants      `json:"grants"`
		NeedsViewers bool        `json:"needsViewers"`
		NeedsFolders bool        `json:"needsFolders"`
	} `json:"permissions"`
	HealthDetail Health `json:"healthDetail"`
	Privacy      struct {
		DeclaredHosts []string       `json:"declaredHosts"`
		ObservedHosts map[string]int `json:"observedHosts"`
		Undeclared    []string       `json:"undeclared,omitempty"`
	} `json:"privacy"`
	Impact struct {
		Calls       int   `json:"calls"`
		Errors      int   `json:"errors"`
		P50MS       int64 `json:"p50Ms"`
		P95MS       int64 `json:"p95Ms"`
		EgressBytes int64 `json:"egressBytes"`
		KVBytes     int64 `json:"kvBytes"`
		Slow        int64 `json:"slow"`
		EventDrops  int64 `json:"eventDrops"`
		Restarts    int64 `json:"restarts"`
	} `json:"impact"`
	// AddedPermissions is set when an update is waiting and asks for more.
	AddedPermissions []string `json:"addedPermissions,omitempty"`
}

type DirectoryEntry struct {
	ID          string `json:"id"`
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	Version     string `json:"version,omitempty"`
	ManifestURL string `json:"manifestURL,omitempty"`
	Unsupported string `json:"unsupported,omitempty"`
}

type DirectoryMeta struct {
	Key   string `json:"key"`
	Label string `json:"label"`
}

type DirectoryResult struct {
	Entries []DirectoryEntry `json:"entries"`
}

type EtherBlock struct {
	Protocol int `json:"protocol"`
	// Stremio marks a native plugin that answers Stremio add-on routes,
	// such as an add-on opened and edited in Studio: Ether talks to it
	// exactly as to the add-on it came from.
	Stremio      bool         `json:"stremio,omitempty"`
	Kind         Kind         `json:"kind"`
	Capabilities []Capability `json:"capabilities,omitempty"`
	// Summary is plain text or a "$t:key" reference into Strings.
	Summary string      `json:"summary,omitempty"`
	Author  Author      `json:"author,omitempty"`
	License string      `json:"license,omitempty"`
	Repo    string      `json:"repo,omitempty"`
	Icon    string      `json:"icon,omitempty"`
	Runtime RuntimeDecl `json:"runtime"`
	// Cluster is "leader" (default) or "every_node".
	Cluster     string      `json:"cluster,omitempty"`
	Health      HealthDecl  `json:"health,omitempty"`
	Permissions Permissions `json:"permissions,omitempty"`
	// Settings is a settings schema (SPEC §5.5), {} or {"$ref":"file"}.
	Settings json.RawMessage `json:"settings,omitempty"`
	// Strings maps a locale to a file path (string) or an inline
	// key-to-text object. "en" is required when any $t: key is used.
	Strings     map[string]json.RawMessage `json:"strings,omitempty"`
	Schedule    []ScheduleEntry            `json:"schedule,omitempty"`
	Contributes Contributes                `json:"contributes,omitempty"`
}

type Event struct {
	ID       string          `json:"id"`
	Name     string          `json:"name"`
	At       time.Time       `json:"at"`
	ViewerID int64           `json:"viewerId,omitempty"`
	Payload  json.RawMessage `json:"payload,omitempty"`
}

type EventsMeta struct {
	Subscribe []string `json:"subscribe"`
}

type FetchRequest struct {
	Method  string            `json:"method"`
	URL     string            `json:"url"`
	Headers map[string]string `json:"headers,omitempty"`
	Body    []byte            `json:"body,omitempty"`
}

type FetchResponse struct {
	Status  int               `json:"status"`
	Headers map[string]string `json:"headers,omitempty"`
	Body    []byte            `json:"body,omitempty"`
}

type FieldError struct {
	Field   string `json:"field"`
	Message string `json:"message"`
}

type FolderEntry struct {
	Name  string `json:"name"`
	Path  string `json:"path"`
	Dir   bool   `json:"dir"`
	Size  int64  `json:"size,omitempty"`
	Mtime int64  `json:"mtime,omitempty"` // unix seconds
}

type Grants struct {
	Viewers []int64  `json:"viewers,omitempty"`
	Folders []string `json:"folders,omitempty"`
	Revoked []string `json:"revoked,omitempty"`
	LAN     bool     `json:"lan,omitempty"`
}

type Health struct {
	Status      string         `json:"status"` // ok|attention|error|disabled
	Reason      string         `json:"reason,omitempty"`
	Failures    []int64        `json:"-"` // unix seconds, pruned to 10 minutes
	Restarts    int64          `json:"restarts"`
	Slow        int64          `json:"slow"`
	Drops       int64          `json:"drops"`
	LastError   string         `json:"lastError,omitempty"`
	LastOK      time.Time      `json:"lastOk,omitempty"`
	NextRetry   time.Time      `json:"nextRetry,omitempty"`
	Observed    map[string]int `json:"observed,omitempty"` // host -> fetch count
	EgressBytes int64          `json:"egressBytes"`
	// RankingSkipped counts the resolves since the plugin's last complete
	// ranking that left its ranking step out because it ran past its time
	// budget; zero once a ranking finishes in time again.
	RankingSkipped   int64     `json:"rankingSkipped"`
	RankingSkippedAt time.Time `json:"rankingSkippedAt,omitempty"`
}

type HealthDecl struct {
	Interval string `json:"interval,omitempty"`
}

type Host interface {
	KVGet(ctx context.Context, key string) ([]byte, bool, error)
	KVPut(ctx context.Context, key string, value []byte) error
	KVDelete(ctx context.Context, key string) error
	KVList(ctx context.Context, prefix string) ([]string, error)

	// SecretGet returns a sealed setting the manifest declared in
	// permissions.secrets. Hosted plugins only.
	SecretGet(ctx context.Context, name string) (string, error)

	// HTTPFetch fetches through egress and safefetch; only manifest
	// network hosts are allowed. Observed hosts feed the privacy label.
	HTTPFetch(ctx context.Context, req FetchRequest) (FetchResponse, error)

	// CatalogSearch and CatalogGet need catalog: read. Results are JSON
	// title summaries produced by the injected catalog backend.
	CatalogSearch(ctx context.Context, query string, limit, offset int) (json.RawMessage, error)
	CatalogGet(ctx context.Context, id string) (json.RawMessage, error)

	// ViewerHistory needs viewers.watch_history for that viewer.
	ViewerGranted(ctx context.Context) (json.RawMessage, error)
	ViewerHistory(ctx context.Context, viewerID int64, limit, offset int) (json.RawMessage, error)
	// SetWatchState needs viewers.write_watch_state; journalled.
	SetWatchState(ctx context.Context, viewerID int64, titleID string, watched bool) error
	// CollectionsUpsert needs collections: write; journalled.
	CollectionsUpsert(ctx context.Context, collection json.RawMessage) error

	// FoldersList and FoldersStat need folders: read and an owner-picked
	// root. They never return file contents.
	FoldersList(ctx context.Context, root, path string) ([]FolderEntry, error)
	FoldersStat(ctx context.Context, root, path string) (FolderEntry, error)

	// Settings returns the plugin's current non-secret settings. Plugins
	// read them per request instead of keeping them in instance memory,
	// because hosted plugins run in a pool of instances that restart.
	// Secrets stay behind SecretGet.
	Settings(ctx context.Context) (map[string]any, error)

	// NotifyOwner posts a console notice (rate-limited).
	NotifyOwner(ctx context.Context, text string) error
	// Log appends to the plugin's log ring (redacted, rate-limited).
	Log(ctx context.Context, level, msg string, attrs map[string]any) error
}

type HotBudgets struct {
	PerCandidate time.Duration `json:"perCandidateNs"`
	PerBatch     time.Duration `json:"perBatchNs"`
}

type HotOutcome struct {
	// Status is ok, error, timeout, forbidden, aborted or governance.
	Status   string        `json:"status"`
	Duration time.Duration `json:"durationNs"`
	Units    int64         `json:"units"`
	// Slow counts candidates that went neutral on budget.
	Slow     int  `json:"slow"`
	MemoHits int  `json:"memoHits"`
	Trap     bool `json:"trap,omitempty"`
}

type HotRuntime interface {
	Runtime
	// RankBatch returns one key per candidate (higher ranks first). A
	// candidate that exceeded its budget gets the neutral key 0 and counts
	// in HotOutcome.Slow; a batch that ran out of time returns neutral keys
	// for the rest.
	RankBatch(ctx context.Context, cands []CandidateFacts, config json.RawMessage) (keys []int64, out HotOutcome, err error)
	// CondMatch evaluates a rule condition; false when the budget runs out.
	CondMatch(ctx context.Context, cand CandidateFacts, operator string, value json.RawMessage) (match bool, out HotOutcome, err error)
	HasRankKey() bool
	HasCondMatch() bool
	// Budgets reports the effective per-candidate and per-batch limits.
	Budgets() HotBudgets
}

type InstallOptions struct {
	Grants     Grants
	Settings   map[string]any
	AutoUpdate bool
	Shadow     bool
	// AcceptAddedPermissions confirms an update that asks for more.
	AcceptAddedPermissions bool
}

type Installed struct {
	ID       string
	Manifest Manifest
	// SourceURL is where the manifest came from (remote endpoint base).
	SourceURL string
	// Files returns an artifact file (entry, module, strings, schema) for
	// the installed version, or false. Hosted runtimes load code through it.
	Files func(path string) ([]byte, bool)
	// Host is the per-plugin host-services handle (SPEC §5.1.5).
	Host Host
}

type IntegrationMeta struct {
	Category string   `json:"category"`
	Logo     string   `json:"logo,omitempty"`
	Adds     []string `json:"adds"`    // 1..4 plain lines or $t: keys
	Connect  string   `json:"connect"` // fields|device_code|none
	Test     bool     `json:"test,omitempty"`
}

type JournalEntry struct {
	ID      int64           `json:"id"`
	Plugin  string          `json:"plugin"`
	Op      string          `json:"op"`
	Detail  string          `json:"detail,omitempty"`
	Inverse json.RawMessage `json:"inverse,omitempty"`
	Shadow  bool            `json:"shadow"`
	Undone  bool            `json:"undone"`
	Created time.Time       `json:"created"`
}

type Kind string

type ListParamField struct {
	Key         string `json:"key"`
	Name        string `json:"name"`
	Kind        string `json:"kind"`
	Label       string `json:"label"`
	Help        string `json:"help"`
	Hint        string `json:"hint"`
	Required    bool   `json:"required"`
	Placeholder string `json:"placeholder"`
	Default     any    `json:"default"`
	Options     []struct {
		Value string `json:"value"`
		Label string `json:"label"`
	} `json:"options"`
}

type ListSourceMeta struct {
	Key      string          `json:"key"`
	Label    string          `json:"label"`
	Hint     string          `json:"hint,omitempty"`
	Catalog  string          `json:"catalog"`
	Params   json.RawMessage `json:"params,omitempty"`
	MaxItems int             `json:"maxItems,omitempty"` // ≤ 2000
	Refresh  string          `json:"refresh,omitempty"`  // ≥ 1h
}

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

type Manifest struct {
	ID            string                `json:"id"`
	Version       string                `json:"version"`
	Name          string                `json:"name"`
	Description   string                `json:"description,omitempty"`
	Logo          string                `json:"logo,omitempty"`
	Background    string                `json:"background,omitempty"`
	Types         []string              `json:"types,omitempty"`
	AddonCatalogs []StremioCat          `json:"addonCatalogs,omitempty"`
	Catalogs      []StremioCat          `json:"catalogs,omitempty"`
	Resources     stremio.Resources     `json:"resources,omitempty"`
	IDPrefixes    []string              `json:"idPrefixes,omitempty"`
	BehaviorHints stremio.BehaviorHints `json:"behaviorHints,omitzero"`
	Ether         *EtherBlock           `json:"ether,omitempty"`
	// contains filtered or unexported fields
}

type MarkersMeta struct {
	Kinds []string `json:"kinds"` // intro|credits|recap|preview
}

type MetadataMeta struct {
	Types []string `json:"types"`
}

type NotificationMeta struct {
	Fields    json.RawMessage `json:"fields,omitempty"`
	SendTest  bool            `json:"sendTest"`
	Formats   []string        `json:"formats,omitempty"`
	MaxLength int             `json:"maxLength,omitempty"`
}

type PageMeta struct {
	Key   string `json:"key"`
	Label string `json:"label"`
	Route string `json:"route"` // plugin route returning {spec,data}
	Group string `json:"group,omitempty"`
	Icon  string `json:"icon,omitempty"`
}

type PermissionIncreaseError struct{ Added []string }

type Permissions struct {
	Network     []string    `json:"network,omitempty" yaml:"network,omitempty"`
	Catalog     string      `json:"catalog,omitempty" yaml:"catalog,omitempty"` // ""|none|read
	Viewers     ViewerPerms `json:"viewers,omitempty" yaml:"viewers,omitempty"`
	Collections string      `json:"collections,omitempty" yaml:"collections,omitempty"` // ""|none|write
	Folders     string      `json:"folders,omitempty" yaml:"folders,omitempty"`         // ""|none|read
	Secrets     []string    `json:"secrets,omitempty" yaml:"secrets,omitempty"`
}

type Preview struct {
	Manifest         Manifest `json:"manifest"`
	PermissionLines  []string `json:"permissions"`
	NeedsViewers     bool     `json:"needsViewers"`
	NeedsFolders     bool     `json:"needsFolders"`
	Verified         bool     `json:"verified"`
	StremioOnly      bool     `json:"stremioOnly"`
	AlreadyInstalled bool     `json:"alreadyInstalled,omitempty"`
	InstalledVersion string   `json:"installedVersion,omitempty"`
	AddedPermissions []string `json:"addedPermissions,omitempty"`
	// contains filtered or unexported fields
}

type RankingReport struct {
	// Slow counts candidates and conditions that went neutral on budget.
	Slow int
	// Skipped counts ranking steps left out because the plugin ran past
	// its time budget; Ranked counts ranking steps that finished in time.
	Skipped, Ranked int
}

type RankingStepMeta struct {
	Key             string          `json:"key"`
	Label           string          `json:"label"`
	Hint            string          `json:"hint,omitempty"`
	Editor          json.RawMessage `json:"editor,omitempty"`
	DefaultPosition int             `json:"defaultPosition,omitempty"`
	Budget          json.RawMessage `json:"budget,omitempty"`
}

type Record struct {
	ID            string
	Name          string
	Version       string
	Kind          string
	Manifest      Manifest
	ManifestRaw   json.RawMessage
	SourceKind    string // url|github|pkg|studio|catalogue
	SourceURL     string
	Enabled       bool
	Verified      bool
	Shadow        bool
	AutoUpdate    bool
	UpdateVersion string

	PrevVersion string
	InstalledAt time.Time
	UpdatedAt   time.Time
	// RolesOff are the capabilities the owner switched off (a Stremio
	// add-on's catalogs, streams, subtitles…). Manifest already reflects
	// them: EffectiveEther leaves them out.
	RolesOff []Capability
	// contains filtered or unexported fields
}

type Request struct {
	PluginID string            `json:"pluginId"`
	Method   string            `json:"method"`
	Path     string            `json:"path"`
	Query    map[string]string `json:"query,omitempty"`
	Headers  map[string]string `json:"headers,omitempty"`
	Body     json.RawMessage   `json:"body,omitempty"`
	// Locale is the console locale for calls that return copy.
	Locale string `json:"locale,omitempty"`
}

type Response struct {
	Status  int               `json:"status"`
	Headers map[string]string `json:"headers,omitempty"`
	Body    json.RawMessage   `json:"body,omitempty"`
}

type RoleState struct {
	Role Capability `json:"role"`
	On   bool       `json:"on"`
}

type RuleConditionMeta struct {
	Key       string          `json:"key"`
	Label     string          `json:"label"`
	Operators []string        `json:"operators,omitempty"`
	Editor    json.RawMessage `json:"editor,omitempty"`
}

type Runtime interface {
	Call(ctx context.Context, req Request) (Response, error)
	Close() error
}

type RuntimeDecl struct {
	Kind   string `json:"kind"` // "hosted" or "remote"
	Entry  string `json:"entry,omitempty"`
	Module string `json:"module,omitempty"`
}

type RuntimeFactory func(inst Installed) (Runtime, error)

type ScheduleEntry struct {
	Every string `json:"every"`
	Call  string `json:"call"`
}

type SlotMeta struct {
	Slot   string `json:"slot"` // title.panel|viewer.tab|dashboard.panel|actionMenu.*
	Key    string `json:"key"`
	Label  string `json:"label"`
	Route  string `json:"route,omitempty"`
	Action string `json:"action,omitempty"`
}

type Source struct {
	Kind string // url|github|pkg|studio|catalogue
	URL  string
	// ID and Version select an entry from the signed catalogue (kind "catalogue").
	ID      string
	Version string
	// SHA256 is the expected lowercase hex SHA-256 of the downloaded artifact.
	SHA256 string

	// Pkg is the .etherpkg bytes (kind "pkg") or a Studio package.
	Pkg []byte
	// Manifest and Files install directly (Studio with loose files).
	Manifest json.RawMessage
	Files    map[string][]byte
	// Verified is set only by the signed catalogue (WS12).
	Verified bool
	// LAN allows a private-network manifest URL (owner confirmed).
	LAN bool
	// contains filtered or unexported fields
}

type SourceMeta struct {
	Class     string          `json:"class"` // debrid|usenet|indexer|direct
	Abilities []string        `json:"abilities,omitempty"`
	Limits    json.RawMessage `json:"limits,omitempty"`
}

type StremioCat = stremio.Catalog

type StremioExtra = stremio.Extra

type SubtitlesMeta struct {
	Languages json.RawMessage `json:"languages,omitempty"`
	Formats   []string        `json:"formats,omitempty"`
}

type Summary struct {
	ID            string `json:"id"`
	Name          string `json:"name"`
	Version       string `json:"version"`
	Kind          string `json:"kind,omitempty"`
	Summary       string `json:"summary,omitempty"`
	Icon          string `json:"icon,omitempty"`
	Enabled       bool   `json:"enabled"`
	Verified      bool   `json:"verified"`
	Shadow        bool   `json:"shadow"`
	AutoUpdate    bool   `json:"autoUpdate"`
	UpdateVersion string `json:"updateVersion,omitempty"`
	PrevVersion   string `json:"prevVersion,omitempty"`
	Health        string `json:"health"`
	// HealthReason is the plain-language reason behind a non-ok health,
	// such as "Recent calls were slow."
	HealthReason string   `json:"healthReason,omitempty"`
	Capabilities []string `json:"capabilities,omitempty"`
	SourceKind   string   `json:"sourceKind,omitempty"`
	StremioOnly  bool     `json:"stremioOnly,omitempty"`
	InstalledAt  int64    `json:"installedAt"`
	// Roles and Host describe a Stremio add-on: what it can do, which of
	// that is switched on, and the host it is reached at (never the link,
	// which carries the owner's configuration).
	Roles []RoleState `json:"roles,omitempty"`
	Host  string      `json:"host,omitempty"`
}

type TestResult struct {
	OK      bool     `json:"ok"`
	Message string   `json:"message,omitempty"`
	Details []string `json:"details,omitempty"`
}

type ToolMeta struct {
	Name        string          `json:"name"`
	Title       string          `json:"title"`
	Description string          `json:"description"`
	InputSchema json.RawMessage `json:"inputSchema"`
	ReadOnly    bool            `json:"readOnly,omitempty"`
	Destructive bool            `json:"destructive,omitempty"`
	OpenWorld   bool            `json:"openWorld,omitempty"`
}

type ValidationError struct{ Fields []FieldError }

type ViewerPerms struct {
	Identity        string `json:"identity,omitempty" yaml:"identity,omitempty"`                   // none|granted_viewers|all
	WatchHistory    string `json:"watch_history,omitempty" yaml:"watch_history,omitempty"`         // none|granted_viewers|all
	WriteWatchState string `json:"write_watch_state,omitempty" yaml:"write_watch_state,omitempty"` // none|granted_viewers
}