import { type TomlTable } from "../config";
export interface MetricEventPayload {
    [key: string]: unknown;
}
export interface RecordMetricOptions {
    codexHome?: string;
    payload?: MetricEventPayload;
}
export interface ReadMetricOptions {
    codexHome?: string;
    from?: string;
    to?: string;
    limit?: number;
}
export interface MetricRecord {
    schema_version: 1;
    event: string;
    at: string;
    actor_id: string;
    [key: string]: unknown;
}
export interface MetricsSettings {
    enabled: boolean;
    outputPath: string;
    actorId: string;
}
export declare function recordMetricEvent(event: string, options?: RecordMetricOptions): Promise<boolean>;
export declare function tryRecordMetricEvent(event: string, options?: RecordMetricOptions): Promise<void>;
export declare function readMetricEvents(options?: ReadMetricOptions): Promise<MetricRecord[]>;
export declare function loadMetricsSettings(codexHome?: string): Promise<MetricsSettings>;
export declare function resolveMetricsSettings(config: TomlTable, codexHome: string): MetricsSettings;