/** * Jev usage ledger — append-only JSONL at `.specweave/state/jev-usage.jsonl` * * Every Jev call writes one line (tokens, cost, latency, ok). Reading is tolerant: * a truncated or corrupt line is skipped, never thrown. Nothing here stores a key. * * @module core/jev/usage */ export interface JevUsageRecord { at: string; kind: string; provider: string; model: string; input_tokens: number; output_tokens: number; cost?: number; latencyMs: number; /** Secret-shaped spans masked out of the request state before it was sent. */ redactions?: number; requestId?: string; evidenceHash?: string; ok: boolean; } export interface JevUsageSummary { /** Count of calls whose cost was not supplied; cost is only the known subtotal. */ unknownCostCalls?: number; calls: number; input_tokens: number; cost: number; byKind: Record; since?: string; } /** Absolute path of the ledger for a project root. */ export declare function usageLogPath(projectRoot: string): string; /** * Append one record. Best-effort: never throws (the caller is mid-decision). * O_APPEND keeps concurrent agents from interleaving partial lines. */ export declare function appendUsage(projectRoot: string, rec: JevUsageRecord): void; /** Totals over the whole ledger. Missing file → zeroes. Bad lines → skipped. */ export declare function readUsageSummary(projectRoot: string): JevUsageSummary; //# sourceMappingURL=usage.d.ts.map