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 { hasPermissions } from 'librechat-data-provider/react-query';
import { InfiniteCollections, QueryKeys, PermissionBits } from 'librechat-data-provider';
import type {
PromptGroupListResponse,
PromptGroupListData,
TPromptGroup,
} from 'librechat-data-provider';
import type { InfiniteData, QueryClient } from '@tanstack/react-query';
import {
addData,
deleteData,
updateData,
updateFields,
addToCacheList,
updateCacheList,
updateFieldsInPlace,
removeFromCacheList,
getRecordByProperty,
} from './collection';
export const addPromptGroup = (
data: InfiniteData<PromptGroupListResponse>,
newPromptGroup: TPromptGroup,
): PromptGroupListData => {
return addData<PromptGroupListResponse, TPromptGroup>(
data,
InfiniteCollections.PROMPT_GROUPS,
newPromptGroup,
(page) => page.promptGroups.findIndex((group) => group._id === newPromptGroup._id),
);
};
export const updatePromptGroup = (
data: InfiniteData<PromptGroupListResponse>,
updatedPromptGroup: TPromptGroup,
): PromptGroupListData => {
return updateData<PromptGroupListResponse, TPromptGroup>(
data,
InfiniteCollections.PROMPT_GROUPS,
updatedPromptGroup,
(page) => page.promptGroups.findIndex((group) => group._id === updatedPromptGroup._id),
);
};
export const deletePromptGroup = (
data: InfiniteData<PromptGroupListResponse>,
groupId: string,
): PromptGroupListData => {
return deleteData<PromptGroupListResponse, PromptGroupListData>(
data,
InfiniteCollections.PROMPT_GROUPS,
(page) => page.promptGroups.findIndex((group) => group._id === groupId),
);
};
export const updateGroupFields = (
data: InfiniteData<PromptGroupListResponse>,
updatedGroup: Partial<TPromptGroup>,
callback?: (group: TPromptGroup) => void,
): InfiniteData<PromptGroupListResponse> => {
return updateFields<PromptGroupListResponse, TPromptGroup>(
data,
updatedGroup,
InfiniteCollections.PROMPT_GROUPS,
'_id',
callback,
);
};
export const updateGroupFieldsInPlace = (
data: InfiniteData<PromptGroupListResponse>,
updatedGroup: Partial<TPromptGroup>,
): InfiniteData<PromptGroupListResponse> => {
return updateFieldsInPlace<PromptGroupListResponse, TPromptGroup>(
data,
updatedGroup,
InfiniteCollections.PROMPT_GROUPS,
'_id',
);
};
/**
* A group is externally managed when its `source` is present and not `native`
* (e.g. `langfuse`). An older server predating the `source` field omits it, so
* a missing `source` is treated as native rather than external.
*/
export const isExternalPromptGroup = (
group?: { source?: TPromptGroup['source'] } | null,
): boolean => {
return group?.source != null && group.source !== 'native';
};
export interface PromptGroupPermissionFlags {
/** Group is externally managed (e.g. Langfuse) and read-only locally */
isExternal: boolean;
/** Caller can view the group */
canView: boolean;
/** Caller can modify the group's prompts, name, category, description or command */
canEdit: boolean;
/** Caller can delete the group entirely */
canDelete: boolean;
}
/**
* Single source of truth for per-prompt-group permission checks, derived from
* a group's source and its ACL bits. External groups (e.g. Langfuse) are
* always read-only locally regardless of ACL bits: `canEdit` and `canDelete`
* are forced false. Viewing is unaffected, since Langfuse owns the content
* but not who inside LibreChat may see it.
*/
export const getPromptGroupPermissions = (
group: { source?: TPromptGroup['source'] } | null | undefined,
permissionBits: number,
): PromptGroupPermissionFlags => {
const isExternal = isExternalPromptGroup(group);
return {
isExternal,
canView: hasPermissions(permissionBits, PermissionBits.VIEW),
canEdit: !isExternal && hasPermissions(permissionBits, PermissionBits.EDIT),
canDelete: !isExternal && hasPermissions(permissionBits, PermissionBits.DELETE),
};
};
export const findPromptGroup = (
data: InfiniteData<PromptGroupListResponse>,
findProperty: (group: TPromptGroup) => boolean,
): TPromptGroup | undefined => {
return getRecordByProperty<PromptGroupListResponse, TPromptGroup>(
data,
InfiniteCollections.PROMPT_GROUPS,
findProperty,
);
};
const restartUnresolvedAllPromptGroups = (
queryClient: QueryClient,
queryKey: string[],
): boolean => {
const state = queryClient.getQueryState(queryKey);
/**
* An idle, never-fetched list must not be seeded partial; its first fetch
* includes the mutation. A first fetch already in flight may have read the
* database before the mutation and settle stale (invalidating alone does not
* cancel a data-less fetch in React Query v4), and an errored fetch never
* retries on its own because retry and refetch triggers are off.
*/
if (!state || state.data === undefined) {
if (state && (state.fetchStatus === 'fetching' || state.status === 'error')) {
void queryClient.cancelQueries(queryKey).then(() => queryClient.invalidateQueries(queryKey));
}
return true;
}
return false;
};
export const addGroupToAll = (queryClient: QueryClient, newGroup: TPromptGroup) => {
const queryKey = [QueryKeys.allPromptGroups];
if (restartUnresolvedAllPromptGroups(queryClient, queryKey)) {
return;
}
addToCacheList<TPromptGroup>(queryClient, queryKey, newGroup);
};
export const updateGroupInAll = (
queryClient: QueryClient,
updatedGroup: Partial<TPromptGroup> & { _id: string },
) => {
const queryKey = [QueryKeys.allPromptGroups];
if (restartUnresolvedAllPromptGroups(queryClient, queryKey)) {
return;
}
updateCacheList<TPromptGroup>({
queryClient,
queryKey,
searchProperty: '_id',
updateData: updatedGroup,
searchValue: updatedGroup._id,
});
};
export const removeGroupFromAll = (queryClient: QueryClient, groupId: string) => {
const queryKey = [QueryKeys.allPromptGroups];
if (restartUnresolvedAllPromptGroups(queryClient, queryKey)) {
return;
}
removeFromCacheList<TPromptGroup>(queryClient, queryKey, '_id', groupId);
};