plugins

Mar 23, 2026

Changes in this version

+ func ResolveConfig(schema *PluginConfigSchema, overrides map[string]any, vault VaultReader) (map[string]any, error)

+ func ValidateConfig(schema *PluginConfigSchema, resolved map[string]any) error

+ type AgentDef struct

+ Channels []string

+ Description string

+ Escalation *EscalationConfig

+ ID string

+ Instructions string

+ MaxTurns int

+ Model string

+ Name string

+ SessionMode string

+ TimeoutSec int

+ Tools AgentToolProfile

+ Triggers []string

+ type AgentRegistrar interface

+ AddProfile func(p any)

+ type AgentToolProfile struct

+ Allow []string

+ Deny []string

+ type ChannelDef struct

+ Handler string

+ Name string

+ type ChannelRegistrar interface

+ Register func(ch any) error

+ type EscalationConfig struct

+ Enabled bool

+ ExplicitOnly bool

+ Keywords []string

+ MaxTurns int

+ OnFailure string

+ type FollowupEnqueuer interface

+ Enqueue func(sessionID, content, channel, chatID string)

+ type HookDef struct

+ Description string

+ Events []string

+ Handler string

+ Name string

+ Priority int

+ Script string

+ type HookRegistrar interface

+ RegisterPluginHook func(pluginID string, events []string, priority int, ...) error

type Loader

+ func (l *Loader) Discover() ([]*PluginInstance, error)

+ func (l *Loader) Get(id string) *PluginInstance

+ type ManifestProvider struct

+ func NewManifestProvider(m *PluginManifest, dir string) *ManifestProvider

+ func (p *ManifestProvider) Agents() []AgentDef

+ func (p *ManifestProvider) Channels() []ChannelDef

+ func (p *ManifestProvider) ConfigSchema() *PluginConfigSchema

+ func (p *ManifestProvider) Hooks() []HookDef

+ func (p *ManifestProvider) ID() string

+ func (p *ManifestProvider) Init(ctx context.Context, config map[string]any) error

+ func (p *ManifestProvider) Metadata() PluginMetadata

+ func (p *ManifestProvider) Services() []ServiceDef

+ func (p *ManifestProvider) SetInitFunc(fn func(ctx context.Context, config map[string]any) error)

+ func (p *ManifestProvider) SetShutdownFunc(fn func() error)

+ func (p *ManifestProvider) Shutdown() error

+ func (p *ManifestProvider) Skills() []SkillDef

+ func (p *ManifestProvider) Tools() []ToolDef

+ func (p *ManifestProvider) UIConfig() *PluginUIConfig

+ type PluginAgentSummary struct

+ AgentID string

+ Description string

+ Name string

+ PluginID string

+ Triggers []string

+ type PluginConfigField struct

+ Default any

+ Description string

+ EnvVar string

+ Key string

+ Name string

+ Required bool

+ Type string

+ VaultKey string

+ type PluginConfigSchema struct

+ Fields []PluginConfigField

+ type PluginInfo struct

+ Agents []string

+ Author string

+ Channels []string

+ ConfigSchema *PluginConfigSchema

+ ConfigValues map[string]any

+ Description string

+ Dir string

+ Enabled bool

+ ErrorMsg string

+ Hooks []string

+ ID string

+ LoadedAt time.Time

+ Name string

+ Skills []string

+ StartedAt time.Time

+ State PluginState

+ Tools []string

+ UI *PluginUIConfig

+ Version string

+ type PluginInstallResult struct

+ ID string

+ IsNew bool

+ Name string

+ Path string

+ Source string

+ Version string

+ type PluginInstaller struct

+ func NewPluginInstaller(pluginsDir string, logger *slog.Logger) *PluginInstaller

+ func (inst *PluginInstaller) Install(ctx context.Context, source string) (*PluginInstallResult, error)

+ func (inst *PluginInstaller) Remove(name string) error

+ type PluginInstance struct

+ Config map[string]any

+ Dir string

+ Enabled bool

+ ErrorMsg string

+ LoadedAt time.Time

+ Manifest *PluginManifest

+ Provider PluginProvider

+ RegisteredAgents []string

+ RegisteredChannels []string

+ RegisteredHooks []string

+ RegisteredSkills []string

+ RegisteredTools []string

+ StartedAt time.Time

+ State PluginState

+ func (pi *PluginInstance) Info() PluginInfo

+ type PluginManifest struct

+ Agents []AgentDef

+ Author string

+ Channels []ChannelDef

+ Config *PluginConfigSchema

+ Description string

+ Hooks []HookDef

+ ID string

+ License string

+ MinDevclaw string

+ Name string

+ NativeLib string

+ Requires *PluginRequirements

+ Services []ServiceDef

+ Skills []SkillDef

+ Tools []ToolDef

+ UI *PluginUIConfig

+ Version string

+ func ParseManifest(path string) (*PluginManifest, error)

+ type PluginMetadata struct

+ Author string

+ Description string

+ License string

+ Name string

+ Version string

+ type PluginProvider interface

+ Agents func() []AgentDef

+ Channels func() []ChannelDef

+ ConfigSchema func() *PluginConfigSchema

+ Hooks func() []HookDef

+ ID func() string

+ Init func(ctx context.Context, config map[string]any) error

+ Metadata func() PluginMetadata

+ Services func() []ServiceDef

+ Shutdown func() error

+ Skills func() []SkillDef

+ Tools func() []ToolDef

+ UIConfig func() *PluginUIConfig

+ type PluginRequirements struct

+ AnyBins []string

+ Bins []string

+ Env []string

+ OS []string

+ func (r *PluginRequirements) IsEligible() bool

+ type PluginState string

+ const StateDiscovered

+ const StateError

+ const StateLoaded

+ const StateRegistered

+ const StateStarted

+ const StateStopped

+ type PluginUIConfig struct

+ Actions []UIAction

+ Category string

+ Color string

+ Icon string

+ Sections []UISection

+ type PluginsConfig struct

+ Dir string

+ Dirs []string

+ Disabled []string

+ Enabled []string

+ Overrides map[string]map[string]any

+ func (c PluginsConfig) EffectiveDirs() []string

+ type Registry struct

+ func NewRegistry(logger *slog.Logger) *Registry

+ func (r *Registry) AddLoadedPlugins(loader *Loader)

+ func (r *Registry) ConfigurePlugin(id string, updates map[string]any) error

+ func (r *Registry) Disable(id string) error

+ func (r *Registry) Enable(id string) error

+ func (r *Registry) Get(id string) *PluginInstance

+ func (r *Registry) GetResolvedAgent(pluginID, agentID string) *resolvedAgent

+ func (r *Registry) HasPlugins() bool

+ func (r *Registry) List() []PluginInfo

+ func (r *Registry) ListAgentSummaries() []PluginAgentSummary

+ func (r *Registry) MatchTrigger(content, channel string) *TriggerMatch

+ func (r *Registry) RegisterAll() error

+ func (r *Registry) SendToMainAgent(parentSessionID string, agent *resolvedAgent, reason, summary string)

+ func (r *Registry) SetAgentRegistrar(ar AgentRegistrar)

+ func (r *Registry) SetChannelRegistrar(cr ChannelRegistrar)

+ func (r *Registry) SetFollowupEnqueuer(fe FollowupEnqueuer)

+ func (r *Registry) SetHookRegistrar(hr HookRegistrar)

+ func (r *Registry) SetSkillRegistrar(sr SkillRegistrar)

+ func (r *Registry) SetToolRegistrar(tr ToolRegistrar)

+ func (r *Registry) StartAll(ctx context.Context) error

+ func (r *Registry) StopAll()

+ type ServiceDef struct

+ Description string

+ Handler string

+ ID string

+ Method string

+ Name string

+ Path string

+ type SkillDef struct

+ Description string

+ Name string

+ SkillMD string

+ type SkillRegistrar interface

+ Register func(name, description, skillMDPath string) error

+ type SubagentSpawner interface

+ SpawnPluginAgent func(ctx context.Context, executor any, llmClient any, prompt, task string, ...) (string, error)

+ type ToolDef struct

+ Description string

+ Endpoint string

+ Handler string

+ Headers map[string]string

+ Hidden bool

+ Method string

+ Name string

+ Parameters map[string]any

+ Permission string

+ Script string

+ type ToolHandlerFunc func(ctx context.Context, args map[string]any) (any, error)

+ func BuildToolHandler(def ToolDef, instance *PluginInstance) (ToolHandlerFunc, error)

+ type ToolRegistrar interface

+ RegisterPluginTool func(reg ToolRegistration)

+ UnregisterTool func(name string) bool

+ type ToolRegistration struct

+ Description string

+ Handler func(ctx context.Context, args map[string]any) (any, error)

+ Hidden bool

+ Name string

+ Parameters json.RawMessage

+ Permission string

+ type TriggerMatch struct

+ AgentID string

+ PluginID string

+ Score float64

+ type UIAction struct

+ Confirm bool

+ Description string

+ Icon string

+ Label string

+ Tool string

+ type UISection struct

+ Collapsible bool

+ Description string

+ Fields []string

+ Title string

+ type VaultReader interface

+ Get func(key string) (string, error)

+ Has func(key string) bool

Feb 20, 2026

Changes in this version

+ type Config struct

+ Dir string

+ Disabled []string

+ Enabled []string

+ type LoadedPlugin struct

+ Channel channels.Channel

+ Name string

+ Path string

+ Plugin Plugin

+ Raw *plugin.Plugin

+ type Loader struct

+ func NewLoader(cfg Config, logger *slog.Logger) *Loader

+ func (l *Loader) All() []*LoadedPlugin

+ func (l *Loader) Channels() []channels.Channel

+ func (l *Loader) Count() int

+ func (l *Loader) LoadAll(ctx context.Context) error

+ func (l *Loader) Plugins() []Plugin

+ func (l *Loader) RegisterChannels(mgr *channels.Manager) error

+ func (l *Loader) Shutdown()

+ type Plugin interface

+ Init func(ctx context.Context, config map[string]any) error

+ Name func() string

+ Shutdown func() error

+ Version func() string