domain

type APISchema struct {
	// Source indicates the origin of the schema (e.g., URL, file path, gRPC reflection endpoint).
	Source string
	// Type specifies the kind of schema (OpenAPI, gRPC, etc.).
	Type SchemaType
	// RawData holds the unprocessed schema content.
	// For OpenAPI, this could be []byte of JSON/YAML.
	// For gRPC, this might be less relevant if reflection data is processed directly,
	// but could hold service/method names or file descriptors.
	RawData []byte
	// ParsedData holds the schema parsed into a library-specific representation.
	// This avoids reparsing in later stages. The actual type depends on the SchemaType.
	// Example: *openapi3.T for OpenAPI. Use interface{} to keep domain clean,
	// but requires type assertions downstream.
	ParsedData interface{}
}

type JSONSchemaProps struct {
	Type       string                     `json:"type"`                 // e.g., "object", "string", "number", "integer", "boolean", "array"
	Properties map[string]JSONSchemaProps `json:"properties,omitempty"` // For type "object"
	Required   []string                   `json:"required,omitempty"`   // For type "object"
	Items      *JSONSchemaProps           `json:"items,omitempty"`      // For type "array"
	Format     string                     `json:"format,omitempty"`     // e.g., "date-time", "email"
	Enum       []interface{}              `json:"enum,omitempty"`       // Possible values

}

type SchemaType string

type Tool struct {
	// Name follows the pattern "{namespace}-{verb}-{resource}" or "{namespace}-{action}".
	// It MUST be unique within the MCP server.
	Name string `json:"name"`

	// Description provides a natural language explanation of what the tool does.
	// This is crucial for the LLM to understand when to use the tool.
	Description string `json:"description"`

	// InputSchema defines the structure of the data the tool expects.
	// Uses JSON Schema format.
	InputSchema JSONSchemaProps `json:"input_schema"`

	// OutputSchema defines the structure of the data the tool returns upon successful invocation.
	// Optional. If omitted, the output is considered opaque or unstructured.
	// Uses JSON Schema format.
	OutputSchema *JSONSchemaProps `json:"output_schema,omitempty"`
}