import type { CliRunResult } from "./bearshell.js";
type EvidenceOptions = {
    readonly env?: Readonly<Record<string, string | undefined>>;
    readonly projectDir?: string;
};
type TokenAggregate = {
    readonly cacheRead: number;
    readonly cacheWrite: number;
    readonly input: number;
    readonly output: number;
    readonly reasoning: number;
    readonly total: number;
};
type TokenSessionMetrics = {
    readonly aggregate: TokenAggregate;
    readonly modelID: string | null;
    readonly modelLimit: number | null;
    readonly providerID: string | null;
    readonly ratio: number | null;
    readonly sessionID: string;
};
type FinishMetricRecord = {
    readonly file: string;
    readonly status: "fail" | "pass" | "unknown";
};
type EvidenceMetrics = {
    readonly evidenceDir: string;
    readonly filesScanned: number;
    readonly finish: {
        readonly fail: number;
        readonly pass: number;
        readonly records: readonly FinishMetricRecord[];
        readonly unknown: number;
    };
    readonly limitations: readonly string[];
    readonly mcp: {
        readonly byFamily: Readonly<Record<string, number>>;
        readonly byTool: Readonly<Record<string, number>>;
        readonly total: number;
    };
    readonly projectDir: string;
    readonly readChars: {
        readonly total: number;
        readonly unavailableReason: string | null;
    };
    readonly schemaVersion: "evidence-metrics.1";
    readonly tokenUsage: {
        readonly aggregate: TokenAggregate;
        readonly sessions: readonly TokenSessionMetrics[];
    };
    readonly toolCalls: {
        readonly byTool: Readonly<Record<string, number>>;
        readonly total: number;
    };
    readonly unreadableFiles: readonly string[];
};
export declare function readEvidenceMetrics(options?: EvidenceOptions): EvidenceMetrics;
export declare function writeEvidenceSummary(options?: EvidenceOptions): string | undefined;
export declare function runEvidenceCommand(args: readonly string[], options?: EvidenceOptions, invocationName?: string): CliRunResult;
export {};