Module agentforge4j.tools.http

Package com.agentforge4j.tools.http

Class HttpToolProvider

java.lang.Object

com.agentforge4j.tools.http.HttpToolProvider

All Implemented Interfaces:

ToolProvider

public final class HttpToolProvider
extends Object
implements ToolProvider

ToolProvider that fulfils logical capabilities with single governed HTTP calls described by code-defined HttpEndpointDefinitions. It is the tool-SPI-native successor to the legacy endpoint-call command: capability resolution stays with the resolver; this provider maps one capability invocation to one request, applies a transient-only retry/timeout policy that can only tighten the runtime options, and maps the response to a ToolResult.

All definitions are validated at construction (fail-fast) so a bad configuration is rejected at wiring time, not mid-run. Secret header values are resolved through the supplied resolver at invoke time and are never inlined into a definition or routed through arguments.

Constructor Summary

Constructors

Constructor	Description
HttpToolProvider(String configuredName, List<HttpEndpointDefinition> definitions, Function<String,String> secretResolver, HttpClient httpClient, OutboundEgressGuard egressGuard, ToolExecutionOptions defaultOptions, long defaultMaxResponseBytes, com.fasterxml.jackson.databind.ObjectMapper objectMapper)	Creates a provider over a fixed set of endpoint definitions, validating them up front.

Method Summary

Modifier and Type	Method	Description
HealthStatus	health()
ToolResult	invoke(ToolDescriptor descriptor, String arguments, ToolInvocationContext ctx, ToolExecutionOptions options)	Invokes the resolved tool.
List<ToolDescriptor>	listTools()
String	providerId()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

HttpToolProvider

public HttpToolProvider(String configuredName,
 List<HttpEndpointDefinition> definitions,
 Function<String,String> secretResolver,
 HttpClient httpClient,
 OutboundEgressGuard egressGuard,
 ToolExecutionOptions defaultOptions,
 long defaultMaxResponseBytes,
 com.fasterxml.jackson.databind.ObjectMapper objectMapper)

Creates a provider over a fixed set of endpoint definitions, validating them up front.

Parameters:

configuredName - non-blank name; providerId() is "http:" + name

definitions - endpoint definitions; non-null, each validated up front

secretResolver - secret-reference key to value resolver, used at invoke time

httpClient - the JDK HTTP client used for all calls

egressGuard - SSRF egress guard consulted against each mapped URL before the call

defaultOptions - fallback execution options when none are supplied at invoke

defaultMaxResponseBytes - response body read cap for definitions that do not set one

Throws:

IllegalArgumentException - if the name is blank or any definition is invalid

Method Details

providerId

public String providerId()

Specified by:

providerId in interface ToolProvider

Returns:

stable, non-blank provider id, for example "mcp:github-official"

listTools

public List<ToolDescriptor> listTools()

Specified by:

listTools in interface ToolProvider

Returns:

descriptors for every tool this provider currently exposes

invoke

public ToolResult invoke(ToolDescriptor descriptor,
 String arguments,
 ToolInvocationContext ctx,
 ToolExecutionOptions options)

Description copied from interface: ToolProvider

Invokes the resolved tool.

Specified by:

invoke in interface ToolProvider

Parameters:

descriptor - resolved descriptor; use ToolSource.remoteToolName() for the remote name

arguments - tool arguments as JSON text, or null

ctx - invocation context

options - tunables; the provider may honour these best-effort, but the authoritative timeout is enforced by the execution service

Returns:

the invocation result

health

public HealthStatus health()

Specified by:

health in interface ToolProvider

Returns:

current provider health