import type { AnalyzeResult } from "./study-analysis-service.js";
import { z } from "zod";
import { type PreparedRunArtifactPaths } from "./run-paths.js";
export declare const AUTOMATIC_STUDY_ANALYSIS_DIRECTORY = "analysis-automatic";
export declare const AUTOMATIC_STUDY_ANALYSIS_SCHEMA = "humanish.automatic-study-analysis.v1";
export declare const AUTOMATIC_STUDY_ANALYSIS_STALE_MS = 15000;
/** Execution metadata only. Never a participant outcome or permission to dispatch. */
export interface AutomaticStudyAnalysisView {
    state: "queued" | "running" | "complete" | "partial" | "failed" | "cancelled" | "skipped" | "unknown";
    analysisId: string | null;
    /** Safe stable code, not provider text. */
    reason: string | null;
    updatedAt: string;
}
export interface AutomaticStudyAnalysisOutcome {
    state: "complete" | "partial" | "failed" | "cancelled" | "skipped" | "unknown";
    reason: string | null;
    result?: AnalyzeResult;
}
export interface AutomaticStudyAnalysisCancellation {
    requested: boolean;
    reason: string | null;
}
declare const jobSchema: z.ZodObject<{
    schema: z.ZodLiteral<"humanish.automatic-study-analysis.v1">;
    runId: z.ZodString;
    claimId: z.ZodUUID;
    attemptId: z.ZodString;
    state: z.ZodEnum<{
        failed: "failed";
        skipped: "skipped";
        cancelled: "cancelled";
        unknown: "unknown";
        complete: "complete";
        running: "running";
        queued: "queued";
        partial: "partial";
    }>;
    analysisId: z.ZodNullable<z.ZodString>;
    reason: z.ZodNullable<z.ZodEnum<{
        AUTOMATIC_ANALYSIS_OUTCOME_UNKNOWN: "AUTOMATIC_ANALYSIS_OUTCOME_UNKNOWN";
        AUTOMATIC_ANALYSIS_ALREADY_REQUESTED: "AUTOMATIC_ANALYSIS_ALREADY_REQUESTED";
        AUTOMATIC_ANALYSIS_STORAGE_UNAVAILABLE: "AUTOMATIC_ANALYSIS_STORAGE_UNAVAILABLE";
        AUTOMATIC_ANALYSIS_SOURCE_UNAVAILABLE: "AUTOMATIC_ANALYSIS_SOURCE_UNAVAILABLE";
        AUTOMATIC_ANALYSIS_KEY_MISSING: "AUTOMATIC_ANALYSIS_KEY_MISSING";
        AUTOMATIC_ANALYSIS_ADMISSION_REFUSED: "AUTOMATIC_ANALYSIS_ADMISSION_REFUSED";
        AUTOMATIC_ANALYSIS_BUSY: "AUTOMATIC_ANALYSIS_BUSY";
        AUTOMATIC_ANALYSIS_CANCELLED: "AUTOMATIC_ANALYSIS_CANCELLED";
        AUTOMATIC_ANALYSIS_CANCELLATION_UNAVAILABLE: "AUTOMATIC_ANALYSIS_CANCELLATION_UNAVAILABLE";
        AUTOMATIC_ANALYSIS_FAILED: "AUTOMATIC_ANALYSIS_FAILED";
        AUTOMATIC_ANALYSIS_PUBLICATION_FAILED: "AUTOMATIC_ANALYSIS_PUBLICATION_FAILED";
        AUTOMATIC_ANALYSIS_REUSED: "AUTOMATIC_ANALYSIS_REUSED";
        AUTOMATIC_ANALYSIS_LIMITATIONS: "AUTOMATIC_ANALYSIS_LIMITATIONS";
        AUTOMATIC_ANALYSIS_ADMISSION_EXCEEDED: "AUTOMATIC_ANALYSIS_ADMISSION_EXCEEDED";
        AUTOMATIC_ANALYSIS_ACTOR_CANCELLED: "AUTOMATIC_ANALYSIS_ACTOR_CANCELLED";
        AUTOMATIC_ANALYSIS_NO_PARTICIPANT_EVIDENCE: "AUTOMATIC_ANALYSIS_NO_PARTICIPANT_EVIDENCE";
    }>>;
    createdAt: z.ZodISODateTime;
    updatedAt: z.ZodISODateTime;
    configDigest: z.ZodString;
    promptVersion: z.ZodString;
    sourceRunSha256: z.ZodNullable<z.ZodString>;
    inputDigest: z.ZodNullable<z.ZodString>;
    analysisSha256: z.ZodNullable<z.ZodString>;
    receiptSha256: z.ZodNullable<z.ZodString>;
    startedAt: z.ZodNullable<z.ZodISODateTime>;
    finishedAt: z.ZodNullable<z.ZodISODateTime>;
}, z.core.$strict>;
type JobRecord = z.infer<typeof jobSchema>;
/** Also guards direct HTML projection callers, not only the contained-file reader. */
export declare function projectAutomaticStudyAnalysisView(value: unknown): AutomaticStudyAnalysisView | undefined;
/** Minimal historical accounting, without source validation, execution or liveness inference. */
export declare function readAutomaticStudyAnalysisAccounting(prepared: PreparedRunArtifactPaths): Promise<{
    attemptId: string;
    analysisId: string | null;
    started: boolean;
    reused: boolean;
    uncertain: boolean;
} | "unknown" | undefined>;
/** Read-only projection. A stale timestamp or persisted claim never authorizes execution. */
export declare function readAutomaticStudyAnalysisPrepared(prepared: PreparedRunArtifactPaths, now?: number): Promise<AutomaticStudyAnalysisView | undefined>;
export interface AutomaticStudyAnalysisJob {
    readonly attemptId: string;
    /** Serialized, awaited durability boundary. A failed write must prevent dispatch. */
    update(update: Partial<Pick<JobRecord, "state" | "analysisId" | "reason" | "sourceRunSha256" | "inputDigest" | "startedAt" | "analysisSha256" | "receiptSha256">>): Promise<void>;
    touch(): Promise<void>;
    cancellationRequested(): Promise<boolean>;
}
/** The directory is permanent, including after interrupted/failed writes. Never re-open it as a writer. */
export declare function claimAutomaticStudyAnalysis(prepared: PreparedRunArtifactPaths, metadata: {
    configDigest: string;
    promptVersion: string;
}): Promise<AutomaticStudyAnalysisJob | null>;
/** A scoped cancellation request, never a PID signal and never permission to create a new job. */
export declare function requestAutomaticStudyAnalysisCancellationPrepared(prepared: PreparedRunArtifactPaths): Promise<AutomaticStudyAnalysisCancellation>;
export {};