skills

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

type ConfigProperty struct {
	Type        string      `json:"type"`
	Description string      `json:"description"`
	Default     interface{} `json:"default,omitempty"`
	Enum        []string    `json:"enum,omitempty"`
	Format      string      `json:"format,omitempty"`
	Sensitive   bool        `json:"sensitive,omitempty"`
}

type ConfigSchema struct {
	Properties map[string]ConfigProperty `json:"properties"`
	Required   []string                  `json:"required,omitempty"`
}

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

type IntentPattern struct {
	Name       string   `json:"name"`
	Examples   []string `json:"examples"`
	Confidence float64  `json:"min_confidence"`
	Priority   int      `json:"priority"`
	Enabled    bool     `json:"enabled"`
	Categories []string `json:"categories,omitempty"`
	Languages  []string `json:"languages,omitempty"`
}

type LoadedSkill struct {
	Plugin SkillPlugin
	Info   *SkillInfo
	// contains filtered or unexported fields
}

type Permission struct {
	Type        PermissionType `json:"type"`
	Resource    string         `json:"resource,omitempty"`
	Actions     []string       `json:"actions,omitempty"`
	Description string         `json:"description"`
}

type PermissionType string

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

type SandboxMode string

type SkillAction struct {
	Type       string                 `json:"type"`
	Target     string                 `json:"target"`
	Parameters map[string]interface{} `json:"parameters,omitempty"`
	Success    bool                   `json:"success"`
	Error      string                 `json:"error,omitempty"`
}

type SkillConfig struct {
	// Skill identification
	SkillID string `json:"skill_id"`
	Name    string `json:"name"`
	Version string `json:"version"`

	// Configuration
	Config map[string]interface{} `json:"config"`

	// Permissions and security
	Permissions []Permission `json:"permissions"`
	Enabled     bool         `json:"enabled"`

	// Runtime settings
	Timeout    time.Duration `json:"timeout"`
	MaxRetries int           `json:"max_retries"`
}

type SkillExecutor interface {
	LoadSkill(manifest *SkillManifest, config *SkillConfig) (SkillPlugin, error)
	UnloadSkill(skillID string) error
	ListLoadedSkills() []string
}

type SkillFactory func(logger *zap.Logger) SkillPlugin

type SkillInfo struct {
	Manifest   *SkillManifest `json:"manifest"`
	Config     *SkillConfig   `json:"config"`
	Status     SkillStatus    `json:"status"`
	LoadedAt   time.Time      `json:"loaded_at"`
	LastUsed   *time.Time     `json:"last_used,omitempty"`
	ErrorCount int            `json:"error_count"`
	LastError  string         `json:"last_error,omitempty"`
	PluginPath string         `json:"plugin_path"`
}

type SkillLoader interface {
	LoadSkill(ctx context.Context, skillPath string) (SkillPlugin, error)
	UnloadSkill(ctx context.Context, plugin SkillPlugin) error
	SupportedModes() []SandboxMode
}

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

type SkillManagerConfig struct {
	SkillsDir    string        `json:"skills_dir"`
	AutoLoad     bool          `json:"auto_load"`
	MaxSkills    int           `json:"max_skills"`
	LoadTimeout  time.Duration `json:"load_timeout"`
	DefaultTrust TrustLevel    `json:"default_trust"`
	AllowedModes []SandboxMode `json:"allowed_sandbox_modes"`
	ConfigStore  string        `json:"config_store"`
}

type SkillManifest struct {
	// Basic information
	ID          string `json:"id"`
	Name        string `json:"name"`
	Version     string `json:"version"`
	Description string `json:"description"`
	Author      string `json:"author"`
	License     string `json:"license"`

	// Capabilities
	IntentPatterns []IntentPattern `json:"intent_patterns"`
	Languages      []string        `json:"languages"`
	Categories     []string        `json:"categories"`

	// Requirements
	Permissions  []Permission  `json:"permissions"`
	Dependencies []string      `json:"dependencies,omitempty"`
	MinVersion   string        `json:"min_loqa_version"`
	ConfigSchema *ConfigSchema `json:"config_schema,omitempty"`

	// Runtime behavior
	LoadOnStartup bool        `json:"load_on_startup"`
	Singleton     bool        `json:"singleton"`
	Timeout       string      `json:"timeout"`
	SandboxMode   SandboxMode `json:"sandbox_mode"`
	TrustLevel    TrustLevel  `json:"trust_level"`

	// Metadata
	Homepage   string   `json:"homepage,omitempty"`
	Repository string   `json:"repository,omitempty"`
	Keywords   []string `json:"keywords,omitempty"`
	Tags       []string `json:"tags,omitempty"`
}

type SkillPlugin interface {
	// Lifecycle hooks
	Initialize(ctx context.Context, config *SkillConfig) error
	Teardown(ctx context.Context) error

	// Core functionality
	CanHandle(intent VoiceIntent) bool
	HandleIntent(ctx context.Context, intent *VoiceIntent) (*SkillResponse, error)

	// Metadata
	GetManifest() (*SkillManifest, error)
	GetStatus() SkillStatus

	// Configuration
	GetConfig() (*SkillConfig, error)
	UpdateConfig(ctx context.Context, config *SkillConfig) error

	// Health checking
	HealthCheck(ctx context.Context) error
}

type SkillResponse struct {
	// Response data
	Success    bool   `json:"success"`
	Message    string `json:"message,omitempty"`
	SpeechText string `json:"speech_text,omitempty"`
	AudioURL   string `json:"audio_url,omitempty"`

	// Actions performed
	Actions []SkillAction `json:"actions,omitempty"`

	// Response metadata
	ResponseTime time.Duration          `json:"response_time"`
	Metadata     map[string]interface{} `json:"metadata,omitempty"`

	// Error information
	Error     string `json:"error,omitempty"`
	ErrorCode string `json:"error_code,omitempty"`
}

type SkillState string

type SkillStatus struct {
	State      SkillState `json:"state"`
	Healthy    bool       `json:"healthy"`
	LastError  string     `json:"last_error,omitempty"`
	LastUsed   time.Time  `json:"last_used"`
	UsageCount int64      `json:"usage_count"`
}

type TrustLevel string

type VoiceIntent struct {
	// Core intent data
	ID         string                 `json:"id"`
	Transcript string                 `json:"transcript"`
	Intent     string                 `json:"intent"`
	Confidence float64                `json:"confidence"`
	Entities   map[string]interface{} `json:"entities"`

	// Metadata
	UserID    string    `json:"user_id,omitempty"`
	DeviceID  string    `json:"device_id"`
	Timestamp time.Time `json:"timestamp"`

	// Context
	SessionID string                 `json:"session_id,omitempty"`
	Context   map[string]interface{} `json:"context,omitempty"`
}