org.llm4s.javaapi

Builder for constructing a Conversation without using Scala case-class syntax or sequence literals.

Conversation conv = ConversationBuilder.create()
   .system("You are a helpful assistant.")
   .user("What is the capital of France?")
   .build();

Instances are immutable: every method returns a new builder, so a builder may be shared and forked across threads. A null content argument throws NullPointerException immediately.

Java-friendly wrapper around Agent.

Exposes a simplified run(query) entry point that returns LlmResult[AgentState] so Java callers do not need to deal with Scala's Either or Result types directly.

Obtain instances via Llm4s.createAgent.

JAgent agent = Llm4s.createAgent(client);
LlmResult<AgentState> result = agent.run("Summarise the news today");
result.ifSuccess(state -> System.out.println(state.conversation()))
     .ifFailure(e -> System.err.println(e.getMessage()));

Java-friendly wrapper around LLMClient.

The underlying Scala client returns Result[Completion]; this wrapper unwraps the content string and surfaces it as LlmResult so Java callers never import any Scala types.

Obtain instances via Llm4s.createDefaultClient or Llm4s.createClient.

LlmResult<String> r = client.complete("What is 2+2?");
r.ifSuccess(System.out::println).ifFailure(e -> System.err.println(e.getMessage()));

Entry-point factory for Java callers.

All methods return LlmResult so Java code never imports Scala Either or deals with implicit/given parameters directly. The Scala-level ModelRegistryService given is resolved internally and passed explicitly.

=== Quick-start (Java) ===

LlmResult<JLlmClient> r = Llm4s.createDefaultClient();
if (r.isSuccess()) {
   JLlmClient client = r.get();
   client.complete("Hello").ifSuccess(System.out::println);
}

A checked-free runtime exception wrapping an LLMError, thrown only when Java callers dereference a failed LlmResult via LlmResult#get.

If the wrapped error carries an underlying Throwable (for example a cause: Option[Throwable] field), it is exposed through getCause.

Java-friendly wrapper for org.llm4s.types.Result, which is an Either[LLMError, A].

Rather than requiring Java callers to deal with Scala's Either, Option, or Left/Right, this class surfaces a familiar API modelled after java.util.Optional and CompletableFuture.

LlmResult<String> result = client.complete("What is 2+2?");
result.ifSuccess(System.out::println)
     .ifFailure(e -> System.err.println(e.getMessage()));