Package com.tnsai.evaluation.autoharness

Record Class FailureRecord

java.lang.Object

java.lang.Record

com.tnsai.evaluation.autoharness.FailureRecord

Record Components:

agentId - identifier of the agent that failed

phase - lifecycle phase where the failure occurred

errorType - fully-qualified class name of the error (e.g. "java.lang.NullPointerException")

message - human-readable error description

timestamp - when the failure was observed

context - additional key-value context (input, trace id, etc.)

public record FailureRecord(String agentId, String phase, String errorType, String message, Instant timestamp, Map<String,String> context)
extends Record

Captures a single agent failure from an execution trace.

Immutable record used as input to the failure mining and clustering pipeline. The phase field indicates where in the agent lifecycle the failure occurred (e.g. "planning", "tool_execution", "response_generation").

Since:

0.1.0

Constructor Summary

Constructors

Constructor	Description
FailureRecord(String agentId, String phase, String errorType, String message, Instant timestamp, Map<String,String> context)	Creates an instance of a FailureRecord record class.

Method Summary

Modifier and Type	Method	Description
String	agentId()	Returns the value of the agentId record component.
Map<String,String>	context()	Returns the value of the context record component.
final boolean	equals(Object o)	Indicates whether some other object is "equal to" this one.
String	errorType()	Returns the value of the errorType record component.
final int	hashCode()	Returns a hash code value for this object.
String	message()	Returns the value of the message record component.
static FailureRecord	of(String agentId, String phase, String errorType, String message)	Convenience factory with explicit error info.
static FailureRecord	of(String agentId, String phase, Throwable error)	Convenience factory for the common case.
String	phase()	Returns the value of the phase record component.
Instant	timestamp()	Returns the value of the timestamp record component.
final String	toString()	Returns a string representation of this record class.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Details

FailureRecord

public FailureRecord(String agentId,
 String phase,
 String errorType,
 String message,
 Instant timestamp,
 Map<String,String> context)

Creates an instance of a FailureRecord record class.

Parameters:

agentId - the value for the agentId record component

phase - the value for the phase record component

errorType - the value for the errorType record component

message - the value for the message record component

timestamp - the value for the timestamp record component

context - the value for the context record component

Method Details

of

public static FailureRecord of(String agentId,
 String phase,
 Throwable error)

Convenience factory for the common case.

of

public static FailureRecord of(String agentId,
 String phase,
 String errorType,
 String message)

Convenience factory with explicit error info.

toString

public final String toString()

Returns a string representation of this record class. The representation contains the name of the class, followed by the name and value of each of the record components.

Specified by:

toString in class Record

Returns:

a string representation of this object

hashCode

public final int hashCode()

Returns a hash code value for this object. The value is derived from the hash code of each of the record components.

Specified by:

hashCode in class Record

Returns:

a hash code value for this object

equals

public final boolean equals(Object o)

Indicates whether some other object is "equal to" this one. The objects are equal if the other object is of the same class and if all the record components are equal. All components in this record class are compared with Objects::equals(Object,Object).

Specified by:

equals in class Record

Parameters:

o - the object with which to compare

Returns:

true if this object is the same as the o argument; false otherwise.

agentId

public String agentId()

Returns the value of the agentId record component.

Returns:

the value of the agentId record component

phase

public String phase()

Returns the value of the phase record component.

Returns:

the value of the phase record component

errorType

public String errorType()

Returns the value of the errorType record component.

Returns:

the value of the errorType record component

message

public String message()

Returns the value of the message record component.

Returns:

the value of the message record component

timestamp

public Instant timestamp()

Returns the value of the timestamp record component.

Returns:

the value of the timestamp record component

context

public Map<String,String> context()

Returns the value of the context record component.

Returns:

the value of the context record component