/**
 * Release input-guard check (specs/2026-10-04-release-input-guard-check.md).
 *
 * Reads every live agent's input box from the running backend's real
 * terminal buffers (styling kept, ghost text blanked) and classifies it with
 * the NEW build's guard, run in a fresh node process. A build that reads an
 * idle agent's input box as `unknown` would hold every message delivery
 * (1.20.198), so the upgrade flow refuses to restart onto it.
 *
 * @module services/system/input-guard-release-check
 */
import type { InputGuardClassification, InputGuardViewInput } from '../../scripts/input-guard-classify.js';
/** One agent row of the report. */
export type InputGuardAgentResult = InputGuardClassification;
/** Report of one check. */
export interface InputGuardReport {
    /** No idle agent reads as unknown */
    ok: boolean;
    /** The check could not run at all (old build without the script): not blocking */
    unavailable?: boolean;
    /** Script that classified (absent when unavailable) */
    script?: string;
    checkedAt: string;
    agents: InputGuardAgentResult[];
    /** Why it failed / could not run */
    error?: string;
}
/** What the live backend offers. */
export interface LiveViewSource {
    listSessions(): string[];
    captureInputView?(name: string): {
        lines: string[];
        cursorRow: number;
    } | null;
}
/** Runs the classifier script; resolves its stdout, rejects on failure. */
export type ClassifierRunner = (script: string, stdin: string) => Promise<string>;
/**
 * Find the new build's classifier script under a path the caller names.
 *
 * @param build - Package root, `dist` dir, `dist/backend` dir, or the script's dir
 * @returns Absolute script path, or null when the build has none
 */
export declare function resolveClassifierScript(build: string): string | null;
/**
 * Gather the live view of every PTY session; one without a styled capture
 * gets a null view and is reported as skipped.
 *
 * @param source - The session backend
 * @param runtimeOf - Runtime type of a session (from persisted metadata)
 * @param ownPastesOf - The harness's pastes into a session since the last
 *   outside input (input ledger), so a box holding only those reads as the
 *   harness's own (crewly#1028)
 * @returns One entry per session
 */
export declare function collectLiveViews(source: LiveViewSource, runtimeOf: (session: string) => string | undefined, ownPastesOf?: (session: string) => {
    pastes: string[];
    shownMarkers: Array<{
        marker: string;
        message: string;
    }>;
}): InputGuardViewInput[];
/**
 * Default runner: `node <script>` in a fresh process, input on stdin.
 *
 * @param script - Script path
 * @param stdin - Input text
 * @returns Its stdout
 */
export declare const spawnClassifier: ClassifierRunner;
/** Inputs of {@link runInputGuardCheck}. */
export interface InputGuardCheckInput {
    /** Build to classify with (see {@link resolveClassifierScript}) */
    build: string;
    /** Live views of the agents */
    views: InputGuardViewInput[];
    /** Process runner (tests inject one) */
    run?: ClassifierRunner;
    now?: () => number;
}
/**
 * Classify the live views with the build's guard.
 *
 * @param input - Build and views
 * @returns The report (never throws)
 */
export declare function runInputGuardCheck(input: InputGuardCheckInput): Promise<InputGuardReport>;
/**
 * The failing agents of a report.
 *
 * @param report - Report
 * @returns Rows with verdict `fail`
 */
export declare function failingAgents(report: InputGuardReport): InputGuardAgentResult[];
/**
 * What a block means for the machine: the new package is already installed.
 *
 * @param version - Blocked target version
 * @param running - Version still running
 * @returns English sentence
 */
export declare function onDiskWarning(version: string, running?: string | null): string;
/**
 * One English line for logs and the action record.
 *
 * @param report - A failed report
 * @param version - Target version, when known
 * @returns The sentence
 */
export declare function describeBlock(report: InputGuardReport, version?: string): string;
/**
 * Owner notice (short, English).
 *
 * @param report - A failed report
 * @param version - Target version
 * @param running - Version still running
 * @returns Title and message
 */
export declare function composeBlockNotice(report: InputGuardReport, version: string, running?: string | null): {
    title: string;
    message: string;
};
/** Marker of a build that is on disk but failed the check. */
export interface BlockedBuildMarker {
    version: string;
    at: string;
    failing: string[];
}
/**
 * Record that `version` is installed but was not restarted onto.
 *
 * @param crewlyHome - Crewly home
 * @param marker - What to record
 */
export declare function writeBlockedBuild(crewlyHome: string, marker: BlockedBuildMarker): void;
/**
 * Read the blocked-build marker.
 *
 * @param crewlyHome - Crewly home
 * @returns The marker, or null
 */
export declare function readBlockedBuild(crewlyHome: string): BlockedBuildMarker | null;
/**
 * Remove the blocked-build marker (a check passed, or the owner forced).
 *
 * @param crewlyHome - Crewly home
 */
export declare function clearBlockedBuild(crewlyHome: string): void;
/**
 * Whether the owner was already told about `version` being blocked.
 *
 * @param crewlyHome - Crewly home
 * @param version - Target version
 * @returns True when a notice for it was sent
 */
export declare function wasBlockNotified(crewlyHome: string, version: string): boolean;
/**
 * Record that the owner was told (call only after the send succeeded).
 *
 * @param crewlyHome - Crewly home
 * @param version - Target version
 */
export declare function recordBlockNotified(crewlyHome: string, version: string): void;
/**
 * Plain-text table of a report (CLI).
 *
 * @param report - Report
 * @returns Lines
 */
export declare function formatReportLines(report: InputGuardReport): string[];
//# sourceMappingURL=input-guard-release-check.d.ts.map