tools

type ArrayParameter struct {
	CommonParameter `yaml:",inline"`
	Items           Parameter `yaml:"items"`
}

type BooleanParameter struct {
	CommonParameter `yaml:",inline"`
}

type CommonParameter struct {
	Name string `yaml:"name"`
	Type string `yaml:"type"`
	Desc string `yaml:"description"`
}

type FloatParameter struct {
	CommonParameter `yaml:",inline"`
}

type IntParameter struct {
	CommonParameter `yaml:",inline"`
}

type Manifest struct {
	Description string              `json:"description"`
	Parameters  []ParameterManifest `json:"parameters"`
}

type ParamValue struct {
	Name  string
	Value any
}

type ParamValues []ParamValue

type Parameter interface {
	// Note: It's typically not idiomatic to include "Get" in the function name,
	// but this is done to differentiate it from the fields in CommonParameter.
	GetName() string
	GetType() string
	Parse(any) (any, error)
	Manifest() ParameterManifest
}

type ParameterManifest struct {
	Name        string `json:"name"`
	Type        string `json:"type"`
	Description string `json:"description"`
}

type Parameters []Parameter

type ParseTypeError struct {
	Name  string
	Type  string
	Value any
}

type StringParameter struct {
	CommonParameter `yaml:",inline"`
}

type Tool interface {
	Invoke(ParamValues) (string, error)
	ParseParams(data map[string]any) (ParamValues, error)
	Manifest() Manifest
}

type ToolConfig interface {
	ToolConfigKind() string
	Initialize(map[string]sources.Source) (Tool, error)
}

type Toolset struct {
	Name     string          `yaml:"name"`
	Tools    []*Tool         `yaml:",inline"`
	Manifest ToolsetManifest `yaml:",inline"`
}

type ToolsetConfig struct {
	Name      string   `yaml:"name"`
	ToolNames []string `yaml:",inline"`
}

type ToolsetManifest struct {
	ServerVersion string              `json:"serverVersion"`
	ToolsManifest map[string]Manifest `json:"tools"`
}