marketplace

type Author struct {
	Name  string `json:"name"`
	Email string `json:"email,omitempty"`
}

type Bump struct {
	// ID is the plugin's filesystem ID (e.g. "demo").
	ID string
	// From is the currently pinned version (from plugins/<id>.toml).
	From string
	// To is the latest version available in the fetched marketplace.
	To string
	// UpdateMode is the plugin's configured update mode ("pinned", "track", "manual").
	UpdateMode string
}

type FetchResult struct {
	HeadSHA string // for git sources
	Version string // for npm
}

type Fetcher interface {
	// Fetch resolves src into the directory at into, creating it if necessary.
	// Returns a FetchResult with available metadata (HeadSHA for git sources,
	// Version for npm).
	Fetch(src Source, into string) (FetchResult, error)
}

type GitFetcher struct{}

type Marketplace struct {
	Schema                              string               `json:"$schema,omitempty"`
	Name                                string               `json:"name"`
	Owner                               Owner                `json:"owner"`
	Description                         string               `json:"description,omitempty"`
	Version                             string               `json:"version,omitempty"`
	Metadata                            *MarketplaceMetadata `json:"metadata,omitempty"`
	Plugins                             []PluginEntry        `json:"plugins"`
	AllowCrossMarketplaceDependenciesOn []string             `json:"allowCrossMarketplaceDependenciesOn,omitempty"`
}

type MarketplaceMetadata struct {
	PluginRoot string `json:"pluginRoot,omitempty"`
}

type NPMFetcher struct {
	// HTTPClient overrides the default http.DefaultClient. Used in tests to
	// inject a fake httptest.Server.
	HTTPClient *http.Client
}

type Owner struct {
	Name  string `json:"name"`
	Email string `json:"email,omitempty"`
}

type PluginEntry struct {
	Name        string   `json:"name"`
	Source      Source   `json:"source"`
	Description string   `json:"description,omitempty"`
	Version     string   `json:"version,omitempty"`
	Author      *Author  `json:"author,omitempty"`
	Homepage    string   `json:"homepage,omitempty"`
	Repository  string   `json:"repository,omitempty"`
	License     string   `json:"license,omitempty"`
	Keywords    []string `json:"keywords,omitempty"`
	Category    string   `json:"category,omitempty"`
	Tags        []string `json:"tags,omitempty"`
	Strict      *bool    `json:"strict,omitempty"` // conflict policy on the plugin.json+entry union (default true): strict errors on a same-name conflict, non-strict lets the entry override. See marketplace.resolveConflicts.

	// Component config can be inlined here (overlaid on plugin.json):
	Skills     any            `json:"skills,omitempty"`   // string | []string
	Commands   any            `json:"commands,omitempty"` // string | []string
	Agents     any            `json:"agents,omitempty"`   // string | []string
	Hooks      any            `json:"hooks,omitempty"`    // string | object
	MCPServers map[string]any `json:"mcpServers,omitempty"`
	LSPServers map[string]any `json:"lspServers,omitempty"`
}

type PluginManifest struct {
	Name        string         `json:"name"`
	Description string         `json:"description,omitempty"`
	Version     string         `json:"version,omitempty"`
	MCPServers  map[string]any `json:"mcpServers,omitempty"`
	Skills      any            `json:"skills,omitempty"`
	Commands    any            `json:"commands,omitempty"`
	Agents      any            `json:"agents,omitempty"`
	Hooks       any            `json:"hooks,omitempty"`
	LSPServers  map[string]any `json:"lspServers,omitempty"`
}

type ProjectionResult struct {
	MCPServers []source.MCPServer
	Skills     []source.Skill
	Subagents  []source.Subagent
	Commands   []source.Command
	Hooks      []source.Hook
	LSPServers []source.LSPServer
}

type RelativeFetcher struct{}

type SHAWarning struct {
	// ID is the plugin's filesystem ID.
	ID string
	// Version is the version that was re-uploaded.
	Version string
	// RecordedSHA is what was stored in plugins/<id>.toml at install time.
	RecordedSHA string
	// FetchedSHA is the SHA of the freshly-fetched plugin.json.
	FetchedSHA string
}

type Source struct {
	Kind     string `json:"source,omitempty"` // "github" | "url" | "git-subdir" | "npm"
	Repo     string `json:"repo,omitempty"`
	URL      string `json:"url,omitempty"`
	Path     string `json:"path,omitempty"`
	Ref      string `json:"ref,omitempty"`
	SHA      string `json:"sha,omitempty"`
	Package  string `json:"package,omitempty"`
	Version  string `json:"version,omitempty"`
	Registry string `json:"registry,omitempty"`
	// Relative is the relative-path string when Source was a JSON string.
	Relative string `json:"-"`
	// RootDir, if non-empty, constrains where the RelativeFetcher will copy
	// from — Relative must resolve inside RootDir or the fetch is rejected.
	// Callers that resolve a marketplace-supplied relative path against the
	// marketplace cache directory should set this to the cache root so a
	// hostile marketplace.json entry like `"source": "../../../etc"` cannot
	// copy host files into the plugin cache.
	RootDir string `json:"-"`
}