sdk

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

type ActionResult struct {
	Success     bool
	Output      string
	Error       error
	ShowOutput  bool
	Title       string
	IsStreaming bool
	RefreshMenu bool // Indicates if the parent menu should refresh its dynamic content
}

type AppState int

type ArgumentBasedActionConfig struct {
	CommandName     string                // CLI command name
	Description     string                // CLI command description
	MenuID          string                // Menu ID for selection
	MenuTitle       string                // Menu title for interactive selection
	CLITitle        string                // Title for CLI execution (optional, defaults to MenuTitle)
	Items           []SelectionItem       // Selectable items
	Parameters      []ParameterDefinition // Parameter definitions for validation
	DirectFunction  InteractiveGoFunction // Function for direct CLI execution with args
	ExecuteFunction InteractiveGoFunction // Function for menu-based execution
	ExampleCommand  string                // Custom example command prefix (optional, defaults to plugin name)
}

type BuildTarget struct {
	OS     string `yaml:"os"`
	Arch   string `yaml:"arch"`
	Output string `yaml:"output"`
}

type CLICommandConfig struct {
	Command     string
	Description string
	Handler     func(args []string) error
	UIAction    string
	UITarget    string
	UICommand   string
}

type CLICommandExecuteArgs struct {
	Name string
	Args []string
}

type CLICommandExecuteResponse struct {
	Output string
	Error  error
}

type CLICommandHandler func(args []string) error

type CLICommandInfo struct {
	Name        string   `json:"name"`
	Description string   `json:"description"`
	Usage       string   `json:"usage"`
	Examples    []string `json:"examples"`
	Hidden      bool     `json:"hidden,omitempty"` // Hide this command from CLI help and prevent execution with args

	// UI Action mapping - allows CLI commands to specify their UI equivalent
	UIAction  string `json:"ui_action,omitempty"`  // The UI action type (e.g., "goto", "core_interactive-go", "action")
	UITarget  string `json:"ui_target,omitempty"`  // For goto actions - the target menu/provider
	UICommand string `json:"ui_command,omitempty"` // For core_interactive-go actions - the command to execute
	UITitle   string `json:"ui_title,omitempty"`   // Custom title for Bubble Tea UI when executed via CLI
}

type CLIShortcut struct {
	Command     string // CLI command name
	MenuID      string // Target menu ID
	Description string // Description for help
}

type CheckboxItem struct {
	Key         string                 // Item key/identifier
	Label       string                 // Item display label
	Description string                 // Item description
	Params      map[string]interface{} // Parameters to pass when selected
	IsChecked   bool                   // Initial checked state
}

type ConfigPreset struct {
	Name        string                 `json:"name"`
	Description string                 `json:"description"`
	Config      map[string]interface{} `json:"config"`
}

type CrossPluginInvocationResult struct {
	Success bool
	Error   error
	Output  []string // Collected output lines
}

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

type DynamicMenuConfig struct {
	MaxEntries       int
	EnableExitButton bool
	ExitKey          string
	ExitLabel        string
	EmptyMessage     string
	EmptyKey         string
}

type DynamicProvider interface {
	GetName() string
	GetDescription() string
	GenerateEntries(param string) ([]MenuEntry, error)
	SupportsRefresh() bool
}

type DynamicProviderRPC struct {
	Name        string
	Description string
}

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

type FavoriteItem struct {
	Key    string                 // Unique key for the item
	Label  string                 // Display label
	Params map[string]interface{} // Additional parameters
}

type FavoritesConfig struct {
	MenuID     string         // Menu ID for the favorites
	Title      string         // Menu title
	Items      []FavoriteItem // Items that can be favorited
	PluginName string         // Plugin name for config storage
	SummaryKey string         // Key for summary menu entry (optional)
}

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

type FormField struct {
	Key   string // Field identifier
	Label string // Field display label
	Type  string // Field type (text, number, etc.)
}

type GitHubRelease struct {
	TagName     string               `json:"tag_name"`
	Name        string               `json:"name"`
	Body        string               `json:"body"`
	Draft       bool                 `json:"draft"`
	Prerelease  bool                 `json:"prerelease"`
	PublishedAt time.Time            `json:"published_at"`
	HTMLURL     string               `json:"html_url"`
	Assets      []GitHubReleaseAsset `json:"assets"`
}

type GitHubReleaseAsset struct {
	ID                 int64  `json:"id"`
	Name               string `json:"name"`
	Label              string `json:"label"`
	ContentType        string `json:"content_type"`
	Size               int64  `json:"size"`
	BrowserDownloadURL string `json:"browser_download_url"`
	URL                string `json:"url"` // API URL for authenticated downloads
}

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

type InputRequester interface {
	// RequestInput sends a prompt and waits for user input
	RequestInput(prompt string) (string, error)
	// RequestInputWithDefault sends a prompt with a default value
	RequestInputWithDefault(prompt string, defaultValue string) (string, error)
	// RequestPassword sends a prompt and waits for hidden password input
	RequestPassword(prompt string) (string, error)
}

type InteractiveGoFunction func(ctx context.Context, outputChan chan<- string, inputChan <-chan string, params map[string]interface{}) error

type InteractiveMapping struct {
	CLIName        string                 // Name of the CLI command (e.g., "streaming")
	CLIDescription string                 // Description for CLI help
	UICommand      string                 // Interactive function name
	Function       InteractiveGoFunction  // The interactive function implementation (nil to use built-in)
	Params         map[string]interface{} // Parameters to pass to the interactive function
	Hidden         bool                   // Hide this command from CLI help and prevent CLI execution
	MenuTarget     string                 // Target menu for navigation when no CLI args provided
}

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

type InteractiveStreamCleanupArgs struct {
	SessionID string
}

type InteractiveStreamCleanupResponse struct {
	Success bool
	Error   error
}

type InteractiveStreamInitArgs struct {
	FunctionName string
	Params       map[string]interface{}
}

type InteractiveStreamInitResponse struct {
	SessionID string
	Error     error
}

type InteractiveStreamInputArgs struct {
	SessionID string
	Input     string
}

type InteractiveStreamInputResponse struct {
	Success bool
	Error   error
}

type InteractiveStreamOutputArgs struct {
	SessionID string
}

type InteractiveStreamOutputResponse struct {
	NewOutput   []string
	Completed   bool
	Error       error
	NeedsInput  bool   // Indicates if the function is waiting for user input
	InputPrompt string // Optional prompt message for the input
}

type InteractiveStreamSession struct {
	FunctionName    string
	Params          map[string]interface{}
	OutputChan      chan string
	InputChan       chan string
	ErrorChan       chan error
	Context         context.Context
	Cancel          context.CancelFunc
	OutputBuffer    []string
	LastSentIndex   int // Track what has been sent to avoid duplicates
	Completed       bool
	FinalError      error
	WaitingForInput bool   // Track if function is waiting for input
	InputPrompt     string // Current input prompt
	// contains filtered or unexported fields
}

type LogLevel string

type Logger struct {
	*logrus.Logger
	// contains filtered or unexported fields
}

type Menu struct {
	ID            string          `yaml:"id"`
	Title         string          `yaml:"title"`
	Input         bool            `yaml:"input,omitempty"`
	Entries       []MenuEntry     `yaml:"entries,omitempty"`
	ConfirmAction *MenuAction     `yaml:"confirm_action,omitempty"`
	CancelKey     string          `yaml:"cancel_key,omitempty"`
	CancelNextID  string          `yaml:"cancel_next_id,omitempty"`
	Provider      string          `yaml:"provider,omitempty"`
	ProviderParam string          `yaml:"provider_param,omitempty"`
	Map           map[string]Menu `yaml:"-"`
	// Checkbox functionality
	IsCheckboxMenu bool        `yaml:"is_checkbox_menu,omitempty"` // Marks this menu as supporting checkboxes
	ExecuteAction  *MenuAction `yaml:"execute_action,omitempty"`   // Action to run with selected checkboxes
	ExecuteKey     string      `yaml:"execute_key,omitempty"`      // Key to trigger execute action (defaults to 'e')
}

type MenuAction struct {
	Action  string                 `yaml:"action"`
	Target  string                 `yaml:"target,omitempty"`
	Command string                 `yaml:"command,omitempty"`
	NextID  string                 `yaml:"next_id,omitempty"`
	Params  map[string]interface{} `yaml:"params,omitempty"`
}

type MenuConfig struct {
	Menus []Menu `yaml:"menus"`
}

type MenuEntry struct {
	Key           string                 `yaml:"key"`
	Label         string                 `yaml:"label"`
	ID            string                 `yaml:"id,omitempty"` // Unique identifier for CLI auto-execution
	Action        string                 `yaml:"action"`
	Target        string                 `yaml:"target,omitempty"`
	Message       string                 `yaml:"message,omitempty"`
	Command       string                 `yaml:"command,omitempty"`
	NextID        string                 `yaml:"next_id,omitempty"`
	FilePath      string                 `yaml:"file_path,omitempty"`
	Params        map[string]interface{} `yaml:"params,omitempty"`
	IsDynamic     bool                   `yaml:"-"`
	KeyBind       string                 `yaml:"key_bind,omitempty"`
	IsInteractive bool                   `yaml:"is_interactive,omitempty"`
	// Checkbox functionality
	IsCheckbox    bool   `yaml:"is_checkbox,omitempty"`    // Marks this entry as a checkbox
	IsChecked     bool   `yaml:"-"`                        // Runtime state - not persisted in YAML
	CheckboxGroup string `yaml:"checkbox_group,omitempty"` // Group name for related checkboxes
}

type MenuEntryConfig struct {
	Key     string
	Label   string
	Action  string
	Command string
	Target  string
	Message string
	Params  map[string]interface{}
}

type MopsPlugin struct {
	// Impl Injection
	Impl Plugin
}

type MopsVersionConstraint struct {
	MinVersion string `yaml:"min_version"`
	MaxVersion string `yaml:"max_version"`
}

type NavMsg struct {
	Next          AppState
	NextID        string
	Data          any
	IsBack        bool
	Params        map[string]interface{}
	TitleOverride string
}

type ParameterDefinition struct {
	Name         string        // Parameter name (used for flag parsing, e.g., "profile")
	Description  string        // Human-readable description
	Type         ParameterType // Parameter data type
	Required     bool          // Whether parameter is required
	Default      string        // Default value if not provided
	Pattern      string        // Regex pattern for validation (optional)
	MinValue     *int          // Minimum value for numeric types (optional)
	MaxValue     *int          // Maximum value for numeric types (optional)
	Choices      []string      // Valid choices for the parameter (optional)
	ExampleValue string        // Custom example value for documentation (optional)
}

type ParameterType string

type PlatformInfo struct {
	OS         string // "linux", "darwin", "windows"
	Arch       string // "amd64", "arm64"
	Platform   string // "linux-amd64", "darwin-arm64", etc.
	BinaryExt  string // ".exe" on Windows, "" on Unix
	ArchiveExt string // Expected archive extension: ".tar.gz", ".zip"
	InstallDir string // Default installation directory
	InPath     bool   // Whether install directory is in PATH
}

type Plugin interface {
	GetInfo() PluginInfo
	Initialize(config map[string]any) error
	ReloadConfig(config map[string]any) error
	RegisterProviders() []DynamicProvider
	RegisterInteractiveFunctions() map[string]InteractiveGoFunction
	GetCLICommands() (map[string]CLICommandHandler, error)
	GetStreamingCLICommands() (map[string]StreamingCLICommandHandler, error)
	GetMenuEntries() (map[string][]MenuEntry, error)
	Cleanup() error
	ValidateConfig(config map[string]any) error
}

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

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

type PluginInfo struct {
	Name               string                  `json:"name"`
	Version            string                  `json:"version"`
	Description        string                  `json:"description"`
	DisplayName        string                  `json:"display_name,omitempty"` // Optional display name for UI
	Author             string                  `json:"author"`
	License            string                  `json:"license"`
	Homepage           string                  `json:"homepage"`
	MopsMinVersion     string                  `json:"mops_min_version"`
	MopsMaxVersion     string                  `json:"mops_max_version"`
	Dependencies       []string                `json:"dependencies"`
	Tags               []string                `json:"tags"`
	CLICommands        []CLICommandInfo        `json:"cli_commands"`
	DefaultConfig      map[string]any          `json:"default_config"`
	ConfigPresets      map[string]ConfigPreset `json:"config_presets,omitempty"`
	Platform           PlatformInfo            `json:"platform"`
	SupportedPlatforms []PlatformInfo          `json:"supported_platforms"`
	MenuIntegration    *PluginMenuIntegration  `json:"menu_integration,omitempty"`
}

type PluginInfoRPC struct {
	Name               string                 `json:"name"`
	Version            string                 `json:"version"`
	Description        string                 `json:"description"`
	DisplayName        string                 `json:"display_name,omitempty"` // Optional display name for UI
	Author             string                 `json:"author"`
	License            string                 `json:"license"`
	Homepage           string                 `json:"homepage"`
	MopsMinVersion     string                 `json:"mops_min_version"`
	MopsMaxVersion     string                 `json:"mops_max_version"`
	Dependencies       []string               `json:"dependencies"`
	Tags               []string               `json:"tags"`
	CLICommands        []CLICommandInfo       `json:"cli_commands"`
	DefaultConfigJSON  string                 `json:"default_config_json"` // JSON-encoded config to avoid GOB issues
	ConfigPresetsJSON  string                 `json:"config_presets_json"` // JSON-encoded presets to avoid GOB issues
	Platform           PlatformInfo           `json:"platform"`
	SupportedPlatforms []PlatformInfo         `json:"supported_platforms"`
	MenuIntegration    *PluginMenuIntegration `json:"menu_integration,omitempty"` // Menu integration config
}

type PluginMenuIntegration struct {
	AutoRegister bool   `yaml:"auto_register"` // Whether to automatically add to main menu
	MenuID       string `yaml:"menu_id"`       // Which menu to integrate with (default: "main")
	Key          string `yaml:"key"`           // Shortcut key for the menu entry
	Label        string `yaml:"label"`         // Display label for the menu entry
	Icon         string `yaml:"icon"`          // Optional icon/emoji for the menu entry
	Priority     int    `yaml:"priority"`      // Priority for ordering (lower = higher priority)
	Group        string `yaml:"group"`         // Optional grouping for organizing menu items
}

type PluginMetadata struct {
	Name               string                  `yaml:"name"`
	Version            string                  `yaml:"version"`
	Description        string                  `yaml:"description"`
	DisplayName        string                  `yaml:"display_name,omitempty"`
	Author             string                  `yaml:"author"`
	License            string                  `yaml:"license"`
	Homepage           string                  `yaml:"homepage"`
	Repository         string                  `yaml:"repository"`
	Category           string                  `yaml:"category"`
	Tags               []string                `yaml:"tags"`
	MinimumMopsVersion string                  `yaml:"minimum_mops_version"`
	MopsVersion        MopsVersionConstraint   `yaml:"mops_version"`
	BuildTargets       []BuildTarget           `yaml:"build_targets"`
	DefaultConfig      map[string]any          `yaml:"default_config"`
	ConfigPresets      map[string]ConfigPreset `yaml:"config_presets,omitempty"`
	CLICommands        []CLICommandInfo        `yaml:"cli_commands"`
	MenuIntegration    *PluginMenuIntegration  `yaml:"menu_integration,omitempty"`
}

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

type PluginRPCServer struct {
	Impl Plugin
}

type ProviderGenerateEntriesArgs struct {
	Name  string
	Param string
}

type Registry interface {
	RegisterProvider(provider DynamicProvider)
	GetProvider(name string) (DynamicProvider, bool)
	ListProviders() []string
}

type RepositoryPlugin struct {
	Name        string                           `json:"name"`
	Version     string                           `json:"version"`
	Description string                           `json:"description"`
	Author      string                           `json:"author"`
	License     string                           `json:"license"`
	Homepage    string                           `json:"homepage"`
	Repository  string                           `json:"repository"`
	Tags        []string                         `json:"tags"`
	MopsVersion MopsVersionConstraint            `json:"mops_version"`
	Platforms   map[string]RepositoryPluginAsset `json:"platforms"`
	Checksums   map[string]string                `json:"checksums"`
	LastUpdated time.Time                        `json:"last_updated"`
}

type RepositoryPluginAsset struct {
	Platform struct {
		OS   string `json:"os"`
		Arch string `json:"arch"`
	} `json:"platform"`
	DownloadURL string `json:"download_url"`
	Size        int64  `json:"size"`
	Checksum    string `json:"checksum"`
	Filename    string `json:"filename"`
}

type RepositoryRegistry struct {
	Repository struct {
		Name        string    `json:"name"`
		Description string    `json:"description"`
		URL         string    `json:"url"`
		LastUpdated time.Time `json:"last_updated"`
		Version     string    `json:"version"`
	} `json:"repository"`
	Plugins map[string]RepositoryPlugin `json:"plugins"`
}

type SelectionItem struct {
	Name        string                 // Item name/identifier
	Description string                 // Item description
	Icon        string                 // Item icon/emoji
	Title       string                 // Custom title for Bubble Tea UI (optional)
	Params      map[string]interface{} // Parameters to pass to the execute function
}

type ShellCommandEntry struct {
	Label       string // Display label for the menu entry
	Description string // Description/message for the entry
	Command     string // Shell command to execute
}

type SimplePluginConfig struct {
	Author               string                           // Plugin author
	DisplayName          string                           // Plugin display name
	AutoLoadPresets      bool                             // Whether to auto-load presets from plugin.yaml
	InteractiveFunctions map[string]InteractiveGoFunction // Interactive functions
	MenuEntries          []MenuEntry                      // Menu entries for UI
	CLIShortcuts         []CLIShortcut                    // CLI shortcuts for menu access
}

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

type SmartCLICommandConfig struct {
	// Command name
	Command string

	// Command description
	Description string

	// Usage string for help
	Usage string

	// Name of the smart selector function to register
	SmartFunctionName string

	// UI target menu to navigate to when no CLI arguments are provided (optional)
	UITarget string

	// UI title for Bubble Tea display when executed via CLI with arguments
	UITitle string

	// Direct CLI handler - called when the command is executed directly from CLI
	DirectHandler func(args []string) error

	// Direct executor for UI mode - called when CLI arguments are provided to the UI function
	DirectExecutor func(ctx context.Context, outputChan chan<- string, inputChan <-chan string, args []string) error

	// Interactive selector function - called when no CLI arguments are provided in UI mode
	InteractiveSelector func(ctx context.Context, outputChan chan<- string, inputChan <-chan string, params map[string]interface{}) error
}

type SmartSelectorConfig struct {
	// Direct execution function - called when CLI arguments are provided
	DirectExecutor func(ctx context.Context, outputChan chan<- string, inputChan <-chan string, args []string) error

	// Interactive selector function - called when no CLI arguments are provided
	InteractiveSelector func(ctx context.Context, outputChan chan<- string, inputChan <-chan string, params map[string]interface{}) error

	// Name of the command for error messages
	CommandName string

	// Usage string for help
	Usage string
}

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

type StreamingCLICommandHandler interface {
	// Execute runs the CLI command with given arguments (fallback method)
	Execute(ctx context.Context, args []string) error

	// GetHelp returns help information for the command
	GetHelp() string

	// ExecuteStreaming runs the CLI command with real-time output streaming
	// outputChan receives output lines as they are generated
	// The channel is closed when the command completes
	ExecuteStreaming(ctx context.Context, args []string, outputChan chan<- string) error

	// SupportsStreaming indicates if this command supports real-time streaming
	SupportsStreaming() bool
}

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

type SudoChecker struct{}

type SudoInfo struct {
	HasSudo           bool   // Whether sudo is available
	IsRoot            bool   // Whether running as root user
	CanSudoWithoutPwd bool   // Whether can sudo without password
	SudoPath          string // Path to sudo binary
	CurrentUser       string // Current username
	SudoTimeLeft      int    // Minutes left in sudo cache (if any)
	ErrorMessage      string // Error message if sudo check failed
}

type ToolChecker struct{}

type ToolInfo struct {
	Name      string // Tool name
	Path      string // Full path to the executable
	Version   string // Version string (if detectable)
	Installed bool   // Whether the tool is installed
}

type ToolInstallCommand struct {
	// Command to execute (can be a shell command, script path, or executable)
	Command string `yaml:"command"`
	// Arguments to pass to the command
	Args []string `yaml:"args,omitempty"`
	// Working directory for command execution
	WorkDir string `yaml:"work_dir,omitempty"`
	// Environment variables to set
	Env map[string]string `yaml:"env,omitempty"`
	// Whether this command requires sudo/elevated privileges
	RequiresSudo bool `yaml:"requires_sudo,omitempty"`
	// Whether to prime sudo cache before command execution (without running command as root)
	PrimeSudoCache bool `yaml:"prime_sudo_cache,omitempty"`
	// Shell to use for command execution (defaults to system shell)
	Shell string `yaml:"shell,omitempty"`
}

type ToolInstallConfig struct {
	// Tool name for display purposes
	ToolName string `yaml:"tool_name"`
	// Default version to install (optional, can be used by commands)
	Version string `yaml:"version,omitempty"`
	// Force update even if tool is already installed
	ForceUpdate bool `yaml:"force_update,omitempty"`
	// Platform-specific installation commands
	// Keys should be in format: "os-arch" (e.g., "linux-amd64", "darwin-arm64", "windows-amd64")
	InstallCommands map[string]ToolInstallCommand `yaml:"install_commands"`
	// Platform-specific version checking commands
	VersionCommands map[string]ToolVersionCommand `yaml:"version_commands,omitempty"`
	// Post-install verification command (optional)
	VerifyCommand *ToolInstallCommand `yaml:"verify_command,omitempty"`
}

type ToolInstallResult struct {
	Success            bool
	AlreadyInstalled   bool
	Version            string
	VersionRetrievable bool
	Error              error
	Platform           string
}

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

type ToolInstallerInterface interface {
	// InstallTool performs cross-platform tool installation using custom commands
	InstallTool(config *ToolInstallConfig) (*ToolInstallResult, error)
	// CheckToolStatus checks if a tool is installed and gets version information
	CheckToolStatus(config *ToolInstallConfig) (*ToolInstallResult, error)
	// GetCurrentPlatform returns the current platform string in "os-arch" format
	GetCurrentPlatform() string
	// GetSupportedPlatforms returns a list of commonly supported platforms
	GetSupportedPlatforms() []string
}

type ToolVersionCommand struct {
	// Command to check if tool is installed
	CheckCommand *ToolInstallCommand `yaml:"check_command,omitempty"`
	// Command to get current version
	VersionCommand *ToolInstallCommand `yaml:"version_command,omitempty"`
	// Whether version information is retrievable for this platform
	VersionRetrievable bool `yaml:"version_retrievable,omitempty"`
	// Custom version parser function (only available in Go code, not YAML)
	VersionParser func(string) string `yaml:"-"`
}

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

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

type ValidationError struct {
	Parameter string
	Message   string
}

type VersionCheckResult struct {
	CurrentVersion  string
	LatestVersion   string
	UpdateAvailable bool
	Comparison      int // -1: current < latest, 0: equal, 1: current > latest
	Error           error
}