.NET API
TraconToolTimeoutException
Tracon.Abstractions.dllThrown when a tool call does not settle within its configured timeout.
public sealed class TraconToolTimeoutException : TraconException, ISerializable- Inheritance
- object ← Exception ← TraconException ← TraconToolTimeoutException
- 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
Section titled “Remarks”Thrown by the wrapper installed in the tool registry, never by the tool body itself. Microsoft Agent Framework’s function-invoking client catches it and turns it into a tool result carrying the error — the run is not dropped, and the model sees a tool failure and can continue the turn.
CancellationToken is cooperative. A tool body that never reads its token is not forcibly stopped by this timeout — only the wait for it is cut short. The underlying work keeps running in the background until it finishes on its own; this is a documented limit, not a bug.
Constructors
Section titled “Constructors”TraconToolTimeoutException()
Section titled “ TraconToolTimeoutException()”Creates a new error.
public TraconToolTimeoutException()TraconToolTimeoutException(string)
Section titled “ TraconToolTimeoutException(string)”Creates a new error.
public TraconToolTimeoutException(string message)Parameters
Section titled “Parameters”message string
The error message.
TraconToolTimeoutException(string, Exception)
Section titled “ TraconToolTimeoutException(string, Exception)”Creates a new error.
public TraconToolTimeoutException(string message, Exception innerException)Parameters
Section titled “Parameters”message string
The error message.
innerException Exception
The underlying error.
Fields
Section titled “Fields”ToolTimeoutErrorType
Section titled “ ToolTimeoutErrorType”The stable value written to TraconException.ErrorType.
public const string ToolTimeoutErrorType = "tool_timeout"Field Value
Section titled “Field Value”Properties
Section titled “Properties”ErrorType
Section titled “ ErrorType”Gets the stable error type name written to the run record.
public override string ErrorType { get; }Property Value
Section titled “Property Value”Remarks
Section titled “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.
Timeout
Section titled “ Timeout”Gets the timeout that elapsed.
public TimeSpan? Timeout { get; init; }Property Value
Section titled “Property Value”ToolName
Section titled “ ToolName”Gets the name of the tool that timed out.
public string? ToolName { get; init; }