skills

type BundledSkillDefinition struct {
	Name                   string
	Description            string
	Aliases                []string
	WhenToUse              string
	ArgumentHint           string
	AllowedTools           []string
	Model                  string
	DisableModelInvocation bool
	UserInvocable          bool
	IsEnabled              func() bool
	Hooks                  *HooksSettings
	Context                ExecutionContext
	Agent                  string
	Effort                 string
	Files                  map[string]string
	Triggers               []string
	GetPromptForCommand    func(args string, ctx context.Context) ([]ContentBlock, error)
}

type ContentBlock struct {
	Type string `json:"type"`
	Text string `json:"text,omitempty"`
}

type ExecutionContext string

type ExternalDir struct {
	// Path is the folder; every sub-folder holding a SKILL.md is a skill.
	Path string
	// Source names where the skills come from. It is shown with each skill (Skill.LoadedFrom), for example "claudeCode".
	Source SettingSource
	// Skip, when set, leaves out the skills it returns true for: a host keeps out the ones that only make sense inside the other tool.
	Skip func(Skill) bool
}

type FileSkillLoader struct {
	Directory string
	Source    SettingSource
	// CollectionRoot, when non-empty, is the repo root that owns this skill
	// collection. It is injected into skill prompts so the AI can resolve
	// paths relative to the repo root (e.g. data/, scripts/).
	CollectionRoot string
	// SkipHidden leaves out every folder whose name starts with a dot (.trash, .git, .system...). A folder of another tool keeps
	// its deleted skills and its own bundled ones there: they are not skills the person chose.
	SkipHidden bool
	// Skip, when set, leaves out the skills it returns true for.
	Skip func(Skill) bool
	// contains filtered or unexported fields
}

type ForkRunner interface {
	// parentPermissionMode is the forking session's current permission
	// mode, passed through unresolved so the implementation (which has
	// access to the same sub-agent permission-inheritance policy every
	// other sub-agent spawn path uses) decides what the forked skill
	// actually runs under, instead of this package hardcoding a choice.
	RunForkedSkill(ctx context.Context, skillName, task string, allowedTools []string, model string, parentPermissionMode types.PermissionMode) (string, error)
}

type FrontmatterData struct {
	Name                   any    `yaml:"name"`
	Description            any    `yaml:"description"`
	WhenToUse              string `yaml:"when_to_use"`
	ArgumentHint           string `yaml:"argument-hint"`
	Arguments              any    `yaml:"arguments"`
	AllowedTools           any    `yaml:"allowed-tools"`
	Model                  string `yaml:"model"`
	DisableModelInvocation any    `yaml:"disable-model-invocation"`
	UserInvocable          any    `yaml:"user-invocable"`
	Version                string `yaml:"version"`
	Context                string `yaml:"context"`
	Agent                  string `yaml:"agent"`
	Effort                 string `yaml:"effort"`
	Paths                  any    `yaml:"paths"`
	Hooks                  any    `yaml:"hooks"`
	Shell                  any    `yaml:"shell"`

	// Triggers is a list of natural-language phrases that should auto-activate
	// this skill (e.g. ["browse this page", "take a screenshot"]). Inspired by
	// gstack. When the user's prompt contains any trigger phrase, the skill is
	// expanded automatically — no /slash-command needed.
	Triggers any `yaml:"triggers,omitempty"`

	// PreambleTier controls how much context is prepended to the expanded skill
	// prompt. Accepts int (1/2/3) or string ("basic"/"standard"/"full").
	//   1 / basic    — skill content only (default)
	//   2 / standard — + working directory info
	//   3 / full     — + working directory + user preferences block
	PreambleTier any `yaml:"preamble-tier,omitempty"`

	// Requires lists external dependencies the skill needs (Node.js, Python
	// packages, system tools). The agent checks them at runtime and requests
	// user permission before installing any missing dependency.
	Requires any `yaml:"requires,omitempty"`
}

type FrontmatterShell struct {
	Before     []string `yaml:"before,omitempty"`
	After      []string `yaml:"after,omitempty"`
	OnError    []string `yaml:"on_error,omitempty"`
	OnComplete []string `yaml:"on_complete,omitempty"`
}

type HooksSettings struct {
	BeforeTool  []string `yaml:"before_tool,omitempty"`
	AfterTool   []string `yaml:"after_tool,omitempty"`
	Before      []string `yaml:"before,omitempty"`
	After       []string `yaml:"after,omitempty"`
	OnError     []string `yaml:"on_error,omitempty"`
	OnCancel    []string `yaml:"on_cancel,omitempty"`
	OnComplete  []string `yaml:"on_complete,omitempty"`
	ToolAllowed []string `yaml:"tool_allowed,omitempty"`
	ToolDenied  []string `yaml:"tool_denied,omitempty"`
}

type LoadedFrom string

type RepoInstall struct {
	// Include lists the skills that were chosen, by the name of their folder. Empty means every skill of the repository.
	Include []string `json:"include,omitempty"`
	// Pending is true while the installation is not finished (the person has not confirmed, or the environment is being made):
	// the repository's skills are not offered to the agent until then.
	Pending bool `json:"pending,omitempty"`
	// Python is the interpreter of the environment made for this repository.
	Python string `json:"python,omitempty"`
	// NodeModules is the folder of the Node packages installed for this repository.
	NodeModules string `json:"node_modules,omitempty"`
}

type SettingSource string

type Skill struct {
	Name                        string
	DisplayName                 string
	Description                 string
	HasUserSpecifiedDescription bool
	AllowedTools                []string
	ArgumentHint                string
	ArgNames                    []string
	WhenToUse                   string
	Version                     string
	Model                       string
	DisableModelInvocation      bool
	UserInvocable               bool
	Context                     ExecutionContext
	Agent                       string
	Effort                      string
	Paths                       []string
	Content                     string // raw markdown body, used by ExecuteSkillPrompt fallback
	ContentLength               int
	IsHidden                    bool
	ProgressMessage             string
	Source                      SkillSource
	LoadedFrom                  LoadedFrom
	SkillRoot                   string
	Hooks                       *HooksSettings
	Shell                       *FrontmatterShell

	// Triggers holds natural-language phrases that auto-activate this skill
	// without a slash command (e.g. "browse this page", "take a screenshot").
	Triggers []string
	// PreambleTier controls context injection depth: 0=default (base dir),
	// 1=basic (none), 2=standard (base dir), 3=full (base dir + context hint).
	PreambleTier int
	// Scope indicates the ownership/access level of this skill.
	Scope SkillScope
	// Requires lists external dependencies that must be present before the
	// skill runs. The agent verifies each and requests user permission to
	// install any that are missing.
	Requires []SkillRequirement

	GetPromptForCommand func(args string, ctx context.Context) ([]ContentBlock, error)
}

type SkillAlias struct {
	Alias  string
	Target string
}

type SkillInput struct {
	Skill string `json:"skill"`
	Args  string `json:"args,omitempty"`
}

type SkillLoader interface {
	LoadSkills() ([]Skill, error)
	GetSkill(name string) (*Skill, error)
	GetSkillDirCommands(cwd string) ([]Skill, error)
}

type SkillOutput struct {
	Skill   string `json:"skill"`
	Args    string `json:"args,omitempty"`
	Output  string `json:"output"`
	Success bool   `json:"success"`
}

type SkillRequirement struct {
	// Type is a human-readable label: "node", "python", "system", etc.
	Type string `yaml:"type"`
	// Check is a shell command that exits 0 when the dep is satisfied.
	// Example: "node --version", "python3 -c 'import pptx'"
	Check string `yaml:"check"`
	// InstallCmd is run (with user permission) when Check fails.
	// Supports ${SESHAT_SKILL_DIR} substitution.
	InstallCmd string `yaml:"install-cmd"`
	// Packages lists the packages for display purposes only.
	Packages []string `yaml:"packages,omitempty"`
	// Optional marks the requirement as non-blocking: the skill runs even if
	// the dep is missing, but the agent is told some features may be degraded.
	Optional bool `yaml:"optional,omitempty"`
}

type SkillScope string

type SkillSource string

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

type SkillWithPath struct {
	Skill    Skill
	FilePath string
}