clawhub

type Dependency struct {
	// Name is the dependency name (e.g., "@clawhub/web-search").
	Name string `json:"name"`

	// Version is the version constraint (e.g., "^1.0.0", ">=2.0.0").
	Version string `json:"version"`

	// Optional indicates if the dependency is optional.
	Optional bool `json:"optional,omitempty"`
}

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

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

type IssueType string

type Manifest struct {
	// Name is the skill name (required).
	Name string `json:"name"`

	// Version is the semantic version (required).
	Version string `json:"version"`

	// Description is a brief description of the skill.
	Description string `json:"description"`

	// Author is the skill author's name or organization.
	Author string `json:"author"`

	// Repository is the source repository URL.
	Repository string `json:"repository"`

	// License is the SPDX license identifier.
	License string `json:"license"`

	// Keywords are searchable tags for the skill.
	Keywords []string `json:"keywords,omitempty"`

	// Dependencies lists other skills this skill depends on.
	Dependencies []Dependency `json:"dependencies,omitempty"`

	// Permissions lists the permissions the skill requires.
	Permissions []string `json:"permissions,omitempty"`

	// Entry is the entry point file (defaults to SKILL.md).
	Entry string `json:"entry,omitempty"`

	// Signature is the cryptographic signature for verification.
	Signature string `json:"signature,omitempty"`

	// MinAgentVersion is the minimum omniagent version required.
	MinAgentVersion string `json:"minAgentVersion,omitempty"`
}

type Option func(*Hub)

type ResolutionError struct {
	// Dependency is the name of the dependency that failed.
	Dependency string

	// Constraint is the version constraint that couldn't be satisfied.
	Constraint string

	// Reason is the error reason.
	Reason string
}

type ResolvedDependency struct {
	// Name is the dependency name.
	Name string

	// Version is the resolved version.
	Version string

	// Repository is the source repository URL.
	Repository string

	// Optional indicates if this is an optional dependency.
	Optional bool

	// Transitive indicates if this is a transitive dependency.
	Transitive bool
}

type ScanResult struct {
	// Issues is the list of security issues found.
	Issues []SecurityIssue

	// FileHashes contains SHA256 hashes of all files.
	FileHashes map[string]string

	// Passed indicates if the scan passed.
	Passed bool
}

type SearchResult struct {
	// Skills is the list of matching skills.
	Skills []SkillInfo `json:"skills"`

	// Total is the total number of matching skills.
	Total int `json:"total"`

	// Page is the current page number.
	Page int `json:"page"`

	// PerPage is the number of results per page.
	PerPage int `json:"perPage"`
}

type SecurityIssue struct {
	// Severity is the issue severity.
	Severity Severity

	// Type is the issue type.
	Type IssueType

	// File is the file where the issue was found.
	File string

	// Line is the line number (0 if not applicable).
	Line int

	// Description describes the issue.
	Description string

	// Recommendation suggests how to fix the issue.
	Recommendation string
}

type SecurityScanner struct {
	// StrictMode fails on any warning when true.
	StrictMode bool

	// AllowedCommands is a list of allowed shell commands.
	AllowedCommands []string

	// BlockedPatterns are regex patterns that are not allowed.
	BlockedPatterns []*regexp.Regexp
}

type SecurityState string

type Severity string

type SkillInfo struct {
	// Name is the skill name.
	Name string `json:"name"`

	// Version is the latest version.
	Version string `json:"version"`

	// Description is the skill description.
	Description string `json:"description"`

	// Author is the skill author.
	Author string `json:"author"`

	// Repository is the source repository URL.
	Repository string `json:"repository"`

	// Downloads is the total download count.
	Downloads int `json:"downloads"`

	// Stars is the star count.
	Stars int `json:"stars"`

	// License is the SPDX license identifier.
	License string `json:"license"`

	// Keywords are searchable tags.
	Keywords []string `json:"keywords"`

	// CreatedAt is when the skill was first published.
	CreatedAt time.Time `json:"createdAt"`

	// UpdatedAt is when the skill was last updated.
	UpdatedAt time.Time `json:"updatedAt"`

	// SecurityState indicates the security verification state.
	SecurityState SecurityState `json:"securityState"`

	// Versions lists all available versions.
	Versions []string `json:"versions,omitempty"`
}