spells

type AppliedSpell struct {
	// SpellName is the name of the spell that was applied
	SpellName string

	// SystemPrompt is the final system prompt after applying mode logic
	SystemPrompt string

	// Tool configuration
	EnabledTools  []string
	DisabledTools []string

	// Response configuration
	MaxTokens      int
	ResponseFormat string
	ResponseStyle  string

	// Reasoning configuration
	ReasoningEffort ReasoningEffort
	ShowThinking    bool

	// Sampling configuration
	Temperature float64
}

type LayerMode string

type Loader struct {
	UserDir     string // User-global spells directory (~/.hex/spells/)
	ProjectDir  string // Project-local spells directory (.hex/spells/)
	BuiltinDir  string // Built-in spells directory (deprecated, use BuiltinFS)
	BuiltinFSys fs.FS  // Embedded filesystem for builtin spells
}

type ReasoningConfig struct {
	Effort       ReasoningEffort `yaml:"effort,omitempty"`        // none, low, medium, high
	ShowThinking bool            `yaml:"show_thinking,omitempty"` // expose thinking blocks
}

type ReasoningEffort string

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

type ResponseConfig struct {
	MaxTokens int    `yaml:"max_tokens,omitempty"` // max response tokens
	Format    string `yaml:"format,omitempty"`     // text, json, markdown
	Style     string `yaml:"style,omitempty"`      // concise, detailed, code-first
}

type SamplingConfig struct {
	Temperature float64 `yaml:"temperature,omitempty"`
}

type Spell struct {
	// Metadata from system.md frontmatter
	Name        string `yaml:"name"`
	Description string `yaml:"description"`
	Author      string `yaml:"author,omitempty"`
	Version     string `yaml:"version,omitempty"`

	// System prompt content (body of system.md)
	SystemPrompt string `yaml:"-"`

	// Configuration from config.yaml
	Config SpellConfig `yaml:"-"`

	// Tool overrides from tools/*.yaml
	ToolOverrides map[string]ToolOverride `yaml:"-"`

	// Runtime metadata
	Mode     LayerMode `yaml:"-"` // Effective mode (from config or override)
	Source   string    `yaml:"-"` // builtin, user, project
	FilePath string    `yaml:"-"` // Path to spell directory
}

type SpellConfig struct {
	Mode      LayerMode       `yaml:"mode,omitempty"`
	Tools     ToolsConfig     `yaml:"tools,omitempty"`
	Reasoning ReasoningConfig `yaml:"reasoning,omitempty"`
	Response  ResponseConfig  `yaml:"response,omitempty"`
	Sampling  SamplingConfig  `yaml:"sampling,omitempty"`
}

type ToolOverride struct {
	Schema       map[string]interface{} `yaml:"schema,omitempty"`
	Defaults     map[string]interface{} `yaml:"defaults,omitempty"`
	Restrictions []string               `yaml:"restrictions,omitempty"`
}

type ToolsConfig struct {
	Enabled  []string `yaml:"enabled,omitempty"`  // Tools to enable (empty = all)
	Disabled []string `yaml:"disabled,omitempty"` // Tools to disable
}