patterns

type CanaryTestConfig struct {
	PatternName       string  // Base pattern name (e.g., "sql.joins.optimize")
	ControlVariant    string  // Usually "control" or "default"
	TreatmentVariant  string  // Usually "treatment" or version number
	TrafficPercentage float64 // 0.10 for 10% canary
	DurationMinutes   int     // 30 for 30-minute canary test
}

type CommonError struct {
	Error    string `yaml:"error" json:"error"`
	Cause    string `yaml:"cause" json:"cause"`
	Solution string `yaml:"solution" json:"solution"`
}

type Example struct {
	Name           string                 `yaml:"name" json:"name"`
	Description    string                 `yaml:"description" json:"description"`
	Parameters     map[string]interface{} `yaml:"parameters" json:"parameters"`
	ExpectedResult string                 `yaml:"expected_result" json:"expected_result"`
	Notes          string                 `yaml:"notes,omitempty" json:"notes,omitempty"`
}

type ExecutionPlan struct {
	Intent      IntentCategory `json:"intent"`
	Description string         `json:"description"`
	Steps       []PlannedStep  `json:"steps"`
	Reasoning   string         `json:"reasoning"`
	PatternName string         `json:"pattern_name,omitempty"` // Recommended pattern to use
}

type ExecutionPlannerFunc func(intent IntentCategory, userMessage string, context map[string]interface{}) (*ExecutionPlan, error)

type HotReloadConfig struct {
	Enabled    bool                  // Enable hot-reload
	DebounceMs int                   // Debounce delay in milliseconds (default: 500ms)
	Logger     *zap.Logger           // Logger for reload events
	OnUpdate   PatternUpdateCallback // Callback for pattern updates (optional)
}

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

type IntentCategory string

type IntentClassifierFunc func(userMessage string, context map[string]interface{}) (IntentCategory, float64)

type LLMClassifierConfig struct {
	// LLM provider to use for classification (should be configured with fast model like Haiku)
	LLMProvider types.LLMProvider

	// Enable caching of classifications (recommended)
	EnableCache bool

	// Cache TTL (default: 15 minutes)
	CacheTTL time.Duration
}

type LLMReRankerConfig struct {
	// LLM provider to use for re-ranking
	LLMProvider types.LLMProvider

	// Enable caching of re-ranking results
	EnableCache bool

	// Cache TTL (default: 30 minutes - longer than intent classification)
	CacheTTL time.Duration
}

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

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

type Parameter struct {
	Name         string `yaml:"name" json:"name"`
	Type         string `yaml:"type" json:"type"` // "string", "number", "array", "object"
	Required     bool   `yaml:"required" json:"required"`
	Description  string `yaml:"description" json:"description"`
	Example      string `yaml:"example" json:"example"`
	DefaultValue string `yaml:"default,omitempty" json:"default,omitempty"`
}

type Pattern struct {
	// Metadata
	Name        string `yaml:"name" json:"name"`
	Title       string `yaml:"title" json:"title"`
	Description string `yaml:"description" json:"description"`
	Category    string `yaml:"category" json:"category"`         // e.g., "analytics", "etl", "ml", "rest_api"
	Difficulty  string `yaml:"difficulty" json:"difficulty"`     // "beginner", "intermediate", "advanced"
	BackendType string `yaml:"backend_type" json:"backend_type"` // "sql", "rest", "document", etc.

	// Use cases and related patterns
	UseCases        []string `yaml:"use_cases" json:"use_cases"`
	RelatedPatterns []string `yaml:"related_patterns,omitempty" json:"related_patterns,omitempty"`

	// Pattern definition
	Parameters    []Parameter         `yaml:"parameters" json:"parameters"`
	Templates     map[string]Template `yaml:"templates" json:"templates"`
	Examples      []Example           `yaml:"examples" json:"examples"`
	CommonErrors  []CommonError       `yaml:"common_errors,omitempty" json:"common_errors,omitempty"`
	BestPractices string              `yaml:"best_practices,omitempty" json:"best_practices,omitempty"`

	// Backend-specific syntax documentation (optional)
	Syntax *Syntax `yaml:"syntax,omitempty" json:"syntax,omitempty"`

	// Backend-specific function name (e.g., Teradata nPath, Postgres jsonb_path_query)
	BackendFunction string `yaml:"backend_function,omitempty" json:"backend_function,omitempty"`
}

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

type PatternEntryYAML struct {
	Name              string           `yaml:"name"`
	Description       string           `yaml:"description"`
	TriggerConditions []string         `yaml:"trigger_conditions"`
	Template          string           `yaml:"template"`
	Example           string           `yaml:"example"`
	Rule              *PatternRuleYAML `yaml:"rule"`
	Priority          int              `yaml:"priority"`
	Tags              []string         `yaml:"tags"`
}

type PatternLibrarySpecYAML struct {
	Entries []PatternEntryYAML `yaml:"entries"`
}

type PatternLibraryYAML struct {
	APIVersion string                 `yaml:"apiVersion"`
	Kind       string                 `yaml:"kind"`
	Metadata   PatternMetadataYAML    `yaml:"metadata"`
	Spec       PatternLibrarySpecYAML `yaml:"spec"`
}

type PatternMetadata struct {
	Name    string
	Variant string
	Domain  string
}

type PatternMetadataYAML struct {
	Name        string            `yaml:"name"`
	Version     string            `yaml:"version"`
	Domain      string            `yaml:"domain"`
	Description string            `yaml:"description"`
	Labels      map[string]string `yaml:"labels"`
}

type PatternRuleYAML struct {
	Condition string `yaml:"condition"`
	Action    string `yaml:"action"`
	Rationale string `yaml:"rationale"`
}

type PatternSummary struct {
	Name            string   `json:"name"`
	Title           string   `json:"title"`
	Description     string   `json:"description"` // Truncated for listing
	Category        string   `json:"category"`
	Difficulty      string   `json:"difficulty"`
	BackendType     string   `json:"backend_type"`
	UseCases        []string `json:"use_cases"`
	BackendFunction string   `json:"backend_function,omitempty"`
}

type PatternUpdateCallback func(eventType string, patternName string, filePath string, err error)

type PlannedStep struct {
	ToolName    string            `json:"tool_name"`
	Params      map[string]string `json:"params"`
	Description string            `json:"description"`
	PatternHint string            `json:"pattern_hint,omitempty"` // Suggested pattern to apply
}

type Syntax struct {
	Description string           `yaml:"description" json:"description"`
	Operators   []SyntaxOperator `yaml:"operators" json:"operators"`
}

type SyntaxOperator struct {
	Symbol  string `yaml:"symbol" json:"symbol"`
	Meaning string `yaml:"meaning" json:"meaning"`
	Example string `yaml:"example" json:"example"`
}

type Template struct {
	Description        string   `yaml:"description,omitempty" json:"description,omitempty"`
	Content            string   `yaml:"content,omitempty" json:"content,omitempty"` // Template content (SQL, JSON, etc.)
	SQL                string   `yaml:"sql,omitempty" json:"sql,omitempty"`         // Alternative field for "content"
	RequiredParameters []string `yaml:"required_parameters,omitempty" json:"required_parameters,omitempty"`
	OutputFormat       string   `yaml:"output_format,omitempty" json:"output_format,omitempty"` // "table", "json", "text"
}