Skip to content

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.

fix(frontend): fall back gracefully when an avatar or listing image URL is dead (#14493)

Reinier van der Leer5abe8501b19c
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/MarketplaceAgentBlock.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/MarketplaceAgentBlock.tsx
index 6542e5479d..ba772ad285 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/MarketplaceAgentBlock.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/MarketplaceAgentBlock.tsx
@@ -12,6 +12,7 @@ import {
PlusSignIcon,
} from "@hugeicons/core-free-icons";
import { Icon } from "@/components/atoms/Icon/Icon";
+import { useImageFallback } from "@/hooks/useImageFallback";
interface Props extends ButtonHTMLAttributes<HTMLButtonElement> {
title?: string;
@@ -38,6 +39,8 @@ export const MarketplaceAgentBlock: MarketplaceAgentBlockComponent = ({
slug,
...rest
}) => {
+ const { showImage, handleImageError } = useImageFallback(image_url);
+
return (
<Button
className={cn(
@@ -48,7 +51,7 @@ export const MarketplaceAgentBlock: MarketplaceAgentBlockComponent = ({
{...rest}
>
<div className="relative h-[3.125rem] w-[5.625rem] overflow-hidden rounded-[0.375rem] bg-white">
- {image_url && (
+ {showImage && image_url && (
<Image
src={image_url}
unoptimized={isLocalStoreMediaUrl(image_url)}
@@ -56,6 +59,7 @@ export const MarketplaceAgentBlock: MarketplaceAgentBlockComponent = ({
fill
sizes="5.625rem"
className="w-full object-contain group-disabled:opacity-50"
+ onError={handleImageError}
/>
)}
</div>
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/UGCAgentBlock.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/UGCAgentBlock.tsx
index e2e9605407..89d6e95bb6 100644
--- a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/UGCAgentBlock.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/UGCAgentBlock.tsx
@@ -8,6 +8,7 @@ import { highlightText } from "./helpers";
import { formatTimeAgo } from "@/lib/utils/time";
import { Loading03Icon, PlusSignIcon } from "@hugeicons/core-free-icons";
import { Icon } from "@/components/atoms/Icon/Icon";
+import { useImageFallback } from "@/hooks/useImageFallback";
interface Props extends ButtonHTMLAttributes<HTMLButtonElement> {
isLoading?: boolean;
@@ -32,6 +33,8 @@ export const UGCAgentBlock: UGCAgentBlockComponent = ({
highlightedText,
...rest
}) => {
+ const { showImage, handleImageError } = useImageFallback(image_url);
+
return (
<Button
className={cn(
@@ -41,7 +44,7 @@ export const UGCAgentBlock: UGCAgentBlockComponent = ({
)}
{...rest}
>
- {image_url && (
+ {showImage && image_url && (
<div className="relative h-[3.125rem] w-[5.625rem] overflow-hidden rounded-[0.375rem] bg-white">
<Image
src={image_url}
@@ -50,6 +53,7 @@ export const UGCAgentBlock: UGCAgentBlockComponent = ({
fill
sizes="5.625rem"
className="w-full object-contain group-disabled:opacity-50"
+ onError={handleImageError}
/>
</div>
)}
diff --git a/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/__tests__/agent-block-image-fallback.test.tsx b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/__tests__/agent-block-image-fallback.test.tsx
new file mode 100644
index 0000000000..a2453a6f3e
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/build/components/NewControlPanel/NewBlockMenu/__tests__/agent-block-image-fallback.test.tsx
@@ -0,0 +1,36 @@
+import { describe, expect, test } from "vitest";
+import { fireEvent, render, screen } from "@/tests/integrations/test-utils";
+
+import { MarketplaceAgentBlock } from "../MarketplaceAgentBlock";
+import { UGCAgentBlock } from "../UGCAgentBlock";
+
+describe("MarketplaceAgentBlock", () => {
+ test("drops a dead image URL and keeps the title", () => {
+ render(
+ <MarketplaceAgentBlock
+ title="Daily digest"
+ image_url="https://cdn.test/dead.png"
+ slug="digest"
+ loading={false}
+ />,
+ );
+
+ fireEvent.error(screen.getByAltText("integration-icon"));
+
+ expect(screen.queryByAltText("integration-icon")).toBeNull();
+ expect(screen.getByText("Daily digest")).toBeDefined();
+ });
+});
+
+describe("UGCAgentBlock", () => {
+ test("drops a dead image URL and keeps the title", () => {
+ render(
+ <UGCAgentBlock title="My agent" image_url="https://cdn.test/dead.png" />,
+ );
+
+ fireEvent.error(screen.getByAltText("integration-icon"));
+
+ expect(screen.queryByAltText("integration-icon")).toBeNull();
+ expect(screen.getByText("My agent")).toBeDefined();
+ });
+});
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/LibraryAgentCard.tsx b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/LibraryAgentCard.tsx
index 2864f5a7b7..f3d502c723 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/LibraryAgentCard.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/LibraryAgentCard.tsx
@@ -11,6 +11,7 @@ import { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
import { cn } from "@/lib/utils";
import { AgentCardMenu } from "./components/AgentCardMenu";
import { FavoriteButton } from "./components/FavoriteButton";
+import { useImageFallback } from "@/hooks/useImageFallback";
import { useLibraryAgentCard } from "./useLibraryAgentCard";
import { useFavoriteAnimation } from "../../context/FavoriteAnimationContext";
import { StatusBadge } from "../StatusBadge/StatusBadge";
@@ -36,6 +37,7 @@ export function LibraryAgentCard({
draggable = true,
}: Props) {
const { id, name, image_url } = agent;
+ const { showImage, handleImageError } = useImageFallback(image_url);
const router = useRouter();
const { triggerFavoriteAnimation } = useFavoriteAnimation();
@@ -100,7 +102,7 @@ export function LibraryAgentCard({
{name}
</Text>
- {!image_url ? (
+ {!showImage || !image_url ? (
<div
className={`h-[3.64rem] w-[6.70rem] flex-shrink-0 rounded-small ${
[
@@ -124,6 +126,7 @@ export function LibraryAgentCard({
width={107}
height={58}
className="flex-shrink-0 rounded-small object-cover"
+ onError={handleImageError}
/>
)}
</NextLink>
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/__tests__/LibraryAgentCard.test.tsx b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/__tests__/LibraryAgentCard.test.tsx
new file mode 100644
index 0000000000..af29cad1d7
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/LibraryAgentCard/__tests__/LibraryAgentCard.test.tsx
@@ -0,0 +1,51 @@
+import { describe, expect, test } from "vitest";
+import { fireEvent, render, screen } from "@/tests/integrations/test-utils";
+
+import { LibraryAgentCard } from "../LibraryAgentCard";
+import { FavoriteAnimationProvider } from "../../../context/FavoriteAnimationContext";
+import type { LibraryAgent } from "@/app/api/__generated__/models/libraryAgent";
+import type { AgentStatusInfo } from "../../../types";
+
+const AGENT = {
+ id: "4f6b2c1e-0000-4000-8000-000000000001",
+ name: "Daily digest",
+ image_url: "https://cdn.test/agent.png",
+ is_favorite: false,
+} as unknown as LibraryAgent;
+
+const STATUS: AgentStatusInfo = {
+ status: "idle",
+ health: "good",
+ progress: null,
+ totalRuns: 3,
+ lastRunAt: null,
+ lastError: null,
+ activeExecutionID: null,
+ monthlySpend: 0,
+ nextScheduledRun: null,
+ triggerType: null,
+};
+
+function renderCard() {
+ return render(
+ <FavoriteAnimationProvider>
+ <LibraryAgentCard agent={AGENT} statusInfo={STATUS} />
+ </FavoriteAnimationProvider>,
+ );
+}
+
+describe("LibraryAgentCard", () => {
+ test("renders the agent image while the URL loads", () => {
+ renderCard();
+ expect(screen.getByAltText("Daily digest preview image")).toBeDefined();
+ });
+
+ test("falls back to the gradient tile when the image URL is dead", () => {
+ renderCard();
+
+ fireEvent.error(screen.getByAltText("Daily digest preview image"));
+
+ expect(screen.queryByAltText("Daily digest preview image")).toBeNull();
+ expect(screen.getByText("Daily digest")).toBeDefined();
+ });
+});
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/SitrepItem/SitrepItem.tsx b/autogpt_platform/frontend/src/app/(platform)/library/components/SitrepItem/SitrepItem.tsx
index d4205eea4c..3c20a19c40 100644
--- a/autogpt_platform/frontend/src/app/(platform)/library/components/SitrepItem/SitrepItem.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/SitrepItem/SitrepItem.tsx
@@ -21,6 +21,7 @@ import {
} from "@hugeicons/core-free-icons";
import type { IconSvgElement } from "@hugeicons/react";
import { Icon } from "@/components/atoms/Icon/Icon";
+import { useImageFallback } from "@/hooks/useImageFallback";
interface Props {
item: SitrepItemData;
@@ -74,6 +75,7 @@ const PRIORITY_CONFIG: Record<
export function SitrepItem({ item }: Props) {
const config = PRIORITY_CONFIG[item.priority];
+ const { showImage, handleImageError } = useImageFallback(item.agentImageUrl);
const router = useRouter();
function handleAskAutoPilot() {
@@ -89,11 +91,12 @@ export function SitrepItem({ item }: Props) {
)}
>
<div className="flex min-w-0 flex-1 items-center gap-3">
- {item.agentImageUrl ? (
+ {showImage && item.agentImageUrl ? (
<img
src={item.agentImageUrl}
alt={item.agentName}
className="h-6 w-6 flex-shrink-0 rounded-full object-cover"
+ onError={handleImageError}
/>
) : (
<div
diff --git a/autogpt_platform/frontend/src/app/(platform)/library/components/SitrepItem/__tests__/SitrepItem.test.tsx b/autogpt_platform/frontend/src/app/(platform)/library/components/SitrepItem/__tests__/SitrepItem.test.tsx
new file mode 100644
index 0000000000..a0ae9e9d0d
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/library/components/SitrepItem/__tests__/SitrepItem.test.tsx
@@ -0,0 +1,31 @@
+import { describe, expect, test } from "vitest";
+import { fireEvent, render, screen } from "@/tests/integrations/test-utils";
+
+import { SitrepItem } from "../SitrepItem";
+import type { SitrepItemData } from "../../../types";
+
+const ITEM: SitrepItemData = {
+ id: "run-1",
+ agentID: "agent-1",
+ agentName: "Daily digest",
+ agentImageUrl: "https://cdn.test/agent.png",
+ priority: "success",
+ message: "Finished a run",
+ status: "healthy" as SitrepItemData["status"],
+};
+
+describe("SitrepItem", () => {
+ test("renders the agent image while the URL loads", () => {
+ render(<SitrepItem item={ITEM} />);
+ expect(screen.getByAltText("Daily digest")).toBeDefined();
+ });
+
+ test("falls back to the priority icon when the image URL is dead", () => {
+ render(<SitrepItem item={ITEM} />);
+
+ fireEvent.error(screen.getByAltText("Daily digest"));
+
+ expect(screen.queryByAltText("Daily digest")).toBeNull();
+ expect(screen.getByText("Daily digest")).toBeDefined();
+ });
+});
diff --git a/autogpt_platform/frontend/src/app/(platform)/marketplace/components/AgentImageItem/AgentImageItem.tsx b/autogpt_platform/frontend/src/app/(platform)/marketplace/components/AgentImageItem/AgentImageItem.tsx
index de7fb19268..0b13c7868b 100644
--- a/autogpt_platform/frontend/src/app/(platform)/marketplace/components/AgentImageItem/AgentImageItem.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/marketplace/components/AgentImageItem/AgentImageItem.tsx
@@ -9,8 +9,9 @@ import {
isValidVideoUrl,
} from "./helpers";
import { useAgentImageItem } from "./useAgentImageItem";
-import { PlayIcon } from "@hugeicons/core-free-icons";
+import { ImageNotFound01Icon, PlayIcon } from "@hugeicons/core-free-icons";
import { Icon } from "@/components/atoms/Icon/Icon";
+import { useImageFallback } from "@/hooks/useImageFallback";
interface AgentImageItemProps {
image: string;
@@ -30,6 +31,7 @@ export function AgentImageItem({
const { videoRef } = useAgentImageItem({ playingVideoIndex, index });
const isVideoFile = isValidVideoFile(image);
const [imageLoaded, setImageLoaded] = useState(false);
+ const { showImage, handleImageError } = useImageFallback(image);
useEffect(() => {
setImageLoaded(false);
@@ -69,19 +71,30 @@ export function AgentImageItem({
)
) : (
<div className="relative h-full w-full">
- {!imageLoaded && (
- <Skeleton className="absolute inset-0 rounded-xl" />
+ {showImage ? (
+ <>
+ {!imageLoaded && (
+ <Skeleton className="absolute inset-0 rounded-xl" />
+ )}
+ <Image
+ src={image}
+ unoptimized={isLocalStoreMediaUrl(image)}
+ alt="Image"
+ fill
+ sizes="(max-width: 768px) 100vw, (max-width: 1200px) 50vw, 33vw"
+ className="rounded-xl object-cover"
+ onLoad={() => setImageLoaded(true)}
+ onError={handleImageError}
+ />
+ </>
+ ) : (
+ <div className="flex h-full w-full items-center justify-center rounded-xl bg-zinc-100">
+ <Icon
+ icon={ImageNotFound01Icon}
+ className="h-10 w-10 text-zinc-400"
+ />
+ </div>
)}
- <Image
- src={image}
- unoptimized={isLocalStoreMediaUrl(image)}
- alt="Image"
- fill
- sizes="(max-width: 768px) 100vw, (max-width: 1200px) 50vw, 33vw"
- className="rounded-xl object-cover"
- onLoad={() => setImageLoaded(true)}
- onError={() => setImageLoaded(true)}
- />
</div>
)}
</div>
diff --git a/autogpt_platform/frontend/src/app/(platform)/marketplace/components/AgentImageItem/__tests__/AgentImageItem.test.tsx b/autogpt_platform/frontend/src/app/(platform)/marketplace/components/AgentImageItem/__tests__/AgentImageItem.test.tsx
new file mode 100644
index 0000000000..4523b48bf9
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/marketplace/components/AgentImageItem/__tests__/AgentImageItem.test.tsx
@@ -0,0 +1,32 @@
+import { describe, expect, test } from "vitest";
+import { fireEvent, render, screen } from "@/tests/integrations/test-utils";
+
+import { AgentImageItem } from "../AgentImageItem";
+
+function renderItem(image: string) {
+ return render(
+ <AgentImageItem
+ image={image}
+ index={0}
+ playingVideoIndex={null}
+ handlePlay={() => {}}
+ handlePause={() => {}}
+ />,
+ );
+}
+
+describe("AgentImageItem", () => {
+ test("renders the preview image while the URL loads", () => {
+ renderItem("https://cdn.test/preview.png");
+ expect(screen.getByAltText("Image")).toBeDefined();
+ });
+
+ test("replaces a dead preview URL with a placeholder", () => {
+ const { container } = renderItem("https://cdn.test/dead.png");
+
+ fireEvent.error(screen.getByAltText("Image"));
+
+ expect(screen.queryByAltText("Image")).toBeNull();
+ expect(container.querySelector("svg")).not.toBeNull();
+ });
+});
diff --git a/autogpt_platform/frontend/src/app/(platform)/marketplace/components/AgentImages/AgentImage.tsx b/autogpt_platform/frontend/src/app/(platform)/marketplace/components/AgentImages/AgentImage.tsx
index 55f970d45b..b11b971d44 100644
--- a/autogpt_platform/frontend/src/app/(platform)/marketplace/components/AgentImages/AgentImage.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/marketplace/components/AgentImages/AgentImage.tsx
@@ -1,6 +1,8 @@
"use client";
import { Skeleton } from "@/components/atoms/Skeleton/Skeleton";
+import { Icon } from "@/components/atoms/Icon/Icon";
+import { ImageNotFound01Icon } from "@hugeicons/core-free-icons";
import { cn } from "@/lib/utils";
import { useEffect, useState } from "react";
import { AgentImageItem } from "../AgentImageItem/AgentImageItem";
@@ -15,6 +17,12 @@ export function AgentImages({ images }: AgentImagesProps) {
const { playingVideoIndex, handlePlay, handlePause } = useAgentImage();
const [selectedIndex, setSelectedIndex] = useState(0);
const [loadedThumbs, setLoadedThumbs] = useState<Set<number>>(new Set());
+ // Keyed by URL: the component stays mounted when a listing's images change.
+ const [failedThumbs, setFailedThumbs] = useState<Set<string>>(new Set());
+
+ function markThumbFailed(url: string) {
+ setFailedThumbs((prev) => new Set(prev).add(url));
+ }
useEffect(() => {
setSelectedIndex((prev) => Math.max(0, Math.min(prev, images.length - 1)));
@@ -39,6 +47,10 @@ export function AgentImages({ images }: AgentImagesProps) {
{images.map((image, index) => {
const isVideo = isValidVideoUrl(image);
const youtubeId = isVideo ? getYouTubeVideoId(image) : null;
+ const thumbnailUrl = youtubeId
+ ? `https://img.youtube.com/vi/${youtubeId}/mqdefault.jpg`
+ : image;
+ const thumbnailFailed = failedThumbs.has(thumbnailUrl);
return (
<button
@@ -52,18 +64,28 @@ export function AgentImages({ images }: AgentImagesProps) {
: "border-zinc-100 opacity-70 hover:opacity-100",
)}
>
- {(!isVideo || youtubeId) && !loadedThumbs.has(index) && (
- <Skeleton className="absolute inset-0 rounded-lg" />
- )}
- {youtubeId ? (
+ {(!isVideo || youtubeId) &&
+ !loadedThumbs.has(index) &&
+ !thumbnailFailed && (
+ <Skeleton className="absolute inset-0 rounded-lg" />
+ )}
+ {thumbnailFailed ? (
+ <div className="flex h-full w-full items-center justify-center bg-zinc-100">
+ <Icon
+ icon={ImageNotFound01Icon}
+ className="h-5 w-5 text-zinc-400"
+ />
+ </div>
+ ) : youtubeId ? (
<img
- src={`https://img.youtube.com/vi/${youtubeId}/mqdefault.jpg`}
+ src={thumbnailUrl}
alt={`Thumbnail ${index + 1}`}
loading="lazy"
className="absolute inset-0 h-full w-full object-cover"
onLoad={() =>
setLoadedThumbs((prev) => new Set(prev).add(index))
}
+ onError={() => markThumbFailed(thumbnailUrl)}
/>
) : isVideo ? (
<div className="flex h-full w-full items-center justify-center bg-neutral-200 text-xs text-neutral-500">
@@ -71,13 +93,14 @@ export function AgentImages({ images }: AgentImagesProps) {
</div>
) : (
<img
- src={image}
+ src={thumbnailUrl}
alt={`Thumbnail ${index + 1}`}
loading="lazy"
className="absolute inset-0 h-full w-full object-cover"
onLoad={() =>
setLoadedThumbs((prev) => new Set(prev).add(index))
}
+ onError={() => markThumbFailed(thumbnailUrl)}
/>
)}
</button>
diff --git a/autogpt_platform/frontend/src/app/(platform)/marketplace/components/AgentImages/__tests__/AgentImage.test.tsx b/autogpt_platform/frontend/src/app/(platform)/marketplace/components/AgentImages/__tests__/AgentImage.test.tsx
new file mode 100644
index 0000000000..cdc8d816ed
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/marketplace/components/AgentImages/__tests__/AgentImage.test.tsx
@@ -0,0 +1,35 @@
+import { describe, expect, test } from "vitest";
+import { fireEvent, render, screen } from "@/tests/integrations/test-utils";
+
+import { AgentImages } from "../AgentImage";
+
+const IMAGES = ["https://cdn.test/one.png", "https://cdn.test/two.png"];
+
+describe("AgentImages thumbnails", () => {
+ test("renders a thumbnail per image", () => {
+ render(<AgentImages images={IMAGES} />);
+ expect(screen.getByAltText("Thumbnail 1")).toBeDefined();
+ expect(screen.getByAltText("Thumbnail 2")).toBeDefined();
+ });
+
+ test("replaces only the dead thumbnail with a placeholder", () => {
+ render(<AgentImages images={IMAGES} />);
+
+ fireEvent.error(screen.getByAltText("Thumbnail 2"));
+
+ expect(screen.queryByAltText("Thumbnail 2")).toBeNull();
+ expect(screen.getByAltText("Thumbnail 1")).toBeDefined();
+ });
+
+ test("shows a replacement image at a previously dead index", () => {
+ const { rerender } = render(<AgentImages images={IMAGES} />);
+ fireEvent.error(screen.getByAltText("Thumbnail 2"));
+
+ rerender(
+ <AgentImages images={[IMAGES[0], "https://cdn.test/replacement.png"]} />,
+ );
+
+ const replacement = screen.getByAltText("Thumbnail 2") as HTMLImageElement;
+ expect(replacement.src).toBe("https://cdn.test/replacement.png");
+ });
+});
diff --git a/autogpt_platform/frontend/src/app/(platform)/marketplace/experts/[expertId]/components/ExpertWorkflowCard/ExpertWorkflowCard.tsx b/autogpt_platform/frontend/src/app/(platform)/marketplace/experts/[expertId]/components/ExpertWorkflowCard/ExpertWorkflowCard.tsx
index b60f499cb6..9c33ac96bc 100644
--- a/autogpt_platform/frontend/src/app/(platform)/marketplace/experts/[expertId]/components/ExpertWorkflowCard/ExpertWorkflowCard.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/marketplace/experts/[expertId]/components/ExpertWorkflowCard/ExpertWorkflowCard.tsx
@@ -6,6 +6,7 @@ import { Icon } from "@/components/atoms/Icon/Icon";
import { Skeleton } from "@/components/atoms/Skeleton/Skeleton";
import { Calendar03Icon, FlashIcon } from "@hugeicons/core-free-icons";
import Image from "next/image";
+import { useImageFallback } from "@/hooks/useImageFallback";
import { isLocalStoreMediaUrl } from "@/lib/store-media";
import { getCadenceLabel } from "./helpers";
import { useExpertWorkflowCard } from "./useExpertWorkflowCard";
@@ -19,12 +20,13 @@ export function ExpertWorkflowCard({ workflow, accent }: Props) {
const { imageUrl, isLoadingImage } = useExpertWorkflowCard(
workflow.store_listing_version_id,
);
+ const { showImage, handleImageError } = useImageFallback(imageUrl);
const name = workflow.name ?? "Unnamed workflow";
return (
<li className="flex flex-col overflow-hidden rounded-xl border border-zinc-200 bg-white">
<div className="relative aspect-[2.17/1] w-full bg-zinc-50">
- {imageUrl ? (
+ {showImage && imageUrl ? (
<Image
src={imageUrl}
unoptimized={isLocalStoreMediaUrl(imageUrl)}
@@ -32,6 +34,7 @@ export function ExpertWorkflowCard({ workflow, accent }: Props) {
fill
sizes="(min-width: 640px) 360px, 100vw"
className="object-cover"
+ onError={handleImageError}
/>
) : isLoadingImage ? (
<Skeleton className="absolute inset-0 rounded-none" />
diff --git a/autogpt_platform/frontend/src/app/(platform)/marketplace/experts/[expertId]/components/ExpertWorkflowCard/__tests__/ExpertWorkflowCard.test.tsx b/autogpt_platform/frontend/src/app/(platform)/marketplace/experts/[expertId]/components/ExpertWorkflowCard/__tests__/ExpertWorkflowCard.test.tsx
new file mode 100644
index 0000000000..448dc07bca
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/marketplace/experts/[expertId]/components/ExpertWorkflowCard/__tests__/ExpertWorkflowCard.test.tsx
@@ -0,0 +1,37 @@
+import { describe, expect, test, vi } from "vitest";
+import { fireEvent, render, screen } from "@/tests/integrations/test-utils";
+
+import { ExpertWorkflowCard } from "../ExpertWorkflowCard";
+import type { ExpertWorkflowRef } from "@/app/api/__generated__/models/expertWorkflowRef";
+import { getExpertAccent } from "@/app/(platform)/marketplace/components/ExpertsSection/helpers";
+
+vi.mock("../useExpertWorkflowCard", () => ({
+ useExpertWorkflowCard: () => ({
+ imageUrl: "https://cdn.test/workflow.png",
+ isLoadingImage: false,
+ }),
+}));
+
+const WORKFLOW = {
+ name: "Daily digest",
+ description: "Sends a summary each morning",
+ store_listing_version_id: "lv1",
+} as ExpertWorkflowRef;
+
+describe("ExpertWorkflowCard", () => {
+ test("falls back to the accent icon when the image URL is dead", () => {
+ const { container } = render(
+ <ExpertWorkflowCard
+ workflow={WORKFLOW}
+ accent={getExpertAccent("Ops")}
+ />,
+ );
+
+ expect(screen.getByAltText("Daily digest preview image")).toBeDefined();
+ fireEvent.error(screen.getByAltText("Daily digest preview image"));
+
+ expect(screen.queryByAltText("Daily digest preview image")).toBeNull();
+ expect(container.querySelector("svg")).not.toBeNull();
+ expect(screen.getByText("Daily digest")).toBeDefined();
+ });
+});
diff --git a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableCard/AgentTableCard.tsx b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableCard/AgentTableCard.tsx
index 296e6987fd..83897efabf 100644
--- a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableCard/AgentTableCard.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableCard/AgentTableCard.tsx
@@ -5,6 +5,9 @@ import { isLocalStoreMediaUrl } from "@/lib/store-media";
import { IconStarFilled, IconMore } from "@/components/__legacy__/ui/icons";
import { StoreSubmission } from "@/app/api/__generated__/models/storeSubmission";
import { Status } from "@/components/__legacy__/Status";
+import { ImageNotFound01Icon } from "@hugeicons/core-free-icons";
+import { Icon } from "@/components/atoms/Icon/Icon";
+import { useImageFallback } from "@/hooks/useImageFallback";
export interface AgentTableCardProps {
storeAgentSubmission: StoreSubmission;
@@ -30,17 +33,27 @@ export const AgentTableCard = ({
review_avg_rating: rating,
} = storeAgentSubmission;
+ const { showImage, handleImageError } = useImageFallback(image_urls?.[0]);
+
return (
<div className="border-b border-neutral-300 p-4 dark:border-neutral-700">
<div className="flex gap-4">
- <div className="relative aspect-video w-24 shrink-0 overflow-hidden rounded-lg bg-[#d9d9d9] dark:bg-neutral-800">
- <Image
- src={image_urls?.[0] ?? "/nada.png"}
- unoptimized={isLocalStoreMediaUrl(image_urls?.[0] ?? "/nada.png")}
- alt={agentName}
- fill
- style={{ objectFit: "cover" }}
- />
+ <div className="relative flex aspect-video w-24 shrink-0 items-center justify-center overflow-hidden rounded-lg bg-zinc-100 dark:bg-neutral-800">
+ {showImage && image_urls?.[0] ? (
+ <Image
+ src={image_urls[0]}
+ unoptimized={isLocalStoreMediaUrl(image_urls[0])}
+ alt={agentName}
+ fill
+ style={{ objectFit: "cover" }}
+ onError={handleImageError}
+ />
+ ) : (
+ <Icon
+ icon={ImageNotFound01Icon}
+ className="h-6 w-6 text-zinc-800"
+ />
+ )}
</div>
<div className="flex-1">
<div className="flex items-center gap-2">
diff --git a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableCard/__tests__/AgentTableCard.test.tsx b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableCard/__tests__/AgentTableCard.test.tsx
new file mode 100644
index 0000000000..525c7c35d2
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableCard/__tests__/AgentTableCard.test.tsx
@@ -0,0 +1,53 @@
+import { describe, expect, test } from "vitest";
+import { fireEvent, render, screen } from "@/tests/integrations/test-utils";
+
+import { AgentTableCard } from "../AgentTableCard";
+import type { StoreSubmission } from "@/app/api/__generated__/models/storeSubmission";
+import { SubmissionStatus } from "@/app/api/__generated__/models/submissionStatus";
+
+const SUBMISSION = {
+ listing_id: "l1",
+ user_id: "u1",
+ slug: "digest",
+ listing_version_id: "lv1",
+ listing_version: 1,
+ graph_id: "g1",
+ graph_version: 2,
+ name: "Daily digest",
+ sub_heading: "A short summary",
+ description: "Longer description",
+ instructions: null,
+ categories: [],
+ image_urls: ["https://cdn.test/agent.png"],
+ video_url: null,
+ agent_output_demo_url: null,
+ submitted_at: new Date("2026-01-01T00:00:00Z"),
+ changes_summary: null,
+ status: SubmissionStatus.APPROVED,
+} as unknown as StoreSubmission;
+
+describe("AgentTableCard", () => {
+ test("renders the submission image while the URL loads", () => {
+ render(
+ <AgentTableCard
+ storeAgentSubmission={SUBMISSION}
+ onViewSubmission={() => {}}
+ />,
+ );
+ expect(screen.getByAltText("Daily digest")).toBeDefined();
+ });
+
+ test("falls back to a placeholder when the image URL is dead", () => {
+ const { container } = render(
+ <AgentTableCard
+ storeAgentSubmission={SUBMISSION}
+ onViewSubmission={() => {}}
+ />,
+ );
+
+ fireEvent.error(screen.getByAltText("Daily digest"));
+
+ expect(screen.queryByAltText("Daily digest")).toBeNull();
+ expect(container.querySelector("svg")).not.toBeNull();
+ });
+});
diff --git a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/AgentTableRow.tsx b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/AgentTableRow.tsx
index e204eed5df..f0957e33b8 100644
--- a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/AgentTableRow.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/AgentTableRow.tsx
@@ -19,6 +19,7 @@ import {
StarIcon,
} from "@hugeicons/core-free-icons";
import { Icon } from "@/components/atoms/Icon/Icon";
+import { useImageFallback } from "@/hooks/useImageFallback";
export type AgentTableRowProps = {
storeAgentSubmission: StoreSubmission;
@@ -58,6 +59,7 @@ export const AgentTableRow = ({
review_avg_rating,
} = storeAgentSubmission;
+ const { showImage, handleImageError } = useImageFallback(image_urls?.[0]);
const canModify = status === SubmissionStatus.PENDING;
return (
@@ -70,14 +72,15 @@ export const AgentTableRow = ({
<div className="grid w-full grid-cols-[minmax(400px,1fr),180px,140px,100px,100px,40px] items-center gap-4">
{/* Agent info column */}
<div className="flex items-center gap-4">
- {image_urls?.[0] ? (
+ {showImage && image_urls?.[0] ? (
<div className="relative aspect-video w-32 shrink-0 overflow-hidden rounded-[10px] bg-zinc-100">
<Image
- src={image_urls?.[0] ?? ""}
- unoptimized={isLocalStoreMediaUrl(image_urls?.[0] ?? "")}
+ src={image_urls[0]}
+ unoptimized={isLocalStoreMediaUrl(image_urls[0])}
alt={agentName}
fill
style={{ objectFit: "cover" }}
+ onError={handleImageError}
/>
</div>
) : (
diff --git a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/__tests__/AgentTableRow.local-media.test.tsx b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/__tests__/AgentTableRow.local-media.test.tsx
new file mode 100644
index 0000000000..36be80658b
--- /dev/null
+++ b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/__tests__/AgentTableRow.local-media.test.tsx
@@ -0,0 +1,43 @@
+import { expect, test, vi } from "vitest";
+import { fireEvent, render, screen } from "@testing-library/react";
+import { getGetV2ListMySubmissionsResponseMock } from "@/app/api/__generated__/endpoints/store/store.msw";
+import { SubmissionStatus } from "@/app/api/__generated__/models/submissionStatus";
+import { AgentTableRow } from "../AgentTableRow";
+
+vi.mock("next/image", async () =>
+ vi.importActual<typeof import("next/image")>("next/image"),
+);
+
+const LOCAL_URL = "/api/store/media/agent-1/images/cover.png";
+
+test("a locally served image renders unoptimized and still falls back when it fails", () => {
+ const submission = {
+ ...getGetV2ListMySubmissionsResponseMock().submissions[0],
+ graph_id: "graph-1",
+ graph_version: 7,
+ listing_version_id: "listing-approved",
+ name: "Local media agent",
+ status: SubmissionStatus.APPROVED,
+ image_urls: [LOCAL_URL],
+ submitted_at: new Date("2026-01-01T00:00:00.000Z"),
+ };
+
+ const { container } = render(
+ <AgentTableRow
+ storeAgentSubmission={submission}
+ onViewSubmission={vi.fn()}
+ onDeleteSubmission={vi.fn()}
+ onEditSubmission={vi.fn()}
+ />,
+ );
+
+ const image = screen.getByAltText(submission.name);
+ expect(image.getAttribute("src")).toContain(LOCAL_URL);
+ expect(image.getAttribute("src")).not.toContain("/_next/image");
+ expect(image.hasAttribute("srcset")).toBe(false);
+
+ fireEvent.error(image);
+
+ expect(screen.queryByAltText(submission.name)).toBeNull();
+ expect(container.querySelector("svg")).not.toBeNull();
+});
diff --git a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/__tests__/AgentTableRow.test.tsx b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/__tests__/AgentTableRow.test.tsx
index 04e1d4ad1e..ec3457cb0e 100644
--- a/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/__tests__/AgentTableRow.test.tsx
+++ b/autogpt_platform/frontend/src/app/(platform)/profile/(user)/dashboard/components/AgentTableRow/__tests__/AgentTableRow.test.tsx
@@ -20,6 +20,13 @@ function makeSubmission(status: SubmissionStatus) {
};
}
+function makeSubmissionWithImage(imageUrl: string) {
+ return {
+ ...makeSubmission(SubmissionStatus.APPROVED),
+ image_urls: [imageUrl],
+ };
+}
+
describe("AgentTableRow", () => {
const onViewSubmission = vi.fn();
const onDeleteSubmission = vi.fn();
@@ -73,4 +80,21 @@ describe("AgentTableRow", () => {
expect(screen.queryByText("Edit")).toBeNull();
expect(screen.queryByText("Delete")).toBeNull();
});
+
+ test("falls back to the not-found icon when the image URL is dead", () => {
+ const submission = makeSubmissionWithImage("https://cdn.test/dead.png");
+ const { container } = render(
+ <AgentTableRow
+ storeAgentSubmission={submission}
+ onViewSubmission={onViewSubmission}
+ onDeleteSubmission={onDeleteSubmission}
+ onEditSubmission={onEditSubmission}
+ />,
+ );
+
+ fireEvent.error(screen.getByAltText(submission.name));
+
+ expect(screen.queryByAltText(submission.name)).toBeNull();
+ expect(container.querySelector("svg")).not.toBeNull();
+ });
});
diff --git a/autogpt_platform/frontend/src/components/atoms/Avatar/__tests__/Avatar.test.tsx b/autogpt_platform/frontend/src/components/atoms/Avatar/__tests__/Avatar.test.tsx
new file mode 100644
index 0000000000..ce4826496f
--- /dev/null
+++ b/autogpt_platform/frontend/src/components/atoms/Avatar/__tests__/Avatar.test.tsx
@@ -0,0 +1,37 @@
+import { describe, expect, test } from "vitest";
+import { fireEvent, render, screen } from "@/tests/integrations/test-utils";
+
+import Avatar, { AvatarFallback, AvatarImage } from "../Avatar";
+
+function renderAvatar(src: string) {
+ return render(
+ <Avatar>
+ <AvatarImage src={src} alt="Pwuts avatar" />
+ <AvatarFallback>Pwuts</AvatarFallback>
+ </Avatar>,
+ );
+}
+
+describe("Avatar", () => {
+ test("swaps a dead avatar URL for the generated fallback", () => {
+ const { container } = renderAvatar("https://cdn.test/dead.png");
+
+ expect(screen.getByAltText("Pwuts avatar")).toBeDefined();
+ fireEvent.error(screen.getByAltText("Pwuts avatar"));
+
+ expect(screen.queryByAltText("Pwuts avatar")).toBeNull();
+ expect(container.querySelector("svg")).not.toBeNull();
+ });
+
+ test("shows the fallback when there is no avatar URL at all", () => {
+ const { container } = render(
+ <Avatar>
+ <AvatarImage src="" alt="Pwuts avatar" />
+ <AvatarFallback>Pwuts</AvatarFallback>
+ </Avatar>,
+ );
+
+ expect(screen.queryByAltText("Pwuts avatar")).toBeNull();
+ expect(container.querySelector("svg")).not.toBeNull();
+ });
+});
diff --git a/autogpt_platform/frontend/src/hooks/__tests__/useImageFallback.test.tsx b/autogpt_platform/frontend/src/hooks/__tests__/useImageFallback.test.tsx
new file mode 100644
index 0000000000..773bc63c17
--- /dev/null
+++ b/autogpt_platform/frontend/src/hooks/__tests__/useImageFallback.test.tsx
@@ -0,0 +1,38 @@
+import { describe, expect, test } from "vitest";
+import { act, renderHook } from "@testing-library/react";
+
+import { useImageFallback } from "../useImageFallback";
+
+describe("useImageFallback", () => {
+ test("shows the image while the URL loads", () => {
+ const { result } = renderHook(() => useImageFallback("https://cdn/a.png"));
+ expect(result.current.showImage).toBe(true);
+ });
+
+ test("hides the image once the URL fails", () => {
+ const { result } = renderHook(() => useImageFallback("https://cdn/a.png"));
+ act(() => result.current.handleImageError());
+ expect(result.current.showImage).toBe(false);
+ });
+
+ test("treats an absent URL as no image", () => {
+ expect(
+ renderHook(() => useImageFallback(null)).result.current.showImage,
+ ).toBe(false);
+ expect(
+ renderHook(() => useImageFallback("")).result.current.showImage,
+ ).toBe(false);
+ });
+
+ test("clears a previous failure when the URL changes", () => {
+ const { result, rerender } = renderHook(
+ ({ src }) => useImageFallback(src),
+ { initialProps: { src: "https://cdn/a.png" } },
+ );
+ act(() => result.current.handleImageError());
+ expect(result.current.showImage).toBe(false);
+
+ rerender({ src: "https://cdn/b.png" });
+ expect(result.current.showImage).toBe(true);
+ });
+});
diff --git a/autogpt_platform/frontend/src/hooks/useImageFallback.ts b/autogpt_platform/frontend/src/hooks/useImageFallback.ts
new file mode 100644
index 0000000000..4c431a8791
--- /dev/null
+++ b/autogpt_platform/frontend/src/hooks/useImageFallback.ts
@@ -0,0 +1,19 @@
+import { useEffect, useState } from "react";
+
+// Treats an image URL that fails to load as absent, so call sites render their
+// own placeholder. Resets on src change, which a bare error flag misses.
+export function useImageFallback(src: string | null | undefined) {
+ const [hasFailed, setHasFailed] = useState(false);
+
+ useEffect(
+ function clearFailureOnSrcChange() {
+ setHasFailed(false);
+ },
+ [src],
+ );
+
+ return {
+ showImage: Boolean(src) && !hasFailed,
+ handleImageError: () => setHasFailed(true),
+ };
+}