skills

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

type CatalogEntry struct {
	Name          string   `yaml:"-"`
	Label         string   `yaml:"label"`
	LabelPT       string   `yaml:"label_pt"`
	Path          string   `yaml:"path"`
	Version       string   `yaml:"version"`
	Category      string   `yaml:"category"`
	Tags          []string `yaml:"tags"`
	Description   string   `yaml:"description"`
	DescriptionPT string   `yaml:"description_pt"`
	ClawHubURL    string   `yaml:"clawhub_url"`
}

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 CommandRouter struct {
	// contains filtered or unexported fields
}

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"`

	// Requires declares runtime eligibility requirements. Skills that don't
	// meet these requirements are excluded from the prompt to avoid confusing
	// the LLM with unavailable capabilities.
	Requires SkillRequirements `yaml:"requires" json:"requires,omitempty"`

	// SourceTier indicates the load priority tier of this skill.
	// Higher tiers override lower tiers with the same name.
	SourceTier SourceTier `yaml:"-" json:"-"`
}

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 ScanFinding struct {
	File     string       `json:"file"`
	Line     int          `json:"line"`
	Severity ScanSeverity `json:"severity"`
	Rule     string       `json:"rule"`
	Match    string       `json:"match"`
}

type ScanResult struct {
	Findings []ScanFinding `json:"findings"`
	Scanned  int           `json:"scanned"`
	Duration time.Duration `json:"duration"`
}

type ScanSeverity string

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

type SecurityScanner 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)

	// Location retorna o caminho absoluto do SKILL.md para skills baseadas em arquivo.
	// Retorna "" para skills built-in (que não possuem arquivo SKILL.md).
	// Usado pelo modelo de referência: a LLM lê o SKILL.md sob demanda via read_file.
	Location() string

	// 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 SkillRequirements struct {
	// Bins lists binaries that must ALL exist in PATH.
	Bins []string `yaml:"bins" json:"bins,omitempty"`

	// AnyBins lists binaries where at least one must exist in PATH.
	AnyBins []string `yaml:"any_bins" json:"anyBins,omitempty"`

	// Env lists environment variables that must all be set (non-empty).
	Env []string `yaml:"env" json:"env,omitempty"`

	// OS lists compatible operating systems (runtime.GOOS values).
	// Empty means all OSes are supported.
	OS []string `yaml:"os" json:"os,omitempty"`
}

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 SkillsLimitsConfig struct {
	// MaxCandidatesPerRoot is the maximum skills scanned per workspace root (default: 300).
	MaxCandidatesPerRoot int `yaml:"max_candidates_per_root"`
	// MaxSkillsInPrompt is the maximum skills included in the system prompt (default: 150).
	MaxSkillsInPrompt int `yaml:"max_skills_in_prompt"`
	// MaxSkillsPromptChars is the total character budget for skills in the prompt (default: 30000).
	MaxSkillsPromptChars int `yaml:"max_skills_prompt_chars"`
	// MaxSkillFileBytes is the maximum size of a single skill file (default: 256000).
	MaxSkillFileBytes int `yaml:"max_skill_file_bytes"`
}

type SlashCommandFlags struct {
	// UserInvocable means the command can only be triggered by the user
	// typing /command, not by the LLM calling it autonomously.
	UserInvocable bool `yaml:"user_invocable"`

	// DisableModelInvocation prevents the LLM from calling this skill's
	// Execute() method directly. Only explicit /command invocation works.
	DisableModelInvocation bool `yaml:"disable_model_invocation"`
}

type SourceTier int

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
}