Skip to content

Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.

8.6 KB
Raw Blame
import * as DateTime from "effect/DateTime";
import * as Option from "effect/Option";
/**
 * Display formatting for the usage page.
 *
 * @module usageFormat
 */
import {
  UsageDay,
  type ThreadTokenUsageSnapshot,
  type UsageResolution,
  type UsageSummaryInput,
  type UsageTokenTotals,
} from "@akeru/contracts";

const CURRENCY = new Intl.NumberFormat("en-US", {
  style: "currency",
  currency: "USD",
  minimumFractionDigits: 2,
  maximumFractionDigits: 2,
});

const INTEGER = new Intl.NumberFormat("en-US");

export function formatUsd(value: number): string {
  return CURRENCY.format(value);
}

export function formatCount(value: number): string {
  return INTEGER.format(Math.round(value));
}

/**
 * Compacts a token count to three significant figures with a unit suffix, so
 * columns of numbers line up at a glance (`19.9B`, `76.7M`, `804K`).
 */
export function formatTokens(value: number): string {
  const abs = Math.abs(value);

  if (abs >= 1e12) return `${trim(value / 1e12)}T`;

  if (abs >= 1e9) return `${trim(value / 1e9)}B`;

  if (abs >= 1e6) return `${trim(value / 1e6)}M`;

  if (abs >= 1e3) return `${trim(value / 1e3)}K`;

  return INTEGER.format(Math.round(value));
}

export function stepTokenCount(usage: ThreadTokenUsageSnapshot): number | null {
  if (usage.lastInputTokens !== undefined || usage.lastOutputTokens !== undefined) {
    return (usage.lastInputTokens ?? 0) + (usage.lastOutputTokens ?? 0);
  }

  return usage.lastUsedTokens ?? null;
}

export function stepUsageTokenTotals(usage: ThreadTokenUsageSnapshot): UsageTokenTotals {
  const inputTokens = usage.lastInputTokens ?? 0;
  const cachedInputTokens = Math.min(inputTokens, usage.lastCachedInputTokens ?? 0);
  const outputTokens = usage.lastOutputTokens ?? 0;

  return {
    uncachedInputTokens: Math.max(0, inputTokens - cachedInputTokens),
    cachedInputTokens,
    cacheCreationTokens: 0,
    outputTokens,
    reasoningTokens: Math.min(outputTokens, usage.lastReasoningOutputTokens ?? 0),
  };
}

function trim(value: number): string {
  const abs = Math.abs(value);
  const digits = abs >= 100 ? 0 : abs >= 10 ? 1 : 2;

  return value.toFixed(digits).replace(/\.0+$/, "");
}

export function formatPercent(share: number, digits = 1): string {
  return `${(share * 100).toFixed(digits)}%`;
}

/** `2026-08-07` to `Aug 7`. */
export function formatDayShort(day: string): string {
  const [year, month, dayOfMonth] = day.split("-").map((part) => Number(part));

  if (year === undefined || month === undefined || dayOfMonth === undefined) return day;

  const MONTHS = [
    "Jan",
    "Feb",
    "Mar",
    "Apr",
    "May",
    "Jun",
    "Jul",
    "Aug",
    "Sep",
    "Oct",
    "Nov",
    "Dec",
  ];

  return `${MONTHS[month - 1] ?? ""} ${dayOfMonth}`;
}

/** Inclusive day list between two `YYYY-MM-DD` bounds. */
export function enumerateDays(sinceDay: string, untilDay: string): readonly string[] {
  const days: string[] = [];
  const start = Date.parse(`${sinceDay}T00:00:00Z`);
  const end = Date.parse(`${untilDay}T00:00:00Z`);

  if (Number.isNaN(start) || Number.isNaN(end) || end < start) return days;

  for (let cursor = start; cursor <= end; cursor += 86_400_000) {
    days.push(DateTime.formatIso(DateTime.makeUnsafe(cursor)).slice(0, 10));
  }

  return days;
}

const HOUR_MS = 60 * 60 * 1000;

/** Every fixed-duration bucket start in an hourly rolling window. */
export function enumerateHourStarts(sinceTime: string, untilTime: string): readonly string[] {
  const starts: string[] = [];
  const start = Date.parse(sinceTime);
  const end = Date.parse(untilTime);

  if (Number.isNaN(start) || Number.isNaN(end) || end <= start) return starts;

  for (let cursor = start; cursor < end; cursor += HOUR_MS) {
    starts.push(DateTime.formatIso(DateTime.makeUnsafe(cursor)));
  }

  return starts;
}

/**
 * A rolling bucket start rendered in the viewer's requested time zone.
 *
 * Repeated wall-clock hours during a fall-back transition include their short
 * zone name so the two distinct buckets remain distinguishable.
 */
export function formatHourShort(hourStart: string, timeZone?: string): string {
  const parsed = DateTime.make(Date.parse(hourStart));

  if (Option.isNone(parsed)) return hourStart;
  const instant = DateTime.toEpochMillis(parsed.value);
  const options = timeZone === undefined ? {} : { timeZone };

  const hourFormat = new Intl.DateTimeFormat("en-US", {
    ...options,
    hour: "numeric",
  });

  const wallHourFormat = new Intl.DateTimeFormat("en-CA", {
    ...options,
    year: "numeric",
    month: "2-digit",
    day: "2-digit",
    hour: "2-digit",
    hourCycle: "h23",
  });

  const wallHour = wallHourFormat.format(instant);

  const isRepeatedHour = [-HOUR_MS, HOUR_MS].some(
    (offset) => wallHourFormat.format(instant + offset) === wallHour,
  );

  if (!isRepeatedHour) return hourFormat.format(instant);

  return new Intl.DateTimeFormat("en-US", {
    ...(timeZone === undefined ? {} : { timeZone }),
    hour: "numeric",
    timeZoneName: "short",
  }).format(instant);
}

/** `2026-08-11T14:37:00Z` to `Aug 11, 2 PM` in the requested zone. */
export function formatDateTimeShort(instant: string, timeZone?: string): string {
  const date = DateTime.make(Date.parse(instant));

  if (Option.isNone(date)) return instant;

  return new Intl.DateTimeFormat("en-US", {
    ...(timeZone === undefined ? {} : { timeZone }),
    month: "short",
    day: "numeric",
    hour: "numeric",
  }).format(DateTime.toEpochMillis(date.value));
}

/** An hourly tooltip label relative to the rolling window's end date. */
export function formatRelativeHourShort(
  hourStart: string,
  relativeTo: string,
  timeZone?: string,
): string {
  const instant = DateTime.make(Date.parse(hourStart));
  const reference = DateTime.make(Date.parse(relativeTo));

  if (Option.isNone(instant) || Option.isNone(reference)) {
    return formatDateTimeShort(hourStart, timeZone);
  }

  const dayFormat = new Intl.DateTimeFormat("en-CA", {
    ...(timeZone === undefined ? {} : { timeZone }),
    year: "numeric",
    month: "2-digit",
    day: "2-digit",
  });

  const instantDay = Date.parse(
    `${dayFormat.format(DateTime.toEpochMillis(instant.value))}T00:00:00Z`,
  );

  const referenceDay = Date.parse(
    `${dayFormat.format(DateTime.toEpochMillis(reference.value))}T00:00:00Z`,
  );

  const calendarDaysAgo = Math.round((referenceDay - instantDay) / (24 * HOUR_MS));
  const hour = formatHourShort(hourStart, timeZone);

  if (calendarDaysAgo === 0) return `${hour} today`;

  if (calendarDaysAgo === 1) return `${hour} yesterday`;

  return formatDateTimeShort(hourStart, timeZone);
}

/**
 * The window the page requests, expressed in the viewer's own time zone so days
 * line up with what they actually experienced.
 */
export function makeWindow(
  days: number,
  now = DateTime.toDateUtc(DateTime.nowUnsafe()),
  resolution: UsageResolution = "day",
): UsageSummaryInput {
  let timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
  let format: Intl.DateTimeFormat;

  try {
    format = new Intl.DateTimeFormat("en-CA", {
      timeZone,
      year: "numeric",
      month: "2-digit",
      day: "2-digit",
    });
  } catch {
    // An unknown zone should degrade to UTC rather than crash the page.
    timeZone = "UTC";
    format = new Intl.DateTimeFormat("en-CA", {
      timeZone: "UTC",
      year: "numeric",
      month: "2-digit",
      day: "2-digit",
    });
  }

  const untilDay = format.format(now);

  if (resolution === "hour") {
    // Minute-aligned bounds keep labels readable while still representing an
    // exact rolling 24-hour duration. Fixed-duration buckets remain correct
    // across offset changes and daylight-saving transitions.
    const untilTimeMs = Math.floor(now.getTime() / 60_000) * 60_000;
    const sinceTimeMs = untilTimeMs - 24 * HOUR_MS;
    const sinceTime = DateTime.makeUnsafe(sinceTimeMs);
    const untilTime = DateTime.makeUnsafe(untilTimeMs);

    return {
      sinceDay: UsageDay.make(format.format(sinceTimeMs)),
      untilDay: UsageDay.make(format.format(untilTimeMs)),
      timeZone,
      resolution,
      sinceTime: DateTime.formatIso(sinceTime),
      untilTime: DateTime.formatIso(untilTime),
    };
  }

  // Subtracting fixed milliseconds from `now` lands on the wrong calendar day
  // around a DST transition. The window start is pure calendar arithmetic on
  // the local end day, done in UTC where days are uniform.
  const [year = 0, month = 1, dayOfMonth = 1] = untilDay
    .split("-")
    .map((part) => Number.parseInt(part, 10));

  const start = DateTime.makeUnsafe(Date.UTC(year, month - 1, dayOfMonth - (days - 1)));

  return {
    sinceDay: UsageDay.make(DateTime.formatIso(start).slice(0, 10)),
    untilDay: UsageDay.make(untilDay),
    timeZone,
    resolution,
  };
}