Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active
TypeScript aianthropicartifactsawsazurechatgptchatgpt-cloneclaudeclonedeepseekgeminigooglegpt-5librechatmcpo1openairesponses-apivisionwebui
import { QueryClient } from '@tanstack/react-query';
import { Constants, QueryKeys } from 'librechat-data-provider';
import type { TMessage, TConversation } from 'librechat-data-provider';
import type { TEndpointsConfig } from 'librechat-data-provider';
import type { LocalizeFunction, TMessageProps } from '~/common';
import {
clearMessagesCache,
clearArchivedConversationMessagesCache,
clearDeletedConversationMessagesCache,
getMessageAriaLabel,
getHeaderPrefixForScreenReader,
areMessageFieldsEqual,
areMessageRowPropsEqual,
isSameTailRelation,
isSubmittableMessage,
createDualMessageContent,
} from '../messages';
const translations: Record<string, string> = {
com_endpoint_message: 'Message',
com_endpoint_message_new: 'Message {{0}}',
com_ui_prompt: 'Prompt',
com_ui_response: 'Response',
};
const localize: LocalizeFunction = ((key: string, args?: Record<string, string | number>) => {
const template = translations[key] ?? key;
if (args) {
return Object.entries(args).reduce(
(result, [k, v]) => result.replace(`{{${k}}}`, String(v)),
template,
);
}
return template;
}) as LocalizeFunction;
const makeMessage = (overrides: Partial<TMessage> = {}): TMessage =>
({
messageId: 'msg-1',
isCreatedByUser: false,
...overrides,
}) as TMessage;
describe('clearMessagesCache', () => {
it('removes existing-conversation history while resetting the new-conversation cache', () => {
const queryClient = new QueryClient();
const conversationId = 'conversation-1';
const messages = [makeMessage({ conversationId })];
queryClient.setQueryData([QueryKeys.messages, conversationId], messages);
queryClient.setQueryData([QueryKeys.messages, Constants.NEW_CONVO], messages);
clearMessagesCache(queryClient, conversationId);
expect(queryClient.getQueryData([QueryKeys.messages, conversationId])).toBeUndefined();
expect(queryClient.getQueryData([QueryKeys.messages, Constants.NEW_CONVO])).toEqual([]);
});
});
describe('clearDeletedConversationMessagesCache', () => {
it('clears both caches when the new-conversation cache contains deleted chat messages', () => {
const queryClient = new QueryClient();
const conversationId = 'conversation-1';
const messages = [makeMessage({ conversationId })];
queryClient.setQueryData([QueryKeys.messages, conversationId], messages);
queryClient.setQueryData(
[QueryKeys.messages, Constants.NEW_CONVO],
messages.map((message) => ({ ...message })),
);
clearDeletedConversationMessagesCache(queryClient, conversationId);
expect(queryClient.getQueryData([QueryKeys.messages, conversationId])).toBeUndefined();
expect(queryClient.getQueryData([QueryKeys.messages, Constants.NEW_CONVO])).toEqual([]);
});
it('clears a shared new-conversation cache before its message IDs are hydrated', () => {
const queryClient = new QueryClient();
const conversationId = 'conversation-1';
const messages = [makeMessage({ conversationId: Constants.NEW_CONVO as string })];
queryClient.setQueryData([QueryKeys.messages, conversationId], messages);
queryClient.setQueryData([QueryKeys.messages, Constants.NEW_CONVO], messages);
clearDeletedConversationMessagesCache(queryClient, conversationId);
expect(queryClient.getQueryData([QueryKeys.messages, conversationId])).toBeUndefined();
expect(queryClient.getQueryData([QueryKeys.messages, Constants.NEW_CONVO])).toEqual([]);
});
it('preserves an unrelated new-conversation message cache', () => {
const queryClient = new QueryClient();
const conversationId = 'conversation-1';
const newConversationMessages = [
makeMessage({ messageId: 'new-message', conversationId: Constants.NEW_CONVO as string }),
];
queryClient.setQueryData(
[QueryKeys.messages, conversationId],
[makeMessage({ conversationId })],
);
queryClient.setQueryData([QueryKeys.messages, Constants.NEW_CONVO], newConversationMessages);
clearDeletedConversationMessagesCache(queryClient, conversationId);
expect(queryClient.getQueryData([QueryKeys.messages, conversationId])).toBeUndefined();
expect(queryClient.getQueryData([QueryKeys.messages, Constants.NEW_CONVO])).toEqual(
newConversationMessages,
);
});
});
describe('clearArchivedConversationMessagesCache', () => {
it('clears the new-conversation cache that still shows the archived chat', () => {
const queryClient = new QueryClient();
const conversationId = 'conversation-1';
const messages = [makeMessage({ conversationId })];
queryClient.setQueryData([QueryKeys.messages, conversationId], messages);
queryClient.setQueryData(
[QueryKeys.messages, Constants.NEW_CONVO],
messages.map((message) => ({ ...message })),
);
clearArchivedConversationMessagesCache(queryClient, conversationId);
expect(queryClient.getQueryData([QueryKeys.messages, Constants.NEW_CONVO])).toEqual([]);
});
it('clears a shared new-conversation cache before its message IDs are hydrated', () => {
const queryClient = new QueryClient();
const conversationId = 'conversation-1';
const messages = [makeMessage({ conversationId: Constants.NEW_CONVO as string })];
queryClient.setQueryData([QueryKeys.messages, conversationId], messages);
queryClient.setQueryData([QueryKeys.messages, Constants.NEW_CONVO], messages);
clearArchivedConversationMessagesCache(queryClient, conversationId);
expect(queryClient.getQueryData([QueryKeys.messages, Constants.NEW_CONVO])).toEqual([]);
});
it('keeps the archived conversation history so reopening it from the archive is instant', () => {
const queryClient = new QueryClient();
const conversationId = 'conversation-1';
const messages = [makeMessage({ conversationId })];
queryClient.setQueryData([QueryKeys.messages, conversationId], messages);
queryClient.setQueryData([QueryKeys.messages, Constants.NEW_CONVO], messages);
clearArchivedConversationMessagesCache(queryClient, conversationId);
expect(queryClient.getQueryData([QueryKeys.messages, conversationId])).toEqual(messages);
});
it('preserves an unrelated new-conversation message cache', () => {
const queryClient = new QueryClient();
const conversationId = 'conversation-1';
const newConversationMessages = [
makeMessage({ messageId: 'new-message', conversationId: Constants.NEW_CONVO as string }),
];
queryClient.setQueryData(
[QueryKeys.messages, conversationId],
[makeMessage({ conversationId })],
);
queryClient.setQueryData([QueryKeys.messages, Constants.NEW_CONVO], newConversationMessages);
clearArchivedConversationMessagesCache(queryClient, conversationId);
expect(queryClient.getQueryData([QueryKeys.messages, Constants.NEW_CONVO])).toEqual(
newConversationMessages,
);
});
});
describe('getMessageAriaLabel', () => {
it('returns "Message N" when depth is present and valid', () => {
const msg = makeMessage({ depth: 2 });
expect(getMessageAriaLabel(msg, localize)).toBe('Message 3');
});
it('returns "Message" when depth is undefined', () => {
const msg = makeMessage({ depth: undefined });
expect(getMessageAriaLabel(msg, localize)).toBe('Message');
});
it('returns "Message" when depth is negative', () => {
const msg = makeMessage({ depth: -1 });
expect(getMessageAriaLabel(msg, localize)).toBe('Message');
});
it('returns "Message 1" for depth 0 (root message)', () => {
const msg = makeMessage({ depth: 0 });
expect(getMessageAriaLabel(msg, localize)).toBe('Message 1');
});
});
describe('getHeaderPrefixForScreenReader', () => {
it('returns "Prompt N: " for user messages with valid depth', () => {
const msg = makeMessage({ isCreatedByUser: true, depth: 2 });
expect(getHeaderPrefixForScreenReader(msg, localize)).toBe('Prompt 3: ');
});
it('returns "Response N: " for AI messages with valid depth', () => {
const msg = makeMessage({ isCreatedByUser: false, depth: 0 });
expect(getHeaderPrefixForScreenReader(msg, localize)).toBe('Response 1: ');
});
it('returns "Prompt: " for user messages without depth', () => {
const msg = makeMessage({ isCreatedByUser: true, depth: undefined });
expect(getHeaderPrefixForScreenReader(msg, localize)).toBe('Prompt: ');
});
it('returns "Response: " for AI messages without depth', () => {
const msg = makeMessage({ isCreatedByUser: false, depth: undefined });
expect(getHeaderPrefixForScreenReader(msg, localize)).toBe('Response: ');
});
it('omits number when depth is -1 (no "Prompt 0:" regression)', () => {
const msg = makeMessage({ isCreatedByUser: true, depth: -1 });
expect(getHeaderPrefixForScreenReader(msg, localize)).toBe('Prompt: ');
});
it('omits number when depth is negative', () => {
const msg = makeMessage({ isCreatedByUser: false, depth: -5 });
expect(getHeaderPrefixForScreenReader(msg, localize)).toBe('Response: ');
});
});
const noop = () => {};
/** Shared content reference so the baseline compares equal on `content` (which
* the comparator diffs BY REFERENCE); the mutation below hands a fresh array. */
const SHARED_CONTENT = [] as TMessage['content'];
const makeFieldsMsg = (over: Partial<TMessage> = {}): TMessage =>
({
messageId: 'm1',
text: 'hello',
error: false,
unfinished: false,
finish_reason: 'stop',
createdAt: '2026-07-01T00:00:00.000Z',
depth: 0,
isCreatedByUser: false,
content: SHARED_CONTENT,
model: 'gpt-4',
endpoint: 'openAI',
iconURL: '',
...over,
}) as TMessage;
/**
* One entry per field `areMessageFieldsEqual` compares, each differing from the
* `makeFieldsMsg` baseline. This list is the guard: dropping a field from the
* comparator makes its case here fail (a bailed row would show stale content),
* and adding a rendered field should mean adding it in both places.
*/
const FIELD_MUTATIONS: Array<[string, Partial<TMessage>]> = [
['messageId', { messageId: 'm2' }],
['text', { text: 'changed' }],
['error', { error: true }],
['unfinished', { unfinished: true }],
['finish_reason', { finish_reason: 'tool_call_limit' }],
['createdAt', { createdAt: '2026-07-02T00:00:00.000Z' }],
['depth', { depth: 3 }],
['isCreatedByUser', { isCreatedByUser: true }],
['isUserSubmitted', { isUserSubmitted: true }],
['children length', { children: [makeFieldsMsg(), makeFieldsMsg()] }],
['content reference', { content: [] as TMessage['content'] }],
['model', { model: 'gpt-5' }],
['endpoint', { endpoint: 'anthropic' }],
['iconURL', { iconURL: 'https://example.com/icon.png' }],
['feedback rating', { feedback: { rating: 'thumbsDown' } as unknown as TMessage['feedback'] }],
['files', { files: [{ file_id: 'f1' }] as TMessage['files'] }],
[
'attachments length',
{ attachments: [{ file_id: 'a1' }] as unknown as TMessage['attachments'] },
],
['manualSkills length', { manualSkills: ['skill'] as unknown as TMessage['manualSkills'] }],
[
'alwaysAppliedSkills length',
{ alwaysAppliedSkills: ['skill'] as unknown as TMessage['alwaysAppliedSkills'] },
],
['quotes length', { quotes: [{ text: 'q' }] as unknown as TMessage['quotes'] }],
];
describe('areMessageFieldsEqual', () => {
it('is true for the same reference', () => {
const message = makeFieldsMsg();
expect(areMessageFieldsEqual(message, message)).toBe(true);
});
it('is true for distinct objects with identical compared fields', () => {
expect(areMessageFieldsEqual(makeFieldsMsg(), makeFieldsMsg())).toBe(true);
});
it('handles nullish operands', () => {
expect(areMessageFieldsEqual(makeFieldsMsg(), null)).toBe(false);
expect(areMessageFieldsEqual(null, makeFieldsMsg())).toBe(false);
expect(areMessageFieldsEqual(null, null)).toBe(true);
expect(areMessageFieldsEqual(undefined, undefined)).toBe(true);
});
it.each(FIELD_MUTATIONS)('re-renders when %s changes', (_label, mutation) => {
expect(areMessageFieldsEqual(makeFieldsMsg(), makeFieldsMsg(mutation))).toBe(false);
});
});
const baseMessage = makeFieldsMsg();
const makeProps = (over: Partial<TMessageProps> = {}): TMessageProps =>
({
currentEditId: null,
setCurrentEditId: noop,
siblingIdx: 0,
siblingCount: 1,
setSiblingIdx: noop,
isSearchView: false,
conversation: null,
message: baseMessage,
...over,
}) as TMessageProps;
const PROP_MUTATIONS: Array<[string, Partial<TMessageProps>]> = [
['currentEditId', { currentEditId: 'edit-1' }],
['setCurrentEditId', { setCurrentEditId: () => {} }],
['siblingIdx', { siblingIdx: 1 }],
['siblingCount', { siblingCount: 2 }],
['setSiblingIdx', { setSiblingIdx: () => {} }],
['isSearchView', { isSearchView: true }],
['conversation', { conversation: { conversationId: 'c1' } as unknown as TConversation }],
];
describe('areMessageRowPropsEqual', () => {
it('is true for distinct prop objects with identical values', () => {
expect(areMessageRowPropsEqual(makeProps(), makeProps())).toBe(true);
});
it.each(PROP_MUTATIONS)('re-renders when %s changes', (_label, mutation) => {
expect(areMessageRowPropsEqual(makeProps(), makeProps(mutation))).toBe(false);
});
it('re-renders when only a message field changes (delegates to areMessageFieldsEqual)', () => {
expect(
areMessageRowPropsEqual(
makeProps(),
makeProps({ message: makeFieldsMsg({ text: 'edited' }) }),
),
).toBe(false);
});
});
describe('isSameTailRelation', () => {
const tailProps = (
messageId: string,
depth: number,
latestMessageId: string | undefined,
latestMessageDepth: number | undefined,
) => ({
message: makeMessage({ messageId, depth }),
latestMessageId,
latestMessageDepth,
});
it('ignores a tail move that neither reaches nor leaves the row', () => {
expect(isSameTailRelation(tailProps('a', 1, 'b', 3), tailProps('a', 1, 'c_', 5))).toBe(true);
expect(isSameTailRelation(tailProps('a', 1, 'c_', 5), tailProps('a', 1, 'c', 5))).toBe(true);
});
it('re-renders the row the tail leaves', () => {
expect(isSameTailRelation(tailProps('b', 3, 'b', 3), tailProps('b', 3, 'c_', 5))).toBe(false);
});
it('re-renders the row the tail reaches', () => {
expect(isSameTailRelation(tailProps('c', 5, 'c_', 5), tailProps('c', 5, 'c', 5))).toBe(false);
});
it('re-renders when the tail depth reaches or leaves the row depth', () => {
expect(isSameTailRelation(tailProps('x', 3, 'b', 3), tailProps('x', 3, 'c', 5))).toBe(false);
});
it('re-renders when the tail becomes known or unknown', () => {
expect(isSameTailRelation(tailProps('a', 1, 'b', 3), tailProps('a', 1, undefined, 3))).toBe(
false,
);
});
});
describe('isSubmittableMessage', () => {
it('accepts non-whitespace text without files', () => {
expect(isSubmittableMessage('Hello')).toBe(true);
expect(isSubmittableMessage(' Hello ', 0)).toBe(true);
});
it('rejects an empty draft with no files', () => {
expect(isSubmittableMessage('')).toBe(false);
expect(isSubmittableMessage(' ')).toBe(false);
expect(isSubmittableMessage(undefined)).toBe(false);
expect(isSubmittableMessage(null)).toBe(false);
});
it('accepts an empty draft when files are attached', () => {
expect(isSubmittableMessage('', 1)).toBe(true);
expect(isSubmittableMessage(' ', 2)).toBe(true);
expect(isSubmittableMessage(undefined, 1)).toBe(true);
});
it('accepts text alongside files', () => {
expect(isSubmittableMessage('Translate this', 1)).toBe(true);
});
});
describe('createDualMessageContent', () => {
/** Custom endpoints carry their configured name (e.g. "Together AI") in
* `endpoint` at runtime, which `TConversation` types as `EModelEndpoint`. */
const asConvo = (convo: Partial<Omit<TConversation, 'endpoint'>> & { endpoint: string }) =>
convo as unknown as TConversation;
const agentIds = (parts: ReturnType<typeof createDualMessageContent>) =>
parts.map((part) => (part as unknown as { agentId: string }).agentId);
it('encodes the model spec label into ephemeral agent ids', () => {
const parts = createDualMessageContent(
asConvo({ endpoint: 'Together AI', model: 'Qwen/Qwen2.5-72B-Instruct', spec: 'fast-qwen' }),
asConvo({ endpoint: 'openAI', model: 'gpt-4o', modelLabel: 'My GPT' }),
undefined,
[{ name: 'fast-qwen', label: 'Fast Qwen' }],
);
expect(agentIds(parts)).toEqual([
'Together AI__Qwen/Qwen2.5-72B-Instruct___Fast Qwen',
'openAI__gpt-4o___My GPT____1',
]);
});
it('falls back to the endpoint modelDisplayLabel when no labels are set', () => {
const endpointsConfig = {
'Together AI': { modelDisplayLabel: 'Together' },
} as unknown as TEndpointsConfig;
const parts = createDualMessageContent(
asConvo({ endpoint: 'Together AI', model: 'mixtral-8x7b' }),
asConvo({ endpoint: 'Together AI', model: 'mixtral-8x7b' }),
endpointsConfig,
);
expect(agentIds(parts)).toEqual([
'Together AI__mixtral-8x7b___Together',
'Together AI__mixtral-8x7b___Together____1',
]);
});
it('omits the sender segment entirely when no label resolves', () => {
const parts = createDualMessageContent(
asConvo({ endpoint: 'Together AI', model: 'mixtral-8x7b' }),
asConvo({ endpoint: 'Together AI', model: 'mixtral-8x7b' }),
);
expect(agentIds(parts)).toEqual([
'Together AI__mixtral-8x7b',
'Together AI__mixtral-8x7b____1',
]);
});
it('passes real agent ids through, suffixing only the added agent', () => {
const parts = createDualMessageContent(
asConvo({ endpoint: 'agents', agent_id: 'agent_abc123' }),
asConvo({ endpoint: 'agents', agent_id: 'agent_abc123' }),
);
expect(agentIds(parts)).toEqual(['agent_abc123', 'agent_abc123____1']);
});
});