plugin

type Channel interface {
	Name() string
	Start(ctx context.Context) error
	Stop(ctx context.Context) error
	Send(ctx context.Context, msg bus.OutboundMessage) error
	IsRunning() bool
}

type ChannelPlugin interface {
	Plugin

	// ChannelPrefix returns the userId prefix this channel owns (e.g., "telegram", "discord")
	ChannelPrefix() string

	// CreateChannel instantiates the channel implementation
	CreateChannel(cfg *config.Config, bus *bus.MessageBus) (Channel, error)

	// IsEnabled checks if the channel is enabled in config
	IsEnabled(cfg *config.Config) bool
}

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

type Metadata struct {
	// ID is the unique identifier for the plugin (e.g., "moonhub-channel-telegram")
	ID string `json:"id"`
	// Name is the human-readable name (e.g., "Telegram")
	Name string `json:"name"`
	// Type indicates the plugin category
	Type PluginType `json:"type"`
	// Version follows semantic versioning (e.g., "1.0.0")
	Version string `json:"version"`
	// Description provides a brief summary of the plugin
	Description string `json:"description"`
	// Author is optional attribution
	Author string `json:"author,omitempty"`
	// Priority affects loading order (higher = loaded later)
	Priority int `json:"priority,omitempty"`
}

type Plugin interface {
	// Metadata returns plugin metadata
	Metadata() Metadata

	// Init initializes the plugin with runtime context
	Init(ctx *RuntimeContext) error

	// Validate checks if the plugin can run with current config
	Validate(cfg *config.Config) error
}

type PluginType string

type ProviderPlugin interface {
	Plugin

	// ProviderName returns the provider identifier (e.g., "anthropic", "openai")
	ProviderName() string

	// CreateProvider instantiates the provider from full config (used for IsEnabled checks).
	// For actual provider creation, use CreateProviderFromModelConfig.
	CreateProvider(cfg *config.Config) (providers.LLMProvider, error)

	// CreateProviderFromModelConfig creates a provider from model-centric config.
	// Used by the factory when routing by protocol.
	CreateProviderFromModelConfig(modelCfg *config.ModelConfig) (providers.LLMProvider, error)

	// IsEnabled checks if the provider has valid configuration
	IsEnabled(cfg *config.Config) bool

	// SupportsProtocol returns true if this plugin handles the given protocol (e.g., "openai", "anthropic").
	// Used for routing in CreateProviderFromConfig.
	SupportsProtocol(protocol string) bool

	// SupportsModel checks if this provider can handle a given model name (e.g., "openai/gpt-4o")
	SupportsModel(modelName string) bool
}

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

type RuntimeContext struct {
	// Config is the application configuration
	Config *config.Config
	// Bus is the message bus for inter-component communication
	Bus *bus.MessageBus
	// Workspace is the path to the workspace directory
	Workspace string
	// MediaStore handles media file storage
	MediaStore media.MediaStore
}

type ToolPlugin interface {
	Plugin

	// CreateTools returns tool instances this plugin provides
	CreateTools(ctx *RuntimeContext) []tools.Tool

	// IsCore indicates if this is a core tool (always available)
	// Non-core tools can be dynamically promoted/discovered
	IsCore() bool
}