skills

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

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

type ClawHubModerationInfo struct {
	IsMalwareBlocked bool `json:"isMalwareBlocked"`
	IsSuspicious     bool `json:"isSuspicious"`
}

type ClawHubSearchResponse struct {
	Results []ClawHubSearchResult `json:"results"`
}

type ClawHubSearchResult struct {
	Score       float64 `json:"score"`
	Slug        string  `json:"slug"`
	DisplayName string  `json:"displayName"`
	Summary     string  `json:"summary"`
	Version     string  `json:"version"`
}

type ClawHubSearchResultLegacy struct {
	Skills []ClawHubSkill `json:"skills"`
	Total  int            `json:"total"`
}

type ClawHubSkill struct {
	Slug        string   `json:"slug"`
	Name        string   `json:"name"`
	Description string   `json:"description"`
	Author      string   `json:"author"`
	Version     string   `json:"version"`
	Downloads   int      `json:"downloads"`
	Stars       int      `json:"stars"`
	Tags        []string `json:"tags"`
	Category    string   `json:"category"`
	Homepage    string   `json:"homepage"`
	CreatedAt   string   `json:"createdAt"`
	UpdatedAt   string   `json:"updatedAt"`
}

type ClawHubSkillMeta struct {
	Slug          string                 `json:"slug"`
	DisplayName   string                 `json:"displayName"`
	Summary       string                 `json:"summary"`
	LatestVersion *ClawHubVersionInfo    `json:"latestVersion"`
	Moderation    *ClawHubModerationInfo `json:"moderation"`
	Author        string                 `json:"author"`
	Tags          []string               `json:"tags"`
	Category      string                 `json:"category"`
	Downloads     int                    `json:"downloads"`
	Stars         int                    `json:"stars"`
	Homepage      string                 `json:"homepage"`
	CreatedAt     string                 `json:"createdAt"`
	UpdatedAt     string                 `json:"updatedAt"`
}

type ClawHubVersionInfo struct {
	Version string `json:"version"`
}

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

type ClawdHubSkillDef struct {
	Name        string                 `yaml:"name"`
	Description string                 `yaml:"description"`
	Homepage    string                 `yaml:"homepage"`
	Metadata    map[string]interface{} `yaml:"metadata"`

	// Parsed from metadata.openclaw
	OpenClaw *OpenClawMeta

	// ConfigRequirements are the configuration/credentials needed.
	// Parsed from metadata.config or metadata.openclaw.config
	ConfigRequirements []ConfigRequirement

	// Body is the markdown content after frontmatter (instructions).
	Body string

	// Dir is the absolute path to the skill directory.
	Dir string
}

type ConfigRequirement struct {
	// Key é a chave usada para armazenar no vault (ex: "SLACK_BOT_TOKEN").
	Key string `yaml:"key"`

	// Name é o nome amigável para mostrar ao usuário (ex: "Slack Bot Token").
	Name string `yaml:"name"`

	// Description explica o que é e como obter essa configuração.
	Description string `yaml:"description"`

	// Pattern é um padrão opcional para validação (ex: "xoxb-*" para tokens Slack).
	Pattern string `yaml:"pattern,omitempty"`

	// Example mostra um exemplo de valor válido (ex: "xoxb-1234567890-1234567890-AbCdEf").
	Example string `yaml:"example,omitempty"`

	// Secret indica se o valor deve ser tratado como segredo (ocultar em logs).
	Secret bool `yaml:"secret"`

	// Required indica se é obrigatório. Se false, a skill pode funcionar sem ele.
	Required bool `yaml:"required"`

	// EnvVar é a variável de ambiente alternativa (ex: "SLACK_BOT_TOKEN").
	EnvVar string `yaml:"env_var,omitempty"`
}

type DefaultSkill struct {
	Name        string // Unique identifier (directory name).
	Label       string // Human-readable label for interactive selection.
	Description string // Short description.
	Category    string // Category: "development", "data", "productivity", "infra".
	StarterPack bool   // If true, pre-selected during setup wizard.
	Content     string // Full SKILL.md file content.
}

type Index struct {
	ByCategory map[string][]string
	ByTag      map[string][]string
	ByAuthor   map[string][]string
}

type InstallResult struct {
	Name    string // skill name (directory name)
	Source  string // where it came from
	Path    string // full path to the installed skill
	IsNew   bool   // true if newly installed, false if updated
	Version string // version if known
}

type InstallSpec struct {
	ID      string   `json:"id"`
	Kind    string   `json:"kind"` // brew, apt, node, go, uv, download
	Formula string   `json:"formula"`
	Package string   `json:"package"`
	Bins    []string `json:"bins"`
	Label   string   `json:"label"`
	OS      []string `json:"os"`
}

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

type Metadata struct {
	// Name é o identificador único da skill (ex: "calendar", "github").
	Name string `yaml:"name"`

	// Version é a versão semântica da skill (ex: "1.0.0").
	Version string `yaml:"version"`

	// Author é o autor ou organização que criou a skill.
	Author string `yaml:"author"`

	// Description é uma breve descrição do que a skill faz.
	Description string `yaml:"description"`

	// Category é a categoria da skill (ex: "productivity", "development").
	Category string `yaml:"category"`

	// Tags são palavras-chave para busca e indexação.
	Tags []string `yaml:"tags"`
}

type OpenClawMeta struct {
	Emoji    string              `json:"emoji"`
	Always   bool                `json:"always"`
	OS       []string            `json:"os"`
	Requires OpenClawRequire     `json:"requires"`
	Install  []InstallSpec       `json:"install"`
	Config   []ConfigRequirement `json:"config"` // Required configuration
}

type OpenClawRequire struct {
	Bins    []string `json:"bins"`
	AnyBins []string `json:"anyBins"`
	Env     []string `json:"env"`
	Config  []string `json:"config"`
}

type ProjectInfo struct {
	ID            string `yaml:"id"`
	Name          string `yaml:"name"`
	RootPath      string `yaml:"root_path"`
	Language      string `yaml:"language"`
	Framework     string `yaml:"framework"`
	GitRemote     string `yaml:"git_remote,omitempty"`
	BuildCmd      string `yaml:"build_cmd,omitempty"`
	TestCmd       string `yaml:"test_cmd,omitempty"`
	LintCmd       string `yaml:"lint_cmd,omitempty"`
	StartCmd      string `yaml:"start_cmd,omitempty"`
	DeployCmd     string `yaml:"deploy_cmd,omitempty"`
	DockerCompose string `yaml:"docker_compose,omitempty"`
}

type ProjectProvider interface {
	// Register adds or updates a project.
	Register(p *ProjectInfo) error
	// Remove removes a project by ID.
	Remove(id string) error
	// Get returns a project by ID.
	Get(id string) *ProjectInfo
	// List returns all registered projects.
	List() []*ProjectInfo
	// Activate sets the active project for a session.
	Activate(sessionKey, projectID string) error
	// ActiveProject returns the active project for a session.
	ActiveProject(sessionKey string) *ProjectInfo
	// ScanDirectory scans for projects in a directory.
	ScanDirectory(root string) ([]*ProjectInfo, error)
}

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

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

type SetupStatus struct {
	// IsComplete indica se todas as configurações obrigatórias estão presentes.
	IsComplete bool

	// MissingRequirements são as configurações que faltam.
	MissingRequirements []ConfigRequirement

	// OptionalMissing são configurações opcionais que não foram definidas.
	OptionalMissing []ConfigRequirement

	// Message é uma mensagem amigável sobre o estado do setup.
	Message string
}

type Skill interface {
	// Metadata retorna os metadados da skill (nome, versão, autor, etc).
	Metadata() Metadata

	// Tools retorna as funções/ferramentas que a skill expõe ao agente LLM.
	Tools() []Tool

	// SystemPrompt retorna instruções adicionais a serem injetadas no prompt do sistema
	// quando a skill está ativa. Pode retornar string vazia se não necessário.
	SystemPrompt() string

	// Triggers retorna padrões de linguagem natural que ativam esta skill.
	// Usado para ativação automática baseada no conteúdo da mensagem.
	Triggers() []string

	// Init inicializa a skill com a configuração fornecida.
	// Chamado uma vez durante o startup.
	Init(ctx context.Context, config map[string]any) error

	// Execute executa a skill com o input fornecido e retorna o resultado.
	Execute(ctx context.Context, input string) (string, error)

	// Shutdown libera recursos da skill de forma graciosa.
	Shutdown() error
}

type SkillLoader interface {
	// Load carrega e retorna skills a partir da fonte configurada.
	Load(ctx context.Context) ([]Skill, error)

	// Source retorna o identificador da fonte (ex: "builtin", "filesystem", "registry").
	Source() string
}

type SkillScript struct {
	Name    string
	Path    string
	Runtime sandbox.Runtime
}

type SkillSetupChecker interface {
	// RequiredConfig retorna as configurações obrigatórias e opcionais.
	RequiredConfig() []ConfigRequirement

	// CheckSetup verifica se a skill está corretamente configurada.
	// Recebe um VaultReader para verificar credenciais armazenadas.
	CheckSetup(vault VaultReader) SetupStatus
}

type Tool struct {
	// Name é o identificador da ferramenta (ex: "list_events").
	Name string `json:"name"`

	// Description descreve o que a ferramenta faz (usado no prompt do LLM).
	Description string `json:"description"`

	// Parameters define os parâmetros aceitos pela ferramenta.
	Parameters []ToolParameter `json:"parameters"`

	// Handler é a função que executa a ferramenta.
	Handler ToolHandler `json:"-"`
}

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

type ToolParameter struct {
	// Name é o nome do parâmetro.
	Name string `json:"name"`

	// Type é o tipo do parâmetro (string, integer, boolean, etc).
	Type string `json:"type"`

	// Description descreve o parâmetro.
	Description string `json:"description"`

	// Required indica se o parâmetro é obrigatório.
	Required bool `json:"required"`

	// Default é o valor padrão, se houver.
	Default any `json:"default,omitempty"`
}

type VaultReader interface {
	// Get retorna o valor armazenado para a chave, ou erro se não existir.
	Get(key string) (string, error)
	// Has retorna true se a chave existe no vault.
	Has(key string) bool
}