install

type OpenClawWorkspace struct {
	ID   string
	Path string
}

type Options struct {
	// Target is one of Targets. It picks the destination (when Path is
	// empty) and the formatting (cursor wraps the body in mdc frontmatter).
	// An empty Target with a Path writes the body verbatim to Path.
	Target string
	// Path, when set, overrides the target's conventional destination.
	Path string
	// SoulName fills the cursor frontmatter description.
	SoulName string
	// Cwd and Home anchor the conventional paths (injected for tests).
	Cwd, Home string
	// Force overwrites an existing file without asking.
	Force bool
	// Link, with Target "claude" or "grok", appends the link line to
	// ~/.claude/CLAUDE.md or $GROK_HOME/AGENTS.md when not already present.
	Link bool
	// Interactive enables the Confirm prompt for overwrites.
	Interactive bool
	// Confirm asks the user to approve overwriting the named file. Required
	// when Interactive and the destination exists.
	Confirm func(prompt string) (bool, error)
	// OverwriteHint names the flag suggested when refusing to overwrite
	// non-interactively; defaults to "--force".
	OverwriteHint string
	// Fetch returns the verbatim SOUL.md body. It is called only after the
	// overwrite gate passes: the server's .md endpoint bumps the public
	// download counter, and a refused install is not a download.
	Fetch func() (string, error)
}

type Receipt struct {
	Method  string `json:"method"`
	Version string `json:"version"`
}

type Result struct {
	Path  string
	Bytes int
}

type SkillOptions struct {
	// Dir is the destination's parent directory: either a target's
	// conventional skills directory (SkillDir) or an explicit --path
	// override. The install folder itself is always Slug.
	Dir string
	// Slug is the listing's slug: it names the install folder
	// (<Dir>/<Slug>/SKILL.md) and must equal the fetched body's
	// frontmatter name.
	Slug string
	// Force overwrites an existing file without asking.
	Force bool
	// Interactive enables the Confirm prompt for overwrites.
	Interactive bool
	// Confirm asks the user to approve overwriting the named file. Required
	// when Interactive and the destination exists.
	Confirm func(prompt string) (bool, error)
	// OverwriteHint names the flag suggested when refusing to overwrite
	// non-interactively; defaults to "--force".
	OverwriteHint string
	// Fetch returns the verbatim SKILL.md body. It is called only after the
	// overwrite gate passes: the server's .md endpoint bumps the public
	// download counter, and a refused install is not a download.
	Fetch func() (string, error)
}

type SkillResult struct {
	Path  string
	Name  string
	Bytes int
}