Kivo

Core concepts

The objects behind a claim report.

Kivo is organized around review runs, atomic claims, source spans, verification results, and claim reports. These terms stay consistent across the product and API.

Primary objects

review run

One submitted AI output plus supplied sources, intended use, metadata, processing state, and review artifacts.

atomic claim

A factual, normative, causal, recommendation, or citation claim extracted from the submitted output.

source span

A quoted evidence span from a supplied source, with offsets when available.

verification result

Stored claim-level source-support verification metadata and support status for one atomic claim against candidate source spans.

claim report

The reviewer-facing artifact summarizing unsupported claims, citation issues, evidence notes, and follow-up questions.

gate verdict

Machine-readable workflow decision: allow, allow_with_limits, needs_review, needs_repair, or blocked.

Support status

Support status is claim-level. It describes whether a specific atomic claim appears supported by the supplied sources available to the verifier.

StatusMeaningCaller action
supportedThe claim appears supported by supplied source evidence.Usually continue.
partially_supportedThe source supports part of the claim or narrower wording.Review or edit before use.
unsupportedNo supplied source supports the claim.Repair the output or route to review.
contradictedA supplied source appears to conflict with the claim.Stop workflow use until repaired.
insufficient_contextThe supplied sources do not provide enough context.Add sources or route to review.
not_checkedVerification was not completed for the claim.Poll, retry, or inspect failure state.

Use status and gate verdict

The `safe_use_status` API field summarizes the source-support review outcome for the submitted intended use. Gate verdict is the machine-readable mapping for workflows that need a compact action signal.

Safe-use statusMeaningGate verdict
verified_for_useNo unsupported or blocking issues were found in the supplied-source review.allow
verified_with_limitsThe claim report contains limits, caveats, or partial support.allow_with_limits
needs_reviewHuman attention is recommended before use.needs_review
needs_repairThe output should be changed or rerun before use.needs_repair
blockedThe workflow should not use the output in its current state.blocked

Human review remains the decision authority

Kivo routes source-support risk. It does not produce final legal, medical, financial, hiring, compliance, or safety decisions.