import type { SemanticAcceptedReadModelV2, SemanticConfiguredModel, SemanticEvidenceV1, SemanticExpressionCue, SemanticHarness, SemanticPhase, SemanticTag } from "./contract.js";
export declare const SEMANTIC_REVIEW_SCHEMA_VERSION: 1;
export declare const SEMANTIC_REVIEW_OVERALL_VERDICTS: readonly ["correct", "close", "wrong", "unsure"];
export declare const SEMANTIC_REVIEW_FIELD_VERDICTS: readonly ["correct", "wrong", "unsure"];
export declare const SEMANTIC_REVIEW_PORTRAIT_VERDICTS: readonly ["helpful", "neutral", "misleading"];
export declare const SEMANTIC_REVIEW_TRANSITION_VERDICTS: readonly ["real-change", "flicker", "unsure"];
export declare const SEMANTIC_REVIEW_CONFIDENCE: readonly ["low", "medium", "high"];
export declare const SEMANTIC_REVIEW_NO_EXPRESSION: "none";
export type SemanticReviewOverallVerdict = (typeof SEMANTIC_REVIEW_OVERALL_VERDICTS)[number];
export type SemanticReviewFieldVerdict = (typeof SEMANTIC_REVIEW_FIELD_VERDICTS)[number];
export type SemanticReviewPortraitVerdict = (typeof SEMANTIC_REVIEW_PORTRAIT_VERDICTS)[number];
export type SemanticReviewTransitionVerdict = (typeof SEMANTIC_REVIEW_TRANSITION_VERDICTS)[number];
export type SemanticReviewConfidence = (typeof SEMANTIC_REVIEW_CONFIDENCE)[number];
export type SemanticReviewExpression = SemanticExpressionCue | typeof SEMANTIC_REVIEW_NO_EXPRESSION;
export interface SemanticReviewObservationV1 {
    kind: string;
    observed_at: string;
    label?: string;
    outcome?: string;
    error_class?: string;
}
export interface SemanticReviewEvidenceSnapshotV1 {
    observed_through_ts: string;
    task?: string;
    lifecycle?: string;
    intent?: string;
    operation?: {
        category: string;
        label: string;
    };
    waits: Array<{
        kind: string;
        started_at: string;
    }>;
    recent: SemanticReviewObservationV1[];
    attention?: SemanticReviewObservationV1;
}
export interface SemanticReviewProposalFieldV1<T> {
    value: T;
    confidence: "high" | "medium" | "low";
}
export interface SemanticReviewProposalV1 {
    headline: SemanticReviewProposalFieldV1<string>;
    summary: SemanticReviewProposalFieldV1<string>;
    phase: SemanticReviewProposalFieldV1<SemanticPhase>;
    expression_cue?: SemanticReviewProposalFieldV1<SemanticExpressionCue>;
    purpose?: SemanticReviewProposalFieldV1<string>;
    recent_result?: SemanticReviewProposalFieldV1<string>;
    attention?: SemanticReviewProposalFieldV1<string>;
    next_step?: SemanticReviewProposalFieldV1<string>;
    tags?: SemanticReviewProposalFieldV1<SemanticTag[]>;
}
export interface SemanticReviewCandidateV1 {
    schema_version: typeof SEMANTIC_REVIEW_SCHEMA_VERSION;
    candidate_id: string;
    subject_id: string;
    captured_at: string;
    source: {
        evidence_digest: `sha256:${string}`;
        observed_through_ts: string;
        generated_at: string;
        harness: SemanticHarness;
        configured_model: SemanticConfiguredModel;
        resolved_model_id: string;
        model_attestation: "verified" | "requested-only";
    };
    evidence: SemanticReviewEvidenceSnapshotV1;
    proposal: SemanticReviewProposalV1;
}
export interface SemanticReviewStudyCandidateV1 {
    candidate: SemanticReviewCandidateV1;
    previous?: SemanticReviewCandidateV1;
    transition_required: boolean;
}
export interface SemanticReviewStudyV1 {
    schema_version: typeof SEMANTIC_REVIEW_SCHEMA_VERSION;
    study_id: string;
    prepared_at: string;
    total_candidate_count: number;
    reviewed_candidate_count: number;
    pending_candidate_count: number;
    candidates: SemanticReviewStudyCandidateV1[];
}
export interface SemanticReviewResponseV1 {
    candidate_id: string;
    overall: SemanticReviewOverallVerdict;
    phase: SemanticReviewFieldVerdict;
    expected_phase?: SemanticPhase;
    expression: SemanticReviewFieldVerdict;
    expected_expression?: SemanticReviewExpression;
    portrait_usefulness: SemanticReviewPortraitVerdict;
    transition?: SemanticReviewTransitionVerdict;
    confidence: SemanticReviewConfidence;
    response_ms: number;
}
export interface SemanticReviewSubmissionV1 {
    schema_version: typeof SEMANTIC_REVIEW_SCHEMA_VERSION;
    study_id: string;
    total_duration_ms: number;
    responses: SemanticReviewResponseV1[];
}
export interface SemanticReviewReceiptRowV1 extends SemanticReviewResponseV1 {
    subject_id: string;
    candidate_generated_at: string;
    source_harness: SemanticHarness;
    configured_model: SemanticConfiguredModel;
    resolved_model_id: string;
    model_attestation: "verified" | "requested-only";
    proposed_phase: SemanticPhase;
    proposed_expression: SemanticReviewExpression;
}
export interface SemanticReviewReceiptV1 {
    schema_version: typeof SEMANTIC_REVIEW_SCHEMA_VERSION;
    receipt_id: string;
    study_id: string;
    completed_at: string;
    total_duration_ms: number;
    responses: SemanticReviewReceiptRowV1[];
    summary: {
        reviewed: number;
        overall: Record<SemanticReviewOverallVerdict, number>;
        phase: Record<SemanticReviewFieldVerdict, number>;
        expression: Record<SemanticReviewFieldVerdict, number>;
        portrait_usefulness: Record<SemanticReviewPortraitVerdict, number>;
        transitions: Record<SemanticReviewTransitionVerdict, number>;
    };
}
export declare function semanticReviewPaths(coordRootRaw: string): {
    root: string;
    candidates: string;
    receipts: string;
};
export declare function captureSemanticReviewCandidate(coordRootRaw: string, evidence: SemanticEvidenceV1, document: SemanticAcceptedReadModelV2): SemanticReviewCandidateV1;
export declare function backfillSemanticReviewCandidates(coordRootRaw: string, now?: number): SemanticReviewCandidateV1[];
export declare function listSemanticReviewCandidates(coordRootRaw: string): SemanticReviewCandidateV1[];
export declare function listSemanticReviewReceipts(coordRootRaw: string): SemanticReviewReceiptV1[];
export declare function prepareSemanticReviewStudy(coordRootRaw: string, options?: {
    limit?: number;
    now?: Date;
    backfill?: boolean;
}): SemanticReviewStudyV1;
export declare function storeSemanticReviewSubmission(coordRootRaw: string, value: unknown, now?: Date): SemanticReviewReceiptV1;
export declare function pruneSemanticReviewStorage(coordRootRaw: string, now?: number): void;
//# sourceMappingURL=review.d.ts.map