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 { useState, useRef, useEffect, useMemo, memo, useCallback } from 'react';
import { AutoSizer, List } from 'react-virtualized';
import { MentionItem } from '@librechat/chat/components';
import { useSetRecoilState, useRecoilValue } from 'recoil';
import { useInitPopoverInput } from '@librechat/chat/react';
import { Input, Spinner, useCombobox, useRemScale, useToastContext } from '@librechat/client';
import type { TPromptGroup } from 'librechat-data-provider';
import type { PromptOption } from '~/common';
import {
removeCharIfLast,
detectVariables,
isExternalPromptGroup,
getPromptResolveErrorMessage,
} from '~/utils';
import { activateCatalog, useLocalize, usePromptContentResolver } from '~/hooks';
import useChatScopedRequest from '~/hooks/Prompts/useChatScopedRequest';
import { useRecordPromptUsage } from '~/data-provider';
import { VariableDialog } from '~/components/Prompts';
import { usePromptGroupsContext } from '~/Providers';
import store from '~/store';
const commandChar = '/';
const PopoverContainer = memo(
({
index,
children,
isVariableDialogOpen,
variableGroup,
variableText,
setVariableDialogOpen,
textAreaRef,
}: {
index: number;
children: React.ReactNode;
isVariableDialogOpen: boolean;
variableGroup: TPromptGroup | null;
variableText: string | undefined;
setVariableDialogOpen: (isOpen: boolean) => void;
textAreaRef: React.MutableRefObject<HTMLTextAreaElement | null>;
}) => {
const showPromptsPopover = useRecoilValue(store.showPromptsPopoverFamily(index));
return (
<>
{showPromptsPopover ? children : null}
<VariableDialog
open={isVariableDialogOpen}
onClose={() => {
setVariableDialogOpen(false);
requestAnimationFrame(() => {
textAreaRef.current?.focus();
});
}}
group={variableGroup}
promptText={variableText}
/>
</>
);
},
);
const ROW_HEIGHT = 44;
function PromptsCommand({
index,
textAreaRef,
submitPrompt,
}: {
index: number;
textAreaRef: React.MutableRefObject<HTMLTextAreaElement | null>;
submitPrompt: (textPrompt: string) => void;
}) {
const localize = useLocalize();
const remScale = useRemScale();
const { showToast } = useToastContext();
const { mutate: recordUsage } = useRecordPromptUsage();
const resolvePromptContent = usePromptContentResolver();
const promptGroupsContext = usePromptGroupsContext();
const { allPromptGroups, hasAccess, requestAllPromptGroups } = promptGroupsContext ?? {};
const { data, isLoading } = allPromptGroups ?? {};
const showPromptsPopover = useRecoilValue(store.showPromptsPopoverFamily(index));
const [activeIndex, setActiveIndex] = useState(0);
const timeoutRef = useRef<NodeJS.Timeout | null>(null);
const inputRef = useRef<HTMLInputElement | null>(null);
const [isVariableDialogOpen, setVariableDialogOpen] = useState(false);
const [variableGroup, setVariableGroup] = useState<TPromptGroup | null>(null);
const [variableText, setVariableText] = useState<string | undefined>(undefined);
const setShowPromptsPopover = useSetRecoilState(store.showPromptsPopoverFamily(index));
/** A resolve that was started for one chat must not land on another; see
* `useChatScopedRequest` for the three cancellation keys. On cancel, a
* variable dialog opened from the stale read closes rather than
* surviving into the chat the user moved to. */
const { begin, isCurrent, isMounted } = useChatScopedRequest(index, () => {
setVariableDialogOpen(false);
});
const prompts = useMemo(() => data?.promptGroups, [data]);
const promptsMap = useMemo(() => data?.promptsMap, [data]);
const { open, setOpen, searchValue, setSearchValue, matches } = useCombobox({
value: '',
options: prompts ?? [],
});
const initInputRef = useInitPopoverInput({
inputRef,
textAreaRef,
commandChar,
setSearchValue,
setOpen,
});
const handleSelect = useCallback(
async (mention?: PromptOption, e?: React.KeyboardEvent<HTMLInputElement>) => {
if (!mention) {
return;
}
setSearchValue('');
setOpen(false);
setShowPromptsPopover(false);
if (textAreaRef.current) {
removeCharIfLast(textAreaRef.current, commandChar);
}
const group = promptsMap?.[mention.id];
if (!group) {
return;
}
const isLangfuse = isExternalPromptGroup(group);
/** Native resolution is synchronous, so the dialog-vs-submit split is already
* known here; a Langfuse group's content (and so its variables) is unknown
* until it resolves, so Tab's default focus move is held off either way. */
const hasKnownVariables =
!isLangfuse && detectVariables(group.productionPrompt?.prompt ?? '');
if (e && e.key === 'Tab' && (isLangfuse || hasKnownVariables)) {
e.preventDefault();
}
/** Supersedes a resolve still pending for a prior selection: `begin`
* bumps the token, so that request's own guard above now discards it
* instead of this one waiting behind it. */
const token = begin();
if (isLangfuse) {
showToast({ status: 'info', message: localize('com_ui_prompt_resolving') });
}
try {
const text = await resolvePromptContent(group);
/** The popover may have unmounted, or the active conversation may
* have changed, while the Langfuse resolve was in flight; a stale
* continuation must not submit, stage, or record for a chat the
* user left. */
if (!isMounted() || !isCurrent(token)) {
return;
}
if (!text?.trim()) {
textAreaRef.current?.focus();
return;
}
if (detectVariables(text)) {
setVariableGroup(group);
setVariableText(text);
setVariableDialogOpen(true);
return;
}
submitPrompt(text);
if (group._id) {
recordUsage(group._id);
}
textAreaRef.current?.focus();
} catch (error) {
if (isMounted() && isCurrent(token)) {
showToast({ status: 'error', message: getPromptResolveErrorMessage(error, localize) });
textAreaRef.current?.focus();
}
}
},
[
setSearchValue,
setOpen,
setShowPromptsPopover,
textAreaRef,
promptsMap,
submitPrompt,
recordUsage,
resolvePromptContent,
showToast,
localize,
begin,
isCurrent,
isMounted,
],
);
useEffect(() => {
if (!open) {
setActiveIndex(0);
setSearchValue('');
} else {
/** Opening the picker before background warmup starts the fetch now */
activateCatalog('prompts');
setVariableGroup(null);
setVariableText(undefined);
}
}, [open, setSearchValue]);
/** The full prompt list is fetched on first popover open, not at app startup */
useEffect(() => {
if (showPromptsPopover) {
requestAllPromptGroups?.();
}
}, [showPromptsPopover, requestAllPromptGroups]);
useEffect(() => {
setActiveIndex((prev) => Math.min(prev, Math.max(matches.length - 1, 0)));
}, [matches.length]);
useEffect(() => {
return () => {
if (timeoutRef.current) {
clearTimeout(timeoutRef.current);
}
};
}, []);
useEffect(() => {
const currentActiveItem = document.getElementById(`prompt-item-${activeIndex}`);
currentActiveItem?.scrollIntoView({ behavior: 'instant', block: 'nearest' });
}, [activeIndex]);
if (!hasAccess) {
return null;
}
const rowRenderer = ({
index,
key,
style,
}: {
index: number;
key: string;
style: React.CSSProperties;
}) => {
const mention = matches[index] as PromptOption;
return (
<MentionItem
index={index}
type="prompt"
key={key}
style={style}
onClick={() => {
if (timeoutRef.current) {
clearTimeout(timeoutRef.current);
}
timeoutRef.current = null;
handleSelect(mention);
}}
name={mention.label ?? ''}
icon={mention.icon}
description={mention.description}
isActive={index === activeIndex}
/>
);
};
return (
<PopoverContainer
index={index}
isVariableDialogOpen={isVariableDialogOpen}
variableGroup={variableGroup}
variableText={variableText}
setVariableDialogOpen={setVariableDialogOpen}
textAreaRef={textAreaRef}
>
<div className="absolute bottom-28 z-10 w-full space-y-2">
<div className="popover border-border-light bg-surface-tertiary-alt rounded-theme-popover border p-2 shadow-lg">
<Input
ref={initInputRef}
placeholder={localize('com_ui_command_usage_placeholder')}
variant="embedded"
className="mb-1"
autoComplete="off"
value={searchValue}
onKeyDown={(e) => {
if (e.key === 'Escape') {
setOpen(false);
setShowPromptsPopover(false);
textAreaRef.current?.focus();
}
if (e.key === 'ArrowDown') {
if (matches.length === 0) {
return;
}
setActiveIndex((prevIndex) => (prevIndex + 1) % matches.length);
} else if (e.key === 'ArrowUp') {
if (matches.length === 0) {
return;
}
setActiveIndex((prevIndex) => (prevIndex - 1 + matches.length) % matches.length);
} else if (e.key === 'Enter' || e.key === 'Tab') {
if (matches.length === 0) {
e.preventDefault();
setOpen(false);
setShowPromptsPopover(false);
textAreaRef.current?.focus();
return;
}
if (e.key === 'Enter') {
e.preventDefault();
}
handleSelect(matches[activeIndex] as PromptOption | undefined, e);
} else if (e.key === 'Backspace' && searchValue === '') {
setOpen(false);
setShowPromptsPopover(false);
textAreaRef.current?.focus();
}
}}
onChange={(e) => setSearchValue(e.target.value)}
onFocus={() => setOpen(true)}
onBlur={() => {
timeoutRef.current = setTimeout(() => {
setOpen(false);
setShowPromptsPopover(false);
}, 150);
}}
/>
{open && isLoading && matches.length === 0 && (
<div className="text-text-primary flex h-32 items-center justify-center">
<Spinner />
</div>
)}
{open && matches.length > 0 && (
<div className="max-h-40">
<AutoSizer disableHeight>
{({ width }) => (
<List
width={width}
overscanRowCount={5}
rowHeight={ROW_HEIGHT * remScale}
rowCount={matches.length}
rowRenderer={rowRenderer}
scrollToIndex={activeIndex}
height={Math.min(matches.length * ROW_HEIGHT, 160) * remScale}
/>
)}
</AutoSizer>
</div>
)}
</div>
</div>
</PopoverContainer>
);
}
export default memo(PromptsCommand);