registry

type AgentConfig struct {
	// ID is the unique identifier for the agent (used as model name).
	ID string `json:"id" yaml:"id"`

	// Name is the human-readable display name.
	Name string `json:"name" yaml:"name"`

	// Description provides additional context about the agent's purpose.
	Description string `json:"description,omitempty" yaml:"description,omitempty"`

	// Provider is the LLM provider (e.g., "anthropic", "openai").
	Provider string `json:"provider" yaml:"provider"`

	// Model is the LLM model to use (e.g., "claude-sonnet-4-20250514").
	Model string `json:"model" yaml:"model"`

	// APIKey is the API key for the provider (optional, can use env var).
	APIKey string `json:"api_key,omitempty" yaml:"api_key,omitempty"` //nolint:gosec // G101: API key intentionally stored

	// BaseURL is an optional custom base URL for the provider.
	BaseURL string `json:"base_url,omitempty" yaml:"base_url,omitempty"`

	// Temperature controls randomness (0.0-2.0).
	Temperature float64 `json:"temperature,omitempty" yaml:"temperature,omitempty"`

	// MaxTokens limits the response length.
	MaxTokens int `json:"max_tokens,omitempty" yaml:"max_tokens,omitempty"`

	// SystemPrompt is the system message for the agent.
	SystemPrompt string `json:"system_prompt,omitempty" yaml:"system_prompt,omitempty"`

	// AllowedTools limits which tools this agent can use (empty = all).
	AllowedTools []string `json:"allowed_tools,omitempty" yaml:"allowed_tools,omitempty"`

	// DeniedTools excludes specific tools from this agent.
	DeniedTools []string `json:"denied_tools,omitempty" yaml:"denied_tools,omitempty"`

	// Enabled determines if the agent is active. Defaults to true.
	Enabled *bool `json:"enabled,omitempty" yaml:"enabled,omitempty"`

	// CreatedAt is when the agent was created.
	CreatedAt time.Time `json:"created_at" yaml:"created_at"`

	// UpdatedAt is when the agent was last modified.
	UpdatedAt time.Time `json:"updated_at" yaml:"updated_at"`
}

type AgentFactory func(cfg *AgentConfig) (*agent.Agent, error)

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

type RegistryConfig struct {
	// Store is the persistent storage for agent configs.
	Store *Store

	// Defaults provides fallback values for new agents.
	Defaults *AgentConfig

	// Factory creates agents from configs. If nil, uses DefaultAgentFactory.
	Factory AgentFactory

	// Logger for registry operations.
	Logger *slog.Logger
}

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

type StoreConfig struct {
	// Backend is the KVS storage backend.
	Backend kvs.Store
}