TraconCompilationException

Namespace Tracon · Assembly Tracon.Abstractions.dll

Thrown when an agent definition cannot be turned into a runnable agent.

public sealed class TraconCompilationException : TraconException, ISerializable

Inheritance

object ← Exception ← TraconException ← TraconCompilationException

Implements

ISerializable

Inherited Members

TraconException.ErrorType, Exception.GetBaseException(), Exception.ToString(), Exception.GetType(), Exception.TargetSite, Exception.Message, Exception.Data, Exception.InnerException, Exception.HelpLink, Exception.Source, Exception.HResult, Exception.StackTrace, object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Remarks

The most common cause is a tool name in the definition that is not registered in code. That case is never skipped silently — an agent running with an unknown tool is an agent that does not do what the user expects.

Constructors

TraconCompilationException()

Creates a new compilation error.

public TraconCompilationException()

TraconCompilationException(string)

Creates a new compilation error.

public TraconCompilationException(string message)

Parameters

message string

The error message.

TraconCompilationException(string, Exception)

Creates a new compilation error.

public TraconCompilationException(string message, Exception innerException)

Parameters

message string

The error message.

innerException Exception

The underlying error.

Fields

CompilationFailedErrorType

The stable value written to TraconException.ErrorType.

public const string CompilationFailedErrorType = "compilation_failed"

Field Value

string

Properties

AgentName

Gets the name of the agent that failed to compile.

public string? AgentName { get; init; }

Property Value

string?

ErrorType

Gets the stable error type name written to the run record.

public override string ErrorType { get; }

Property Value

string

Remarks

Defaults to the full name of the exception type, so today’s behaviour does not change. A derived type overrides this member when the record has to be machine readable — for example TraconContentFilteredException writes content_filtered. Reports and alert rules can rely on this stable name instead of an assembly name.

The value is written to RunError.Type and carries no secret.