core

type Adapter interface {
	// Name returns the name of the tool/format (e.g., "claude", "vscode").
	Name() string

	// DefaultPaths returns the default configuration file paths for this tool.
	DefaultPaths() []string

	// Parse parses tool-specific data into the canonical Config format.
	Parse(data []byte) (*Config, error)

	// Marshal converts the canonical Config to tool-specific format.
	Marshal(cfg *Config) ([]byte, error)

	// ReadFile reads a tool-specific config file and returns canonical Config.
	ReadFile(path string) (*Config, error)

	// WriteFile writes the canonical Config to a tool-specific file.
	WriteFile(cfg *Config, path string) error
}

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

type Config struct {
	// Servers is a map of server names to their configurations.
	Servers map[string]Server `json:"servers"`

	// Inputs defines input variables for sensitive data like API keys (VS Code feature).
	Inputs []InputVariable `json:"inputs,omitempty"`
}

type InputVariable struct {
	// Type is the input type, typically "promptString".
	Type string `json:"type"`

	// ID is the unique identifier referenced in server config as ${input:id}.
	ID string `json:"id"`

	// Description is the user-friendly prompt text.
	Description string `json:"description"`

	// Password hides typed input when true (for API keys and passwords).
	Password bool `json:"password,omitempty"`
}

type ParseError struct {
	Format string
	Path   string
	Err    error
}

type Server struct {
	// Transport specifies the communication protocol (stdio, http, sse).
	// If empty, it will be inferred from Command (stdio) or URL (http).
	Transport TransportType `json:"transport,omitempty"`

	// Command is the executable to launch for stdio servers.
	Command string `json:"command,omitempty"`

	// Args are the command-line arguments passed to the command.
	Args []string `json:"args,omitempty"`

	// Env contains environment variables for the server process.
	Env map[string]string `json:"env,omitempty"`

	// EnvFile is the path to an environment file to load (VS Code feature).
	EnvFile string `json:"envFile,omitempty"`

	// Cwd is the working directory for the server process (Codex feature).
	Cwd string `json:"cwd,omitempty"`

	// URL is the endpoint for HTTP/SSE servers.
	URL string `json:"url,omitempty"`

	// Headers contains HTTP headers for authentication or configuration.
	Headers map[string]string `json:"headers,omitempty"`

	// BearerTokenEnvVar is the name of an env var containing a bearer token (Codex feature).
	BearerTokenEnvVar string `json:"bearerTokenEnvVar,omitempty"`

	// EnabledTools is an allow-list of tools to expose (Codex/Cline feature).
	EnabledTools []string `json:"enabledTools,omitempty"`

	// DisabledTools is a deny-list of tools to hide (Codex/Cline feature).
	DisabledTools []string `json:"disabledTools,omitempty"`

	// AlwaysAllow lists tools that don't require user approval (Cline feature).
	AlwaysAllow []string `json:"alwaysAllow,omitempty"`

	// Enabled indicates whether the server is active. Defaults to true.
	Enabled *bool `json:"enabled,omitempty"`

	// StartupTimeoutSec is the timeout for server startup in seconds (Codex feature).
	StartupTimeoutSec int `json:"startupTimeoutSec,omitempty"`

	// ToolTimeoutSec is the timeout for tool execution in seconds (Codex feature).
	ToolTimeoutSec int `json:"toolTimeoutSec,omitempty"`

	// NetworkTimeoutSec is the timeout for network operations (Cline feature).
	NetworkTimeoutSec int `json:"networkTimeoutSec,omitempty"`
}

type ServerValidationError struct {
	Name string
	Err  error
}

type TransportType string

type WriteError struct {
	Format string
	Path   string
	Err    error
}