import type { TokenUsage } from "@tangle-network/agent-interface";
/** One execution's measured token usage and cost. */
export interface ExecutionUsageRecord {
    executionId: string;
    usage: TokenUsage;
    observedAt: string;
}
/**
 * The newest per-execution usage this environment handle measured.
 *
 * Sandbox reports token usage and cost on the result of one execution, never
 * for the environment as a whole, so the only environment-scoped answer is the
 * newest execution the handle actually saw. The record lives with the handle:
 * an environment rebuilt through `provider.get(id)` starts with none, and the
 * observation then reports the usage surface as unavailable rather than as a
 * measured zero.
 */
export interface ExecutionUsageLog {
    record(executionId: string | undefined, usage: TokenUsage | undefined): void;
    latest(): ExecutionUsageRecord | undefined;
}
export declare function createExecutionUsageLog(): ExecutionUsageLog;