@promptbook/cli 0.112.0-132 → 0.112.0-134

package/apps/agents-server/src/app/admin/usage/UsageClientFormatting.ts

@@ -4,6 +4,8 @@ import type {
     UsageCallType,
     UsageMetricMode,
 } from '@/src/utils/usageAdmin';
+import type { ServerLanguageCode } from '@/src/languages/ServerLanguageRegistry';
+import { formatServerLanguageHumanReadableDate } from '@/src/utils/localization/formatServerLanguageHumanReadableDate';
 
 /**
  * Source shape with metric values used across usage widgets.
@@ -90,20 +92,12 @@ export const UsageClientFormatting = {
         return usageCompactFormatter.format(value);
     },
 
-    formatDateTime(iso: string): string {
-        const date = new Date(iso);
-        if (Number.isNaN(date.getTime())) {
-            return iso;
-        }
-        return date.toLocaleString();
+    formatDateTime(iso: string, language: ServerLanguageCode): string {
+        return formatServerLanguageHumanReadableDate(iso, language);
     },
 
-    formatShortDate(iso: string): string {
-        const date = new Date(iso);
-        if (Number.isNaN(date.getTime())) {
-            return iso;
-        }
-        return date.toLocaleDateString();
+    formatShortDate(iso: string, language: ServerLanguageCode): string {
+        return formatServerLanguageHumanReadableDate(iso, language);
     },
 
     isIsoDateInputValue(value: string): boolean {

package/apps/agents-server/src/app/admin/usage/UsageClientTimelineChart.tsx

@@ -1,3 +1,4 @@
+import type { ServerLanguageCode } from '@/src/languages/ServerLanguageRegistry';
 import type { UsageAnalyticsResponse, UsageMetricMode } from '@/src/utils/usageAdmin';
 import { useMemo } from 'react';
 import { UsageClientFormatting } from './UsageClientFormatting';
@@ -24,6 +25,7 @@ type UsageClientTimelinePoint = {
  * Props for `<UsageClientTimelineChart/>`.
  */
 type UsageClientTimelineChartProps = {
+    language: ServerLanguageCode;
     points: UsageAnalyticsResponse['timeline'];
     metric: UsageMetricMode;
 };
@@ -34,7 +36,7 @@ type UsageClientTimelineChartProps = {
  * @private function of UsageClient
  */
 export function UsageClientTimelineChart(props: UsageClientTimelineChartProps) {
-    const { points, metric } = props;
+    const { language, points, metric } = props;
 
     const chartGeometry = useMemo(() => {
         const paddedWidth = TIMELINE_WIDTH;
@@ -73,11 +75,12 @@ export function UsageClientTimelineChart(props: UsageClientTimelineChartProps) {
 
     const linePath = toLinePath(chartGeometry.coordinates);
     const areaPath = toAreaPath(chartGeometry.coordinates, chartGeometry.height - chartGeometry.paddingY);
-    const firstLabel = UsageClientFormatting.formatShortDate(points[0].bucketStart);
+    const firstLabel = UsageClientFormatting.formatShortDate(points[0].bucketStart, language);
     const middleLabel = UsageClientFormatting.formatShortDate(
         points[Math.floor(points.length / 2)]?.bucketStart || points[0].bucketStart,
+        language,
     );
-    const lastLabel = UsageClientFormatting.formatShortDate(points[points.length - 1].bucketStart);
+    const lastLabel = UsageClientFormatting.formatShortDate(points[points.length - 1].bucketStart, language);
 
     return (
         <div>

package/apps/agents-server/src/app/admin/usage/useUsageClientState.ts

@@ -8,6 +8,7 @@ import {
     type UsageMetricMode,
     type UsageTimeframePreset,
 } from '@/src/utils/usageAdmin';
+import type { ServerLanguageCode } from '@/src/languages/ServerLanguageRegistry';
 import { usePathname, useRouter } from 'next/navigation';
 import { useCallback, useEffect, useMemo, useState } from 'react';
 import { UsageClientFormatting } from './UsageClientFormatting';
@@ -142,13 +143,17 @@ function resolveUsageClientSelectedScopeLabel(
 /**
  * Resolves the human-readable timeframe range chip label.
  */
-function resolveUsageClientTimeframeRangeLabel(data: UsageAnalyticsResponse | null): string | null {
+function resolveUsageClientTimeframeRangeLabel(
+    data: UsageAnalyticsResponse | null,
+    language: ServerLanguageCode,
+): string | null {
     if (!data) {
         return null;
     }
 
-    return `${UsageClientFormatting.formatDateTime(data.timeframe.from)} - ${UsageClientFormatting.formatDateTime(
+    return `${UsageClientFormatting.formatDateTime(data.timeframe.from, language)} - ${UsageClientFormatting.formatDateTime(
         data.timeframe.to,
+        language,
     )}`;
 }
 
@@ -164,7 +169,10 @@ function resolveUsageClientAnalyticsErrorMessage(fetchError: unknown): string {
  *
  * @private function of <UsageClient/>
  */
-export function useUsageClientState(props: UseUsageClientStateProps): UseUsageClientStateResult {
+export function useUsageClientState(
+    props: UseUsageClientStateProps,
+    language: ServerLanguageCode,
+): UseUsageClientStateResult {
     const { agents, folders } = props;
     const router = useRouter();
     const pathname = usePathname();
@@ -271,7 +279,7 @@ export function useUsageClientState(props: UseUsageClientStateProps): UseUsageCl
         [agentName, agents, folderId, folders],
     );
 
-    const timeframeRangeLabel = useMemo(() => resolveUsageClientTimeframeRangeLabel(data), [data]);
+    const timeframeRangeLabel = useMemo(() => resolveUsageClientTimeframeRangeLabel(data, language), [data, language]);
 
     const handleAgentNameChange = useCallback((value: string) => {
         setAgentName(value);

package/apps/agents-server/src/app/admin/users/[userId]/UserDetailClient.tsx

@@ -7,6 +7,7 @@ import { Card } from '../../../../components/Homepage/Card';
 import { Section } from '../../../../components/Homepage/Section';
 import { useServerLanguage } from '../../../../components/ServerLanguage/ServerLanguageProvider';
 import { useUsersAdmin } from '../../../../components/UsersList/useUsersAdmin';
+import { formatServerLanguageHumanReadableDate } from '../../../../utils/localization/formatServerLanguageHumanReadableDate';
 
 /**
  * Props for user detail client.
@@ -26,7 +27,7 @@ type UserDetailClientProps = {
  */
 export function UserDetailClient({ userId }: UserDetailClientProps) {
     const router = useRouter();
-    const { t } = useServerLanguage();
+    const { language, t } = useServerLanguage();
     const { users, loading, error, deleteUser, toggleAdmin } = useUsersAdmin();
 
     const user = useMemo(
@@ -108,11 +109,15 @@ export function UserDetailClient({ userId }: UserDetailClientProps) {
                             )}
                             <p className="text-gray-500 text-sm mt-1">
                                 {t('users.createdAtLabel')}:{' '}
-                                {user.createdAt ? new Date(user.createdAt).toLocaleString() : t('users.unknownValue')}
+                                {formatServerLanguageHumanReadableDate(user.createdAt, language, {
+                                    fallbackLabel: t('users.unknownValue'),
+                                })}
                             </p>
                             <p className="text-gray-500 text-sm mt-1">
                                 {t('users.lastUpdatedLabel')}:{' '}
-                                {user.updatedAt ? new Date(user.updatedAt).toLocaleString() : t('users.unknownValue')}
+                                {formatServerLanguageHumanReadableDate(user.updatedAt, language, {
+                                    fallbackLabel: t('users.unknownValue'),
+                                })}
                             </p>
                         </div>
                         <div className="space-x-2">

package/apps/agents-server/src/app/agents/[agentName]/AgentProfileChat.tsx

@@ -28,7 +28,7 @@ import type { ServerLanguageCode } from '../../../languages/ServerLanguageRegist
 import { buildFreshAgentChatHref } from '../../../utils/agentRouting/agentRouteHrefs';
 import { executeQuickActionButton } from '../../../utils/chat/executeQuickActionButton';
 import { resolveChatMessageValidationIssue } from '../../../utils/chat/validateChatMessageContent';
-import { createServerLanguageMoment } from '../../../utils/localization/createServerLanguageMoment';
+import { formatServerLanguageHumanReadableDate } from '../../../utils/localization/formatServerLanguageHumanReadableDate';
 import { createDefaultSpeechRecognition } from '../../../utils/speech-to-text/createDefaultSpeechRecognition';
 import { chatFileUploadHandler } from '../../../utils/upload/createBookEditorUploadHandler';
 import { createUserChatClientMessageId, type UserChatSummary } from '../../../utils/userChatClient';
@@ -120,21 +120,6 @@ type OptimisticChatNavigationState = {
     attachments?: ChatMessage['attachments'];
 };
 
-/**
- * Parses one profile-chat timestamp using the active Agents Server language.
- *
- * @param timestamp - ISO string describing the chat update time.
- * @param language - Active Agents Server language code.
- * @returns Localized moment instance or `null` when the timestamp is invalid.
- */
-function resolveProfileChatTimestampMoment(
-    timestamp: string,
-    language: ServerLanguageCode,
-): ReturnType<typeof createServerLanguageMoment> | null {
-    const parsed = createServerLanguageMoment(timestamp, language);
-    return parsed.isValid() ? parsed : null;
-}
-
 /**
  * Returns true when a message has non-whitespace content.
  */
@@ -643,9 +628,10 @@ function ExistingChatsPanel({
                 </div>
                 <div className="mt-4 space-y-3 overflow-y-auto pr-1" style={{ maxHeight: `${scrollViewportHeight}px` }}>
                     {chats.map((chat) => {
-                        const updatedAtMoment = resolveProfileChatTimestampMoment(chat.updatedAt, language);
-                        const fullTimeLabel = updatedAtMoment ? updatedAtMoment.format('L LT') : chat.updatedAt;
-                        const timeLabel = updatedAtMoment ? updatedAtMoment.fromNow() || fullTimeLabel : chat.updatedAt;
+                        const fullTimeLabel = formatServerLanguageHumanReadableDate(chat.updatedAt, language, {
+                            isExactDateIncluded: true,
+                        });
+                        const timeLabel = formatServerLanguageHumanReadableDate(chat.updatedAt, language);
                         const title = chat.title || formatText('Untitled chat');
                         const previewText = hasMessageContent(chat.preview)
                             ? chat.preview
@@ -678,7 +664,7 @@ function ExistingChatsPanel({
                                         </span>
                                     </div>
                                     <time
-                                        dateTime={updatedAtMoment ? updatedAtMoment.toISOString() : chat.updatedAt}
+                                        dateTime={chat.updatedAt}
                                         title={fullTimeLabel}
                                         className="text-[0.65rem] font-semibold text-slate-400 dark:text-slate-500"
                                     >

package/apps/agents-server/src/app/agents/[agentName]/api/book/route.ts

@@ -1,5 +1,6 @@
 import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
 import { $provideAgentReferenceResolver } from '@/src/utils/agentReferenceResolver/$provideAgentReferenceResolver';
+import { invalidateCachedActiveOrganizationSnapshots } from '@/src/utils/agentOrganization/loadAgentOrganizationState';
 import {
     parseBookScopedAgentIdentifier,
     resolveBookScopedAgentContext,
@@ -172,6 +173,7 @@ export async function PUT(request: Request, { params }: { params: Promise<{ agen
 
         const agentId = await collection.getAgentPermanentId(agentName);
         await collection.updateAgentSource(agentId, agentSource, { versionName });
+        invalidateCachedActiveOrganizationSnapshots();
         // <- TODO: [🐱‍🚀] Properly type as string_book
 
         return new Response(

package/apps/agents-server/src/app/agents/[agentName]/book/useBookEditorHistory.ts

@@ -1,6 +1,9 @@
 import type { string_book } from '@promptbook-local/types';
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { showAlert, showConfirm, showPrompt } from '@/src/components/AsyncDialogs/asyncDialogs';
+import { useServerLanguage } from '@/src/components/ServerLanguage/ServerLanguageProvider';
+import type { ServerLanguageCode } from '@/src/languages/ServerLanguageRegistry';
+import { formatServerLanguageHumanReadableDate } from '@/src/utils/localization/formatServerLanguageHumanReadableDate';
 import type { BookEditorHistoryVersionItem } from './BookEditorHistoryPanel';
 import { resolveBookEditorApiErrorMessage } from './resolveBookEditorApiErrorMessage';
 
@@ -340,6 +343,7 @@ function resolveSelectedHistoryId<HistoryItem extends { readonly id: number }>(
  */
 function buildHistoryVersionItems(
     historyEntries: ReadonlyArray<AgentHistoryEntry>,
+    language: ServerLanguageCode,
 ): Array<BookEditorHistoryVersionItem> {
     const totalVersions = historyEntries.length;
 
@@ -347,7 +351,9 @@ function buildHistoryVersionItems(
         id: entry.id,
         versionName: normalizeHistoryVersionName(entry.versionName),
         versionLabel: `Version ${totalVersions - index}`,
-        createdAtLabel: new Date(entry.createdAt).toLocaleString(),
+        createdAtLabel: formatServerLanguageHumanReadableDate(entry.createdAt, language, {
+            isExactDateIncluded: true,
+        }),
         hash: entry.agentHash,
         hashPreview: entry.agentHash.slice(0, 8),
         source: entry.agentSource,
@@ -800,6 +806,7 @@ export function useBookEditorHistory({
     replaceWithRestoredSource,
     requestDiagnostics,
 }: UseBookEditorHistoryProps) {
+    const { language } = useServerLanguage();
     const [isHistoryOpen, setIsHistoryOpen] = useState(false);
     const [historyNameQuery, setHistoryNameQuery] = useState('');
     const [isNamedHistoryOnly, setIsNamedHistoryOnly] = useState(false);
@@ -840,7 +847,7 @@ export function useBookEditorHistory({
      *
      * @private function of useBookEditorHistory
      */
-    const historyVersions = useMemo(() => buildHistoryVersionItems(historyEntries), [historyEntries]);
+    const historyVersions = useMemo(() => buildHistoryVersionItems(historyEntries, language), [historyEntries, language]);
 
     /**
      * Filtered history items matching the current panel controls.

package/apps/agents-server/src/app/agents/[agentName]/chat/useAgentChatHistoryClientState.ts

@@ -9,9 +9,8 @@ import { usePrivateModePreferences } from '../../../../components/PrivateModePre
 import { useBrowserPushNotifications } from '../../../../components/PushNotifications/BrowserPushNotificationsProvider';
 import { useServerLanguage } from '../../../../components/ServerLanguage/ServerLanguageProvider';
 import { useActiveBrowserTab } from '../../../../hooks/useActiveBrowserTab';
-import type { ServerLanguageCode } from '../../../../languages/ServerLanguageRegistry';
 import type { ChatFeedbackMode } from '../../../../utils/chatFeedbackMode';
-import { createServerLanguageMoment } from '../../../../utils/localization/createServerLanguageMoment';
+import { formatServerLanguageHumanReadableDate } from '../../../../utils/localization/formatServerLanguageHumanReadableDate';
 import { consumeShareTargetPayloadFromBrowser } from '../../../../utils/shareTargetClient';
 import type { UserChatJob, UserChatSummary, UserChatTimeout } from '../../../../utils/userChatClient';
 import { FORCE_NEW_CHAT_QUERY_VALUE } from '../agentChatNavigationUtils';
@@ -309,7 +308,7 @@ export function useAgentChatHistoryClientState(
     useHoistedMobileMenuItems(hoistedMobileMenuItems);
 
     const formatChatTimestamp = useCallback(
-        (timestamp: string): string => formatRelativeChatTimestamp(timestamp, language),
+        (timestamp: string): string => formatServerLanguageHumanReadableDate(timestamp, language),
         [language],
     );
 
@@ -359,15 +358,3 @@ function hasAutoExecutePayload(
 ): boolean {
     return Boolean(message) || Boolean(attachments?.length);
 }
-
-/**
- * Formats one chat timestamp into relative text using the active server language.
- */
-function formatRelativeChatTimestamp(timestamp: string, language: ServerLanguageCode): string {
-    const parsed = createServerLanguageMoment(timestamp, language);
-    if (!parsed.isValid()) {
-        return timestamp;
-    }
-
-    return parsed.fromNow();
-}

package/apps/agents-server/src/app/agents/[agentName]/history/page.tsx

@@ -3,6 +3,8 @@ import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentColle
 import { formatAgentNamingText } from '@/src/utils/agentNaming';
 import { getCurrentUser } from '@/src/utils/getCurrentUser';
 import { getAgentNaming } from '@/src/utils/getAgentNaming';
+import { formatServerLanguageHumanReadableDate } from '@/src/utils/localization/formatServerLanguageHumanReadableDate';
+import { getRequestServerLanguage } from '@/src/utils/localization/getRequestServerLanguage';
 import { HistoryIcon } from 'lucide-react';
 import { RestoreVersionButton } from './RestoreVersionButton';
 import { enforceCanonicalLocalAgentId, getAgentName } from '../_utils';
@@ -39,6 +41,7 @@ export default async function AgentHistoryPage({ params }: { params: Promise<{ a
     const collection = await $provideAgentCollectionForServer();
     const history = await collection.listAgentHistory(agentName);
     const agentNaming = await getAgentNaming();
+    const language = await getRequestServerLanguage();
 
     return (
         <div className="container mx-auto p-6 max-w-4xl">
@@ -69,7 +72,9 @@ export default async function AgentHistoryPage({ params }: { params: Promise<{ a
                                 <div className="flex justify-between items-start mb-2">
                                     <div>
                                         <time className="block mb-1 text-sm font-normal leading-none text-gray-400">
-                                            {new Date(item.createdAt).toLocaleString()}
+                                            {formatServerLanguageHumanReadableDate(item.createdAt, language, {
+                                                isExactDateIncluded: true,
+                                            })}
                                         </time>
                                         <h3 className="text-lg font-semibold text-gray-900">
                                             {item.versionName || `Version ${history.length - index}`}

package/apps/agents-server/src/app/agents/[agentName]/integration/CalendarIntegrationSection.tsx

@@ -1,7 +1,10 @@
 'use client';
 
 import { showConfirm } from '@/src/components/AsyncDialogs/asyncDialogs';
+import { useServerLanguage } from '@/src/components/ServerLanguage/ServerLanguageProvider';
+import type { ServerLanguageCode } from '@/src/languages/ServerLanguageRegistry';
 import { buildCalendarOAuthConnectUrl } from '@/src/utils/calendarOAuthClient';
+import { formatServerLanguageHumanReadableDate } from '@/src/utils/localization/formatServerLanguageHumanReadableDate';
 import { Calendar, Link2, RefreshCw, Unlink } from 'lucide-react';
 import { useCallback, useEffect, useMemo, useState } from 'react';
 
@@ -71,6 +74,7 @@ type CalendarIntegrationSectionProps = {
  * Renders connected-calendar settings for one agent, including re-auth/disconnect and activity timeline.
  */
 export function CalendarIntegrationSection({ agentName, agentPermanentId }: CalendarIntegrationSectionProps) {
+    const { language } = useServerLanguage();
     const {
         activeConnections,
         disconnectConnection,
@@ -124,7 +128,7 @@ export function CalendarIntegrationSection({ agentName, agentPermanentId }: Cale
                         onDisconnect={(connection) => void disconnectConnection(connection)}
                     />
 
-                    <CalendarActivitySection activity={payload?.activity || []} />
+                    <CalendarActivitySection activity={payload?.activity || []} language={language} />
                 </>
             )}
         </div>
@@ -497,7 +501,13 @@ function CalendarConnectionCard({
 /**
  * Renders the recent calendar activity section.
  */
-function CalendarActivitySection({ activity }: { activity: ReadonlyArray<CalendarActivityItem> }) {
+function CalendarActivitySection({
+    activity,
+    language,
+}: {
+    activity: ReadonlyArray<CalendarActivityItem>;
+    language: ServerLanguageCode;
+}) {
     return (
         <div className="mt-6 space-y-3">
             <h3 className="text-sm font-semibold uppercase tracking-wide text-gray-700">Recent activity</h3>
@@ -506,7 +516,7 @@ function CalendarActivitySection({ activity }: { activity: ReadonlyArray<Calenda
             ) : (
                 <div className="space-y-2">
                     {activity.map((item) => (
-                        <CalendarActivityCard key={item.id} activity={item} />
+                        <CalendarActivityCard key={item.id} activity={item} language={language} />
                     ))}
                 </div>
             )}
@@ -517,7 +527,13 @@ function CalendarActivitySection({ activity }: { activity: ReadonlyArray<Calenda
 /**
  * Renders one recent calendar activity row.
  */
-function CalendarActivityCard({ activity }: { activity: CalendarActivityItem }) {
+function CalendarActivityCard({
+    activity,
+    language,
+}: {
+    activity: CalendarActivityItem;
+    language: ServerLanguageCode;
+}) {
     return (
         <div className="rounded-lg border border-blue-100 bg-white/90 px-3 py-2">
             <div className="flex flex-wrap items-center gap-2 text-xs">
@@ -529,7 +545,9 @@ function CalendarActivityCard({ activity }: { activity: CalendarActivityItem })
                 >
                     {activity.status}
                 </span>
-                <span className="text-gray-500">{new Date(activity.createdAt).toLocaleString()}</span>
+                <span className="text-gray-500">
+                    {formatServerLanguageHumanReadableDate(activity.createdAt, language)}
+                </span>
             </div>
             {activity.calendarUrl && (
                 <p className="mt-1 text-[11px] text-gray-600 break-all font-mono">{activity.calendarUrl}</p>

package/apps/agents-server/src/app/agents/[agentName]/timeouts/AgentTimeoutsClient.tsx

@@ -1,5 +1,6 @@
 'use client';
 
+import { useServerLanguage } from '@/src/components/ServerLanguage/ServerLanguageProvider';
 import { AgentTimeoutsEditDialog } from './AgentTimeoutsEditDialog';
 import { AgentTimeoutsFiltersCard } from './AgentTimeoutsFiltersCard';
 import { AgentTimeoutsHeader } from './AgentTimeoutsHeader';
@@ -20,13 +21,14 @@ type AgentTimeoutsClientProps = {
  * @private route component of AgentTimeoutsPage
  */
 export function AgentTimeoutsClient({ agentName }: AgentTimeoutsClientProps) {
+    const { language } = useServerLanguage();
     const state = useAgentTimeoutsClientState({ agentName });
 
     return (
         <div className="container mx-auto mt-20 space-y-6 px-4 py-8">
             <AgentTimeoutsHeader state={state} />
             <AgentTimeoutsSummaryMetrics state={state} />
-            <AgentTimeoutsFiltersCard state={state} />
+            <AgentTimeoutsFiltersCard language={language} state={state} />
 
             {state.errorMessage ? (
                 <div className="rounded-2xl border border-red-200 bg-red-50 p-4 text-sm text-red-700">
@@ -34,7 +36,7 @@ export function AgentTimeoutsClient({ agentName }: AgentTimeoutsClientProps) {
                 </div>
             ) : null}
 
-            <AgentTimeoutsTableCard agentName={agentName} state={state} />
+            <AgentTimeoutsTableCard agentName={agentName} language={language} state={state} />
             <AgentTimeoutsEditDialog state={state} />
         </div>
     );

package/apps/agents-server/src/app/agents/[agentName]/timeouts/AgentTimeoutsFiltersCard.tsx

@@ -1,3 +1,5 @@
+import type { ServerLanguageCode } from '@/src/languages/ServerLanguageRegistry';
+import { formatServerLanguageHumanReadableDate } from '@/src/utils/localization/formatServerLanguageHumanReadableDate';
 import type { useAgentTimeoutsClientState } from './useAgentTimeoutsClientState';
 
 /**
@@ -6,6 +8,7 @@ import type { useAgentTimeoutsClientState } from './useAgentTimeoutsClientState'
  * @private function of AgentTimeoutsClient
  */
 type AgentTimeoutsFiltersCardProps = {
+    language: ServerLanguageCode;
     state: ReturnType<typeof useAgentTimeoutsClientState>;
 };
 
@@ -36,8 +39,10 @@ const TIMEOUT_MANAGER_FILTER_OPTIONS: ReadonlyArray<TimeoutManagerFilterOption>
  *
  * @private function of AgentTimeoutsFiltersCard
  */
-function resolveLastRefreshedLabel(generatedAt: string | null): string {
-    return generatedAt ? `Last refreshed ${new Date(generatedAt).toLocaleString()}` : 'Waiting for first refresh...';
+function resolveLastRefreshedLabel(generatedAt: string | null, language: ServerLanguageCode): string {
+    return generatedAt
+        ? `Last refreshed ${formatServerLanguageHumanReadableDate(generatedAt, language)}`
+        : 'Waiting for first refresh...';
 }
 
 /**
@@ -45,7 +50,7 @@ function resolveLastRefreshedLabel(generatedAt: string | null): string {
  *
  * @private function of AgentTimeoutsClient
  */
-export function AgentTimeoutsFiltersCard({ state }: AgentTimeoutsFiltersCardProps) {
+export function AgentTimeoutsFiltersCard({ language, state }: AgentTimeoutsFiltersCardProps) {
     return (
         <div className="rounded-2xl border border-gray-200 bg-white p-4 shadow-sm">
             <div className="flex flex-wrap gap-2">
@@ -64,7 +69,7 @@ export function AgentTimeoutsFiltersCard({ state }: AgentTimeoutsFiltersCardProp
                     </button>
                 ))}
             </div>
-            <div className="mt-3 text-xs text-gray-500">{resolveLastRefreshedLabel(state.generatedAt)}</div>
+            <div className="mt-3 text-xs text-gray-500">{resolveLastRefreshedLabel(state.generatedAt, language)}</div>
         </div>
     );
 }

package/apps/agents-server/src/app/agents/[agentName]/timeouts/AgentTimeoutsTableCard.tsx

@@ -1,3 +1,4 @@
+import type { ServerLanguageCode } from '@/src/languages/ServerLanguageRegistry';
 import type { useAgentTimeoutsClientState } from './useAgentTimeoutsClientState';
 import { AgentTimeoutsTableRow } from './AgentTimeoutsTableRow';
 
@@ -8,6 +9,7 @@ import { AgentTimeoutsTableRow } from './AgentTimeoutsTableRow';
  */
 type AgentTimeoutsTableCardProps = {
     agentName: string;
+    language: ServerLanguageCode;
     state: ReturnType<typeof useAgentTimeoutsClientState>;
 };
 
@@ -16,7 +18,7 @@ type AgentTimeoutsTableCardProps = {
  *
  * @private function of AgentTimeoutsClient
  */
-export function AgentTimeoutsTableCard({ agentName, state }: AgentTimeoutsTableCardProps) {
+export function AgentTimeoutsTableCard({ agentName, language, state }: AgentTimeoutsTableCardProps) {
     return (
         <div className="rounded-2xl border border-gray-200 bg-white shadow-sm">
             {state.isLoading ? (
@@ -42,6 +44,7 @@ export function AgentTimeoutsTableCard({ agentName, state }: AgentTimeoutsTableC
                                 <AgentTimeoutsTableRow
                                     key={timeout.timeoutId}
                                     agentName={agentName}
+                                    language={language}
                                     state={state}
                                     timeout={timeout}
                                 />

package/apps/agents-server/src/app/agents/[agentName]/timeouts/AgentTimeoutsTableRow.tsx

@@ -1,4 +1,6 @@
 import type { UserChatTimeout } from '@/src/utils/userChatClient';
+import type { ServerLanguageCode } from '@/src/languages/ServerLanguageRegistry';
+import { formatServerLanguageHumanReadableDate } from '@/src/utils/localization/formatServerLanguageHumanReadableDate';
 import Link from 'next/link';
 import type { useAgentTimeoutsClientState } from './useAgentTimeoutsClientState';
 
@@ -9,6 +11,7 @@ import type { useAgentTimeoutsClientState } from './useAgentTimeoutsClientState'
  */
 type AgentTimeoutsTableRowProps = {
     agentName: string;
+    language: ServerLanguageCode;
     state: ReturnType<typeof useAgentTimeoutsClientState>;
     timeout: UserChatTimeout;
 };
@@ -141,7 +144,7 @@ function truncateText(value: string, maxLength: number): string {
  *
  * @private function of AgentTimeoutsClient
  */
-export function AgentTimeoutsTableRow({ agentName, state, timeout }: AgentTimeoutsTableRowProps) {
+export function AgentTimeoutsTableRow({ agentName, language, state, timeout }: AgentTimeoutsTableRowProps) {
     const isBusy = state.busyTimeoutId === timeout.timeoutId;
     const isPaused = isTimeoutPaused(timeout);
     const isEditable = isTimeoutEditable(timeout);
@@ -152,7 +155,9 @@ export function AgentTimeoutsTableRow({ agentName, state, timeout }: AgentTimeou
         <tr>
             <td className="px-4 py-3 align-top">
                 <div className="font-mono text-[11px] font-semibold text-gray-900">{timeout.timeoutId}</div>
-                <div className="mt-1 text-[11px] text-gray-500">Updated {new Date(timeout.updatedAt).toLocaleString()}</div>
+                <div className="mt-1 text-[11px] text-gray-500">
+                    Updated {formatServerLanguageHumanReadableDate(timeout.updatedAt, language)}
+                </div>
             </td>
             <td className="px-4 py-3 align-top">
                 <Link
@@ -167,7 +172,9 @@ export function AgentTimeoutsTableRow({ agentName, state, timeout }: AgentTimeou
                     {statusPresentation.label}
                 </span>
             </td>
-            <td className="px-4 py-3 align-top">{new Date(timeout.dueAt).toLocaleString()}</td>
+            <td className="px-4 py-3 align-top">
+                {formatServerLanguageHumanReadableDate(timeout.dueAt, language, { isExactDateIncluded: true })}
+            </td>
             <td className="px-4 py-3 align-top">
                 {timeout.recurrenceIntervalMs ? `Every ${formatDuration(timeout.recurrenceIntervalMs)}` : 'One-shot'}
             </td>

package/apps/agents-server/src/app/api/admin/update/commits/route.ts

@@ -0,0 +1,35 @@
+import { NextResponse } from 'next/server';
+import { isUserGlobalAdmin } from '@/src/utils/isUserGlobalAdmin';
+import { listVpsSelfUpdateCandidateCommits } from '@/src/utils/vpsSelfUpdate';
+
+export const runtime = 'nodejs';
+export const dynamic = 'force-dynamic';
+
+/**
+ * Lists candidate commits for the standalone VPS self-update custom-target picker.
+ */
+export async function GET(request: Request) {
+    if (!(await isUserGlobalAdmin())) {
+        return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+    }
+
+    try {
+        const requestUrl = new URL(request.url);
+        const limitParameter = requestUrl.searchParams.get('limit');
+        const parsedLimit = limitParameter ? Number.parseInt(limitParameter, 10) : null;
+
+        const commits = await listVpsSelfUpdateCandidateCommits({
+            searchText: requestUrl.searchParams.get('search'),
+            authoredAfter: requestUrl.searchParams.get('after'),
+            authoredBefore: requestUrl.searchParams.get('before'),
+            limit: Number.isFinite(parsedLimit) ? parsedLimit : null,
+        });
+
+        return NextResponse.json({ commits });
+    } catch (error) {
+        return NextResponse.json(
+            { error: error instanceof Error ? error.message : 'Failed to load candidate commits.' },
+            { status: 500 },
+        );
+    }
+}

package/apps/agents-server/src/app/api/admin/update/route.ts

@@ -24,7 +24,7 @@ export async function GET() {
 }
 
 /**
- * Starts a detached standalone VPS self-update for the selected environment.
+ * Starts a detached standalone VPS self-update for the selected environment or arbitrary ref.
  */
 export async function POST(request: Request) {
     if (!(await isUserGlobalAdmin())) {
@@ -35,6 +35,8 @@ export async function POST(request: Request) {
         const body = (await request.json().catch(() => null)) as
             | {
                   readonly environment?: string;
+                  readonly customRef?: string | null;
+                  readonly originRepositoryUrl?: string | null;
               }
             | null;
 
@@ -42,7 +44,13 @@ export async function POST(request: Request) {
             return NextResponse.json({ error: 'Update environment is required.' }, { status: 400 });
         }
 
-        return NextResponse.json(await startVpsSelfUpdate(body.environment), { status: 202 });
+        const overview = await startVpsSelfUpdate({
+            environmentId: body.environment,
+            customRef: body.customRef ?? null,
+            originRepositoryUrl: body.originRepositoryUrl ?? null,
+        });
+
+        return NextResponse.json(overview, { status: 202 });
     } catch (error) {
         return NextResponse.json(
             { error: error instanceof Error ? error.message : 'Failed to start the update.' },