@promptbook/cli 0.113.0-8 → 0.114.0-0

package/apps/agents-server/src/app/agents/[agentName]/book+chat/page.tsx

@@ -4,12 +4,12 @@ import { ForbiddenPage } from '@/src/components/ForbiddenPage/ForbiddenPage';
 import { loadChatConfiguration } from '@/src/utils/chatConfiguration';
 import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
 import { getCurrentUser } from '@/src/utils/getCurrentUser';
-import { getThinkingMessages } from '@/src/utils/thinkingMessages';
+import { getThinkingMessages, resolveThinkingMessages } from '@/src/utils/thinkingMessages';
 import { headers } from 'next/headers';
 import { resolveSpeechRecognitionLanguage } from '../../../../../../../src/utils/language/getBrowserPreferredSpeechRecognitionLanguage';
 import { $sideEffect } from '../../../../../../../src/utils/organization/$sideEffect';
 import { DeletedAgentBanner } from '../../../../components/DeletedAgentBanner';
-import { enforceCanonicalLocalAgentId, getAgentName, isAgentDeleted } from '../_utils';
+import { enforceCanonicalLocalAgentId, getAgentName, getAgentProfile, isAgentDeleted } from '../_utils';
 import { AgentBookAndChat } from './AgentBookAndChat';
 
 /**
@@ -44,13 +44,26 @@ export default async function AgentBookAndChatPage({ params }: { params: Promise
     }
 
     const collection = await $provideAgentCollectionForServer();
-    const agentSource = await collection.getAgentSource(agentName);
+    const agentSourcePromise = collection.getAgentSource(agentName);
+    const agentProfilePromise = getAgentProfile(agentName);
+    const serverThinkingMessagesPromise = getThinkingMessages();
     const agentUrl = `/agents/${encodeURIComponent(agentName)}`;
-    const thinkingMessages = await getThinkingMessages();
     const speechRecognitionLanguage = resolveSpeechRecognitionLanguage({
         acceptLanguageHeader: requestHeaders.get('accept-language'),
     });
-    const { chatFailMessage, isFileAttachmentsEnabled, feedbackMode } = await loadChatConfiguration();
+    const chatConfigurationPromise = loadChatConfiguration();
+    const [
+        agentSource,
+        agentProfile,
+        serverThinkingMessages,
+        { chatFailMessage, isFileAttachmentsEnabled, feedbackMode },
+    ] = await Promise.all([
+        agentSourcePromise,
+        agentProfilePromise,
+        serverThinkingMessagesPromise,
+        chatConfigurationPromise,
+    ]);
+    const thinkingMessages = resolveThinkingMessages(agentProfile.thinkingMessages, serverThinkingMessages);
 
     return (
         <div className={`agents-server-viewport-width h-[calc(100dvh-60px)] relative`}>

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

@@ -8,6 +8,7 @@ import { AgentChatWrapper } from '../AgentChatWrapper';
 import { AgentChatPageLayout } from './AgentChatPageLayout';
 import { AgentChatSidebar } from './AgentChatSidebar';
 import { CanonicalAgentChatPanel } from './CanonicalAgentChatPanel';
+import { ExternalUserChatAdminActions } from './ExternalUserChatAdminActions';
 import { type AgentChatHistoryClientProps, useAgentChatHistoryClientState } from './useAgentChatHistoryClientState';
 
 /**
@@ -34,6 +35,7 @@ type AgentChatHistoryPrivateModeViewProps = Pick<
     | 'speechRecognitionLanguage'
     | 'areFileAttachmentsEnabled'
     | 'feedbackMode'
+    | 'projectReferences'
 > & {
     formatText: (text: string) => string;
     autoExecuteMessage: string | undefined;
@@ -55,6 +57,7 @@ type AgentChatHistoryLoadingViewProps = {
 type AgentChatHistoryReadyViewProps = Pick<
     AgentChatHistoryClientProps,
     | 'agentName'
+    | 'agentTitle'
     | 'agentUrl'
     | 'brandColor'
     | 'inputPlaceholder'
@@ -64,6 +67,8 @@ type AgentChatHistoryReadyViewProps = Pick<
     | 'areFileAttachmentsEnabled'
     | 'feedbackMode'
     | 'isCurrentUserAdmin'
+    | 'isCurrentUserSuperAdmin'
+    | 'projectReferences'
 > & {
     isHeadlessMode: boolean;
     activeChatId: string;
@@ -109,6 +114,7 @@ type AgentChatHistoryReadyViewProps = Pick<
 export function AgentChatHistoryClient(props: AgentChatHistoryClientProps) {
     const {
         agentName,
+        agentTitle,
         agentUrl,
         brandColor,
         inputPlaceholder,
@@ -116,8 +122,10 @@ export function AgentChatHistoryClient(props: AgentChatHistoryClientProps) {
         speechRecognitionLanguage,
         initialAgentMessage,
         isCurrentUserAdmin,
+        isCurrentUserSuperAdmin = false,
         areFileAttachmentsEnabled,
         feedbackMode,
+        projectReferences = [],
         isHeadlessMode = false,
     } = props;
     const {
@@ -166,6 +174,7 @@ export function AgentChatHistoryClient(props: AgentChatHistoryClientProps) {
                 speechRecognitionLanguage={speechRecognitionLanguage}
                 areFileAttachmentsEnabled={areFileAttachmentsEnabled}
                 feedbackMode={feedbackMode}
+                projectReferences={projectReferences}
                 formatText={formatText}
                 autoExecuteMessage={effectiveInitialAutoExecuteMessage}
                 autoExecuteMessageAttachments={effectiveInitialAutoExecuteMessageAttachments}
@@ -181,6 +190,7 @@ export function AgentChatHistoryClient(props: AgentChatHistoryClientProps) {
     return (
         <AgentChatHistoryReadyView
             agentName={agentName}
+            agentTitle={agentTitle}
             agentUrl={agentUrl}
             brandColor={brandColor}
             inputPlaceholder={inputPlaceholder}
@@ -190,6 +200,8 @@ export function AgentChatHistoryClient(props: AgentChatHistoryClientProps) {
             areFileAttachmentsEnabled={areFileAttachmentsEnabled}
             feedbackMode={feedbackMode}
             isCurrentUserAdmin={isCurrentUserAdmin}
+            isCurrentUserSuperAdmin={isCurrentUserSuperAdmin}
+            projectReferences={projectReferences}
             isHeadlessMode={isHeadlessMode}
             activeChatId={activeChatId}
             chats={chats}
@@ -238,6 +250,7 @@ function AgentChatHistoryPrivateModeView(props: AgentChatHistoryPrivateModeViewP
         speechRecognitionLanguage,
         areFileAttachmentsEnabled,
         feedbackMode,
+        projectReferences = [],
         formatText,
         autoExecuteMessage,
         autoExecuteMessageAttachments,
@@ -260,6 +273,7 @@ function AgentChatHistoryPrivateModeView(props: AgentChatHistoryPrivateModeViewP
                     persistenceKey={`guest-chat-${encodeURIComponent(agentName)}`}
                     areFileAttachmentsEnabled={areFileAttachmentsEnabled}
                     feedbackMode={feedbackMode}
+                    projectReferences={projectReferences}
                     onAutoExecuteMessageConsumed={onAutoExecuteMessageConsumed}
                 />
             </div>
@@ -284,6 +298,7 @@ function AgentChatHistoryLoadingView(props: AgentChatHistoryLoadingViewProps) {
 function AgentChatHistoryReadyView(props: AgentChatHistoryReadyViewProps) {
     const {
         agentName,
+        agentTitle,
         agentUrl,
         brandColor,
         inputPlaceholder,
@@ -293,6 +308,8 @@ function AgentChatHistoryReadyView(props: AgentChatHistoryReadyViewProps) {
         areFileAttachmentsEnabled,
         feedbackMode,
         isCurrentUserAdmin,
+        isCurrentUserSuperAdmin,
+        projectReferences = [],
         isHeadlessMode,
         activeChatId,
         chats,
@@ -325,6 +342,16 @@ function AgentChatHistoryReadyView(props: AgentChatHistoryReadyViewProps) {
         onAutoExecuteMessagePending,
         onAutoExecuteMessageConsumed,
     } = props;
+    const isActiveExternalUserChat = activeChatSummary?.isExternalUserChat === true;
+    const externalUserChatAdminActions =
+        isCurrentUserSuperAdmin === true && isActiveExternalUserChat ? (
+            <ExternalUserChatAdminActions
+                agentName={agentName}
+                chatId={activeChatId}
+                chatTitle={activeChatSummary?.title || 'Recorded chat'}
+                messages={renderedActiveMessages}
+            />
+        ) : undefined;
     const chatSurface = (
         <div className="relative flex min-h-0 flex-1 overflow-hidden">
             {isActiveChatLoading ? (
@@ -335,6 +362,7 @@ function AgentChatHistoryReadyView(props: AgentChatHistoryReadyViewProps) {
                 <CanonicalAgentChatPanel
                     chatId={activeChatId}
                     agentName={agentName}
+                    agentTitle={agentTitle}
                     agentUrl={agentUrl}
                     brandColor={brandColor}
                     inputPlaceholder={inputPlaceholder}
@@ -343,6 +371,9 @@ function AgentChatHistoryReadyView(props: AgentChatHistoryReadyViewProps) {
                     initialAgentMessage={initialAgentMessage}
                     isReadOnly={isActiveChatReadOnly}
                     readOnlySource={activeChatSummary?.source}
+                    isExternalUserChat={isActiveExternalUserChat}
+                    readOnlyExtraActions={externalUserChatAdminActions}
+                    projectReferences={projectReferences}
                     messages={renderedActiveMessages}
                     draftMessage={isActiveChatReadOnly ? '' : activeChatDraftMessage}
                     autoExecuteMessage={autoExecuteMessage}
@@ -375,7 +406,7 @@ function AgentChatHistoryReadyView(props: AgentChatHistoryReadyViewProps) {
             onSelectChat={onSelectChat}
             onDeleteChat={onDeleteChat}
             newChatHref={newChatHref}
-            isAdmin={isCurrentUserAdmin}
+            isAdmin={isCurrentUserAdmin || isCurrentUserSuperAdmin === true}
             showExternalChats={shouldShowExternalChats}
             onShowExternalChatsChange={onShowExternalChatsChange}
             isCollapsed={isSidebarCollapsed}

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

@@ -3,6 +3,7 @@
 import { WalletRecordDialog } from '@/src/components/WalletRecordDialog/WalletRecordDialog';
 import type { ChatMessage } from '@promptbook-local/types';
 import { type ReactNode } from 'react';
+import type { AgentProjectItemInfo } from '../../../../components/AgentProjects/AgentProjectReferencesList';
 import { type ChatFeedbackMode } from '../../../../utils/chatFeedbackMode';
 import { type UserChatSource } from '../../../../utils/userChat/UserChatSource';
 import type { UserChatJob, UserChatTimeout } from '../../../../utils/userChatClient';
@@ -17,6 +18,7 @@ import { useCanonicalAgentChatPanelState } from './useCanonicalAgentChatPanelSta
 type CanonicalAgentChatPanelProps = {
     chatId: string;
     agentName: string;
+    agentTitle: string;
     agentUrl: string;
     brandColor?: string;
     inputPlaceholder: string | undefined;
@@ -25,6 +27,18 @@ type CanonicalAgentChatPanelProps = {
     initialAgentMessage?: string | null;
     isReadOnly?: boolean;
     readOnlySource?: UserChatSource;
+    /**
+     * True when the viewed chat belongs to a different user than the current viewer.
+     */
+    isExternalUserChat?: boolean;
+    /**
+     * Optional actions rendered inside the read-only banner (for example super-admin shortcuts).
+     */
+    readOnlyExtraActions?: ReactNode;
+    /**
+     * Compact project references shown in the chat surface.
+     */
+    projectReferences?: ReadonlyArray<AgentProjectItemInfo>;
     messages: ReadonlyArray<ChatMessage>;
     draftMessage?: string;
     autoExecuteMessage?: string;
@@ -64,6 +78,7 @@ export function CanonicalAgentChatPanel(props: CanonicalAgentChatPanelProps) {
     const {
         chatId,
         agentName,
+        agentTitle,
         agentUrl,
         brandColor,
         inputPlaceholder,
@@ -72,6 +87,9 @@ export function CanonicalAgentChatPanel(props: CanonicalAgentChatPanelProps) {
         initialAgentMessage,
         isReadOnly = false,
         readOnlySource,
+        isExternalUserChat = false,
+        readOnlyExtraActions,
+        projectReferences = [],
         messages,
         draftMessage,
         autoExecuteMessage,
@@ -95,6 +113,7 @@ export function CanonicalAgentChatPanel(props: CanonicalAgentChatPanelProps) {
     const panelState = useCanonicalAgentChatPanelState({
         chatId,
         agentName,
+        agentTitle,
         agentUrl,
         initialAgentMessage,
         isReadOnly,
@@ -111,6 +130,7 @@ export function CanonicalAgentChatPanel(props: CanonicalAgentChatPanelProps) {
     return (
         <>
             <CanonicalAgentChatSurface
+                agentName={agentName}
                 brandColor={brandColor}
                 inputPlaceholder={inputPlaceholder}
                 draftMessage={draftMessage}
@@ -121,6 +141,9 @@ export function CanonicalAgentChatPanel(props: CanonicalAgentChatPanelProps) {
                 currentTimestamp={currentTimestamp}
                 isReadOnly={isReadOnly}
                 readOnlySource={readOnlySource}
+                isExternalUserChat={isExternalUserChat}
+                readOnlyExtraActions={readOnlyExtraActions}
+                projectReferences={projectReferences}
                 onDraftMessageChange={onDraftMessageChange}
                 onStartNewChat={onStartNewChat}
                 newChatButtonHref={newChatButtonHref}

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

@@ -4,6 +4,7 @@ import { Chat } from '@promptbook-local/components';
 import { useCallback, useMemo, type CSSProperties, type ReactNode } from 'react';
 import type { ChatParticipant } from '../../../../../../../src/book-components/Chat/types/ChatParticipant';
 import type { ChatSaveFormatHandlerOptions } from '../../../../../../../src/book-components/Chat/save/_common/ChatSaveFormatHandler';
+import type { AgentProjectItemInfo } from '../../../../components/AgentProjects/AgentProjectReferencesList';
 import { useAgentBackground } from '../../../../components/AgentProfile/useAgentBackground';
 import { useChatEnterBehaviorPreferences } from '../../../../components/ChatEnterBehavior/ChatEnterBehaviorPreferencesProvider';
 import { notifyError } from '../../../../components/Notifications/notifications';
@@ -14,15 +15,16 @@ import { useServerLanguage } from '../../../../components/ServerLanguage/ServerL
 import { ChatThreadLoadingSkeleton } from '../../../../components/Skeleton/ChatThreadLoadingSkeleton';
 import { useSoundSystem } from '../../../../components/SoundSystemProvider/SoundSystemProvider';
 import { usePromptbookTheme } from '../../../../components/ThemeMode/usePromptbookTheme';
+import { createAttachmentAwareCitationLabelResolver } from '../../../../utils/chat/createAttachmentAwareCitationLabelResolver';
 import { createDefaultChatEffects } from '../../../../utils/chat/createDefaultChatEffects';
 import { executeQuickActionButton } from '../../../../utils/chat/executeQuickActionButton';
-import { resolveAgentsServerCitationLabel } from '../../../../utils/chat/resolveAgentsServerCitationLabel';
 import { downloadChatPdfFromServer } from '../../../../utils/chatExport/downloadChatPdfFromServer';
 import {
     isChatFeedbackEnabled,
     toChatComponentFeedbackMode,
     type ChatFeedbackMode,
 } from '../../../../utils/chatFeedbackMode';
+import { createAgentProjectMarkdownReferences } from '../../../../utils/agentProjects/createAgentProjectMarkdownReferences';
 import { createDefaultSpeechRecognition } from '../../../../utils/speech-to-text/createDefaultSpeechRecognition';
 import { chatFileUploadHandler } from '../../../../utils/upload/createBookEditorUploadHandler';
 import { getUserChatSourceBannerLabel, type UserChatSource } from '../../../../utils/userChat/UserChatSource';
@@ -58,6 +60,10 @@ type TranslateText = ReturnType<typeof useServerLanguage>['t'];
  * @private function of CanonicalAgentChatPanel
  */
 type CanonicalAgentChatSurfaceProps = {
+    /**
+     * Agent name used to scope live browser previews to the agent's persistent browser profile.
+     */
+    readonly agentName: string;
     readonly brandColor?: string;
     readonly inputPlaceholder: string | undefined;
     readonly draftMessage?: string;
@@ -68,6 +74,18 @@ type CanonicalAgentChatSurfaceProps = {
     readonly currentTimestamp: number;
     readonly isReadOnly: boolean;
     readonly readOnlySource?: UserChatSource;
+    /**
+     * True when the viewed chat belongs to a different user than the current viewer.
+     */
+    readonly isExternalUserChat?: boolean;
+    /**
+     * Optional actions rendered inside the read-only banner (for example super-admin shortcuts).
+     */
+    readonly readOnlyExtraActions?: ReactNode;
+    /**
+     * Project references resolved from `[[project-name]]` markdown tokens.
+     */
+    readonly projectReferences?: ReadonlyArray<AgentProjectItemInfo>;
     readonly onDraftMessageChange: (message: string) => void;
     readonly onStartNewChat?: () => Promise<void> | void;
     readonly newChatButtonHref?: string;
@@ -91,6 +109,7 @@ const USER_PARTICIPANT_COLOR = '#115EB6';
  * @private function of CanonicalAgentChatPanel
  */
 export function CanonicalAgentChatSurface({
+    agentName,
     brandColor,
     inputPlaceholder,
     draftMessage,
@@ -101,6 +120,9 @@ export function CanonicalAgentChatSurface({
     currentTimestamp,
     isReadOnly,
     readOnlySource,
+    isExternalUserChat = false,
+    readOnlyExtraActions,
+    projectReferences = [],
     onDraftMessageChange,
     onStartNewChat,
     newChatButtonHref,
@@ -111,6 +133,14 @@ export function CanonicalAgentChatSurface({
     state,
 }: CanonicalAgentChatSurfaceProps) {
     const { backgroundImage, brandColorHex, brandColorLightHex, brandColorDarkHex } = useAgentBackground(brandColor);
+    const markdownInlineReferences = useMemo(
+        () =>
+            createAgentProjectMarkdownReferences({
+                agentPermanentId: agentName,
+                projects: projectReferences,
+            }),
+        [agentName, projectReferences],
+    );
     const chatBackgroundStyle = useMemo(
         () =>
             createCanonicalAgentChatBackgroundStyle({
@@ -142,10 +172,15 @@ export function CanonicalAgentChatSurface({
     );
     const { language, t: translateText } = useServerLanguage();
     const translations = useMemo(() => createCanonicalAgentChatTranslations(translateText), [translateText]);
-    const frozenChatBannerLabel = useMemo(
-        () => (readOnlySource ? getUserChatSourceBannerLabel(readOnlySource) : null),
-        [readOnlySource],
-    );
+    const frozenChatBannerLabel = useMemo(() => {
+        const sourceBannerLabel = readOnlySource ? getUserChatSourceBannerLabel(readOnlySource) : null;
+        if (sourceBannerLabel) {
+            return sourceBannerLabel;
+        }
+
+        // Note: Chats of other users have no external source but must still explain the view-only mode
+        return isExternalUserChat ? 'another user' : null;
+    }, [isExternalUserChat, readOnlySource]);
     const feedbackEnabled = isChatFeedbackEnabled(feedbackMode);
     const cancellableJob = useMemo(() => resolveCancellableJob(activeJobs), [activeJobs]);
     const { chatVisualMode } = useChatVisualMode();
@@ -217,6 +252,10 @@ export function CanonicalAgentChatSurface({
         ),
         [activeTimeouts, cancelAction, currentTimestamp, extraActions, isReadOnly, onCancelActiveTimeout],
     );
+    const resolveCitationLabel = useMemo(
+        () => createAttachmentAwareCitationLabelResolver(state.renderedMessages),
+        [state.renderedMessages],
+    );
     const shouldRenderLoadingSkeleton = state.initialMessage === undefined && state.renderedMessages.length === 0;
     const chatElement = shouldRenderLoadingSkeleton ? (
         renderCanonicalAgentChatLoadingSkeleton()
@@ -225,6 +264,7 @@ export function CanonicalAgentChatSurface({
             className="agent-chat-panel__chat h-full min-h-0 w-full"
             style={chatBackgroundStyle}
             title={`Chat with ${state.agentDisplayName}`}
+            agentIdentifier={agentName}
             messages={state.renderedMessages}
             defaultMessage={draftMessage}
             placeholderMessageContent={inputPlaceholder}
@@ -266,7 +306,8 @@ export function CanonicalAgentChatSurface({
             teamAgentProfiles={state.teamAgentProfiles}
             extraActions={extraActionNodes}
             saveFormatHandlers={saveFormatHandlers}
-            resolveCitationLabel={resolveAgentsServerCitationLabel}
+            markdownInlineReferences={markdownInlineReferences}
+            resolveCitationLabel={resolveCitationLabel}
             theme={promptbookTheme}
         >
             {!isReadOnly && areFileAttachmentsEnabled && !fileUploadAvailability.isUploadAvailable && (
@@ -275,6 +316,7 @@ export function CanonicalAgentChatSurface({
             {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 })}
+                    {readOnlyExtraActions}
                 </div>
             )}
         </Chat>

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

@@ -0,0 +1,125 @@
+'use client';
+
+import type { ChatMessage } from '@promptbook-local/types';
+import { useCallback, useState } from 'react';
+import { notifyError, notifySuccess } from '../../../../components/Notifications/notifications';
+import {
+    $saveMockedChatPresetFromMessages,
+    MOCKED_CHATS_EDITOR_ROUTE,
+} from '../../../../utils/mockedChats/$saveMockedChatPresetFromMessages';
+
+/**
+ * Route of the admin chat-history page linked from the external-chat view.
+ *
+ * @private constant of <ExternalUserChatAdminActions/>
+ */
+const ADMIN_CHAT_HISTORY_ROUTE = '/admin/chat-history';
+
+/**
+ * Builds the admin chat-history link pointing at the most detailed view of one chat.
+ *
+ * When the agent and chat thread are known the link opens the recorded conversation
+ * directly (chat view of that thread) instead of the mixed chat-history pile.
+ *
+ * @private utility of <ExternalUserChatAdminActions/>
+ */
+function buildAdminChatHistoryHref(agentName: string, chatId: string): string {
+    const params = new URLSearchParams();
+
+    if (agentName) {
+        params.set('agentName', agentName);
+    }
+
+    if (chatId) {
+        params.set('chatId', chatId);
+        params.set('view', 'chat');
+    }
+
+    const qs = params.toString();
+    return qs ? `${ADMIN_CHAT_HISTORY_ROUTE}?${qs}` : ADMIN_CHAT_HISTORY_ROUTE;
+}
+
+/**
+ * Props for the super-admin actions shown on external users' chats.
+ *
+ * @private component of <AgentChatHistoryClient/>
+ */
+type ExternalUserChatAdminActionsProps = {
+    /**
+     * Name of the agent owning the viewed chat, used to deep-link the chat history.
+     */
+    readonly agentName: string;
+    /**
+     * Canonical id of the viewed chat, used to deep-link the recorded conversation.
+     */
+    readonly chatId: string;
+    /**
+     * Title of the viewed chat used as the mocked-chat preset name.
+     */
+    readonly chatTitle: string;
+    /**
+     * Messages of the viewed chat used to build the mocked-chat preset.
+     */
+    readonly messages: ReadonlyArray<ChatMessage>;
+};
+
+/**
+ * Super-admin quick actions rendered inside the frozen banner of external users' chats:
+ * create a mocked chat from the conversation and jump to the admin chat history.
+ *
+ * @private component of <AgentChatHistoryClient/>
+ */
+export function ExternalUserChatAdminActions({
+    agentName,
+    chatId,
+    chatTitle,
+    messages,
+}: ExternalUserChatAdminActionsProps) {
+    const [isCreatingMock, setIsCreatingMock] = useState(false);
+    const adminChatHistoryHref = buildAdminChatHistoryHref(agentName, chatId);
+
+    const handleCreateMock = useCallback(async () => {
+        if (isCreatingMock) {
+            return;
+        }
+
+        try {
+            setIsCreatingMock(true);
+            await $saveMockedChatPresetFromMessages({
+                name: chatTitle,
+                messages: messages.map((message) => ({
+                    sender: String(message.sender || ''),
+                    content: typeof message.content === 'string' ? message.content : '',
+                    createdAt: message.createdAt || null,
+                })),
+            });
+            notifySuccess('Mocked chat was created.');
+            window.location.href = MOCKED_CHATS_EDITOR_ROUTE;
+        } catch (error) {
+            notifyError(error instanceof Error ? error.message : 'Failed to create the mocked chat.');
+        } finally {
+            setIsCreatingMock(false);
+        }
+    }, [chatTitle, isCreatingMock, messages]);
+
+    return (
+        <span className="ml-2 inline-flex flex-wrap items-center gap-2 align-middle">
+            <button
+                type="button"
+                onClick={() => void handleCreateMock()}
+                disabled={isCreatingMock}
+                className="rounded-full border border-amber-300 bg-white/80 px-3 py-1 text-xs font-semibold text-amber-900 hover:bg-white disabled:cursor-not-allowed disabled:opacity-60 dark:border-amber-500/40 dark:bg-transparent dark:text-amber-100"
+                title="Create a mocked chat preset from this conversation"
+            >
+                {isCreatingMock ? 'Creating mock…' : 'Create mock'}
+            </button>
+            <a
+                href={adminChatHistoryHref}
+                className="rounded-full border border-amber-300 bg-white/80 px-3 py-1 text-xs font-semibold text-amber-900 hover:bg-white dark:border-amber-500/40 dark:bg-transparent dark:text-amber-100"
+                title="Open the admin chat history"
+            >
+                Chat history
+            </a>
+        </span>
+    );
+}

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

@@ -1,13 +1,17 @@
 'use server';
 import type { Metadata, ResolvingMetadata } from 'next';
 import { ForbiddenPage } from '@/src/components/ForbiddenPage/ForbiddenPage';
+import type { AgentProjectItemInfo } from '@/src/components/AgentProjects/AgentProjectReferencesList';
 import { $provideServer } from '@/src/tools/$provideServer';
 import { resolveAgentAccess } from '@/src/utils/agentAccess';
+import { resolveAgentProjectsAccess } from '@/src/utils/agentProjects/agentProjectAccess';
+import { listAgentProjectChatReferences } from '@/src/utils/agentProjects/listAgentProjectChatReferences';
 import { loadChatConfiguration } from '@/src/utils/chatConfiguration';
 import { ensureChatHistoryIdentity } from '@/src/utils/currentUserIdentity';
 import { getCurrentUser } from '@/src/utils/getCurrentUser';
+import { isUserGlobalAdmin } from '@/src/utils/isUserGlobalAdmin';
 import { peekShareTargetPayload } from '@/src/utils/shareTargetPayloads';
-import { getThinkingMessages } from '@/src/utils/thinkingMessages';
+import { getThinkingMessages, resolveThinkingMessages } from '@/src/utils/thinkingMessages';
 import { headers } from 'next/headers';
 import { notFound, redirect } from 'next/navigation';
 import { resolveSpeechRecognitionLanguage } from '../../../../../../../src/utils/language/getBrowserPreferredSpeechRecognitionLanguage';
@@ -67,6 +71,23 @@ function buildCanonicalAgentChatPath(
     return query ? `${pathname}?${query}` : pathname;
 }
 
+/**
+ * Resolves compact project references available to the agent chat surface.
+ *
+ * @param agentPermanentId - Permanent id of the agent owning the projects.
+ * @returns Display-only project references safe to send to the client.
+ */
+async function resolveAgentChatProjectReferences(
+    agentPermanentId: string,
+): Promise<ReadonlyArray<AgentProjectItemInfo>> {
+    const projectAccess = await resolveAgentProjectsAccess(agentPermanentId);
+    if (!projectAccess.isProjectOverviewVisible) {
+        return [];
+    }
+
+    return await listAgentProjectChatReferences(agentPermanentId);
+}
+
 /**
  * Handles agent chat page.
  */
@@ -75,12 +96,23 @@ export default async function AgentChatPage({
     searchParams,
 }: {
     params: Promise<{ agentName: string }>;
-    searchParams: Promise<{ headless?: string; message?: string; chat?: string; newChat?: string; shareTarget?: string }>;
+    searchParams: Promise<{
+        headless?: string;
+        message?: string;
+        chat?: string;
+        newChat?: string;
+        shareTarget?: string;
+    }>;
 }) {
     const requestHeadersPromise = headers();
-    const [agentName, currentSearchParams, requestHeaders] = await Promise.all([getAgentName(params), searchParams, requestHeadersPromise]);
+    const [agentName, currentSearchParams, requestHeaders] = await Promise.all([
+        getAgentName(params),
+        searchParams,
+        requestHeadersPromise,
+    ]);
     $sideEffect(requestHeaders);
     const { headless, message, chat, newChat, shareTarget } = currentSearchParams;
+    const isHeadless = headless !== undefined;
 
     const isForcedNewChat = chat === FORCE_NEW_CHAT_QUERY_VALUE || parseBooleanFlag(newChat);
     const effectiveChatId = chat === FORCE_NEW_CHAT_QUERY_VALUE ? undefined : chat;
@@ -113,8 +145,11 @@ export default async function AgentChatPage({
     const historyIdentityAvailablePromise = ensureChatHistoryIdentity();
     const currentUserPromise = getCurrentUser();
     const chatConfigurationPromise = loadChatConfiguration();
-    const thinkingMessagesPromise = getThinkingMessages();
+    const serverThinkingMessagesPromise = getThinkingMessages();
     const providedServerPromise = $provideServer();
+    const agentProjectReferencesPromise = isHeadless
+        ? Promise.resolve<ReadonlyArray<AgentProjectItemInfo>>([])
+        : resolveAgentChatProjectReferences(canonicalAgentId);
     const shareTargetPayloadPromise = shareTarget
         ? peekShareTargetPayload({
               shareTargetId: shareTarget,
@@ -123,7 +158,6 @@ export default async function AgentChatPage({
         : Promise.resolve(null);
 
     const isDeleted = await isDeletedPromise;
-    const isHeadless = headless !== undefined;
 
     if (isDeleted) {
         return (
@@ -141,19 +175,23 @@ export default async function AgentChatPage({
         historyIdentityAvailable,
         currentUser,
         { isFileAttachmentsEnabled, feedbackMode },
-        thinkingMessages,
+        serverThinkingMessages,
         { publicUrl },
+        agentProjectReferences,
         shareTargetPayload,
-    ] =
-        await Promise.all([
+        isCurrentUserSuperAdmin,
+    ] = await Promise.all([
         agentProfilePromise,
         historyIdentityAvailablePromise,
         currentUserPromise,
         chatConfigurationPromise,
-        thinkingMessagesPromise,
+        serverThinkingMessagesPromise,
         providedServerPromise,
+        agentProjectReferencesPromise,
         shareTargetPayloadPromise,
+        isUserGlobalAdmin(),
     ]);
+    const thinkingMessages = resolveThinkingMessages(agentProfile.thinkingMessages, serverThinkingMessages);
     const agentUrl = new URL(`/agents/${encodeURIComponent(canonicalAgentId)}`, publicUrl).href;
     const agentDisplayName = agentProfile.meta.fullname || agentProfile.agentName || canonicalAgentId;
     const inputPlaceholder = agentProfile.meta.inputPlaceholder?.trim() || undefined;
@@ -179,6 +217,8 @@ export default async function AgentChatPage({
                 speechRecognitionLanguage={speechRecognitionLanguage}
                 isHistoryEnabled={historyIdentityAvailable}
                 isCurrentUserAdmin={currentUser?.isAdmin === true}
+                isCurrentUserSuperAdmin={isCurrentUserSuperAdmin}
+                projectReferences={agentProjectReferences}
                 areFileAttachmentsEnabled={isFileAttachmentsEnabled}
                 feedbackMode={feedbackMode}
                 isHeadlessMode={isHeadless}