Expand description
HTTP API contract for the Evaluate service.
Evaluate is a control plane over four immutable catalog resources — Case, Environment Profile, Evaluator and Suite — plus the durable Task that a Runtime pulls from. Case is the node that owns the dependency edges, so it carries its own id, version and digest like every other catalog resource; a Suite is only an ordered selection of Case versions.
§Layering
agent-evaluate-contract paths + DTOs (this crate)
agent-evaluate-runtime control plane + verdicts
agent-evaluate-server router + auth + binRe-exports§
Modules§
- gate
- Report comparison and the declarative release gate.
- metric
- Metric taxonomy, report slices and metric health.
- objective
- Objective metrics derived deterministically from one authoritative Trace partition.
- review
- Human review queue and the error-analysis sampling protocol.
Structs§
- Admin
Case Page - Admin
Case Summary - Admin
Review Page - Admin
RunPage - Admin
RunSummary - Admin
Suite Page - Admin
Suite Summary - Agent
Evaluation Input - Stable input passed to a repository-owned Agent evaluation function. It is deliberately independent from the function implementation language.
- Agent
Evaluation Output - Stable output produced by one repository-owned Agent evaluation function.
- ApiError
- Error body shared by every non-2xx response.
- Assertion
Verdict - Cancel
RunRequest - Case
RunPage - Case
RunSummary - Claim
Evaluation Case Request - Runtime-facing pull protocol.
evaluate_task_idis the durableEvalOperation::idreturned when the SDK/CLI configures a run. Infra never needs a callback URL for the Runtime. - Claim
Evaluation Case Response - Create
Eval RunRequest - Environment
Profile Version - Eval
Access Scope - Eval
Budget - Eval
Case Result - Eval
Case Version - Eval
Operation - Eval
Report - Eval
Suite Version - Ordered selection of immutable Case versions. A Suite adds no content of its own, so changing one Case never rewrites the others.
- Eval
Turn - Evaluate
Admin Overview - Evaluation
Case Lease - Evaluation
Subject - Agent is an optimistic precondition; Runtime ID remains the execution selector and Runtime is the authoritative owner of their binding.
- Evaluator
Verdict - Evaluator
Version - Evidence
Ref - Immutable evidence object owned by the scoped Evaluate namespace.
- Experiment
Variant - GetOperation
Request - GetReport
Request - Judge
Calibration - Human-label agreement accumulated for one evaluator id.
- Judge
Evaluation Evidence - Attested outcome of a model-graded evaluator. Produced by the isolated executor; the control plane never calls a judge model itself.
- List
Admin Cases Request - List
Admin Reviews Request - List
Admin Runs Request - List
Admin Suites Request - List
Case Runs Request - Plugin
Evaluation Evidence - Register
Environment Profile Request - Register
Eval Case Request - Immutable Case content. A Case is the node that owns the evaluation dependency edges, so it is registered and versioned in its own right and a Suite only references it.
- Register
Evaluator Version Request - Register
Suite Request - Renew
Evaluation Case Request - Renew
Evaluation Case Response - Sandbox
Execution Evidence - Bounded evidence returned by the isolated executor. Verdict calculation remains owned by Evaluate and is deterministic from this typed structure.
- Sandbox
Execution Request - Submit
Evaluation Evidence Request - Submit
Evaluation Evidence Response - Verify
Command - Versioned
Resource Ref - Immutable reference to a catalog resource. Evaluate snapshots the resolved version into a CaseAttempt; mutable aliases are deliberately unsupported.
Enums§
- Case
Failure Kind - Case
RunState - Evaluator
Implementation - Operation
State - Typed
Assertion - Versioned typed assertion schema used by immutable Case versions.
Constants§
- ADMIN_
CANCEL_ RUN_ PATH - ADMIN_
CASES_ PATH - ADMIN_
CLAIM_ REVIEW_ PATH - ADMIN_
COMPLETE_ REVIEW_ PATH - ADMIN_
METRIC_ HEALTH_ PATH - ADMIN_
OVERVIEW_ PATH - ADMIN_
REPORT_ PATH - ADMIN_
REVIEWS_ PATH - ADMIN_
RUNS_ PATH - ADMIN_
RUN_ CASES_ PATH - ADMIN_
SUITES_ PATH - AUDIENCE
- CANCEL_
RUN_ PATH - CASE_
VERSIONS_ PATH - CLAIM_
REVIEW_ PATH - COMPARE_
REPORTS_ PATH - COMPLETE_
REVIEW_ PATH - DEFAULT_
ADMIN_ PAGE_ SIZE - DEFAULT_
PORT - DRIVER_
CLAIM_ PATH - DRIVER_
RENEW_ PATH - DRIVER_
SUBMIT_ PATH - DURABLE_
REPORT_ PATH - ENVIRONMENT_
PROFILES_ PATH - EVALUATOR_
VERSIONS_ PATH - HEALTH_
PATH - JUDGE_
PROMOTION_ MIN_ AGREEMENT - JUDGE_
PROMOTION_ MIN_ LABELS - Minimum human-label evidence before a model-graded evaluator may gate.
- MAX_
ADMIN_ PAGE_ SIZE - MAX_
RESOURCE_ ID_ CHARS - METRIC_
CANDIDATES_ PATH - METRIC_
HEALTH_ PATH - OPERATIONS_
PATH - REVIEW_
QUEUE_ PATH - RUNS_
PATH - RUN_
CASES_ PATH - SAMPLE_
REVIEWS_ PATH - SERVICE_
NAME - SUITES_
PATH - TRACE_
OBJECTIVE_ METRICS_ PATH