types

type BuildOpts struct {
	// ExcludeBackend tells the builder to not build the plugin binary. This is useful
	// when we only have changes to UI components.
	ExcludeBackend bool

	// ExcludeUI tells the builder to not rebuild the plugin UI. This is useful
	// when we only have changes to the plugin binary.
	ExcludeUI bool

	// GoPath defines a predefined path to the Go binary
	GoPath string

	// PnpmPath defines a predefined path to the PNPM binary
	PnpmPath string

	// NodePath defines a predefined path to the Node binary
	NodePath string
}

type CapabilityDetector interface {
	DetectCapabilities() ([]string, error)
}

type ConnectedController interface {
	Controller

	// ListAllConnections returns a list of all connections for all plugins.
	ListAllConnections() (map[string][]types.Connection, error)

	// GetConnection returns a connection for a plugin by ID.
	GetConnection(pluginID, connectionID string) (types.Connection, error)

	// GetConnectionNamespaces returns a list of connection namespaces for a plugin.
	GetConnectionNamespaces(pluginID, connectionID string) ([]string, error)

	// ListPluginConnections returns a list of connections for the plugin.
	ListConnections(pluginID string) ([]types.Connection, error)

	// AddConnection adds a new connection for the plugin.
	AddConnection(pluginID string, connection types.Connection) error

	// UpdateConnection updates an existing connection for a plugin
	UpdateConnection(pluginID string, connection types.Connection) (types.Connection, error)

	// RemoveConnection removes a connection for a plugin
	RemoveConnection(pluginID, connectionID string) error

	// Run starts the controller, using the provided context to know when to stop
	Run(ctx context.Context)
}

type Controller interface {
	// OnPluginInit is called after the plugin is loaded in to do any pre-startup initialization.
	OnPluginInit(pluginID string, meta config.PluginMeta)

	// OnPluginStart is called when the plugin is started.
	OnPluginStart(pluginID string, meta config.PluginMeta, backend PluginBackend) error

	// OnPluginStop is called when the plugin is stopped. Modules should perform any persisting of state here
	OnPluginStop(pluginID string, meta config.PluginMeta) error

	// OnPluginShutdown is called when the plugin is shutdown. This is the last chance to clean up any resources
	// before the IDE is closed.
	OnPluginShutdown(pluginID string, meta config.PluginMeta) error

	// OnPluginDestroy is called when the plugin is being removed from the system. This is the last chance to
	// clean up any resources associated with the plugin before it is uninstalled.
	OnPluginDestroy(pluginID string, meta config.PluginMeta) error

	// ListPlugins returns a list of names of the plugins that are installed.
	ListPlugins() ([]string, error)

	// HasPlugin returns true if the plugin is registered with this controller.
	HasPlugin(pluginID string) bool
}

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

type InProcessBackend struct {

	// HealthFunc optionally overrides the default health check.
	// If nil, Healthy() returns !stopped.
	HealthFunc func() bool
	// contains filtered or unexported fields
}

type PluginBackend interface {
	// Dispense returns a capability client by name (e.g. "resource", "exec").
	Dispense(name string) (interface{}, error)

	// Healthy returns true if the plugin is alive and serving.
	Healthy() bool

	// Stop performs a graceful shutdown of the plugin.
	Stop() error

	// Kill forcefully terminates the plugin.
	Kill()

	// Exited returns true if the plugin process has exited.
	Exited() bool

	// NegotiatedVersion returns the SDK protocol version negotiated with this plugin.
	// For InProcessBackend, returns CurrentProtocolVersion.
	// For ExternalBackend, returns the go-plugin negotiated version.
	NegotiatedVersion() int
}

type PluginManager interface {
	// OnPluginInit is called after the plugin is loaded in to do any pre-startup initialization.
	OnPluginInit(ctx context.Context, pluginID string, meta config.PluginMeta) error

	// OnPluginStart is called when the plugin is started.
	OnPluginStart(ctx context.Context, pluginID string, meta config.PluginMeta) error

	// OnPluginStop is called when the plugin is stopped. Modules should perform any persisting of state here
	OnPluginStop(ctx context.Context, pluginID string, meta config.PluginMeta) error

	// OnPluginShutdown is called when the plugin is shutdown. This is the last chance to clean up any resources
	// before the IDE is closed.
	OnPluginShutdown(ctx context.Context, pluginID string, meta config.PluginMeta) error

	// OnPluginDestroy is called when the plugin is being removed from the system. This is the last chance to
	// clean up any resources associated with the plugin before it is uninstalled.
	OnPluginDestroy(ctx context.Context, pluginID string, meta config.PluginMeta) error
}

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

type PluginRecord struct {
	// Persisted fields.
	ID          string                `json:"id"`
	Phase       lifecycle.PluginPhase `json:"phase"`
	Metadata    config.PluginMeta     `json:"metadata"`
	Enabled     bool                  `json:"enabled"`
	DevMode     bool                  `json:"devMode"`
	DevPath     string                `json:"devPath,omitempty"`
	LastError   string                `json:"lastError,omitempty"`
	ErrorCount  int                   `json:"errorCount"`
	InstalledAt time.Time             `json:"installedAt"`

	// Runtime-only fields (not persisted).
	StateMachine    *lifecycle.PluginStateMachine `json:"-"`
	Backend         PluginBackend                 `json:"-"`
	Capabilities    []sdktypes.Capability         `json:"-"`
	ProtocolVersion int                           `json:"-"`
}

type PluginStateRecord struct {
	ID          string                `json:"id"`
	Phase       lifecycle.PluginPhase `json:"phase"`
	Metadata    config.PluginMeta     `json:"metadata"`
	Enabled     bool                  `json:"enabled"`
	DevMode     bool                  `json:"devMode"`
	DevPath     string                `json:"devPath,omitempty"`
	LastError   string                `json:"lastError,omitempty"`
	ErrorCount  int                   `json:"errorCount"`
	InstalledAt time.Time             `json:"installedAt"`
}