import type { ActorTokenUsage } from "./actor-contract.js";
/**
 * Accumulate runtime-turn usage from a captured `codex exec --json` stream. A Codex turn may
 * include multiple provider requests; these records cannot establish per-request pricing tiers.
 *
 * Returns undefined when the stream carried no usage record at all, which is the honest "no
 * signal" case and must stay distinguishable from a measured zero. Per-turn records are preserved
 * in `turns` because long-context pricing can only be computed from per-request sizes
 * (src/pricing.ts), and totals cannot say which requests crossed a threshold.
 */
export declare function parseTerminalTokenUsage(transcript: string): ActorTokenUsage | undefined;
/** Human-readable token statement for the cost ledger and the no-spend proof. Reports what was
 *  counted and says plainly that it is unpriced, so a reader never reads "no charge recorded" as
 *  "nothing was consumed". */
export declare function describeTokenUsage(usage: ActorTokenUsage): string;