import { type ContinuityEndpoint, type MessageOrigin } from "@yanlinglabs/winter-provider-runtime";
import { type TranscriptReconcileOutcome } from "../store/reconcile.js";
import type { SharedSessionStore } from "../store/wiring.js";
/**
 * Copies `<root>/projects` to `<home>/cache/quarantine/<ts>-<label>/projects`. Returns the quarantine
 * dir. Refuses (typed) when `cache` or `cache/quarantine` is a link — the evidence is never written
 * through one — and copies links as links (`cpSync` without `dereference`).
 */
export declare function quarantineRoot(root: string, home: string, label: string, now?: Date): string;
/** One transcript's recovery outcome (I6). */
export interface RecoveryTranscriptOutcome {
    projectKey: string;
    sessionId: string;
    /** `subagents/agent-<id>` for a subagent transcript; absent for the session's own. */
    subpath?: string;
    outcome: "clean" | "appended" | "canonical-ahead" | "quarantined";
    /** Entries appended to the canonical file (0 unless `appended`). */
    appended: number;
    /** Why a transcript was quarantined. */
    reason?: string;
    /**
     * On a session's OWN transcript: its session dir's other files (tool results, workflow scripts and
     * run records, subagent metadata), carried into `<sdk>/projects/<key>/<sid>/` — `copied`, already
     * `identical`, or `quarantined` (paths relative to `projects/`; a differing destination is never
     * overwritten).
     */
    artifacts?: {
        copied: number;
        identical: number;
        quarantined: string[];
    };
}
/** `reconcileRootForRecovery`'s answer: the root outcome, and every transcript's own (I6). */
export interface RecoveryReport {
    /** `quarantined` if any transcript was; else `appended` if any tail was appended; else `clean`. */
    outcome: "clean" | "appended" | "quarantined";
    transcripts: RecoveryTranscriptOutcome[];
    /** The quarantine dir holding the quarantined transcripts' and artifacts' copies, when any were. */
    quarantine?: string;
    /**
     * Every carried artifact, totalled — including per-project files beside the session dirs and a
     * session dir with no transcript in this root, which no transcript entry can carry. `skipped` are
     * links (never followed) and special files.
     */
    artifacts?: {
        copied: number;
        identical: number;
        quarantined: string[];
        skipped: string[];
        /** Subagent/journal `.meta.json` files appended to the store as `agent_metadata` (it had none). */
        metadataRepaired?: number;
    };
}
/**
 * Copies the named transcripts (paths under `root`) to `<home>/cache/quarantine/<ts>-<label>/`, keeping
 * their path relative to the root. The same link refusals as `quarantineRoot`.
 */
export declare function quarantineTranscripts(root: string, home: string, label: string, paths: readonly string[], now?: Date): string;
/**
 * One reconciled transcript's recovery outcome. A quarantine REASON names what actually happened: "not
 * level after appending N entries" only when an append was made and the re-read disagreed; otherwise the
 * comparison's own reason (minors round, item 4).
 */
export declare function recoveryOutcomeOf(transcript: TranscriptReconcileOutcome): RecoveryTranscriptOutcome;
/** What `reconcileRootForRecovery` needs from the handle. */
export interface RecoveryInput {
    shared: SharedSessionStore;
    /** The daemon's home (quarantine) and the store's root (the sidecar). */
    home: string;
    storeHome: string;
    resolveEndpoint: (origin: MessageOrigin) => ContinuityEndpoint;
    now?: () => Date;
}
/**
 * Spec §3.8's recovery door, PER TRANSCRIPT (I6). The proof is the judge `reconcileLocalWriteRoot`
 * asks before it appends anything; the append, the re-read and the per-session repair flag are that
 * one function's, as everywhere else. A session's flag is cleared only when every one of its
 * transcripts came back level; the quarantined transcripts' files are copied out and nothing of
 * theirs is ever appended.
 */
export declare function reconcileRootForRecovery(root: string, input: RecoveryInput): Promise<RecoveryReport>;