TraconToolOptions

Namespace Tracon · Assembly Tracon.Core.dll

Defines tool execution options.

public sealed class TraconToolOptions

Inheritance

object ← TraconToolOptions

Inherited Members

object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Constructors

TraconToolOptions()

public TraconToolOptions()

Properties

AllowUnverifiedToolRegistry

Gets or sets whether a consumer-provided registry may bypass Tracon’s tool pipeline.

public bool AllowUnverifiedToolRegistry { get; set; }

Property Value

bool

Remarks

The default is false.

ApprovalPresentationTimeout

Gets or sets the longest an IToolApprovalPresenter may run before an approval request is published without its presentation.

public TimeSpan ApprovalPresentationTimeout { get; set; }

Property Value

TimeSpan

Remarks

2 seconds: unlike TraconToolOptions.DefaultTimeout, this runs on the path that publishes RunStatus.AwaitingApproval — the presenter is expected to do a single fast, read-only lookup (a point read by primary key), not real work. A slow presenter never blocks the approval itself; it only loses its own presentation, so a short default costs nothing but a resolved entity name.

Must be from one millisecond to about 49.7 days; any other value fails at startup.

DefaultMaxOutputBytes

Gets or sets the default byte limit for a tool result. null means unlimited, which is the default: an upgrade never silently cuts output.

public int? DefaultMaxOutputBytes { get; set; }

Property Value

int?

Remarks

Used when a tool’s own registration does not set ToolDescriptor.MaxOutputBytes. Bounding output inside the tool’s own body is always better; this is the installation-wide last defence for the day that bound is forgotten.

DefaultTimeout

Gets or sets the longest duration one tool call may run when its own registration does not set ToolDescriptor.Timeout.

public TimeSpan DefaultTimeout { get; set; }

Property Value

TimeSpan

Remarks

30 seconds matches the skill-script default (TraconSkillScriptOptions.Timeout); this value was not measured against production traffic and should be revisited after the first real run.

Must be from one millisecond to about 49.7 days; any other value fails at startup.