skills

type ClawHubConfig struct {
	Enabled         bool
	BaseURL         string
	AuthToken       string
	SearchPath      string // e.g. "/api/v1/search"
	SkillsPath      string // e.g. "/api/v1/skills"
	DownloadPath    string // e.g. "/api/v1/download"
	Timeout         int    // seconds, 0 = default (30s)
	MaxZipSize      int    // bytes, 0 = default (50MB)
	MaxResponseSize int    // bytes, 0 = default (2MB)
}

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

type GitHubContent struct {
	Name        string `json:"name"`
	Path        string `json:"path"`
	Type        string `json:"type"` // "file" or "dir"
	DownloadURL string `json:"download_url"`
	URL         string `json:"url"` // API URL for subdirectories
}

type GitHubRef struct {
	Owner    string // Repository owner
	RepoName string // Repository name
	Ref      string // Git reference (branch, tag, or commit)
	SubPath  string // Path within the repository
}

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

type GitHubRegistryConfig struct {
	Enabled   bool
	BaseURL   string
	AuthToken string
	Proxy     string
}

type InstallResult struct {
	Version          string
	IsMalwareBlocked bool
	IsSuspicious     bool
	Summary          string
	// Commit is the commit SHA a GitHub install was made from (empty for
	// other registries). Record it with the install.
	Commit string
	// Unpinned is set for a GitHub install whose ref couldn't be resolved to
	// a commit, so it was downloaded from the ref itself (Commit is empty).
	Unpinned bool
}

type InstallTargetNormalizer interface {
	NormalizeInstallTarget(target string) string
}

type RegistryConfig struct {
	Providers             []RegistryProvider
	MaxConcurrentSearches int
}

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

type RegistryProvider interface {
	IsEnabled() bool
	BuildRegistry() SkillRegistry
}

type RegistryProviderBuilder func(name string, cfg config.SkillRegistryConfig) RegistryProvider

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

type SearchResult struct {
	Score        float64 `json:"score"`
	Slug         string  `json:"slug"`
	DisplayName  string  `json:"display_name"`
	Summary      string  `json:"summary"`
	Version      string  `json:"version"`
	RegistryName string  `json:"registry_name"`
}

type SkillInfo struct {
	Name        string `json:"name"`
	Path        string `json:"path"`
	Source      string `json:"source"`
	Description string `json:"description"`
	// Origin is OriginInstalled for a skill installed from a registry.
	Origin string `json:"origin,omitempty"`
	// Unavailable says why the skill doesn't apply on this host (an
	// unsupported OS or a missing binary). Such skills aren't offered to the
	// agent.
	Unavailable string `json:"unavailable,omitempty"`
}

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

type SkillMeta struct {
	Slug             string `json:"slug"`
	DisplayName      string `json:"display_name"`
	Summary          string `json:"summary"`
	LatestVersion    string `json:"latest_version"`
	IsMalwareBlocked bool   `json:"is_malware_blocked"`
	IsSuspicious     bool   `json:"is_suspicious"`
	RegistryName     string `json:"registry_name"`
}

type SkillMetadata struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	// contains filtered or unexported fields
}

type SkillRegistry interface {
	// Name returns the unique name of this registry (e.g., "clawhub").
	Name() string
	// ResolveInstallDirName returns the directory name to use under workspace/skills
	// for a given install target. Different registries can interpret the target
	// differently (for example, a slug vs owner/repo/path).
	ResolveInstallDirName(target string) (string, error)
	// SkillURL returns the web URL for a skill slug if the registry exposes one.
	// version is optional and can be used by registries whose URLs depend on a ref.
	SkillURL(slug, version string) string
	// Search searches the registry for skills matching the query.
	Search(ctx context.Context, query string, limit int) ([]SearchResult, error)
	// GetSkillMeta retrieves metadata for a specific skill by slug.
	GetSkillMeta(ctx context.Context, slug string) (*SkillMeta, error)
	// DownloadAndInstall fetches metadata, resolves the version, downloads and
	// installs the skill to targetDir. Returns an InstallResult with metadata
	// for the caller to use for moderation and user messaging.
	DownloadAndInstall(ctx context.Context, slug, version, targetDir string) (*InstallResult, error)
}

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