> ## Documentation Index
> Fetch the complete documentation index at: https://docs.valkyrie.vals.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Scheduler types

> Public scheduler models and enums exported by the Valkyrie Python SDK.

This page documents all 9 public types in the `Scheduler` family in source order. Use the table of contents to jump to a type.

<h2 id="scheduler-active-entry-response">
  `SchedulerActiveEntryResponse`
</h2>

One task currently building, running, or evaluating.

Scheduler model · 7 fields

**Fields**

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"benchmark_uuid"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · UUID</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"task_uuid"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · UUID</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"benchmark_name"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · str</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"external_task_id"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · str</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"started_by_email"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">optional · str | None · default: <code>{"None"}</code></span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"status"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · <a href="/reference/sdk/models/scheduler#scheduler-active-status"><code>SchedulerActiveStatus</code></a></span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"started_at"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · datetime</span></div>
</div>

***

<h2 id="scheduler-active-status">
  `SchedulerActiveStatus`
</h2>

Task states included in the scheduler's active entries.

Scheduler enum · 3 members

**Members**

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1">
    <span className="break-all font-mono text-sm">
      {"BUILDING"}
    </span>

    <span className="text-sm text-gray-500 dark:text-gray-400">
      <code>
        {"'BUILDING'"}
      </code>
    </span>
  </div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1">
    <span className="break-all font-mono text-sm">
      {"IN_PROGRESS"}
    </span>

    <span className="text-sm text-gray-500 dark:text-gray-400">
      <code>
        {"'IN_PROGRESS'"}
      </code>
    </span>
  </div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1">
    <span className="break-all font-mono text-sm">
      {"EVALUATING"}
    </span>

    <span className="text-sm text-gray-500 dark:text-gray-400">
      <code>
        {"'EVALUATING'"}
      </code>
    </span>
  </div>
</div>

***

<h2 id="scheduler-capacity-domain-response">
  `SchedulerCapacityDomainResponse`
</h2>

Capacity scoped to one provider target and sandbox class.

Scheduler model · 3 fields

**Fields**

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"target_id"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · str · constraints: {"minimum length 1"}</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"sandbox_class"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · str · constraints: {"minimum length 1"}</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"capacity"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · <a href="/reference/sdk/models/scheduler#scheduler-capacity-response"><code>SchedulerCapacityResponse</code></a></span></div>
</div>

***

<h2 id="scheduler-capacity-response">
  `SchedulerCapacityResponse`
</h2>

CPU, memory, disk, and optional GPU capacity for one target and sandbox class.

Scheduler model · 5 fields

**Fields**

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"cpu"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · <a href="/reference/sdk/models/scheduler#scheduler-resource-capacity-response"><code>SchedulerResourceCapacityResponse</code></a></span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"memory"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · <a href="/reference/sdk/models/scheduler#scheduler-resource-capacity-response"><code>SchedulerResourceCapacityResponse</code></a></span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"disk"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · <a href="/reference/sdk/models/scheduler#scheduler-resource-capacity-response"><code>SchedulerResourceCapacityResponse</code></a></span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"gpu"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">optional · <a href="/reference/sdk/models/scheduler#scheduler-resource-capacity-response"><code>SchedulerResourceCapacityResponse</code></a> | None · default: <code>{"None"}</code></span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"allowed_gpu_types"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">optional · list\[str] | None · default: <code>{"None"}</code></span></div>
</div>

***

<h2 id="scheduler-overview-response">
  `SchedulerOverviewResponse`
</h2>

Scheduler totals and bounded task entries for the authenticated organization.

Scheduler model · 9 fields

**Fields**

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"observed_at"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · datetime</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"summary"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · <a href="/reference/sdk/models/scheduler#scheduler-summary-response"><code>SchedulerSummaryResponse</code></a></span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"pools"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · list\[<a href="/reference/sdk/models/scheduler#scheduler-pool-response"><code>SchedulerPoolResponse</code></a>]</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"waiting_entries"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · list\[<a href="/reference/sdk/models/scheduler#scheduler-waiting-entry-response"><code>SchedulerWaitingEntryResponse</code></a>]</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"active_entries"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · list\[<a href="/reference/sdk/models/scheduler#scheduler-active-entry-response"><code>SchedulerActiveEntryResponse</code></a>]</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"waiting_capped"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · bool</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"active_capped"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · bool</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"waiting_next_offset"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · int | None</span></div>

  <p className="mb-0 mt-1">
    {"Next waiting offset, or null when this list is exhausted."}
  </p>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"active_next_offset"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · int | None</span></div>

  <p className="mb-0 mt-1">
    {"Next active offset, or null when this list is exhausted."}
  </p>
</div>

***

<h2 id="scheduler-pool-response">
  `SchedulerPoolResponse`
</h2>

Waiting task count and optional capacity for one sandbox admission pool.

Scheduler model · 4 fields

**Fields**

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"pool_id"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · str</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"waiting"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · int</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"provider"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">optional · str | None · default: <code>{"None"}</code></span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"capacity_domains"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">optional · list\[<a href="/reference/sdk/models/scheduler#scheduler-capacity-domain-response"><code>SchedulerCapacityDomainResponse</code></a>] | None · default: <code>{"None"}</code></span></div>
</div>

***

<h2 id="scheduler-resource-capacity-response">
  `SchedulerResourceCapacityResponse`
</h2>

Available and total capacity for one resource.

Scheduler model · 2 fields

**Fields**

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"available"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · float · constraints: {">= 0"}</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"total"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · float · constraints: {">= 0"}</span></div>
</div>

***

<h2 id="scheduler-summary-response">
  `SchedulerSummaryResponse`
</h2>

Total waiting and active task counts, independent of entry limits.

Scheduler model · 4 fields

**Fields**

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"waiting"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">optional · int · default: <code>{"0"}</code></span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"building"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">optional · int · default: <code>{"0"}</code></span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"in_progress"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">optional · int · default: <code>{"0"}</code></span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"evaluating"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">optional · int · default: <code>{"0"}</code></span></div>
</div>

***

<h2 id="scheduler-waiting-entry-response">
  `SchedulerWaitingEntryResponse`
</h2>

One waiting task with its priority and position within its pool.

Scheduler model · 9 fields

**Fields**

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"benchmark_uuid"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · UUID</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"task_uuid"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · UUID</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"benchmark_name"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · str</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"external_task_id"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · str</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"started_by_email"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">optional · str | None · default: <code>{"None"}</code></span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"pool_id"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · str</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"position"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · int</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"priority"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · int</span></div>
</div>

<div className="border-b border-gray-200 py-3 dark:border-gray-800">
  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-1"><span className="break-all font-mono text-sm">{"enqueued_at"}</span><span className="min-w-0 break-words text-sm text-gray-500 dark:text-gray-400">required · datetime</span></div>
</div>
