describe

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

type DiscoveryMetadata struct {
	Command            string   `json:"command,omitempty"`
	Args               []string `json:"args,omitempty"`
	WrapperImage       string   `json:"wrapper_image,omitempty"`
	WrapperImageDigest string   `json:"wrapper_image_digest,omitempty"`
	WrapperImageID     string   `json:"wrapper_image_id,omitempty"`
	DiscoveredAt       string   `json:"discovered_at,omitempty"`
	MCPProtocolVersion string   `json:"mcp_protocol_version,omitempty"`
	ToolCount          int      `json:"tool_count,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 MCPDescriptor struct {
	Transport string `json:"transport,omitempty"`
	Path      string `json:"path,omitempty"`
}

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"`
	MCP            *MCPDescriptor       `json:"mcp,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"`
	XClawDiscovery *DiscoveryMetadata   `json:"x-claw-discovery,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
	MCP         *MCPDescriptor
	Annotations map[string]interface{}
}