/**
 * ForensicsClassifier — auto-classifies failures from event context.
 *
 * Maps combinations of stop reasons, error messages, event sequences,
 * and cascade presence to a FailureClass without requiring manual log
 * spelunking. Classification is heuristic and best-effort.
 */
import type { FailureClass } from './types.js';
/** Inputs available to the classifier at report generation time. */
interface ClassifierInput {
    /** Stop reason from the LLM provider (if any). */
    readonly stopReason?: string;
    /** Error message from the terminal event. */
    readonly errorMessage?: string;
    /** Whether this entity was explicitly cancelled by the operator. */
    readonly wasCancelled?: boolean;
    /** Whether any cascade events were present in the causal context. */
    readonly hasCascadeEvents?: boolean;
    /** Whether any tool calls failed in this turn/task. */
    readonly hasToolFailure?: boolean;
    /** Whether any permission check was denied. */
    readonly hasPermissionDenial?: boolean;
    /** Whether a compaction error was recorded. */
    readonly hasCompactionError?: boolean;
}
/**
 * Classify a failure based on available event context.
 * Rules are evaluated in priority order — first match wins.
 *
 * @returns The classified FailureClass.
 */
export declare function classifyFailure(input: ClassifierInput): FailureClass;
/**
 * Human-readable summary string for a classified failure.
 * Used as the FailureReport.summary.
 */
export declare function summariseFailure(classification: FailureClass, errorMessage?: string, stopReason?: string): string;
export {};
//# sourceMappingURL=classifier.d.ts.map