Module agentforge4j.runtime

Package com.agentforge4j.runtime.llm

Class AgentInvocationResult.Builder

java.lang.Object

com.agentforge4j.runtime.llm.AgentInvocationResult.Builder

Enclosing class:

AgentInvocationResult

public static final class AgentInvocationResult.Builder
extends Object

Fluent builder for AgentInvocationResult. Lets callers omit the tier-resolution metadata without passing trailing arguments to the canonical constructor. Validation is deferred to build(), which delegates to the canonical constructor.

Method Summary

Modifier and Type	Method	Description
AgentInvocationResult	build()	Builds the validated AgentInvocationResult.
AgentInvocationResult.Builder	withCommands(List<LlmCommand> commands)	Sets the parsed commands from the response.
AgentInvocationResult.Builder	withModelSource(ModelSource modelSource)	Sets how resolvedModel was determined.
AgentInvocationResult.Builder	withModelUsed(String modelUsed)	Sets the concrete model the provider ran.
AgentInvocationResult.Builder	withRawResponse(String rawResponse)	Sets the raw model output text before command parsing.
AgentInvocationResult.Builder	withRequestedModelTier(ModelTier requestedModelTier)	Sets the capability tier requested for this call.
AgentInvocationResult.Builder	withResolvedModel(String resolvedModel)	Sets the model string the runtime resolved and sent on the request.
AgentInvocationResult.Builder	withTokenUsage(TokenUsageReport tokenUsage)	Sets the token counts for this invocation.

Methods inherited from class java.lang.Object

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

Method Details

withRawResponse

public AgentInvocationResult.Builder withRawResponse(String rawResponse)

Sets the raw model output text before command parsing.

Parameters:

rawResponse - non-blank raw response text

Returns:

this builder

withCommands

public AgentInvocationResult.Builder withCommands(List<LlmCommand> commands)

Sets the parsed commands from the response.

Parameters:

commands - parsed commands; must not be null

Returns:

this builder

withModelUsed

public AgentInvocationResult.Builder withModelUsed(String modelUsed)

Sets the concrete model the provider ran.

Parameters:

modelUsed - model the provider reported; nullable

Returns:

this builder

withTokenUsage

public AgentInvocationResult.Builder withTokenUsage(TokenUsageReport tokenUsage)

Sets the token counts for this invocation.

Parameters:

tokenUsage - token usage; nullable

Returns:

this builder

withResolvedModel

public AgentInvocationResult.Builder withResolvedModel(String resolvedModel)

Sets the model string the runtime resolved and sent on the request.

Parameters:

resolvedModel - resolved model; null for ModelSource.PROVIDER_DEFAULT

Returns:

this builder

withModelSource

public AgentInvocationResult.Builder withModelSource(ModelSource modelSource)

Sets how resolvedModel was determined. Defaults to ModelSource.PROVIDER_DEFAULT when not set.

Parameters:

modelSource - model source; must not be null

Returns:

this builder

withRequestedModelTier

public AgentInvocationResult.Builder withRequestedModelTier(ModelTier requestedModelTier)

Sets the capability tier requested for this call.

Parameters:

requestedModelTier - requested tier, or null when no tier applied

Returns:

this builder

build

public AgentInvocationResult build()

Builds the validated AgentInvocationResult.

Returns:

immutable invocation result; never null