Recompute Verdicts
recompute_verdictsRe-run coverage and group-sufficiency verdict evaluation for a threat model, or obtain a pre-flight cost estimate. Use dry-run mode to quote charges before committing.
Instructions
Re-run coverage and group-sufficiency verdict evaluation for a model, or return the pre-flight cost estimate without enqueueing anything.
dry_run selects between enqueueing the recompute and a cost-only
quote:
dry_run=False(default) — ENQUEUE: force a fresh evaluation of every control's coverage verdict and every live control objective's group-sufficiency verdict, bypassing the normal quiet-period batching. Evaluation runs in the background; re-read the model's divergence report (or coverage surfaces) shortly after to see updated verdicts. The response carriesestimated_credits— an informational estimate; nothing is charged from it, actual usage is metered as the evaluation runs, per the account's plan. Returns{model_id, model_version, enqueued_coverage, enqueued_group_sufficiency, total_enqueued, estimated_credits, quote, governor}. Whengovernor.exhaustedis true the work is queued and resumes automatically atgovernor.resets_at— it is never dropped.dry_run=True— QUOTE ONLY: return the informational pre-flight cost estimate and enqueue NOTHING. Nothing is charged from the estimate. It carriescomputed_atand the pricingrate_versionin force so a stale quote is detectable. Returns{estimated_credits, computed_at, rate_version, informational, total_enqueueable, already_evaluated, governor}, wheretotal_enqueueableis the number of jobs a recompute would enqueue andalready_evaluatedcounts subjects that already carry a verdict (a portion short-circuit without cost, so the estimate is an upper bound). Whengovernor.exhaustedis true, new evaluation would be queued untilgovernor.resets_at.
Scope — what this does NOT do. It evaluates control-objective
COVERAGE and GROUP SUFFICIENCY only. It does not evaluate per-control
sufficiency (whether a control's assertions cover its description) and
it does not evaluate assertion coherence — both of those are computed
on assertion write and read back with get_sufficiency /
get_verification_report. So a control sitting at
partially_verified, or an assertion showing
coherence_status: "pending", is NOT a reason to call this tool: the
verdict you want already exists, and recomputing spends credits without
changing it. Reach for this only when control-to-CO MAPPINGS look wrong
(see get_verdict_divergence).
Cost: this fans out across every control and live control objective, so
on a large model the estimate can run to thousands of credits. Call it
with dry_run=True first and surface the number to the operator
before enqueueing.
Both modes return a 503-mapped error when verdict observability is
unavailable on the deployment. To un-park verdicts stuck by a transient
outage instead of force-enqueueing the whole model, use
retry_verdicts.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | When True, return only the pre-flight estimate and enqueue nothing. When False (default), enqueue the recompute. | |
| model_id | Yes | ID of the threat model to re-evaluate (or estimate for). | |
| server_version | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||