# TraconToolTimeoutException > Tracon documentation. Tracon is a .NET package family that adds a control > plane on Microsoft Agent Framework, published as NuGet packages that run > inside your own ASP.NET Core application. > > Page: https://tracon.dev/api/tracon.tracontooltimeoutexception/ > Summary: TraconToolTimeoutException: Thrown when a tool call does not settle within its configured timeout.
Namespace Tracon · Assembly Tracon.Abstractions.dll
Thrown when a tool call does not settle within its configured timeout. ```csharp 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 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](https://learn.microsoft.com/dotnet/api/system.threading.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 ### TraconToolTimeoutException\(\) Creates a new error. ```csharp public TraconToolTimeoutException() ``` ### TraconToolTimeoutException\(string\) Creates a new error. ```csharp public TraconToolTimeoutException(string message) ``` #### Parameters `message` [string](https://learn.microsoft.com/dotnet/api/system.string) The error message. ### TraconToolTimeoutException\(string, Exception\) Creates a new error. ```csharp public TraconToolTimeoutException(string message, Exception innerException) ``` #### Parameters `message` [string](https://learn.microsoft.com/dotnet/api/system.string) The error message. `innerException` [Exception](https://learn.microsoft.com/dotnet/api/system.exception) The underlying error. ## Fields ### ToolTimeoutErrorType The stable value written to [TraconException.ErrorType](/api/tracon.traconexception/#Tracon_TraconException_ErrorType). ```csharp public const string ToolTimeoutErrorType = "tool_timeout" ``` #### Field Value [string](https://learn.microsoft.com/dotnet/api/system.string) ## Properties ### ErrorType Gets the stable error type name written to the run record. ```csharp public override string ErrorType { get; } ``` #### Property Value [string](https://learn.microsoft.com/dotnet/api/system.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](/api/tracon.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 Gets the timeout that elapsed. ```csharp public TimeSpan? Timeout { get; init; } ``` #### Property Value [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)? ### ToolName Gets the name of the tool that timed out. ```csharp public string? ToolName { get; init; } ``` #### Property Value [string](https://learn.microsoft.com/dotnet/api/system.string)?