import type { QuestionAnswerEntry, QuestionRecord } from './types.js';
export type QuestionEventType = 'question-created' | 'question-answered' | 'question-error';
export interface QuestionEventRecord {
    kind: 'omx.question-event/v1';
    event_id: string;
    type: QuestionEventType;
    question_id: string;
    session_id?: string;
    run_id?: string;
    created_at: string;
    question_created_at?: string;
    status: QuestionRecord['status'];
    source?: string;
    context_summary?: string;
    option_schema?: QuestionRecord['questions'];
    state?: {
        record_path?: string;
        renderer?: QuestionRecord['renderer'];
        timeout_ms?: number;
        error?: QuestionRecord['error'];
        answer_count?: number;
    };
}
export declare function getQuestionEventsPath(cwd: string): string;
export declare function resolveQuestionRunId(env?: NodeJS.ProcessEnv): string | undefined;
export declare function summarizeQuestionContext(record: QuestionRecord): string;
export declare function buildQuestionEvent(type: QuestionEventType, record: QuestionRecord, options?: {
    recordPath?: string;
    timeoutMs?: number;
    runId?: string;
    now?: Date;
}): QuestionEventRecord;
export declare function appendQuestionEvent(cwd: string, type: QuestionEventType, record: QuestionRecord, options?: {
    recordPath?: string;
    timeoutMs?: number;
    runId?: string;
    now?: Date;
}): Promise<QuestionEventRecord>;
export declare function appendQuestionAnsweredEventOnce(cwd: string, record: QuestionRecord, options?: {
    recordPath?: string;
    timeoutMs?: number;
    runId?: string;
    now?: Date;
}): Promise<{
    event: QuestionEventRecord;
    appended: boolean;
}>;
export declare function readQuestionEvents(cwd: string, options?: {
    limit?: number;
    type?: QuestionEventType;
}): Promise<QuestionEventRecord[]>;
export declare function normalizeSubmittedAnswers(record: QuestionRecord, raw: unknown): QuestionAnswerEntry[];
//# sourceMappingURL=events.d.ts.map