RunQuery
AgentPrism.Abstractions.dllQuery used to filter the run list.
public sealed record RunQuery : IEquatable<RunQuery>Inheritance
Section titled “Inheritance”Implements
Section titled “Implements”Inherited Members
Section titled “Inherited Members”object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Constructors
Section titled “Constructors”RunQuery()
Section titled “ RunQuery()”public RunQuery()Properties
Section titled “Properties”AgentName
Section titled “ AgentName”Gets the agent whose runs are returned.
public string? AgentName { get; init; }Property Value
Section titled “Property Value”ErrorType
Section titled “ ErrorType”Gets the error type (RunError.Type) whose runs are returned. null includes every error type.
public string? ErrorType { get; init; }Property Value
Section titled “Property Value”Gets the kind whose runs are returned. null includes every kind.
public RunKind? Kind { get; init; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”Judge runs are RunKind.Eval and do not appear in
the default list (see IRunStore.GetStatisticsAsync); to see
their cost, call GET /api/runs?kind=Eval.
LabelKey
Section titled “ LabelKey”Gets the label a returned run must carry, or null to apply no label filter.
public string? LabelKey { get; init; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”The filter matches a key AND a value together: asking for
team=payments must not also return team=billing. Give
RunQuery.LabelValue alongside it; a key on its own matches any
value of that key.
LabelValue
Section titled “ LabelValue”Gets the value RunQuery.LabelKey must have. null matches any value of that key.
public string? LabelValue { get; init; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”The field is ignored when RunQuery.LabelKey is null: a value with no key names no dimension, and silently returning an empty list is hard to debug.
OnlyRootRuns
Section titled “ OnlyRootRuns”Gets whether only root runs are returned. Defaults to true.
public bool OnlyRootRuns { get; init; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”The default is deliberately true: when an agent calls other
agents, every child call produces its own runs row and the list fills
with runs the user never started. Child runs appear as a tree inside their
own root’s detail view; set this to false for the full list.
ParentRunId
Section titled “ ParentRunId”Gets the run whose direct children are returned.
public Guid? ParentRunId { get; init; }Property Value
Section titled “Property Value”Guid?
Remarks
Section titled “Remarks”When a value is given, RunQuery.OnlyRootRuns is ignored: asking for child runs and filtering to roots contradict each other, and silently returning an empty list is hard to debug.
RootRunId
Section titled “ RootRunId”Gets the tree whose runs are returned, including the root.
public Guid? RootRunId { get; init; }Property Value
Section titled “Property Value”Guid?
SessionId
Section titled “ SessionId”Gets the session whose runs are returned.
public string? SessionId { get; init; }Property Value
Section titled “Property Value”Gets the number of records to skip.
public int Skip { get; init; }Property Value
Section titled “Property Value”StartedAfter
Section titled “ StartedAfter”Gets the lower bound on start time (UTC).
public DateTimeOffset? StartedAfter { get; init; }Property Value
Section titled “Property Value”Status
Section titled “ Status”Gets the status whose runs are returned.
public RunStatus? Status { get; init; }Property Value
Section titled “Property Value”Gets the maximum number of records to return.
public int Take { get; init; }Property Value
Section titled “Property Value”TenantId
Section titled “ TenantId”Gets the tenant whose runs are returned.
public string? TenantId { get; init; }Property Value
Section titled “Property Value”UserId
Section titled “ UserId”Gets the user whose runs are returned. null includes every user, including runs that carry no user at all.
public string? UserId { get; init; }Property Value
Section titled “Property Value”Methods
Section titled “Methods”Equals(object?)
Section titled “ Equals(object?)”public override bool Equals(object? obj)Parameters
Section titled “Parameters”obj object?
Returns
Section titled “Returns”Equals(RunQuery?)
Section titled “ Equals(RunQuery?)”public bool Equals(RunQuery? other)Parameters
Section titled “Parameters”other RunQuery?
Returns
Section titled “Returns”GetHashCode()
Section titled “ GetHashCode()”public override int GetHashCode()Returns
Section titled “Returns”ToString()
Section titled “ ToString()”public override string ToString()Returns
Section titled “Returns”Operators
Section titled “Operators”operator ==(RunQuery?, RunQuery?)
Section titled “ operator ==(RunQuery?, RunQuery?)”public static bool operator ==(RunQuery? left, RunQuery? right)Parameters
Section titled “Parameters”left RunQuery?
right RunQuery?
Returns
Section titled “Returns”operator !=(RunQuery?, RunQuery?)
Section titled “ operator !=(RunQuery?, RunQuery?)”public static bool operator !=(RunQuery? left, RunQuery? right)Parameters
Section titled “Parameters”left RunQuery?
right RunQuery?