@promptbook/cli 0.113.0-9 → 0.114.0-0

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

@@ -3,7 +3,7 @@ import {
     createUserChatDetailPayload,
     deleteUserChat,
     getUserChat,
-    isFrozenUserChatSource,
+    isUserChatViewOnly,
     updateUserChatMessages,
 } from '@/src/utils/userChat';
 import { UserChatReplyValidationError } from '@/src/utils/userChat/UserChatReplyValidationError';
@@ -40,6 +40,7 @@ export async function GET(request: Request, { params }: { params: Promise<{ agen
         const chat = await getUserChat({
             userId: scopeResult.scope.userId,
             viewerIsAdmin: scopeResult.scope.viewerIsAdmin,
+            viewerIsSuperAdmin: scopeResult.scope.viewerIsSuperAdmin,
             agentPermanentId: scopeResult.scope.agentPermanentId,
             chatId,
         });
@@ -48,7 +49,7 @@ export async function GET(request: Request, { params }: { params: Promise<{ agen
             return NextResponse.json({ error: 'Chat not found.' }, { status: 404 });
         }
 
-        return NextResponse.json(await createUserChatDetailPayload(chat));
+        return NextResponse.json(await createUserChatDetailPayload(chat, { viewerUserId: scopeResult.scope.userId }));
     } catch (error) {
         return NextResponse.json(
             { error: error instanceof Error ? error.message : 'Failed to load chat.' },
@@ -84,6 +85,7 @@ export async function PATCH(request: Request, { params }: { params: Promise<{ ag
         const existingChat = await getUserChat({
             userId: scopeResult.scope.userId,
             viewerIsAdmin: scopeResult.scope.viewerIsAdmin,
+            viewerIsSuperAdmin: scopeResult.scope.viewerIsSuperAdmin,
             agentPermanentId: scopeResult.scope.agentPermanentId,
             chatId,
         });
@@ -92,7 +94,7 @@ export async function PATCH(request: Request, { params }: { params: Promise<{ ag
             return NextResponse.json({ error: 'Chat not found.' }, { status: 404 });
         }
 
-        if (isFrozenUserChatSource(existingChat.source)) {
+        if (isUserChatViewOnly({ chat: existingChat, viewerUserId: scopeResult.scope.userId })) {
             return NextResponse.json({ error: 'Frozen chats are view-only in the web UI.' }, { status: 403 });
         }
 
@@ -108,7 +110,9 @@ export async function PATCH(request: Request, { params }: { params: Promise<{ ag
             messages: body.messages as Array<ChatMessage>,
         });
 
-        return NextResponse.json(await createUserChatDetailPayload(updatedChat));
+        return NextResponse.json(
+            await createUserChatDetailPayload(updatedChat, { viewerUserId: scopeResult.scope.userId }),
+        );
     } catch (error) {
         if (error instanceof UserChatScopeError) {
             return resolveUserChatUpdateScopeErrorResponse(error);
@@ -196,6 +200,7 @@ export async function DELETE(request: Request, { params }: { params: Promise<{ a
         const existingChat = await getUserChat({
             userId: scopeResult.scope.userId,
             viewerIsAdmin: scopeResult.scope.viewerIsAdmin,
+            viewerIsSuperAdmin: scopeResult.scope.viewerIsSuperAdmin,
             agentPermanentId: scopeResult.scope.agentPermanentId,
             chatId,
         });
@@ -204,7 +209,7 @@ export async function DELETE(request: Request, { params }: { params: Promise<{ a
             return NextResponse.json({ error: 'Chat not found.' }, { status: 404 });
         }
 
-        if (isFrozenUserChatSource(existingChat.source)) {
+        if (isUserChatViewOnly({ chat: existingChat, viewerUserId: scopeResult.scope.userId })) {
             return NextResponse.json({ error: 'Frozen chats are view-only in the web UI.' }, { status: 403 });
         }
 

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

@@ -1,6 +1,7 @@
 import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
 import { canAccessAgentVisibility, resolveAgentVisibility } from '@/src/utils/agentAccess';
 import { resolveCurrentUserIdentity } from '@/src/utils/currentUserIdentity';
+import { isUserGlobalAdmin } from '@/src/utils/isUserGlobalAdmin';
 import { ensureUserChatTimeoutWorkerBootstrapped } from '@/src/utils/userChatTimeout/ensureUserChatTimeoutWorkerBootstrapped';
 
 /**
@@ -9,6 +10,11 @@ import { ensureUserChatTimeoutWorkerBootstrapped } from '@/src/utils/userChatTim
 export type ResolvedUserChatScope = {
     userId: number;
     viewerIsAdmin: boolean;
+    /**
+     * True when the viewer is the environment-backed super-admin
+     * who may browse all users' chats in a view-only mode.
+     */
+    viewerIsSuperAdmin: boolean;
     agentPermanentId: string;
 };
 
@@ -32,7 +38,10 @@ export async function resolveUserChatScope(
 
     try {
         const collection = await $provideAgentCollectionForServer();
-        const agentPermanentId = await collection.getAgentPermanentId(agentIdentifier);
+        const [agentPermanentId, viewerIsSuperAdmin] = await Promise.all([
+            collection.getAgentPermanentId(agentIdentifier),
+            isUserGlobalAdmin(),
+        ]);
         const visibility = await resolveAgentVisibility(agentPermanentId);
         const isAllowed = canAccessAgentVisibility({
             visibility,
@@ -48,6 +57,7 @@ export async function resolveUserChatScope(
             scope: {
                 userId: currentUserIdentity.userId,
                 viewerIsAdmin: currentUserIdentity.isAdmin,
+                viewerIsSuperAdmin,
                 agentPermanentId,
             },
         };

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

@@ -41,11 +41,14 @@ export async function GET(request: Request, { params }: { params: Promise<{ agen
         const chatSummarySeeds = await listUserChatSummarySeeds({
             userId: scopeResult.scope.userId,
             viewerIsAdmin: scopeResult.scope.viewerIsAdmin,
+            viewerIsSuperAdmin: scopeResult.scope.viewerIsSuperAdmin,
             agentPermanentId: scopeResult.scope.agentPermanentId,
             includeExternalChats: showExternalChats,
         });
         const activityUserId =
-            scopeResult.scope.viewerIsAdmin && showExternalChats ? undefined : scopeResult.scope.userId;
+            (scopeResult.scope.viewerIsAdmin || scopeResult.scope.viewerIsSuperAdmin) && showExternalChats
+                ? undefined
+                : scopeResult.scope.userId;
         const [timeoutActivities, jobActivityCounts] = await Promise.all([
             listUserChatTimeoutActivities({
                 userId: activityUserId,
@@ -67,15 +70,19 @@ export async function GET(request: Request, { params }: { params: Promise<{ agen
             ? await getUserChat({
                   userId: scopeResult.scope.userId,
                   viewerIsAdmin: scopeResult.scope.viewerIsAdmin,
+                  viewerIsSuperAdmin: scopeResult.scope.viewerIsSuperAdmin,
                   agentPermanentId: scopeResult.scope.agentPermanentId,
                   chatId: activeChatSummarySeed.id,
               })
             : null;
-        const activeChatDetail = activeChat ? await createUserChatDetailPayload(activeChat) : null;
+        const activeChatDetail = activeChat
+            ? await createUserChatDetailPayload(activeChat, { viewerUserId: scopeResult.scope.userId })
+            : null;
         const chatSummaries = chatSummarySeeds.map((chat) =>
             createUserChatSummaryFromSeed(chat, {
                 timeoutActivity: timeoutActivities[chat.id],
                 activeJobCount: jobActivityCounts[chat.id],
+                viewerUserId: scopeResult.scope.userId,
             }),
         );
 

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';
@@ -23,6 +24,7 @@ import {
     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();
@@ -229,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}
@@ -270,6 +306,7 @@ export function CanonicalAgentChatSurface({
             teamAgentProfiles={state.teamAgentProfiles}
             extraActions={extraActionNodes}
             saveFormatHandlers={saveFormatHandlers}
+            markdownInlineReferences={markdownInlineReferences}
             resolveCitationLabel={resolveCitationLabel}
             theme={promptbookTheme}
         >
@@ -279,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>
+    );
+}