.NET API
RunEventCustomTypes
Tracon.Abstractions.dllValidation for the CustomType string that qualifies a
RunEventType.Custom event.
public static class RunEventCustomTypesInheritance
Section titled “Inheritance”Inherited Members
Section titled “Inherited Members”object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Remarks
Section titled “Remarks”Repeats the JobHandlerKeys pattern: a namespaced, lowercase ASCII string with a reserved prefix Tracon itself never emits, so a future built-in custom type can never collide with a consumer’s own.
Fields
Section titled “Fields”QuotaThreshold
Section titled “ QuotaThreshold”The RunEventType.Custom type of the quota threshold notice a root run’s completion writes into its own event stream.
public const string QuotaThreshold = "tracon.quota.threshold"Field Value
Section titled “Field Value”Remarks
Section titled “Remarks”Falls under RunEventCustomTypes.ReservedPrefix: a consumer cannot write an
event under this type, so a client can trust that every event carrying
it came from Tracon itself, not from the agent’s own tool code.
Off by default (TraconQuotaOptions.PublishThresholdToRunStream).
ReservedPrefix
Section titled “ ReservedPrefix”The prefix reserved for Tracon’s own use.
public const string ReservedPrefix = "tracon."Field Value
Section titled “Field Value”Remarks
Section titled “Remarks”A consumer’s CustomType starting with this prefix is rejected
at write time — not because Tracon ships a built-in custom type
today, but so one could be added later without ever colliding with a
consumer’s own.
Methods
Section titled “Methods”IsReserved(string?)
Section titled “ IsReserved(string?)”Checks whether customType falls inside the
RunEventCustomTypes.ReservedPrefix namespace.
public static bool IsReserved(string? customType)Parameters
Section titled “Parameters”customType string?
The candidate type.
Returns
Section titled “Returns”true if the type is reserved for Tracon.
IsValidType(string?)
Section titled “ IsValidType(string?)”Checks whether customType is a valid custom event
type: 1-128 characters, lowercase ASCII letters, digits, .,
_, or -, starting with a letter or digit.
public static bool IsValidType(string? customType)Parameters
Section titled “Parameters”customType string?
The candidate type.
Returns
Section titled “Returns”true if the type is valid.
Remarks
Section titled “Remarks”Uppercase letters are rejected, not normalized — the same reasoning as
JobHandlerKeys.IsValidKey. A consumer that read back its
own event compares the type ordinally, so allowing case variants would
let "Contoso.Preview" and "contoso.preview" silently
become two different types.