plugins

type ActivateOptions struct {
	// Cwd is the working directory plugin tool commands run in. Empty falls back to
	// the plugin's own directory.
	Cwd string
	// Timeout bounds each plugin tool command. <= 0 uses defaultPluginToolTimeout.
	Timeout time.Duration
	// Env supplies the base environment for plugin tool commands. nil uses the
	// current process environment (os.Environ()).
	Env []string
	// contains filtered or unexported fields
}

type ActivationResult struct {
	// Hooks are the live hook definitions built from plugin manifests, ready to be
	// merged into the dispatcher's hook set. Order is deterministic.
	Hooks []hooks.Definition
	// SkillRoots are directories internal/skills.Load can scan to discover plugin
	// skills, deduplicated and deterministically ordered.
	SkillRoots []string
	// Tools/HookProv/Skills carry provenance so a listing can attribute each live
	// extension to its originating plugin.
	Tools    []ToolProvenance
	HookProv []HookProvenance
	Skills   []SkillProvenance
	// Warnings collects per-plugin/per-extension issues that caused an extension to
	// be skipped. A single malformed plugin never aborts activation.
	Warnings []string
}

type Diagnostic struct {
	Kind         DiagnosticKind `json:"kind"`
	Message      string         `json:"message"`
	Source       Source         `json:"source,omitempty"`
	Root         string         `json:"root,omitempty"`
	PluginPath   string         `json:"pluginPath,omitempty"`
	ManifestPath string         `json:"manifestPath,omitempty"`
	FieldPath    string         `json:"fieldPath,omitempty"`
	PluginID     string         `json:"pluginId,omitempty"`
}

type DiagnosticKind string

type GitRunner func(ctx context.Context, destination string, source string) error

type HookEvent string

type HookExtension struct {
	Name        string    `json:"name"`
	Description string    `json:"description,omitempty"`
	Event       HookEvent `json:"event"`
	Command     string    `json:"command"`
	Args        []string  `json:"args"`
}

type HookProvenance struct {
	HookID   string `json:"hookId"`
	PluginID string `json:"pluginId"`
}

type InstallOptions struct {
	// Source is a git URL or a local filesystem path to a plugin directory (one
	// that contains a plugin.json, or whose tree contains exactly one).
	Source string
	// Dir is the plugins directory to install into (typically the user plugins
	// root from ResolveRoots).
	Dir string
	// Force allows overwriting a plugin installed from a different source.
	Force bool
	// GitRunner overrides the fetch implementation. When nil, a git source is
	// shallow-cloned with the system git.
	GitRunner GitRunner
}

type InstallResult struct {
	ID           string `json:"id"`
	Name         string `json:"name"`
	Version      string `json:"version"`
	ManifestPath string `json:"manifestPath"`
	Hash         string `json:"hash"`
	Source       string `json:"source"`
	Updated      bool   `json:"updated"`
	PreviousHash string `json:"previousHash,omitempty"`
}

type LoadOptions struct {
	Roots                         []Root
	Cwd                           string
	Env                           map[string]string
	AllowManifestToolAutoApproval bool
}

type LoadResult struct {
	Roots       []Root         `json:"roots"`
	Plugins     []LoadedPlugin `json:"plugins"`
	Diagnostics []Diagnostic   `json:"diagnostics"`
}

type LoadedPlugin struct {
	SchemaVersion int             `json:"schemaVersion"`
	ID            string          `json:"id"`
	Name          string          `json:"name"`
	Version       string          `json:"version"`
	Description   string          `json:"description,omitempty"`
	Enabled       bool            `json:"enabled"`
	Source        Source          `json:"source"`
	Root          string          `json:"root"`
	PluginDir     string          `json:"pluginDir"`
	ManifestPath  string          `json:"manifestPath"`
	Tools         []ToolExtension `json:"tools"`
	Prompts       []PathExtension `json:"prompts"`
	Skills        []PathExtension `json:"skills"`
	Hooks         []HookExtension `json:"hooks"`
	// Optional, additive metadata (omitempty so existing plugins are unchanged).
	// Author/Interface are pointers: a non-pointer struct is never "empty" to
	// encoding/json, so omitempty would still emit `author:{}` / `interface:{}`
	// and change the serialized form of plugins that don't set them.
	Author    *PluginAuthor    `json:"author,omitempty"`
	License   string           `json:"license,omitempty"`
	Keywords  []string         `json:"keywords,omitempty"`
	Homepage  string           `json:"homepage,omitempty"`
	Interface *PluginInterface `json:"interface,omitempty"`
}

type LockEntry struct {
	Source string `json:"source"`
	Hash   string `json:"hash"`
}

type ManifestError struct {
	FieldPath string
	Message   string
}

type ParseManifestOptions struct {
	Source                        Source
	Root                          string
	PluginDir                     string
	ManifestPath                  string
	AllowManifestToolAutoApproval bool
}

type PathExtension struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	Path        string `json:"path"`
}

type PluginAuthor struct {
	Name  string `json:"name,omitempty"`
	Email string `json:"email,omitempty"`
	URL   string `json:"url,omitempty"`
}

type PluginInterface struct {
	DisplayName    string   `json:"displayName,omitempty"`
	Category       string   `json:"category,omitempty"`
	BrandColor     string   `json:"brandColor,omitempty"`
	DefaultPrompts []string `json:"defaultPrompts,omitempty"`
}

type ResolveRootOptions struct {
	Cwd string
	Env map[string]string
}

type Root struct {
	Source Source `json:"source"`
	Path   string `json:"path"`
}

type SkillProvenance struct {
	SkillName string `json:"skillName"`
	Root      string `json:"root"`
	PluginID  string `json:"pluginId"`
}

type Source string

type ToolExtension struct {
	Name        string         `json:"name"`
	Description string         `json:"description,omitempty"`
	Command     string         `json:"command"`
	Args        []string       `json:"args"`
	InputSchema map[string]any `json:"inputSchema"`
	Permission  ToolPermission `json:"permission"`
}

type ToolPermission string

type ToolProvenance struct {
	ToolName string `json:"toolName"`
	PluginID string `json:"pluginId"`
}