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 { Types } from 'mongoose';
import {
ResourceType,
PrincipalType,
PermissionBits,
AccessRoleIds,
} from 'librechat-data-provider';
import { SYSTEM_TENANT_ID, getTenantId, permissionBitSupersets } from '@librechat/data-schemas';
import type { PipelineStage, AnyBulkWriteOperation } from 'mongoose';
export interface Principal {
type: string;
id: string;
name: string;
email?: string;
avatar?: string;
source?: string;
idOnTheSource?: string;
accessRoleId: string;
isImplicit?: boolean;
}
export interface EnricherDependencies {
aggregateAclEntries: (pipeline: PipelineStage[]) => Promise<Record<string, unknown>[]>;
bulkWriteAclEntries: (
ops: AnyBulkWriteOperation[],
options?: Record<string, unknown>,
) => Promise<unknown>;
findRoleByIdentifier: (
accessRoleId: string,
) => Promise<{ _id: Types.ObjectId; permBits: number } | null>;
logger: { error: (msg: string, ...args: unknown[]) => void };
}
export interface EnrichResult {
principals: Principal[];
entriesToBackfill: Types.ObjectId[];
}
function matchesCurrentTenant(principal: Record<string, unknown>, tenantId?: string): boolean {
if (!tenantId || tenantId === SYSTEM_TENANT_ID) {
return true;
}
return principal.tenantId === tenantId;
}
/** Enriches REMOTE_AGENT principals with implicit AGENT owners */
export async function enrichRemoteAgentPrincipals(
deps: EnricherDependencies,
resourceId: string | Types.ObjectId,
principals: Principal[],
): Promise<EnrichResult> {
const resourceObjectId =
typeof resourceId === 'string' && /^[a-f\d]{24}$/i.test(resourceId)
? Types.ObjectId.createFromHexString(resourceId)
: resourceId;
const tenantId = getTenantId();
/**
* Filter `permBits` with `$in: permissionBitSupersets(SHARE)` instead of
* `$bitsAllSet` for Cosmos DB for MongoDB compatibility. `$in` is indexable
* and, for the current 4-bit permission set, expands to at most 8 values.
*/
const agentOwnerEntries = await deps.aggregateAclEntries([
{
$match: {
resourceType: ResourceType.AGENT,
resourceId: resourceObjectId,
principalType: PrincipalType.USER,
permBits: { $in: permissionBitSupersets(PermissionBits.SHARE) },
},
},
{
$lookup: {
from: 'users',
localField: 'principalId',
foreignField: '_id',
as: 'userInfo',
},
},
{
$project: {
principalId: 1,
userInfo: { $arrayElemAt: ['$userInfo', 0] },
},
},
]);
const enrichedPrincipals = [...principals];
const entriesToBackfill: Types.ObjectId[] = [];
for (const entry of agentOwnerEntries) {
if (!entry.userInfo) {
continue;
}
const userInfo = entry.userInfo as Record<string, unknown>;
if (!matchesCurrentTenant(userInfo, tenantId)) {
continue;
}
const principalId = entry.principalId as Types.ObjectId;
const alreadyIncluded = enrichedPrincipals.some(
(p) => p.type === PrincipalType.USER && p.id === principalId.toString(),
);
if (!alreadyIncluded) {
enrichedPrincipals.unshift({
type: PrincipalType.USER,
id: (userInfo._id as Types.ObjectId).toString(),
name: (userInfo.name || userInfo.username) as string,
email: userInfo.email as string,
avatar: userInfo.avatar as string,
source: 'local',
idOnTheSource:
(userInfo.idOnTheSource as string) || (userInfo._id as Types.ObjectId).toString(),
accessRoleId: AccessRoleIds.REMOTE_AGENT_OWNER,
isImplicit: true,
});
entriesToBackfill.push(principalId);
}
}
return { principals: enrichedPrincipals, entriesToBackfill };
}
/** Backfills REMOTE_AGENT ACL entries for AGENT owners (fire-and-forget) */
export function backfillRemoteAgentPermissions(
deps: EnricherDependencies,
resourceId: string | Types.ObjectId,
entriesToBackfill: Types.ObjectId[],
): void {
if (entriesToBackfill.length === 0) {
return;
}
const { logger } = deps;
const resourceObjectId =
typeof resourceId === 'string' && /^[a-f\d]{24}$/i.test(resourceId)
? Types.ObjectId.createFromHexString(resourceId)
: resourceId;
deps
.findRoleByIdentifier(AccessRoleIds.REMOTE_AGENT_OWNER)
.then((role) => {
if (!role) {
logger.error('[backfillRemoteAgentPermissions] REMOTE_AGENT_OWNER role not found');
return;
}
const bulkOps = entriesToBackfill.map((principalId) => ({
updateOne: {
filter: {
principalType: PrincipalType.USER,
principalId,
resourceType: ResourceType.REMOTE_AGENT,
resourceId: resourceObjectId,
},
update: {
$setOnInsert: {
principalType: PrincipalType.USER,
principalId,
principalModel: 'User',
resourceType: ResourceType.REMOTE_AGENT,
resourceId: resourceObjectId,
permBits: role.permBits,
roleId: role._id,
grantedBy: principalId,
grantedAt: new Date(),
},
},
upsert: true,
},
}));
return deps.bulkWriteAclEntries(bulkOps, { ordered: false });
})
.catch((err: unknown) => {
logger.error('[backfillRemoteAgentPermissions] Failed to backfill:', err);
});
}