plugin

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

type CommandSpec struct {
	Name        string     `json:"name"`        // Command name
	Description string     `json:"description"` // Command description
	Arguments   []string   `json:"arguments"`   // Argument names
	Flags       []FlagSpec `json:"flags"`       // Available flags
}

type ConfigField struct {
	Key         string      `json:"key"`           // Field key
	Type        string      `json:"type"`          // Field type (string, int, bool, etc.)
	Default     interface{} `json:"default"`       // Default value
	Description string      `json:"description"`   // Field description
	Required    bool        `json:"required"`      // Is required
	Options     []string    `json:"options"`       // Allowed values for enum
	Min         *float64    `json:"min,omitempty"` // Minimum for numbers
	Max         *float64    `json:"max,omitempty"` // Maximum for numbers
	Pattern     string      `json:"pattern"`       // Regex pattern for strings
	Sensitive   bool        `json:"sensitive"`     // Is sensitive (password, etc.)
	EnvVar      string      `json:"env_var"`       // Environment variable fallback
}

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

type Context struct {
	PluginID    string                 // Plugin ID
	HomeDir     string                 // User home directory
	WorkingDir  string                 // Current working directory
	Environment []string               // Environment variables
	DataDir     string                 // Plugin data directory
	CacheDir    string                 // Plugin cache directory
	ConfigDir   string                 // Plugin config directory
	Config      map[string]interface{} // Plugin configuration
	SessionID   string                 // Current session ID
	UserID      string                 // Current user ID
	Logger      Logger                 // Plugin logger
	Metadata    map[string]interface{} // Additional metadata
}

type Dependency struct {
	ID       string `json:"id"`       // Plugin ID
	Version  string `json:"version"`  // Version constraint
	Optional bool   `json:"optional"` // Is this optional
}

type FlagSpec struct {
	Name        string `json:"name"`        // Flag name
	Short       string `json:"short"`       // Short flag
	Description string `json:"description"` // Flag description
	Default     string `json:"default"`     // Default value
	Type        string `json:"type"`        // Flag type
}

type LifecycleEvent string

type LifecycleHook func(ctx *Context, event LifecycleEvent, data interface{}) error

type LifecycleHookRegistration struct {
	Event    LifecycleEvent
	Priority int // Higher priority runs first
	Handler  LifecycleHook
}

type LifecyclePlugin interface {
	Plugin

	// OnLifecycle is called for lifecycle events
	OnLifecycle(ctx *Context, event LifecycleEvent, data interface{}) error

	// RegisterLifecycleHooks returns hooks this plugin provides
	RegisterLifecycleHooks() []LifecycleHookRegistration
}

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

type LoaderConfig struct {
	PluginDir    string   // Directory to load plugins from
	AllowedDirs  []string // Additional allowed directories
	AutoEnable   bool     // Auto-enable loaded plugins
	ValidateDeps bool     // Validate dependencies on load
	LoadBuiltins bool     // Load built-in plugins
	BuiltinDir   string   // Built-in plugins directory
	PreloadHooks []string // Hooks to preload
}

type Logger interface {
	Debug(msg string, args ...interface{})
	Info(msg string, args ...interface{})
	Warn(msg string, args ...interface{})
	Error(msg string, args ...interface{})
}

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

type ManagerConfig struct {
	PluginDir     string
	CacheDir      string
	AllowNetwork  bool
	EnableSandbox bool
}

type Plugin interface {
	// Manifest returns the plugin manifest
	Manifest() *PluginManifest

	// Initialize initializes the plugin with configuration
	Initialize(ctx *Context) error

	// Execute runs a command with arguments
	Execute(cmd string, args []string) (interface{}, error)

	// Shutdown gracefully shuts down the plugin
	Shutdown() error
}

type PluginEntry struct {
	Plugin   Plugin
	Manifest *PluginManifest
	State    PluginState
	Info     *PluginInfo
	RefCount int // Number of other plugins depending on this
	// contains filtered or unexported fields
}

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

type PluginInfo struct {
	ID           string                 `json:"id"`
	Name         string                 `json:"name"`
	Version      string                 `json:"version"`
	Description  string                 `json:"description"`
	State        PluginState            `json:"state"`
	Author       string                 `json:"author"`
	Category     string                 `json:"category"`
	Tags         []string               `json:"tags"`
	StateInfo    string                 `json:"state_info"`   // Additional state info
	EnabledAt    *time.Time             `json:"enabled_at"`   // When enabled
	DisabledAt   *time.Time             `json:"disabled_at"`  // When disabled
	LoadedAt     *time.Time             `json:"loaded_at"`    // When loaded
	UnloadedAt   *time.Time             `json:"unloaded_at"`  // When unloaded
	ErrorMsg     string                 `json:"error_msg"`    // Error message if state is error
	Permissions  []string               `json:"permissions"`  // Permissions granted
	Commands     []string               `json:"commands"`     // Available commands
	Hooks        []string               `json:"hooks"`        // Registered hooks
	Dependents   []string               `json:"dependents"`   // Plugins depending on this
	Dependencies []string               `json:"dependencies"` // Plugins this depends on
	Config       map[string]interface{} `json:"config"`       // Current config
}

type PluginManifest struct {
	ID                string            `json:"id"`                 // Unique identifier (kebab-case)
	Name              string            `json:"name"`               // Display name
	Version           string            `json:"version"`            // Semantic version
	Description       string            `json:"description"`        // Brief description
	LongDesc          string            `json:"long_desc"`          // Detailed description
	Author            string            `json:"author"`             // Author name
	AuthorEmail       string            `json:"author_email"`       // Author email
	License           string            `json:"license"`            // License type
	Homepage          string            `json:"homepage"`           // Plugin homepage
	Repository        string            `json:"repository"`         // Source repository
	Tags              []string          `json:"tags"`               // Searchable tags
	Category          string            `json:"category"`           // Plugin category
	APIVersion        string            `json:"api_version"`        // go-magic API version
	MinAppVersion     string            `json:"min_app_version"`    // Minimum go-magic version
	Type              PluginType        `json:"type"`               // Plugin implementation type
	Entrypoint        string            `json:"entrypoint"`         // Main entry file (default)
	Entrypoints       map[string]string `json:"entrypoints"`        // Platform-specific entrypoints (key: GOOS, e.g. "windows", "darwin", "linux")
	EntrypointWindows string            `json:"entrypoint_windows"` // Shortcut for entrypoints.windows
	Permissions       []string          `json:"permissions"`        // Required permissions
	Dependencies      []Dependency      `json:"dependencies"`       // Plugin dependencies
	ConfigSchema      []ConfigField     `json:"config_schema"`      // Configuration schema
	Commands          []CommandSpec     `json:"commands"`           // CLI commands
	Hooks             []string          `json:"hooks"`              // Lifecycle hooks
	Events            []string          `json:"events"`             // Published events
	Resources         []ResourceSpec    `json:"resources"`          // Bundled resources
	CreatedAt         string            `json:"created_at"`         // Creation timestamp
	UpdatedAt         string            `json:"updated_at"`         // Last update timestamp
}

type PluginState string

type PluginType string

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

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

type RegistryListener interface {
	OnPluginRegistered(plugin *PluginManifest)
	OnPluginUnregistered(id string)
	OnPluginStateChanged(id string, oldState, newState PluginState)
	OnPluginEnabled(id string)
	OnPluginDisabled(id string)
}

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

type RepositoryIndex struct {
	UpdatedAt string           `json:"updated_at"`
	Plugins   []PluginManifest `json:"plugins"`
}

type ResourceSpec struct {
	Name     string `json:"name"`      // Resource name
	Type     string `json:"type"`      // Resource type (data, template, etc.)
	Path     string `json:"path"`      // Relative path in plugin
	MimeType string `json:"mime_type"` // MIME type
}

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

type SandboxConfig struct {
	Timeout         time.Duration // Execution timeout
	MemLimit        int64         // Memory limit in bytes (0 = unlimited)
	CPUQuota        int           // CPU quota percentage (0 = unlimited)
	AllowNetwork    bool          // Allow network access
	FilesystemRead  []string      // Allowed read paths
	FilesystemWrite []string      // Allowed write paths
	EnvWhitelist    []string      // Allowed environment variables
}

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

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

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

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

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

type UpdateInfo struct {
	PluginID   string
	CurrentVer string
	NewVersion string
}

type VersionConstraint struct {
	Operator string
	Major    int
	Minor    *int
	Patch    *int
}

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