core

type Adapter interface {
	// Name returns the adapter identifier (e.g., "claude", "gemini").
	Name() string

	// FileExtension returns the file extension for agent files.
	FileExtension() string

	// DefaultDir returns the default directory name for agents.
	DefaultDir() string

	// Parse converts tool-specific bytes to canonical Agent.
	Parse(data []byte) (*Agent, error)

	// Marshal converts canonical Agent to tool-specific bytes.
	Marshal(agent *Agent) ([]byte, error)

	// ReadFile reads from path and returns canonical Agent.
	ReadFile(path string) (*Agent, error)

	// WriteFile writes canonical Agent to path.
	WriteFile(agent *Agent, path string) error
}

type AdapterError struct {
	Name string
}

type Agent struct {
	// Name is the unique identifier for the agent (e.g., "release-coordinator").
	Name string `json:"name"`

	// Description is a brief summary of what the agent does and when to use it.
	// Example: "Orchestrates software releases including versioning and tagging."
	Description string `json:"description,omitempty"`

	// Instructions are the detailed system prompt for the agent.
	// This is the full guidance on how the agent should behave.
	Instructions string `json:"instructions,omitempty"`

	// Model is the preferred AI model (e.g., "haiku", "sonnet", "opus").
	Model string `json:"model,omitempty"`

	// Tools are the tools available to the agent (e.g., "Read", "Write", "Bash").
	Tools []string `json:"tools,omitempty"`

	// Skills are capabilities or skills the agent can invoke.
	Skills []string `json:"skills,omitempty"`

	// Dependencies are external CLI tools required by this agent.
	Dependencies []string `json:"dependencies,omitempty"`
}

type MarshalError struct {
	Format string
	Err    error
}

type ParseError struct {
	Format string
	Path   string
	Err    error
}

type ReadError struct {
	Path string
	Err  error
}

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

type WriteError struct {
	Path string
	Err  error
}