Your lightweight open-source personal agent.
Python agent-frameworkai-agentai-agentschatbotchatopsdiscord-botllm-agentsllmslocal-llmmcpmodel-context-protocolmulti-agentopenai-compatibleopenclawpersonal-ai-assistantpythonself-hostedtelegram-bot-ai-assistantwebuiworkflow-automation
import i18n from "i18next";
import { normalizeLocale } from "@/i18n/config";
/** Loose ISO-or-epoch parser; zero denotes an unknown persisted message time. */
function parseDate(value: string | number | null | undefined): Date | null {
if (value === null || value === undefined || value === "" || value === 0) return null;
const d = new Date(value);
return Number.isNaN(d.getTime()) ? null : d;
}
const RELATIVE_THRESHOLDS: [number, Intl.RelativeTimeFormatUnit][] = [
[60, "second"],
[60, "minute"],
[24, "hour"],
[7, "day"],
[4.345, "week"],
[12, "month"],
[Number.POSITIVE_INFINITY, "year"],
];
const relativeTimeFormatters = new Map<string, Intl.RelativeTimeFormat>();
const dateTimeFormatters = new Map<string, Intl.DateTimeFormat>();
const clockTimeFormatters = new Map<string, Intl.DateTimeFormat>();
const hoverTimeFormatters = new Map<string, Intl.DateTimeFormat>();
function activeLocale(locale?: string): string {
return locale || i18n.resolvedLanguage || i18n.language || normalizeLocale(i18n.resolvedLanguage ?? i18n.language);
}
function relativeTimeFormatter(locale: string): Intl.RelativeTimeFormat {
const existing = relativeTimeFormatters.get(locale);
if (existing) return existing;
const formatter = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
relativeTimeFormatters.set(locale, formatter);
return formatter;
}
function dateTimeFormatter(locale: string): Intl.DateTimeFormat {
const existing = dateTimeFormatters.get(locale);
if (existing) return existing;
const formatter = new Intl.DateTimeFormat(locale, {
dateStyle: "medium",
timeStyle: "short",
});
dateTimeFormatters.set(locale, formatter);
return formatter;
}
function clockTimeFormatter(locale: string): Intl.DateTimeFormat {
const existing = clockTimeFormatters.get(locale);
if (existing) return existing;
const formatter = new Intl.DateTimeFormat(locale, {
hour: "2-digit",
minute: "2-digit",
});
clockTimeFormatters.set(locale, formatter);
return formatter;
}
function isSameLocalCalendarDay(left: Date, right: Date): boolean {
return (
left.getFullYear() === right.getFullYear()
&& left.getMonth() === right.getMonth()
&& left.getDate() === right.getDate()
);
}
export function relativeTime(
value: string | number | null | undefined,
locale?: string,
): string {
const date = parseDate(value);
if (!date) return "";
let delta = (date.getTime() - Date.now()) / 1000;
const formatter = relativeTimeFormatter(activeLocale(locale));
for (const [step, unit] of RELATIVE_THRESHOLDS) {
if (Math.abs(delta) < step) {
return formatter.format(Math.round(delta), unit);
}
delta /= step;
}
return formatter.format(Math.round(delta), "year");
}
export function fmtDateTime(
value: string | number | null | undefined,
locale?: string,
): string {
const date = parseDate(value);
return date ? dateTimeFormatter(activeLocale(locale)).format(date) : "";
}
/**
* Format a completion timestamp in the browser's local timezone.
* Today's messages stay compact; older messages include their date for orientation.
*/
export function formatMessageEndTime(
value: number | null | undefined,
locale?: string,
): string {
const date = parseDate(value);
if (!date) return "";
const loc = activeLocale(locale);
return isSameLocalCalendarDay(date, new Date())
? clockTimeFormatter(loc).format(date)
: dateTimeFormatter(loc).format(date);
}
/** One-line gutter label; the full local date/time belongs in its tooltip. */
export function formatMessageHoverTime(
value: number | null | undefined,
locale?: string,
now = new Date(),
): string {
const date = parseDate(value);
if (!date) return "";
const loc = activeLocale(locale);
const today = isSameLocalCalendarDay(date, now);
const key = `${loc}:${today ? "clock" : "date"}`;
let formatter = hoverTimeFormatters.get(key);
if (!formatter) {
formatter = new Intl.DateTimeFormat(loc, today
? { hour: "2-digit", minute: "2-digit", hourCycle: "h23" }
: { month: "numeric", day: "numeric" });
hoverTimeFormatters.set(key, formatter);
}
return formatter.format(date);
}
/** Human-readable turn duration (wall-clock), locale-aware via ``Intl`` (seconds/minutes). */
export function formatTurnLatency(ms: number, locale?: string): string {
const loc = activeLocale(locale);
const msClamped = Math.max(0, ms);
const secTotal = msClamped / 1000;
if (secTotal < 60) {
return new Intl.NumberFormat(loc, {
style: "unit",
unit: "second",
unitDisplay: "narrow",
maximumFractionDigits: secTotal < 10 ? 1 : 0,
minimumFractionDigits: 0,
}).format(secTotal);
}
const wholeMin = Math.floor(secTotal / 60);
const remSec = Math.max(0, Math.round(secTotal - wholeMin * 60));
const minStr = new Intl.NumberFormat(loc, {
style: "unit",
unit: "minute",
unitDisplay: "narrow",
}).format(wholeMin);
const secStr = new Intl.NumberFormat(loc, {
style: "unit",
unit: "second",
unitDisplay: "narrow",
maximumFractionDigits: 0,
}).format(remSec);
return `${minStr}\u00a0${secStr}`;
}