Method GetRequestSchema

backend/api/mcp/openapi_index.go:419–468

GetRequestSchema returns the simplified schema properties for a request type.

(schemaRef string)

// GetRequestSchema returns the simplified schema properties for a request type.
func (idx *OpenAPIIndex) GetRequestSchema(schemaRef string) []PropertyInfo {
	if schemaRef == "" || idx.doc.Model.Components == nil || idx.doc.Model.Components.Schemas == nil {
		return nil
	}

	// Extract schema name from ref: "#/components/schemas/bytebase.v1.QueryRequest"
	parts := strings.Split(schemaRef, "/")
	schemaName := parts[len(parts)-1]

	schemaProxy, ok := idx.doc.Model.Components.Schemas.Get(schemaName)
	if !ok || schemaProxy == nil {
		return nil
	}

	schema := schemaProxy.Schema()
	if schema == nil {
		return nil
	}

	var props []PropertyInfo
	requiredSet := make(map[string]bool)
	for _, r := range schema.Required {
		requiredSet[r] = true
	}

	if schema.Properties == nil {
		return nil
	}

	for pair := schema.Properties.First(); pair != nil; pair = pair.Next() {
		name := pair.Key()
		prop := pair.Value()

		propType, desc := extractPropertyTypeAndDesc(prop)

		props = append(props, PropertyInfo{
			Name:        name,
			Type:        propType,
			Description: desc,
			Required:    requiredSet[name],
		})
	}

	// Sort by name for consistent output
	slices.SortFunc(props, func(a, b PropertyInfo) int {
		return strings.Compare(a.Name, b.Name)
	})

	return props
}

// extractPropertyTypeAndDesc extracts the type string and description from a schema property.
// For arrays, it includes the item type (e.g., "array<string>").