skills

type EmbeddingProvider interface {
	// Embed returns embedding vectors for the given texts.
	// Each text produces one vector. All vectors must have the same dimensionality.
	Embed(ctx context.Context, texts []string) ([][]float64, error)
}

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

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

type ExecutorConfig struct {
	Registry  *Registry
	Selector  SkillSelector // nil = ModelDrivenSelector
	PackTools []string      // all tools declared in the pack
	MaxActive int           // 0 = unlimited
}

type InstalledSkill struct {
	Org      string // e.g., "anthropic"
	Name     string // e.g., "pdf-processing"
	Location string // "user" or "project"
	Path     string // filesystem path to the skill directory
}

type Installer struct {
	UserDir      string                       // ~/.config/promptkit/skills/
	ProjectDir   string                       // .promptkit/skills/
	GitCloneFunc func(url, dest string) error // injectable for testing
	GitCheckout  func(dir, ref string) error  // injectable for testing
	CopyDirFunc  func(src, dest string) error // injectable for testing
}

type ModelDrivenSelector struct{}

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

type Skill struct {
	SkillMetadata
	Instructions string `json:"instructions"` // Markdown body from SKILL.md
	Path         string `json:"path"`         // Filesystem path to skill directory
}

type SkillMetadata struct {
	Name          string            `yaml:"name" json:"name"`
	Description   string            `yaml:"description" json:"description"`
	License       string            `yaml:"license,omitempty" json:"license,omitempty"`
	Compatibility string            `yaml:"compatibility,omitempty" json:"compatibility,omitempty"`
	Metadata      map[string]string `yaml:"metadata,omitempty" json:"metadata,omitempty"`
	AllowedTools  []string          `yaml:"allowed-tools,omitempty" json:"allowed_tools,omitempty"`
}

type SkillRef struct {
	Org     string // e.g., "anthropic"
	Name    string // e.g., "pdf-processing"
	Version string // e.g., "v1.0.0" (empty = latest)
}

type SkillSelector interface {
	// Select returns the names of skills that should appear in the Phase 1 index.
	// The query is typically the latest user message or conversation context.
	// Available contains all skills that passed directory filtering for the current state.
	Select(ctx context.Context, query string, available []SkillMetadata) ([]string, error)
}

type SkillSource struct {
	// For directory-based skills
	Dir  string `yaml:"dir,omitempty" json:"dir,omitempty"`
	Path string `yaml:"path,omitempty" json:"path,omitempty"` // schema alias for dir

	// For inline skills
	Name         string `yaml:"name,omitempty" json:"name,omitempty"`
	Description  string `yaml:"description,omitempty" json:"description,omitempty"`
	Instructions string `yaml:"instructions,omitempty" json:"instructions,omitempty"`

	// Options
	Preload bool `yaml:"preload,omitempty" json:"preload,omitempty"`
}

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

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