types

type Artifact struct {
	Reference string            `json:"reference"`
	Digest    string            `json:"digest"`
	Size      int64             `json:"size"`
	MediaType string            `json:"mediaType"`
	Metadata  map[string]string `json:"metadata,omitempty"`
	Layers    []Layer           `json:"layers,omitempty"`
	CreatedAt time.Time         `json:"createdAt"`
}

type AuthConfig struct {
	DockerConfig string       `mapstructure:"docker_config" yaml:"docker_config,omitempty"`
	Credentials  []Credential `mapstructure:"credentials" yaml:"credentials,omitempty"`
}

type CacheConfig struct {
	Dir     string        `mapstructure:"dir" yaml:"dir"`
	MaxSize int64         `mapstructure:"max_size" yaml:"max_size"` // in bytes
	TTL     time.Duration `mapstructure:"ttl" yaml:"ttl"`
}

type Config struct {
	Registry RegistryConfig `mapstructure:"registry" yaml:"registry"`
	Auth     AuthConfig     `mapstructure:"auth" yaml:"auth"`
	Cache    CacheConfig    `mapstructure:"cache" yaml:"cache"`
	Logging  LoggingConfig  `mapstructure:"logging" yaml:"logging"`
	Proxy    ProxyConfig    `mapstructure:"proxy" yaml:"proxy"`
	Plugins  PluginsConfig  `mapstructure:"plugins" yaml:"plugins"`
}

type Credential struct {
	Registry string `mapstructure:"registry" yaml:"registry"`
	Username string `mapstructure:"username" yaml:"username"`
	Token    string `mapstructure:"token" yaml:"token,omitempty"`
	Password string `mapstructure:"password" yaml:"password,omitempty"`
}

type ExecutionResult struct {
	Stdout   string `json:"stdout"`
	Stderr   string `json:"stderr"`
	ExitCode int    `json:"exit_code"`
	Error    string `json:"error,omitempty"`
}

type HostConfigProvider interface {
	GetEffectiveConfig(ctx context.Context) (*Config, error)
}

type Layer struct {
	Digest    string            `json:"digest"`
	Size      int64             `json:"size"`
	MediaType string            `json:"mediaType"`
	Metadata  map[string]string `json:"metadata,omitempty"`
}

type LoggingConfig struct {
	Level  string `mapstructure:"level" yaml:"level"`
	Format string `mapstructure:"format" yaml:"format"`
	Output string `mapstructure:"output" yaml:"output"`
}

type OCIPluginMetadata struct {
	Name        string            `json:"name"`
	Version     string            `json:"version"`
	Description string            `json:"description"`
	Author      string            `json:"author,omitempty"`
	Homepage    string            `json:"homepage,omitempty"`
	Tags        []string          `json:"tags,omitempty"`
	Metadata    map[string]string `json:"metadata,omitempty"`
}

type Plugin interface {
	// Name returns the plugin name
	Name() string

	// Version returns the plugin version
	Version() string

	// Execute runs the plugin with given arguments
	Execute(args []string) error
}

type PluginCommand struct {
	Name        string `mapstructure:"name" yaml:"name"`
	Description string `mapstructure:"description" yaml:"description"`
}

type PluginInfo struct {
	Name        string          `json:"name" yaml:"name"`
	Version     string          `json:"version" yaml:"version"`
	Description string          `json:"description" yaml:"description"`
	Path        string          `json:"path" yaml:"path"`
	Manifest    *PluginManifest `json:"manifest,omitempty" yaml:"manifest,omitempty"`
}

type PluginManifest struct {
	Name        string            `mapstructure:"name" yaml:"name"`
	Version     string            `mapstructure:"version" yaml:"version"`
	Description string            `mapstructure:"description" yaml:"description"`
	Checksum    string            `mapstructure:"checksum" yaml:"checksum,omitempty"`
	Commands    []PluginCommand   `mapstructure:"commands" yaml:"commands,omitempty"`
	Platform    PluginPlatform    `mapstructure:"platform" yaml:"platform,omitempty"`
	Annotations map[string]string `mapstructure:"annotations" yaml:"annotations,omitempty" json:"annotations,omitempty"`
}

type PluginMetadata struct {
	Name        string            `json:"name"`
	Version     string            `json:"version"`
	Description string            `json:"description"`
	Operations  []string          `json:"operations"`
	Platform    PluginPlatform    `json:"platform"`
	Config      map[string]string `json:"config,omitempty"`
}

type PluginPlatform struct {
	OS   []string `mapstructure:"os" yaml:"os,omitempty"`
	Arch []string `mapstructure:"arch" yaml:"arch,omitempty"`
}

type PluginProtocol interface {
	// GetMetadata returns plugin metadata (name, version, description, etc.)
	GetMetadata(ctx context.Context) (*PluginMetadata, error)

	// Execute runs a plugin operation with given arguments
	// Returns output (stdout), error output (stderr), and exit code
	Execute(ctx context.Context, operation string, args []string, env map[string]string) (*ExecutionResult, error)

	// ValidateConfig validates plugin configuration
	ValidateConfig(ctx context.Context, config map[string]interface{}) error

	// GetSchema returns the configuration schema for this plugin
	GetSchema(ctx context.Context) (*PluginSchema, error)
}

type PluginSchema struct {
	Version    string                    `json:"version"`
	Properties map[string]SchemaProperty `json:"properties"`
}

type PluginSource struct {
	Registry          string `mapstructure:"registry" yaml:"registry"`
	VersionConstraint string `mapstructure:"version_constraint" yaml:"version_constraint,omitempty"`
}

type PluginsConfig struct {
	Dir         string                            `mapstructure:"dir" yaml:"dir"`
	AutoInstall bool                              `mapstructure:"auto_install" yaml:"auto_install"`
	Sources     []PluginSource                    `mapstructure:"sources" yaml:"sources,omitempty"`
	Signature   SignatureConfig                   `mapstructure:"signature" yaml:"signature,omitempty"`
	Settings    map[string]map[string]interface{} `mapstructure:"settings" yaml:"settings,omitempty"`
}

type ProxyConfig struct {
	HTTPProxy  string `mapstructure:"http_proxy" yaml:"http_proxy,omitempty"`
	HTTPSProxy string `mapstructure:"https_proxy" yaml:"https_proxy,omitempty"`
	NoProxy    string `mapstructure:"no_proxy" yaml:"no_proxy,omitempty"`
}

type RegistryConfig struct {
	Default            string   `mapstructure:"default" yaml:"default"`
	Mirrors            []string `mapstructure:"mirrors" yaml:"mirrors,omitempty"`
	InsecureRegistries []string `mapstructure:"insecure_registries" yaml:"insecure_registries,omitempty"`
}

type SchemaProperty struct {
	Type        string `json:"type"`
	Description string `json:"description"`
	Required    bool   `json:"required"`
	Default     string `json:"default,omitempty"`
}

type ServiceHealth struct {
	Status    string    `json:"status"`
	Message   string    `json:"message,omitempty"`
	Timestamp time.Time `json:"timestamp"`
}

type ServiceInfo struct {
	Name     string            `json:"name"`
	Address  string            `json:"address"`
	Protocol string            `json:"protocol,omitempty"`
	Metadata map[string]string `json:"metadata,omitempty"`
	Health   ServiceHealth     `json:"health,omitempty"`
}

type SignatureConfig struct {
	// Mode: "strict" (only valid signatures) or "permissive" (warn on unsigned)
	Mode string `mapstructure:"mode" yaml:"mode"`
	// PublicKeys contains paths to trusted public key files
	PublicKeys []string `mapstructure:"public_keys" yaml:"public_keys,omitempty"`
	// TrustStore is a directory containing trusted public keys
	TrustStore string `mapstructure:"trust_store" yaml:"trust_store,omitempty"`
	// AllowUnsigned allows unsigned plugins in permissive mode
	AllowUnsigned bool `mapstructure:"allow_unsigned" yaml:"allow_unsigned"`
}