feat(notifications): support copilot agent session (#3384)

* feat(notifications): support copilot agent session

Signed-off-by: Adam Setch <adam.setch@outlook.com>

* feat(notifications): support copilot agent session

Signed-off-by: Adam Setch <adam.setch@outlook.com>

* fix(sonar): build agent session url with URL builder (typescript:S8786)

---------

Signed-off-by: Adam Setch <adam.setch@outlook.com>

Author: setchy

src/renderer/__mocks__/notifications-mocks.ts

@@ -1,4 +1,10 @@
-import { GitPullRequestIcon, IssueOpenedIcon, TagIcon } from '@primer/octicons-react';
+import {
+  AgentIcon,
+  CopilotIcon,
+  GitPullRequestIcon,
+  IssueOpenedIcon,
+  TagIcon,
+} from '@primer/octicons-react';
 
 import {
   type AccountNotifications,
@@ -217,6 +223,43 @@ export const mockGithubEnterpriseGitifyNotifications: GitifyNotification[] = [
 
 export const mockGitifyNotification: GitifyNotification = mockGitHubCloudGitifyNotifications[0];
 
+/**
+ * Mock Gitify Notification for a GitHub Copilot cloud agent session.
+ *
+ * Subject type `AgentSessionThread`, reason `agent_session_finished`. The actor
+ * is Copilot, surfaced through the handler's actor icon and `Bot` user type.
+ */
+export const mockAgentSessionGitifyNotification: GitifyNotification = {
+  account: mockGitHubCloudAccount,
+  order: 0,
+  id: '26096167998',
+  unread: true,
+  reason: {
+    code: 'agent_session_finished',
+    title: 'Agent Session Finished',
+    description: 'A GitHub Copilot cloud agent session finished running.',
+  },
+  updatedAt: '2026-10-05T02:34:59Z',
+  subject: {
+    title: 'Analyzing and fixing GitHub Actions job failure',
+    url: null,
+    latestCommentUrl: null,
+    type: 'AgentSessionThread',
+  },
+  repository: mockGitHubRepository,
+  display: {
+    number: '',
+    title: 'Analyzing and fixing GitHub Actions job failure',
+    type: 'Agent Session Thread',
+    icon: {
+      type: AgentIcon,
+      color: IconColor.GRAY,
+    },
+    defaultUserType: 'Bot',
+    defaultUserIcon: CopilotIcon,
+  },
+};
+
 /** Same shape as cloud notification, but bound to a Gitea account. */
 export const mockGiteaGitifyNotification: GitifyNotification = {
   ...mockGitifyNotification,

src/renderer/components/avatars/AvatarWithFallback.test.tsx

@@ -1,5 +1,7 @@
 import { fireEvent, screen } from '@testing-library/react';
 
+import { CopilotIcon } from '@primer/octicons-react';
+
 import { renderWithProviders } from '../../__helpers__/test-utils';
 
 import { type Link, Size } from '../../types';
@@ -39,6 +41,14 @@ describe('renderer/components/avatars/AvatarWithFallback.tsx', () => {
     expect(tree.container).toMatchSnapshot();
   });
 
+  it('renders a provided fallback icon override', () => {
+    const tree = renderWithProviders(
+      <AvatarWithFallback {...props} icon={CopilotIcon} src={undefined} />,
+    );
+
+    expect(tree.container).toMatchSnapshot();
+  });
+
   it('renders the fallback icon when the image fails to load (isBroken = true) - human user', () => {
     renderWithProviders(<AvatarWithFallback {...props} />);
 

src/renderer/components/avatars/AvatarWithFallback.tsx

@@ -1,6 +1,8 @@
 import type React from 'react';
+import type { FC } from 'react';
 import { createElement, useState } from 'react';
 
+import type { OcticonProps } from '@primer/octicons-react';
 import { Avatar, Stack, Truncate } from '@primer/react';
 
 import { type Link, Size, type UserType } from '../../types';
@@ -14,6 +16,8 @@ export interface AvatarWithFallbackProps {
   name?: string;
   size?: number;
   userType?: UserType;
+  /** Optional fallback icon overriding the user-type default. */
+  icon?: FC<OcticonProps>;
 }
 
 export const AvatarWithFallback: React.FC<AvatarWithFallbackProps> = ({
@@ -22,11 +26,12 @@ export const AvatarWithFallback: React.FC<AvatarWithFallbackProps> = ({
   name,
   size = Size.MEDIUM,
   userType = 'User',
+  icon,
 }) => {
   const [hasBrokenAvatarSource, setHasBrokenAvatarSource] = useState(false);
 
   const isNonHuman = isNonHumanUser(userType);
-  const defaultUserIcon = getDefaultUserIcon(userType);
+  const defaultUserIcon = icon ?? getDefaultUserIcon(userType);
 
   // TODO explore using AnchoredOverlay component (https://primer.style/components/anchored-overlay/react/alpha) to render Avatar Card on hover
   return (

src/renderer/components/avatars/__snapshots__/AvatarWithFallback.test.tsx.snap

@@ -2,7 +2,10 @@ import { screen } from '@testing-library/react';
 import userEvent from '@testing-library/user-event';
 
 import { renderWithProviders } from '../../__helpers__/test-utils';
-import { mockGitifyNotification } from '../../__mocks__/notifications-mocks';
+import {
+  mockAgentSessionGitifyNotification,
+  mockGitifyNotification,
+} from '../../__mocks__/notifications-mocks';
 
 import type { GitifyNotificationUser, Link } from '../../types';
 
@@ -63,6 +66,17 @@ describe('renderer/components/notifications/NotificationFooter.tsx', () => {
     expect(tree.container).toMatchSnapshot();
   });
 
+  it('presents the Copilot actor for an agent session notification', () => {
+    const tree = renderWithProviders(
+      <NotificationFooter notification={mockAgentSessionGitifyNotification} />,
+    );
+
+    expect(tree.container).toMatchSnapshot();
+    // Agent sessions have no enriched actor, so no profile button is rendered.
+    expect(screen.queryByTestId('view-profile')).not.toBeInTheDocument();
+    expect(screen.getByText('Agent Session Finished')).toBeInTheDocument();
+  });
+
   it('should open notification user profile', async () => {
     const openExternalLinkSpy = vi.spyOn(comms, 'openExternalLink').mockImplementation(vi.fn());
 

src/renderer/components/filters/__snapshots__/ReasonFilter.test.tsx.snap

@@ -50,7 +50,11 @@ export const NotificationFooter: FC<NotificationFooterProps> = ({
           />
         </button>
       ) : (
-        <AvatarWithFallback size={Size.SMALL} userType={notification.display.defaultUserType} />
+        <AvatarWithFallback
+          icon={notification.display.defaultUserIcon}
+          size={Size.SMALL}
+          userType={notification.display.defaultUserType}
+        />
       )}
 
       <Stack direction="horizontal" gap="none">