Files
clawdbot/src/agents/usage.ts
2026-01-06 19:54:50 +01:00

112 lines
2.6 KiB
TypeScript

export type UsageLike = {
input?: number;
output?: number;
cacheRead?: number;
cacheWrite?: number;
total?: number;
// Common alternates across providers/SDKs.
inputTokens?: number;
outputTokens?: number;
promptTokens?: number;
completionTokens?: number;
input_tokens?: number;
output_tokens?: number;
prompt_tokens?: number;
completion_tokens?: number;
cache_read_input_tokens?: number;
cache_creation_input_tokens?: number;
// Some agents/logs emit alternate naming.
totalTokens?: number;
total_tokens?: number;
cache_read?: number;
cache_write?: number;
};
export type NormalizedUsage = {
input?: number;
output?: number;
cacheRead?: number;
cacheWrite?: number;
total?: number;
};
const asFiniteNumber = (value: unknown): number | undefined => {
if (typeof value !== "number") return undefined;
if (!Number.isFinite(value)) return undefined;
return value;
};
export function hasNonzeroUsage(
usage?: NormalizedUsage | null,
): usage is NormalizedUsage {
if (!usage) return false;
return [
usage.input,
usage.output,
usage.cacheRead,
usage.cacheWrite,
usage.total,
].some((v) => typeof v === "number" && Number.isFinite(v) && v > 0);
}
export function normalizeUsage(
raw?: UsageLike | null,
): NormalizedUsage | undefined {
if (!raw) return undefined;
const input = asFiniteNumber(
raw.input ??
raw.inputTokens ??
raw.input_tokens ??
raw.promptTokens ??
raw.prompt_tokens,
);
const output = asFiniteNumber(
raw.output ??
raw.outputTokens ??
raw.output_tokens ??
raw.completionTokens ??
raw.completion_tokens,
);
const cacheRead = asFiniteNumber(
raw.cacheRead ?? raw.cache_read ?? raw.cache_read_input_tokens,
);
const cacheWrite = asFiniteNumber(
raw.cacheWrite ?? raw.cache_write ?? raw.cache_creation_input_tokens,
);
const total = asFiniteNumber(
raw.total ?? raw.totalTokens ?? raw.total_tokens,
);
if (
input === undefined &&
output === undefined &&
cacheRead === undefined &&
cacheWrite === undefined &&
total === undefined
) {
return undefined;
}
return {
input,
output,
cacheRead,
cacheWrite,
total,
};
}
export function derivePromptTokens(usage?: {
input?: number;
cacheRead?: number;
cacheWrite?: number;
}): number | undefined {
if (!usage) return undefined;
const input = usage.input ?? 0;
const cacheRead = usage.cacheRead ?? 0;
const cacheWrite = usage.cacheWrite ?? 0;
const sum = input + cacheRead + cacheWrite;
return sum > 0 ? sum : undefined;
}