plugin

type AsyncExecutor struct {
	// contains filtered or unexported fields
}

type AsyncExecutorConfig struct {
	// WorkerCount 工作协程数量
	WorkerCount int

	// QueueSize 任务队列大小
	QueueSize int
}

type AsyncFuture struct {
	// contains filtered or unexported fields
}

type AsyncResult struct {
	// Value 返回值
	Value interface{}

	// Error 错误
	Error error

	// Duration 执行时间
	Duration time.Duration
}

type CacheConfig struct {
	// MaxSize 最大缓存条目数
	MaxSize int

	// TTL 缓存过期时间
	TTL time.Duration

	// Enabled 是否启用
	Enabled bool
}

type CacheStats struct {
	// Size 当前大小
	Size int

	// MaxSize 最大大小
	MaxSize int

	// Hits 命中次数
	Hits int64

	// Misses 未命中次数
	Misses int64

	// HitRate 命中率
	HitRate float64

	// Enabled 是否启用
	Enabled bool
}

type CommandPluginAdapter struct {
	// contains filtered or unexported fields
}

type Dependency struct {
	// Name 依赖的插件名称
	Name string

	// Version 版本要求
	// 支持的格式：
	//   - "1.0.0" - 精确版本
	//   - ">=1.0.0" - 大于等于
	//   - ">1.0.0" - 大于
	//   - "<=1.0.0" - 小于等于
	//   - "<1.0.0" - 小于
	//   - "^1.0.0" - 兼容版本（主版本相同）
	//   - "~1.0.0" - 近似版本（主版本和次版本相同）
	Version string

	// Optional 是否为可选依赖
	Optional bool
}

type DependencyGraph struct {
	// contains filtered or unexported fields
}

type Diagnostics struct {
	// contains filtered or unexported fields
}

type DiscoveredPlugin struct {
	// Path 插件目录路径
	Path string

	// ManifestPath manifest.json 路径
	ManifestPath string

	// Manifest 解析后的清单
	Manifest *Manifest

	// LastModified 最后修改时间
	LastModified time.Time

	// Status 插件发现状态
	Status DiscoveryStatus
}

type DiscoveryCallback func(event *DiscoveryEvent)

type DiscoveryEvent struct {
	// Type 事件类型
	Type DiscoveryEventType

	// Plugin 相关插件
	Plugin *DiscoveredPlugin

	// Error 错误信息（如果有）
	Error error
}

type DiscoveryEventType string

type DiscoveryStatus string

type ErrorHandler func(pluginName string, funcName string, err error)

type ErrorIsolator struct {
	// contains filtered or unexported fields
}

type FunctionBus struct {
	// contains filtered or unexported fields
}

type FunctionCache struct {
	// contains filtered or unexported fields
}

type FunctionDeclaration struct {
	// Name 函数名称
	Name string `json:"name"`

	// Signature 函数签名
	// 格式: func(param1: type1, param2: type2): returnType
	// 例如: func(path: string, width: int, height: int): string
	Signature string `json:"signature"`

	// Description 函数描述
	Description string `json:"description"`
}

type FunctionMetricsData struct {
	// FunctionName 函数名称
	FunctionName string

	// PluginName 所属插件名称
	PluginName string

	// TotalCalls 总调用次数
	TotalCalls int64

	// SuccessCalls 成功调用次数
	SuccessCalls int64

	// ErrorCalls 错误调用次数
	ErrorCalls int64

	// TotalDuration 总耗时
	TotalDuration time.Duration

	// MinDuration 最小耗时
	MinDuration time.Duration

	// MaxDuration 最大耗时
	MaxDuration time.Duration

	// LastCallTime 最后调用时间
	LastCallTime time.Time

	// LastError 最后错误
	LastError string
}

type FunctionSignature struct {
	// Name 函数名称
	Name string

	// ParamTypes 参数类型列表
	// 例如: ["string", "int", "float64"]
	ParamTypes []string

	// ReturnType 返回值类型
	// 例如: "string", "int", "map[string]interface{}"
	ReturnType string

	// Variadic 是否为可变参数函数
	Variadic bool

	// Description 函数描述
	Description string
}

type GoPluginAdapter struct {
	// contains filtered or unexported fields
}

type HealthCheckFunc func() *HealthCheckResult

type HealthCheckResult struct {
	// Name 检查名称
	Name string

	// Status 状态
	Status HealthStatus

	// Message 消息
	Message string

	// Duration 检查耗时
	Duration time.Duration

	// Details 详细信息
	Details map[string]interface{}
}

type HealthStatus string

type HotReloadCallback func(event *HotReloadEvent)

type HotReloadEvent struct {
	// Type 事件类型
	Type HotReloadEventType

	// PluginPath 插件路径
	PluginPath string

	// Manifest 插件清单
	Manifest *Manifest

	// OldAdapter 旧适配器（如果是更新）
	OldAdapter PluginAdapter

	// NewAdapter 新适配器
	NewAdapter PluginAdapter

	// Error 错误信息（如果有）
	Error error
}

type HotReloadEventType string

type HotReloader struct {
	// contains filtered or unexported fields
}

type IsolatedAdapter struct {
	// contains filtered or unexported fields
}

type JSONLinesProtocol struct {
	// contains filtered or unexported fields
}

type JSONLinesRequest struct {
	// ID 请求 ID，用于匹配响应
	ID int64 `json:"id"`

	// Function 函数名
	Function string `json:"function"`

	// Args 参数列表
	Args []interface{} `json:"args"`
}

type JSONLinesResponse struct {
	// ID 请求 ID
	ID int64 `json:"id"`

	// Result 结果（成功时）
	Result interface{} `json:"result,omitempty"`

	// Error 错误信息（失败时）
	Error string `json:"error,omitempty"`
}

type LegacyPluginAdapter struct {
	// contains filtered or unexported fields
}

type LimitedExecutor struct {
	// contains filtered or unexported fields
}

type Logger interface {
	// Debug 调试日志
	Debug(msg string, args ...interface{})

	// Info 信息日志
	Info(msg string, args ...interface{})

	// Warn 警告日志
	Warn(msg string, args ...interface{})

	// Error 错误日志
	Error(msg string, args ...interface{})
}

type ManagerConfig struct {
	// PluginDirs 插件目录列表
	PluginDirs []string

	// EnableHotReload 是否启用热加载
	EnableHotReload bool

	// EnableMetrics 是否启用指标收集
	EnableMetrics bool

	// EnableDiagnostics 是否启用诊断
	EnableDiagnostics bool

	// ResourceLimits 资源限制配置
	ResourceLimits *ResourceLimits

	// Logger 日志记录器
	Logger Logger
}

type Manifest struct {
	// ID 插件唯一标识符
	// 格式建议: com.company.plugin-name
	ID string `json:"id"`

	// Name 插件名称
	Name string `json:"name"`

	// Version 插件版本
	// 格式: 语义化版本 (例如: 1.0.0)
	Version string `json:"version"`

	// Type 插件类型
	// 可选值: go, rpc, script, command
	Type PluginType `json:"type"`

	// Namespace 插件命名空间
	// 用于函数名前缀，例如 "http" 会使函数变成 "http.get"
	Namespace string `json:"namespace,omitempty"`

	// Language 插件实现语言（可选）
	// 对 RPC 和 Command 插件有用
	// 例如: python, nodejs, java
	Language string `json:"language,omitempty"`

	// Entry 插件入口点
	// - Go 插件: .so/.dll 文件路径
	// - RPC 插件: 可执行文件路径或服务地址
	// - Script 插件: .dsl 脚本文件路径
	// - Command 插件: 可执行文件路径
	Entry string `json:"entry"`

	// Functions 插件提供的函数列表
	Functions []FunctionDeclaration `json:"functions"`

	// Permissions 插件所需权限列表
	// 例如: ["file.read", "file.write", "net.fetch"]
	Permissions []string `json:"permissions"`

	// Dependencies 插件依赖列表（可选）
	Dependencies []Dependency `json:"dependencies,omitempty"`

	// Config 插件配置（可选）
	// 插件特定的配置参数
	Config map[string]interface{} `json:"config,omitempty"`

	// Description 插件描述（可选）
	Description string `json:"description,omitempty"`

	// Author 插件作者（可选）
	Author string `json:"author,omitempty"`

	// Homepage 插件主页（可选）
	Homepage string `json:"homepage,omitempty"`
	// contains filtered or unexported fields
}

type MetricsCollector struct {
	// contains filtered or unexported fields
}

type PanicHandler func(pluginName string, funcName string, panicValue interface{}, stack []byte)

type PermissionChecker struct {
	// contains filtered or unexported fields
}

type PermissionDeniedError struct {
	Permission string
}

type Plugin interface {
	// Name 获取插件名称
	Name() string

	// Version 获取插件版本
	Version() string

	// Description 获取插件描述
	Description() string

	// Dependencies 获取插件依赖
	Dependencies() []Dependency

	// Initialize 初始化插件
	// 在此方法中注册函数、监听事件等
	Initialize(ctx *PluginContext) error

	// Start 启动插件
	// 插件初始化完成后调用
	Start() error

	// Stop 停止插件
	// 准备卸载插件时调用
	Stop() error

	// Shutdown 卸载插件
	// 清理所有资源
	Shutdown() error

	// Status 获取插件状态
	Status() PluginStatus
}

type PluginAdapter interface {
	// Init 初始化适配器
	// manifest: 插件清单，包含插件元数据
	// ctx: 插件上下文，提供系统资源访问
	Init(manifest *Manifest, ctx *PluginContext) error

	// GetFunctions 获取插件提供的函数签名
	// 返回函数名到函数签名的映射
	GetFunctions() map[string]*FunctionSignature

	// Execute 执行函数调用
	// funcName: 要调用的函数名
	// args: 函数参数列表
	// 返回函数执行结果和可能的错误
	Execute(funcName string, args []interface{}) (interface{}, error)

	// Stop 停止适配器
	// 清理所有资源，关闭连接，终止进程等
	Stop() error

	// GetMetrics 获取运行指标
	// 返回插件的性能和运行统计信息
	GetMetrics() *PluginMetrics
}

type PluginBridge struct {
	// contains filtered or unexported fields
}

type PluginContext struct {
	// FunctionRegistry 函数注册表
	// 插件可以通过此接口注册自定义函数
	FunctionRegistry function.Registry

	// EventBus 事件总线
	// 插件可以通过此接口监听和触发事件
	EventBus event.EventBus

	// Config 插件配置
	// 从配置文件传递给插件的参数
	Config map[string]interface{}

	// Logger 日志记录器
	Logger Logger

	// Permissions 权限检查器（v1.2.0 新增）
	// 插件可以通过此接口检查是否有权限执行某些操作
	Permissions *PermissionChecker
	// contains filtered or unexported fields
}

type PluginDiscovery struct {
	// contains filtered or unexported fields
}

type PluginError struct {
	// PluginName 插件名称
	PluginName string

	// FunctionName 函数名称
	FunctionName string

	// OriginalError 原始错误
	OriginalError error

	// IsPanic 是否是 panic
	IsPanic bool

	// PanicValue panic 值
	PanicValue interface{}

	// Stack 堆栈信息
	Stack []byte
}

type PluginManager struct {
	// contains filtered or unexported fields
}

type PluginManagerInterface interface {
	// GetContext 获取插件上下文
	GetContext() *PluginContext
}

type PluginMetrics struct {
	// CallCount 函数调用总次数
	CallCount int64

	// ErrorCount 错误次数
	ErrorCount int64

	// TotalDuration 总执行时间
	TotalDuration time.Duration

	// AvgDuration 平均执行时间
	AvgDuration time.Duration

	// MinDuration 最小执行时间
	MinDuration time.Duration

	// MaxDuration 最大执行时间
	MaxDuration time.Duration

	// LastError 最后一次错误
	LastError error

	// LastCallTime 最后一次调用时间
	LastCallTime time.Time

	// LastSuccessTime 最后一次成功调用时间
	LastSuccessTime time.Time
}

type PluginMetricsData struct {
	// PluginName 插件名称
	PluginName string

	// PluginType 插件类型
	PluginType PluginType

	// TotalCalls 总调用次数
	TotalCalls int64

	// SuccessCalls 成功调用次数
	SuccessCalls int64

	// ErrorCalls 错误调用次数
	ErrorCalls int64

	// TotalDuration 总耗时
	TotalDuration time.Duration

	// MinDuration 最小耗时
	MinDuration time.Duration

	// MaxDuration 最大耗时
	MaxDuration time.Duration

	// LastCallTime 最后调用时间
	LastCallTime time.Time

	// LoadTime 加载时间
	LoadTime time.Time

	// Status 插件状态
	Status string
}

type PluginStatus int

type PluginStatusDetail struct {
	// Name 插件名称
	Name string

	// Type 插件类型
	Type PluginType

	// Status 状态
	Status string

	// LoadTime 加载时间
	LoadTime time.Time

	// TotalCalls 总调用次数
	TotalCalls int64

	// ErrorCalls 错误调用次数
	ErrorCalls int64

	// AverageDuration 平均耗时
	AverageDuration time.Duration

	// LastCallTime 最后调用时间
	LastCallTime time.Time

	// Functions 函数列表
	Functions []string
}

type PluginType string

type Process struct {
	// contains filtered or unexported fields
}

type ProcessPool struct {
	// contains filtered or unexported fields
}

type ProcessPoolConfig struct {
	// Command 命令路径
	Command string

	// Args 命令参数
	Args []string

	// MinSize 最小进程数（默认 1）
	MinSize int

	// MaxSize 最大进程数（默认 10）
	MaxSize int

	// IdleTimeout 空闲超时时间（默认 5 分钟）
	IdleTimeout time.Duration
}

type RPCPluginAdapter struct {
	// contains filtered or unexported fields
}

type ResourceLimiter struct {
	// contains filtered or unexported fields
}

type ResourceLimits struct {
	// MaxMemory 最大内存限制（字节）
	// 0 表示不限制
	MaxMemory int64

	// MaxCPUPercent 最大 CPU 使用率（0-100）
	// 0 表示不限制
	MaxCPUPercent int

	// MaxExecutionTime 最大执行时间
	// 0 表示不限制
	MaxExecutionTime time.Duration

	// MaxConcurrentCalls 最大并发调用数
	// 0 表示不限制
	MaxConcurrentCalls int

	// MaxCallsPerMinute 每分钟最大调用次数
	// 0 表示不限制
	MaxCallsPerMinute int
}

type ScriptPlugin struct {
	// contains filtered or unexported fields
}

type ScriptPluginAdapter struct {
	// contains filtered or unexported fields
}

type ScriptPluginConfig struct {
	Name         string
	Version      string
	Description  string
	Dependencies []Dependency
	Script       string // DSL 脚本内容
	Functions    map[string]string
}

type SystemStatus struct {
	// Status 总体状态
	Status HealthStatus

	// Uptime 运行时间
	Uptime time.Duration

	// PluginCount 插件数量
	PluginCount int

	// LoadedPlugins 已加载插件数量
	LoadedPlugins int

	// TotalCalls 总调用次数
	TotalCalls int64

	// TotalErrors 总错误次数
	TotalErrors int64

	// MemoryUsage 内存使用
	MemoryUsage uint64

	// GoRoutines Goroutine 数量
	GoRoutines int

	// HealthChecks 健康检查结果
	HealthChecks []*HealthCheckResult
}