describe

type AuthDescriptor struct {
	Type string `json:"type"`
	Env  string `json:"env,omitempty"`
}

type EndpointDescriptor struct {
	Method      string `json:"method"`
	Path        string `json:"path"`
	Description string `json:"description,omitempty"`
}

type FeedDescriptor struct {
	Name        string `json:"name"`
	Path        string `json:"path"`
	TTL         int    `json:"ttl"`
	Description string `json:"description,omitempty"`
}

type FeedSpec struct {
	Name        string
	Source      string
	Path        string
	TTL         int
	Description string
	Auth        *AuthDescriptor
}

type MemoryDescriptor struct {
	Recall *MemoryEndpoint `json:"recall,omitempty"`
	Retain *MemoryEndpoint `json:"retain,omitempty"`
	Forget *MemoryEndpoint `json:"forget,omitempty"`
}

type MemoryEndpoint struct {
	Path string `json:"path"`
}

type ServiceDescriptor struct {
	Version     int                  `json:"version"`
	Description string               `json:"description,omitempty"`
	Feeds       []FeedDescriptor     `json:"feeds,omitempty"`
	Tools       []ToolDescriptor     `json:"tools,omitempty"`
	Memory      *MemoryDescriptor    `json:"memory,omitempty"`
	Endpoints   []EndpointDescriptor `json:"endpoints,omitempty"`
	Auth        *AuthDescriptor      `json:"auth,omitempty"`
	Skill       string               `json:"skill,omitempty"`
}

type ToolDescriptor struct {
	Name        string                 `json:"name"`
	Description string                 `json:"description"`
	InputSchema map[string]interface{} `json:"inputSchema"`
	HTTP        *ToolHTTP              `json:"http,omitempty"`
	Annotations map[string]interface{} `json:"annotations,omitempty"`
}

type ToolHTTP struct {
	Method  string `json:"method"`
	Path    string `json:"path"`
	Body    string `json:"body,omitempty"`
	BodyKey string `json:"body_key,omitempty"`
}

type ToolRegistry map[string][]ToolSpec

type ToolSpec struct {
	Name        string
	Service     string
	Description string
	InputSchema map[string]interface{}
	HTTP        *ToolHTTP
	Annotations map[string]interface{}
}