Uses of Annotation Interface
dev.langchain4j.Internal

Packages that use Internal

Package	Description
dev.langchain4j.agentic
dev.langchain4j.agentic.agent
dev.langchain4j.agentic.declarative
dev.langchain4j.agentic.internal
dev.langchain4j.agentic.observability
dev.langchain4j.agentic.scope
dev.langchain4j.data.message
dev.langchain4j.guardrail
dev.langchain4j.http.client.log
dev.langchain4j.http.client.sse
dev.langchain4j.internal
dev.langchain4j.invocation
dev.langchain4j.jackson3
dev.langchain4j.jackson3.inmemory
dev.langchain4j.mcp.client.transport
dev.langchain4j.mcp.protocol
dev.langchain4j.mcp.registryclient
dev.langchain4j.mcp.transport.stdio
dev.langchain4j.model.anthropic.internal.client
dev.langchain4j.model.anthropic.internal.mapper
dev.langchain4j.model.chat
dev.langchain4j.model.embedding
dev.langchain4j.model.input.structured
dev.langchain4j.model.mistralai.internal.client
dev.langchain4j.model.mistralai.internal.mapper
dev.langchain4j.model.openai
dev.langchain4j.model.openai.internal
dev.langchain4j.model.openai.internal.decision
dev.langchain4j.model.openai.spi
dev.langchain4j.model.typesafe.internal
dev.langchain4j.model.vertexai.anthropic.internal.client
dev.langchain4j.reactive.streaming
dev.langchain4j.service
dev.langchain4j.service.decision.internal
dev.langchain4j.service.guardrail
dev.langchain4j.service.memory
dev.langchain4j.service.output
dev.langchain4j.service.tool
dev.langchain4j.service.tool.search
dev.langchain4j.service.tool.search.decision
dev.langchain4j.spi
dev.langchain4j.spi.agent.tool
dev.langchain4j.spi.data.document.parser
dev.langchain4j.spi.data.document.splitter
dev.langchain4j.spi.data.message
dev.langchain4j.spi.json
dev.langchain4j.spi.model.embedding
dev.langchain4j.spi.observability
dev.langchain4j.spi.prompt
dev.langchain4j.spi.prompt.structured
dev.langchain4j.spi.services
dev.langchain4j.spi.store.embedding.inmemory
dev.langchain4j.store.embedding.inmemory
dev.langchain4j.test.internal
dev.langchain4j.test.service.internal

Uses of Internal in dev.langchain4j.agentic

Classes in dev.langchain4j.agentic with annotations of type Internal

Modifier and Type	Class	Description
static final class	AgenticServices.DefaultDeclarativeDecisionAgentCreationContext<T>

Uses of Internal in dev.langchain4j.agentic.agent

Classes in dev.langchain4j.agentic.agent with annotations of type Internal

Modifier and Type	Class	Description
class	DecisionAgentInvocationHandler	The invocation handler of the proxy of a decision agent: it implements the agent method with a call to the decision model, hands the response of the model to the AgentModelResponse of the invocation for the listeners, and answers the AgentInstance methods.

Methods in dev.langchain4j.agentic.agent with annotations of type Internal

Modifier and Type	Method	Description
DecisionAgentBuilder<T>	DecisionAgentBuilder.agentInstanceFactory(Function<InternalAgent, Object> factory)
Object	AgentInvocationHandler.aiService()
boolean	DecisionAgentBuilder.hasDecisionModel()	Whether a decision model, or a provider of it, has been set.
static <T> AgentBuilder<T, AgentBuilder<T,?>>	AgentBuilder.withoutDeclarativeConfiguration(Class<T> agentServiceClass)
static <T> DecisionAgentBuilder<T>	DecisionAgentBuilder.withoutDeclarativeConfiguration(Class<T> agentServiceClass)

Uses of Internal in dev.langchain4j.agentic.declarative

Classes in dev.langchain4j.agentic.declarative with annotations of type Internal

Modifier and Type	Class	Description
class	DeclarativeUtil

Uses of Internal in dev.langchain4j.agentic.internal

Classes in dev.langchain4j.agentic.internal with annotations of type Internal

Modifier and Type	Class	Description
final class	ActivationConditions	The single place deciding whether an agent is active according to its activation condition.
final class	AgentHelpers	Locates the helper methods of a declarative agent: the static methods of the agent type, as declared on it or inherited, and the instance methods of its helper objects, searched in the class hierarchy of each object.
interface	AgenticScopeOwner
final class	AgentModelResponse	The response of the model called by one invocation of an AI or decision agent, as reported to the agent's listeners after the invocation.
final record	HelperMethod	A helper method of a declarative agent, with the object it is invoked on: a static method of the agent type, whose target is null, or an instance method of a helper object.
final class	LazyResolution<T>	A value resolved lazily, the first time it is needed, from something that may be unavailable or slow, like the server of a remote agent.
final class	ResolvedParameters	The parameters of a helper method of an agent, a static method declared on the agent type or an instance method of one of its helper objects, split once, when the agent is created, between the parameters provided by a registered SupplierParameterResolver and the parameters provided by the agentic framework, like the AgenticScope, its state, the memory id or a value passed by the caller.

Uses of Internal in dev.langchain4j.agentic.observability

Classes in dev.langchain4j.agentic.observability with annotations of type Internal

Modifier and Type	Class	Description
class	ComposedAgentListener

Methods in dev.langchain4j.agentic.observability with annotations of type Internal

Modifier and Type	Method	Description
void	AgentMonitor.asyncAgentCompleted(AgenticScope agenticScope, String agentId, boolean failed)	Notified by the agentic system when an asynchronous agent submitted with AgentMonitor.asyncAgentSubmitted(AgentRequest) completes, after its error handler ran if it failed: the execution stays ongoing until then, since the failure of the agent is reported to AgentMonitor.onAgentInvocationError(AgentInvocationError) before the handler decides whether to recover it.
void	AgentMonitor.asyncAgentSubmitted(AgentRequest agentRequest)	Notified by the agentic system when an asynchronous agent is submitted to its executor, on the submitting thread, before the AgentMonitor.beforeAgentInvocation(AgentRequest) of the agent is notified on the thread of the executor: the invocation is nested under its parent, still ongoing at that point, also when the executor starts the agent after the parent completed.
void	AgentMonitor.setRootAgent(AgentInstance rootAgent)

Uses of Internal in dev.langchain4j.agentic.scope

Classes in dev.langchain4j.agentic.scope with annotations of type Internal

Modifier and Type	Interface	Description
interface	AgenticScopeJsonCodec	A codec for serializing and deserializing DefaultAgenticScope objects to and from JSON.
class	AgenticScopeRegistry	Singleton registry for managing AgenticScope instances.
class	DefaultAgenticScope
final class	PersistedDecisionAnswers	The persistable form of the answers that decision agents write to the AgenticScope: Choice and Scale are generic in their enum type, which the JSON serialization of the scope would lose, and none of the three types has a constructor a JSON library can call.

Uses of Internal in dev.langchain4j.data.message

Classes in dev.langchain4j.data.message with annotations of type Internal

Modifier and Type	Interface	Description
interface	ChatMessageJsonCodec	A codec for serializing and deserializing ChatMessage objects to and from JSON.
class	JacksonChatMessageJsonCodec

Uses of Internal in dev.langchain4j.guardrail

Classes in dev.langchain4j.guardrail with annotations of type Internal

Modifier and Type	Class	Description
class	AbstractGuardrailExecutor<C extends GuardrailsConfig, P extends GuardrailRequest<P>, R extends GuardrailResult<R>, G extends Guardrail<P,R>, E extends GuardrailExecutedEvent<P,R,G>, F extends GuardrailResult.Failure>	Abstract base class for GuardrailExecutors.

Uses of Internal in dev.langchain4j.http.client.log

Classes in dev.langchain4j.http.client.log with annotations of type Internal

Modifier and Type	Class	Description
class	LoggingHttpClient	An HttpClient decorator that logs requests and responses.

Uses of Internal in dev.langchain4j.http.client.sse

Classes in dev.langchain4j.http.client.sse with annotations of type Internal

Modifier and Type	Class	Description
class	CancellationUnsupportedHandle
class	ServerSentEventListenerUtils
class	ServerSentEventParsingHandleUtils

Uses of Internal in dev.langchain4j.internal

Classes in dev.langchain4j.internal with annotations of type Internal

Modifier and Type	Class	Description
final class	AsyncNotSupported	Factory for the "not implemented" result of an asynchronous / reactive SPI default method.
final class	CancellationChain	Propagates cancellation from a single caller-facing "root" future to every downstream future produced while composing an asynchronous, possibly fan-out, pipeline (e.g. the RAG graph: transform → route → retrieve over many queries × retrievers).
class	ChatRequestValidationUtils
class	CompletableFutureUtils	Utility methods for working with CompletableFuture.
final class	CurrentInvocation	Holds the InvocationContext.invocationId() of the AI Service invocation that is doing its own work on the current thread (for example running a tool, a guardrail, retrieval or the chatRequestTransformer), so that an AI Service invoked by that work can record it as its parent invocation.
class	CustomMimeTypesFileTypeDetector	Utility class to guess the mime-type of a file from its path or URI.
class	DecisionModelInputUtils	Converts chat messages into the input of a DecisionModel, the same way for all components that use one.
class	DefaultExecutorProvider	Resolves the Executor that LangChain4j uses to offload blocking work and run its asynchronous continuations.
interface	ExceptionMapper
class	Exceptions	Utility methods for creating common exceptions.
final class	HandlerWithoutInvocation	Wraps the handler an AI Service passes to its streaming chat model, so that the handler runs without the current invocation, also when the model calls it on the thread of the call, during the call.
class	InternalFlowUtils
class	InternalStreamingChatResponseHandlerUtils
@interface	JacocoIgnoreCoverageGenerated	Annotation to mark methods where JaCoCo coverage should be ignored.
class	Json	JSON helper class.
static interface	Json.JsonCodec	The abstract JSON codec interface.
class	JsonParsingUtils
class	JsonSchemaElementJsonUtils	Converts between JsonSchemaElement and JSON Schema Map representation with round-trip fidelity.
class	JsonSchemaElementUtils
class	MappingTrackingStreamingChatResponseHandler	Delegating StreamingChatResponseHandler that records whether the underlying handler received any typed, user-facing callback (partial response/thinking/tool call, complete tool call, complete response or error) while processing a single provider streaming event - i.e. whether the event was mapped to a typed callback.
class	Markers
final class	ObservabilityListeners	Adds the listeners of the ObservabilityListenersProviders found with ServiceLoader to AI Services and to model calls.
final class	PolymorphicTypes	Detection and naming for polymorphic base types — sealed interfaces / classes (no annotations needed) and types annotated with Jackson's JsonSubTypes.
final class	ProviderJson	Entry point for the JSON codec used by provider wire DTOs.
class	ProviderJsonSpec	Describes how a provider's wire DTOs are mapped to JSON, in terms that carry no dependency on a particular JSON library.
final class	RetryUtils	Utility class for retrying actions.
final class	StateJson	Entry point for the JSON codec used where values are not known ahead of time and their types have to be written into the document.
class	ToolCallBuilder	Internal helper that helps to build partial and complete tool calls during streaming.
class	ToolSpecificationJsonUtils	Handles JSON serialization and deserialization of ToolSpecification.
class	ToolSpecificationUtils
class	TypeAllowlist	Decides which types may be instantiated while reading JSON that carries type information.
final class	Types	Builds Type instances for generic types, so that a caller can ask a Json.JsonCodec for a List<Foo> without a JSON library's type token.
class	Utils	Utility methods.
class	ValidationUtils	Utility class for validating method arguments.
class	VirtualThreadUtils	Utility class for working with virtual threads introduced in Java 21.

Uses of Internal in dev.langchain4j.invocation

Classes in dev.langchain4j.invocation with annotations of type Internal

Modifier and Type	Class	Description
final class	CapturedContextSupport	Carries the context of the thread that started an AI Service invocation, captured with ExecutorProvider.captureContext(), in the InvocationContext of the invocation, so that every task the invocation offloads runs with it, whichever thread submits the task.
interface	LangChain4jManaged	A marker interface for components that are managed by LangChain4j framework.

Uses of Internal in dev.langchain4j.jackson3

Classes in dev.langchain4j.jackson3 with annotations of type Internal

Modifier and Type	Class	Description
class	Jackson3ChatMessageJsonCodec	Jackson 3 twin of JacksonChatMessageJsonCodec.
class	Jackson3ChatMessageJsonCodecFactory
final class	Jackson3Defaults	Jackson 3 changed a number of defaults.
class	Jackson3JsonCodec	Jackson 3 implementation of Json.JsonCodec.
class	Jackson3JsonCodecFactory
class	Jackson3ProviderJsonCodec	Jackson 3 codec for provider wire DTOs.
class	Jackson3ProviderJsonCodecFactory
class	Jackson3StateJsonCodec	Jackson 3 codec for JSON that carries type information.
class	Jackson3StateJsonCodecFactory
class	Jackson3StructuredPromptFactory	Jackson 3 twin of the default structured prompt factory.
class	Jackson3ToolSpecificationJsonCodec	Jackson 3 twin of the default tool specification codec.
class	Jackson3ToolSpecificationJsonCodecFactory

Uses of Internal in dev.langchain4j.jackson3.inmemory

Classes in dev.langchain4j.jackson3.inmemory with annotations of type Internal

Modifier and Type	Class	Description
class	Jackson3InMemoryEmbeddingStoreJsonCodec	Jackson 3 twin of the default in-memory embedding store codec.
class	Jackson3InMemoryEmbeddingStoreJsonCodecFactory

Uses of Internal in dev.langchain4j.mcp.client.transport

Classes in dev.langchain4j.mcp.client.transport with annotations of type Internal

Modifier and Type	Class	Description
class	McpHeaderEncoding	Encodes MCP header values per the spec's Value Encoding rule.
final class	McpJson	Reads and writes MCP payloads through the pluggable JSON codec.

Uses of Internal in dev.langchain4j.mcp.protocol

Classes in dev.langchain4j.mcp.protocol with annotations of type Internal

Modifier and Type	Class	Description
class	McpCallToolParams	Corresponds to the params of the CallToolRequest type from the MCP schema.
class	McpCallToolRequest	Corresponds to the CallToolRequest type from the MCP schema.
class	McpCallToolResult	Corresponds to the CallToolResult type from the MCP schema.
class	McpCancellationNotification	Corresponds to the CancelledNotification type from the MCP schema.
class	McpCancellationParams	Corresponds to the params of the CancelledNotification type from the MCP schema.
class	McpClientMessage
class	McpClientNotification	Corresponds to the JSONRPCNotification type from the MCP schema.
class	McpClientParams	Corresponds to the params of the JSONRPCRequest type from the MCP schema.
class	McpClientRequest	Corresponds to the JSONRPCRequest type from the MCP schema.
class	McpClientResponse	Corresponds to the JSONRPCResponse type from the MCP schema.
class	McpErrorResponse	Corresponds to the JSONRPCError type from the MCP schema.
class	McpGetPromptParams	Corresponds to the params of the GetPromptRequest type from the MCP schema.
class	McpGetPromptRequest	Corresponds to the GetPromptRequest type from the MCP schema.
class	McpGetPromptResponse	Corresponds to the GetPromptResult type from the MCP schema.
class	McpImplementation	Corresponds to the Implementation type from the MCP schema.
class	McpInitializationNotification	Corresponds to the InitializedNotification type from the MCP schema.
class	McpInitializeParams	Corresponds to the params of the InitializeRequest type from the MCP schema.
class	McpInitializeRequest	Corresponds to the InitializeRequest type from the MCP schema.
class	McpInitializeResult	Corresponds to the InitializeResult type from the MCP schema.
class	McpJsonRpcMessage	Corresponds to the JSONRPCMessage type from the MCP schema.
class	McpListPromptsParams	Corresponds to the params of the ListPromptsRequest type from the MCP schema.
class	McpListPromptsRequest	Corresponds to the ListPromptsRequest type from the MCP schema.
class	McpListPromptsResult	Corresponds to the ListPromptsResult type from the MCP schema.
class	McpListResourcesParams	Corresponds to the params of the ListResourcesRequest type from the MCP schema.
class	McpListResourcesRequest	Corresponds to the ListResourcesRequest type from the MCP schema.
class	McpListResourcesResult	Corresponds to the ListResourcesResult type from the MCP schema.
class	McpListResourceTemplatesParams	Corresponds to the params of the ListResourceTemplatesRequest type from the MCP schema.
class	McpListResourceTemplatesRequest	Corresponds to the ListResourceTemplatesRequest type from the MCP schema.
class	McpListResourceTemplatesResult	Corresponds to the ListResourceTemplatesResult type from the MCP schema.
class	McpListToolsParams	Corresponds to the params of the ListToolsRequest type from the MCP schema.
class	McpListToolsRequest	Corresponds to the ListToolsRequest type from the MCP schema.
class	McpListToolsResult	Corresponds to the ListToolsResult type from the MCP schema.
class	McpPaginatedResult	The pagination envelope shared by every list operation in the MCP schema.
class	McpPingRequest	Corresponds to the PingRequest type from the MCP schema.
class	McpPingResponse	Corresponds to the EmptyResult type from the MCP schema (response to a PingRequest).
class	McpReadResourceParams	Corresponds to the params of the ReadResourceRequest type from the MCP schema.
class	McpReadResourceRequest	Corresponds to the ReadResourceRequest type from the MCP schema.
class	McpReadResourceResponse	Corresponds to the ReadResourceResult type from the MCP schema.
class	McpRootsListChangedNotification	Corresponds to the RootsListChangedNotification type from the MCP schema.
class	McpRootsListResponse	Corresponds to the ListRootsResult type from the MCP schema.
class	McpServerDiscoverParams	Corresponds to the params of the ServerDiscoverRequest type from the MCP schema.
class	McpServerDiscoverRequest	Corresponds to the ServerDiscoverRequest type from the MCP schema.
class	McpServerDiscoverResponse	Corresponds to the result of server/discover in the modern MCP protocol.
enum	McpServerMethod	Enum representing method names for server-initiated MCP messages.
class	McpSubscribeResourceRequest	Only used with the legacy MCP protocol (versions up to 2025-11-25).
class	McpSubscriptionsListenParams
static class	McpSubscriptionsListenParams.Notifications
class	McpSubscriptionsListenRequest	Corresponds to the SubscriptionsListenRequest type from the MCP schema.
class	McpUnsubscribeResourceRequest	Only used with the legacy MCP protocol (versions up to 2025-11-25).

Uses of Internal in dev.langchain4j.mcp.registryclient

Classes in dev.langchain4j.mcp.registryclient with annotations of type Internal

Modifier and Type	Class	Description
class	McpRegistryJson

Uses of Internal in dev.langchain4j.mcp.transport.stdio

Classes in dev.langchain4j.mcp.transport.stdio with annotations of type Internal

Modifier and Type	Class	Description
class	JsonRpcIoHandler

Uses of Internal in dev.langchain4j.model.anthropic.internal.client

Classes in dev.langchain4j.model.anthropic.internal.client with annotations of type Internal

Modifier and Type	Class	Description
class	AnthropicClient
interface	AnthropicClientBuilderFactory
class	AnthropicCreateMessageOptions
class	DefaultAnthropicClient	Default implementation of AnthropicClient that provides methods to interact with the Anthropic API for creating messages, counting tokens, and listing models.
class	Json

Uses of Internal in dev.langchain4j.model.anthropic.internal.mapper

Classes in dev.langchain4j.model.anthropic.internal.mapper with annotations of type Internal

Modifier and Type	Class	Description
class	AnthropicMapper

Uses of Internal in dev.langchain4j.model.chat

Classes in dev.langchain4j.model.chat with annotations of type Internal

Modifier and Type	Class	Description
final class	StreamingChatModelHelper	Bridges a single reactive StreamingChatModel.chat(ChatRequest) call to a CompletableFuture of its terminal ChatResponse: it subscribes with unbounded demand and completes the future with the last ChatResponse emitted by the stream.

Uses of Internal in dev.langchain4j.model.embedding

Classes in dev.langchain4j.model.embedding with annotations of type Internal

Modifier and Type	Class	Description
class	EmbeddingModelListenerUtils

Uses of Internal in dev.langchain4j.model.input.structured

Classes in dev.langchain4j.model.input.structured with annotations of type Internal

Modifier and Type	Class	Description
class	StructuredPromptProcessor	Utility class for structured prompts.

Uses of Internal in dev.langchain4j.model.mistralai.internal.client

Classes in dev.langchain4j.model.mistralai.internal.client with annotations of type Internal

Modifier and Type	Class	Description
class	DefaultMistralAiClient
class	MistralAiClient
interface	MistralAiClientBuilderFactory

Uses of Internal in dev.langchain4j.model.mistralai.internal.mapper

Classes in dev.langchain4j.model.mistralai.internal.mapper with annotations of type Internal

Modifier and Type	Class	Description
class	MistralAiMapper

Uses of Internal in dev.langchain4j.model.openai

Classes in dev.langchain4j.model.openai with annotations of type Internal

Modifier and Type	Class	Description
class	OpenAiStreamingResponseBuilder	This class needs to be thread safe because it is called when a streaming result comes back and there is no guarantee that this thread will be the same as the one that initiated the request, in fact it almost certainly won't be.

Uses of Internal in dev.langchain4j.model.openai.internal

Classes in dev.langchain4j.model.openai.internal with annotations of type Internal

Modifier and Type	Class	Description
final class	ChatCompletionEventDispatcher
final record	ChatCompletionOptions
class	OpenAiUtils
class	ParsedAndRawResponse<R>

Uses of Internal in dev.langchain4j.model.openai.internal.decision

Classes in dev.langchain4j.model.openai.internal.decision with annotations of type Internal

Modifier and Type	Class	Description
class	DecisionCreateRequest	The body of POST /decisions.
class	DecisionCreateResponse	The body of the response to POST /decisions.
final class	DecisionMapper	Converts between the DecisionModel API and the OpenAI Decisions API.

Uses of Internal in dev.langchain4j.model.openai.spi

Classes in dev.langchain4j.model.openai.spi with annotations of type Internal

Modifier and Type	Interface	Description
interface	OpenAiAudioTranscriptionModelBuilderFactory	A factory for building OpenAiAudioTranscriptionModel.Builder instances.
interface	OpenAiChatModelBuilderFactory	A factory for building OpenAiChatModel.OpenAiChatModelBuilder instances.
interface	OpenAiDecisionModelBuilderFactory	A factory for building OpenAiDecisionModel.OpenAiDecisionModelBuilder instances.
interface	OpenAiEmbeddingModelBuilderFactory	A factory for building OpenAiEmbeddingModel.OpenAiEmbeddingModelBuilder instances.
interface	OpenAiImageModelBuilderFactory	A factory for building OpenAiImageModel.OpenAiImageModelBuilder instances.
interface	OpenAiLanguageModelBuilderFactory	A factory for building OpenAiLanguageModel.OpenAiLanguageModelBuilder instances.
interface	OpenAiModerationModelBuilderFactory	A factory for building OpenAiModerationModel.OpenAiModerationModelBuilder instances.
interface	OpenAiStreamingChatModelBuilderFactory	A factory for building OpenAiStreamingChatModel.OpenAiStreamingChatModelBuilder instances.
interface	OpenAiStreamingLanguageModelBuilderFactory	A factory for building OpenAiStreamingLanguageModel.OpenAiStreamingLanguageModelBuilder instances.
interface	OpenAiTextToSpeechModelBuilderFactory	A factory for building OpenAiTextToSpeechModel.Builder instances.

Uses of Internal in dev.langchain4j.model.typesafe.internal

Classes in dev.langchain4j.model.typesafe.internal with annotations of type Internal

Modifier and Type	Class	Description
class	TypeSafeAnswer
class	TypeSafeClient
final class	TypeSafeMapper	Maps DecisionRequests to the System One request format and System One responses to DecisionResponses.
class	TypeSafeQuestion
class	TypeSafeRequest
class	TypeSafeResponse
class	TypeSafeUsage

Uses of Internal in dev.langchain4j.model.vertexai.anthropic.internal.client

Classes in dev.langchain4j.model.vertexai.anthropic.internal.client with annotations of type Internal

Modifier and Type	Class	Description
class	VertexAiAnthropicJsonUtils

Uses of Internal in dev.langchain4j.reactive.streaming

Classes in dev.langchain4j.reactive.streaming with annotations of type Internal

Modifier and Type	Class	Description
final class	HttpStreamingChatPublisher	Builds a reactive Publisher<ChatModelStreamingEvent> for a streaming chat model from an upstream Publisher<HttpStreamingEvent> (typically httpClient.stream(request, parser)), factoring out the boilerplate every provider's reactive path otherwise hand-rolls: a bounded, back-pressured Tube of ChatModelStreamingEvents (ZeroPublisher); a subscriber whose cancellation is subscription-based — it cancels the upstream Flow.Subscription on any terminal signal (a downstream cancel, an error, or a buffer overflow), so, for example, an overflow actually aborts the HTTP connection; and delegation of each upstream event to a provider-supplied HttpStreamingChatPublisher.Sink. Only the per-event interpretation (parsing the provider's SSE payloads and driving a StreamingChatResponseHandler / TubeBackedStreamingChatResponseHandler) is provider-specific; that lives in the HttpStreamingChatPublisher.Sink, created per subscription from the Tube.
final class	ReactiveStreamingDefaults	Shared defaults for the reactive (Flow.Publisher) streaming path used by streaming chat model providers.
final class	TubeBackedStreamingChatResponseHandler	Bridge from the handler-based StreamingChatResponseHandler contract to a Tube of ChatModelStreamingEvents.

Uses of Internal in dev.langchain4j.service

Classes in dev.langchain4j.service with annotations of type Internal

Modifier and Type	Class	Description
class	AiServiceContext
class	AiServiceStreamingEventPublisher	A cold, non-blocking reactive stream for an AI Service method that returns a Flow.Publisher of AiServiceStreamingEvents.
class	AiServiceTokenStream
class	AiServiceTokenStreamParameters	Parameters for creating an AiServiceTokenStream.
class	InternalReflectionVariableResolver	Utility class responsible for resolving variable names and values for prompt templates by leveraging method parameters and their annotations.
class	TypeUtils

Methods in dev.langchain4j.service with annotations of type Internal

Modifier and Type	Method	Description
static <T> AiServices<T>	AiServices.builder(AiServiceContext context)

Uses of Internal in dev.langchain4j.service.decision.internal

Classes in dev.langchain4j.service.decision.internal with annotations of type Internal

Modifier and Type	Class	Description
final class	DecisionMethod	The analysis of one decision service method: the questions it asks, how its parameters become the input, and how the answers are mapped back to its return type.
final class	DecisionServiceConfig	The configuration of a decision service, shared by all its methods: the service interface, the decision model and the optional ThresholdProvider.

Uses of Internal in dev.langchain4j.service.guardrail

Classes in dev.langchain4j.service.guardrail with annotations of type Internal

Modifier and Type	Class	Description
class	AbstractGuardrailService	Responsible for managing and applying input and output guardrails to methods of a specified AI service class.

Uses of Internal in dev.langchain4j.service.memory

Classes in dev.langchain4j.service.memory with annotations of type Internal

Modifier and Type	Class	Description
class	ChatMemoryService

Uses of Internal in dev.langchain4j.service.output

Classes in dev.langchain4j.service.output with annotations of type Internal

Modifier and Type	Class	Description
class	ServiceOutputParser

Uses of Internal in dev.langchain4j.service.tool

Classes in dev.langchain4j.service.tool with annotations of type Internal

Modifier and Type	Class	Description
class	ToolExecutionRequestUtil	Utility class for ToolExecutionRequest.
class	ToolService
static final record	ToolService.CompensableToolExecution
class	ToolServiceContext
class	ToolServiceResult

Methods in dev.langchain4j.service.tool with annotations of type Internal

Modifier and Type	Method	Description
static void	ToolService.fireToolExecutedEventsOfFailedRound(InvocationContext invocationContext, List<ToolExecutionRequest> toolRequests, Map<ToolExecutionRequest, ToolExecutionResult> results, Map<ToolExecutionRequest, Throwable> errors, AiServiceListenerRegistrar listenerRegistrar)	Fires a ToolExecutedEvent for each tool of a round that has terminated, in the order the tools were requested, before a tool error that fails the invocation is rethrown: the tools that returned a result, and the tools whose error is rethrown (with ToolExecutedEvent.isError() true).

Uses of Internal in dev.langchain4j.service.tool.search

Classes in dev.langchain4j.service.tool.search with annotations of type Internal

Modifier and Type	Class	Description
class	ToolSearchService

Uses of Internal in dev.langchain4j.service.tool.search.decision

Classes in dev.langchain4j.service.tool.search.decision with annotations of type Internal

Modifier and Type	Class	Description
final class	DecisionModelToolSelector	Selects the tools relevant to a request with a DecisionModel: one yes/no question per tool, answered in one request (or in batches, if configured), keeping the tools whose probability of "yes" reaches the minimum, most relevant first.

Uses of Internal in dev.langchain4j.spi

Classes in dev.langchain4j.spi with annotations of type Internal

Modifier and Type	Class	Description
class	ServiceHelper	Utility wrapper around ServiceLoader.load().

Uses of Internal in dev.langchain4j.spi.agent.tool

Classes in dev.langchain4j.spi.agent.tool with annotations of type Internal

Modifier and Type	Interface	Description
interface	ToolSpecificationJsonCodecFactory	A factory for creating ToolSpecificationJsonCodec instances through SPI.

Uses of Internal in dev.langchain4j.spi.data.document.parser

Classes in dev.langchain4j.spi.data.document.parser with annotations of type Internal

Modifier and Type	Interface	Description
interface	DocumentParserFactory	A factory for creating DocumentParser instances through SPI.

Uses of Internal in dev.langchain4j.spi.data.document.splitter

Classes in dev.langchain4j.spi.data.document.splitter with annotations of type Internal

Modifier and Type	Interface	Description
interface	DocumentSplitterFactory	A factory for creating DocumentSplitter instances through SPI.

Uses of Internal in dev.langchain4j.spi.data.message

Classes in dev.langchain4j.spi.data.message with annotations of type Internal

Modifier and Type	Interface	Description
interface	ChatMessageJsonCodecFactory	A factory for creating ChatMessageJsonCodec objects.

Uses of Internal in dev.langchain4j.spi.json

Classes in dev.langchain4j.spi.json with annotations of type Internal

Modifier and Type	Interface	Description
interface	JsonCodecFactory	A factory for creating Json.JsonCodec instances through SPI.
interface	ProviderJsonCodecFactory	Creates the Json.JsonCodec used to serialize a provider's wire DTOs.
interface	StateJsonCodecFactory	A factory for a JSON codec that writes and reads type information, discovered through ServiceHelper.

Uses of Internal in dev.langchain4j.spi.model.embedding

Classes in dev.langchain4j.spi.model.embedding with annotations of type Internal

Modifier and Type	Interface	Description
interface	EmbeddingModelFactory	A factory for creating EmbeddingModel instances through SPI.

Uses of Internal in dev.langchain4j.spi.observability

Classes in dev.langchain4j.spi.observability with annotations of type Internal

Modifier and Type	Interface	Description
interface	ObservabilityListenersProvider	Provides listeners that are added to every AI Service and to every model call, in addition to the listeners configured by the user.

Uses of Internal in dev.langchain4j.spi.prompt

Classes in dev.langchain4j.spi.prompt with annotations of type Internal

Modifier and Type	Interface	Description
interface	PromptTemplateFactory	A factory for creating prompt templates.
static interface	PromptTemplateFactory.Input	Interface for input for the factory.
static interface	PromptTemplateFactory.Template	Interface for a prompt template.

Uses of Internal in dev.langchain4j.spi.prompt.structured

Classes in dev.langchain4j.spi.prompt.structured with annotations of type Internal

Modifier and Type	Interface	Description
interface	StructuredPromptFactory	Represents a factory for structured prompts.

Uses of Internal in dev.langchain4j.spi.services

Classes in dev.langchain4j.spi.services with annotations of type Internal

Modifier and Type	Interface	Description
interface	AiServiceContextFactory
interface	AiServicesFactory
interface	CompletableFutureAdapter	SPI for adapting a single-value asynchronous type (e.g.
interface	DecisionServicesFactory	Creates the builders returned by DecisionServices.builder(Class), so that frameworks can provide their own implementation of decision services.
interface	PublisherAdapter	SPI for adapting the canonical reactive stream used internally by non-blocking streaming AI Services — a Flow.Publisher — to a third-party reactive type (e.g.
interface	TokenStreamAdapter

Uses of Internal in dev.langchain4j.spi.store.embedding.inmemory

Classes in dev.langchain4j.spi.store.embedding.inmemory with annotations of type Internal

Modifier and Type	Interface	Description
interface	InMemoryEmbeddingStoreJsonCodecFactory

Uses of Internal in dev.langchain4j.store.embedding.inmemory

Classes in dev.langchain4j.store.embedding.inmemory with annotations of type Internal

Modifier and Type	Class	Description
static class	InMemoryEmbeddingStore.Entry<Embedded>	Public so that alternative JSON codecs, supplied through InMemoryEmbeddingStoreJsonCodecFactory, can describe how an entry is serialized without living in this package.
interface	InMemoryEmbeddingStoreJsonCodec

Uses of Internal in dev.langchain4j.test.internal

Classes in dev.langchain4j.test.internal with annotations of type Internal

Modifier and Type	Class	Description
final class	ChatMessageTexts	Describes chat messages as text, for judges and failure messages.

Uses of Internal in dev.langchain4j.test.service.internal

Classes in dev.langchain4j.test.service.internal with annotations of type Internal

Modifier and Type	Class	Description
final class	CaptureListenersProvider	Gives every AI Service and every model the listeners that pass their events to the InvocationRegistry.
final class	InvocationRecord	The events and model calls of one recorded AI Service invocation.
final class	InvocationRegistry	Assigns AI Service events to recordings.
final class	ModelCallRecord	A model call made for a recorded AI Service invocation.
final class	RecordingSession	The AI Service invocations captured by one call of the recorder.