plugins

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

type Behavior struct {
	Name     string         `yaml:"name"`
	Trigger  map[string]any `yaml:"trigger"`
	Workflow string         `yaml:"workflow,omitempty"`
}

type Capability struct {
	Name         string
	Description  string
	Type         string   // "skill", "agent", "workflow", "action"
	CallableFrom string   // "model", "direct", "both"
	Body         string   // raw markdown body (content after frontmatter); empty for YAML capabilities
	Model        string   // optional model override for agent capabilities ("sonnet", "opus", "haiku")
	Tools        []string // per-capability tool allow-list (agent capabilities only)

	// Action-specific fields (populated for type: action from .yaml capability files)
	Run    string              // path to shell script relative to extension dir
	Params map[string]ParamDef // parameter schema for input validation and MCP tool generation
}

type CapabilityMeta struct {
	CallableFrom string `yaml:"callable_from"`
}

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

type DispatcherSlashCommandInfo struct {
	Command     string
	Description string
}

type Event struct {
	// Topic is the canonical event name: "<ext>:<cap>:<phase>" (e.g. "bud-core:fetch:after").
	Topic   string
	Payload map[string]any
}

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

type EventHandler func(e Event)

type MCPServerDef struct {
	Command string            `yaml:"command"`
	Args    []string          `yaml:"args,omitempty"`
	Env     map[string]string `yaml:"env,omitempty"`
}

type Manifest struct {
	Name         string                    `yaml:"name"`
	Version      string                    `yaml:"version,omitempty"`
	Description  string                    `yaml:"description"`
	Author       string                    `yaml:"author,omitempty"`
	Capabilities map[string]CapabilityMeta `yaml:"capabilities,omitempty"`
	Behaviors    []Behavior                `yaml:"behaviors,omitempty"`
	Lifecycle    map[string]string         `yaml:"lifecycle,omitempty"`
	Requires     Requirements              `yaml:"requires,omitempty"`
	MCPServers   map[string]MCPServerDef   `yaml:"mcp_servers,omitempty"`
	// Settings is a flat map from setting key to its JSON Schema subset node.
	// Treat this as the "properties" of an implicit root object schema.
	Settings map[string]SchemaNode `yaml:"settings,omitempty"`
	// SettingsRequired lists which top-level settings keys are required.
	// Missing required settings emit a warning on load, but never hard-fail.
	SettingsRequired []string `yaml:"settings_required,omitempty"`
}

type OnResultConfig struct {
	// Parse pre-processes the workflow result before evaluation.
	// Supported: "json" (extract JSON from the result string).
	Parse string `yaml:"parse,omitempty"`

	// Condition is an expr-lang expression evaluated against the (possibly parsed) result.
	// The handler fires only when the condition is true or when Condition is empty.
	Condition string `yaml:"condition,omitempty"`

	// Action determines what to do when the handler fires.
	// "notify" → talk_to_user, "log" → save_thought, "invoke" → run a workflow.
	Action string `yaml:"action"`

	// Message is the notification message for action=notify. Supports {{var}} templates.
	Message string `yaml:"message,omitempty"`

	// Workflow is the workflow name for action=invoke. Supports {{var}} templates.
	Workflow string `yaml:"workflow,omitempty"`

	// Params are passed to the invoked workflow. Values support {{var}} templates.
	Params map[string]any `yaml:"params,omitempty"`
}

type ParamDef struct {
	Type        string `yaml:"type,omitempty"`        // "string", "integer", "boolean", "number"
	Description string `yaml:"description,omitempty"` // human-readable description
	Required    bool   `yaml:"required,omitempty"`    // whether the parameter must be supplied
	Default     any    `yaml:"default,omitempty"`     // value applied when param is absent
	Enum        []any  `yaml:"enum,omitempty"`        // allowed values
}

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

type PatternMatcher interface {
	// MatchAndRun attempts to match content against the named reflex (by name) and execute it.
	// Returns (matched, error).
	MatchAndRun(ctx context.Context, name string, source, typ, content string, data map[string]any) (bool, error)
}

type Plugin struct {
	Manifest     Manifest
	Dir          string
	Capabilities map[string]*Capability
	Settings     map[string]any // current settings (loaded + schema defaults applied)
	State        map[string]any // current state
	// contains filtered or unexported fields
}

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

type Requirements struct {
	// Plugins lists required plugin names. LoadAll topologically sorts
	// based on this field and rejects cycles.
	Plugins    []string `yaml:"plugins,omitempty"`
	Tools      []string `yaml:"tools,omitempty"`
	MCPServers []string `yaml:"mcp_servers,omitempty"`
}

type SaveThought interface {
	Log(message string) error
}

type SchemaNode struct {
	Type        string `yaml:"type,omitempty"`
	Description string `yaml:"description,omitempty"`
	Default     any    `yaml:"default,omitempty"`
	// Required lists required property names within an object-type SchemaNode.
	Required   []string              `yaml:"required,omitempty"`
	Enum       []any                 `yaml:"enum,omitempty"`
	Minimum    *float64              `yaml:"minimum,omitempty"`
	Maximum    *float64              `yaml:"maximum,omitempty"`
	MinLength  *int                  `yaml:"minLength,omitempty"`
	MaxLength  *int                  `yaml:"maxLength,omitempty"`
	Pattern    string                `yaml:"pattern,omitempty"`
	Items      *SchemaNode           `yaml:"items,omitempty"`
	Properties map[string]SchemaNode `yaml:"properties,omitempty"`
	// Unknown captures any YAML keys not listed above for warning purposes.
	Unknown map[string]any `yaml:",inline"`
}

type TalkToUser interface {
	Notify(message string) error
}

type WorkflowRunner interface {
	RunWorkflow(ctx context.Context, name string, params map[string]any) (any, error)
}