council

type ChainConfig struct {
	// Steps defines the sequence of models to use.
	Steps []ChainStep `json:"steps" toml:"steps"`

	// PassContext determines if each step receives the full conversation history.
	PassContext bool `json:"pass_context" toml:"pass_context"`

	// StopOnError halts the chain if any step fails.
	StopOnError bool `json:"stop_on_error" toml:"stop_on_error"`
}

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

type ChainResult struct {
	Steps         []StepResult  `json:"steps"`
	FinalOutput   string        `json:"final_output"`
	TotalDuration time.Duration `json:"total_duration"`
	TotalCost     float64       `json:"total_cost"`
	Success       bool          `json:"success"`
	Error         string        `json:"error,omitempty"`
}

type ChainStep struct {
	// Name identifies this step.
	Name string `json:"name" toml:"name"`

	// Model to use for this step.
	Model string `json:"model" toml:"model"`

	// Role to apply (e.g., "refinery" for code review).
	Role string `json:"role" toml:"role"`

	// Prompt template or instruction for this step.
	Prompt string `json:"prompt" toml:"prompt"`

	// TransformOutput applies a transformation to the output before passing to next step.
	TransformOutput string `json:"transform_output" toml:"transform_output"`
}

type CircuitBreaker struct {
	// State is "closed" (normal), "open" (failing), or "half-open" (testing)
	State string

	// FailureCount is consecutive failures in current window
	FailureCount int

	// LastFailure is the timestamp of the last failure
	LastFailure time.Time

	// LastSuccess is the timestamp of the last success
	LastSuccess time.Time

	// OpenedAt is when the circuit was opened
	OpenedAt time.Time

	// Threshold is failures before opening
	Threshold int

	// ResetTimeout is how long to wait before testing again
	ResetTimeout time.Duration
}

type ComplexityConfig struct {
	// High complexity tasks (multi-file, architectural changes).
	High string `json:"high" toml:"high"`

	// Medium complexity tasks (single file, moderate changes).
	Medium string `json:"medium" toml:"medium"`

	// Low complexity tasks (small changes, simple fixes).
	Low string `json:"low" toml:"low"`
}

type ComplexityLevel int

type Config struct {
	// Version is the schema version.
	Version int `json:"version" toml:"version"`

	// Roles maps Gas Town roles to their model configurations.
	Roles map[string]*RoleConfig `json:"roles" toml:"roles"`

	// Defaults contains default settings.
	Defaults *DefaultConfig `json:"defaults,omitempty" toml:"defaults"`

	// Providers contains provider-specific settings.
	Providers map[string]*ProviderConfig `json:"providers,omitempty" toml:"providers"`
}

type DefaultConfig struct {
	// Model is the default model when no role-specific config exists.
	Model string `json:"model" toml:"model"`

	// Provider is the default provider.
	Provider string `json:"provider,omitempty" toml:"provider"`

	// Fallback is the default fallback chain.
	Fallback []string `json:"fallback,omitempty" toml:"fallback"`
}

type EnsembleConfig struct {
	// Models to run in parallel.
	Models []string `json:"models" toml:"models"`

	// VotingStrategy determines how to combine outputs.
	VotingStrategy VotingStrategy `json:"voting_strategy" toml:"voting_strategy"`

	// Threshold for consensus (0-1, percentage of models that must agree).
	Threshold float64 `json:"threshold" toml:"threshold"`

	// Timeout for waiting on all models.
	Timeout time.Duration `json:"timeout" toml:"timeout"`

	// MinResponses is the minimum number of responses required before voting.
	MinResponses int `json:"min_responses" toml:"min_responses"`
}

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

type EnsembleResult struct {
	Responses    []ModelResponse `json:"responses"`
	Winner       string          `json:"winner"`
	WinnerOutput string          `json:"winner_output"`
	Votes        map[string]int  `json:"votes"`
	Agreement    float64         `json:"agreement"` // 0-1
	Duration     time.Duration   `json:"duration"`
	Success      bool            `json:"success"`
	Error        string          `json:"error,omitempty"`
}

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

type Metrics struct {
	Version     int                         `json:"version"`
	UpdatedAt   time.Time                   `json:"updated_at"`
	ByRole      map[string]*RoleMetrics     `json:"by_role"`
	ByModel     map[string]*ModelMetrics    `json:"by_model"`
	ByProvider  map[string]*ProviderMetrics `json:"by_provider"`
	TaskHistory []TaskMetric                `json:"task_history,omitempty"`
}

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

type ModelComparison struct {
	Model1       string        `json:"model1"`
	Model2       string        `json:"model2"`
	TaskDiff     int           `json:"task_diff"`
	SuccessDiff  float64       `json:"success_diff"`
	DurationDiff time.Duration `json:"duration_diff_ms"`
	CostDiff     float64       `json:"cost_diff"`
}

type ModelExecutor interface {
	Execute(ctx context.Context, model, prompt string) (*ModelResponse, error)
}

type ModelMetrics struct {
	Model          string         `json:"model"`
	Provider       string         `json:"provider"`
	TotalTasks     int            `json:"total_tasks"`
	CompletedTasks int            `json:"completed_tasks"`
	FailedTasks    int            `json:"failed_tasks"`
	TotalDuration  time.Duration  `json:"total_duration_ms"`
	TotalTokens    int64          `json:"total_tokens"`
	TotalCost      float64        `json:"total_cost"`
	AvgDuration    time.Duration  `json:"avg_duration_ms"`
	SuccessRate    float64        `json:"success_rate"`
	RoleUsage      map[string]int `json:"role_usage"` // role -> count
}

type ModelResponse struct {
	Model      string        `json:"model"`
	Output     string        `json:"output"`
	Duration   time.Duration `json:"duration"`
	Tokens     int64         `json:"tokens"`
	Cost       float64       `json:"cost"`
	Success    bool          `json:"success"`
	Error      string        `json:"error,omitempty"`
	Confidence float64       `json:"confidence"` // 0-1, model's confidence in response
}

type Pattern string

type Profile struct {
	// Metadata
	Name        string    `json:"name" toml:"name"`
	Description string    `json:"description" toml:"description"`
	Author      string    `json:"author" toml:"author"`
	Version     string    `json:"version" toml:"version"`
	CreatedAt   time.Time `json:"created_at" toml:"created_at"`
	UpdatedAt   time.Time `json:"updated_at" toml:"updated_at"`

	// Tags for discovery
	Tags []string `json:"tags,omitempty" toml:"tags"`

	// Use case description
	UseCase string `json:"use_case,omitempty" toml:"use_case"`

	// The actual configuration
	Config *Config `json:"config" toml:"config"`

	// Performance metrics (optional)
	Metrics *ProfileMetrics `json:"metrics,omitempty" toml:"metrics"`
}

type ProfileMetrics struct {
	TotalTasks      int     `json:"total_tasks" toml:"total_tasks"`
	SuccessRate     float64 `json:"success_rate" toml:"success_rate"`
	AvgCostPerTask  float64 `json:"avg_cost_per_task" toml:"avg_cost_per_task"`
	CostSavings     float64 `json:"cost_savings_percent" toml:"cost_savings_percent"`
	ReportedIssues  int     `json:"reported_issues" toml:"reported_issues"`
	CommunityRating float64 `json:"community_rating" toml:"community_rating"`
}

type ProviderConfig struct {
	// Enabled indicates if this provider is available.
	Enabled bool `json:"enabled" toml:"enabled"`

	// RateLimit is the rate limit in requests per minute.
	RateLimit int `json:"rate_limit,omitempty" toml:"rate_limit"`

	// Priority is used for fallback ordering (higher = preferred).
	Priority int `json:"priority,omitempty" toml:"priority"`

	// Models lists available models from this provider.
	Models []string `json:"models,omitempty" toml:"models"`
}

type ProviderHealth struct {
	Provider      string        `json:"provider"`
	Available     bool          `json:"available"`
	LastChecked   time.Time     `json:"last_checked"`
	ResponseTime  time.Duration `json:"response_time_ms"`
	FailureCount  int           `json:"failure_count"`
	CircuitState  string        `json:"circuit_state"`
	RateLimitHits int           `json:"rate_limit_hits"`
}

type ProviderMetrics struct {
	Provider       string        `json:"provider"`
	TotalTasks     int           `json:"total_tasks"`
	CompletedTasks int           `json:"completed_tasks"`
	FailedTasks    int           `json:"failed_tasks"`
	TotalCost      float64       `json:"total_cost"`
	RateLimitHits  int           `json:"rate_limit_hits"`
	AvgLatency     time.Duration `json:"avg_latency_ms"`
	Availability   float64       `json:"availability"` // 0-1
}

type RoleConfig struct {
	// Model is the primary model for this role.
	Model string `json:"model" toml:"model"`

	// Fallback is a list of fallback models if the primary is unavailable.
	Fallback []string `json:"fallback,omitempty" toml:"fallback"`

	// Rationale explains why this model was chosen for the role.
	Rationale string `json:"rationale,omitempty" toml:"rationale"`

	// ComplexityRouting enables routing based on task complexity.
	ComplexityRouting bool `json:"complexity_routing,omitempty" toml:"complexity_routing"`

	// Complexity defines model selection based on task complexity.
	Complexity *ComplexityConfig `json:"complexity,omitempty" toml:"complexity"`

	// Provider overrides the default provider detection.
	Provider string `json:"provider,omitempty" toml:"provider"`
}

type RoleMetrics struct {
	Role           string         `json:"role"`
	TotalTasks     int            `json:"total_tasks"`
	CompletedTasks int            `json:"completed_tasks"`
	FailedTasks    int            `json:"failed_tasks"`
	TotalDuration  time.Duration  `json:"total_duration_ms"`
	TotalTokens    int64          `json:"total_tokens"`
	TotalCost      float64        `json:"total_cost"`
	ModelUsage     map[string]int `json:"model_usage"` // model -> count
	AvgDuration    time.Duration  `json:"avg_duration_ms"`
	SuccessRate    float64        `json:"success_rate"`
}

type RouteRequest struct {
	// Role is the Gas Town role making the request.
	Role string

	// Task describes the task (optional, for complexity analysis).
	Task *TaskInfo

	// PreferredModel is an optional model override.
	PreferredModel string

	// ExcludeProviders lists providers to exclude (e.g., due to rate limits).
	ExcludeProviders []string
}

type RouteResult struct {
	// Model is the selected model.
	Model string

	// Provider is the provider for the model.
	Provider string

	// Rationale explains why this model was selected.
	Rationale string

	// Complexity is the assessed task complexity.
	Complexity ComplexityLevel

	// Fallback indicates if this is a fallback selection.
	Fallback bool

	// FallbackReason explains why fallback was needed.
	FallbackReason string
}

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

type StepResult struct {
	Name     string        `json:"name"`
	Model    string        `json:"model"`
	Input    string        `json:"input"`
	Output   string        `json:"output"`
	Duration time.Duration `json:"duration"`
	Success  bool          `json:"success"`
	Error    string        `json:"error,omitempty"`
}

type Summary struct {
	TotalTasks     int     `json:"total_tasks"`
	CompletedTasks int     `json:"completed_tasks"`
	TotalCost      float64 `json:"total_cost"`
	AvgSuccessRate float64 `json:"avg_success_rate"`
	TopModel       string  `json:"top_model"`
	TopProvider    string  `json:"top_provider"`
	CostSavings    float64 `json:"cost_savings_percent"`
}

type TaskInfo struct {
	// FilesAffected is the number of files the task will touch.
	FilesAffected int

	// LinesChanged is the estimated lines of code changed.
	LinesChanged int

	// IsArchitectural indicates if the change affects architecture.
	IsArchitectural bool

	// HasTests indicates if tests need to be written.
	HasTests bool

	// Description is a text description of the task.
	Description string
}

type TaskMetric struct {
	ID          string        `json:"id"`
	Role        string        `json:"role"`
	Model       string        `json:"model"`
	Provider    string        `json:"provider"`
	StartedAt   time.Time     `json:"started_at"`
	CompletedAt time.Time     `json:"completed_at,omitempty"`
	Duration    time.Duration `json:"duration_ms"`
	Tokens      int64         `json:"tokens,omitempty"`
	Cost        float64       `json:"cost,omitempty"`
	Success     bool          `json:"success"`
	Error       string        `json:"error,omitempty"`
	Complexity  string        `json:"complexity,omitempty"`
	Fallback    bool          `json:"fallback"`
}

type VotingStrategy string