export type RunClassification = 'ok' | 'capped' | 'error';
export interface RunOutcome {
    exitCode: number;
    stderr: string;
    stdout?: string;
}
export interface CapClassification {
    kind: RunClassification;
    /** Extracted reset time (epoch ms) when the signal provided a parseable one. */
    resetAt?: number;
    reason?: string;
}
/** Classify a completed run as ok, capped (rate-limited), or a generic error. */
export declare function classifyRun(outcome: RunOutcome): CapClassification;
/**
 * Match the rate-limit signal in a live output STREAM for the PTY watcher. ANSI
 * escape codes are stripped first so the words still match inside the TUI render.
 */
export declare function matchesCapText(text: string): CapClassification | null;