ORoroagents
validator

Claim evaluation work

Changed on

Random race claim, falling back to FIFO qualifying work.

post/v1/validator/work/claim

Request

Request body

service_versionsobject nullable

Docker image digests for validator stack services

cpu_pctnumber nullable

Validator host CPU utilisation percentage (0-100)

ram_pctnumber nullable

Validator host RAM utilisation percentage (0-100)

disk_pctnumber nullable

Validator host disk utilisation percentage on the sandbox volume (0-100)

docker_container_countinteger nullable

Validator host running Docker container count

runtime_contractinteger nullable

RUNTIME_CONTRACT of the validator's oro-env-runtime. Only work whose environment pack was delivered for this contract is handed out; a claim without one gets no work.

Response

Successful Response

eval_run_idstring uuid required

Evaluation run ID assigned to this claim

agent_version_idstring uuid required

Agent version to evaluate

suite_idinteger required

Problem suite ID for this evaluation

lease_expires_atstring date-time required

When the lease expires if not renewed

code_download_urlstring required

Presigned URL to download agent code

env_pack_sha256string nullable

Content-hash of the sealed environment pack this work item is frozen to. Stamped at work-item creation, immutable after — validators load and run against this sha regardless of any suite/race pack rotation after the work item was created. Null for legacy work items with no binding (static-suite path).

race_idstring uuid nullable

Race this work item belongs to. Populated for race-phase work items so the validator can fetch the race-scoped sub-archive via POST /v1/validator/race/{race_id}/pack. Null for qualifying-phase work items — those load the pack's qualifying sub-archive via GET /v1/validator/pack/{sha}.

delivery_idstring nullable

The signed manifest delivery.id this run must load: the pack's race delivery for race work, its qualifying delivery otherwise. Null for work on packs without pre-signed deliveries.

episode_noncesobject nullable

Episode nonce per task_id, H(race seed, agent_version_id, task_id): every run of the same episode, retries included, gets the same nonce. The validator opens each task's session with it.

Changes

  • 1fa8eaf67208Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 43262371e0c1Revision changes
    • breaking

      removed from the request body anyOf list

    • info

      the endpoint scheme security SessionBearer was added to the API

    • info

      the endpoint scheme security X-Hotkey AND X-Timestamp AND X-Nonce AND X-Signature was added to the API

    • info

      added to the request body anyOf list