@promptbook/cli 0.112.0-99 → 0.113.0-0

package/apps/agents-server/src/app/agents/[agentName]/api/user-chats/[chatId]/stream/route.ts

@@ -1,7 +1,13 @@
 import { CHAT_STREAM_KEEP_ALIVE_INTERVAL_MS } from '@/src/constants/streaming';
 import { isPrivateModeEnabledFromRequest } from '@/src/utils/privateMode';
-import { createUserChatDetailPayload, getUserChat, isFrozenUserChatSource } from '@/src/utils/userChat';
-import type { ChatMessage } from '@promptbook-local/types';
+import {
+    createUserChatDetailPayload,
+    getUserChat,
+    isFrozenUserChatSource,
+    listUserChatJobs,
+} from '@/src/utils/userChat';
+import { hasPotentiallyPendingAssistantMessages } from '@/src/utils/userChat/hasPotentiallyPendingAssistantMessages';
+import { listUserChatTimeouts } from '@/src/utils/userChatTimeout/userChatTimeoutStore';
 import { NextResponse } from 'next/server';
 import { resolveUserChatScope } from '../../resolveUserChatScope';
 
@@ -136,17 +142,17 @@ export async function GET(request: Request, { params }: { params: Promise<{ agen
                     return false;
                 }
 
-                const payload = await createUserChatDetailPayload(currentChat);
-                const nextSignature = createUserChatDetailSignature(payload);
+                const livePollState = await loadLiveUserChatPollingState(currentChat);
 
-                if (nextSignature !== lastSnapshotSignature) {
-                    lastSnapshotSignature = nextSignature;
+                if (livePollState.signature !== lastSnapshotSignature) {
+                    const payload = await createUserChatDetailPayload(currentChat);
+                    lastSnapshotSignature = createUserChatPollingSignatureFromDetailPayload(payload);
                     if (!enqueueFrame({ type: 'snapshot', payload })) {
                         return false;
                     }
                 }
 
-                return !isFrozenUserChatSource(payload.chat.source) && payload.activeJobs.length > 0;
+                return !isFrozenUserChatSource(currentChat.source) && livePollState.hasActiveJobs;
             };
 
             /**
@@ -211,69 +217,92 @@ export async function GET(request: Request, { params }: { params: Promise<{ agen
 }
 
 /**
- * Builds a stable signature for the user-visible parts of a canonical chat snapshot.
+ * Minimal live poll state used to avoid rebuilding the full chat payload when nothing visible changed.
  */
-function createUserChatDetailSignature(payload: Awaited<ReturnType<typeof createUserChatDetailPayload>>): string {
-    return JSON.stringify({
-        chatId: payload.chat.id,
-        updatedAt: payload.chat.updatedAt,
-        draftMessage: payload.draftMessage || '',
-        messages: payload.messages.map(createUserChatMessageSignature),
-        activeJobs: payload.activeJobs.map((job) => ({
-            id: job.id,
-            status: job.status,
-            cancelRequestedAt: job.cancelRequestedAt,
-        })),
-        activeTimeouts: payload.activeTimeouts.map((timeout) => ({
-            id: timeout.id,
-            status: timeout.status,
-            dueAt: timeout.dueAt,
-            cancelRequestedAt: timeout.cancelRequestedAt,
-        })),
-    });
-}
+type LiveUserChatPollState = {
+    signature: string;
+    hasActiveJobs: boolean;
+};
 
 /**
- * Builds one compact stable signature for a user-visible chat message.
+ * Loads the lightweight state needed to decide whether the active chat payload changed.
+ *
+ * The expensive detail payload does job reconciliation, local-runner synchronization, and full
+ * transcript serialization. Polling first with the persisted timestamps + active resource state
+ * keeps long-lived chat streams cheap when the conversation is idle.
+ *
+ * @param chat - Current scoped chat record.
+ * @returns Poll signature plus whether the chat should keep using the active-job cadence.
  */
-function createUserChatMessageSignature(
-    message: Awaited<ReturnType<typeof createUserChatDetailPayload>>['messages'][number],
-): Record<string, unknown> {
+async function loadLiveUserChatPollingState(chat: NonNullable<Awaited<ReturnType<typeof getUserChat>>>): Promise<LiveUserChatPollState> {
+    const shouldInspectActiveJobs = hasPotentiallyPendingAssistantMessages(chat.messages);
+    const [activeJobs, activeTimeouts] = await Promise.all([
+        shouldInspectActiveJobs
+            ? listUserChatJobs({
+                  userId: chat.userId,
+                  agentPermanentId: chat.agentPermanentId,
+                  chatId: chat.id,
+                  onlyActive: true,
+              })
+            : Promise.resolve([]),
+        listUserChatTimeouts({
+            userId: chat.userId,
+            agentPermanentId: chat.agentPermanentId,
+            chatId: chat.id,
+            onlyActive: true,
+        }),
+    ]);
+
     return {
-        id: message.id ?? null,
-        sender: message.sender,
-        isComplete: message.isComplete,
-        lifecycleState: message.lifecycleState ?? null,
-        lifecycleError: message.lifecycleError ?? null,
-        contentLength: message.content.length,
-        contentHash: createStableTextDigest(message.content),
-        replyingTo: message.replyingTo ? JSON.stringify(message.replyingTo) : null,
-        progressCard: message.progressCard ? JSON.stringify(message.progressCard) : null,
-        ongoingToolCalls: createToolCallsSignature(message.ongoingToolCalls),
-        completedToolCalls: createToolCallsSignature(message.completedToolCalls),
-        toolCalls: createToolCallsSignature(message.toolCalls),
+        signature: createUserChatPollingSignature({
+            chatUpdatedAt: chat.updatedAt,
+            draftMessage: chat.draftMessage,
+            activeJobs,
+            activeTimeouts,
+        }),
+        hasActiveJobs: activeJobs.length > 0,
     };
 }
 
 /**
- * Creates one compact stable digest for message text without pulling in heavier hashing helpers.
+ * Builds the polling signature for a fully hydrated detail payload.
  */
-function createStableTextDigest(value: string): string {
-    let hash = 2_166_136_261;
-
-    for (let index = 0; index < value.length; index++) {
-        hash ^= value.charCodeAt(index);
-        hash = Math.imul(hash, 16_777_619);
-    }
-
-    return (hash >>> 0).toString(16);
+function createUserChatPollingSignatureFromDetailPayload(
+    payload: Awaited<ReturnType<typeof createUserChatDetailPayload>>,
+): string {
+    return createUserChatPollingSignature({
+        chatUpdatedAt: payload.chat.updatedAt,
+        draftMessage: payload.draftMessage,
+        activeJobs: payload.activeJobs,
+        activeTimeouts: payload.activeTimeouts,
+    });
 }
 
 /**
- * Serializes optional tool-call arrays for snapshot signature comparisons.
+ * Builds a stable signature for the user-visible state that changes stream snapshots.
  */
-function createToolCallsSignature(toolCalls: ChatMessage['toolCalls']): string | null {
-    return toolCalls && toolCalls.length > 0 ? JSON.stringify(toolCalls) : null;
+function createUserChatPollingSignature(options: {
+    chatUpdatedAt: string;
+    draftMessage: string | null;
+    activeJobs: ReadonlyArray<Awaited<ReturnType<typeof createUserChatDetailPayload>>['activeJobs'][number]>;
+    activeTimeouts: ReadonlyArray<Awaited<ReturnType<typeof createUserChatDetailPayload>>['activeTimeouts'][number]>;
+}): string {
+    return JSON.stringify({
+        updatedAt: options.chatUpdatedAt,
+        draftMessage: options.draftMessage || '',
+        activeJobs: options.activeJobs.map((job) => ({
+            id: job.id,
+            status: job.status,
+            cancelRequestedAt: job.cancelRequestedAt,
+        })),
+        activeTimeouts: options.activeTimeouts.map((timeout) => ({
+            id: timeout.id,
+            status: timeout.status,
+            dueAt: timeout.dueAt,
+            cancelRequestedAt: timeout.cancelRequestedAt,
+            pausedAt: timeout.pausedAt,
+        })),
+    });
 }
 
 /**

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

@@ -3,6 +3,8 @@
 import { BookEditor } from '@promptbook-local/components';
 import type { string_book } from '@promptbook-local/types';
 import { bookEditorUploadHandler } from '../../../../utils/upload/createBookEditorUploadHandler';
+import { FileUploadUnavailableNotice } from '../../../../components/FileUploadAvailability/FileUploadUnavailableNotice';
+import { useFileUploadAvailability } from '../../../../components/FileUploadAvailability/FileUploadAvailabilityContext';
 import { SaveFailureNotice } from '../../../../components/SaveFailureNotice/SaveFailureNotice';
 import { usePromptbookTheme } from '../../../../components/ThemeMode/usePromptbookTheme';
 import { BookEditorHistoryPanel } from './BookEditorHistoryPanel';
@@ -24,6 +26,7 @@ type BookEditorWrapperProps = {
  */
 export function BookEditorWrapper({ agentName, initialAgentSource }: BookEditorWrapperProps) {
     const { promptbookTheme } = usePromptbookTheme();
+    const fileUploadAvailability = useFileUploadAvailability();
     const {
         agentSource,
         monacoModelPath,
@@ -48,6 +51,7 @@ export function BookEditorWrapper({ agentName, initialAgentSource }: BookEditorW
                     onRetry={retrySaveNow}
                 />
             )}
+            {!fileUploadAvailability.isUploadAvailable && <FileUploadUnavailableNotice className="mb-3" />}
 
             <div className="flex min-h-0 flex-1 gap-4">
                 <div className="flex min-h-0 min-w-0 flex-1 gap-6">
@@ -59,7 +63,9 @@ export function BookEditorWrapper({ agentName, initialAgentSource }: BookEditorW
                             value={agentSource}
                             monacoModelPath={monacoModelPath}
                             onChange={handleChange}
-                            onFileUpload={bookEditorUploadHandler}
+                            onFileUpload={
+                                fileUploadAvailability.isUploadAvailable ? bookEditorUploadHandler : undefined
+                            }
                             diagnostics={diagnostics}
                             hoistedMenuItems={hoistedMenuItems}
                             theme={promptbookTheme}

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/AgentChatHistoryPayloadState.ts

@@ -34,6 +34,7 @@ export const AgentChatHistoryPayloadState = {
     applySnapshotStateUpdate,
     clearActiveChatRuntimeState,
     replaceChatInList,
+    sortUserChatSummariesByTimeDescending,
 };
 
 /**
@@ -175,7 +176,7 @@ function applySnapshotStateUpdate(params: {
     } = params;
 
     const reason = options.reason || 'snapshot-update';
-    setChats(snapshot.chats);
+    setChats(sortUserChatSummariesByTimeDescending(snapshot.chats));
     if (!snapshot.activeChatId) {
         if (options.allowSelectionAdoption !== true) {
             logChatSelection('selection_skip_snapshot_missing_active_chat', {
@@ -616,11 +617,44 @@ function applyResolvedChatPayload(params: {
 }
 
 /**
- * Moves one chat summary to the top of the sidebar list.
+ * Inserts or updates one chat summary in the sidebar list while keeping the list ordered
+ * by latest activity time (newest first), so the currently selected chat stays in its
+ * chronological position instead of being hoisted to the top.
  *
  * @private function of useAgentChatHistoryClientState
  */
 function replaceChatInList(chats: ReadonlyArray<UserChatSummary>, targetChat: UserChatSummary): Array<UserChatSummary> {
-    const remainingChats = chats.filter((chat) => chat.id !== targetChat.id);
-    return [targetChat, ...remainingChats];
+    const hasExistingEntry = chats.some((chat) => chat.id === targetChat.id);
+    const updatedChats = hasExistingEntry
+        ? chats.map((chat) => (chat.id === targetChat.id ? targetChat : chat))
+        : [...chats, targetChat];
+    return sortUserChatSummariesByTimeDescending(updatedChats);
+}
+
+/**
+ * Resolves the timestamp used to order one chat summary in the sidebar tray.
+ *
+ * Prefers the latest message timestamp, falls back to the chat's last update time, and finally
+ * to its creation time. This mirrors the timestamp displayed next to each chat row.
+ *
+ * @private function of useAgentChatHistoryClientState
+ */
+function resolveUserChatSummaryOrderTime(chat: UserChatSummary): number {
+    const timestamp = chat.lastMessageAt || chat.updatedAt || chat.createdAt;
+    const parsedTime = new Date(timestamp).getTime();
+    return Number.isFinite(parsedTime) ? parsedTime : 0;
+}
+
+/**
+ * Returns one new array of chat summaries sorted by latest activity time, newest first.
+ *
+ * @private function of useAgentChatHistoryClientState
+ */
+function sortUserChatSummariesByTimeDescending(
+    chats: ReadonlyArray<UserChatSummary>,
+): Array<UserChatSummary> {
+    return [...chats].sort(
+        (leftChat, rightChat) =>
+            resolveUserChatSummaryOrderTime(rightChat) - resolveUserChatSummaryOrderTime(leftChat),
+    );
 }

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

@@ -90,7 +90,10 @@ async function createBootstrapChatFromSnapshot(params: {
                   currentInitialOptimisticChatBootstrap.optimisticChatId,
                   createdChat.chat,
               )
-            : [createdChat.chat, ...snapshot.chats.filter((chat) => chat.id !== createdChat.chat.id)],
+            : AgentChatHistoryPayloadState.sortUserChatSummariesByTimeDescending([
+                  createdChat.chat,
+                  ...snapshot.chats.filter((chat) => chat.id !== createdChat.chat.id),
+              ]),
     );
 }
 

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

@@ -24,11 +24,11 @@ export function AgentChatPageLayout({
     children,
 }: AgentChatPageLayoutProps) {
     if (isHeadlessMode) {
-        return <div className="flex h-full min-h-0 w-full overflow-hidden bg-slate-50/80">{children}</div>;
+        return <div className="flex h-full min-h-0 w-full overflow-hidden bg-slate-50/80 dark:bg-slate-950">{children}</div>;
     }
 
     return (
-        <div className="flex h-full min-h-0 w-full overflow-hidden bg-slate-50/80">
+        <div className="flex h-full min-h-0 w-full overflow-hidden bg-slate-50/80 dark:bg-slate-950">
             {sidebar}
             <section className="flex min-h-0 min-w-0 flex-1 flex-col overflow-hidden">{children}</section>
         </div>

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

@@ -168,10 +168,7 @@ function resolveAgentChatSidebarExpandedStatusClassName(activityKind: AgentChatS
  *
  * @private function of AgentChatSidebar
  */
-function AgentChatSidebarDefaultCollapsedRow({
-    item,
-    onChatSelect,
-}: AgentChatSidebarDefaultCollapsedRowProps) {
+function AgentChatSidebarDefaultCollapsedRow({ item, onChatSelect }: AgentChatSidebarDefaultCollapsedRowProps) {
     const statusClassName = resolveAgentChatSidebarCollapsedStatusClassName(
         item.content.activityIndicator.kind,
         item.isActive,
@@ -183,7 +180,7 @@ function AgentChatSidebarDefaultCollapsedRow({
             onClick={() => onChatSelect(item.id)}
             className={`group relative flex w-full min-w-0 flex-col items-center gap-1 rounded-2xl border px-1.5 py-2 transition focus-visible:outline focus-visible:outline-blue-400 focus-visible:outline-offset-2 ${
                 item.isActive
-                    ? 'border-blue-300 bg-blue-50 text-blue-700 shadow-sm dark:border-blue-500/40 dark:bg-blue-500/12 dark:text-blue-100'
+                    ? 'agent-chat-sidebar-item-active border-blue-300 bg-blue-50 text-blue-700 shadow-sm dark:border-blue-500/40 dark:bg-blue-500/12 dark:text-blue-100'
                     : 'border-transparent bg-slate-100/80 text-slate-700 hover:border-slate-300 hover:bg-slate-100 dark:bg-slate-900/88 dark:text-slate-300 dark:hover:border-slate-700 dark:hover:bg-slate-900'
             } ${item.isEmpty && !item.isActive ? 'opacity-40' : ''}`}
             aria-label={item.content.accessibilityLabel}
@@ -206,14 +203,16 @@ function AgentChatSidebarDefaultCollapsedRow({
                 {item.content.messagesCount}
             </span>
             <div
-                className={`aspect-square w-full overflow-hidden rounded-xl border px-1.5 py-1.5 text-left ${
+                className={`agent-chat-sidebar-item-preview-card aspect-square w-full overflow-hidden rounded-xl border px-1.5 py-1.5 text-left ${
                     item.isActive
                         ? 'border-blue-300 bg-white/90 text-blue-700 dark:border-blue-500/40 dark:bg-slate-950/82 dark:text-blue-100'
                         : 'border-slate-200 bg-white/90 text-slate-600 dark:border-slate-700 dark:bg-slate-950/78 dark:text-slate-300'
                 }`}
             >
-                <div className="max-w-full truncate text-[10px] font-semibold leading-none">{item.content.title}</div>
-                <div className="mt-1 max-w-full truncate text-[9px] leading-tight text-slate-500 dark:text-slate-400">
+                <div className="agent-chat-sidebar-item-title max-w-full truncate text-[10px] font-semibold leading-none">
+                    {item.content.title}
+                </div>
+                <div className="agent-chat-sidebar-item-preview mt-1 max-w-full truncate text-[9px] leading-tight text-slate-500 dark:text-slate-400">
                     {item.content.preview}
                 </div>
             </div>
@@ -241,7 +240,7 @@ function AgentChatSidebarDefaultExpandedRow({
         <div
             className={`group relative rounded-xl border ${
                 item.isActive
-                    ? 'border-blue-300 bg-blue-50 shadow-sm dark:border-blue-500/40 dark:bg-blue-500/12'
+                    ? 'agent-chat-sidebar-item-active border-blue-300 bg-blue-50 shadow-sm dark:border-blue-500/40 dark:bg-blue-500/12'
                     : 'border-transparent hover:border-slate-200 hover:bg-slate-100/80 dark:hover:border-slate-700 dark:hover:bg-slate-900/88'
             } ${item.isEmpty && !item.isActive ? 'opacity-40' : ''}`}
         >
@@ -256,7 +255,7 @@ function AgentChatSidebarDefaultExpandedRow({
                 title={item.content.accessibilityLabel}
             >
                 <div className="flex items-center gap-2">
-                    <div className="min-w-0 flex-1 truncate text-sm font-medium text-slate-800 dark:text-slate-100">
+                    <div className="agent-chat-sidebar-item-title min-w-0 flex-1 truncate text-sm font-medium text-slate-800 dark:text-slate-100">
                         {item.content.title}
                     </div>
                     {item.content.sourceChipLabel && (
@@ -265,7 +264,9 @@ function AgentChatSidebarDefaultExpandedRow({
                         </span>
                     )}
                 </div>
-                <div className="mt-1 truncate text-xs text-slate-500 dark:text-slate-400">{item.content.preview}</div>
+                <div className="agent-chat-sidebar-item-preview mt-1 truncate text-xs text-slate-500 dark:text-slate-400">
+                    {item.content.preview}
+                </div>
                 <div className="mt-2 flex items-center justify-between gap-2">
                     <div className={`truncate text-[11px] ${statusClassName}`}>
                         {item.content.activityIndicator.compactLabel || item.content.lastActivity}
@@ -440,7 +441,9 @@ function AgentChatSidebarDefaultCollapsedSection({
             ) : (
                 <div className="flex min-h-0 w-full flex-1 flex-col gap-2 overflow-y-auto scrollbar-hidden">
                     {sidebarItems.length === 0 ? (
-                        <p className="px-1 text-center text-[11px] text-slate-500 dark:text-slate-400">{emptyStateText}</p>
+                        <p className="px-1 text-center text-[11px] text-slate-500 dark:text-slate-400">
+                            {emptyStateText}
+                        </p>
                     ) : (
                         sidebarItems.map((item) => (
                             <AgentChatSidebarDefaultCollapsedRow
@@ -596,7 +599,10 @@ export function AgentChatSidebarDefault({
                     </div>
                 </div>
 
-                <div className="agent-chat-sidebar-toggle-slot pointer-events-none absolute inset-y-0 right-0 z-10 hidden translate-x-1/2 items-center justify-center md:flex">
+                <div
+                    className="agent-chat-sidebar-toggle-slot pointer-events-none absolute inset-y-0 right-0 z-10 hidden items-center justify-center md:flex"
+                    style={{ transform: 'translateX(100%)' }}
+                >
                     <SolidArrowButton
                         direction={isCollapsed ? 'right' : 'left'}
                         onClick={onToggleCollapse}

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

@@ -8,13 +8,16 @@ import { useAgentBackground } from '../../../../components/AgentProfile/useAgent
 import { useChatEnterBehaviorPreferences } from '../../../../components/ChatEnterBehavior/ChatEnterBehaviorPreferencesProvider';
 import { notifyError } from '../../../../components/Notifications/notifications';
 import { useChatVisualMode } from '../../../../components/ChatVisualMode/ChatVisualModeProvider';
+import { FileUploadUnavailableNotice } from '../../../../components/FileUploadAvailability/FileUploadUnavailableNotice';
+import { useFileUploadAvailability } from '../../../../components/FileUploadAvailability/FileUploadAvailabilityContext';
 import { useServerLanguage } from '../../../../components/ServerLanguage/ServerLanguageProvider';
 import { ChatThreadLoadingSkeleton } from '../../../../components/Skeleton/ChatThreadLoadingSkeleton';
 import { useSoundSystem } from '../../../../components/SoundSystemProvider/SoundSystemProvider';
 import { usePromptbookTheme } from '../../../../components/ThemeMode/usePromptbookTheme';
 import { createDefaultChatEffects } from '../../../../utils/chat/createDefaultChatEffects';
-import { downloadChatPdfFromServer } from '../../../../utils/chatExport/downloadChatPdfFromServer';
 import { executeQuickActionButton } from '../../../../utils/chat/executeQuickActionButton';
+import { resolveAgentsServerCitationLabel } from '../../../../utils/chat/resolveAgentsServerCitationLabel';
+import { downloadChatPdfFromServer } from '../../../../utils/chatExport/downloadChatPdfFromServer';
 import {
     isChatFeedbackEnabled,
     toChatComponentFeedbackMode,
@@ -125,6 +128,7 @@ export function CanonicalAgentChatSurface({
                 agentAvatarSrc: state.agentAvatarSrc,
                 agentAvatarVisualId: state.agentAvatarVisualId,
                 agentDisplayName: state.agentDisplayName,
+                agentKnowledgeSources: state.agentKnowledgeSources,
                 brandColorHex,
             }),
         [
@@ -133,6 +137,7 @@ export function CanonicalAgentChatSurface({
             state.agentAvatarSrc,
             state.agentAvatarVisualId,
             state.agentDisplayName,
+            state.agentKnowledgeSources,
         ],
     );
     const { language, t: translateText } = useServerLanguage();
@@ -145,6 +150,7 @@ export function CanonicalAgentChatSurface({
     const cancellableJob = useMemo(() => resolveCancellableJob(activeJobs), [activeJobs]);
     const { chatVisualMode } = useChatVisualMode();
     const { enterBehavior, resolveEnterBehavior } = useChatEnterBehaviorPreferences();
+    const fileUploadAvailability = useFileUploadAvailability();
     const { soundSystem } = useSoundSystem();
     const { promptbookTheme } = usePromptbookTheme();
     const effectConfigs = useMemo(() => createDefaultChatEffects(), []);
@@ -178,20 +184,17 @@ export function CanonicalAgentChatSurface({
             </button>
         );
     }, [cancellableJob, isReadOnly, onCancelActiveJob, translateText]);
-    const handlePdfSaveFormat = useCallback(
-        async ({ title, messages, participants }: ChatSaveFormatHandlerOptions) => {
-            try {
-                await downloadChatPdfFromServer({
-                    title,
-                    messages,
-                    participants,
-                });
-            } catch (error) {
-                notifyError(error instanceof Error ? error.message : 'Failed to export chat as PDF.');
-            }
-        },
-        [],
-    );
+    const handlePdfSaveFormat = useCallback(async ({ title, messages, participants }: ChatSaveFormatHandlerOptions) => {
+        try {
+            await downloadChatPdfFromServer({
+                title,
+                messages,
+                participants,
+            });
+        } catch (error) {
+            notifyError(error instanceof Error ? error.message : 'Failed to export chat as PDF.');
+        }
+    }, []);
     const saveFormatHandlers = useMemo(
         () => ({
             pdf: handlePdfSaveFormat,
@@ -240,7 +243,11 @@ export function CanonicalAgentChatSurface({
             newChatButtonHref={isReadOnly ? undefined : newChatButtonHref}
             feedbackMode={toChatComponentFeedbackMode(feedbackMode)}
             onFeedback={!isReadOnly && feedbackEnabled ? state.onFeedback : undefined}
-            onFileUpload={!isReadOnly && areFileAttachmentsEnabled ? handleFileUpload : undefined}
+            onFileUpload={
+                !isReadOnly && areFileAttachmentsEnabled && fileUploadAvailability.isUploadAvailable
+                    ? handleFileUpload
+                    : undefined
+            }
             participants={participants}
             chatLocale={language}
             timingTranslations={translations.timingTranslations}
@@ -259,8 +266,12 @@ export function CanonicalAgentChatSurface({
             teamAgentProfiles={state.teamAgentProfiles}
             extraActions={extraActionNodes}
             saveFormatHandlers={saveFormatHandlers}
+            resolveCitationLabel={resolveAgentsServerCitationLabel}
             theme={promptbookTheme}
         >
+            {!isReadOnly && areFileAttachmentsEnabled && !fileUploadAvailability.isUploadAvailable && (
+                <FileUploadUnavailableNotice className="mx-4 mt-4" />
+            )}
             {isReadOnly && frozenChatBannerLabel && (
                 <div className="mx-4 mt-4 rounded-2xl border border-amber-200 bg-amber-50/95 px-4 py-3 text-sm font-medium text-amber-900 shadow-sm dark:border-amber-500/30 dark:bg-amber-500/10 dark:text-amber-100">
                     {translateText('chat.frozenBannerLabel', { source: frozenChatBannerLabel })}
@@ -312,12 +323,14 @@ function createCanonicalAgentChatParticipants({
     agentAvatarDefinition,
     agentAvatarSrc,
     agentAvatarVisualId,
+    agentKnowledgeSources,
     brandColorHex,
 }: {
     agentDisplayName: string;
     agentAvatarDefinition: CanonicalAgentChatPanelState['surface']['agentAvatarDefinition'];
     agentAvatarSrc: CanonicalAgentChatPanelState['surface']['agentAvatarSrc'];
     agentAvatarVisualId: CanonicalAgentChatPanelState['surface']['agentAvatarVisualId'];
+    agentKnowledgeSources: CanonicalAgentChatPanelState['surface']['agentKnowledgeSources'];
     brandColorHex: string;
 }): ReadonlyArray<ChatParticipant> {
     return [
@@ -329,6 +342,7 @@ function createCanonicalAgentChatParticipants({
             avatarVisualId: agentAvatarVisualId || undefined,
             color: brandColorHex,
             isMe: false,
+            knowledgeSources: agentKnowledgeSources,
         },
         {
             name: 'USER',

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();
-}