The outcome of one agent turn, as JAgent and AgentStream return it: where it ran, how it ended, and the thread's state at its end. Every accessor returns a String, a JDK type or another type of this package, never a Scala or ujson one.
JAgentResult r = agent.run("What is 2+2?").get();
switch (r.status().kind()) {
case COMPLETED -> System.out.println(r.answer().orElseThrow());
case BLOCKED -> System.out.println("Blocked by " + r.status().guardrail().orElseThrow());
case STEP_LIMIT_REACHED -> System.out.println("Hit the step limit");
case SUSPENDED -> r.status().pending().forEach(p -> System.out.println(p.toolName()));
}
A value: two are equal when every field is. Built only by the facade; a conversation continues by its threadId, with JAgent.continueConversation, resume or recover. Neither it nor any type it reaches is Serializable; JMessage, JToolCall and JAgentStatus print their full text in toString, as the Scala types do, so mind what a log line includes.
Value parameters
activeAgent
the id of the agent the thread is with at the run's end: the next turn starts with it
messages
the thread's full history, without system prompts; an unmodifiable list
runId
this run
status
how the turn ended, or what it waits for
threadId
the conversation's thread
usage
token usage and cost accumulated over the thread, per model
It is reflexive: for any instance x of type Any, x.equals(x) should return true.
It is symmetric: for any instances x and y of type Any, x.equals(y) should return true if and only if y.equals(x) returns true.
It is transitive: for any instances x, y, and z of type Any if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
If you override this method, you should verify that your implementation remains an equivalence relation. Additionally, when overriding this method it is usually necessary to override hashCode to ensure that objects which are "equal" (o1.equals(o2) returns true) hash to the same scala.Int. (o1.hashCode.equals(o2.hashCode)).
Value parameters
that
the object to compare against this object for equality.
Attributes
Returns
true if the receiver object is equivalent to the argument; false otherwise.
The default hashing algorithm is platform dependent.
Note that it is allowed for two objects to have identical hash codes (o1.hashCode.equals(o2.hashCode)) yet not be equal (o1.equals(o2) returns false). A degenerate implementation could always return 0. However, it is required that if two objects are equal (o1.equals(o2) returns true) that they have identical hash codes (o1.hashCode.equals(o2.hashCode)). Therefore, when overriding this method, be sure to verify that the behavior is consistent with the equals method.