import { z } from 'zod'; export declare const evaluationHash: (text: string) => string; export declare const EVALUATION_WORKFLOWS: readonly ["unassisted", "minimal-editing", "notes-plus-author-edits", "notes-plus-exemplars-plus-author-edits"]; export declare const EVALUATION_CONDITIONS: { id: string; rules: boolean; voiceDescription: boolean; exemplars: boolean; }[]; export declare const EVALUATION_DIMENSIONS: readonly ["factual-fidelity", "author-authenticity", "reader-suitability", "effort", "within-author-preservation", "between-author-diversity"]; export type EvaluationDimension = typeof EVALUATION_DIMENSIONS[number]; export declare const evaluationManifestSchema: z.ZodObject<{ schemaVersion: z.ZodLiteral<1>; id: z.ZodString; developmentAuthorIds: z.ZodArray; finalAuthorIds: z.ZodArray; documents: z.ZodArray; text: z.ZodString; sha256: z.ZodString; }, z.core.$strict>>; duplicatePolicy: z.ZodObject<{ metric: z.ZodLiteral<"normalized-word-trigram-jaccard-v1">; threshold: z.ZodNumber; justification: z.ZodString; }, z.core.$strict>; controls: z.ZodArray; leftDocumentId: z.ZodString; rightDocumentId: z.ZodString; }, z.core.$strict>>; models: z.ZodArray>; promptSha256: z.ZodString; }, z.core.$strict>>; extractionModelIds: z.ZodArray; judges: z.ZodArray>; independentCalibrationSha256: z.ZodString; selfPreferenceAuditSha256: z.ZodString; }, z.core.$strict>>; humanJudges: z.ZodPrefault; authorId: z.ZodOptional; }, z.core.$strict>>>; voluntaryStrata: z.ZodArray; language: z.ZodOptional; proficiency: z.ZodOptional; }, z.core.$strict>>; }, z.core.$strict>; export type EvaluationManifest = z.infer; /** Reject contaminated manifests before fitting. Checks supplied texts, not undisclosed data or semantic paraphrases. */ export declare function parseEvaluationManifest(value: unknown): EvaluationManifest; declare const preregistrationSchema: z.ZodObject<{ schemaVersion: z.ZodLiteral<1>; id: z.ZodString; manifestSha256: z.ZodString; pilot: z.ZodObject<{ artifactSha256: z.ZodString; completedAt: z.ZodString; authorIds: z.ZodArray; findings: z.ZodString; }, z.core.$strict>; registeredAt: z.ZodString; finalDataNotAccessed: z.ZodLiteral; plannedAuthors: z.ZodNumber; sampleSizeJustification: z.ZodString; thresholds: z.ZodArray; value: z.ZodNumber; direction: z.ZodEnum<{ "at-least": "at-least"; "at-most": "at-most"; }>; justification: z.ZodString; }, z.core.$strict>>; primaryOutcomes: z.ZodArray>; analysisPlan: z.ZodString; selectorPoliciesSha256: z.ZodString; budget: z.ZodObject<{ limit: z.ZodNumber; tokenizerId: z.ZodString; tokenizerVersion: z.ZodString; }, z.core.$strict>; }, z.core.$strict>; export type EvaluationPreregistration = z.infer; /** Records caller declarations; hashes/timestamps do not attest that a pilot occurred or final data stayed unseen. */ export declare function preregisterEvaluation(manifest: EvaluationManifest, value: unknown): EvaluationPreregistration; declare const stimulusSchema: z.ZodObject<{ id: z.ZodString; taskId: z.ZodString; authorId: z.ZodString; heldoutDocumentId: z.ZodString; text: z.ZodString; sha256: z.ZodString; budgetUsed: z.ZodNumber; tokenizerId: z.ZodString; tokenizerVersion: z.ZodString; conditionId: z.ZodEnum<{ r0v0e0: "r0v0e0"; r0v0e1: "r0v0e1"; r0v1e0: "r0v1e0"; r0v1e1: "r0v1e1"; r1v0e0: "r1v0e0"; r1v0e1: "r1v0e1"; r1v1e0: "r1v1e0"; r1v1e1: "r1v1e1"; }>; workflow: z.ZodEnum<{ unassisted: "unassisted"; "minimal-editing": "minimal-editing"; "notes-plus-author-edits": "notes-plus-author-edits"; "notes-plus-exemplars-plus-author-edits": "notes-plus-exemplars-plus-author-edits"; }>; modelId: z.ZodNullable; genre: z.ZodString; lengthBand: z.ZodString; editingStrength: z.ZodString; }, z.core.$strict>; export type EvaluationStimulus = z.infer; export interface BlindEvaluationPacket { packetId: string; role: 'author' | 'reader'; items: Array<{ label: string; text: string; }>; } export interface EvaluationPrivateKey { packetId: string; judgeId: string; role: 'author' | 'reader'; items: Array<{ label: string; stimulus: EvaluationStimulus; }>; } /** Latin-square rotations plus reversed blocks. Balance is exact only for complete 2N-judge blocks per role. */ export declare function createBlindEvaluationPackets(stimuliInput: EvaluationStimulus[], judges: Array<{ id: string; role: 'author' | 'reader'; }>, seed: string): { packets: BlindEvaluationPacket[]; privateKeyMap: EvaluationPrivateKey[]; balance: string; }; export interface EvaluationRating { stimulusId: string; authorId: string; judgeId: string; role: 'author' | 'reader'; dimension: EvaluationDimension; value: number | null; missingReason?: string; tie: boolean; } export interface EvaluationRatingAssignment { stimulusId: string; judgeId: string; role: 'author' | 'reader'; dimension: EvaluationDimension; } export interface EvaluationRatingContext { manifest: EvaluationManifest; stimuli: EvaluationStimulus[]; assignments?: EvaluationRatingAssignment[]; } export declare function summarizeEvaluationRatings(ratings: EvaluationRating[], context?: EvaluationRatingContext): { role: "author" | "reader"; dimension: "effort" | "factual-fidelity" | "author-authenticity" | "reader-suitability" | "within-author-preservation" | "between-author-diversity"; judgeKind: string; missingnessCompleteness: "unknown" | "declared-assignments"; observed: number; missing: number; ties: number; mean: number | null; }[]; /** Equal-weight author means, then author-cluster percentile bootstrap; no independent-text pseudo-replication. */ export declare function bootstrapAuthorMeans(rows: Array<{ authorId: string; value: number | null; }>, options: { seed: string; iterations: number; confidence: number; }): { estimate: number | null; interval: null; authors: number; excludedAuthors: number; method: "author-cluster-percentile"; } | { estimate: number | null; interval: number[]; authors: number; excludedAuthors: number; method: "author-cluster-percentile"; }; /** Outcomes must already share a preregistered decision rule; never compare arbitrary raw scales. */ export declare function reportMetricDisagreement(rows: Array<{ itemId: string; human: 'pass' | 'fail' | 'tie' | null; metric: 'pass' | 'fail' | 'tie' | null; }>, calibration: { humanReferenceSha256: string; independentOfFinalData: true; decisionRule: string; }): { paired: number; missing: number; ties: number; disagreements: string[]; disagreementRate: number | null; calibration: { humanReferenceSha256: string; independentOfFinalData: true; decisionRule: string; }; authorshipCertification: false; }; /** Qualification is a design completeness check, not a quality verdict or evidence that humans participated. */ export declare function evaluationDesignReadiness(manifest: EvaluationManifest, preregistration: EvaluationPreregistration, stimuliInput: EvaluationStimulus[]): { designComplete: boolean; gaps: string[]; humanEvaluation: "not-established"; qualityVerdict: "not-established"; }; /** Descriptive subgroup estimates only; sparse cells return no interval. No inferred demographic strata. */ export declare function summarizeEvaluationByStratum(manifest: EvaluationManifest, stimuli: EvaluationStimulus[], ratings: EvaluationRating[], options: { seed: string; iterations: number; confidence: number; assignments?: EvaluationRatingAssignment[]; }): ({ estimate: number | null; interval: null; authors: number; excludedAuthors: number; method: "author-cluster-percentile"; axis: string; value: string; role: string; dimension: string; judgeKind: string; missingnessCompleteness: "unknown" | "declared-assignments"; missing: number; } | { estimate: number | null; interval: number[]; authors: number; excludedAuthors: number; method: "author-cluster-percentile"; axis: string; value: string; role: string; dimension: string; judgeKind: string; missingnessCompleteness: "unknown" | "declared-assignments"; missing: number; })[]; export {}; //# sourceMappingURL=voice-evaluation.d.ts.map