🔐 feat: Granular Role-based Permissions + Entra ID Group Discovery (#7804)

WIP: pre-granular-permissions commit

feat: Add category and support contact fields to Agent schema and UI components

Revert "feat: Add category and support contact fields to Agent schema and UI components"

This reverts commit c43a52b4c9.

Fix: Update import for renderHook in useAgentCategories.spec.tsx

fix: Update icon rendering in AgentCategoryDisplay tests to use empty spans

refactor: Improve category synchronization logic and clean up AgentConfig component

refactor: Remove unused UI flow translations from translation.json

feat: agent marketplace features

🔐 feat: Granular Role-based Permissions + Entra ID Group Discovery (#7804)

client/src/utils/__tests__/agents.spec.tsx

@@ -0,0 +1,178 @@
+import React from 'react';
+import { render, screen } from '@testing-library/react';
+import '@testing-library/jest-dom';
+import { getAgentAvatarUrl, renderAgentAvatar, getContactDisplayName } from '../agents';
+import type t from 'librechat-data-provider';
+
+// Mock the Bot icon from lucide-react
+jest.mock('lucide-react', () => ({
+  Bot: ({ className, strokeWidth, ...props }: any) => (
+    <svg data-testid="bot-icon" className={className} data-stroke-width={strokeWidth} {...props}>
+      <title>{/* eslint-disable-line i18next/no-literal-string */}Bot Icon</title>
+    </svg>
+  ),
+}));
+
+describe('Agent Utilities', () => {
+  describe('getAgentAvatarUrl', () => {
+    it('should return null for null agent', () => {
+      expect(getAgentAvatarUrl(null)).toBeNull();
+    });
+
+    it('should return null for undefined agent', () => {
+      expect(getAgentAvatarUrl(undefined)).toBeNull();
+    });
+
+    it('should return null for agent without avatar', () => {
+      const agent = { id: '1', name: 'Test Agent' } as t.Agent;
+      expect(getAgentAvatarUrl(agent)).toBeNull();
+    });
+
+    it('should return string avatar directly', () => {
+      const agent = {
+        id: '1',
+        name: 'Test Agent',
+        avatar: '/path/to/avatar.png',
+      } as t.Agent;
+      expect(getAgentAvatarUrl(agent)).toBe('/path/to/avatar.png');
+    });
+
+    it('should extract filepath from object avatar', () => {
+      const agent = {
+        id: '1',
+        name: 'Test Agent',
+        avatar: { filepath: '/path/to/object-avatar.png' },
+      } as t.Agent;
+      expect(getAgentAvatarUrl(agent)).toBe('/path/to/object-avatar.png');
+    });
+
+    it('should return null for object avatar without filepath', () => {
+      const agent = {
+        id: '1',
+        name: 'Test Agent',
+        avatar: { someOtherProperty: 'value' },
+      } as any;
+      expect(getAgentAvatarUrl(agent)).toBeNull();
+    });
+  });
+
+  describe('renderAgentAvatar', () => {
+    it('should render image when avatar URL exists', () => {
+      const agent = {
+        id: '1',
+        name: 'Test Agent',
+        avatar: '/test-avatar.png',
+      } as t.Agent;
+
+      render(<div>{renderAgentAvatar(agent)}</div>);
+
+      const img = screen.getByAltText('Test Agent avatar');
+      expect(img).toBeInTheDocument();
+      expect(img).toHaveAttribute('src', '/test-avatar.png');
+      expect(img).toHaveClass('rounded-full', 'object-cover', 'shadow-lg');
+    });
+
+    it('should render Bot icon fallback when no avatar', () => {
+      const agent = {
+        id: '1',
+        name: 'Test Agent',
+      } as t.Agent;
+
+      render(<div>{renderAgentAvatar(agent)}</div>);
+
+      const botIcon = screen.getByTestId('bot-icon');
+      expect(botIcon).toBeInTheDocument();
+      expect(botIcon).toHaveAttribute('data-stroke-width', '1.5');
+    });
+
+    it('should apply different size classes', () => {
+      const agent = {
+        id: '1',
+        name: 'Test Agent',
+        avatar: '/test-avatar.png',
+      } as t.Agent;
+
+      const { rerender } = render(<div>{renderAgentAvatar(agent, { size: 'sm' })}</div>);
+      expect(screen.getByAltText('Test Agent avatar')).toHaveClass('h-12', 'w-12');
+
+      rerender(<div>{renderAgentAvatar(agent, { size: 'lg' })}</div>);
+      expect(screen.getByAltText('Test Agent avatar')).toHaveClass('h-20', 'w-20');
+
+      rerender(<div>{renderAgentAvatar(agent, { size: 'xl' })}</div>);
+      expect(screen.getByAltText('Test Agent avatar')).toHaveClass('h-24', 'w-24');
+    });
+
+    it('should apply custom className', () => {
+      const agent = {
+        id: '1',
+        name: 'Test Agent',
+        avatar: '/test-avatar.png',
+      } as t.Agent;
+
+      render(<div>{renderAgentAvatar(agent, { className: 'custom-class' })}</div>);
+
+      const container = screen.getByAltText('Test Agent avatar').parentElement;
+      expect(container).toHaveClass('custom-class');
+    });
+
+    it('should handle showBorder option', () => {
+      const agent = {
+        id: '1',
+        name: 'Test Agent',
+        avatar: '/test-avatar.png',
+      } as t.Agent;
+
+      const { rerender } = render(<div>{renderAgentAvatar(agent, { showBorder: true })}</div>);
+      expect(screen.getByAltText('Test Agent avatar')).toHaveClass('border-2');
+
+      rerender(<div>{renderAgentAvatar(agent, { showBorder: false })}</div>);
+      expect(screen.getByAltText('Test Agent avatar')).not.toHaveClass('border-2');
+    });
+  });
+
+  describe('getContactDisplayName', () => {
+    it('should return null for null agent', () => {
+      expect(getContactDisplayName(null)).toBeNull();
+    });
+
+    it('should return null for undefined agent', () => {
+      expect(getContactDisplayName(undefined)).toBeNull();
+    });
+
+    it('should prioritize support_contact name', () => {
+      const agent = {
+        id: '1',
+        support_contact: { name: 'Support Team', email: 'support@example.com' },
+        authorName: 'John Doe',
+      } as any;
+      expect(getContactDisplayName(agent)).toBe('Support Team');
+    });
+
+    it('should use authorName when support_contact name is missing', () => {
+      const agent = {
+        id: '1',
+        support_contact: { email: 'support@example.com' },
+        authorName: 'John Doe',
+      } as any;
+      expect(getContactDisplayName(agent)).toBe('John Doe');
+    });
+
+    it('should use support_contact email when both name and authorName are missing', () => {
+      const agent = {
+        id: '1',
+        support_contact: { email: 'support@example.com' },
+      } as any;
+      expect(getContactDisplayName(agent)).toBe('support@example.com');
+    });
+
+    it('should return null when no contact info is available', () => {
+      const agent = {
+        id: '1',
+        name: 'Test Agent',
+      } as any;
+      expect(getContactDisplayName(agent)).toBeNull();
+    });
+  });
+
+  // Tests for hardcoded category functions removed - now using database-driven categories
+});