Package net.thevpc.naru.api.model

Class NaruMessage

java.lang.Object

net.thevpc.naru.api.model.NaruMessage

All Implemented Interfaces:

Cloneable, NToElement, NCopiable

public class NaruMessage
extends Object
implements NToElement, NCopiable, Cloneable

A single message in a chat conversation. Roles: "system", "user", "assistant", "tool"

Constructor Summary

Constructors

Constructor	Description
NaruMessage()
NaruMessage(String sourceName, NaruSource source, NaruRole role, String content, List<String> images, String toolCallId, String toolName, List<NaruToolCall> toolCalls)
NaruMessage(NElement element)

Method Summary

Modifier and Type	Method	Description
NaruMessage	addThinkingSegment(NaruThinkingSegment segment)	Appends one reasoning segment, assigning it the next position.
static NaruMessage	assistant(String content)
static NaruMessage	assistantWithToolCalls(String content, List<NaruToolCall> calls)
protected NaruMessage	clone()
NaruMessage	copy()
String	getContent()
List<String>	getImages()
NaruRole	getRole()
NaruSource	getSource()
String	getSourceName()
String	getThinking()	All reasoning as one string, regardless of how it was stored.
List<NaruThinkingSegment>	getThinkingSegments()	Structured reasoning, or null when the model did not think.
String	getToolCallId()
List<NaruToolCall>	getToolCalls()
String	getToolName()
boolean	hasThinking()	Whether this message carries any reasoning at all, in either form.
boolean	hasToolCalls()
boolean	isTurnBoundary()
static NaruMessage	of(NElement element)
void	setContent(String content)
void	setImages(List<String> images)
void	setRole(NaruRole role)
NaruMessage	setSource(NaruSource source)
NaruMessage	setSourceName(String sourceName)
NaruMessage	setThinking(String thinking)
NaruMessage	setThinkingSegments(List<NaruThinkingSegment> thinkingSegments)
void	setToolCallId(String toolCallId)
void	setToolCalls(List<NaruToolCall> toolCalls)
void	setToolName(String toolName)
NaruMessage	setTurnBoundary(boolean turnBoundary)
static NaruMessage	system(String content)
NElement	toElement()
static NaruMessage	tool(String toolName, String callId, String result)
String	toString()
static NaruMessage	user(String content)
static NaruMessage	user(NMsg content)
static NaruMessage	userWithImages(String content, List<String> base64Images)
NaruMessage	withContent(String content)

Methods inherited from class java.lang.Object

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

Constructor Details

NaruMessage

public NaruMessage()

NaruMessage

public NaruMessage(String sourceName,
 NaruSource source,
 NaruRole role,
 String content,
 List<String> images,
 String toolCallId,
 String toolName,
 List<NaruToolCall> toolCalls)

NaruMessage

public NaruMessage(NElement element)

Method Details

withContent

public NaruMessage withContent(String content)

getSourceName

public String getSourceName()

setSourceName

public NaruMessage setSourceName(String sourceName)

getSource

public NaruSource getSource()

setSource

public NaruMessage setSource(NaruSource source)

copy

public NaruMessage copy()

Specified by:

copy in interface NCopiable

clone

protected NaruMessage clone()

Overrides:

clone in class Object

of

public static NaruMessage of(NElement element)

toElement

public NElement toElement()

Specified by:

toElement in interface NToElement

system

public static NaruMessage system(String content)

user

public static NaruMessage user(NMsg content)

user

public static NaruMessage user(String content)

userWithImages

public static NaruMessage userWithImages(String content,
 List<String> base64Images)

assistant

public static NaruMessage assistant(String content)

assistantWithToolCalls

public static NaruMessage assistantWithToolCalls(String content,
 List<NaruToolCall> calls)

tool

public static NaruMessage tool(String toolName,
 String callId,
 String result)

getRole

public NaruRole getRole()

setRole

public void setRole(NaruRole role)

getContent

public String getContent()

setContent

public void setContent(String content)

getImages

public List<String> getImages()

setImages

public void setImages(List<String> images)

getToolCallId

public String getToolCallId()

setToolCallId

public void setToolCallId(String toolCallId)

getToolName

public String getToolName()

setToolName

public void setToolName(String toolName)

getToolCalls

public List<NaruToolCall> getToolCalls()

setToolCalls

public void setToolCalls(List<NaruToolCall> toolCalls)

getThinking

public String getThinking()

All reasoning as one string, regardless of how it was stored.

Derives from getThinkingSegments() when segments are present, so callers written against the original single-string field keep working against messages produced by the structured path. Returns null when there was no reasoning at all, which callers already treat as "did not think".

getThinkingSegments

public List<NaruThinkingSegment> getThinkingSegments()

Structured reasoning, or null when the model did not think.

hasThinking

public boolean hasThinking()

Whether this message carries any reasoning at all, in either form.

setThinkingSegments

public NaruMessage setThinkingSegments(List<NaruThinkingSegment> thinkingSegments)

addThinkingSegment

public NaruMessage addThinkingSegment(NaruThinkingSegment segment)

Appends one reasoning segment, assigning it the next position.

isTurnBoundary

public boolean isTurnBoundary()

setTurnBoundary

public NaruMessage setTurnBoundary(boolean turnBoundary)

setThinking

public NaruMessage setThinking(String thinking)

hasToolCalls

public boolean hasToolCalls()

toString

public String toString()

Overrides:

toString in class Object