http

type HttpInvocationConfig struct {
	// The URL for the HTTP request.
	//
	// It can contain placeholders in the form of {paramName} which correspond to parameters from the input schema.
	// It can contain placeholders in the form of {headers.paramName} which correspond to headers from the incoming
	// http request (won't work in stdio).
	// It can contain placeholders in the form of ${ENV_VAR_NAME} or {env.ENV_VAR_NAME} which correspond to env vars
	URL string `json:"url,omitempty" jsonschema:"required"` // even though this is required for the type, we don't require it on every nested extends instance of this struct, so we have omitempty

	// The headers for the HTTP request.
	//
	// Values can contain placeholders in the form of {paramName} which correspond to parameters from the input schema.
	// Values can contain placeholders in the form of {headers.paramName} which correspond to headers from the incoming
	// http request (won't work in stdio).
	// Values can contain placeholders in the form of ${ENV_VAR_NAME} or {env.ENV_VAR_NAME} which correspond to env vars
	Headers map[string]string `json:"headers,omitempty" jsonschema:"optional"`

	// The HTTP method to be used for the request (e.g., "GET", "POST").
	Method string `json:"method,omitempty" jsonschema:"required,enum=GET,enum=POST,enum=PUT,enum=PATCH,enum=DELETE,enum=HEAD"`

	// BodyRoot specifies a dot-separated path to a property whose value should be used as the HTTP request body.
	// This allows sending non-object request bodies, despite MCP requiring all tool call params to be rooted in
	// a top-level object.
	// Mutually exclusive with BodyAsArray
	BodyRoot string `json:"bodyRoot,omitempty" jsonschema:"optional"`

	// BodyAsArray wraps the entire request body into a JSON array.
	// For example, if the arguments are {"name": "foo"}, the HTTP body will be [{"name": "foo"}].
	// This is useful for APIs that expect array inputs but you want to expose a simpler single-item interface.
	// Mutually exclusive with BodyRoot.
	BodyAsArray bool `json:"bodyAsArray,omitempty" jsonschema:"optional"`
}

type HttpInvoker struct {
	ParsedTemplate  *template.ParsedTemplate            // Parsed template for the URL path
	HeaderTemplates map[string]*template.ParsedTemplate // Parsed templates for the headers
	Method          string                              // Http request method
	InputSchema     *jsonschema.Resolved                // InputSchema for the tool
	URITemplate     string                              // MCP URI template (for resource templates only)
	BodyRoot        string                              // Dot-separated path to extract as the request body
	BodyAsArray     bool                                // Wrap the entire body in a JSON array
}

type InvokerFactory struct{}