Function operationSchema

pkg/tools/builtin/openapi/openapi.go:294–334

operationSchema builds a JSON Schema object describing the tool parameters.

(op *v3.Operation)

// operationSchema builds a JSON Schema object describing the tool parameters.
func operationSchema(op *v3.Operation) map[string]any {
	properties := map[string]any{}
	var required []string

	// Path and query parameters.
	for _, p := range op.Parameters {
		if p == nil {
			continue
		}

		prop := schemaProxyToProperty(p.Schema)
		if p.Description != "" {
			prop["description"] = p.Description
		}

		properties[p.Name] = prop
		if p.Required != nil && *p.Required {
			required = append(required, p.Name)
		}
	}

	// JSON request body properties (prefixed with "body_").
	if body := requestBodySchema(op); body != nil {
		for name, propProxy := range body.Properties.FromOldest() {
			properties["body_"+name] = schemaProxyToProperty(propProxy)
		}
		for _, req := range body.Required {
			required = append(required, "body_"+req)
		}
	}

	schema := map[string]any{
		"type":       "object",
		"properties": properties,
	}
	if len(required) > 0 {
		schema["required"] = required
	}

	return schema
}

// requestBodySchema extracts the JSON schema from an operation's request body, if any.
func requestBodySchema(op *v3.Operation) *base.Schema {