plugin

type ActionResult struct {
	Success     bool      `json:"success"`
	Action      string    `json:"action"`
	PluginID    string    `json:"plugin_id,omitempty"`
	Path        string    `json:"path,omitempty"`
	Builtin     bool      `json:"builtin,omitempty"`
	PluginRoot  string    `json:"plugin_root,omitempty"`
	Source      string    `json:"source,omitempty"`
	BackupPath  string    `json:"backup_path,omitempty"`
	Digest      string    `json:"digest,omitempty"`
	Trusted     bool      `json:"trusted,omitempty"`
	Valid       bool      `json:"valid,omitempty"`
	Files       []string  `json:"files,omitempty"`
	Plugins     []Summary `json:"plugins,omitempty"`
	Plugin      *Summary  `json:"plugin,omitempty"`
	Manifest    *Manifest `json:"manifest,omitempty"`
	TestResult  *Result   `json:"test_result,omitempty"`
	Fixture     string    `json:"fixture,omitempty"`
	NextActions []string  `json:"next_actions,omitempty"`
	ErrorKind   string    `json:"error_kind,omitempty"`
	Error       string    `json:"error,omitempty"`
}

type CachePolicy struct {
	RecommendedTTL string `json:"recommended_ttl"`
	HardMaxAge     string `json:"hard_max_age"`
}

type CacheState struct {
	Mode       string `json:"mode"`
	Hit        bool   `json:"hit"`
	Stale      bool   `json:"stale"`
	AgeSeconds int64  `json:"age_seconds,omitempty"`
}

type CapabilityRef struct {
	ID      string `json:"id"`
	Version string `json:"version"`
	Digest  string `json:"digest"`
	Builtin bool   `json:"builtin"`
}

type CreateOptions struct {
	ID        string
	Runner    string
	Platform  string
	Privilege string
	Template  string
	Replace   bool
}

type CreateResult struct {
	Resolved   *Resolved
	Files      []string
	BackupPath string
}

type Evidence struct {
	Kind   string `json:"kind"`
	Source string `json:"source"`
}

type InstallOptions struct {
	Source  string // local directory that holds the plugin
	Replace bool   // preserve an existing plugin as a backup (--replace)
	Trust   bool   // trust the installed digest in the same step (--trust)
}

type InstallResult struct {
	Resolved   *Resolved
	Files      []string
	BackupPath string
}

type Lock struct {
	Version int                  `json:"version"`
	Plugins map[string]LockEntry `json:"plugins"`
}

type LockEntry struct {
	Digest    string    `json:"digest"`
	TrustedAt time.Time `json:"trusted_at"`
}

type Manifest struct {
	APIVersion       string          `json:"api_version"`
	ID               string          `json:"id"`
	Version          string          `json:"version"`
	Kind             string          `json:"kind"`
	Description      string          `json:"description,omitempty"`
	Platforms        []string        `json:"platforms"`
	Runner           Runner          `json:"runner"`
	RequiredCommands []string        `json:"required_commands,omitempty"`
	Privilege        string          `json:"privilege"`
	Timeout          string          `json:"timeout"`
	Effects          []string        `json:"effects"`
	Output           OutputContract  `json:"output"`
	Cache            CachePolicy     `json:"cache"`
	Redaction        RedactionPolicy `json:"redaction"`
}

type Observation struct {
	Schema      string         `json:"schema"`
	Capability  CapabilityRef  `json:"capability"`
	Target      TargetRef      `json:"target"`
	CollectedAt time.Time      `json:"collected_at"`
	ExpiresAt   time.Time      `json:"expires_at"`
	Status      string         `json:"status"`
	Privilege   string         `json:"privilege"`
	Parameters  string         `json:"parameters_digest"`
	Cache       CacheState     `json:"cache"`
	Facts       map[string]any `json:"facts"`
	Evidence    []Evidence     `json:"evidence"`
	Errors      []ResultError  `json:"errors"`
	Redaction   []string       `json:"redacted_fields,omitempty"`
}

type OutputContract struct {
	Schema string `json:"schema"`
}

type RedactionPolicy struct {
	DenyFields []string `json:"deny_fields,omitempty"`
}

type Resolved struct {
	Manifest  Manifest `json:"manifest"`
	Path      string   `json:"path"`
	Digest    string   `json:"digest"`
	Trusted   bool     `json:"trusted"`
	Builtin   bool     `json:"builtin"`
	Collector []byte   `json:"-"`
	Schema    any      `json:"-"`
}

type Result struct {
	Status   string         `json:"status"`
	Facts    map[string]any `json:"facts"`
	Evidence []Evidence     `json:"evidence"`
	Errors   []ResultError  `json:"errors"`
}

type ResultError struct {
	Kind    string `json:"kind"`
	Section string `json:"section,omitempty"`
	Message string `json:"message,omitempty"`
}

type Runner struct {
	Type       string `json:"type"`
	Entrypoint string `json:"entrypoint"`
}

type Summary struct {
	ID          string `json:"id"`
	Version     string `json:"version,omitempty"`
	Description string `json:"description,omitempty"`
	Path        string `json:"path"`
	Digest      string `json:"digest,omitempty"`
	Trusted     bool   `json:"trusted"`
	Builtin     bool   `json:"builtin"`
	Valid       bool   `json:"valid"`
	ErrorKind   string `json:"error_kind,omitempty"`
	Error       string `json:"error,omitempty"`
}

type TargetRef struct {
	Host               string `json:"host"`
	Port               string `json:"port"`
	User               string `json:"user"`
	UID                string `json:"uid,omitempty"`
	HostKeyFingerprint string `json:"host_key_fingerprint"`
	Platform           string `json:"platform"`
	BootID             string `json:"boot_id,omitempty"`
}