From c16b358a79106870c53d57f9133da2a21fd470f0 Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Wed, 20 May 2026 21:53:13 -0400
Subject: [PATCH 01/25] update style for oss of the failed task in the task
 panel

---
 .../components/task-collapsible-section.tsx   |   6 +-
 frontend/components/task-error-content.tsx    | 132 +++++++++---------
 .../components/task-notification-menu.tsx     |  95 +++++++------
 frontend/components/tasks_details.tsx         |   1 +
 frontend/contexts/task-context.tsx            |  74 ++++++----
 frontend/lib/task-utils.ts                    |  14 ++
 frontend/package-lock.json                    |  35 +++++
 frontend/package.json                         |   1 +
 frontend/tailwind.config.ts                   |   4 +
 .../tests/core/tasks-unified-panel.spec.ts    |  29 ++--
 10 files changed, 244 insertions(+), 147 deletions(-)

diff --git a/frontend/components/task-collapsible-section.tsx b/frontend/components/task-collapsible-section.tsx
index e7c28068c..fc0f081f1 100644
--- a/frontend/components/task-collapsible-section.tsx
+++ b/frontend/components/task-collapsible-section.tsx
@@ -33,14 +33,14 @@ export function TaskCollapsibleSection<T>({
       >
         <h3 className="font-semibold text-sm flex items-center gap-2 text-muted-foreground">
           {title}
-          <span className="inline-flex h-5 w-5 shrink-0 items-center justify-center rounded-full bg-muted-foreground text-[10px] font-semibold text-background">
+          <span className="inline-flex size-5 shrink-0 items-center justify-center rounded-full bg-muted-foreground text-xxs font-semibold text-background">
             {items.length}
           </span>
         </h3>
         {isOpen ? (
-          <ChevronDown className="h-[14px] w-[14px] text-foreground" />
+          <ChevronDown className="size-3.5 text-foreground" />
         ) : (
-          <ChevronUp className="h-[14px] w-[14px] text-foreground" />
+          <ChevronUp className="size-3.5 text-foreground" />
         )}
       </button>
 
diff --git a/frontend/components/task-error-content.tsx b/frontend/components/task-error-content.tsx
index 34266bea2..c2d51d480 100644
--- a/frontend/components/task-error-content.tsx
+++ b/frontend/components/task-error-content.tsx
@@ -1,6 +1,7 @@
 "use client";
 
-import { ArrowDown, ArrowUp, ChevronDown, XCircle } from "lucide-react";
+import { ErrorFilled, IncidentReporter } from "@carbon/icons-react";
+import { ChevronDown } from "lucide-react";
 import { useEffect, useMemo, useState } from "react";
 import {
   Accordion,
@@ -11,6 +12,7 @@ import {
 import { type Task } from "@/contexts/task-context";
 import { getFailedFileEntries } from "@/lib/task-utils";
 import { formatTaskTimestamp, parseTimestamp } from "@/lib/time-utils";
+import { cn } from "@/lib/utils";
 
 interface TaskErrorContentProps {
   task: Task;
@@ -29,19 +31,24 @@ export function TaskErrorContent({
   defaultExpanded = false,
   expandTrigger = 0,
 }: TaskErrorContentProps) {
-  const [isExpanded, setIsExpanded] = useState(defaultExpanded);
+  const [accordionValue, setAccordionValue] = useState(
+    defaultExpanded ? "failed-files" : "",
+  );
   useEffect(() => {
     if (defaultExpanded) {
-      setIsExpanded(true);
+      setAccordionValue("failed-files");
     }
   }, [defaultExpanded, expandTrigger]);
+
+  const isExpanded = accordionValue === "failed-files";
+
   const failedEntries = useMemo(() => getFailedFileEntries(task), [task]);
 
   const failedCount = task.failed_files ?? failedEntries.length;
   const successCount = task.successful_files ?? 0;
   const timestamp =
     parseTimestamp(task.created_at) ?? parseTimestamp(task.updated_at);
-  const statusLabel = "INCOMPLETE";
+  const statusLabel = "Failed";
   const statusPillClassName =
     "text-destructive border-failure-pill bg-failure-soft";
 
@@ -51,17 +58,18 @@ export function TaskErrorContent({
 
   return (
     <div
-      className={
+      className={cn(
+        "flex flex-col gap-1 w-full",
         showHeader
-          ? "flex flex-col gap-1 border-t border-muted w-full hover:bg-muted/60 transition-colors px-4 py-2"
-          : ""
-      }
+          ? "rounded-task border border-muted py-mmd px-4 hover:bg-muted/60 transition-colors"
+          : "pt-2",
+      )}
     >
       {showHeader && (
         <>
-          <div className="flex items-center justify-between gap-2 min-w-0">
-            <div className="flex items-center gap-2 min-w-0">
-              <XCircle className="h-5 w-5 text-destructive shrink-0" />
+          <div className="flex items-center justify-between gap-1.5 min-w-0">
+            <div className="flex items-center gap-2.5 min-w-0 ">
+              <ErrorFilled className="size-5 shrink-0 text-destructive" />
               <p className="text-mmd truncate">
                 Task {task.task_id.slice(0, 8)}...
               </p>
@@ -75,7 +83,7 @@ export function TaskErrorContent({
             )}
           </div>
 
-          <div className="flex flex-col justify-between gap-1">
+          <div className="flex flex-col justify-between gap-1 pl-[30px]">
             <p className="text-xxs text-muted-foreground whitespace-nowrap leading-4 min-h-4">
               {formatTaskTimestamp(timestamp, mode, nowMs)}
             </p>
@@ -86,63 +94,59 @@ export function TaskErrorContent({
       <Accordion
         type="single"
         collapsible
-        className="border-0"
-        value={isExpanded ? "failure-log" : undefined}
-        onValueChange={(value) => setIsExpanded(Boolean(value))}
+        className="rounded-task border-0"
+        value={accordionValue}
+        onValueChange={(value) =>
+          setAccordionValue(value === "failed-files" ? "failed-files" : "")
+        }
       >
-        <AccordionItem value="failure-log" className="border-0 rounded-none">
-          <AccordionTrigger className="group px-0 py-0 text-sm text-destructive hover:text-destructive/80 transition-colors [&>svg:first-child]:hidden">
-            <div className="flex items-center gap-1">
-              <span className="text-muted-foreground text-xs">
-                {successCount} success,
-              </span>
-              <span className="text-destructive text-xs">
-                {failedCount} failed
-              </span>
-              <ChevronDown className="h-4 w-4 text-destructive transition-transform group-data-[state=open]:rotate-180" />
+        <AccordionItem value="failed-files" className="border-0 rounded-none">
+          <AccordionTrigger className="group px-0 py-0 text-sm text-muted-foreground hover:text-foreground transition-colors [&>svg:first-child]:hidden">
+            <div className="flex w-full items-center justify-between gap-2 pl-[30px]">
+              <div className="flex items-center gap-1">
+                <span className="text-xs">
+                  {successCount} success · {failedCount} failed
+                </span>
+                <ChevronDown className="size-4 shrink-0 transition-transform group-data-[state=open]:rotate-180" />
+              </div>
+              <button
+                type="button"
+                aria-label="Report incident"
+                className="inline-flex shrink-0 items-center justify-center text-muted-foreground hover:text-foreground"
+                onClick={(event) => {
+                  event.preventDefault();
+                  event.stopPropagation();
+                }}
+                onPointerDown={(event) => event.stopPropagation()}
+              >
+                <IncidentReporter className="size-4" />
+              </button>
             </div>
           </AccordionTrigger>
-          <AccordionContent className="pt-2 pb-0">
-            <div className="rounded-xl border border-destructive/20 bg-failure-soft p-3">
-              <p className="text-xs font-medium text-failure-log mb-2 sticky top-0">
-                Failure Log{" "}
-                <span className="text-failure-muted">
-                  ({failedCount} of {failedCount} pending)
-                </span>
-              </p>
-              <div className="max-h-56 overflow-y-auto flex flex-col gap-2">
-                {failedEntries.map(([filePath, fileInfo], index) => {
-                  const fileName =
-                    fileInfo.filename || filePath.split("/").pop() || filePath;
-                  const message =
-                    typeof fileInfo.error === "string" && fileInfo.error.trim()
-                      ? fileInfo.error.trim()
-                      : task.error || "Unknown error";
+          <AccordionContent className="p-0 pt-2">
+            <div className="flex flex-col gap-2 pt-2">
+              {failedEntries.map(([filePath, fileInfo], index) => {
+                const fileName =
+                  fileInfo.filename || filePath.split("/").pop() || filePath;
+                const message =
+                  typeof fileInfo.error === "string" && fileInfo.error.trim()
+                    ? fileInfo.error.trim()
+                    : task.error || "Unknown error";
 
-                  return (
-                    <div
-                      key={`${task.task_id}-${filePath}-${index}`}
-                      className="space-y-1"
-                    >
-                      <p className="text-xs text-failure-file font-semibold truncate">
-                        {">"} {fileName}
-                      </p>
-                      <p className="text-xs text-failure-message break-words">
-                        {message}
-                      </p>
-                    </div>
-                  );
-                })}
-              </div>
-              {failedCount > 1 && (
-                <div className="mt-2 text-[9px] text-failure-scroll/40 flex items-center justify-center gap-1">
-                  <div className="flex items-center gap-0">
-                    <ArrowUp className="h-2 w-2" />
-                    <ArrowDown className="h-2 w-2" />
+                return (
+                  <div
+                    key={`${task.task_id}-${filePath}-${index}`}
+                    className="space-y-1 rounded border-destructive/20 bg-failure-soft py-mmd px-4"
+                  >
+                    <p className="text-xs font-semibold text-failure-file truncate">
+                      {fileName}
+                    </p>
+                    <p className="text-xs text-failure-message break-words">
+                      {message}
+                    </p>
                   </div>
-                  <span>scroll · {failedCount} errors</span>
-                </div>
-              )}
+                );
+              })}
             </div>
           </AccordionContent>
         </AccordionItem>
diff --git a/frontend/components/task-notification-menu.tsx b/frontend/components/task-notification-menu.tsx
index d88005bdb..3d63edd84 100644
--- a/frontend/components/task-notification-menu.tsx
+++ b/frontend/components/task-notification-menu.tsx
@@ -1,5 +1,6 @@
 "use client";
 
+import { ErrorFilled } from "@carbon/icons-react";
 import {
   AlertCircle,
   Bell,
@@ -7,7 +8,6 @@ import {
   Clock,
   Loader2,
   X,
-  XCircle,
 } from "lucide-react";
 import { useEffect, useMemo, useRef, useState } from "react";
 import { TaskCollapsibleSection } from "@/components/task-collapsible-section";
@@ -23,7 +23,11 @@ import {
   CardTitle,
 } from "@/components/ui/card";
 import { Task, useTask } from "@/contexts/task-context";
-import { hasFailedFileEntries, isTerminalFailedTask } from "@/lib/task-utils";
+import {
+  hasFailedFileEntries,
+  isCompletedTotalFailure,
+  isTerminalFailedTask,
+} from "@/lib/task-utils";
 import { parseTimestampMs } from "@/lib/time-utils";
 
 export function TaskNotificationMenu() {
@@ -81,11 +85,6 @@ export function TaskNotificationMenu() {
         }),
     [tasks],
   );
-  const mostRecentFailureTaskId =
-    terminalTasks.find(
-      (task) => isTerminalFailedTask(task) || hasFailedFileEntries(task),
-    )?.task_id ?? null;
-
   // Ensure selected task is visible in the past tasks section.
   useEffect(() => {
     if (!selectedTaskId) return;
@@ -103,16 +102,23 @@ export function TaskNotificationMenu() {
   // Don't render if menu is closed
   if (!isMenuOpen) return null;
 
-  const getTaskIcon = (status: Task["status"], hasFailedFiles = false) => {
+  const getTaskIcon = (
+    status: Task["status"],
+    hasFailedFiles = false,
+    isTotalFailure = false,
+  ) => {
     switch (status) {
       case "completed":
         if (hasFailedFiles) {
+          if (isTotalFailure) {
+            return <ErrorFilled className="size-4 text-destructive" />;
+          }
           return <AlertCircle className="h-4 w-4 text-brand-amber" />;
         }
         return <CheckCircle className="h-4 w-4 text-green-500" />;
       case "failed":
       case "error":
-        return <XCircle className="h-4 w-4 text-red-500" />;
+        return <ErrorFilled className="size-4 text-destructive" />;
       case "pending":
         return <Clock className="h-4 w-4 text-yellow-500" />;
       case "running":
@@ -123,14 +129,28 @@ export function TaskNotificationMenu() {
     }
   };
 
-  const getStatusBadge = (status: Task["status"], hasFailedFiles = false) => {
+  const getStatusBadge = (
+    status: Task["status"],
+    hasFailedFiles = false,
+    isTotalFailure = false,
+  ) => {
     switch (status) {
       case "completed":
+        if (hasFailedFiles && isTotalFailure) {
+          return (
+            <Badge
+              variant="outline"
+              className="rounded-lg bg-red-500/10 text-red-500 border-red-500/20"
+            >
+              FAILED
+            </Badge>
+          );
+        }
         if (hasFailedFiles) {
           return (
             <Badge
               variant="outline"
-              className="rounded-[8px] bg-brand-amber-10 text-brand-amber border-brand-amber-30"
+              className="rounded-lg bg-brand-amber-10 text-brand-amber border-brand-amber-30"
             >
               COMPLETED
             </Badge>
@@ -139,7 +159,7 @@ export function TaskNotificationMenu() {
         return (
           <Badge
             variant="outline"
-            className="rounded-[8px] bg-green-500/10 text-green-500 border-green-500/20"
+            className="rounded-lg bg-green-500/10 text-green-500 border-green-500/20"
           >
             COMPLETED
           </Badge>
@@ -149,16 +169,16 @@ export function TaskNotificationMenu() {
         return (
           <Badge
             variant="outline"
-            className="rounded-[8px] bg-red-500/10 text-red-500 border-red-500/20"
+            className="rounded-lg bg-red-500/10 text-red-500 border-red-500/20"
           >
-            INCOMPLETE
+            FAILED
           </Badge>
         );
       case "pending":
         return (
           <Badge
             variant="outline"
-            className="rounded-[8px] bg-yellow-500/10 text-yellow-500 border-yellow-500/20"
+            className="rounded-lg bg-yellow-500/10 text-yellow-500 border-yellow-500/20"
           >
             Pending
           </Badge>
@@ -168,7 +188,7 @@ export function TaskNotificationMenu() {
         return (
           <Badge
             variant="outline"
-            className="rounded-[8px] bg-blue-500/10 text-blue-500 border-blue-500/20"
+            className="rounded-lg bg-blue-500/10 text-blue-500 border-blue-500/20"
           >
             Processing
           </Badge>
@@ -177,7 +197,7 @@ export function TaskNotificationMenu() {
         return (
           <Badge
             variant="outline"
-            className="rounded-[8px] bg-gray-500/10 text-gray-500 border-gray-500/20"
+            className="rounded-lg bg-gray-500/10 text-gray-500 border-gray-500/20"
           >
             Unknown
           </Badge>
@@ -278,7 +298,7 @@ export function TaskNotificationMenu() {
         <div className="flex-1 overflow-y-auto">
           {/* Active Tasks */}
           {activeTasks.length > 0 && (
-            <div className="px-4 py-2 space-y-3">
+            <div className="flex flex-col gap-2 p-4">
               <h4 className="text-sm font-medium text-muted-foreground">
                 Active Tasks
               </h4>
@@ -292,9 +312,9 @@ export function TaskNotificationMenu() {
                 return (
                   <Card
                     key={task.task_id}
-                    className="bg-card/50 border-0 shadow-none"
+                    className="bg-card/50 border-0 shadow-none py-mmd px-4"
                   >
-                    <CardHeader className="pb-2">
+                    <CardHeader className="p-0 pb-2">
                       <div className="flex items-center justify-between">
                         <CardTitle className="text-sm flex items-center gap-2">
                           {getTaskIcon(task.status)}
@@ -311,7 +331,7 @@ export function TaskNotificationMenu() {
                       </CardDescription>
                     </CardHeader>
                     {(progress || showCancel) && (
-                      <CardContent className="pt-0">
+                      <CardContent className="p-0 pt-0">
                         {progress && (
                           <div className="space-y-2">
                             <div className="text-xs text-muted-foreground">
@@ -369,12 +389,6 @@ export function TaskNotificationMenu() {
                               task={task}
                               mode="recent"
                               showHeader={false}
-                              defaultExpanded={true}
-                              expandTrigger={
-                                selectedTaskId === task.task_id
-                                  ? selectedTaskTrigger
-                                  : 0
-                              }
                             />
                           </div>
                         )}
@@ -395,24 +409,17 @@ export function TaskNotificationMenu() {
               onToggle={() => setIsPastOpen((prev) => !prev)}
               emptyText="No past tasks."
               containerClassName=""
-              contentClassName="transition-all duration-200"
+              contentClassName="flex flex-col gap-2 p-4 transition-all duration-200"
               renderItem={(task) => {
                 const progress = formatTaskProgress(task);
                 const hasFailedFiles = hasFailedFileEntries(task);
-                const shouldExpandDetails =
-                  selectedTaskId === task.task_id ||
-                  (!selectedTaskId && task.task_id === mostRecentFailureTaskId);
-
-                if (isTerminalFailedTask(task)) {
+                const isTotalFailure = isCompletedTotalFailure(task);
+                if (isTerminalFailedTask(task) || isTotalFailure) {
                   return (
                     <TaskErrorContent
                       key={task.task_id}
                       task={task}
                       mode="past"
-                      defaultExpanded={shouldExpandDetails}
-                      expandTrigger={
-                        shouldExpandDetails ? selectedTaskTrigger : 0
-                      }
                     />
                   );
                 }
@@ -420,10 +427,10 @@ export function TaskNotificationMenu() {
                 return (
                   <div
                     key={task.task_id}
-                    className="px-4 py-2 hover:bg-muted/50 transition-colors"
+                    className="py-mmd px-4 hover:bg-muted/50 transition-colors"
                   >
                     <div className="flex items-start gap-3">
-                      {getTaskIcon(task.status, hasFailedFiles)}
+                      {getTaskIcon(task.status, hasFailedFiles, isTotalFailure)}
                       <div className="flex-1 min-w-0">
                         <div className="text-xs font-medium truncate">
                           Task {task.task_id.substring(0, 8)}...
@@ -451,7 +458,11 @@ export function TaskNotificationMenu() {
                           )}
                       </div>
                       <div className="self-start pt-0.5">
-                        {getStatusBadge(task.status, hasFailedFiles)}
+                        {getStatusBadge(
+                          task.status,
+                          hasFailedFiles,
+                          isTotalFailure,
+                        )}
                       </div>
                     </div>
                     {hasFailedFiles && (
@@ -460,10 +471,6 @@ export function TaskNotificationMenu() {
                           task={task}
                           mode="past"
                           showHeader={false}
-                          defaultExpanded={shouldExpandDetails}
-                          expandTrigger={
-                            shouldExpandDetails ? selectedTaskTrigger : 0
-                          }
                         />
                       </div>
                     )}
diff --git a/frontend/components/tasks_details.tsx b/frontend/components/tasks_details.tsx
index 8a9d2f3ae..20a0543ff 100644
--- a/frontend/components/tasks_details.tsx
+++ b/frontend/components/tasks_details.tsx
@@ -98,6 +98,7 @@ export const FailedTasksInfo = ({ failedTasks }: FailedTasksInfoProps) => {
                 }))
               }
               emptyText={section.emptyText}
+              contentClassName="flex flex-col gap-2 p-4"
               renderItem={(task) => (
                 <TaskErrorContent
                   key={`${section.sectionKey}-${task.task_id}`}
diff --git a/frontend/contexts/task-context.tsx b/frontend/contexts/task-context.tsx
index 8737deb2e..d49dbbf05 100644
--- a/frontend/contexts/task-context.tsx
+++ b/frontend/contexts/task-context.tsx
@@ -20,7 +20,11 @@ import {
 import { useAuth } from "@/contexts/auth-context";
 import { useOnboardingState } from "@/hooks/use-onboarding-state";
 import { trackProcessFailure, trackProcessSuccess } from "@/lib/analytics";
-import { hasFailedFileEntries, isTerminalFailedTask } from "@/lib/task-utils";
+import {
+  getSuccessfulFileCount,
+  hasFailedFileEntries,
+  isTerminalFailedTask,
+} from "@/lib/task-utils";
 
 // Task interface is now imported from useGetTasksQuery
 export type { Task };
@@ -328,20 +332,32 @@ export function TaskProvider({ children }: { children: React.ReactNode }) {
           previousTask.status !== "completed" &&
           currentTask.status === "completed"
         ) {
-          // Task just completed - show success toast with file counts
-          const successfulFiles = currentTask.successful_files || 0;
+          const successfulFiles = getSuccessfulFileCount(currentTask);
           const failedFiles = currentTask.failed_files || 0;
-
-          trackProcessSuccess({
-            processType: "Ingestion",
-            process: "Document Upload",
-            category: "Knowledge",
-            task_id: currentTask.task_id,
-            total_files: currentTask.total_files,
-            successful_files: successfulFiles,
-            failed_files: failedFiles,
-            duration_seconds: currentTask.duration_seconds,
-          });
+          const isTotalFailure = failedFiles > 0 && successfulFiles === 0;
+
+          if (isTotalFailure) {
+            trackProcessFailure({
+              processType: "Ingestion",
+              process: "Document Upload",
+              category: "Knowledge",
+              task_id: currentTask.task_id,
+              total_files: currentTask.total_files,
+              failed_files: failedFiles,
+              duration_seconds: currentTask.duration_seconds,
+            });
+          } else {
+            trackProcessSuccess({
+              processType: "Ingestion",
+              process: "Document Upload",
+              category: "Knowledge",
+              task_id: currentTask.task_id,
+              total_files: currentTask.total_files,
+              successful_files: successfulFiles,
+              failed_files: failedFiles,
+              duration_seconds: currentTask.duration_seconds,
+            });
+          }
 
           let description = "";
           if (failedFiles > 0) {
@@ -356,17 +372,27 @@ export function TaskProvider({ children }: { children: React.ReactNode }) {
             } uploaded successfully`;
           }
           if (!isOnboardingActive) {
-            toast.success("Task completed", {
-              description,
-              action: {
-                label: "View",
-                onClick: () => {
-                  selectTask(currentTask.task_id);
-                  setIsMenuOpen(true);
-                  setIsRecentTasksExpanded(true);
-                },
+            const toastAction = {
+              label: "View",
+              onClick: () => {
+                selectTask(currentTask.task_id);
+                setIsMenuOpen(true);
+                setIsRecentTasksExpanded(true);
               },
-            });
+            };
+            if (isTotalFailure) {
+              toast.error("Task failed", {
+                description: `${failedFiles} file${
+                  failedFiles !== 1 ? "s" : ""
+                } failed`,
+                action: toastAction,
+              });
+            } else {
+              toast.success("Task completed", {
+                description,
+                action: toastAction,
+              });
+            }
           }
 
           const completedHasFailures = hasFailedFileEntries(currentTask);
diff --git a/frontend/lib/task-utils.ts b/frontend/lib/task-utils.ts
index 94b441fa9..88c5cab33 100644
--- a/frontend/lib/task-utils.ts
+++ b/frontend/lib/task-utils.ts
@@ -24,6 +24,20 @@ export function isCompletedWithFailures(task: Task): boolean {
   return task.status === "completed" && hasFailedFileEntries(task);
 }
 
+export function getSuccessfulFileCount(task: Task): number {
+  if (typeof task.successful_files === "number") {
+    return task.successful_files;
+  }
+  return Object.values(task.files || {}).filter(
+    (fileInfo) => fileInfo?.status === "completed",
+  ).length;
+}
+
+/** Completed task with failures and no successful files — treat as failed, not partial success. */
+export function isCompletedTotalFailure(task: Task): boolean {
+  return isCompletedWithFailures(task) && getSuccessfulFileCount(task) === 0;
+}
+
 export function isFailureLikeTask(task: Task): boolean {
   return isTerminalFailedTask(task) || isCompletedWithFailures(task);
 }
diff --git a/frontend/package-lock.json b/frontend/package-lock.json
index 3e5165d5a..adb7ecda2 100644
--- a/frontend/package-lock.json
+++ b/frontend/package-lock.json
@@ -8,6 +8,7 @@
       "name": "frontend",
       "version": "0.1.0",
       "dependencies": {
+        "@carbon/icons-react": "^11.81.0",
         "@radix-ui/react-accordion": "^1.2.12",
         "@radix-ui/react-avatar": "^1.1.10",
         "@radix-ui/react-collapsible": "^1.1.11",
@@ -257,6 +258,31 @@
         "node": ">=14.21.3"
       }
     },
+    "node_modules/@carbon/icon-helpers": {
+      "version": "10.76.0",
+      "resolved": "https://registry.npmjs.org/@carbon/icon-helpers/-/icon-helpers-10.76.0.tgz",
+      "integrity": "sha512-DLxVV/NtEFauMbmKFW53cGKMs84RRdIp9AzHbasIxlCBjO0P4eZbPdO3gTzYxn02jDMo++2m3MsEAwNydzrzmQ==",
+      "hasInstallScript": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ibm/telemetry-js": "^1.5.0"
+      }
+    },
+    "node_modules/@carbon/icons-react": {
+      "version": "11.81.0",
+      "resolved": "https://registry.npmjs.org/@carbon/icons-react/-/icons-react-11.81.0.tgz",
+      "integrity": "sha512-rkaQz45ioyQQ1FeSB69ojL1EfsEecYE0+S88marMqz6GIqJxnDhHap3a2C89kXwuBUbCNsZ5aIhKqfiMquotvg==",
+      "hasInstallScript": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@carbon/icon-helpers": "^10.76.0",
+        "@ibm/telemetry-js": "^1.5.0",
+        "prop-types": "^15.8.1"
+      },
+      "peerDependencies": {
+        "react": ">=16"
+      }
+    },
     "node_modules/@emnapi/core": {
       "version": "1.8.1",
       "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.8.1.tgz",
@@ -524,6 +550,15 @@
         "url": "https://github.com/sponsors/nzakas"
       }
     },
+    "node_modules/@ibm/telemetry-js": {
+      "version": "1.11.0",
+      "resolved": "https://registry.npmjs.org/@ibm/telemetry-js/-/telemetry-js-1.11.0.tgz",
+      "integrity": "sha512-RO/9j+URJnSfseWg9ZkEX9p+a3Ousd33DBU7rOafoZB08RqdzxFVYJ2/iM50dkBuD0o7WX7GYt1sLbNgCoE+pA==",
+      "license": "Apache-2.0",
+      "bin": {
+        "ibmtelemetry": "dist/collect.js"
+      }
+    },
     "node_modules/@img/colour": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/@img/colour/-/colour-1.1.0.tgz",
diff --git a/frontend/package.json b/frontend/package.json
index b712c0ac6..3ed1dbef5 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -17,6 +17,7 @@
     "prepare": "cd .. && npx husky frontend/.husky || true"
   },
   "dependencies": {
+    "@carbon/icons-react": "^11.81.0",
     "@radix-ui/react-accordion": "^1.2.12",
     "@radix-ui/react-avatar": "^1.1.10",
     "@radix-ui/react-collapsible": "^1.1.11",
diff --git a/frontend/tailwind.config.ts b/frontend/tailwind.config.ts
index a74c8c8ab..ec66f1ecd 100644
--- a/frontend/tailwind.config.ts
+++ b/frontend/tailwind.config.ts
@@ -194,10 +194,14 @@ const config = {
           muted: "var(--failure-muted)",
         },
       },
+      spacing: {
+        mmd: "13px",
+      },
       borderRadius: {
         lg: "var(--radius)",
         md: "calc(var(--radius) - 2px)",
         sm: "calc(var(--radius) - 4px)",
+        task: "13px",
       },
       fontFamily: {
         sans: ["var(--font-sans)", ...fontFamily.sans],
diff --git a/frontend/tests/core/tasks-unified-panel.spec.ts b/frontend/tests/core/tasks-unified-panel.spec.ts
index 73f711a54..f55909c6c 100644
--- a/frontend/tests/core/tasks-unified-panel.spec.ts
+++ b/frontend/tests/core/tasks-unified-panel.spec.ts
@@ -77,13 +77,18 @@ const wireTasksState = async (page: Page, initialTasks: MockTask[]) => {
   };
 };
 
-const expandFirstFailureAccordion = async (page: Page) => {
-  const failureLog = page.getByText("Failure Log").first();
-  if (await failureLog.isVisible()) {
+const expandFirstFailureAccordion = async (
+  page: Page,
+  expectedError?: string,
+) => {
+  if (
+    expectedError &&
+    (await page.getByText(expectedError).first().isVisible())
+  ) {
     return;
   }
   await page
-    .getByRole("button", { name: /\d+\s*success,\s*\d+\s*failed/i })
+    .getByRole("button", { name: /\d+\s*success\s*·\s*\d+\s*failed/i })
     .first()
     .click();
 };
@@ -178,8 +183,10 @@ test("completed task with failures keeps failure log in Tasks panel", async ({
   );
   await openTasksPanel(page);
   await openPastTasksSection(page);
-  await expandFirstFailureAccordion(page);
-  await expect(page.getByText("Failure Log")).toBeVisible();
+  await expandFirstFailureAccordion(
+    page,
+    "Synthetic ingestion failure for test",
+  );
   await expect(
     page.getByText("Synthetic ingestion failure for test"),
   ).toBeVisible();
@@ -228,8 +235,7 @@ test("completed task with failures requires View click to open tasks panel", asy
   );
   await openTasksPanel(page);
   await openPastTasksSection(page);
-  await expandFirstFailureAccordion(page);
-  await expect(page.getByText("Failure Log")).toBeVisible();
+  await expandFirstFailureAccordion(page, "Auto-open on partial success");
   await expect(page.getByText("Auto-open on partial success")).toBeVisible();
 });
 
@@ -274,8 +280,7 @@ test("new failed task auto-opens tasks panel", async ({ page }) => {
   );
   await openTasksPanel(page);
   await openPastTasksSection(page);
-  await expandFirstFailureAccordion(page);
-  await expect(page.getByText("Failure Log")).toBeVisible();
+  await expandFirstFailureAccordion(page, "Auto-open on failed task");
   await expect(page.getByText("Auto-open on failed task")).toBeVisible();
 });
 
@@ -325,6 +330,6 @@ test("unified panel shows all completed tasks in a single past tasks section", a
   await openTasksPanel(page);
   await expect(page.getByText("Task task-new...")).toBeVisible();
   await expect(page.getByText("Task task-old...")).toBeVisible();
-  // The most recent failure task auto-expands, hiding its INCOMPLETE pill; the older one stays collapsed.
-  await expect(page.getByText("INCOMPLETE")).toHaveCount(1);
+  // Failure summaries stay collapsed by default; both tasks show the FAILED pill.
+  await expect(page.getByText("FAILED")).toHaveCount(2);
 });

From ee99d06620bf2a72a0e581e0b92d64b8fb8c1684 Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Wed, 20 May 2026 22:14:21 -0400
Subject: [PATCH 02/25] keep logic on click, remove unecessary useeffect

---
 frontend/components/task-error-content.tsx | 16 ++--------------
 1 file changed, 2 insertions(+), 14 deletions(-)

diff --git a/frontend/components/task-error-content.tsx b/frontend/components/task-error-content.tsx
index c2d51d480..337589869 100644
--- a/frontend/components/task-error-content.tsx
+++ b/frontend/components/task-error-content.tsx
@@ -2,7 +2,7 @@
 
 import { ErrorFilled, IncidentReporter } from "@carbon/icons-react";
 import { ChevronDown } from "lucide-react";
-import { useEffect, useMemo, useState } from "react";
+import { useMemo, useState } from "react";
 import {
   Accordion,
   AccordionContent,
@@ -19,8 +19,6 @@ interface TaskErrorContentProps {
   mode?: "recent" | "past";
   nowMs?: number;
   showHeader?: boolean;
-  defaultExpanded?: boolean;
-  expandTrigger?: number;
 }
 
 export function TaskErrorContent({
@@ -28,18 +26,8 @@ export function TaskErrorContent({
   mode = "recent",
   nowMs = Date.now(),
   showHeader = true,
-  defaultExpanded = false,
-  expandTrigger = 0,
 }: TaskErrorContentProps) {
-  const [accordionValue, setAccordionValue] = useState(
-    defaultExpanded ? "failed-files" : "",
-  );
-  useEffect(() => {
-    if (defaultExpanded) {
-      setAccordionValue("failed-files");
-    }
-  }, [defaultExpanded, expandTrigger]);
-
+  const [accordionValue, setAccordionValue] = useState("");
   const isExpanded = accordionValue === "failed-files";
 
   const failedEntries = useMemo(() => getFailedFileEntries(task), [task]);

From d3f05c1beb3ef814c6715222019d937bc5070b1a Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Wed, 20 May 2026 22:21:11 -0400
Subject: [PATCH 03/25] fix padding

---
 frontend/components/task-notification-menu.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/components/task-notification-menu.tsx b/frontend/components/task-notification-menu.tsx
index 3d63edd84..cb1e3896a 100644
--- a/frontend/components/task-notification-menu.tsx
+++ b/frontend/components/task-notification-menu.tsx
@@ -409,7 +409,7 @@ export function TaskNotificationMenu() {
               onToggle={() => setIsPastOpen((prev) => !prev)}
               emptyText="No past tasks."
               containerClassName=""
-              contentClassName="flex flex-col gap-2 p-4 transition-all duration-200"
+              contentClassName="flex flex-col gap-2 p-4 pt-2 transition-all duration-200"
               renderItem={(task) => {
                 const progress = formatTaskProgress(task);
                 const hasFailedFiles = hasFailedFileEntries(task);

From 1d4f425d028bf07c49a1b73bcc26e181a68f61ec Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Wed, 20 May 2026 23:15:51 -0400
Subject: [PATCH 04/25] wip implementing Saas style

---
 frontend/app/globals.css                      |   2 +
 frontend/components/task-error-content.tsx    | 221 +++++++++++-------
 .../components/task-notification-menu.tsx     |   7 +-
 frontend/components/tasks_details.tsx         |  10 +-
 frontend/tailwind.config.ts                   |   1 +
 .../tests/core/tasks-unified-panel.spec.ts    |  26 ++-
 6 files changed, 172 insertions(+), 95 deletions(-)

diff --git a/frontend/app/globals.css b/frontend/app/globals.css
index 9fb849a30..ab08eeffd 100644
--- a/frontend/app/globals.css
+++ b/frontend/app/globals.css
@@ -88,6 +88,7 @@
     --failure-message: hsl(var(--foreground));
     --failure-scroll: #ff6464;
     --failure-muted: #a66262;
+    --failure-component-cause: #525252; /* IBM Gray 70 — OSS component label beside flag */
   }
 
   .dark {
@@ -156,6 +157,7 @@
     --failure-message: #ffc9c9cc;
     --failure-scroll: #ff6464;
     --failure-muted: #a66262;
+    --failure-component-cause: #525252;
   }
 
   /* IBM Light */
diff --git a/frontend/components/task-error-content.tsx b/frontend/components/task-error-content.tsx
index 337589869..7c9912d0b 100644
--- a/frontend/components/task-error-content.tsx
+++ b/frontend/components/task-error-content.tsx
@@ -1,6 +1,6 @@
 "use client";
 
-import { ErrorFilled, IncidentReporter } from "@carbon/icons-react";
+import { ErrorFilled, FlagFilled, IncidentReporter } from "@carbon/icons-react";
 import { ChevronDown } from "lucide-react";
 import { useMemo, useState } from "react";
 import {
@@ -9,7 +9,9 @@ import {
   AccordionItem,
   AccordionTrigger,
 } from "@/components/ui/accordion";
+import { useIsCloudBrand } from "@/contexts/brand-context";
 import { type Task } from "@/contexts/task-context";
+import { displayFileTaskError } from "@/lib/task-error-display";
 import { getFailedFileEntries } from "@/lib/task-utils";
 import { formatTaskTimestamp, parseTimestamp } from "@/lib/time-utils";
 import { cn } from "@/lib/utils";
@@ -27,6 +29,7 @@ export function TaskErrorContent({
   nowMs = Date.now(),
   showHeader = true,
 }: TaskErrorContentProps) {
+  const isCloudBrand = useIsCloudBrand();
   const [accordionValue, setAccordionValue] = useState("");
   const isExpanded = accordionValue === "failed-files";
 
@@ -44,101 +47,157 @@ export function TaskErrorContent({
     return null;
   }
 
+  const ossIconColumn = showHeader && !isCloudBrand;
+
+  const accordionTrigger = (
+    <div className="flex w-full min-w-0 items-center justify-between gap-2">
+      <div className="flex min-w-0 items-center gap-1">
+        <span className="text-xs">
+          {successCount} success · {failedCount} failed
+        </span>
+        <ChevronDown className="size-4 shrink-0 transition-transform group-data-[state=open]:rotate-180" />
+      </div>
+      <button
+        type="button"
+        aria-label="Report incident"
+        className="inline-flex shrink-0 items-center justify-center text-muted-foreground hover:text-foreground"
+        onClick={(event) => {
+          event.preventDefault();
+          event.stopPropagation();
+        }}
+        onPointerDown={(event) => event.stopPropagation()}
+      >
+        <IncidentReporter className="size-4" />
+      </button>
+    </div>
+  );
+
   return (
     <div
       className={cn(
-        "flex flex-col gap-1 w-full",
+        "w-full",
         showHeader
           ? "rounded-task border border-muted py-mmd px-4 hover:bg-muted/60 transition-colors"
           : "pt-2",
       )}
     >
-      {showHeader && (
-        <>
-          <div className="flex items-center justify-between gap-1.5 min-w-0">
-            <div className="flex items-center gap-2.5 min-w-0 ">
+      <div className="flex w-full min-w-0 flex-col gap-1">
+        {showHeader && (
+          <div
+            className={cn("flex min-w-0 w-full", ossIconColumn && "gap-2.5")}
+          >
+            {ossIconColumn && (
               <ErrorFilled className="size-5 shrink-0 text-destructive" />
-              <p className="text-mmd truncate">
-                Task {task.task_id.slice(0, 8)}...
+            )}
+            <div className="flex min-w-0 flex-1 flex-col gap-1">
+              <div className="flex min-w-0 items-center justify-between gap-1.5">
+                <p className="text-mmd truncate">
+                  Task {task.task_id.slice(0, 8)}...
+                </p>
+                {!isExpanded && (
+                  <p
+                    className={`shrink-0 rounded-full border px-2 py-1 text-xs ${statusPillClassName}`}
+                  >
+                    {statusLabel}
+                  </p>
+                )}
+              </div>
+              <p className="min-h-4 text-xxs leading-4 text-muted-foreground whitespace-nowrap">
+                {formatTaskTimestamp(timestamp, mode, nowMs)}
               </p>
             </div>
-            {!isExpanded && (
-              <p
-                className={`text-xs shrink-0 border rounded-full px-2 py-1 ${statusPillClassName}`}
-              >
-                {statusLabel}
-              </p>
-            )}
           </div>
+        )}
 
-          <div className="flex flex-col justify-between gap-1 pl-[30px]">
-            <p className="text-xxs text-muted-foreground whitespace-nowrap leading-4 min-h-4">
-              {formatTaskTimestamp(timestamp, mode, nowMs)}
-            </p>
-          </div>
-        </>
-      )}
+        <Accordion
+          type="single"
+          collapsible
+          className="w-full rounded-task border-0"
+          value={accordionValue}
+          onValueChange={(value) =>
+            setAccordionValue(value === "failed-files" ? "failed-files" : "")
+          }
+        >
+          <AccordionItem value="failed-files" className="border-0 rounded-none">
+            <AccordionTrigger className="group px-0 py-0 text-sm text-muted-foreground hover:text-foreground transition-colors [&>svg:first-child]:hidden">
+              {ossIconColumn ? (
+                <div className="flex w-full min-w-0 gap-2.5">
+                  <div className="size-5 shrink-0" aria-hidden />
+                  <div className="min-w-0 flex-1">{accordionTrigger}</div>
+                </div>
+              ) : (
+                accordionTrigger
+              )}
+            </AccordionTrigger>
+            <AccordionContent className="w-full p-0 pt-2">
+              <div className="flex w-full flex-col gap-2">
+                {failedEntries.map(([filePath, fileInfo], index) => {
+                  const fileName =
+                    fileInfo.filename || filePath.split("/").pop() || filePath;
+                  const rawError =
+                    typeof fileInfo.error === "string" && fileInfo.error.trim()
+                      ? fileInfo.error.trim()
+                      : task.error;
+                  const { line, componentCause } =
+                    displayFileTaskError(rawError);
 
-      <Accordion
-        type="single"
-        collapsible
-        className="rounded-task border-0"
-        value={accordionValue}
-        onValueChange={(value) =>
-          setAccordionValue(value === "failed-files" ? "failed-files" : "")
-        }
-      >
-        <AccordionItem value="failed-files" className="border-0 rounded-none">
-          <AccordionTrigger className="group px-0 py-0 text-sm text-muted-foreground hover:text-foreground transition-colors [&>svg:first-child]:hidden">
-            <div className="flex w-full items-center justify-between gap-2 pl-[30px]">
-              <div className="flex items-center gap-1">
-                <span className="text-xs">
-                  {successCount} success · {failedCount} failed
-                </span>
-                <ChevronDown className="size-4 shrink-0 transition-transform group-data-[state=open]:rotate-180" />
+                  return (
+                    <div
+                      key={`${task.task_id}-${filePath}-${index}`}
+                      className={cn(
+                        "task-failed-file-card min-w-0",
+                        isCloudBrand
+                          ? "flex h-[90px] flex-col items-start gap-2 self-stretch rounded-none rounded-r border-l-[1.5px] border-l-destructive bg-border p-2"
+                          : "flex flex-col gap-1 rounded border-destructive/20 bg-failure-soft py-mmd px-4",
+                      )}
+                    >
+                      <p
+                        className={cn(
+                          "w-full truncate text-xs",
+                          isCloudBrand
+                            ? "font-normal text-foreground"
+                            : "font-semibold text-failure-file",
+                        )}
+                      >
+                        {fileName}
+                      </p>
+                      <p
+                        className={cn(
+                          "w-full truncate text-xs",
+                          isCloudBrand
+                            ? "text-muted-foreground"
+                            : "text-failure-message",
+                        )}
+                        title={rawError}
+                      >
+                        {line}
+                      </p>
+                      {componentCause ? (
+                        <div className="flex min-w-0 items-center gap-1">
+                          <FlagFilled
+                            className="size-3 shrink-0 text-destructive"
+                            aria-hidden
+                          />
+                          <span
+                            className={cn(
+                              "truncate text-xs",
+                              isCloudBrand
+                                ? "text-muted-foreground"
+                                : "text-failure-component-cause",
+                            )}
+                          >
+                            {componentCause}
+                          </span>
+                        </div>
+                      ) : null}
+                    </div>
+                  );
+                })}
               </div>
-              <button
-                type="button"
-                aria-label="Report incident"
-                className="inline-flex shrink-0 items-center justify-center text-muted-foreground hover:text-foreground"
-                onClick={(event) => {
-                  event.preventDefault();
-                  event.stopPropagation();
-                }}
-                onPointerDown={(event) => event.stopPropagation()}
-              >
-                <IncidentReporter className="size-4" />
-              </button>
-            </div>
-          </AccordionTrigger>
-          <AccordionContent className="p-0 pt-2">
-            <div className="flex flex-col gap-2 pt-2">
-              {failedEntries.map(([filePath, fileInfo], index) => {
-                const fileName =
-                  fileInfo.filename || filePath.split("/").pop() || filePath;
-                const message =
-                  typeof fileInfo.error === "string" && fileInfo.error.trim()
-                    ? fileInfo.error.trim()
-                    : task.error || "Unknown error";
-
-                return (
-                  <div
-                    key={`${task.task_id}-${filePath}-${index}`}
-                    className="space-y-1 rounded border-destructive/20 bg-failure-soft py-mmd px-4"
-                  >
-                    <p className="text-xs font-semibold text-failure-file truncate">
-                      {fileName}
-                    </p>
-                    <p className="text-xs text-failure-message break-words">
-                      {message}
-                    </p>
-                  </div>
-                );
-              })}
-            </div>
-          </AccordionContent>
-        </AccordionItem>
-      </Accordion>
+            </AccordionContent>
+          </AccordionItem>
+        </Accordion>
+      </div>
     </div>
   );
 }
diff --git a/frontend/components/task-notification-menu.tsx b/frontend/components/task-notification-menu.tsx
index cb1e3896a..bfd193786 100644
--- a/frontend/components/task-notification-menu.tsx
+++ b/frontend/components/task-notification-menu.tsx
@@ -22,6 +22,7 @@ import {
   CardHeader,
   CardTitle,
 } from "@/components/ui/card";
+import { useIsCloudBrand } from "@/contexts/brand-context";
 import { Task, useTask } from "@/contexts/task-context";
 import {
   hasFailedFileEntries,
@@ -29,8 +30,10 @@ import {
   isTerminalFailedTask,
 } from "@/lib/task-utils";
 import { parseTimestampMs } from "@/lib/time-utils";
+import { cn } from "@/lib/utils";
 
 export function TaskNotificationMenu() {
+  const isCloudBrand = useIsCloudBrand();
   const {
     tasks,
     isFetching,
@@ -286,7 +289,9 @@ export function TaskNotificationMenu() {
   };
 
   return (
-    <div className="h-full bg-background">
+    <div
+      className={cn("h-full bg-background", isCloudBrand && "ibm-tasks-panel")}
+    >
       <div className="flex flex-col h-full">
         <TaskPanelHeader
           activeCount={activeTasks.length}
diff --git a/frontend/components/tasks_details.tsx b/frontend/components/tasks_details.tsx
index 20a0543ff..d420ce10a 100644
--- a/frontend/components/tasks_details.tsx
+++ b/frontend/components/tasks_details.tsx
@@ -2,15 +2,18 @@ import { useEffect, useMemo, useState } from "react";
 import { TaskCollapsibleSection } from "@/components/task-collapsible-section";
 import { TaskErrorContent } from "@/components/task-error-content";
 import { TaskPanelHeader } from "@/components/task-panel-header";
+import { useIsCloudBrand } from "@/contexts/brand-context";
 import { useKnowledgeFilter } from "@/contexts/knowledge-filter-context";
 import { type Task } from "@/contexts/task-context";
 import { parseTimestampMs } from "@/lib/time-utils";
+import { cn } from "@/lib/utils";
 
 interface FailedTasksInfoProps {
   failedTasks: Task[];
 }
 
 export const FailedTasksInfo = ({ failedTasks }: FailedTasksInfoProps) => {
+  const isCloudBrand = useIsCloudBrand();
   const [openSections, setOpenSections] = useState<
     Record<"recent" | "past", boolean>
   >({
@@ -76,7 +79,12 @@ export const FailedTasksInfo = ({ failedTasks }: FailedTasksInfoProps) => {
   );
 
   return (
-    <div className="h-full bg-background border-l overflow-y-auto">
+    <div
+      className={cn(
+        "h-full bg-background border-l overflow-y-auto",
+        isCloudBrand && "ibm-tasks-panel",
+      )}
+    >
       <TaskPanelHeader onClose={closePanelOnly} />
 
       {failedTasks.length === 0 ? (
diff --git a/frontend/tailwind.config.ts b/frontend/tailwind.config.ts
index ec66f1ecd..3954f604d 100644
--- a/frontend/tailwind.config.ts
+++ b/frontend/tailwind.config.ts
@@ -192,6 +192,7 @@ const config = {
           message: "var(--failure-message)",
           scroll: "var(--failure-scroll)",
           muted: "var(--failure-muted)",
+          "component-cause": "var(--failure-component-cause)",
         },
       },
       spacing: {
diff --git a/frontend/tests/core/tasks-unified-panel.spec.ts b/frontend/tests/core/tasks-unified-panel.spec.ts
index f55909c6c..7bb57146a 100644
--- a/frontend/tests/core/tasks-unified-panel.spec.ts
+++ b/frontend/tests/core/tasks-unified-panel.spec.ts
@@ -77,6 +77,9 @@ const wireTasksState = async (page: Page, initialTasks: MockTask[]) => {
   };
 };
 
+/** Matches accordion summary, e.g. "1 success · 2 failed". */
+const FAILURE_SUMMARY_BUTTON = /\d+\s*success\s*[·,.]\s*\d+\s*failed/i;
+
 const expandFirstFailureAccordion = async (
   page: Page,
   expectedError?: string,
@@ -88,7 +91,7 @@ const expandFirstFailureAccordion = async (
     return;
   }
   await page
-    .getByRole("button", { name: /\d+\s*success\s*·\s*\d+\s*failed/i })
+    .getByRole("button", { name: FAILURE_SUMMARY_BUTTON })
     .first()
     .click();
 };
@@ -115,18 +118,17 @@ const openTasksPanel = async (page: Page) => {
 };
 
 const openPastTasksSection = async (page: Page) => {
-  const failureAccordionTrigger = page.getByRole("button", {
-    name: /\d+\s*success,\s*\d+\s*failed/i,
-  });
-  if (await failureAccordionTrigger.count()) {
-    return;
-  }
-
   const pastTasksToggle = page.getByRole("button", { name: /Past Tasks/i });
-  if (await pastTasksToggle.count()) {
+  await expect(pastTasksToggle.first()).toBeVisible({ timeout: 15000 });
+
+  const failureSummary = page.getByRole("button", {
+    name: FAILURE_SUMMARY_BUTTON,
+  });
+  if ((await failureSummary.count()) === 0) {
     await pastTasksToggle.first().click();
   }
-  await expect(failureAccordionTrigger.first()).toBeVisible({ timeout: 15000 });
+
+  await expect(failureSummary.first()).toBeVisible({ timeout: 15000 });
 };
 
 test("completed task with failures keeps failure log in Tasks panel", async ({
@@ -330,6 +332,6 @@ test("unified panel shows all completed tasks in a single past tasks section", a
   await openTasksPanel(page);
   await expect(page.getByText("Task task-new...")).toBeVisible();
   await expect(page.getByText("Task task-old...")).toBeVisible();
-  // Failure summaries stay collapsed by default; both tasks show the FAILED pill.
-  await expect(page.getByText("FAILED")).toHaveCount(2);
+  // Failure summaries stay collapsed by default; both tasks show the Failed pill.
+  await expect(page.getByText("Failed", { exact: true })).toHaveCount(2);
 });

From e1fa26dd2ed3c04a3dc72903ba8f916b90b2df1a Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Wed, 20 May 2026 23:23:12 -0400
Subject: [PATCH 05/25] utils to reshape error until backend provide info we
 need

---
 frontend/contexts/task-context.tsx | 3 ++-
 frontend/lib/task-utils.ts         | 7 +++++++
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/frontend/contexts/task-context.tsx b/frontend/contexts/task-context.tsx
index d49dbbf05..838e3760b 100644
--- a/frontend/contexts/task-context.tsx
+++ b/frontend/contexts/task-context.tsx
@@ -21,6 +21,7 @@ import { useAuth } from "@/contexts/auth-context";
 import { useOnboardingState } from "@/hooks/use-onboarding-state";
 import { trackProcessFailure, trackProcessSuccess } from "@/lib/analytics";
 import {
+  getFailedFileCount,
   getSuccessfulFileCount,
   hasFailedFileEntries,
   isTerminalFailedTask,
@@ -333,7 +334,7 @@ export function TaskProvider({ children }: { children: React.ReactNode }) {
           currentTask.status === "completed"
         ) {
           const successfulFiles = getSuccessfulFileCount(currentTask);
-          const failedFiles = currentTask.failed_files || 0;
+          const failedFiles = getFailedFileCount(currentTask);
           const isTotalFailure = failedFiles > 0 && successfulFiles === 0;
 
           if (isTotalFailure) {
diff --git a/frontend/lib/task-utils.ts b/frontend/lib/task-utils.ts
index 88c5cab33..8f22468d5 100644
--- a/frontend/lib/task-utils.ts
+++ b/frontend/lib/task-utils.ts
@@ -33,6 +33,13 @@ export function getSuccessfulFileCount(task: Task): number {
   ).length;
 }
 
+export function getFailedFileCount(task: Task): number {
+  if (typeof task.failed_files === "number") {
+    return task.failed_files;
+  }
+  return getFailedFileEntries(task).length;
+}
+
 /** Completed task with failures and no successful files — treat as failed, not partial success. */
 export function isCompletedTotalFailure(task: Task): boolean {
   return isCompletedWithFailures(task) && getSuccessfulFileCount(task) === 0;

From 1e5e7e3f739a82873de57e0acb75e9778a82cb4c Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Wed, 20 May 2026 23:28:33 -0400
Subject: [PATCH 06/25] utils to reshape error until backend provide info we
 need

---
 frontend/app/globals.css                   | 1 +
 frontend/components/task-error-content.tsx | 4 ++--
 frontend/tailwind.config.ts                | 2 +-
 3 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/frontend/app/globals.css b/frontend/app/globals.css
index ab08eeffd..d542549b1 100644
--- a/frontend/app/globals.css
+++ b/frontend/app/globals.css
@@ -63,6 +63,7 @@
     --badge-foreground: 0 0% 100%; /* #FFFFFF */
 
     --radius: 0.5rem;
+    --radius-mmd: 13px;
 
     --sidebar-background: 0 0% 98%;
 
diff --git a/frontend/components/task-error-content.tsx b/frontend/components/task-error-content.tsx
index 7c9912d0b..05db27c1e 100644
--- a/frontend/components/task-error-content.tsx
+++ b/frontend/components/task-error-content.tsx
@@ -77,7 +77,7 @@ export function TaskErrorContent({
       className={cn(
         "w-full",
         showHeader
-          ? "rounded-task border border-muted py-mmd px-4 hover:bg-muted/60 transition-colors"
+          ? "rounded-mmd border border-muted py-mmd px-4 hover:bg-muted/60 transition-colors"
           : "pt-2",
       )}
     >
@@ -112,7 +112,7 @@ export function TaskErrorContent({
         <Accordion
           type="single"
           collapsible
-          className="w-full rounded-task border-0"
+          className="w-full rounded-mmd border-0"
           value={accordionValue}
           onValueChange={(value) =>
             setAccordionValue(value === "failed-files" ? "failed-files" : "")
diff --git a/frontend/tailwind.config.ts b/frontend/tailwind.config.ts
index 3954f604d..0b302b8ca 100644
--- a/frontend/tailwind.config.ts
+++ b/frontend/tailwind.config.ts
@@ -202,7 +202,7 @@ const config = {
         lg: "var(--radius)",
         md: "calc(var(--radius) - 2px)",
         sm: "calc(var(--radius) - 4px)",
-        task: "13px",
+        mmd: "var(--radius-mmd)",
       },
       fontFamily: {
         sans: ["var(--font-sans)", ...fontFamily.sans],

From 550b75929d2768af95a2322351f1aa61aae805fe Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Wed, 20 May 2026 23:34:35 -0400
Subject: [PATCH 07/25] utils to reshape error until backend provide info we
 need and fixinf fallbacks of isTotalFailure

---
 frontend/components/task-error-content.tsx | 10 ++-
 frontend/lib/task-error-display.ts         | 99 ++++++++++++++++++++++
 2 files changed, 106 insertions(+), 3 deletions(-)
 create mode 100644 frontend/lib/task-error-display.ts

diff --git a/frontend/components/task-error-content.tsx b/frontend/components/task-error-content.tsx
index 05db27c1e..2d827933b 100644
--- a/frontend/components/task-error-content.tsx
+++ b/frontend/components/task-error-content.tsx
@@ -12,7 +12,11 @@ import {
 import { useIsCloudBrand } from "@/contexts/brand-context";
 import { type Task } from "@/contexts/task-context";
 import { displayFileTaskError } from "@/lib/task-error-display";
-import { getFailedFileEntries } from "@/lib/task-utils";
+import {
+  getFailedFileCount,
+  getFailedFileEntries,
+  getSuccessfulFileCount,
+} from "@/lib/task-utils";
 import { formatTaskTimestamp, parseTimestamp } from "@/lib/time-utils";
 import { cn } from "@/lib/utils";
 
@@ -35,8 +39,8 @@ export function TaskErrorContent({
 
   const failedEntries = useMemo(() => getFailedFileEntries(task), [task]);
 
-  const failedCount = task.failed_files ?? failedEntries.length;
-  const successCount = task.successful_files ?? 0;
+  const failedCount = getFailedFileCount(task);
+  const successCount = getSuccessfulFileCount(task);
   const timestamp =
     parseTimestamp(task.created_at) ?? parseTimestamp(task.updated_at);
   const statusLabel = "Failed";
diff --git a/frontend/lib/task-error-display.ts b/frontend/lib/task-error-display.ts
new file mode 100644
index 000000000..9594e6d97
--- /dev/null
+++ b/frontend/lib/task-error-display.ts
@@ -0,0 +1,99 @@
+/**
+ * Formats raw per-file task error strings for compact UI.
+ *
+ * TODO(backend): Prefer structured fields on TaskFileEntry when available, e.g.
+ * error_summary (one line), failing_step, and component_cause — then use this
+ * module only as a fallback for older tasks.
+ */
+
+export const FILE_ERROR_MAX_LINE_LENGTH = 80;
+
+export type TaskErrorComponentCause = "OpenSearch" | "Docling" | "Langflow";
+
+const COMPONENT_CAUSES: ReadonlyArray<{
+  keyword: string;
+  label: TaskErrorComponentCause;
+}> = [
+  { keyword: "opensearch", label: "OpenSearch" },
+  { keyword: "docling", label: "Docling" },
+  { keyword: "langflow", label: "Langflow" },
+];
+
+export interface FileTaskErrorDisplay {
+  line: string;
+  componentCause?: TaskErrorComponentCause;
+}
+
+function normalizeErrorText(raw: string): string {
+  return raw.replace(/\s+/g, " ").trim();
+}
+
+function stripNoisePrefixes(text: string): string {
+  return text
+    .replace(/^Error running graph:\s*/i, "")
+    .replace(/^Error building Component [^:]+:\s*/i, "")
+    .trim();
+}
+
+function truncateLine(
+  text: string,
+  maxLength = FILE_ERROR_MAX_LINE_LENGTH,
+): string {
+  if (text.length <= maxLength) {
+    return text;
+  }
+  return `${text.slice(0, maxLength - 1).trimEnd()}…`;
+}
+
+/** Prefer a short clause from long, nested error strings. */
+function extractReadableLine(text: string): string {
+  const beforeCausedBy = text.split(/\s+caused by:/i)[0]?.trim() ?? text;
+
+  if (beforeCausedBy.length <= FILE_ERROR_MAX_LINE_LENGTH) {
+    return beforeCausedBy;
+  }
+
+  const colonParts = beforeCausedBy.split(":");
+  const lastClause = colonParts[colonParts.length - 1]?.trim();
+  if (
+    lastClause &&
+    lastClause.length >= 10 &&
+    lastClause.length <= FILE_ERROR_MAX_LINE_LENGTH
+  ) {
+    return lastClause;
+  }
+
+  return beforeCausedBy;
+}
+
+export function detectComponentCause(
+  raw: string,
+): TaskErrorComponentCause | undefined {
+  const lower = raw.toLowerCase();
+  for (const { keyword, label } of COMPONENT_CAUSES) {
+    if (lower.includes(keyword)) {
+      return label;
+    }
+  }
+  return undefined;
+}
+
+export function displayFileTaskError(
+  raw: string | undefined | null,
+): FileTaskErrorDisplay {
+  if (!raw?.trim()) {
+    return { line: "Unknown error" };
+  }
+
+  const normalized = normalizeErrorText(raw);
+  const componentCause = detectComponentCause(normalized);
+
+  let line = stripNoisePrefixes(normalized);
+  line = truncateLine(extractReadableLine(line));
+
+  if (!line) {
+    line = "Unknown error";
+  }
+
+  return componentCause ? { line, componentCause } : { line };
+}

From 4cadb5fa16b554da47ab13485f74748f614d40b6 Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Wed, 20 May 2026 23:35:47 -0400
Subject: [PATCH 08/25] utils to reshape error until backend provide into

---
 frontend/lib/task-error-display.ts | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/frontend/lib/task-error-display.ts b/frontend/lib/task-error-display.ts
index 9594e6d97..7f3ce7890 100644
--- a/frontend/lib/task-error-display.ts
+++ b/frontend/lib/task-error-display.ts
@@ -1,10 +1,6 @@
-/**
- * Formats raw per-file task error strings for compact UI.
- *
- * TODO(backend): Prefer structured fields on TaskFileEntry when available, e.g.
- * error_summary (one line), failing_step, and component_cause — then use this
- * module only as a fallback for older tasks.
- */
+//formatting error displayed
+//waiting for backend step pf failure, cause etc
+//in meantime make sure we display only one line and search for opensearch, docling or langflow
 
 export const FILE_ERROR_MAX_LINE_LENGTH = 80;
 

From 45d782ca8225ee8de0c5576614a57d12ee157e5f Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Wed, 20 May 2026 23:51:35 -0400
Subject: [PATCH 09/25] have Saas style for failed and complete labelstatus and
 width and border

---
 frontend/app/globals.css                      | 11 +++++++
 frontend/components/task-error-content.tsx    | 33 ++++++++++++-------
 .../components/task-notification-menu.tsx     | 12 +++++--
 frontend/components/tasks_details.tsx         |  7 +++-
 frontend/tailwind.config.ts                   | 10 ++++++
 5 files changed, 59 insertions(+), 14 deletions(-)

diff --git a/frontend/app/globals.css b/frontend/app/globals.css
index d542549b1..c1683f8ff 100644
--- a/frontend/app/globals.css
+++ b/frontend/app/globals.css
@@ -241,6 +241,12 @@
 
     --badge: 0 0% 22.4%; /* #393939 */
     --badge-foreground: 0 0% 96%; /* #F4F4F4 */
+
+    /* IBM task panel status pills */
+    --task-status-failed-bg: #a2191f; /* IBM Red 70 */
+    --task-status-failed-fg: #ffd7d9; /* IBM Red 20 */
+    --task-status-complete-bg: #0e6027; /* IBM Green 70 */
+    --task-status-complete-fg: #a7f0ba; /* IBM Green 20 */
   }
 
   /* IBM: match OSS switch colors — black track when checked, white thumb always */
@@ -332,6 +338,11 @@
 
     --badge: 0 0% 32%; /* #525252 */
     --badge-foreground: 0 0% 96%; /* #F4F4F4 */
+
+    --task-status-failed-bg: #a2191f;
+    --task-status-failed-fg: #ffd7d9;
+    --task-status-complete-bg: #0e6027;
+    --task-status-complete-fg: #a7f0ba;
   }
 
   /* IBM Settings: section titles (productive heading-04); beats CardTitle utilities */
diff --git a/frontend/components/task-error-content.tsx b/frontend/components/task-error-content.tsx
index 2d827933b..d6e65189e 100644
--- a/frontend/components/task-error-content.tsx
+++ b/frontend/components/task-error-content.tsx
@@ -16,6 +16,8 @@ import {
   getFailedFileCount,
   getFailedFileEntries,
   getSuccessfulFileCount,
+  isCompletedTotalFailure,
+  isTerminalFailedTask,
 } from "@/lib/task-utils";
 import { formatTaskTimestamp, parseTimestamp } from "@/lib/time-utils";
 import { cn } from "@/lib/utils";
@@ -43,9 +45,17 @@ export function TaskErrorContent({
   const successCount = getSuccessfulFileCount(task);
   const timestamp =
     parseTimestamp(task.created_at) ?? parseTimestamp(task.updated_at);
-  const statusLabel = "Failed";
-  const statusPillClassName =
-    "text-destructive border-failure-pill bg-failure-soft";
+  const isFailedStatus =
+    isTerminalFailedTask(task) || isCompletedTotalFailure(task);
+  const statusLabel = isFailedStatus ? "Failed" : "Complete";
+  const statusPillClassName = cn(
+    "shrink-0 rounded-full px-2 py-1 text-xs",
+    isCloudBrand
+      ? isFailedStatus
+        ? "border-0 bg-task-status-failed text-task-status-failed-foreground"
+        : "border-0 bg-task-status-complete text-task-status-complete-foreground"
+      : "border border-failure-pill bg-failure-soft text-destructive",
+  );
 
   if (failedCount <= 0 && failedEntries.length === 0) {
     return null;
@@ -80,9 +90,14 @@ export function TaskErrorContent({
     <div
       className={cn(
         "w-full",
-        showHeader
-          ? "rounded-mmd border border-muted py-mmd px-4 hover:bg-muted/60 transition-colors"
-          : "pt-2",
+        showHeader &&
+          cn(
+            "py-mmd px-4 transition-colors hover:bg-muted/60",
+            isCloudBrand
+              ? "border-t border-muted"
+              : "rounded-mmd border border-muted",
+          ),
+        !showHeader && "pt-2",
       )}
     >
       <div className="flex w-full min-w-0 flex-col gap-1">
@@ -99,11 +114,7 @@ export function TaskErrorContent({
                   Task {task.task_id.slice(0, 8)}...
                 </p>
                 {!isExpanded && (
-                  <p
-                    className={`shrink-0 rounded-full border px-2 py-1 text-xs ${statusPillClassName}`}
-                  >
-                    {statusLabel}
-                  </p>
+                  <p className={statusPillClassName}>{statusLabel}</p>
                 )}
               </div>
               <p className="min-h-4 text-xxs leading-4 text-muted-foreground whitespace-nowrap">
diff --git a/frontend/components/task-notification-menu.tsx b/frontend/components/task-notification-menu.tsx
index bfd193786..792b0d102 100644
--- a/frontend/components/task-notification-menu.tsx
+++ b/frontend/components/task-notification-menu.tsx
@@ -414,7 +414,12 @@ export function TaskNotificationMenu() {
               onToggle={() => setIsPastOpen((prev) => !prev)}
               emptyText="No past tasks."
               containerClassName=""
-              contentClassName="flex flex-col gap-2 p-4 pt-2 transition-all duration-200"
+              contentClassName={cn(
+                "flex flex-col transition-all duration-200",
+                isCloudBrand
+                  ? "p-0 [&>*:last-child]:border-b [&>*:last-child]:border-muted"
+                  : "gap-2 p-4 pt-2",
+              )}
               renderItem={(task) => {
                 const progress = formatTaskProgress(task);
                 const hasFailedFiles = hasFailedFileEntries(task);
@@ -432,7 +437,10 @@ export function TaskNotificationMenu() {
                 return (
                   <div
                     key={task.task_id}
-                    className="py-mmd px-4 hover:bg-muted/50 transition-colors"
+                    className={cn(
+                      "w-full py-mmd px-4 transition-colors hover:bg-muted/50",
+                      isCloudBrand && "border-t border-muted",
+                    )}
                   >
                     <div className="flex items-start gap-3">
                       {getTaskIcon(task.status, hasFailedFiles, isTotalFailure)}
diff --git a/frontend/components/tasks_details.tsx b/frontend/components/tasks_details.tsx
index d420ce10a..f6f923453 100644
--- a/frontend/components/tasks_details.tsx
+++ b/frontend/components/tasks_details.tsx
@@ -106,7 +106,12 @@ export const FailedTasksInfo = ({ failedTasks }: FailedTasksInfoProps) => {
                 }))
               }
               emptyText={section.emptyText}
-              contentClassName="flex flex-col gap-2 p-4"
+              contentClassName={cn(
+                "flex flex-col",
+                isCloudBrand
+                  ? "p-0 [&>*:last-child]:border-b [&>*:last-child]:border-muted"
+                  : "gap-2 p-4",
+              )}
               renderItem={(task) => (
                 <TaskErrorContent
                   key={`${section.sectionKey}-${task.task_id}`}
diff --git a/frontend/tailwind.config.ts b/frontend/tailwind.config.ts
index 0b302b8ca..575f24edd 100644
--- a/frontend/tailwind.config.ts
+++ b/frontend/tailwind.config.ts
@@ -194,6 +194,16 @@ const config = {
           muted: "var(--failure-muted)",
           "component-cause": "var(--failure-component-cause)",
         },
+        "task-status": {
+          failed: {
+            DEFAULT: "var(--task-status-failed-bg)",
+            foreground: "var(--task-status-failed-fg)",
+          },
+          complete: {
+            DEFAULT: "var(--task-status-complete-bg)",
+            foreground: "var(--task-status-complete-fg)",
+          },
+        },
       },
       spacing: {
         mmd: "13px",

From 8a7b33041f338f333037c22331c29834cc0ce51a Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Thu, 21 May 2026 07:59:45 -0400
Subject: [PATCH 10/25] few style adjustment to follow codebase pattern

---
 frontend/app/globals.css                   | 21 ++++++++++-----------
 frontend/components/task-error-content.tsx |  2 +-
 frontend/lib/task-error-display.ts         |  4 +---
 frontend/tailwind.config.ts                | 10 +++++-----
 4 files changed, 17 insertions(+), 20 deletions(-)

diff --git a/frontend/app/globals.css b/frontend/app/globals.css
index c1683f8ff..3cabaf359 100644
--- a/frontend/app/globals.css
+++ b/frontend/app/globals.css
@@ -89,7 +89,7 @@
     --failure-message: hsl(var(--foreground));
     --failure-scroll: #ff6464;
     --failure-muted: #a66262;
-    --failure-component-cause: #525252; /* IBM Gray 70 — OSS component label beside flag */
+    --failure-component-cause: 0 0% 32%; /* #525252 */
   }
 
   .dark {
@@ -158,7 +158,7 @@
     --failure-message: #ffc9c9cc;
     --failure-scroll: #ff6464;
     --failure-muted: #a66262;
-    --failure-component-cause: #525252;
+    --failure-component-cause: 0 0% 32%; /* #525252 */
   }
 
   /* IBM Light */
@@ -242,11 +242,10 @@
     --badge: 0 0% 22.4%; /* #393939 */
     --badge-foreground: 0 0% 96%; /* #F4F4F4 */
 
-    /* IBM task panel status pills */
-    --task-status-failed-bg: #a2191f; /* IBM Red 70 */
-    --task-status-failed-fg: #ffd7d9; /* IBM Red 20 */
-    --task-status-complete-bg: #0e6027; /* IBM Green 70 */
-    --task-status-complete-fg: #a7f0ba; /* IBM Green 20 */
+    --task-status-failed-bg: 357 73% 37%; /* #a2191f */
+    --task-status-failed-fg: 357 100% 93%; /* #ffd7d9 */
+    --task-status-complete-bg: 137 73% 22%; /* #0e6027 */
+    --task-status-complete-fg: 135 59% 80%; /* #a7f0ba */
   }
 
   /* IBM: match OSS switch colors — black track when checked, white thumb always */
@@ -339,10 +338,10 @@
     --badge: 0 0% 32%; /* #525252 */
     --badge-foreground: 0 0% 96%; /* #F4F4F4 */
 
-    --task-status-failed-bg: #a2191f;
-    --task-status-failed-fg: #ffd7d9;
-    --task-status-complete-bg: #0e6027;
-    --task-status-complete-fg: #a7f0ba;
+    --task-status-failed-bg: 357 73% 37%; /* #a2191f */
+    --task-status-failed-fg: 357 100% 93%; /* #ffd7d9 */
+    --task-status-complete-bg: 137 73% 22%; /* #0e6027 */
+    --task-status-complete-fg: 135 59% 80%; /* #a7f0ba */
   }
 
   /* IBM Settings: section titles (productive heading-04); beats CardTitle utilities */
diff --git a/frontend/components/task-error-content.tsx b/frontend/components/task-error-content.tsx
index d6e65189e..a3ab416bb 100644
--- a/frontend/components/task-error-content.tsx
+++ b/frontend/components/task-error-content.tsx
@@ -162,7 +162,7 @@ export function TaskErrorContent({
                       className={cn(
                         "task-failed-file-card min-w-0",
                         isCloudBrand
-                          ? "flex h-[90px] flex-col items-start gap-2 self-stretch rounded-none rounded-r border-l-[1.5px] border-l-destructive bg-border p-2"
+                          ? "flex flex-col items-start gap-2 self-stretch rounded-none rounded-r border-l-[1.5px] border-l-destructive bg-border p-2"
                           : "flex flex-col gap-1 rounded border-destructive/20 bg-failure-soft py-mmd px-4",
                       )}
                     >
diff --git a/frontend/lib/task-error-display.ts b/frontend/lib/task-error-display.ts
index 7f3ce7890..782b40502 100644
--- a/frontend/lib/task-error-display.ts
+++ b/frontend/lib/task-error-display.ts
@@ -1,6 +1,4 @@
-//formatting error displayed
-//waiting for backend step pf failure, cause etc
-//in meantime make sure we display only one line and search for opensearch, docling or langflow
+// Will update when backend is ready (error_summary, failing_step, component_cause).
 
 export const FILE_ERROR_MAX_LINE_LENGTH = 80;
 
diff --git a/frontend/tailwind.config.ts b/frontend/tailwind.config.ts
index 575f24edd..2bcd546a5 100644
--- a/frontend/tailwind.config.ts
+++ b/frontend/tailwind.config.ts
@@ -192,16 +192,16 @@ const config = {
           message: "var(--failure-message)",
           scroll: "var(--failure-scroll)",
           muted: "var(--failure-muted)",
-          "component-cause": "var(--failure-component-cause)",
+          "component-cause": "hsl(var(--failure-component-cause))",
         },
         "task-status": {
           failed: {
-            DEFAULT: "var(--task-status-failed-bg)",
-            foreground: "var(--task-status-failed-fg)",
+            DEFAULT: "hsl(var(--task-status-failed-bg))",
+            foreground: "hsl(var(--task-status-failed-fg))",
           },
           complete: {
-            DEFAULT: "var(--task-status-complete-bg)",
-            foreground: "var(--task-status-complete-fg)",
+            DEFAULT: "hsl(var(--task-status-complete-bg))",
+            foreground: "hsl(var(--task-status-complete-fg))",
           },
         },
       },

From 5984d900a5716ab6fc302a4293688af603c27e8e Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Thu, 21 May 2026 09:36:22 -0400
Subject: [PATCH 11/25] adjust succeed and partially succeed case

---
 frontend/app/globals.css                      |   4 +
 frontend/components/task-error-content.tsx    |  33 +++--
 .../components/task-notification-menu.tsx     | 137 ++++++++++++------
 frontend/tailwind.config.ts                   |   4 +
 4 files changed, 121 insertions(+), 57 deletions(-)

diff --git a/frontend/app/globals.css b/frontend/app/globals.css
index 3cabaf359..fad853f2f 100644
--- a/frontend/app/globals.css
+++ b/frontend/app/globals.css
@@ -244,6 +244,8 @@
 
     --task-status-failed-bg: 357 73% 37%; /* #a2191f */
     --task-status-failed-fg: 357 100% 93%; /* #ffd7d9 */
+    --task-status-partial-bg: 26 90% 37%; /* #8a3800 */
+    --task-status-partial-fg: 46 100% 90%; /* #fff1c8 */
     --task-status-complete-bg: 137 73% 22%; /* #0e6027 */
     --task-status-complete-fg: 135 59% 80%; /* #a7f0ba */
   }
@@ -340,6 +342,8 @@
 
     --task-status-failed-bg: 357 73% 37%; /* #a2191f */
     --task-status-failed-fg: 357 100% 93%; /* #ffd7d9 */
+    --task-status-partial-bg: 22 78% 32%; /* warm orange */
+    --task-status-partial-fg: 46 97% 65%; /* #f1c21b */
     --task-status-complete-bg: 137 73% 22%; /* #0e6027 */
     --task-status-complete-fg: 135 59% 80%; /* #a7f0ba */
   }
diff --git a/frontend/components/task-error-content.tsx b/frontend/components/task-error-content.tsx
index a3ab416bb..bc61c93f4 100644
--- a/frontend/components/task-error-content.tsx
+++ b/frontend/components/task-error-content.tsx
@@ -1,7 +1,7 @@
 "use client";
 
 import { ErrorFilled, FlagFilled, IncidentReporter } from "@carbon/icons-react";
-import { ChevronDown } from "lucide-react";
+import { AlertCircle, ChevronDown } from "lucide-react";
 import { useMemo, useState } from "react";
 import {
   Accordion,
@@ -27,6 +27,7 @@ interface TaskErrorContentProps {
   mode?: "recent" | "past";
   nowMs?: number;
   showHeader?: boolean;
+  defaultExpanded?: boolean;
 }
 
 export function TaskErrorContent({
@@ -34,9 +35,12 @@ export function TaskErrorContent({
   mode = "recent",
   nowMs = Date.now(),
   showHeader = true,
+  defaultExpanded = false,
 }: TaskErrorContentProps) {
   const isCloudBrand = useIsCloudBrand();
-  const [accordionValue, setAccordionValue] = useState("");
+  const [accordionValue, setAccordionValue] = useState(
+    defaultExpanded ? "failed-files" : "",
+  );
   const isExpanded = accordionValue === "failed-files";
 
   const failedEntries = useMemo(() => getFailedFileEntries(task), [task]);
@@ -50,11 +54,13 @@ export function TaskErrorContent({
   const statusLabel = isFailedStatus ? "Failed" : "Complete";
   const statusPillClassName = cn(
     "shrink-0 rounded-full px-2 py-1 text-xs",
-    isCloudBrand
-      ? isFailedStatus
+    isFailedStatus
+      ? isCloudBrand
         ? "border-0 bg-task-status-failed text-task-status-failed-foreground"
-        : "border-0 bg-task-status-complete text-task-status-complete-foreground"
-      : "border border-failure-pill bg-failure-soft text-destructive",
+        : "border border-failure-pill bg-failure-soft text-destructive"
+      : isCloudBrand
+        ? "border-0 bg-task-status-partial text-task-status-partial-foreground"
+        : "border border-brand-amber-30 bg-brand-amber-10 text-brand-amber",
   );
 
   if (failedCount <= 0 && failedEntries.length === 0) {
@@ -105,9 +111,18 @@ export function TaskErrorContent({
           <div
             className={cn("flex min-w-0 w-full", ossIconColumn && "gap-2.5")}
           >
-            {ossIconColumn && (
-              <ErrorFilled className="size-5 shrink-0 text-destructive" />
-            )}
+            {ossIconColumn &&
+              (isFailedStatus ? (
+                <ErrorFilled
+                  className="size-5 shrink-0 text-destructive"
+                  aria-hidden
+                />
+              ) : (
+                <AlertCircle
+                  className="size-5 shrink-0 text-brand-amber"
+                  aria-hidden
+                />
+              ))}
             <div className="flex min-w-0 flex-1 flex-col gap-1">
               <div className="flex min-w-0 items-center justify-between gap-1.5">
                 <p className="text-mmd truncate">
diff --git a/frontend/components/task-notification-menu.tsx b/frontend/components/task-notification-menu.tsx
index 792b0d102..1ea904799 100644
--- a/frontend/components/task-notification-menu.tsx
+++ b/frontend/components/task-notification-menu.tsx
@@ -132,6 +132,13 @@ export function TaskNotificationMenu() {
     }
   };
 
+  const pastTaskRowClass = cn(
+    "w-full py-mmd px-4 transition-colors hover:bg-muted/60",
+    isCloudBrand ? "border-t border-muted" : "rounded-mmd border border-muted",
+  );
+
+  const statusBadgeBase = "shrink-0 rounded-full px-2 py-1 text-xs font-normal";
+
   const getStatusBadge = (
     status: Task["status"],
     hasFailedFiles = false,
@@ -143,7 +150,12 @@ export function TaskNotificationMenu() {
           return (
             <Badge
               variant="outline"
-              className="rounded-lg bg-red-500/10 text-red-500 border-red-500/20"
+              className={cn(
+                statusBadgeBase,
+                isCloudBrand
+                  ? "border-0 bg-task-status-failed text-task-status-failed-foreground"
+                  : "bg-red-500/10 text-red-500 border-red-500/20",
+              )}
             >
               FAILED
             </Badge>
@@ -153,18 +165,28 @@ export function TaskNotificationMenu() {
           return (
             <Badge
               variant="outline"
-              className="rounded-lg bg-brand-amber-10 text-brand-amber border-brand-amber-30"
+              className={cn(
+                statusBadgeBase,
+                isCloudBrand
+                  ? "border-0 bg-task-status-partial text-task-status-partial-foreground"
+                  : "bg-brand-amber-10 text-brand-amber border-brand-amber-30",
+              )}
             >
-              COMPLETED
+              Complete
             </Badge>
           );
         }
         return (
           <Badge
             variant="outline"
-            className="rounded-lg bg-green-500/10 text-green-500 border-green-500/20"
+            className={cn(
+              statusBadgeBase,
+              isCloudBrand
+                ? "border-0 bg-task-status-complete text-task-status-complete-foreground"
+                : "border border-green-500/20 bg-green-500/10 text-green-500",
+            )}
           >
-            COMPLETED
+            Complete
           </Badge>
         );
       case "failed":
@@ -172,7 +194,12 @@ export function TaskNotificationMenu() {
         return (
           <Badge
             variant="outline"
-            className="rounded-lg bg-red-500/10 text-red-500 border-red-500/20"
+            className={cn(
+              statusBadgeBase,
+              isCloudBrand
+                ? "border-0 bg-task-status-failed text-task-status-failed-foreground"
+                : "bg-red-500/10 text-red-500 border-red-500/20",
+            )}
           >
             FAILED
           </Badge>
@@ -181,7 +208,10 @@ export function TaskNotificationMenu() {
         return (
           <Badge
             variant="outline"
-            className="rounded-lg bg-yellow-500/10 text-yellow-500 border-yellow-500/20"
+            className={cn(
+              statusBadgeBase,
+              "bg-yellow-500/10 text-yellow-500 border-yellow-500/20",
+            )}
           >
             Pending
           </Badge>
@@ -191,7 +221,10 @@ export function TaskNotificationMenu() {
         return (
           <Badge
             variant="outline"
-            className="rounded-lg bg-blue-500/10 text-blue-500 border-blue-500/20"
+            className={cn(
+              statusBadgeBase,
+              "bg-blue-500/10 text-blue-500 border-blue-500/20",
+            )}
           >
             Processing
           </Badge>
@@ -200,7 +233,10 @@ export function TaskNotificationMenu() {
         return (
           <Badge
             variant="outline"
-            className="rounded-lg bg-gray-500/10 text-gray-500 border-gray-500/20"
+            className={cn(
+              statusBadgeBase,
+              "bg-gray-500/10 text-gray-500 border-gray-500/20",
+            )}
           >
             Unknown
           </Badge>
@@ -309,10 +345,15 @@ export function TaskNotificationMenu() {
               </h4>
               {activeTasks.map((task) => {
                 const progress = formatTaskProgress(task);
+                const hasFailedFiles = hasFailedFileEntries(task);
                 const showCancel =
                   task.status === "pending" ||
                   task.status === "running" ||
                   task.status === "processing";
+                const showTaskIcon =
+                  !isCloudBrand ||
+                  task.status !== "completed" ||
+                  hasFailedFiles;
 
                 return (
                   <Card
@@ -322,7 +363,12 @@ export function TaskNotificationMenu() {
                     <CardHeader className="p-0 pb-2">
                       <div className="flex items-center justify-between">
                         <CardTitle className="text-sm flex items-center gap-2">
-                          {getTaskIcon(task.status)}
+                          {showTaskIcon &&
+                            getTaskIcon(
+                              task.status,
+                              hasFailedFiles,
+                              isCompletedTotalFailure(task),
+                            )}
                           Task {task.task_id.substring(0, 8)}...
                         </CardTitle>
                       </div>
@@ -388,12 +434,18 @@ export function TaskNotificationMenu() {
                             </Button>
                           </div>
                         )}
-                        {hasFailedFileEntries(task) && (
+                        {hasFailedFiles && (
                           <div className="mt-3">
                             <TaskErrorContent
+                              key={
+                                selectedTaskId === task.task_id
+                                  ? `${task.task_id}-${selectedTaskTrigger}`
+                                  : task.task_id
+                              }
                               task={task}
                               mode="recent"
                               showHeader={false}
+                              defaultExpanded={selectedTaskId === task.task_id}
                             />
                           </div>
                         )}
@@ -424,26 +476,32 @@ export function TaskNotificationMenu() {
                 const progress = formatTaskProgress(task);
                 const hasFailedFiles = hasFailedFileEntries(task);
                 const isTotalFailure = isCompletedTotalFailure(task);
-                if (isTerminalFailedTask(task) || isTotalFailure) {
+                const shouldExpandDetails = selectedTaskId === task.task_id;
+
+                // Same full card as total failure; partial only differs inside (Complete pill / amber icon).
+                if (
+                  isTerminalFailedTask(task) ||
+                  isTotalFailure ||
+                  hasFailedFiles
+                ) {
                   return (
                     <TaskErrorContent
-                      key={task.task_id}
+                      key={
+                        shouldExpandDetails
+                          ? `${task.task_id}-${selectedTaskTrigger}`
+                          : task.task_id
+                      }
                       task={task}
                       mode="past"
+                      defaultExpanded={shouldExpandDetails}
                     />
                   );
                 }
 
                 return (
-                  <div
-                    key={task.task_id}
-                    className={cn(
-                      "w-full py-mmd px-4 transition-colors hover:bg-muted/50",
-                      isCloudBrand && "border-t border-muted",
-                    )}
-                  >
+                  <div key={task.task_id} className={pastTaskRowClass}>
                     <div className="flex items-start gap-3">
-                      {getTaskIcon(task.status, hasFailedFiles, isTotalFailure)}
+                      {!isCloudBrand && getTaskIcon(task.status)}
                       <div className="flex-1 min-w-0">
                         <div className="text-xs font-medium truncate">
                           Task {task.task_id.substring(0, 8)}...
@@ -456,37 +514,20 @@ export function TaskNotificationMenu() {
                             </span>
                           )}
                         </div>
-                        {task.status === "completed" &&
-                          progress?.detailed &&
-                          !hasFailedFiles && (
-                            <div className="text-xs text-muted-foreground">
-                              {progress.detailed.successful} success,{" "}
-                              {progress.detailed.failed} failed
-                              {(progress.detailed.running || 0) > 0 && (
-                                <span>
-                                  , {progress.detailed.running} running
-                                </span>
-                              )}
-                            </div>
-                          )}
+                        {task.status === "completed" && progress?.detailed && (
+                          <div className="text-xs text-muted-foreground">
+                            {progress.detailed.successful} success,{" "}
+                            {progress.detailed.failed} failed
+                            {(progress.detailed.running || 0) > 0 && (
+                              <span>, {progress.detailed.running} running</span>
+                            )}
+                          </div>
+                        )}
                       </div>
                       <div className="self-start pt-0.5">
-                        {getStatusBadge(
-                          task.status,
-                          hasFailedFiles,
-                          isTotalFailure,
-                        )}
+                        {getStatusBadge(task.status)}
                       </div>
                     </div>
-                    {hasFailedFiles && (
-                      <div className="ml-7">
-                        <TaskErrorContent
-                          task={task}
-                          mode="past"
-                          showHeader={false}
-                        />
-                      </div>
-                    )}
                   </div>
                 );
               }}
diff --git a/frontend/tailwind.config.ts b/frontend/tailwind.config.ts
index 2bcd546a5..cbed098bc 100644
--- a/frontend/tailwind.config.ts
+++ b/frontend/tailwind.config.ts
@@ -199,6 +199,10 @@ const config = {
             DEFAULT: "hsl(var(--task-status-failed-bg))",
             foreground: "hsl(var(--task-status-failed-fg))",
           },
+          partial: {
+            DEFAULT: "hsl(var(--task-status-partial-bg))",
+            foreground: "hsl(var(--task-status-partial-fg))",
+          },
           complete: {
             DEFAULT: "hsl(var(--task-status-complete-bg))",
             foreground: "hsl(var(--task-status-complete-fg))",

From a30991d3b3acc915e008fbc2a0569d1691bccbae Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Thu, 21 May 2026 09:58:36 -0400
Subject: [PATCH 12/25] adding comment for TODO implementation or more clarity

---
 frontend/components/task-error-content.tsx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/frontend/components/task-error-content.tsx b/frontend/components/task-error-content.tsx
index bc61c93f4..c59de1add 100644
--- a/frontend/components/task-error-content.tsx
+++ b/frontend/components/task-error-content.tsx
@@ -52,6 +52,7 @@ export function TaskErrorContent({
   const isFailedStatus =
     isTerminalFailedTask(task) || isCompletedTotalFailure(task);
   const statusLabel = isFailedStatus ? "Failed" : "Complete";
+  // Pill colors: failed (red) vs partial success (amber/orange), each with IBM tokens or OSS borders.
   const statusPillClassName = cn(
     "shrink-0 rounded-full px-2 py-1 text-xs",
     isFailedStatus
@@ -84,6 +85,7 @@ export function TaskErrorContent({
         onClick={(event) => {
           event.preventDefault();
           event.stopPropagation();
+          // TODO: open report-incident dialog
         }}
         onPointerDown={(event) => event.stopPropagation()}
       >

From 357ca70f7388b5976d1ac418f18b2d27f00f8813 Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Tue, 26 May 2026 15:11:00 -0400
Subject: [PATCH 13/25] Introduce a modular TaskDialog for reviewing task files
 from the error panel, with brand-specific header, filters, category chips,
 and tabs. Wire list/detail helpers and ingestion failure display; fix nested
 button hydration in the task error accordion.

---
 frontend/app/api/queries/useGetTaskQuery.ts   |  27 ++
 frontend/app/api/queries/useGetTasksQuery.ts  |  10 +
 frontend/app/globals.css                      |   6 +
 .../components/task-dialog/category-chips.tsx |  65 ++++
 frontend/components/task-dialog/constants.ts  |  40 +++
 .../task-dialog/file-error-details.tsx        | 125 ++++++++
 frontend/components/task-dialog/file-list.tsx | 289 +++++++++++++++++
 frontend/components/task-dialog/filters.tsx   | 156 ++++++++++
 frontend/components/task-dialog/header.tsx    |  97 ++++++
 frontend/components/task-dialog/index.ts      |   1 +
 .../components/task-dialog/task-dialog.tsx    | 121 ++++++++
 .../components/task-dialog/use-task-dialog.ts |  90 ++++++
 frontend/components/task-error-content.tsx    |  70 +++--
 frontend/components/tasks_details.tsx         |  16 +-
 frontend/lib/task-error-display.ts            | 291 +++++++++++++++++-
 frontend/lib/task-utils.ts                    | 209 +++++++++++++
 frontend/package-lock.json                    |  35 ---
 frontend/package.json                         |   1 -
 frontend/tailwind.config.ts                   |   3 +
 19 files changed, 1559 insertions(+), 93 deletions(-)
 create mode 100644 frontend/app/api/queries/useGetTaskQuery.ts
 create mode 100644 frontend/components/task-dialog/category-chips.tsx
 create mode 100644 frontend/components/task-dialog/constants.ts
 create mode 100644 frontend/components/task-dialog/file-error-details.tsx
 create mode 100644 frontend/components/task-dialog/file-list.tsx
 create mode 100644 frontend/components/task-dialog/filters.tsx
 create mode 100644 frontend/components/task-dialog/header.tsx
 create mode 100644 frontend/components/task-dialog/index.ts
 create mode 100644 frontend/components/task-dialog/task-dialog.tsx
 create mode 100644 frontend/components/task-dialog/use-task-dialog.ts

diff --git a/frontend/app/api/queries/useGetTaskQuery.ts b/frontend/app/api/queries/useGetTaskQuery.ts
new file mode 100644
index 000000000..be735c858
--- /dev/null
+++ b/frontend/app/api/queries/useGetTaskQuery.ts
@@ -0,0 +1,27 @@
+import { type UseQueryOptions, useQuery } from "@tanstack/react-query";
+import type { Task } from "@/app/api/queries/useGetTasksQuery";
+
+export function useGetTaskQuery(
+  taskId: string | null,
+  options?: Omit<UseQueryOptions<Task | null>, "queryKey" | "queryFn">,
+) {
+  return useQuery({
+    queryKey: ["tasks", taskId],
+    queryFn: async (): Promise<Task | null> => {
+      if (!taskId) {
+        return null;
+      }
+      //will be replace /api/tasks/{taskId}/enhanced, when backend merged
+      const response = await fetch(`/api/tasks/${taskId}`);
+      if (response.status === 404) {
+        return null;
+      }
+      if (!response.ok) {
+        throw new Error("Failed to fetch task");
+      }
+      return response.json() as Promise<Task>;
+    },
+    enabled: !!taskId,
+    ...options,
+  });
+}
diff --git a/frontend/app/api/queries/useGetTasksQuery.ts b/frontend/app/api/queries/useGetTasksQuery.ts
index bcdfa9d14..7a5d57004 100644
--- a/frontend/app/api/queries/useGetTasksQuery.ts
+++ b/frontend/app/api/queries/useGetTasksQuery.ts
@@ -21,6 +21,16 @@ export interface TaskFileEntry {
   filename?: string;
   embedding_model?: string;
   embedding_dimensions?: number;
+  /** Ingestion pipeline phase from the task service (`docling` | `langflow` | `complete`). */
+  phase?: "docling" | "langflow" | "complete" | string;
+  /**
+   * Phase or step where ingestion failed (from API).
+   * Ingestion phase: `docling` | `langflow` | `complete`.
+   * Pipeline step: `parsing` | `chunking` | `embedding` | `indexing`.
+   */
+  failure_phase?: string;
+  docling_status?: string;
+  docling_task_id?: string;
   [key: string]: unknown;
 }
 
diff --git a/frontend/app/globals.css b/frontend/app/globals.css
index fad853f2f..77a5a5198 100644
--- a/frontend/app/globals.css
+++ b/frontend/app/globals.css
@@ -31,6 +31,8 @@
     --placeholder-foreground: 240 5% 65%;
 
     /* App-level UI tokens (safe defaults, override per brand/theme) */
+    --canvas: 0 0% 100%;
+    --border-subtle-background-contextual: var(--border);
     --layered-select-bg: hsl(var(--muted) / 0.5);
     --chat-surface-gradient: rgba(69, 137, 255, 0.16);
     --chat-input-border: hsl(var(--input));
@@ -115,6 +117,8 @@
     --placeholder-foreground: 240 4% 46%;
 
     /* App-level UI tokens (safe defaults, override per brand/theme) */
+    --canvas: 0 0% 3.9%; /* #0A0A0A */
+    --border-subtle-background-contextual: var(--border);
     --layered-select-bg: hsl(var(--muted) / 0.5);
     --chat-surface-gradient: rgba(69, 137, 255, 0.16);
     --chat-input-border: hsl(var(--input));
@@ -230,6 +234,7 @@
     --layered-select-bg: rgba(131, 131, 131, 0.24);
     --chat-input-border: #f4f4f4;
     --icon-disabled: #525252;
+    --border-subtle-background-contextual: 0 0% 82%;
     /* Contextual layer (~Gray 100); use hsl(var(--layer-contextual)) */
     /* Layer / contextual surfaces (IBM Gray 10 light, Gray 100 dark) */
     --layer-contextual: 0 0% 96%;
@@ -330,6 +335,7 @@
     --icon-primary: 0 0% 96%; /* #f4f4f4*/
     --placeholder: 0 0% 44%; /* #6F6F6F */
 
+    --border-subtle-background-contextual: 0 0% 22.4%; /* #393939 */
     --layer-contextual: 0 0% 15%;
     --layer-contextual-foreground: 0 0% 96%;
     --text-text-01: 0 0% 96%;
diff --git a/frontend/components/task-dialog/category-chips.tsx b/frontend/components/task-dialog/category-chips.tsx
new file mode 100644
index 000000000..3ed341cb8
--- /dev/null
+++ b/frontend/components/task-dialog/category-chips.tsx
@@ -0,0 +1,65 @@
+"use client";
+
+import {
+  ALL_TASK_STATUS_CATEGORIES,
+  type TaskFileStatusCategory,
+} from "@/lib/task-utils";
+import { cn } from "@/lib/utils";
+import { CATEGORY_CHIPS } from "./constants";
+
+interface TaskDialogCategoryChipsProps {
+  isCloudBrand: boolean;
+  counts: Record<TaskFileStatusCategory, number> | null;
+  statusCategory: string;
+  onStatusCategoryChange: (value: string) => void;
+}
+
+export function TaskDialogCategoryChips({
+  isCloudBrand,
+  counts,
+  statusCategory,
+  onStatusCategoryChange,
+}: TaskDialogCategoryChipsProps) {
+  if (!counts) return null;
+
+  return (
+    <div
+      className={cn(
+        "flex flex-wrap items-center",
+        isCloudBrand ? "gap-2" : "gap-1.5",
+      )}
+    >
+      {CATEGORY_CHIPS.map((chip) => {
+        const Icon = chip.icon;
+        const isActive = statusCategory === chip.id;
+        const count = counts[chip.id];
+
+        return (
+          <button
+            key={chip.id}
+            type="button"
+            onClick={() =>
+              onStatusCategoryChange(
+                isActive ? ALL_TASK_STATUS_CATEGORIES : chip.id,
+              )
+            }
+            className={cn(
+              "inline-flex min-h-10 items-center gap-2 border text-sm transition-colors",
+              isCloudBrand ? "px-4" : "px-3",
+              isCloudBrand ? "rounded-full" : "rounded-lg",
+              isActive
+                ? "border-badge bg-badge text-foreground"
+                : "border-border bg-muted hover:bg-badge hover:text-badge-foreground",
+            )}
+          >
+            <Icon className={cn("size-4 shrink-0", chip.iconClassName)} />
+            <span>{chip.label}</span>
+            <span className="rounded-md bg-muted px-1.5 py-0.5 text-xs font-medium tabular-nums">
+              {count}
+            </span>
+          </button>
+        );
+      })}
+    </div>
+  );
+}
diff --git a/frontend/components/task-dialog/constants.ts b/frontend/components/task-dialog/constants.ts
new file mode 100644
index 000000000..1c0351dbd
--- /dev/null
+++ b/frontend/components/task-dialog/constants.ts
@@ -0,0 +1,40 @@
+import {
+  AlertCircle,
+  CheckCircle,
+  Clock,
+  Focus,
+  type LucideIcon,
+} from "lucide-react";
+import type { TaskFileStatusCategory } from "@/lib/task-utils";
+
+export const CATEGORY_CHIPS: Array<{
+  id: TaskFileStatusCategory;
+  label: string;
+  icon: LucideIcon;
+  iconClassName: string;
+}> = [
+  {
+    id: "completed",
+    label: "Completed",
+    icon: CheckCircle,
+    iconClassName: "text-emerald-500",
+  },
+  {
+    id: "system_error",
+    label: "System error",
+    icon: AlertCircle,
+    iconClassName: "text-destructive",
+  },
+  {
+    id: "indexing",
+    label: "Indexing",
+    icon: Clock,
+    iconClassName: "text-muted-foreground",
+  },
+  {
+    id: "partial",
+    label: "Partial",
+    icon: Focus,
+    iconClassName: "text-muted-foreground",
+  },
+];
diff --git a/frontend/components/task-dialog/file-error-details.tsx b/frontend/components/task-dialog/file-error-details.tsx
new file mode 100644
index 000000000..7a13b6dd0
--- /dev/null
+++ b/frontend/components/task-dialog/file-error-details.tsx
@@ -0,0 +1,125 @@
+"use client";
+
+import { Ban, Check, Flag } from "lucide-react";
+import type { TaskFileEntry } from "@/app/api/queries/useGetTasksQuery";
+import {
+  analyzeTaskFileIngestionFailure,
+  type TaskFileIngestionFailureAnalysis,
+} from "@/lib/task-error-display";
+import { cn } from "@/lib/utils";
+
+interface TaskDialogFileErrorDetailsProps {
+  isCloudBrand: boolean;
+  indentClassName?: string;
+  fileInfo: TaskFileEntry;
+  taskError?: string;
+  analysis?: TaskFileIngestionFailureAnalysis;
+}
+
+export function TaskDialogFileErrorDetails({
+  isCloudBrand,
+  indentClassName,
+  fileInfo,
+  taskError,
+  analysis: analysisProp,
+}: TaskDialogFileErrorDetailsProps) {
+  const analysis =
+    analysisProp ?? analyzeTaskFileIngestionFailure(fileInfo, taskError);
+
+  return (
+    <div
+      className={cn(
+        "flex flex-col",
+        isCloudBrand
+          ? "gap-3 pl-9 pr-4 pb-4"
+          : cn(
+              "gap-1 border-t border-muted/60 py-2 pr-3",
+              indentClassName ?? "pl-[4.75rem]",
+            ),
+      )}
+    >
+      <div className="flex flex-col">
+        {analysis.pipelineSteps.map((step, index) => {
+          const isFailed = step.status === "failed";
+          const isLast = index === analysis.pipelineSteps.length - 1;
+
+          return (
+            <div key={step.id} className="flex gap-3">
+              <div className="flex flex-col items-center">
+                {step.status === "completed" ? (
+                  <Check
+                    className="h-4 w-4 shrink-0 text-emerald-600 dark:text-emerald-400"
+                    aria-hidden
+                  />
+                ) : (
+                  <Ban
+                    className="h-4 w-4 shrink-0 text-destructive"
+                    aria-hidden
+                  />
+                )}
+                {!isLast && (
+                  <span
+                    className={cn(
+                      "my-1 w-px flex-1 min-h-3",
+                      step.status === "completed"
+                        ? "bg-emerald-500/40"
+                        : "bg-destructive/40",
+                    )}
+                  />
+                )}
+              </div>
+
+              <div
+                className={cn(
+                  "min-w-0 flex-1",
+                  !isLast && (isCloudBrand ? "pb-3" : "pb-1.5"),
+                )}
+              >
+                <p
+                  className={cn(
+                    "text-sm",
+                    isFailed
+                      ? "text-muted-foreground"
+                      : "text-muted-foreground/80",
+                  )}
+                >
+                  {step.label}
+                </p>
+                {isFailed && (
+                  <div
+                    className={cn(
+                      isCloudBrand ? "mt-2 space-y-2" : "mt-1 space-y-1",
+                    )}
+                  >
+                    <p className="whitespace-pre-wrap break-words text-sm text-foreground/90">
+                      {analysis.resolvedError}
+                    </p>
+                    <p className="text-xs text-muted-foreground">
+                      {analysis.failureSummary}
+                    </p>
+                    {analysis.componentTags.length > 0 && (
+                      <div className="flex flex-wrap items-center gap-2 pt-1">
+                        <Flag
+                          className="size-3 shrink-0 text-destructive"
+                          aria-hidden
+                        />
+                        {analysis.componentTags.map((tag) => (
+                          <span
+                            key={tag}
+                            className="text-xs text-failure-component-cause"
+                          >
+                            {tag}
+                          </span>
+                        ))}
+                      </div>
+                    )}
+                  </div>
+                )}
+              </div>
+            </div>
+          );
+        })}
+      </div>
+    </div>
+  );
+}
diff --git a/frontend/components/task-dialog/file-list.tsx b/frontend/components/task-dialog/file-list.tsx
new file mode 100644
index 000000000..2a4afc80b
--- /dev/null
+++ b/frontend/components/task-dialog/file-list.tsx
@@ -0,0 +1,289 @@
+"use client";
+
+import { ArrowUpAZ, ChevronDown, FileText } from "lucide-react";
+import { useEffect, useMemo, useState } from "react";
+import type { TaskFileEntry } from "@/app/api/queries/useGetTasksQuery";
+import type { Task } from "@/contexts/task-context";
+import { analyzeTaskFileIngestionFailure } from "@/lib/task-error-display";
+import {
+  getTaskFileDialogStatusLabel,
+  getTaskFileName,
+  isTaskFileFailed,
+  type TaskFileNameSort,
+} from "@/lib/task-utils";
+import { cn } from "@/lib/utils";
+import { TaskDialogFileErrorDetails } from "./file-error-details";
+
+const OSS_ERROR_INDENT = "pl-9";
+
+type TaskDialogFileListTab = "task-ingestions" | "retry-ingestions";
+
+interface TaskDialogFileListProps {
+  isCloudBrand: boolean;
+  task: Task;
+  entries: Array<[string, TaskFileEntry]>;
+  totalSourceCount: number;
+  totalSourceCountAll?: number;
+  nameSort: TaskFileNameSort;
+  onToggleNameSort: () => void;
+  expandedPath: string | null;
+  onExpandedPathChange: (path: string | null) => void;
+  /** Retry-ingestion row count; tab is shown only when greater than zero. */
+  retryIngestionCount?: number;
+}
+
+export function TaskDialogFileList({
+  isCloudBrand,
+  task,
+  entries,
+  totalSourceCount,
+  totalSourceCountAll,
+  nameSort,
+  onToggleNameSort,
+  expandedPath,
+  onExpandedPathChange,
+  retryIngestionCount = 0,
+}: TaskDialogFileListProps) {
+  const [activeTab, setActiveTab] =
+    useState<TaskDialogFileListTab>("task-ingestions");
+
+  const showRetryIngestionsTab = retryIngestionCount > 0;
+
+  useEffect(() => {
+    if (!showRetryIngestionsTab && activeTab === "retry-ingestions") {
+      setActiveTab("task-ingestions");
+    }
+  }, [showRetryIngestionsTab, activeTab]);
+
+  const analysisByPath = useMemo(() => {
+    const map = new Map<
+      string,
+      ReturnType<typeof analyzeTaskFileIngestionFailure>
+    >();
+    for (const [filePath, fileInfo] of entries) {
+      if (isTaskFileFailed(fileInfo)) {
+        map.set(
+          filePath,
+          analyzeTaskFileIngestionFailure(fileInfo, task.error),
+        );
+      }
+    }
+    return map;
+  }, [entries, task.error]);
+
+  if (entries.length === 0) {
+    return (
+      <p
+        className={cn(
+          "text-center text-sm text-muted-foreground",
+          isCloudBrand ? "py-6" : "px-4 py-4",
+        )}
+      >
+        No files match your filters.
+      </p>
+    );
+  }
+
+  const containerClass = cn(
+    "flex min-h-0 flex-1 flex-col overflow-hidden",
+    isCloudBrand ? "rounded-md border" : "border-b border-muted",
+  );
+
+  const taskIngestionsTabCount =
+    totalSourceCountAll != null && totalSourceCountAll > totalSourceCount
+      ? `${totalSourceCount} of ${totalSourceCountAll}`
+      : String(totalSourceCount);
+
+  const isTabActive = (tab: TaskDialogFileListTab) => activeTab === tab;
+
+  const tabTriggerClass = (tab: TaskDialogFileListTab) => {
+    const isActive = isTabActive(tab);
+    return cn(
+      "inline-flex w-fit max-w-fit min-h-10 shrink-0 items-center px-4 text-sm font-medium transition-colors",
+      isCloudBrand
+        ? cn(
+            "rounded-none border-0 border-b-2",
+            isActive
+              ? "border-[var(--border-border-interactive)] bg-muted text-foreground"
+              : "border-transparent bg-transparent text-muted-foreground hover:border-[var(--border-border-interactive)]",
+          )
+        : cn(
+            "border-0",
+            isActive
+              ? "rounded-none rounded-t-lg bg-muted text-foreground"
+              : "rounded-none bg-transparent text-muted-foreground hover:text-foreground",
+          ),
+    );
+  };
+
+  const listScrollClass = "min-h-0 flex-1 overflow-y-auto overscroll-contain";
+
+  const fileRows = entries.map(([filePath, fileInfo]) => {
+    const fileName = getTaskFileName(filePath, fileInfo);
+    const failed = isTaskFileFailed(fileInfo);
+    const analysis = analysisByPath.get(filePath);
+    const rowStatusLabel = failed
+      ? (analysis?.rowStatusLabel ?? "Failed")
+      : getTaskFileDialogStatusLabel(fileInfo, task.error);
+    const isExpanded = expandedPath === filePath;
+
+    return (
+      <div
+        key={filePath}
+        className={cn(
+          "border-b last:border-b-0",
+          isCloudBrand ? "border-border" : "border-muted",
+        )}
+      >
+        <div
+          className={cn(
+            "grid min-h-10 grid-cols-[auto_1fr_auto] items-center gap-3",
+            isCloudBrand ? "px-4 hover:bg-muted/40" : "px-3 hover:bg-muted/30",
+          )}
+        >
+          {failed ? (
+            <button
+              type="button"
+              aria-label={isExpanded ? "Collapse error" : "Expand error"}
+              aria-expanded={isExpanded}
+              onClick={() => onExpandedPathChange(isExpanded ? null : filePath)}
+              className="inline-flex h-5 w-5 items-center justify-center text-muted-foreground hover:text-foreground"
+            >
+              <ChevronDown
+                className={cn(
+                  "h-4 w-4 transition-transform",
+                  isExpanded && "rotate-180",
+                )}
+              />
+            </button>
+          ) : (
+            <span className="h-5 w-5" aria-hidden />
+          )}
+          <button
+            type="button"
+            className={cn(
+              "flex min-w-0 items-center gap-2 text-left",
+              failed && "cursor-pointer",
+            )}
+            onClick={() => {
+              if (!failed) return;
+              onExpandedPathChange(isExpanded ? null : filePath);
+            }}
+            disabled={!failed}
+          >
+            <FileText className="h-4 w-4 shrink-0 text-muted-foreground" />
+            <span
+              className={cn("truncate text-sm", failed && "text-foreground")}
+              title={fileName}
+            >
+              {fileName}
+            </span>
+          </button>
+          <span
+            className={cn(
+              "shrink-0 text-sm",
+              failed
+                ? "text-destructive"
+                : rowStatusLabel === "Complete"
+                  ? "text-emerald-600 dark:text-emerald-400"
+                  : "text-muted-foreground",
+            )}
+          >
+            {rowStatusLabel}
+          </span>
+        </div>
+
+        {failed && isExpanded && analysis && (
+          <TaskDialogFileErrorDetails
+            isCloudBrand={isCloudBrand}
+            indentClassName={!isCloudBrand ? OSS_ERROR_INDENT : ""}
+            fileInfo={fileInfo}
+            taskError={task.error}
+            analysis={analysis}
+          />
+        )}
+      </div>
+    );
+  });
+
+  return (
+    <div className={containerClass}>
+      <div
+        className="flex w-fit max-w-fit shrink-0 items-end gap-1 p-0"
+        role="tablist"
+        aria-label="Task file views"
+      >
+        <button
+          type="button"
+          role="tab"
+          id="task-dialog-tab-task-ingestions"
+          aria-selected={isTabActive("task-ingestions")}
+          aria-controls="task-dialog-panel-task-ingestions"
+          className={tabTriggerClass("task-ingestions")}
+          onClick={() => setActiveTab("task-ingestions")}
+        >
+          Task ingestions ({taskIngestionsTabCount})
+        </button>
+        {showRetryIngestionsTab && (
+          <button
+            type="button"
+            role="tab"
+            id="task-dialog-tab-retry-ingestions"
+            aria-selected={isTabActive("retry-ingestions")}
+            aria-controls="task-dialog-panel-retry-ingestions"
+            className={tabTriggerClass("retry-ingestions")}
+            onClick={() => setActiveTab("retry-ingestions")}
+          >
+            Retry ingestions ({retryIngestionCount})
+          </button>
+        )}
+      </div>
+
+      {isTabActive("task-ingestions") ? (
+        <div className="flex min-h-0 flex-1 flex-col overflow-hidden">
+          <div
+            className={cn(
+              "flex min-h-10 shrink-0 items-center gap-1 bg-muted text-sm font-medium text-muted-foreground",
+              isCloudBrand ? "px-4" : "px-3",
+            )}
+          >
+            <button
+              type="button"
+              className="inline-flex items-center gap-1 hover:text-foreground"
+              onClick={onToggleNameSort}
+            >
+              <span>Source</span>
+              <ArrowUpAZ
+                className={cn(
+                  "h-3.5 w-3.5",
+                  isCloudBrand ? "opacity-70" : "opacity-50",
+                  nameSort === "desc" && "rotate-180",
+                )}
+                aria-hidden
+              />
+              <span className="sr-only">
+                Sort by name {nameSort === "asc" ? "A to Z" : "Z to A"}
+              </span>
+            </button>
+          </div>
+          <div
+            id="task-dialog-panel-task-ingestions"
+            role="tabpanel"
+            aria-labelledby="task-dialog-tab-task-ingestions"
+            className={listScrollClass}
+          >
+            {fileRows}
+          </div>
+        </div>
+      ) : (
+        <div
+          id="task-dialog-panel-retry-ingestions"
+          role="tabpanel"
+          aria-labelledby="task-dialog-tab-retry-ingestions"
+          className={cn("flex min-h-0 flex-1 flex-col", listScrollClass)}
+          aria-hidden={!showRetryIngestionsTab}
+        />
+      )}
+    </div>
+  );
+}
diff --git a/frontend/components/task-dialog/filters.tsx b/frontend/components/task-dialog/filters.tsx
new file mode 100644
index 000000000..9ed34c512
--- /dev/null
+++ b/frontend/components/task-dialog/filters.tsx
@@ -0,0 +1,156 @@
+"use client";
+
+import { ChevronDown, Search } from "lucide-react";
+import type { ReactNode } from "react";
+import { Button } from "@/components/ui/button";
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuTrigger,
+} from "@/components/ui/dropdown-menu";
+import { Input } from "@/components/ui/input";
+import { ALL_TASK_FILE_TYPES, formatTaskFileTypeLabel } from "@/lib/task-utils";
+import { cn } from "@/lib/utils";
+
+interface TaskDialogFiltersProps {
+  isCloudBrand: boolean;
+  search: string;
+  onSearchChange: (value: string) => void;
+  fileType: string;
+  onFileTypeChange: (value: string) => void;
+  fileTypes: string[];
+  fileTypeLabel: string;
+  searchDisabled: boolean;
+  fileTypeDisabled: boolean;
+}
+
+function fileTypeItemClassName(selected: boolean) {
+  return cn(
+    "px-2",
+    selected &&
+      "bg-muted text-foreground focus:bg-muted data-[highlighted]:bg-muted",
+  );
+}
+
+function FileTypeMenu({
+  fileType,
+  onFileTypeChange,
+  fileTypes,
+  allTypesLabel,
+  trigger,
+}: {
+  fileType: string;
+  onFileTypeChange: (value: string) => void;
+  fileTypes: string[];
+  allTypesLabel: string;
+  trigger: ReactNode;
+}) {
+  const options = [
+    { value: ALL_TASK_FILE_TYPES, label: allTypesLabel },
+    ...fileTypes.map((type) => ({
+      value: type,
+      label: formatTaskFileTypeLabel(type),
+    })),
+  ];
+
+  return (
+    <DropdownMenu>
+      <DropdownMenuTrigger asChild>{trigger}</DropdownMenuTrigger>
+      <DropdownMenuContent align="end" className="w-[160px]">
+        {options.map(({ value, label }) => (
+          <DropdownMenuItem
+            key={value}
+            onSelect={() => onFileTypeChange(value)}
+            className={fileTypeItemClassName(fileType === value)}
+          >
+            {label}
+          </DropdownMenuItem>
+        ))}
+      </DropdownMenuContent>
+    </DropdownMenu>
+  );
+}
+
+export function TaskDialogFilters({
+  isCloudBrand,
+  search,
+  onSearchChange,
+  fileType,
+  onFileTypeChange,
+  fileTypes,
+  fileTypeLabel,
+  searchDisabled,
+  fileTypeDisabled,
+}: TaskDialogFiltersProps) {
+  const allTypesLabel = isCloudBrand ? "All categories" : "All file types";
+
+  if (isCloudBrand) {
+    return (
+      <div className="flex min-h-10 items-stretch border-b border-border [&_input]:min-h-10">
+        <div className="min-w-0 flex-1 border-r border-border-subtle-contextual bg-layer-contextual">
+          <Input
+            type="search"
+            autoComplete="off"
+            placeholder="Search files..."
+            value={search}
+            onChange={(e) => onSearchChange(e.target.value)}
+            disabled={searchDisabled}
+            icon={<Search className="h-4 w-4" aria-hidden />}
+            inputClassName="h-10 min-w-0 !rounded-none !border-0 bg-layer-contextual text-layer-contextual-foreground placeholder:text-muted-foreground focus:outline-none disabled:cursor-not-allowed disabled:opacity-50"
+          />
+        </div>
+        <FileTypeMenu
+          fileType={fileType}
+          onFileTypeChange={onFileTypeChange}
+          fileTypes={fileTypes}
+          allTypesLabel={allTypesLabel}
+          trigger={
+            <button
+              type="button"
+              disabled={fileTypeDisabled}
+              className="inline-flex min-h-10 w-[160px] shrink-0 items-center justify-between gap-2 px-4 text-sm text-muted-foreground transition-colors hover:text-foreground disabled:pointer-events-none disabled:opacity-50"
+            >
+              <span className="truncate">{fileTypeLabel}</span>
+              <ChevronDown className="h-4 w-4 shrink-0 opacity-70" />
+            </button>
+          }
+        />
+      </div>
+    );
+  }
+
+  return (
+    <div className="flex min-h-10 items-center gap-2">
+      <div className="relative min-w-0 flex-1">
+        <Input
+          type="search"
+          autoComplete="off"
+          placeholder="Search connectors..."
+          value={search}
+          onChange={(e) => onSearchChange(e.target.value)}
+          disabled={searchDisabled}
+          icon={<Search className="h-4 w-4" aria-hidden />}
+          inputClassName="h-10 rounded-md !bg-canvas"
+        />
+      </div>
+      <FileTypeMenu
+        fileType={fileType}
+        onFileTypeChange={onFileTypeChange}
+        fileTypes={fileTypes}
+        allTypesLabel={allTypesLabel}
+        trigger={
+          <Button
+            type="button"
+            variant="outline"
+            disabled={fileTypeDisabled}
+            className="min-h-10 h-10 w-[160px] shrink-0 justify-between font-normal"
+          >
+            <span className="truncate">{fileTypeLabel}</span>
+            <ChevronDown className="ml-2 h-4 w-4 shrink-0 opacity-50" />
+          </Button>
+        }
+      />
+    </div>
+  );
+}
diff --git a/frontend/components/task-dialog/header.tsx b/frontend/components/task-dialog/header.tsx
new file mode 100644
index 000000000..2a42284b9
--- /dev/null
+++ b/frontend/components/task-dialog/header.tsx
@@ -0,0 +1,97 @@
+"use client";
+
+import { DialogHeader, DialogTitle } from "@/components/ui/dialog";
+import {
+  ALL_TASK_FILE_TYPES,
+  formatTaskFileTypeLabel,
+  type TaskFileStatusCategory,
+} from "@/lib/task-utils";
+import { cn } from "@/lib/utils";
+import { TaskDialogCategoryChips } from "./category-chips";
+import { TaskDialogFilters } from "./filters";
+
+interface TaskDialogHeaderProps {
+  isCloudBrand: boolean;
+  taskId: string;
+  search: string;
+  onSearchChange: (value: string) => void;
+  fileType: string;
+  onFileTypeChange: (value: string) => void;
+  fileTypes: string[];
+  statusCategory: string;
+  onStatusCategoryChange: (value: string) => void;
+  categoryCounts: Record<TaskFileStatusCategory, number> | null;
+  filtersDisabled: boolean;
+  fileTypeDisabled: boolean;
+}
+
+export function TaskDialogHeader({
+  isCloudBrand,
+  taskId,
+  search,
+  onSearchChange,
+  fileType,
+  onFileTypeChange,
+  fileTypes,
+  statusCategory,
+  onStatusCategoryChange,
+  categoryCounts,
+  filtersDisabled,
+  fileTypeDisabled,
+}: TaskDialogHeaderProps) {
+  const allTypesLabel = isCloudBrand ? "All categories" : "All file types";
+  const fileTypeLabel =
+    fileType === ALL_TASK_FILE_TYPES
+      ? allTypesLabel
+      : formatTaskFileTypeLabel(fileType);
+
+  return (
+    <header
+      className={cn(
+        "shrink-0 flex-none",
+        isCloudBrand ? "border-b border-border" : "border-b-0",
+      )}
+    >
+      <DialogHeader
+        className={cn(
+          "space-y-0 border-b-0 text-left",
+          isCloudBrand ? "px-6 pt-4 pb-3" : "pt-3 pb-2 pr-12",
+        )}
+      >
+        <DialogTitle
+          className={cn(
+            "py-2 text-base font-semibold leading-snug",
+            !isCloudBrand && "px-4",
+          )}
+        >
+          Task {taskId}
+        </DialogTitle>
+      </DialogHeader>
+
+      <div
+        className={cn(
+          "flex flex-col gap-2 border-b-0",
+          isCloudBrand ? "gap-3 px-4 pb-4" : "px-4 pb-3",
+        )}
+      >
+        <TaskDialogFilters
+          isCloudBrand={isCloudBrand}
+          search={search}
+          onSearchChange={onSearchChange}
+          fileType={fileType}
+          onFileTypeChange={onFileTypeChange}
+          fileTypes={fileTypes}
+          fileTypeLabel={fileTypeLabel}
+          searchDisabled={filtersDisabled}
+          fileTypeDisabled={fileTypeDisabled}
+        />
+        <TaskDialogCategoryChips
+          isCloudBrand={isCloudBrand}
+          counts={categoryCounts}
+          statusCategory={statusCategory}
+          onStatusCategoryChange={onStatusCategoryChange}
+        />
+      </div>
+    </header>
+  );
+}
diff --git a/frontend/components/task-dialog/index.ts b/frontend/components/task-dialog/index.ts
new file mode 100644
index 000000000..5d29db243
--- /dev/null
+++ b/frontend/components/task-dialog/index.ts
@@ -0,0 +1 @@
+export { default } from "./task-dialog";
diff --git a/frontend/components/task-dialog/task-dialog.tsx b/frontend/components/task-dialog/task-dialog.tsx
new file mode 100644
index 000000000..e4da75aea
--- /dev/null
+++ b/frontend/components/task-dialog/task-dialog.tsx
@@ -0,0 +1,121 @@
+"use client";
+
+import { Button } from "@/components/ui/button";
+import { Dialog, DialogContent, DialogFooter } from "@/components/ui/dialog";
+import { useIsCloudBrand } from "@/contexts/brand-context";
+import { cn } from "@/lib/utils";
+import { TaskDialogFileList } from "./file-list";
+import { TaskDialogHeader } from "./header";
+import { useTaskDialog } from "./use-task-dialog";
+
+interface TaskDialogProps {
+  open: boolean;
+  task_id: string;
+  onOpenChange: (open: boolean) => void;
+  onClose: () => void;
+}
+
+function TaskDialogContent({
+  open,
+  task_id,
+  onClose,
+}: Pick<TaskDialogProps, "open" | "task_id" | "onClose">) {
+  const isCloudBrand = useIsCloudBrand();
+  const {
+    task,
+    fileEntries,
+    fileTypes,
+    categoryCounts,
+    sortedEntries,
+    search,
+    setSearch,
+    fileType,
+    setFileType,
+    statusCategory,
+    setStatusCategory,
+    expandedPath,
+    setExpandedPath,
+    nameSort,
+    toggleNameSort,
+  } = useTaskDialog(open, task_id);
+
+  const filtersDisabled = !task;
+  const fileTypeDisabled = !task || fileTypes.length === 0;
+
+  return (
+    <div className="flex min-h-0 flex-1 flex-col overflow-hidden">
+      <TaskDialogHeader
+        isCloudBrand={isCloudBrand}
+        taskId={task_id}
+        search={search}
+        onSearchChange={setSearch}
+        fileType={fileType}
+        onFileTypeChange={setFileType}
+        fileTypes={fileTypes}
+        statusCategory={statusCategory}
+        onStatusCategoryChange={setStatusCategory}
+        categoryCounts={categoryCounts}
+        filtersDisabled={filtersDisabled}
+        fileTypeDisabled={fileTypeDisabled}
+      />
+
+      <div
+        className={cn(
+          "flex min-h-0 flex-1 flex-col overflow-hidden",
+          !isCloudBrand && "px-4",
+        )}
+      >
+        {!task ? (
+          <p className="text-sm text-muted-foreground">Task not found.</p>
+        ) : fileEntries.length === 0 ? (
+          <p className="text-sm text-muted-foreground">
+            No files in this task.
+          </p>
+        ) : (
+          <TaskDialogFileList
+            isCloudBrand={isCloudBrand}
+            task={task}
+            entries={sortedEntries}
+            totalSourceCount={sortedEntries.length}
+            totalSourceCountAll={fileEntries.length}
+            nameSort={nameSort}
+            onToggleNameSort={toggleNameSort}
+            expandedPath={expandedPath}
+            onExpandedPathChange={setExpandedPath}
+          />
+        )}
+      </div>
+
+      <DialogFooter
+        className={cn(
+          "shrink-0 flex-row items-center border-t sm:justify-end",
+          isCloudBrand ? "px-6 py-4" : "px-4 py-3",
+        )}
+      >
+        <Button type="button" variant="ghost" onClick={onClose}>
+          {isCloudBrand ? "Cancel" : "Close"}
+        </Button>
+      </DialogFooter>
+    </div>
+  );
+}
+
+export default function TaskDialog({
+  open,
+  onOpenChange,
+  task_id,
+  onClose,
+}: TaskDialogProps) {
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent className="flex max-h-[90vh] w-[640px] max-w-[640px] flex-col gap-0 overflow-hidden p-0 sm:rounded-lg">
+        <TaskDialogContent
+          key={task_id}
+          open={open}
+          task_id={task_id}
+          onClose={onClose}
+        />
+      </DialogContent>
+    </Dialog>
+  );
+}
diff --git a/frontend/components/task-dialog/use-task-dialog.ts b/frontend/components/task-dialog/use-task-dialog.ts
new file mode 100644
index 000000000..97d169d92
--- /dev/null
+++ b/frontend/components/task-dialog/use-task-dialog.ts
@@ -0,0 +1,90 @@
+"use client";
+
+import { useMemo, useState } from "react";
+import { useGetTaskQuery } from "@/app/api/queries/useGetTaskQuery";
+import type { Task } from "@/app/api/queries/useGetTasksQuery";
+import { useTask } from "@/contexts/task-context";
+import {
+  ALL_TASK_FILE_TYPES,
+  ALL_TASK_STATUS_CATEGORIES,
+  countTaskFilesByCategory,
+  filterTaskFileEntries,
+  getTaskFileEntries,
+  getTaskFileTypes,
+  sortTaskFileEntries,
+  type TaskFileNameSort,
+  TaskFileStatusCategory,
+} from "@/lib/task-utils";
+
+export function useTaskDialog(open: boolean, taskId: string) {
+  const { tasks } = useTask();
+  const { data: taskDetail } = useGetTaskQuery(taskId, { enabled: open });
+
+  const [search, setSearch] = useState("");
+  const [fileType, setFileType] = useState(ALL_TASK_FILE_TYPES);
+  const [statusCategory, setStatusCategory] = useState(
+    ALL_TASK_STATUS_CATEGORIES,
+  );
+  const [expandedPath, setExpandedPath] = useState<string | null>(null);
+  const [nameSort, setNameSort] = useState<TaskFileNameSort>("asc");
+
+  const task = useMemo<Task | undefined>(
+    () => taskDetail ?? tasks.find((entry) => entry.task_id === taskId),
+    [taskDetail, tasks, taskId],
+  );
+
+  const fileEntries = useMemo(
+    () => (task ? getTaskFileEntries(task) : []),
+    [task],
+  );
+
+  const fileTypes = useMemo(() => (task ? getTaskFileTypes(task) : []), [task]);
+
+  const categoryCounts = useMemo(
+    () => (task ? countTaskFilesByCategory(task) : null),
+    [task],
+  );
+
+  const activeFileType =
+    fileType === ALL_TASK_FILE_TYPES || fileTypes.includes(fileType)
+      ? fileType
+      : ALL_TASK_FILE_TYPES;
+
+  const filteredEntries = useMemo(
+    () =>
+      filterTaskFileEntries(fileEntries, {
+        search,
+        fileType: activeFileType,
+        statusCategory: statusCategory as TaskFileStatusCategory,
+        task,
+      }),
+    [fileEntries, search, activeFileType, statusCategory, task],
+  );
+
+  const sortedEntries = useMemo(
+    () => sortTaskFileEntries(filteredEntries, nameSort),
+    [filteredEntries, nameSort],
+  );
+
+  const toggleNameSort = () => {
+    setNameSort((current) => (current === "asc" ? "desc" : "asc"));
+  };
+
+  return {
+    task,
+    fileEntries,
+    fileTypes,
+    categoryCounts,
+    sortedEntries,
+    search,
+    setSearch,
+    fileType: activeFileType,
+    setFileType,
+    statusCategory,
+    setStatusCategory,
+    expandedPath,
+    setExpandedPath,
+    nameSort,
+    toggleNameSort,
+  };
+}
diff --git a/frontend/components/task-error-content.tsx b/frontend/components/task-error-content.tsx
index 4142149e3..c50869f35 100644
--- a/frontend/components/task-error-content.tsx
+++ b/frontend/components/task-error-content.tsx
@@ -1,5 +1,6 @@
 "use client";
 
+import * as AccordionPrimitive from "@radix-ui/react-accordion";
 import { AlertCircle, ChevronDown, Flag, XCircle } from "lucide-react";
 import { useMemo, useState } from "react";
 import { IncidentReporterIcon } from "@/components/icons/incident-reporter-icon";
@@ -8,7 +9,6 @@ import {
   Accordion,
   AccordionContent,
   AccordionItem,
-  AccordionTrigger,
 } from "@/components/ui/accordion";
 import { useIsCloudBrand } from "@/contexts/brand-context";
 import { type Task } from "@/contexts/task-context";
@@ -72,30 +72,45 @@ export function TaskErrorContent({
 
   const ossIconColumn = showHeader && !isCloudBrand;
 
-  const accordionTrigger = (
-    <div className="flex w-full min-w-0 items-center justify-between gap-2">
-      <div className="flex min-w-0 items-center gap-1">
-        <span className="text-xs">
-          {successCount} success · {failedCount} failed
-        </span>
-        <ChevronDown className="size-4 shrink-0 transition-transform group-data-[state=open]:rotate-180" />
-      </div>
-      <button
-        type="button"
-        aria-label="Open task details"
-        className="inline-flex shrink-0 items-center justify-center text-muted-foreground hover:text-foreground"
-        onClick={(event) => {
-          event.preventDefault();
-          event.stopPropagation();
-          setIsTaskDialogOpen(true);
-        }}
-        onPointerDown={(event) => event.stopPropagation()}
-      >
-        <IncidentReporterIcon className="size-4" />
-      </button>
+  const accordionSummary = (
+    <div className="flex min-w-0 flex-1 items-center gap-1">
+      <span className="text-xs">
+        {successCount} success · {failedCount} failed
+      </span>
+      <ChevronDown className="size-4 shrink-0 transition-transform group-data-[state=open]:rotate-180" />
     </div>
   );
 
+  const openTaskDialogButton = (
+    <button
+      type="button"
+      aria-label="Open task details"
+      className="inline-flex shrink-0 items-center justify-center text-muted-foreground hover:text-foreground"
+      onClick={() => setIsTaskDialogOpen(true)}
+    >
+      <IncidentReporterIcon className="size-4" />
+    </button>
+  );
+
+  const accordionHeader = (
+    <AccordionPrimitive.Header
+      className={cn(
+        "flex w-full min-w-0 items-center gap-2",
+        ossIconColumn && "gap-2.5",
+      )}
+    >
+      {ossIconColumn ? <div className="size-5 shrink-0" aria-hidden /> : null}
+      <AccordionPrimitive.Trigger
+        className={cn(
+          "group inline-flex min-w-0 flex-1 items-center justify-start gap-1 px-0 py-0 text-sm text-muted-foreground transition-colors hover:text-foreground",
+        )}
+      >
+        {accordionSummary}
+      </AccordionPrimitive.Trigger>
+      {openTaskDialogButton}
+    </AccordionPrimitive.Header>
+  );
+
   return (
     <div
       className={cn(
@@ -153,16 +168,7 @@ export function TaskErrorContent({
           }
         >
           <AccordionItem value="failed-files" className="border-0 rounded-none">
-            <AccordionTrigger className="group px-0 py-0 text-sm text-muted-foreground hover:text-foreground transition-colors [&>svg:first-child]:hidden">
-              {ossIconColumn ? (
-                <div className="flex w-full min-w-0 gap-2.5">
-                  <div className="size-5 shrink-0" aria-hidden />
-                  <div className="min-w-0 flex-1">{accordionTrigger}</div>
-                </div>
-              ) : (
-                accordionTrigger
-              )}
-            </AccordionTrigger>
+            {accordionHeader}
             <AccordionContent className="w-full p-0 pt-2">
               <div className="flex w-full flex-col gap-2">
                 {failedEntries.map(([filePath, fileInfo], index) => {
diff --git a/frontend/components/tasks_details.tsx b/frontend/components/tasks_details.tsx
index f6f923453..8a9d2f3ae 100644
--- a/frontend/components/tasks_details.tsx
+++ b/frontend/components/tasks_details.tsx
@@ -2,18 +2,15 @@ import { useEffect, useMemo, useState } from "react";
 import { TaskCollapsibleSection } from "@/components/task-collapsible-section";
 import { TaskErrorContent } from "@/components/task-error-content";
 import { TaskPanelHeader } from "@/components/task-panel-header";
-import { useIsCloudBrand } from "@/contexts/brand-context";
 import { useKnowledgeFilter } from "@/contexts/knowledge-filter-context";
 import { type Task } from "@/contexts/task-context";
 import { parseTimestampMs } from "@/lib/time-utils";
-import { cn } from "@/lib/utils";
 
 interface FailedTasksInfoProps {
   failedTasks: Task[];
 }
 
 export const FailedTasksInfo = ({ failedTasks }: FailedTasksInfoProps) => {
-  const isCloudBrand = useIsCloudBrand();
   const [openSections, setOpenSections] = useState<
     Record<"recent" | "past", boolean>
   >({
@@ -79,12 +76,7 @@ export const FailedTasksInfo = ({ failedTasks }: FailedTasksInfoProps) => {
   );
 
   return (
-    <div
-      className={cn(
-        "h-full bg-background border-l overflow-y-auto",
-        isCloudBrand && "ibm-tasks-panel",
-      )}
-    >
+    <div className="h-full bg-background border-l overflow-y-auto">
       <TaskPanelHeader onClose={closePanelOnly} />
 
       {failedTasks.length === 0 ? (
@@ -106,12 +98,6 @@ export const FailedTasksInfo = ({ failedTasks }: FailedTasksInfoProps) => {
                 }))
               }
               emptyText={section.emptyText}
-              contentClassName={cn(
-                "flex flex-col",
-                isCloudBrand
-                  ? "p-0 [&>*:last-child]:border-b [&>*:last-child]:border-muted"
-                  : "gap-2 p-4",
-              )}
               renderItem={(task) => (
                 <TaskErrorContent
                   key={`${section.sectionKey}-${task.task_id}`}
diff --git a/frontend/lib/task-error-display.ts b/frontend/lib/task-error-display.ts
index 782b40502..038ee850d 100644
--- a/frontend/lib/task-error-display.ts
+++ b/frontend/lib/task-error-display.ts
@@ -1,16 +1,81 @@
-// Will update when backend is ready (error_summary, failing_step, component_cause).
+// Prefer API `failure_phase` for failed-step inference; `component_cause` may follow later.
+
+import type { TaskFileEntry } from "@/app/api/queries/useGetTasksQuery";
 
 export const FILE_ERROR_MAX_LINE_LENGTH = 80;
 
 export type TaskErrorComponentCause = "OpenSearch" | "Docling" | "Langflow";
 
+export type IngestionPipelineStepId =
+  | "parsing"
+  | "chunking"
+  | "embedding"
+  | "indexing";
+
+export interface IngestionPipelineStep {
+  id: IngestionPipelineStepId;
+  label: string;
+  status: "completed" | "failed";
+}
+
+export interface TaskFileIngestionFailureAnalysis {
+  resolvedError: string;
+  failedStep: IngestionPipelineStepId;
+  pipelineSteps: IngestionPipelineStep[];
+  rowStatusLabel: string;
+  failureSummary: string;
+  componentCause?: TaskErrorComponentCause;
+  componentTags: string[];
+  /** Short line for compact panels (truncated). */
+  summaryLine: string;
+}
+
+const PIPELINE_STEP_ORDER: IngestionPipelineStepId[] = [
+  "parsing",
+  "chunking",
+  "embedding",
+  "indexing",
+];
+
+const PIPELINE_STEP_LABELS: Record<IngestionPipelineStepId, string> = {
+  parsing: "Parsing",
+  chunking: "Chunking",
+  embedding: "Embedding",
+  indexing: "Indexing",
+};
+
 const COMPONENT_CAUSES: ReadonlyArray<{
-  keyword: string;
+  keyword: RegExp;
   label: TaskErrorComponentCause;
 }> = [
-  { keyword: "opensearch", label: "OpenSearch" },
-  { keyword: "docling", label: "Docling" },
-  { keyword: "langflow", label: "Langflow" },
+  { keyword: /opensearch/i, label: "OpenSearch" },
+  { keyword: /docling/i, label: "Docling" },
+  { keyword: /langflow/i, label: "Langflow" },
+];
+
+const STEP_ERROR_SIGNALS: Record<
+  IngestionPipelineStepId,
+  ReadonlyArray<RegExp>
+> = {
+  parsing: [/docling/i, /\bpars(e|ing)\b/i, /convert/i, /ocr/i],
+  chunking: [/chunk/i, /\bsplit/i, /segment/i],
+  embedding: [/embed/i, /\bvector/i, /dimension/i],
+  indexing: [/opensearch/i, /\bindex/i, /mapping/i, /schema/i],
+};
+
+const ISSUE_TYPE_SIGNALS: ReadonlyArray<{ pattern: RegExp; label: string }> = [
+  {
+    pattern: /schema|mapping|does not match.*index/i,
+    label: "pipeline configuration issue",
+  },
+  { pattern: /timeout|timed?\s*out/i, label: "timeout" },
+  {
+    pattern: /unauthorized|forbidden|403|401|permission/i,
+    label: "access issue",
+  },
+  { pattern: /connection|unreachable|network/i, label: "connectivity issue" },
+  { pattern: /embed|model|dimension/i, label: "embedding configuration issue" },
+  { pattern: /quota|limit|rate/i, label: "rate limit" },
 ];
 
 export interface FileTaskErrorDisplay {
@@ -39,7 +104,6 @@ function truncateLine(
   return `${text.slice(0, maxLength - 1).trimEnd()}…`;
 }
 
-/** Prefer a short clause from long, nested error strings. */
 function extractReadableLine(text: string): string {
   const beforeCausedBy = text.split(/\s+caused by:/i)[0]?.trim() ?? text;
 
@@ -63,28 +127,235 @@ function extractReadableLine(text: string): string {
 export function detectComponentCause(
   raw: string,
 ): TaskErrorComponentCause | undefined {
-  const lower = raw.toLowerCase();
   for (const { keyword, label } of COMPONENT_CAUSES) {
-    if (lower.includes(keyword)) {
+    if (keyword.test(raw)) {
       return label;
     }
   }
   return undefined;
 }
 
+function scorePipelineStepsFromError(
+  error: string,
+): Record<IngestionPipelineStepId, number> {
+  const scores: Record<IngestionPipelineStepId, number> = {
+    parsing: 0,
+    chunking: 0,
+    embedding: 0,
+    indexing: 0,
+  };
+  for (const step of PIPELINE_STEP_ORDER) {
+    for (const pattern of STEP_ERROR_SIGNALS[step]) {
+      if (pattern.test(error)) {
+        scores[step] += 1;
+      }
+    }
+  }
+  return scores;
+}
+
+function pickFailedStepFromErrorScores(
+  scores: Record<IngestionPipelineStepId, number>,
+): IngestionPipelineStepId | null {
+  const maxScore = Math.max(...PIPELINE_STEP_ORDER.map((step) => scores[step]));
+  if (maxScore === 0) {
+    return null;
+  }
+  const matching = PIPELINE_STEP_ORDER.filter(
+    (step) => scores[step] === maxScore,
+  );
+  return matching[matching.length - 1] ?? null;
+}
+
+function inferFailedStepFromPhase(
+  fileInfo: TaskFileEntry,
+): IngestionPipelineStepId | null {
+  const phase =
+    typeof fileInfo.phase === "string" ? fileInfo.phase.toLowerCase() : "";
+  const doclingStatus =
+    typeof fileInfo.docling_status === "string"
+      ? fileInfo.docling_status.toLowerCase()
+      : "";
+
+  if (phase === "docling" || doclingStatus === "failed") {
+    return "parsing";
+  }
+  if (phase === "langflow") {
+    return "embedding";
+  }
+  if (phase === "complete") {
+    return "indexing";
+  }
+  return null;
+}
+
+export function inferFailedPipelineStep(
+  fileInfo: TaskFileEntry,
+  rawError: string,
+): IngestionPipelineStepId {
+  const normalized = normalizeErrorText(rawError);
+  const fromError = pickFailedStepFromErrorScores(
+    scorePipelineStepsFromError(normalized),
+  );
+  if (fromError) {
+    return fromError;
+  }
+  return inferFailedStepFromPhase(fileInfo) ?? "embedding";
+}
+
+function getPhaseMinimumFailedIndex(phase: string): number {
+  if (phase === "complete") {
+    return PIPELINE_STEP_ORDER.indexOf("indexing");
+  }
+  if (phase === "langflow") {
+    return PIPELINE_STEP_ORDER.indexOf("embedding");
+  }
+  return 0;
+}
+
+export function buildIngestionPipelineSteps(
+  failedStep: IngestionPipelineStepId,
+  fileInfo: TaskFileEntry,
+): IngestionPipelineStep[] {
+  const phase =
+    typeof fileInfo.phase === "string" ? fileInfo.phase.toLowerCase() : "";
+
+  const failedIndex = PIPELINE_STEP_ORDER.indexOf(failedStep);
+  const lastIndex = Math.max(failedIndex, getPhaseMinimumFailedIndex(phase));
+
+  return PIPELINE_STEP_ORDER.slice(0, lastIndex + 1).map((id, index) => ({
+    id,
+    label: PIPELINE_STEP_LABELS[id],
+    status: index < lastIndex ? "completed" : "failed",
+  }));
+}
+
+function inferIssueType(error: string): string | null {
+  for (const { pattern, label } of ISSUE_TYPE_SIGNALS) {
+    if (pattern.test(error)) {
+      return label;
+    }
+  }
+  return null;
+}
+
+export function buildFailureSummary(
+  failedStep: IngestionPipelineStepId,
+  error: string,
+): string {
+  const stepLabel = PIPELINE_STEP_LABELS[failedStep].toLowerCase();
+  const issueType = inferIssueType(error);
+  return issueType
+    ? `Failed at ${stepLabel} · ${issueType}`
+    : `Failed at ${stepLabel}`;
+}
+
+export function buildRowStatusLabel(
+  failedStep: IngestionPipelineStepId,
+): string {
+  return `${PIPELINE_STEP_LABELS[failedStep]} issue`;
+}
+
+export function buildComponentTags(
+  error: string,
+  componentCause?: TaskErrorComponentCause,
+): string[] {
+  const tags: string[] = [];
+  if (componentCause) {
+    tags.push(componentCause);
+  }
+  if (/mapping/i.test(error) && !tags.includes("Mapping")) {
+    tags.push("Mapping");
+  }
+  if (/schema/i.test(error) && !tags.includes("Schema")) {
+    tags.push("Schema");
+  }
+  return tags;
+}
+
+export function resolveTaskFileError(
+  fileInfo: TaskFileEntry,
+  taskError?: string,
+): string {
+  if (typeof fileInfo.error === "string" && fileInfo.error.trim()) {
+    return fileInfo.error.trim();
+  }
+  if (typeof taskError === "string" && taskError.trim()) {
+    return taskError.trim();
+  }
+  return "Unknown error";
+}
+
+export function analyzeTaskFileIngestionFailure(
+  fileInfo: TaskFileEntry,
+  taskError?: string,
+): TaskFileIngestionFailureAnalysis {
+  const resolvedError = resolveTaskFileError(fileInfo, taskError);
+  const normalized = normalizeErrorText(resolvedError);
+  const componentCause = detectComponentCause(normalized);
+  const failedStep = inferFailedPipelineStep(fileInfo, normalized);
+  const pipelineSteps = buildIngestionPipelineSteps(failedStep, fileInfo);
+  const summaryLine = truncateLine(
+    extractReadableLine(stripNoisePrefixes(normalized)),
+  );
+
+  return {
+    resolvedError,
+    failedStep,
+    pipelineSteps,
+    rowStatusLabel: buildRowStatusLabel(failedStep),
+    failureSummary: buildFailureSummary(failedStep, normalized),
+    componentCause,
+    componentTags: buildComponentTags(normalized, componentCause),
+    summaryLine,
+  };
+}
+
+/** @deprecated Use analyzeTaskFileIngestionFailure */
+export function getIngestionPipelineSteps(
+  raw: string | undefined | null,
+  componentCause?: TaskErrorComponentCause,
+  fileInfo?: TaskFileEntry,
+): IngestionPipelineStep[] {
+  const resolved = (raw ?? "").trim() || "Unknown error";
+  const failedStep = fileInfo
+    ? inferFailedPipelineStep(fileInfo, resolved)
+    : (pickFailedStepFromErrorScores(scorePipelineStepsFromError(resolved)) ??
+      (componentCause === "Docling"
+        ? "parsing"
+        : componentCause === "Langflow"
+          ? "embedding"
+          : componentCause === "OpenSearch"
+            ? "indexing"
+            : "embedding"));
+  return buildIngestionPipelineSteps(
+    failedStep,
+    fileInfo ??
+      ({ phase: undefined, docling_status: undefined } as TaskFileEntry),
+  );
+}
+
 export function displayFileTaskError(
   raw: string | undefined | null,
+  fileInfo?: TaskFileEntry,
+  taskError?: string,
 ): FileTaskErrorDisplay {
+  if (fileInfo) {
+    const analysis = analyzeTaskFileIngestionFailure(fileInfo, taskError);
+    return {
+      line: analysis.summaryLine,
+      componentCause: analysis.componentCause,
+    };
+  }
+
   if (!raw?.trim()) {
     return { line: "Unknown error" };
   }
 
   const normalized = normalizeErrorText(raw);
   const componentCause = detectComponentCause(normalized);
-
   let line = stripNoisePrefixes(normalized);
   line = truncateLine(extractReadableLine(line));
-
   if (!line) {
     line = "Unknown error";
   }
diff --git a/frontend/lib/task-utils.ts b/frontend/lib/task-utils.ts
index 8f22468d5..f586cdf8c 100644
--- a/frontend/lib/task-utils.ts
+++ b/frontend/lib/task-utils.ts
@@ -1,4 +1,213 @@
 import type { Task, TaskFileEntry } from "@/app/api/queries/useGetTasksQuery";
+import {
+  buildRowStatusLabel,
+  inferFailedPipelineStep,
+  resolveTaskFileError,
+} from "@/lib/task-error-display";
+
+export const ALL_TASK_FILE_TYPES = "__all__";
+export const ALL_TASK_STATUS_CATEGORIES = "__all__";
+
+export type TaskFileStatusCategory =
+  | "completed"
+  | "system_error"
+  | "indexing"
+  | "partial";
+
+export type TaskFileNameSort = "asc" | "desc";
+
+export type TaskFileFilterOptions = {
+  search?: string;
+  fileType?: string | typeof ALL_TASK_FILE_TYPES;
+  statusCategory?: TaskFileStatusCategory | typeof ALL_TASK_STATUS_CATEGORIES;
+  task?: Task;
+};
+
+interface TaskFileCategoryContext {
+  taskHasFailures: boolean;
+  successfulFileCount: number;
+}
+
+export function isTaskFileCompleted(fileInfo: TaskFileEntry): boolean {
+  return fileInfo.status === "completed";
+}
+
+export function isTaskFileFailed(fileInfo: TaskFileEntry): boolean {
+  return fileInfo.status === "failed" || fileInfo.status === "error";
+}
+
+export function getTaskFileDialogStatusLabel(
+  fileInfo: TaskFileEntry,
+  taskError?: string,
+): string {
+  if (isTaskFileFailed(fileInfo)) {
+    return buildRowStatusLabel(
+      inferFailedPipelineStep(
+        fileInfo,
+        resolveTaskFileError(fileInfo, taskError),
+      ),
+    );
+  }
+  if (isTaskFileCompleted(fileInfo)) {
+    return "Complete";
+  }
+  return "Processing";
+}
+
+export function getTaskFileName(
+  filePath: string,
+  fileInfo: TaskFileEntry,
+): string {
+  return fileInfo.filename || filePath.split("/").pop() || filePath;
+}
+
+/** Lowercase extension without dot, or empty string when none. */
+export function getFileExtensionFromName(filename: string): string {
+  const trimmed = filename.trim();
+  const dotIndex = trimmed.lastIndexOf(".");
+  if (dotIndex <= 0 || dotIndex === trimmed.length - 1) {
+    return "";
+  }
+  return trimmed.slice(dotIndex + 1).toLowerCase();
+}
+
+export function getTaskFileTypeKey(
+  filePath: string,
+  fileInfo: TaskFileEntry,
+): string {
+  const extension = getFileExtensionFromName(
+    getTaskFileName(filePath, fileInfo),
+  );
+  return extension || "unknown";
+}
+
+export function getTaskFileEntries(task: Task): Array<[string, TaskFileEntry]> {
+  return Object.entries(task.files || {});
+}
+
+export function getTaskFileTypes(task: Task): string[] {
+  const types = new Set(
+    getTaskFileEntries(task).map(([path, entry]) =>
+      getTaskFileTypeKey(path, entry),
+    ),
+  );
+  return Array.from(types).sort((a, b) => a.localeCompare(b));
+}
+
+export function formatTaskFileTypeLabel(fileType: string): string {
+  if (fileType === "unknown") {
+    return "Unknown";
+  }
+  return fileType.toUpperCase();
+}
+
+function getTaskFileCategoryContext(task: Task): TaskFileCategoryContext {
+  return {
+    taskHasFailures: hasFailedFileEntries(task),
+    successfulFileCount: getSuccessfulFileCount(task),
+  };
+}
+
+/**
+ * Maps a file to a dialog filter chip bucket.
+ * Completed files in a mixed task (failures + successes) use `partial`, not `completed`.
+ */
+export function getTaskFileStatusCategory(
+  fileInfo: TaskFileEntry,
+  task: Task,
+  context: TaskFileCategoryContext = getTaskFileCategoryContext(task),
+): TaskFileStatusCategory {
+  if (isTaskFileFailed(fileInfo)) {
+    return "system_error";
+  }
+
+  const status = fileInfo.status ?? "pending";
+  if (status === "pending" || status === "running" || status === "processing") {
+    return "indexing";
+  }
+
+  if (status === "completed") {
+    if (context.taskHasFailures && context.successfulFileCount > 0) {
+      return "partial";
+    }
+    return "completed";
+  }
+
+  return "indexing";
+}
+
+export function countTaskFilesByCategory(
+  task: Task,
+): Record<TaskFileStatusCategory, number> {
+  const counts: Record<TaskFileStatusCategory, number> = {
+    completed: 0,
+    system_error: 0,
+    indexing: 0,
+    partial: 0,
+  };
+  const context = getTaskFileCategoryContext(task);
+
+  for (const [, fileInfo] of getTaskFileEntries(task)) {
+    const category = getTaskFileStatusCategory(fileInfo, task, context);
+    counts[category] += 1;
+  }
+
+  return counts;
+}
+
+export function sortTaskFileEntries(
+  entries: Array<[string, TaskFileEntry]>,
+  direction: TaskFileNameSort = "asc",
+): Array<[string, TaskFileEntry]> {
+  const sorted = [...entries].sort(([pathA, infoA], [pathB, infoB]) =>
+    getTaskFileName(pathA, infoA).localeCompare(
+      getTaskFileName(pathB, infoB),
+      undefined,
+      { sensitivity: "base" },
+    ),
+  );
+  return direction === "asc" ? sorted : sorted.reverse();
+}
+
+export function filterTaskFileEntries(
+  entries: Array<[string, TaskFileEntry]>,
+  options: TaskFileFilterOptions,
+): Array<[string, TaskFileEntry]> {
+  const query = options.search?.trim().toLowerCase() ?? "";
+  const fileType = options.fileType ?? ALL_TASK_FILE_TYPES;
+  const statusCategory = options.statusCategory ?? ALL_TASK_STATUS_CATEGORIES;
+  const categoryContext = options.task
+    ? getTaskFileCategoryContext(options.task)
+    : undefined;
+
+  return entries.filter(([filePath, fileInfo]) => {
+    if (fileType !== ALL_TASK_FILE_TYPES) {
+      const typeKey = getTaskFileTypeKey(filePath, fileInfo);
+      if (typeKey !== fileType) {
+        return false;
+      }
+    }
+
+    if (
+      options.task &&
+      statusCategory !== ALL_TASK_STATUS_CATEGORIES &&
+      categoryContext &&
+      getTaskFileStatusCategory(fileInfo, options.task, categoryContext) !==
+        statusCategory
+    ) {
+      return false;
+    }
+
+    if (query) {
+      const name = getTaskFileName(filePath, fileInfo);
+      if (!name.toLowerCase().includes(query)) {
+        return false;
+      }
+    }
+
+    return true;
+  });
+}
 
 export function getFailedFileEntries(
   task: Task,
diff --git a/frontend/package-lock.json b/frontend/package-lock.json
index adb7ecda2..3e5165d5a 100644
--- a/frontend/package-lock.json
+++ b/frontend/package-lock.json
@@ -8,7 +8,6 @@
       "name": "frontend",
       "version": "0.1.0",
       "dependencies": {
-        "@carbon/icons-react": "^11.81.0",
         "@radix-ui/react-accordion": "^1.2.12",
         "@radix-ui/react-avatar": "^1.1.10",
         "@radix-ui/react-collapsible": "^1.1.11",
@@ -258,31 +257,6 @@
         "node": ">=14.21.3"
       }
     },
-    "node_modules/@carbon/icon-helpers": {
-      "version": "10.76.0",
-      "resolved": "https://registry.npmjs.org/@carbon/icon-helpers/-/icon-helpers-10.76.0.tgz",
-      "integrity": "sha512-DLxVV/NtEFauMbmKFW53cGKMs84RRdIp9AzHbasIxlCBjO0P4eZbPdO3gTzYxn02jDMo++2m3MsEAwNydzrzmQ==",
-      "hasInstallScript": true,
-      "license": "Apache-2.0",
-      "dependencies": {
-        "@ibm/telemetry-js": "^1.5.0"
-      }
-    },
-    "node_modules/@carbon/icons-react": {
-      "version": "11.81.0",
-      "resolved": "https://registry.npmjs.org/@carbon/icons-react/-/icons-react-11.81.0.tgz",
-      "integrity": "sha512-rkaQz45ioyQQ1FeSB69ojL1EfsEecYE0+S88marMqz6GIqJxnDhHap3a2C89kXwuBUbCNsZ5aIhKqfiMquotvg==",
-      "hasInstallScript": true,
-      "license": "Apache-2.0",
-      "dependencies": {
-        "@carbon/icon-helpers": "^10.76.0",
-        "@ibm/telemetry-js": "^1.5.0",
-        "prop-types": "^15.8.1"
-      },
-      "peerDependencies": {
-        "react": ">=16"
-      }
-    },
     "node_modules/@emnapi/core": {
       "version": "1.8.1",
       "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.8.1.tgz",
@@ -550,15 +524,6 @@
         "url": "https://github.com/sponsors/nzakas"
       }
     },
-    "node_modules/@ibm/telemetry-js": {
-      "version": "1.11.0",
-      "resolved": "https://registry.npmjs.org/@ibm/telemetry-js/-/telemetry-js-1.11.0.tgz",
-      "integrity": "sha512-RO/9j+URJnSfseWg9ZkEX9p+a3Ousd33DBU7rOafoZB08RqdzxFVYJ2/iM50dkBuD0o7WX7GYt1sLbNgCoE+pA==",
-      "license": "Apache-2.0",
-      "bin": {
-        "ibmtelemetry": "dist/collect.js"
-      }
-    },
     "node_modules/@img/colour": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/@img/colour/-/colour-1.1.0.tgz",
diff --git a/frontend/package.json b/frontend/package.json
index 3ed1dbef5..b712c0ac6 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -17,7 +17,6 @@
     "prepare": "cd .. && npx husky frontend/.husky || true"
   },
   "dependencies": {
-    "@carbon/icons-react": "^11.81.0",
     "@radix-ui/react-accordion": "^1.2.12",
     "@radix-ui/react-avatar": "^1.1.10",
     "@radix-ui/react-collapsible": "^1.1.11",
diff --git a/frontend/tailwind.config.ts b/frontend/tailwind.config.ts
index cbed098bc..b1e025a67 100644
--- a/frontend/tailwind.config.ts
+++ b/frontend/tailwind.config.ts
@@ -157,9 +157,12 @@ const config = {
           DEFAULT: "hsl(var(--card))",
           foreground: "hsl(var(--card-foreground))",
         },
+        canvas: "hsl(var(--canvas))",
         "layer-contextual": "hsl(var(--layer-contextual))",
         "layer-contextual-foreground":
           "hsl(var(--layer-contextual-foreground))",
+        "border-subtle-contextual":
+          "hsl(var(--border-subtle-background-contextual))",
         "text-text-01": "hsl(var(--text-text-01))",
         "link-primary": "hsl(var(--link-primary))",
         "button-tertiary": "hsl(var(--button-tertiary))",

From d51cfe2f29734f1733ec0d6e634b2bdc81a3bec7 Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Wed, 27 May 2026 17:34:02 -0400
Subject: [PATCH 14/25] Backend - Add POST /tasks/{task_id}/retry to re-queue
 failed RETRYABLE files on the   existing task processor (optional file_paths
 subset). - Implement TaskService.retry_failed_files with skip reasons
 (not_failed,   not_retryable, source_file_missing, task_in_progress) and
 retry_count tracking. - Classify non-retryable file errors vs transient
 Docling failures. - Add tests/unit/test_task_service_retry_failed_files.py.
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Frontend — retry
- Add useRetryTaskMutation calling the retry endpoint.
- Extend enhanced task types (actionable_by, retry_count, failure component/
  phase) in useGetTasksQuery and single-task fetch in useGetTaskQuery.
- Task dialog: retry all/selected, retry ingestions tab, row selection, polling
  while retry runs, and toasts for retried/skipped files.
- task-utils: retryable file helpers, filters, and dialog status labels.
- task-context: markTaskFilesProcessing when retry starts; improved overlay
  sync/finalization with enhanced task payloads and knowledge refetch on
  completio
- task-error-display: use structured API failure metadata for file errors.
- task-error-content: open task dialog from failure panel; show API component
  and resolved error text.
- useCancelTaskMutation: invalidate tasks queries with exact: false.
- Playwright: mock GET /api/tasks** only so retry POST is not intercepted.

Frontend — knowledge bulk delete
- Fix delete modal listing wrong files after partial ingest/retry: AG Grid kept
  failed rows selected after checkboxes disappeared (processing → failed).
- Restrict selection and delete to active rows present in listFiles/search
  (indexed knowledge only, not overlay-only rows without chunks).
- Prune non-deletable selection when grid data changes; add isRowSelectable.
- Delete with Promise.allSettled via deleteDocumentByFilename so one file
  without chunks does not abort the batch; resolve indexed filename for delete.

Tests
- Extend tests/unit/test_task_service_get_task_status2.py for enhanced status.
---
 .../api/mutations/useCancelTaskMutation.ts    |   2 +-
 .../app/api/mutations/useDeleteDocument.ts    |  13 +-
 frontend/app/api/queries/useGetTaskQuery.ts   |  14 +-
 frontend/app/api/queries/useGetTasksQuery.ts  |  47 ++-
 frontend/app/knowledge/page.tsx               | 151 +++++--
 frontend/components/task-dialog/file-list.tsx | 374 ++++++++++++------
 .../components/task-dialog/task-dialog.tsx    |  66 +++-
 .../components/task-dialog/use-task-dialog.ts | 289 +++++++++++++-
 frontend/components/task-error-content.tsx    |  19 +-
 frontend/contexts/task-context.tsx            | 160 ++++++--
 frontend/lib/task-error-display.ts            | 346 ++++------------
 frontend/lib/task-utils.ts                    | 166 +++++++-
 .../tests/core/tasks-unified-panel.spec.ts    |   6 +-
 src/api/tasks.py                              |  36 +-
 src/app/routes/internal.py                    |   6 +
 src/services/task_service.py                  | 245 +++++++++++-
 .../test_task_service_get_task_status2.py     |  51 +++
 17 files changed, 1456 insertions(+), 535 deletions(-)

diff --git a/frontend/app/api/mutations/useCancelTaskMutation.ts b/frontend/app/api/mutations/useCancelTaskMutation.ts
index 88ea7e0c5..e96c0c19d 100644
--- a/frontend/app/api/mutations/useCancelTaskMutation.ts
+++ b/frontend/app/api/mutations/useCancelTaskMutation.ts
@@ -40,7 +40,7 @@ export const useCancelTaskMutation = (
     mutationFn: cancelTask,
     onSuccess: () => {
       // Invalidate tasks query to refresh the list
-      queryClient.invalidateQueries({ queryKey: ["tasks"] });
+      queryClient.invalidateQueries({ queryKey: ["tasks"], exact: false });
     },
     ...options,
   });
diff --git a/frontend/app/api/mutations/useDeleteDocument.ts b/frontend/app/api/mutations/useDeleteDocument.ts
index f4fd9ce41..20039ad07 100644
--- a/frontend/app/api/mutations/useDeleteDocument.ts
+++ b/frontend/app/api/mutations/useDeleteDocument.ts
@@ -13,15 +13,15 @@ interface DeleteDocumentResponse {
   message: string;
 }
 
-const deleteDocument = async (
-  data: DeleteDocumentRequest,
-): Promise<DeleteDocumentResponse> => {
+export async function deleteDocumentByFilename(
+  filename: string,
+): Promise<DeleteDocumentResponse> {
   const response = await fetch("/api/documents/delete-by-filename", {
     method: "POST",
     headers: {
       "Content-Type": "application/json",
     },
-    body: JSON.stringify(data),
+    body: JSON.stringify({ filename } satisfies DeleteDocumentRequest),
   });
 
   if (!response.ok) {
@@ -30,13 +30,14 @@ const deleteDocument = async (
   }
 
   return response.json();
-};
+}
 
 export const useDeleteDocument = () => {
   const queryClient = useQueryClient();
 
   return useMutation({
-    mutationFn: deleteDocument,
+    mutationFn: ({ filename }: DeleteDocumentRequest) =>
+      deleteDocumentByFilename(filename),
     onSettled: () => {
       // Invalidate and refetch search queries to update the UI
       setTimeout(() => {
diff --git a/frontend/app/api/queries/useGetTaskQuery.ts b/frontend/app/api/queries/useGetTaskQuery.ts
index be735c858..e5cd2948a 100644
--- a/frontend/app/api/queries/useGetTaskQuery.ts
+++ b/frontend/app/api/queries/useGetTaskQuery.ts
@@ -1,18 +1,24 @@
 import { type UseQueryOptions, useQuery } from "@tanstack/react-query";
 import type { Task } from "@/app/api/queries/useGetTasksQuery";
+export const TASK_DETAIL_QUERY_KEY = ["tasks", "detail"] as const;
+
+export function taskDetailQueryKey(taskId: string) {
+  return [...TASK_DETAIL_QUERY_KEY, taskId] as const;
+}
 
 export function useGetTaskQuery(
   taskId: string | null,
   options?: Omit<UseQueryOptions<Task | null>, "queryKey" | "queryFn">,
 ) {
   return useQuery({
-    queryKey: ["tasks", taskId],
+    queryKey: taskId
+      ? taskDetailQueryKey(taskId)
+      : [...TASK_DETAIL_QUERY_KEY, "idle"],
     queryFn: async (): Promise<Task | null> => {
       if (!taskId) {
         return null;
       }
-      //will be replace /api/tasks/{taskId}/enhanced, when backend merged
-      const response = await fetch(`/api/tasks/${taskId}`);
+      const response = await fetch(`/api/tasks/${taskId}/enhanced`);
       if (response.status === 404) {
         return null;
       }
@@ -21,7 +27,7 @@ export function useGetTaskQuery(
       }
       return response.json() as Promise<Task>;
     },
-    enabled: !!taskId,
     ...options,
+    enabled: options?.enabled ?? !!taskId,
   });
 }
diff --git a/frontend/app/api/queries/useGetTasksQuery.ts b/frontend/app/api/queries/useGetTasksQuery.ts
index 7a5d57004..d871007e6 100644
--- a/frontend/app/api/queries/useGetTasksQuery.ts
+++ b/frontend/app/api/queries/useGetTasksQuery.ts
@@ -4,6 +4,25 @@ import {
   useQueryClient,
 } from "@tanstack/react-query";
 
+/** Component that failed, from GET /tasks/enhanced file metadata. */
+export type TaskFailureComponent =
+  | "docling"
+  | "openrag"
+  | "langflow"
+  | "opensearch";
+
+/** Pipeline or validation step where failure occurred. */
+export type TaskFailurePhase =
+  | "parsing"
+  | "chunking"
+  | "embedding"
+  | "indexing"
+  | "file_validation"
+  | "unknown";
+
+/** Who can resolve the failure (enhanced API). */
+export type TaskActionableBy = "USER_ACTIONABLE" | "RETRYABLE";
+
 export interface TaskFileEntry {
   status?:
     | "pending"
@@ -21,17 +40,14 @@ export interface TaskFileEntry {
   filename?: string;
   embedding_model?: string;
   embedding_dimensions?: number;
-  /** Ingestion pipeline phase from the task service (`docling` | `langflow` | `complete`). */
   phase?: "docling" | "langflow" | "complete" | string;
-  /**
-   * Phase or step where ingestion failed (from API).
-   * Ingestion phase: `docling` | `langflow` | `complete`.
-   * Pipeline step: `parsing` | `chunking` | `embedding` | `indexing`.
-   */
-  failure_phase?: string;
   docling_status?: string;
   docling_task_id?: string;
-  [key: string]: unknown;
+  /** Present on failed files when the enhanced API can classify the failure. */
+  component?: TaskFailureComponent;
+  failure_phase?: TaskFailurePhase;
+  user_facing_message?: string;
+  actionable_by?: TaskActionableBy;
 }
 
 export interface Task {
@@ -61,13 +77,15 @@ export interface TasksResponse {
   tasks: Task[];
 }
 
+export const TASKS_QUERY_KEY = ["tasks", "enhanced"] as const;
+
 export const useGetTasksQuery = (
   options?: Omit<UseQueryOptions<Task[]>, "queryKey" | "queryFn">,
 ) => {
   const queryClient = useQueryClient();
 
   async function getTasks(): Promise<Task[]> {
-    const response = await fetch("/api/tasks");
+    const response = await fetch("/api/tasks/enhanced");
 
     if (!response.ok) {
       throw new Error("Failed to fetch tasks");
@@ -79,13 +97,12 @@ export const useGetTasksQuery = (
 
   const queryResult = useQuery(
     {
-      queryKey: ["tasks"],
+      queryKey: [...TASKS_QUERY_KEY],
       queryFn: getTasks,
       refetchInterval: (query) => {
-        // Only poll if there are tasks with pending or running status
         const data = query.state.data;
         if (!data || data.length === 0) {
-          return false; // Stop polling if no tasks
+          return false;
         }
 
         const hasActiveTasks = data.some(
@@ -95,11 +112,11 @@ export const useGetTasksQuery = (
             task.status === "processing",
         );
 
-        return hasActiveTasks ? 3000 : false; // Poll every 3 seconds if active tasks exist
+        return hasActiveTasks ? 3000 : false;
       },
       refetchIntervalInBackground: true,
-      staleTime: 0, // Always consider data stale to ensure fresh updates
-      gcTime: 5 * 60 * 1000, // Keep in cache for 5 minutes
+      staleTime: 0,
+      gcTime: 5 * 60 * 1000,
       ...options,
     },
     queryClient,
diff --git a/frontend/app/knowledge/page.tsx b/frontend/app/knowledge/page.tsx
index ea5f9af27..086148c55 100644
--- a/frontend/app/knowledge/page.tsx
+++ b/frontend/app/knowledge/page.tsx
@@ -12,7 +12,7 @@ import {
 import { AgGridReact, type CustomCellRendererProps } from "ag-grid-react";
 import { AlertTriangle, Cloud, FileIcon, Globe, RefreshCw } from "lucide-react";
 import { useRouter } from "next/navigation";
-import { useCallback, useEffect, useRef, useState } from "react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { KnowledgeDropdown } from "@/components/knowledge-dropdown";
 import { ProtectedRoute } from "@/components/protected-route";
 import { Banner, BannerIcon, BannerTitle } from "@/components/ui/banner";
@@ -56,7 +56,10 @@ import IBMCOSIcon from "../../components/icons/ibm-cos-icon";
 import OneDriveIcon from "../../components/icons/one-drive-logo";
 import SharePointIcon from "../../components/icons/share-point-logo";
 import { SyncConfirmDialog } from "../../components/sync-confirm-dialog";
-import { useDeleteDocument } from "../api/mutations/useDeleteDocument";
+import {
+  deleteDocumentByFilename,
+  useDeleteDocument,
+} from "../api/mutations/useDeleteDocument";
 import { useRefreshOpenragDocs } from "../api/mutations/useRefreshOpenragDocs";
 import {
   type SyncAllPreviewResponse,
@@ -64,6 +67,19 @@ import {
   useSyncAllConnectorsPreview,
 } from "../api/mutations/useSyncConnector";
 
+/** Failed overlays can stay selected after they lose their checkbox (processing → failed). */
+function syncGridSelectionToDeletableRows(
+  api: NonNullable<AgGridReact<File>["api"]>,
+  isDeletable: (file?: File) => boolean,
+): File[] {
+  api.forEachNode((node) => {
+    if (node.isSelected() && !isDeletable(node.data)) {
+      node.setSelected(false);
+    }
+  });
+  return api.getSelectedRows().filter(isDeletable);
+}
+
 /** List-files uses term filters; "*" means "any" in the UI — do not send it literally. */
 function listFilesFilterParam(values?: string[]): string | undefined {
   const raw = values?.[0]?.trim();
@@ -327,6 +343,37 @@ function SearchPage() {
     return getKnowledgeFileIdentity(file);
   }, []);
 
+  const indexedFileIdentities = useMemo(
+    () =>
+      new Set(
+        effectiveData
+          .map((file) => getKnowledgeFileIdentity(file))
+          .filter(Boolean),
+      ),
+    [effectiveData],
+  );
+
+  const isDeletableKnowledgeRow = useCallback(
+    (file?: File) => {
+      if ((file?.status || "active") !== "active") {
+        return false;
+      }
+      return indexedFileIdentities.has(getKnowledgeFileIdentity(file));
+    },
+    [indexedFileIdentities],
+  );
+
+  const resolveDeleteFilename = useCallback(
+    (row: File) => {
+      const identity = getKnowledgeFileIdentity(row);
+      const indexed = effectiveData.find(
+        (file) => getKnowledgeFileIdentity(file) === identity,
+      );
+      return indexed?.filename ?? row.filename;
+    },
+    [effectiveData],
+  );
+
   const getOwnerLabel = useCallback((file?: File): string => {
     return file?.owner_name?.trim() || file?.owner_email?.trim() || "—";
   }, []);
@@ -417,6 +464,29 @@ function SearchPage() {
   const gridRows = fileResults;
   const gridRef = useRef<AgGridReact>(null);
 
+  useEffect(() => {
+    const api = gridRef.current?.api;
+    if (!api) {
+      return;
+    }
+    const activeSelected = syncGridSelectionToDeletableRows(
+      api,
+      isDeletableKnowledgeRow,
+    );
+    setSelectedRows((current) => {
+      if (
+        current.length === activeSelected.length &&
+        current.every(
+          (row, index) =>
+            getFileIdentity(row) === getFileIdentity(activeSelected[index]),
+        )
+      ) {
+        return current;
+      }
+      return activeSelected;
+    });
+  }, [gridRows, getFileIdentity, isDeletableKnowledgeRow]);
+
   const columnDefs: ColDef<File>[] = [
     {
       field: "filename",
@@ -436,7 +506,7 @@ function SearchPage() {
         return sourceA < sourceB ? -1 : 1;
       },
       checkboxSelection: (params: CheckboxSelectionCallbackParams<File>) =>
-        (params?.data?.status || "active") === "active",
+        isDeletableKnowledgeRow(params?.data),
       headerCheckboxSelection: true,
       ...(isCloudBrand
         ? { flex: 2.2, minWidth: 260 }
@@ -685,51 +755,78 @@ function SearchPage() {
   };
 
   const onSelectionChanged = useCallback(() => {
-    if (gridRef.current) {
-      const selectedNodes = gridRef.current.api.getSelectedRows();
-      setSelectedRows(selectedNodes);
+    if (!gridRef.current) {
+      return;
     }
-  }, []);
+    setSelectedRows(
+      syncGridSelectionToDeletableRows(
+        gridRef.current.api,
+        isDeletableKnowledgeRow,
+      ),
+    );
+  }, [isDeletableKnowledgeRow]);
 
   const handleBulkDelete = async () => {
-    if (selectedRows.length === 0) return;
+    const rowsToDelete = selectedRows.filter(isDeletableKnowledgeRow);
+    if (rowsToDelete.length === 0) return;
 
     try {
-      // Delete each file individually since the API expects one filename at a time
-      const deletePromises = selectedRows.map((row) =>
-        deleteDocumentMutation.mutateAsync({ filename: row.filename }),
+      const deleteResults = await Promise.allSettled(
+        rowsToDelete.map((row) =>
+          deleteDocumentByFilename(resolveDeleteFilename(row)),
+        ),
       );
 
-      const deleteResults = await Promise.all(deletePromises);
       await refreshTasks();
       await queryClient.invalidateQueries({ queryKey: ["search"] });
+      await queryClient.invalidateQueries({ queryKey: ["listFiles"] });
       await queryClient.refetchQueries({ queryKey: ["search"] });
+      await queryClient.refetchQueries({ queryKey: ["listFiles"] });
 
-      const totalDeletedChunks = deleteResults.reduce(
-        (sum, result) => sum + (result.deleted_chunks || 0),
-        0,
+      const deleted = deleteResults.filter(
+        (
+          result,
+        ): result is PromiseFulfilledResult<
+          Awaited<ReturnType<typeof deleteDocumentByFilename>>
+        > =>
+          result.status === "fulfilled" &&
+          (result.value.deleted_chunks || 0) > 0,
       );
-      const filesWithNoDeletion = deleteResults.filter(
-        (result) => (result.deleted_chunks || 0) === 0,
+      const noChunks = deleteResults.filter(
+        (result) =>
+          result.status === "fulfilled" &&
+          (result.value.deleted_chunks || 0) === 0,
+      );
+      const failed = deleteResults.filter(
+        (result): result is PromiseRejectedResult =>
+          result.status === "rejected",
       );
 
-      if (totalDeletedChunks > 0) {
+      if (deleted.length > 0) {
         toast.success(
-          `Successfully deleted ${selectedRows.length} document${
-            selectedRows.length > 1 ? "s" : ""
-          }`,
+          `Deleted ${deleted.length} document${deleted.length > 1 ? "s" : ""}`,
         );
       } else {
         toast.warning(
-          "No document chunks were deleted. Files may be owned by another context or already removed.",
+          "No document chunks were deleted. Files may be missing or not deletable in your current context.",
         );
       }
 
-      if (filesWithNoDeletion.length > 0 && totalDeletedChunks > 0) {
+      if (noChunks.length > 0 && deleted.length > 0) {
         toast.warning(
-          `${filesWithNoDeletion.length} selected file${
-            filesWithNoDeletion.length > 1 ? "s were" : " was"
-          } not deleted (0 chunks matched).`,
+          `${noChunks.length} selected file${noChunks.length > 1 ? "s had" : " had"} no matching chunks.`,
+        );
+      }
+
+      if (failed.length > 0) {
+        toast.error(
+          `${failed.length} document${failed.length > 1 ? "s" : ""} could not be deleted`,
+          {
+            description:
+              failed[0].reason instanceof Error
+                ? failed[0].reason.message
+                : undefined,
+          },
         );
       }
       setSelectedRows([]);
@@ -919,6 +1016,7 @@ function SearchPage() {
             getRowId={(params: GetRowIdParams<File>) =>
               getFileIdentity(params.data)
             }
+            isRowSelectable={(params) => isDeletableKnowledgeRow(params.data)}
             domLayout="normal"
             onSelectionChanged={onSelectionChanged}
             pagination={pagination}
@@ -952,6 +1050,7 @@ function SearchPage() {
             getRowId={(params: GetRowIdParams<File>) =>
               getFileIdentity(params.data)
             }
+            isRowSelectable={(params) => isDeletableKnowledgeRow(params.data)}
             domLayout="normal"
             onSelectionChanged={onSelectionChanged}
             pagination={pagination}
diff --git a/frontend/components/task-dialog/file-list.tsx b/frontend/components/task-dialog/file-list.tsx
index 2a4afc80b..21275fde2 100644
--- a/frontend/components/task-dialog/file-list.tsx
+++ b/frontend/components/task-dialog/file-list.tsx
@@ -9,12 +9,14 @@ import {
   getTaskFileDialogStatusLabel,
   getTaskFileName,
   isTaskFileFailed,
+  isTaskFileRetryable,
   type TaskFileNameSort,
 } from "@/lib/task-utils";
 import { cn } from "@/lib/utils";
 import { TaskDialogFileErrorDetails } from "./file-error-details";
 
 const OSS_ERROR_INDENT = "pl-9";
+const CHECKBOX_CLASS = "h-4 w-4 shrink-0 rounded border-border accent-primary";
 
 type TaskDialogFileListTab = "task-ingestions" | "retry-ingestions";
 
@@ -22,20 +24,31 @@ interface TaskDialogFileListProps {
   isCloudBrand: boolean;
   task: Task;
   entries: Array<[string, TaskFileEntry]>;
+  retryIngestionEntries: Array<[string, TaskFileEntry]>;
   totalSourceCount: number;
   totalSourceCountAll?: number;
   nameSort: TaskFileNameSort;
   onToggleNameSort: () => void;
   expandedPath: string | null;
   onExpandedPathChange: (path: string | null) => void;
-  /** Retry-ingestion row count; tab is shown only when greater than zero. */
   retryIngestionCount?: number;
+  selectablePaths: string[];
+  selectedPaths: Set<string>;
+  allSelectableSelected: boolean;
+  onToggleSelectedPath: (filePath: string) => void;
+  onToggleSelectAllVisible: () => void;
+  allRetryIngestionsSelected: boolean;
+  onToggleSelectAllRetryIngestions: () => void;
+  selectedCount: number;
+  retryIngestionSelectedCount: number;
+  retryingTarget?: "all" | "selected" | string | null;
 }
 
 export function TaskDialogFileList({
   isCloudBrand,
   task,
   entries,
+  retryIngestionEntries,
   totalSourceCount,
   totalSourceCountAll,
   nameSort,
@@ -43,6 +56,16 @@ export function TaskDialogFileList({
   expandedPath,
   onExpandedPathChange,
   retryIngestionCount = 0,
+  selectablePaths,
+  selectedPaths,
+  allSelectableSelected,
+  onToggleSelectedPath,
+  onToggleSelectAllVisible,
+  allRetryIngestionsSelected,
+  onToggleSelectAllRetryIngestions,
+  selectedCount,
+  retryIngestionSelectedCount,
+  retryingTarget = null,
 }: TaskDialogFileListProps) {
   const [activeTab, setActiveTab] =
     useState<TaskDialogFileListTab>("task-ingestions");
@@ -60,7 +83,11 @@ export function TaskDialogFileList({
       string,
       ReturnType<typeof analyzeTaskFileIngestionFailure>
     >();
-    for (const [filePath, fileInfo] of entries) {
+    const allEntries = [...entries, ...retryIngestionEntries];
+    const seen = new Set<string>();
+    for (const [filePath, fileInfo] of allEntries) {
+      if (seen.has(filePath)) continue;
+      seen.add(filePath);
       if (isTaskFileFailed(fileInfo)) {
         map.set(
           filePath,
@@ -69,20 +96,7 @@ export function TaskDialogFileList({
       }
     }
     return map;
-  }, [entries, task.error]);
-
-  if (entries.length === 0) {
-    return (
-      <p
-        className={cn(
-          "text-center text-sm text-muted-foreground",
-          isCloudBrand ? "py-6" : "px-4 py-4",
-        )}
-      >
-        No files match your filters.
-      </p>
-    );
-  }
+  }, [entries, retryIngestionEntries, task.error]);
 
   const containerClass = cn(
     "flex min-h-0 flex-1 flex-col overflow-hidden",
@@ -118,93 +132,188 @@ export function TaskDialogFileList({
 
   const listScrollClass = "min-h-0 flex-1 overflow-y-auto overscroll-contain";
 
-  const fileRows = entries.map(([filePath, fileInfo]) => {
-    const fileName = getTaskFileName(filePath, fileInfo);
-    const failed = isTaskFileFailed(fileInfo);
-    const analysis = analysisByPath.get(filePath);
-    const rowStatusLabel = failed
-      ? (analysis?.rowStatusLabel ?? "Failed")
-      : getTaskFileDialogStatusLabel(fileInfo, task.error);
-    const isExpanded = expandedPath === filePath;
+  const rowGridClass =
+    "grid min-h-10 grid-cols-[auto_auto_1fr_auto] items-center gap-3";
 
-    return (
-      <div
-        key={filePath}
-        className={cn(
-          "border-b last:border-b-0",
-          isCloudBrand ? "border-border" : "border-muted",
-        )}
-      >
+  const renderFileRows = (listEntries: Array<[string, TaskFileEntry]>) =>
+    listEntries.map(([filePath, fileInfo]) => {
+      const fileName = getTaskFileName(filePath, fileInfo);
+      const failed = isTaskFileFailed(fileInfo);
+      const analysis = analysisByPath.get(filePath);
+      const rowStatusLabel = failed
+        ? (analysis?.rowStatusLabel ?? "Failed")
+        : getTaskFileDialogStatusLabel(fileInfo, task.error);
+      const isExpanded = expandedPath === filePath;
+      const retryable = isTaskFileRetryable(fileInfo);
+      const isSelected = selectedPaths.has(filePath);
+      const isRowRetrying =
+        retryingTarget === "all" ||
+        retryingTarget === filePath ||
+        (retryingTarget === "selected" && isSelected);
+      const retryAttempts = fileInfo.retry_count ?? 0;
+      const statusLabel =
+        retryable && retryAttempts > 0
+          ? `${rowStatusLabel} · Retry ${retryAttempts}`
+          : rowStatusLabel;
+
+      return (
         <div
+          key={filePath}
           className={cn(
-            "grid min-h-10 grid-cols-[auto_1fr_auto] items-center gap-3",
-            isCloudBrand ? "px-4 hover:bg-muted/40" : "px-3 hover:bg-muted/30",
+            "border-b last:border-b-0",
+            isCloudBrand ? "border-border" : "border-muted",
+            isSelected && "bg-muted/30",
           )}
         >
-          {failed ? (
+          <div
+            className={cn(
+              rowGridClass,
+              isCloudBrand
+                ? "px-4 hover:bg-muted/40"
+                : "px-3 hover:bg-muted/30",
+              isSelected && "hover:bg-muted/40",
+            )}
+          >
+            {retryable ? (
+              <input
+                type="checkbox"
+                className={CHECKBOX_CLASS}
+                checked={isSelected}
+                disabled={isRowRetrying}
+                aria-label={`Select ${fileName}`}
+                onChange={() => onToggleSelectedPath(filePath)}
+              />
+            ) : (
+              <span className="h-4 w-4 shrink-0" aria-hidden />
+            )}
+            {failed ? (
+              <button
+                type="button"
+                aria-label={isExpanded ? "Collapse error" : "Expand error"}
+                aria-expanded={isExpanded}
+                onClick={() =>
+                  onExpandedPathChange(isExpanded ? null : filePath)
+                }
+                className="inline-flex h-5 w-5 items-center justify-center text-muted-foreground hover:text-foreground"
+              >
+                <ChevronDown
+                  className={cn(
+                    "h-4 w-4 transition-transform",
+                    isExpanded && "rotate-180",
+                  )}
+                />
+              </button>
+            ) : (
+              <span className="h-5 w-5" aria-hidden />
+            )}
             <button
               type="button"
-              aria-label={isExpanded ? "Collapse error" : "Expand error"}
-              aria-expanded={isExpanded}
-              onClick={() => onExpandedPathChange(isExpanded ? null : filePath)}
-              className="inline-flex h-5 w-5 items-center justify-center text-muted-foreground hover:text-foreground"
+              className={cn(
+                "flex min-w-0 items-center gap-2 text-left",
+                failed && "cursor-pointer",
+              )}
+              onClick={() => {
+                if (!failed) return;
+                onExpandedPathChange(isExpanded ? null : filePath);
+              }}
+              disabled={!failed}
             >
-              <ChevronDown
-                className={cn(
-                  "h-4 w-4 transition-transform",
-                  isExpanded && "rotate-180",
-                )}
-              />
+              <FileText className="h-4 w-4 shrink-0 text-muted-foreground" />
+              <span
+                className={cn("truncate text-sm", failed && "text-foreground")}
+                title={fileName}
+              >
+                {fileName}
+              </span>
             </button>
-          ) : (
-            <span className="h-5 w-5" aria-hidden />
-          )}
-          <button
-            type="button"
-            className={cn(
-              "flex min-w-0 items-center gap-2 text-left",
-              failed && "cursor-pointer",
-            )}
-            onClick={() => {
-              if (!failed) return;
-              onExpandedPathChange(isExpanded ? null : filePath);
-            }}
-            disabled={!failed}
-          >
-            <FileText className="h-4 w-4 shrink-0 text-muted-foreground" />
             <span
-              className={cn("truncate text-sm", failed && "text-foreground")}
-              title={fileName}
+              className={cn(
+                "shrink-0 text-sm",
+                failed
+                  ? "text-destructive"
+                  : rowStatusLabel === "Complete"
+                    ? "text-emerald-600 dark:text-emerald-400"
+                    : "text-muted-foreground",
+              )}
             >
-              {fileName}
+              {statusLabel}
             </span>
-          </button>
-          <span
-            className={cn(
-              "shrink-0 text-sm",
-              failed
-                ? "text-destructive"
-                : rowStatusLabel === "Complete"
-                  ? "text-emerald-600 dark:text-emerald-400"
-                  : "text-muted-foreground",
-            )}
-          >
-            {rowStatusLabel}
-          </span>
+          </div>
+
+          {failed && isExpanded && analysis && (
+            <TaskDialogFileErrorDetails
+              isCloudBrand={isCloudBrand}
+              indentClassName={!isCloudBrand ? OSS_ERROR_INDENT : ""}
+              fileInfo={fileInfo}
+              taskError={task.error}
+              analysis={analysis}
+            />
+          )}
         </div>
+      );
+    });
 
-        {failed && isExpanded && analysis && (
-          <TaskDialogFileErrorDetails
-            isCloudBrand={isCloudBrand}
-            indentClassName={!isCloudBrand ? OSS_ERROR_INDENT : ""}
-            fileInfo={fileInfo}
-            taskError={task.error}
-            analysis={analysis}
-          />
-        )}
-      </div>
-    );
-  });
+  const renderListHeader = ({
+    showSelectAll,
+    allSelected,
+    onToggleSelectAll,
+    selectedLabel,
+  }: {
+    showSelectAll: boolean;
+    allSelected: boolean;
+    onToggleSelectAll: () => void;
+    selectedLabel?: string;
+  }) => (
+    <div
+      className={cn(
+        "flex min-h-10 shrink-0 items-center gap-3 bg-muted text-sm font-medium text-muted-foreground",
+        isCloudBrand ? "px-4" : "px-3",
+      )}
+    >
+      {showSelectAll ? (
+        <input
+          type="checkbox"
+          className={CHECKBOX_CLASS}
+          checked={allSelected}
+          disabled={retryingTarget != null}
+          aria-label="Select all retryable files"
+          onChange={onToggleSelectAll}
+        />
+      ) : null}
+      <button
+        type="button"
+        className="inline-flex min-w-0 flex-1 items-center gap-1 hover:text-foreground"
+        onClick={onToggleNameSort}
+      >
+        <span>Source</span>
+        <ArrowUpAZ
+          className={cn(
+            "h-3.5 w-3.5",
+            isCloudBrand ? "opacity-70" : "opacity-50",
+            nameSort === "desc" && "rotate-180",
+          )}
+          aria-hidden
+        />
+        <span className="sr-only">
+          Sort by name {nameSort === "asc" ? "A to Z" : "Z to A"}
+        </span>
+      </button>
+      {selectedLabel ? (
+        <span className="shrink-0 text-xs tabular-nums">{selectedLabel}</span>
+      ) : null}
+    </div>
+  );
+
+  const renderEmptyPanel = (message: string) => (
+    <p
+      className={cn(
+        "text-center text-sm text-muted-foreground",
+        isCloudBrand ? "py-6" : "px-4 py-4",
+      )}
+    >
+      {message}
+    </p>
+  );
 
   return (
     <div className={containerClass}>
@@ -241,48 +350,55 @@ export function TaskDialogFileList({
 
       {isTabActive("task-ingestions") ? (
         <div className="flex min-h-0 flex-1 flex-col overflow-hidden">
-          <div
-            className={cn(
-              "flex min-h-10 shrink-0 items-center gap-1 bg-muted text-sm font-medium text-muted-foreground",
-              isCloudBrand ? "px-4" : "px-3",
-            )}
-          >
-            <button
-              type="button"
-              className="inline-flex items-center gap-1 hover:text-foreground"
-              onClick={onToggleNameSort}
-            >
-              <span>Source</span>
-              <ArrowUpAZ
-                className={cn(
-                  "h-3.5 w-3.5",
-                  isCloudBrand ? "opacity-70" : "opacity-50",
-                  nameSort === "desc" && "rotate-180",
-                )}
-                aria-hidden
-              />
-              <span className="sr-only">
-                Sort by name {nameSort === "asc" ? "A to Z" : "Z to A"}
-              </span>
-            </button>
-          </div>
-          <div
-            id="task-dialog-panel-task-ingestions"
-            role="tabpanel"
-            aria-labelledby="task-dialog-tab-task-ingestions"
-            className={listScrollClass}
-          >
-            {fileRows}
-          </div>
+          {entries.length === 0 ? (
+            renderEmptyPanel("No files match your filters.")
+          ) : (
+            <>
+              {renderListHeader({
+                showSelectAll: selectablePaths.length > 0,
+                allSelected: allSelectableSelected,
+                onToggleSelectAll: onToggleSelectAllVisible,
+                selectedLabel:
+                  selectedCount > 0 ? `${selectedCount} selected` : undefined,
+              })}
+              <div
+                id="task-dialog-panel-task-ingestions"
+                role="tabpanel"
+                aria-labelledby="task-dialog-tab-task-ingestions"
+                className={listScrollClass}
+              >
+                {renderFileRows(entries)}
+              </div>
+            </>
+          )}
         </div>
       ) : (
-        <div
-          id="task-dialog-panel-retry-ingestions"
-          role="tabpanel"
-          aria-labelledby="task-dialog-tab-retry-ingestions"
-          className={cn("flex min-h-0 flex-1 flex-col", listScrollClass)}
-          aria-hidden={!showRetryIngestionsTab}
-        />
+        <div className="flex min-h-0 flex-1 flex-col overflow-hidden">
+          {retryIngestionEntries.length === 0 ? (
+            renderEmptyPanel("No retryable files in this task.")
+          ) : (
+            <>
+              {renderListHeader({
+                showSelectAll: true,
+                allSelected: allRetryIngestionsSelected,
+                onToggleSelectAll: onToggleSelectAllRetryIngestions,
+                selectedLabel:
+                  retryIngestionSelectedCount > 0
+                    ? `${retryIngestionSelectedCount} selected`
+                    : undefined,
+              })}
+              <div
+                id="task-dialog-panel-retry-ingestions"
+                role="tabpanel"
+                aria-labelledby="task-dialog-tab-retry-ingestions"
+                className={listScrollClass}
+                aria-hidden={!showRetryIngestionsTab}
+              >
+                {renderFileRows(retryIngestionEntries)}
+              </div>
+            </>
+          )}
+        </div>
       )}
     </div>
   );
diff --git a/frontend/components/task-dialog/task-dialog.tsx b/frontend/components/task-dialog/task-dialog.tsx
index e4da75aea..3fe715d9c 100644
--- a/frontend/components/task-dialog/task-dialog.tsx
+++ b/frontend/components/task-dialog/task-dialog.tsx
@@ -23,10 +23,16 @@ function TaskDialogContent({
   const isCloudBrand = useIsCloudBrand();
   const {
     task,
+    isLoading,
+    isError,
     fileEntries,
     fileTypes,
     categoryCounts,
     sortedEntries,
+    retryIngestionEntries,
+    retryIngestionSelectedCount,
+    allRetryIngestionsSelected,
+    toggleSelectAllRetryIngestions,
     search,
     setSearch,
     fileType,
@@ -37,10 +43,22 @@ function TaskDialogContent({
     setExpandedPath,
     nameSort,
     toggleNameSort,
+    retryableCount,
+    selectedCount,
+    selectedPaths,
+    selectablePaths,
+    allSelectableSelected,
+    toggleSelectedPath,
+    toggleSelectAllVisible,
+    isRetrying,
+    retryingTarget,
+    handleRetryAll,
+    handleRetrySelected,
   } = useTaskDialog(open, task_id);
 
   const filtersDisabled = !task;
   const fileTypeDisabled = !task || fileTypes.length === 0;
+  const showRetryActions = retryableCount > 0;
 
   return (
     <div className="flex min-h-0 flex-1 flex-col overflow-hidden">
@@ -65,9 +83,11 @@ function TaskDialogContent({
           !isCloudBrand && "px-4",
         )}
       >
-        {!task ? (
+        {isLoading ? (
+          <p className="text-sm text-muted-foreground">Loading task…</p>
+        ) : isError || !task ? (
           <p className="text-sm text-muted-foreground">Task not found.</p>
-        ) : fileEntries.length === 0 ? (
+        ) : fileEntries.length === 0 && retryableCount === 0 ? (
           <p className="text-sm text-muted-foreground">
             No files in this task.
           </p>
@@ -76,25 +96,63 @@ function TaskDialogContent({
             isCloudBrand={isCloudBrand}
             task={task}
             entries={sortedEntries}
+            retryIngestionEntries={retryIngestionEntries}
             totalSourceCount={sortedEntries.length}
             totalSourceCountAll={fileEntries.length}
             nameSort={nameSort}
             onToggleNameSort={toggleNameSort}
             expandedPath={expandedPath}
             onExpandedPathChange={setExpandedPath}
+            retryIngestionCount={retryableCount}
+            selectablePaths={selectablePaths}
+            selectedPaths={selectedPaths}
+            allSelectableSelected={allSelectableSelected}
+            onToggleSelectedPath={toggleSelectedPath}
+            onToggleSelectAllVisible={toggleSelectAllVisible}
+            allRetryIngestionsSelected={allRetryIngestionsSelected}
+            onToggleSelectAllRetryIngestions={toggleSelectAllRetryIngestions}
+            selectedCount={selectedCount}
+            retryIngestionSelectedCount={retryIngestionSelectedCount}
+            retryingTarget={retryingTarget}
           />
         )}
       </div>
 
       <DialogFooter
         className={cn(
-          "shrink-0 flex-row items-center border-t sm:justify-end",
+          "shrink-0 flex-row items-center gap-2 border-t sm:justify-end",
           isCloudBrand ? "px-6 py-4" : "px-4 py-3",
         )}
       >
-        <Button type="button" variant="ghost" onClick={onClose}>
+        <Button
+          type="button"
+          variant="ghost"
+          className={cn(showRetryActions && "flex-1")}
+          onClick={onClose}
+          disabled={isRetrying}
+        >
           {isCloudBrand ? "Cancel" : "Close"}
         </Button>
+        {showRetryActions && selectedCount > 0 ? (
+          <Button
+            type="button"
+            className="flex-1"
+            disabled={isRetrying || !task}
+            onClick={() => void handleRetrySelected()}
+          >
+            {isRetrying ? "Retrying…" : `Retry selected (${selectedCount})`}
+          </Button>
+        ) : null}
+        {showRetryActions && selectedCount === 0 ? (
+          <Button
+            type="button"
+            className="flex-1"
+            disabled={isRetrying || !task}
+            onClick={() => void handleRetryAll()}
+          >
+            {isRetrying ? "Retrying…" : "Retry all"}
+          </Button>
+        ) : null}
       </DialogFooter>
     </div>
   );
diff --git a/frontend/components/task-dialog/use-task-dialog.ts b/frontend/components/task-dialog/use-task-dialog.ts
index 97d169d92..5ef7dab52 100644
--- a/frontend/components/task-dialog/use-task-dialog.ts
+++ b/frontend/components/task-dialog/use-task-dialog.ts
@@ -1,24 +1,106 @@
 "use client";
 
-import { useMemo, useState } from "react";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { toast } from "sonner";
+import {
+  type RetryTaskResponse,
+  useRetryTaskMutation,
+} from "@/app/api/mutations/useRetryTaskMutation";
 import { useGetTaskQuery } from "@/app/api/queries/useGetTaskQuery";
-import type { Task } from "@/app/api/queries/useGetTasksQuery";
 import { useTask } from "@/contexts/task-context";
 import {
   ALL_TASK_FILE_TYPES,
   ALL_TASK_STATUS_CATEGORIES,
+  countRetryIngestionFiles,
   countTaskFilesByCategory,
   filterTaskFileEntries,
+  getRetryableFileEntries,
+  getRetryableFilePaths,
   getTaskFileEntries,
   getTaskFileTypes,
+  isTaskInProgressStatus,
   sortTaskFileEntries,
   type TaskFileNameSort,
   TaskFileStatusCategory,
 } from "@/lib/task-utils";
 
+function showRetryResultToast(result: RetryTaskResponse) {
+  if (result.skipped.length > 0) {
+    const missingSources = result.skipped.filter(
+      (entry) => entry.reason === "source_file_missing",
+    ).length;
+    if (missingSources > 0) {
+      toast.warning("Some files could not be retried", {
+        description: `${result.retried} file(s) queued. ${missingSources} need to be uploaded again.`,
+      });
+      return;
+    }
+  }
+
+  if (result.retried > 0) {
+    toast.success("Retry started", {
+      description: `${result.retried} file(s) queued for ingestion`,
+    });
+    return;
+  }
+
+  toast.warning("No files were retried", {
+    description: result.message ?? "Selected files could not be retried",
+  });
+}
+
 export function useTaskDialog(open: boolean, taskId: string) {
-  const { tasks } = useTask();
-  const { data: taskDetail } = useGetTaskQuery(taskId, { enabled: open });
+  const { markTaskFilesProcessing } = useTask();
+
+  const [selectedPaths, setSelectedPaths] = useState<Set<string>>(
+    () => new Set(),
+  );
+
+  const [retryingTarget, setRetryingTarget] = useState<
+    "all" | "selected" | string | null
+  >(null);
+
+  const retryMutation = useRetryTaskMutation();
+
+  const {
+    data: task,
+    isLoading,
+    isError,
+    refetch: refetchTask,
+  } = useGetTaskQuery(taskId, {
+    enabled: open && !!taskId,
+    refetchOnMount: "always",
+    refetchInterval: (query) => {
+      if (!open) {
+        return false;
+      }
+      if (retryingTarget != null) {
+        return 2000;
+      }
+      const data = query.state.data;
+      if (!data) {
+        return false;
+      }
+      if (isTaskInProgressStatus(data.status)) {
+        return 2000;
+      }
+      return getTaskFileEntries(data).some(([, fileInfo]) => {
+        const status = fileInfo.status ?? "pending";
+        return (
+          status === "pending" ||
+          status === "running" ||
+          status === "processing"
+        );
+      })
+        ? 2000
+        : false;
+    },
+  });
+
+  const retryableCount = useMemo(
+    () => (task ? countRetryIngestionFiles(task) : 0),
+    [task],
+  );
 
   const [search, setSearch] = useState("");
   const [fileType, setFileType] = useState(ALL_TASK_FILE_TYPES);
@@ -28,10 +110,11 @@ export function useTaskDialog(open: boolean, taskId: string) {
   const [expandedPath, setExpandedPath] = useState<string | null>(null);
   const [nameSort, setNameSort] = useState<TaskFileNameSort>("asc");
 
-  const task = useMemo<Task | undefined>(
-    () => taskDetail ?? tasks.find((entry) => entry.task_id === taskId),
-    [taskDetail, tasks, taskId],
-  );
+  useEffect(() => {
+    if (!open) {
+      setSelectedPaths(new Set());
+    }
+  }, [open]);
 
   const fileEntries = useMemo(
     () => (task ? getTaskFileEntries(task) : []),
@@ -56,7 +139,7 @@ export function useTaskDialog(open: boolean, taskId: string) {
         search,
         fileType: activeFileType,
         statusCategory: statusCategory as TaskFileStatusCategory,
-        task,
+        task: task ?? undefined,
       }),
     [fileEntries, search, activeFileType, statusCategory, task],
   );
@@ -66,16 +149,202 @@ export function useTaskDialog(open: boolean, taskId: string) {
     [filteredEntries, nameSort],
   );
 
+  const retryIngestionEntries = useMemo(
+    () =>
+      task ? sortTaskFileEntries(getRetryableFileEntries(task), nameSort) : [],
+    [task, nameSort],
+  );
+
+  const retryIngestionPaths = useMemo(
+    () => retryIngestionEntries.map(([filePath]) => filePath),
+    [retryIngestionEntries],
+  );
+
+  const selectablePaths = useMemo(
+    () => getRetryableFilePaths(sortedEntries),
+    [sortedEntries],
+  );
+
+  const selectedCount = useMemo(() => {
+    let count = 0;
+    for (const path of selectablePaths) {
+      if (selectedPaths.has(path)) {
+        count += 1;
+      }
+    }
+    return count;
+  }, [selectablePaths, selectedPaths]);
+
+  const allSelectableSelected =
+    selectablePaths.length > 0 && selectedCount === selectablePaths.length;
+
+  const retryIngestionSelectedCount = useMemo(() => {
+    let count = 0;
+    for (const path of retryIngestionPaths) {
+      if (selectedPaths.has(path)) {
+        count += 1;
+      }
+    }
+    return count;
+  }, [retryIngestionPaths, selectedPaths]);
+
+  const allRetryIngestionsSelected =
+    retryIngestionPaths.length > 0 &&
+    retryIngestionSelectedCount === retryIngestionPaths.length;
+
+  const selectedRetryablePaths = useMemo(
+    () => selectablePaths.filter((path) => selectedPaths.has(path)),
+    [selectablePaths, selectedPaths],
+  );
+
+  const runRetry = useCallback(
+    async (filePaths?: string[]) => {
+      if (!taskId) {
+        return;
+      }
+      if (!filePaths && retryableCount === 0) {
+        return;
+      }
+      if (filePaths && filePaths.length === 0) {
+        return;
+      }
+
+      const pathsToRetry =
+        filePaths ??
+        (task ? getRetryableFilePaths(getRetryableFileEntries(task)) : []);
+
+      setRetryingTarget(
+        filePaths
+          ? filePaths.length === 1
+            ? filePaths[0]
+            : "selected"
+          : "all",
+      );
+
+      if (pathsToRetry.length > 0) {
+        markTaskFilesProcessing(taskId, pathsToRetry);
+      }
+
+      try {
+        const result = await retryMutation.mutateAsync({
+          taskId,
+          ...(filePaths ? { filePaths } : {}),
+        });
+        await refetchTask();
+        showRetryResultToast(result);
+        if (result.retried > 0) {
+          setSelectedPaths(new Set());
+        }
+      } catch (error) {
+        toast.error("Retry failed", {
+          description:
+            error instanceof Error ? error.message : "Could not retry files",
+        });
+      } finally {
+        setRetryingTarget(null);
+      }
+    },
+    [
+      task,
+      taskId,
+      retryableCount,
+      retryMutation,
+      refetchTask,
+      markTaskFilesProcessing,
+    ],
+  );
+
+  const handleRetryAll = useCallback(() => runRetry(), [runRetry]);
+
+  const handleRetrySelected = useCallback(
+    () => runRetry(selectedRetryablePaths),
+    [runRetry, selectedRetryablePaths],
+  );
+
+  const toggleSelectedPath = useCallback((filePath: string) => {
+    setSelectedPaths((current) => {
+      const next = new Set(current);
+      if (next.has(filePath)) {
+        next.delete(filePath);
+      } else {
+        next.add(filePath);
+      }
+      return next;
+    });
+  }, []);
+
+  const toggleSelectAllVisible = useCallback(() => {
+    setSelectedPaths((current) => {
+      const visible = new Set(selectablePaths);
+      const allSelected =
+        selectablePaths.length > 0 &&
+        selectablePaths.every((path) => current.has(path));
+
+      if (allSelected) {
+        const next = new Set(current);
+        for (const path of visible) {
+          next.delete(path);
+        }
+        return next;
+      }
+
+      const next = new Set(current);
+      for (const path of visible) {
+        next.add(path);
+      }
+      return next;
+    });
+  }, [selectablePaths]);
+
+  const toggleSelectAllRetryIngestions = useCallback(() => {
+    setSelectedPaths((current) => {
+      const allSelected =
+        retryIngestionPaths.length > 0 &&
+        retryIngestionPaths.every((path) => current.has(path));
+
+      if (allSelected) {
+        const next = new Set(current);
+        for (const path of retryIngestionPaths) {
+          next.delete(path);
+        }
+        return next;
+      }
+
+      const next = new Set(current);
+      for (const path of retryIngestionPaths) {
+        next.add(path);
+      }
+      return next;
+    });
+  }, [retryIngestionPaths]);
+
   const toggleNameSort = () => {
     setNameSort((current) => (current === "asc" ? "desc" : "asc"));
   };
 
   return {
-    task,
+    task: task ?? undefined,
+    isLoading,
+    isError,
+    retryableCount,
+    selectedCount,
+    selectedPaths,
+    selectablePaths,
+    allSelectableSelected,
+    toggleSelectedPath,
+    toggleSelectAllVisible,
+    isRetrying: retryMutation.isPending,
+    retryingTarget,
+    handleRetryAll,
+    handleRetrySelected,
     fileEntries,
     fileTypes,
     categoryCounts,
     sortedEntries,
+    retryIngestionEntries,
+    retryIngestionSelectedCount,
+    allRetryIngestionsSelected,
+    toggleSelectAllRetryIngestions,
     search,
     setSearch,
     fileType: activeFileType,
diff --git a/frontend/components/task-error-content.tsx b/frontend/components/task-error-content.tsx
index c50869f35..c03d9fe44 100644
--- a/frontend/components/task-error-content.tsx
+++ b/frontend/components/task-error-content.tsx
@@ -12,11 +12,15 @@ import {
 } from "@/components/ui/accordion";
 import { useIsCloudBrand } from "@/contexts/brand-context";
 import { type Task } from "@/contexts/task-context";
-import { displayFileTaskError } from "@/lib/task-error-display";
+import {
+  formatApiComponent,
+  resolveTaskFileError,
+} from "@/lib/task-error-display";
 import {
   getFailedFileCount,
   getFailedFileEntries,
   getSuccessfulFileCount,
+  getTaskFileName,
   isCompletedTotalFailure,
   isTerminalFailedTask,
 } from "@/lib/task-utils";
@@ -172,14 +176,9 @@ export function TaskErrorContent({
             <AccordionContent className="w-full p-0 pt-2">
               <div className="flex w-full flex-col gap-2">
                 {failedEntries.map(([filePath, fileInfo], index) => {
-                  const fileName =
-                    fileInfo.filename || filePath.split("/").pop() || filePath;
-                  const rawError =
-                    typeof fileInfo.error === "string" && fileInfo.error.trim()
-                      ? fileInfo.error.trim()
-                      : task.error;
-                  const { line, componentCause } =
-                    displayFileTaskError(rawError);
+                  const fileName = getTaskFileName(filePath, fileInfo);
+                  const line = resolveTaskFileError(fileInfo, task.error);
+                  const componentCause = formatApiComponent(fileInfo.component);
 
                   return (
                     <div
@@ -208,7 +207,7 @@ export function TaskErrorContent({
                             ? "text-muted-foreground"
                             : "text-failure-message",
                         )}
-                        title={rawError}
+                        title={line}
                       >
                         {line}
                       </p>
diff --git a/frontend/contexts/task-context.tsx b/frontend/contexts/task-context.tsx
index 838e3760b..121df5fd2 100644
--- a/frontend/contexts/task-context.tsx
+++ b/frontend/contexts/task-context.tsx
@@ -12,18 +12,27 @@ import {
 } from "react";
 import { toast } from "sonner";
 import { useCancelTaskMutation } from "@/app/api/mutations/useCancelTaskMutation";
+import type { SearchResult } from "@/app/api/queries/useGetSearchQuery";
 import {
+  TASKS_QUERY_KEY,
   type Task,
   type TaskFileEntry,
   useGetTasksQuery,
 } from "@/app/api/queries/useGetTasksQuery";
+import type { ListFilesResponse } from "@/app/api/queries/useListFiles";
 import { useAuth } from "@/contexts/auth-context";
 import { useOnboardingState } from "@/hooks/use-onboarding-state";
 import { trackProcessFailure, trackProcessSuccess } from "@/lib/analytics";
+import { getKnowledgeFileIdentity } from "@/lib/knowledge-table-state";
 import {
+  didTaskReachCompleted,
+  finalizeProcessingOverlaysForEnhancedTask,
+  findTaskFileOverlayIndex,
+  getEnhancedListDisappearedFilePaths,
   getFailedFileCount,
   getSuccessfulFileCount,
   hasFailedFileEntries,
+  isTaskInProgressStatus,
   isTerminalFailedTask,
 } from "@/lib/task-utils";
 
@@ -49,6 +58,8 @@ interface TaskContextType {
   files: TaskFile[];
   addTask: (taskId: string) => void;
   addFiles: (files: Partial<TaskFile>[], taskId: string) => void;
+  /** Mark knowledge-table overlays as processing when a retry starts. */
+  markTaskFilesProcessing: (taskId: string, sourceUrls: string[]) => void;
   refreshTasks: () => Promise<void>;
   cancelTask: (taskId: string) => Promise<void>;
   isPolling: boolean;
@@ -102,10 +113,13 @@ export function TaskProvider({ children }: { children: React.ReactNode }) {
   const cancelTaskMutation = useCancelTaskMutation({
     onSuccess: (_data, variables) => {
       // Immediately remove from React Query cache
-      queryClient.setQueryData(["tasks"], (oldTasks: Task[] | undefined) => {
-        if (!oldTasks) return [];
-        return oldTasks.filter((task) => task.task_id !== variables.taskId);
-      });
+      queryClient.setQueryData(
+        [...TASKS_QUERY_KEY],
+        (oldTasks: Task[] | undefined) => {
+          if (!oldTasks) return [];
+          return oldTasks.filter((task) => task.task_id !== variables.taskId);
+        },
+      );
 
       // Update file to display as cancelled
       setFiles((prevFiles) =>
@@ -141,6 +155,33 @@ export function TaskProvider({ children }: { children: React.ReactNode }) {
     });
   }, [queryClient]);
 
+  const markTaskFilesProcessing = useCallback(
+    (taskId: string, sourceUrls: string[]) => {
+      const paths = new Set(sourceUrls);
+      if (paths.size === 0) {
+        return;
+      }
+      const now = new Date().toISOString();
+      setFiles((prevFiles) => {
+        let changed = false;
+        const updated = prevFiles.map((file) => {
+          if (file.task_id !== taskId || !paths.has(file.source_url)) {
+            return file;
+          }
+          changed = true;
+          return {
+            ...file,
+            status: "processing" as const,
+            error: undefined,
+            updated_at: now,
+          };
+        });
+        return changed ? updated : prevFiles;
+      });
+    },
+    [],
+  );
+
   const addFiles = useCallback(
     (newFiles: Partial<TaskFile>[], taskId: string) => {
       const now = new Date().toISOString();
@@ -178,11 +219,7 @@ export function TaskProvider({ children }: { children: React.ReactNode }) {
         (prev) => prev.task_id === currentTask.task_id,
       );
 
-      // Check if task is in progress
-      const isTaskInProgress =
-        currentTask.status === "pending" ||
-        currentTask.status === "running" ||
-        currentTask.status === "processing";
+      const isTaskInProgress = isTaskInProgressStatus(currentTask.status);
 
       // On initial load, previousTasksRef is empty, so we need to process all in-progress tasks
       const isInitialLoad = previousTasksRef.current.length === 0;
@@ -249,8 +286,11 @@ export function TaskProvider({ children }: { children: React.ReactNode }) {
               })();
 
               setFiles((prevFiles) => {
-                const existingFileIndex = prevFiles.findIndex(
-                  (f) => f.source_url === filePath,
+                const existingFileIndex = findTaskFileOverlayIndex(
+                  prevFiles,
+                  currentTask.task_id,
+                  filePath,
+                  fileName,
                 );
 
                 // Detect connector type based on file path or other indicators
@@ -302,28 +342,28 @@ export function TaskProvider({ children }: { children: React.ReactNode }) {
           });
         }
 
-        if (isTaskInProgress && previousTask?.files) {
-          const currentFileKeys = new Set(Object.keys(currentTask.files ?? {}));
-          const disappearedFilePaths = Object.keys(previousTask.files).filter(
-            (fp) => !currentFileKeys.has(fp),
+        if (previousTask?.files) {
+          const disappearedFilePaths = getEnhancedListDisappearedFilePaths(
+            currentTask,
+            previousTask,
           );
-
-          if (disappearedFilePaths.length > 0) {
-            setFiles((prevFiles) => {
-              let changed = false;
-              const updated = prevFiles.map((f) => {
-                if (
-                  f.task_id === currentTask.task_id &&
-                  f.status === "processing" &&
-                  disappearedFilePaths.includes(f.source_url)
-                ) {
-                  changed = true;
-                  return { ...f, status: "active" as TaskFile["status"] };
-                }
-                return f;
-              });
-              return changed ? updated : prevFiles;
-            });
+          const taskJustCompleted = didTaskReachCompleted(
+            previousTask,
+            currentTask,
+          );
+          const shouldFinalizeDisappeared =
+            disappearedFilePaths.length > 0 &&
+            (isTaskInProgress || taskJustCompleted);
+          const shouldFinalizeAllProcessing = taskJustCompleted;
+
+          if (shouldFinalizeDisappeared || shouldFinalizeAllProcessing) {
+            setFiles((prevFiles) =>
+              finalizeProcessingOverlaysForEnhancedTask(
+                prevFiles,
+                currentTask,
+                shouldFinalizeAllProcessing ? undefined : disappearedFilePaths,
+              ),
+            );
             refetchSearch();
           }
         }
@@ -417,12 +457,57 @@ export function TaskProvider({ children }: { children: React.ReactNode }) {
                 e,
               );
             } finally {
+              const indexedIdentities = new Set<string>();
+              const indexedFilenames = new Set<string>();
+              for (const [
+                ,
+                data,
+              ] of queryClient.getQueriesData<ListFilesResponse>({
+                queryKey: ["listFiles"],
+              })) {
+                for (const indexed of data?.files ?? []) {
+                  indexedIdentities.add(getKnowledgeFileIdentity(indexed));
+                  if (indexed.filename?.trim()) {
+                    indexedFilenames.add(indexed.filename.trim());
+                  }
+                }
+              }
+              for (const [, data] of queryClient.getQueriesData<SearchResult>({
+                queryKey: ["search"],
+              })) {
+                for (const indexed of data?.files ?? []) {
+                  indexedIdentities.add(getKnowledgeFileIdentity(indexed));
+                  if (indexed.filename?.trim()) {
+                    indexedFilenames.add(indexed.filename.trim());
+                  }
+                }
+              }
+
               setFiles((prevFiles) =>
-                prevFiles.filter(
-                  (file) =>
-                    file.task_id !== currentTask.task_id ||
-                    (completedHasFailures && file.status === "failed"),
-                ),
+                prevFiles.filter((file) => {
+                  if (file.task_id !== currentTask.task_id) {
+                    return true;
+                  }
+                  if (file.status === "failed") {
+                    return completedHasFailures;
+                  }
+                  if (file.status === "processing") {
+                    return false;
+                  }
+                  if (file.status === "active") {
+                    const filename = file.filename?.trim();
+                    if (filename && indexedFilenames.has(filename)) {
+                      return false;
+                    }
+                    return !indexedIdentities.has(
+                      getKnowledgeFileIdentity({
+                        filename: file.filename,
+                        source_url: file.source_url,
+                      }),
+                    );
+                  }
+                  return false;
+                }),
               );
             }
           }
@@ -531,6 +616,7 @@ export function TaskProvider({ children }: { children: React.ReactNode }) {
     files,
     addTask,
     addFiles,
+    markTaskFilesProcessing,
     refreshTasks,
     cancelTask,
     isPolling,
diff --git a/frontend/lib/task-error-display.ts b/frontend/lib/task-error-display.ts
index 038ee850d..6ba87d05e 100644
--- a/frontend/lib/task-error-display.ts
+++ b/frontend/lib/task-error-display.ts
@@ -1,98 +1,64 @@
-// Prefer API `failure_phase` for failed-step inference; `component_cause` may follow later.
-
-import type { TaskFileEntry } from "@/app/api/queries/useGetTasksQuery";
+import type {
+  TaskFailureComponent,
+  TaskFailurePhase,
+  TaskFileEntry,
+} from "@/app/api/queries/useGetTasksQuery";
 
 export const FILE_ERROR_MAX_LINE_LENGTH = 80;
 
-export type TaskErrorComponentCause = "OpenSearch" | "Docling" | "Langflow";
+export type TaskErrorComponentCause =
+  | "OpenSearch"
+  | "Docling"
+  | "Langflow"
+  | "OpenRAG";
 
-export type IngestionPipelineStepId =
+export type TaskPipelineStepId =
   | "parsing"
   | "chunking"
   | "embedding"
-  | "indexing";
+  | "indexing"
+  | "file_validation"
+  | "unknown";
 
 export interface IngestionPipelineStep {
-  id: IngestionPipelineStepId;
+  id: TaskPipelineStepId;
   label: string;
   status: "completed" | "failed";
 }
 
 export interface TaskFileIngestionFailureAnalysis {
   resolvedError: string;
-  failedStep: IngestionPipelineStepId;
+  failedStep: TaskPipelineStepId;
   pipelineSteps: IngestionPipelineStep[];
   rowStatusLabel: string;
   failureSummary: string;
   componentCause?: TaskErrorComponentCause;
   componentTags: string[];
-  /** Short line for compact panels (truncated). */
   summaryLine: string;
 }
 
-const PIPELINE_STEP_ORDER: IngestionPipelineStepId[] = [
+const PIPELINE_STEP_ORDER: TaskPipelineStepId[] = [
   "parsing",
   "chunking",
   "embedding",
   "indexing",
 ];
 
-const PIPELINE_STEP_LABELS: Record<IngestionPipelineStepId, string> = {
+const PIPELINE_STEP_LABELS: Record<TaskPipelineStepId, string> = {
   parsing: "Parsing",
   chunking: "Chunking",
   embedding: "Embedding",
   indexing: "Indexing",
+  file_validation: "File validation",
+  unknown: "Ingestion",
 };
 
-const COMPONENT_CAUSES: ReadonlyArray<{
-  keyword: RegExp;
-  label: TaskErrorComponentCause;
-}> = [
-  { keyword: /opensearch/i, label: "OpenSearch" },
-  { keyword: /docling/i, label: "Docling" },
-  { keyword: /langflow/i, label: "Langflow" },
-];
-
-const STEP_ERROR_SIGNALS: Record<
-  IngestionPipelineStepId,
-  ReadonlyArray<RegExp>
-> = {
-  parsing: [/docling/i, /\bpars(e|ing)\b/i, /convert/i, /ocr/i],
-  chunking: [/chunk/i, /\bsplit/i, /segment/i],
-  embedding: [/embed/i, /\bvector/i, /dimension/i],
-  indexing: [/opensearch/i, /\bindex/i, /mapping/i, /schema/i],
-};
-
-const ISSUE_TYPE_SIGNALS: ReadonlyArray<{ pattern: RegExp; label: string }> = [
+const COMPONENT_LABELS: Record<TaskFailureComponent, TaskErrorComponentCause> =
   {
-    pattern: /schema|mapping|does not match.*index/i,
-    label: "pipeline configuration issue",
-  },
-  { pattern: /timeout|timed?\s*out/i, label: "timeout" },
-  {
-    pattern: /unauthorized|forbidden|403|401|permission/i,
-    label: "access issue",
-  },
-  { pattern: /connection|unreachable|network/i, label: "connectivity issue" },
-  { pattern: /embed|model|dimension/i, label: "embedding configuration issue" },
-  { pattern: /quota|limit|rate/i, label: "rate limit" },
-];
-
-export interface FileTaskErrorDisplay {
-  line: string;
-  componentCause?: TaskErrorComponentCause;
-}
-
-function normalizeErrorText(raw: string): string {
-  return raw.replace(/\s+/g, " ").trim();
-}
-
-function stripNoisePrefixes(text: string): string {
-  return text
-    .replace(/^Error running graph:\s*/i, "")
-    .replace(/^Error building Component [^:]+:\s*/i, "")
-    .trim();
-}
+    docling: "Docling",
+    openrag: "OpenRAG",
+    langflow: "Langflow",
+  };
 
 function truncateLine(
   text: string,
@@ -104,179 +70,78 @@ function truncateLine(
   return `${text.slice(0, maxLength - 1).trimEnd()}…`;
 }
 
-function extractReadableLine(text: string): string {
-  const beforeCausedBy = text.split(/\s+caused by:/i)[0]?.trim() ?? text;
-
-  if (beforeCausedBy.length <= FILE_ERROR_MAX_LINE_LENGTH) {
-    return beforeCausedBy;
-  }
-
-  const colonParts = beforeCausedBy.split(":");
-  const lastClause = colonParts[colonParts.length - 1]?.trim();
-  if (
-    lastClause &&
-    lastClause.length >= 10 &&
-    lastClause.length <= FILE_ERROR_MAX_LINE_LENGTH
-  ) {
-    return lastClause;
-  }
-
-  return beforeCausedBy;
-}
-
-export function detectComponentCause(
-  raw: string,
+export function formatApiComponent(
+  component?: TaskFailureComponent,
 ): TaskErrorComponentCause | undefined {
-  for (const { keyword, label } of COMPONENT_CAUSES) {
-    if (keyword.test(raw)) {
-      return label;
-    }
+  if (!component) {
+    return undefined;
   }
-  return undefined;
+  return COMPONENT_LABELS[component];
 }
 
-function scorePipelineStepsFromError(
-  error: string,
-): Record<IngestionPipelineStepId, number> {
-  const scores: Record<IngestionPipelineStepId, number> = {
-    parsing: 0,
-    chunking: 0,
-    embedding: 0,
-    indexing: 0,
-  };
-  for (const step of PIPELINE_STEP_ORDER) {
-    for (const pattern of STEP_ERROR_SIGNALS[step]) {
-      if (pattern.test(error)) {
-        scores[step] += 1;
-      }
-    }
+export function normalizeFailurePhase(
+  phase?: string,
+): TaskPipelineStepId | undefined {
+  if (!phase) {
+    return undefined;
   }
-  return scores;
-}
-
-function pickFailedStepFromErrorScores(
-  scores: Record<IngestionPipelineStepId, number>,
-): IngestionPipelineStepId | null {
-  const maxScore = Math.max(...PIPELINE_STEP_ORDER.map((step) => scores[step]));
-  if (maxScore === 0) {
-    return null;
+  if (phase in PIPELINE_STEP_LABELS) {
+    return phase as TaskPipelineStepId;
   }
-  const matching = PIPELINE_STEP_ORDER.filter(
-    (step) => scores[step] === maxScore,
-  );
-  return matching[matching.length - 1] ?? null;
+  return undefined;
 }
 
-function inferFailedStepFromPhase(
-  fileInfo: TaskFileEntry,
-): IngestionPipelineStepId | null {
-  const phase =
-    typeof fileInfo.phase === "string" ? fileInfo.phase.toLowerCase() : "";
-  const doclingStatus =
-    typeof fileInfo.docling_status === "string"
-      ? fileInfo.docling_status.toLowerCase()
-      : "";
-
-  if (phase === "docling" || doclingStatus === "failed") {
-    return "parsing";
+export function buildRowStatusLabel(failedStep: TaskPipelineStepId): string {
+  if (failedStep === "file_validation") {
+    return "File validation issue";
   }
-  if (phase === "langflow") {
-    return "embedding";
+  if (failedStep === "unknown") {
+    return "Failed";
   }
-  if (phase === "complete") {
-    return "indexing";
-  }
-  return null;
+  return `${PIPELINE_STEP_LABELS[failedStep]} issue`;
 }
 
-export function inferFailedPipelineStep(
-  fileInfo: TaskFileEntry,
-  rawError: string,
-): IngestionPipelineStepId {
-  const normalized = normalizeErrorText(rawError);
-  const fromError = pickFailedStepFromErrorScores(
-    scorePipelineStepsFromError(normalized),
-  );
-  if (fromError) {
-    return fromError;
-  }
-  return inferFailedStepFromPhase(fileInfo) ?? "embedding";
+export function buildFailureSummary(failedStep: TaskPipelineStepId): string {
+  return `Failed at ${PIPELINE_STEP_LABELS[failedStep].toLowerCase()}`;
 }
 
-function getPhaseMinimumFailedIndex(phase: string): number {
-  if (phase === "complete") {
-    return PIPELINE_STEP_ORDER.indexOf("indexing");
-  }
-  if (phase === "langflow") {
-    return PIPELINE_STEP_ORDER.indexOf("embedding");
-  }
-  return 0;
-}
-
-export function buildIngestionPipelineSteps(
-  failedStep: IngestionPipelineStepId,
-  fileInfo: TaskFileEntry,
+export function buildPipelineStepsFromFailurePhase(
+  failurePhase: TaskPipelineStepId,
 ): IngestionPipelineStep[] {
-  const phase =
-    typeof fileInfo.phase === "string" ? fileInfo.phase.toLowerCase() : "";
+  if (failurePhase === "file_validation" || failurePhase === "unknown") {
+    return [
+      {
+        id: failurePhase,
+        label: PIPELINE_STEP_LABELS[failurePhase],
+        status: "failed",
+      },
+    ];
+  }
 
-  const failedIndex = PIPELINE_STEP_ORDER.indexOf(failedStep);
-  const lastIndex = Math.max(failedIndex, getPhaseMinimumFailedIndex(phase));
+  const failedIndex = PIPELINE_STEP_ORDER.indexOf(failurePhase);
+  if (failedIndex < 0) {
+    return [
+      { id: "unknown", label: PIPELINE_STEP_LABELS.unknown, status: "failed" },
+    ];
+  }
 
-  return PIPELINE_STEP_ORDER.slice(0, lastIndex + 1).map((id, index) => ({
+  return PIPELINE_STEP_ORDER.slice(0, failedIndex + 1).map((id, index) => ({
     id,
     label: PIPELINE_STEP_LABELS[id],
-    status: index < lastIndex ? "completed" : "failed",
+    status: index < failedIndex ? "completed" : "failed",
   }));
 }
 
-function inferIssueType(error: string): string | null {
-  for (const { pattern, label } of ISSUE_TYPE_SIGNALS) {
-    if (pattern.test(error)) {
-      return label;
-    }
-  }
-  return null;
-}
-
-export function buildFailureSummary(
-  failedStep: IngestionPipelineStepId,
-  error: string,
-): string {
-  const stepLabel = PIPELINE_STEP_LABELS[failedStep].toLowerCase();
-  const issueType = inferIssueType(error);
-  return issueType
-    ? `Failed at ${stepLabel} · ${issueType}`
-    : `Failed at ${stepLabel}`;
-}
-
-export function buildRowStatusLabel(
-  failedStep: IngestionPipelineStepId,
-): string {
-  return `${PIPELINE_STEP_LABELS[failedStep]} issue`;
-}
-
-export function buildComponentTags(
-  error: string,
-  componentCause?: TaskErrorComponentCause,
-): string[] {
-  const tags: string[] = [];
-  if (componentCause) {
-    tags.push(componentCause);
-  }
-  if (/mapping/i.test(error) && !tags.includes("Mapping")) {
-    tags.push("Mapping");
-  }
-  if (/schema/i.test(error) && !tags.includes("Schema")) {
-    tags.push("Schema");
-  }
-  return tags;
-}
-
 export function resolveTaskFileError(
   fileInfo: TaskFileEntry,
   taskError?: string,
 ): string {
+  if (typeof fileInfo.user_facing_message === "string") {
+    const message = fileInfo.user_facing_message.trim();
+    if (message) {
+      return message;
+    }
+  }
   if (typeof fileInfo.error === "string" && fileInfo.error.trim()) {
     return fileInfo.error.trim();
   }
@@ -291,74 +156,19 @@ export function analyzeTaskFileIngestionFailure(
   taskError?: string,
 ): TaskFileIngestionFailureAnalysis {
   const resolvedError = resolveTaskFileError(fileInfo, taskError);
-  const normalized = normalizeErrorText(resolvedError);
-  const componentCause = detectComponentCause(normalized);
-  const failedStep = inferFailedPipelineStep(fileInfo, normalized);
-  const pipelineSteps = buildIngestionPipelineSteps(failedStep, fileInfo);
-  const summaryLine = truncateLine(
-    extractReadableLine(stripNoisePrefixes(normalized)),
-  );
+  const failedStep = normalizeFailurePhase(fileInfo.failure_phase) ?? "unknown";
+  const pipelineSteps = buildPipelineStepsFromFailurePhase(failedStep);
+  const componentCause = formatApiComponent(fileInfo.component);
+  const componentTags = componentCause ? [componentCause] : [];
 
   return {
     resolvedError,
     failedStep,
     pipelineSteps,
     rowStatusLabel: buildRowStatusLabel(failedStep),
-    failureSummary: buildFailureSummary(failedStep, normalized),
+    failureSummary: buildFailureSummary(failedStep),
     componentCause,
-    componentTags: buildComponentTags(normalized, componentCause),
-    summaryLine,
+    componentTags,
+    summaryLine: truncateLine(resolvedError),
   };
 }
-
-/** @deprecated Use analyzeTaskFileIngestionFailure */
-export function getIngestionPipelineSteps(
-  raw: string | undefined | null,
-  componentCause?: TaskErrorComponentCause,
-  fileInfo?: TaskFileEntry,
-): IngestionPipelineStep[] {
-  const resolved = (raw ?? "").trim() || "Unknown error";
-  const failedStep = fileInfo
-    ? inferFailedPipelineStep(fileInfo, resolved)
-    : (pickFailedStepFromErrorScores(scorePipelineStepsFromError(resolved)) ??
-      (componentCause === "Docling"
-        ? "parsing"
-        : componentCause === "Langflow"
-          ? "embedding"
-          : componentCause === "OpenSearch"
-            ? "indexing"
-            : "embedding"));
-  return buildIngestionPipelineSteps(
-    failedStep,
-    fileInfo ??
-      ({ phase: undefined, docling_status: undefined } as TaskFileEntry),
-  );
-}
-
-export function displayFileTaskError(
-  raw: string | undefined | null,
-  fileInfo?: TaskFileEntry,
-  taskError?: string,
-): FileTaskErrorDisplay {
-  if (fileInfo) {
-    const analysis = analyzeTaskFileIngestionFailure(fileInfo, taskError);
-    return {
-      line: analysis.summaryLine,
-      componentCause: analysis.componentCause,
-    };
-  }
-
-  if (!raw?.trim()) {
-    return { line: "Unknown error" };
-  }
-
-  const normalized = normalizeErrorText(raw);
-  const componentCause = detectComponentCause(normalized);
-  let line = stripNoisePrefixes(normalized);
-  line = truncateLine(extractReadableLine(line));
-  if (!line) {
-    line = "Unknown error";
-  }
-
-  return componentCause ? { line, componentCause } : { line };
-}
diff --git a/frontend/lib/task-utils.ts b/frontend/lib/task-utils.ts
index f586cdf8c..9de93438d 100644
--- a/frontend/lib/task-utils.ts
+++ b/frontend/lib/task-utils.ts
@@ -1,8 +1,7 @@
 import type { Task, TaskFileEntry } from "@/app/api/queries/useGetTasksQuery";
 import {
   buildRowStatusLabel,
-  inferFailedPipelineStep,
-  resolveTaskFileError,
+  normalizeFailurePhase,
 } from "@/lib/task-error-display";
 
 export const ALL_TASK_FILE_TYPES = "__all__";
@@ -41,12 +40,14 @@ export function getTaskFileDialogStatusLabel(
   taskError?: string,
 ): string {
   if (isTaskFileFailed(fileInfo)) {
-    return buildRowStatusLabel(
-      inferFailedPipelineStep(
-        fileInfo,
-        resolveTaskFileError(fileInfo, taskError),
-      ),
-    );
+    const failurePhase = normalizeFailurePhase(fileInfo.failure_phase);
+    if (failurePhase) {
+      return buildRowStatusLabel(failurePhase);
+    }
+    if (fileInfo.user_facing_message?.trim()) {
+      return "Failed";
+    }
+    return buildRowStatusLabel("unknown");
   }
   if (isTaskFileCompleted(fileInfo)) {
     return "Complete";
@@ -101,6 +102,32 @@ export function formatTaskFileTypeLabel(fileType: string): string {
   return fileType.toUpperCase();
 }
 
+export function isTaskFileRetryable(fileInfo: TaskFileEntry): boolean {
+  return fileInfo.actionable_by === "RETRYABLE";
+}
+
+export function getRetryableFileEntries(
+  task: Task,
+): Array<[string, TaskFileEntry]> {
+  return getTaskFileEntries(task).filter(([, fileInfo]) =>
+    isTaskFileRetryable(fileInfo),
+  );
+}
+
+export function getRetryableFilePaths(
+  entries: Array<[string, TaskFileEntry]>,
+): string[] {
+  return entries
+    .filter(([, fileInfo]) => isTaskFileRetryable(fileInfo))
+    .map(([filePath]) => filePath);
+}
+
+export function countRetryIngestionFiles(task: Task): number {
+  return getTaskFileEntries(task).filter(([, fileInfo]) =>
+    isTaskFileRetryable(fileInfo),
+  ).length;
+}
+
 function getTaskFileCategoryContext(task: Task): TaskFileCategoryContext {
   return {
     taskHasFailures: hasFailedFileEntries(task),
@@ -212,9 +239,8 @@ export function filterTaskFileEntries(
 export function getFailedFileEntries(
   task: Task,
 ): Array<[string, TaskFileEntry]> {
-  return Object.entries(task.files || {}).filter(
-    ([, fileInfo]) =>
-      fileInfo?.status === "failed" || fileInfo?.status === "error",
+  return Object.entries(task.files || {}).filter(([, fileInfo]) =>
+    isTaskFileFailed(fileInfo),
   );
 }
 
@@ -257,3 +283,121 @@ export function isCompletedTotalFailure(task: Task): boolean {
 export function isFailureLikeTask(task: Task): boolean {
   return isTerminalFailedTask(task) || isCompletedWithFailures(task);
 }
+
+export function isTaskInProgressStatus(status: Task["status"]): boolean {
+  return (
+    status === "pending" || status === "running" || status === "processing"
+  );
+}
+
+/** True when a task has just transitioned to completed. */
+export function didTaskReachCompleted(
+  previousTask: Task | undefined,
+  currentTask: Task,
+): boolean {
+  return (
+    !!previousTask &&
+    previousTask.status !== "completed" &&
+    currentTask.status === "completed"
+  );
+}
+
+/**
+ * File paths present on the previous enhanced-list payload but omitted now.
+ * The enhanced list drops completed files from `files` while a task is still running.
+ */
+/** Stable overlay key before the backend temp path is known. */
+export function pendingTaskFileSourceUrl(
+  taskId: string,
+  filename: string,
+): string {
+  return `pending:${taskId}:${filename}`;
+}
+
+export function isPendingTaskFileSourceUrl(sourceUrl: string): boolean {
+  return sourceUrl.startsWith("pending:");
+}
+
+export function findTaskFileOverlayIndex(
+  files: Array<{ task_id: string; source_url: string; filename: string }>,
+  taskId: string,
+  filePath: string,
+  fileName: string,
+): number {
+  const pendingUrl = pendingTaskFileSourceUrl(taskId, fileName);
+  return files.findIndex(
+    (f) =>
+      f.task_id === taskId &&
+      (f.source_url === filePath ||
+        f.source_url === pendingUrl ||
+        (f.filename === fileName && isPendingTaskFileSourceUrl(f.source_url))),
+  );
+}
+
+export function getEnhancedListDisappearedFilePaths(
+  currentTask: Task,
+  previousTask: Task,
+): string[] {
+  const currentKeys = new Set(Object.keys(currentTask.files ?? {}));
+  return Object.keys(previousTask.files ?? {}).filter(
+    (filePath) => !currentKeys.has(filePath),
+  );
+}
+
+interface ProcessingFileOverlay {
+  task_id: string;
+  source_url: string;
+  status: "active" | "failed" | "processing";
+  error?: string;
+}
+
+/**
+ * Promote local processing overlays when the enhanced list omits completed files.
+ * Pass `disappearedPaths` while the task is in progress; omit it when the task completes
+ * to finalize every remaining processing file for that task.
+ */
+export function finalizeProcessingOverlaysForEnhancedTask<
+  T extends ProcessingFileOverlay,
+>(prevFiles: T[], currentTask: Task, disappearedPaths?: string[]): T[] {
+  const pathsFilter =
+    disappearedPaths === undefined ? null : new Set(disappearedPaths);
+  let changed = false;
+
+  const updated = prevFiles.map((file) => {
+    if (file.task_id !== currentTask.task_id) {
+      return file;
+    }
+    if (pathsFilter !== null && !pathsFilter.has(file.source_url)) {
+      return file;
+    }
+    // Overlays can still be "failed" until the list poll sees a retry as running.
+    if (file.status !== "processing" && file.status !== "failed") {
+      return file;
+    }
+
+    const entry = currentTask.files?.[file.source_url];
+    if (entry && isTaskFileFailed(entry)) {
+      if (file.status === "failed") {
+        const error =
+          typeof entry.error === "string" && entry.error.trim().length > 0
+            ? entry.error.trim()
+            : file.error;
+        if (error === file.error) {
+          return file;
+        }
+      }
+      changed = true;
+      const error =
+        typeof entry.error === "string" && entry.error.trim().length > 0
+          ? entry.error.trim()
+          : file.error;
+      return { ...file, status: "failed" as const, error };
+    }
+
+    // Left the enhanced list (completed files are omitted) or task finished.
+    changed = true;
+    return { ...file, status: "active" as const, error: undefined };
+  });
+
+  return changed ? (updated as T[]) : prevFiles;
+}
diff --git a/frontend/tests/core/tasks-unified-panel.spec.ts b/frontend/tests/core/tasks-unified-panel.spec.ts
index 7bb57146a..3d6797a29 100644
--- a/frontend/tests/core/tasks-unified-panel.spec.ts
+++ b/frontend/tests/core/tasks-unified-panel.spec.ts
@@ -64,7 +64,11 @@ const buildTask = (
 
 const wireTasksState = async (page: Page, initialTasks: MockTask[]) => {
   let currentTasks = initialTasks;
-  await page.route("**/api/tasks", async (route: Route) => {
+  await page.route("**/api/tasks**", async (route: Route) => {
+    if (route.request().method() !== "GET") {
+      await route.continue();
+      return;
+    }
     await route.fulfill({
       status: 200,
       contentType: "application/json",
diff --git a/src/api/tasks.py b/src/api/tasks.py
index c5c779ce7..02435567d 100644
--- a/src/api/tasks.py
+++ b/src/api/tasks.py
@@ -1,5 +1,6 @@
-from fastapi import Depends
+from fastapi import Body, Depends
 from fastapi.responses import JSONResponse
+from pydantic import BaseModel, Field
 
 from dependencies import get_current_user, get_task_service
 from session_manager import User
@@ -50,6 +51,39 @@ async def all_tasks_enhanced(
     return JSONResponse({"tasks": tasks})
 
 
+class RetryTaskBody(BaseModel):
+    file_paths: list[str] | None = Field(
+        default=None,
+        description=(
+            "Optional subset of task file paths to retry. "
+            "Omit to retry all failed RETRYABLE files."
+        ),
+    )
+
+
+async def retry_task(
+    task_id: str,
+    body: RetryTaskBody = Body(default_factory=RetryTaskBody),
+    task_service=Depends(get_task_service),
+    user: User = Depends(get_current_user),
+):
+    """Re-run ingestion for failed RETRYABLE files in an existing task."""
+    result = await task_service.retry_failed_files(
+        user.user_id, task_id, file_paths=body.file_paths
+    )
+    if result is None:
+        return JSONResponse({"error": "Task not found"}, status_code=404)
+
+    if result.get("error") == "task_in_progress":
+        return JSONResponse(result, status_code=409)
+
+    if result.get("status") == "no_op":
+        return JSONResponse(result, status_code=400)
+
+    await TelemetryClient.send_event(Category.TASK_OPERATIONS, MessageId.ORB_TASK_CREATED)
+    return JSONResponse(result, status_code=202)
+
+
 async def cancel_task(
     task_id: str,
     task_service=Depends(get_task_service),
diff --git a/src/app/routes/internal.py b/src/app/routes/internal.py
index 86b13e80e..21bc25e7e 100644
--- a/src/app/routes/internal.py
+++ b/src/app/routes/internal.py
@@ -91,6 +91,12 @@ def register_internal_routes(app: FastAPI):
         tags=["internal"],
     )
     app.add_api_route("/tasks", tasks.all_tasks, methods=["GET"], tags=["internal"])
+    app.add_api_route(
+        "/tasks/{task_id}/retry",
+        tasks.retry_task,
+        methods=["POST"],
+        tags=["internal"],
+    )
     app.add_api_route(
         "/tasks/{task_id}/cancel",
         tasks.cancel_task,
diff --git a/src/services/task_service.py b/src/services/task_service.py
index 20604ff84..4fa4d6c5b 100644
--- a/src/services/task_service.py
+++ b/src/services/task_service.py
@@ -17,6 +17,48 @@
 
 logger = get_logger(__name__)
 
+# Substrings that indicate a permanent file/content problem (not worth retrying).
+_NON_RETRYABLE_FILE_ERROR_MARKERS = (
+    "corrupt",
+    "corrupted",
+    "corruption",
+    "invalid file",
+    "invalid document",
+    "unsupported format",
+    "unsupported file",
+    "malformed",
+    "damaged",
+    "not a zip file",
+    "bad zipfile",
+    "failed to parse",
+    "could not be parsed",
+    "cannot parse",
+    "no text content could be extracted",
+    "empty or unreadable",
+    "unreadable",
+    "validationerror",
+)
+
+# Docling polling errors that are transient (service/timeout), not bad file content.
+_DOCLING_TRANSIENT_ERROR_MARKERS = (
+    "(timeout)",
+    "timed out",
+    "polling exceeded",
+    "polling timed out",
+)
+
+
+def _is_non_retryable_file_error(error: str) -> bool:
+    lowered = error.lower()
+    return any(marker in lowered for marker in _NON_RETRYABLE_FILE_ERROR_MARKERS)
+
+
+def _is_docling_transient_error(error: str) -> bool:
+    lowered = error.lower()
+    if "docling conversion did not complete" not in lowered:
+        return False
+    return any(marker in lowered for marker in _DOCLING_TRANSIENT_ERROR_MARKERS)
+
 
 class IngestionTimeoutError(Exception):
     """Raised when file processing exceeds the configured timeout"""
@@ -590,6 +632,155 @@ def _resolve_upload_task(self, user_id: str, task_id: str) -> UploadTask | None:
                 return self.task_store[candidate_user_id][task_id]
         return None
 
+    def _resolve_upload_task_store(
+        self, user_id: str, task_id: str
+    ) -> tuple[str, UploadTask] | None:
+        """Return (store_user_id, upload_task) for a task visible to this user."""
+        if not task_id:
+            return None
+        for candidate_user_id in [user_id, AnonymousUser().user_id]:
+            if (
+                candidate_user_id in self.task_store
+                and task_id in self.task_store[candidate_user_id]
+            ):
+                return candidate_user_id, self.task_store[candidate_user_id][task_id]
+        return None
+
+    async def retry_failed_files(
+        self,
+        user_id: str,
+        task_id: str,
+        *,
+        file_paths: list[str] | None = None,
+        retryable_only: bool = True,
+    ) -> dict | None:
+        """Re-queue failed files for ingestion when their source paths still exist.
+
+        Only files classified as RETRYABLE are retried when *retryable_only* is
+        True (the default). When *file_paths* is set, only those task paths are
+        considered; paths missing from the task or not in a failed state are
+        reported in *skipped*. This reuses the task's original processor — it
+        does not accept new uploads from the client.
+        """
+        resolved = self._resolve_upload_task_store(user_id, task_id)
+        if resolved is None:
+            return None
+
+        store_user_id, upload_task = resolved
+
+        if upload_task.status == TaskStatus.RUNNING:
+            return {
+                "error": "task_in_progress",
+                "message": "Task is still running",
+                "task_id": task_id,
+            }
+
+        processor = upload_task.processor
+        if processor is None:
+            return {
+                "error": "no_processor",
+                "message": "Cannot retry: task processor is no longer available",
+                "task_id": task_id,
+            }
+
+        paths_to_retry: list[str] = []
+        skipped: list[dict] = []
+        requested_paths = set(file_paths) if file_paths is not None else None
+
+        if requested_paths is not None:
+            for path in requested_paths:
+                file_task = upload_task.file_tasks.get(path)
+                if file_task is None:
+                    skipped.append({"file_path": path, "reason": "file_not_in_task"})
+                elif file_task.status != TaskStatus.FAILED:
+                    skipped.append(
+                        {
+                            "file_path": path,
+                            "filename": file_task.filename,
+                            "reason": "not_failed",
+                        }
+                    )
+
+        # Build retry candidates before mutating shared task/file state.
+        retry_candidates: list[tuple[str, FileTask]] = []
+        for file_path, file_task in list(upload_task.file_tasks.items()):
+            if requested_paths is not None and file_path not in requested_paths:
+                continue
+            if file_task.status != TaskStatus.FAILED:
+                continue
+
+            if retryable_only:
+                metadata = self._infer_failure_metadata(file_task)
+                if not metadata or metadata.get("actionable_by") != "RETRYABLE":
+                    skipped.append(
+                        {
+                            "file_path": file_path,
+                            "filename": file_task.filename,
+                            "reason": "not_retryable",
+                        }
+                    )
+                    continue
+
+            if not os.path.isfile(file_path):
+                skipped.append(
+                    {
+                        "file_path": file_path,
+                        "filename": file_task.filename,
+                        "reason": "source_file_missing",
+                    }
+                )
+                continue
+
+            retry_candidates.append((file_path, file_task))
+
+        # All shared task/file state transitions are protected by the task lock
+        # so retry requests and background processors cannot interleave updates.
+        async with self._get_task_lock(task_id):
+            now = time.time()
+            for file_path, file_task in retry_candidates:
+                if upload_task.failed_files > 0:
+                    upload_task.failed_files -= 1
+                if upload_task.processed_files > 0:
+                    upload_task.processed_files -= 1
+
+                file_task.status = TaskStatus.PENDING
+                file_task.error = None
+                file_task.result = None
+                file_task.retry_count += 1
+                file_task.docling_status = DoclingPhaseStatus.PENDING
+                file_task.phase = IngestionPhase.DOCLING
+                file_task.docling_task_id = None
+                file_task.updated_at = now
+                paths_to_retry.append(file_path)
+
+        if not paths_to_retry:
+            return {
+                "task_id": task_id,
+                "retried": 0,
+                "skipped": skipped,
+                "status": "no_op",
+                "message": "No retryable files with available source data",
+            }
+
+        async with self._get_task_lock(task_id):
+            upload_task.status = TaskStatus.RUNNING
+            upload_task.updated_at = time.time()
+
+        background_task = asyncio.create_task(
+            self.background_custom_processor(
+                store_user_id, task_id, paths_to_retry, processor
+            )
+        )
+        self.background_tasks.add(background_task)
+        background_task.add_done_callback(self.background_tasks.discard)
+
+        return {
+            "task_id": task_id,
+            "retried": len(paths_to_retry),
+            "skipped": skipped,
+            "status": "accepted",
+        }
+
     def _serialize_file_task(self, file_task: FileTask) -> dict:
         """Serialize a FileTask to the standard dict shape."""
         return {
@@ -613,35 +804,42 @@ def _infer_failure_metadata(self, file_task: FileTask) -> dict | None:
         actionable_by when the failure can be classified, or None when the cause
         is unknown and no fields should be emitted.
 
-        Priority order: docling_status enum first (stable), error string patterns
-        second (fallback for edge cases like polling timeout).
+        Priority order: transient / retryable docling outcomes (expired, polling
+        timeout) before generic docling FAILED, which indicates conversion failure.
         """
         docling_status = file_task.docling_status
         phase = file_task.phase
         error = file_task.error or ""
 
-        if docling_status == DoclingPhaseStatus.FAILED:
+        if docling_status == DoclingPhaseStatus.EXPIRED:
             return {
                 "component": "docling",
                 "failure_phase": "parsing",
                 "user_facing_message": (
-                    "The file could not be processed into readable document content."
+                    "The document processing result could not be found. "
+                    "The task may have expired. Please retry ingestion."
                 ),
-                "actionable_by": "USER_ACTIONABLE",
+                "actionable_by": "RETRYABLE",
             }
 
-        if docling_status == DoclingPhaseStatus.EXPIRED:
+        if _is_non_retryable_file_error(error):
+            if phase == IngestionPhase.LANGFLOW:
+                component = "langflow"
+                failure_phase = "unknown"
+            else:
+                component = "docling"
+                failure_phase = "parsing"
             return {
-                "component": "docling",
-                "failure_phase": "parsing",
+                "component": component,
+                "failure_phase": failure_phase,
                 "user_facing_message": (
-                    "The document processing result could not be found. "
-                    "The task may have expired. Please retry ingestion."
+                    "The file appears corrupted or invalid and cannot be processed. "
+                    "Upload a valid file."
                 ),
-                "actionable_by": "RETRYABLE",
+                "actionable_by": "USER_ACTIONABLE",
             }
 
-        if phase == IngestionPhase.DOCLING and "Docling conversion did not complete" in error:
+        if phase == IngestionPhase.DOCLING and _is_docling_transient_error(error):
             return {
                 "component": "docling",
                 "failure_phase": "parsing",
@@ -657,6 +855,16 @@ def _infer_failure_metadata(self, file_task: FileTask) -> dict | None:
                 "actionable_by": "RETRYABLE",
             }
 
+        if docling_status == DoclingPhaseStatus.FAILED:
+            return {
+                "component": "docling",
+                "failure_phase": "parsing",
+                "user_facing_message": (
+                    "The file could not be processed into readable document content."
+                ),
+                "actionable_by": "USER_ACTIONABLE",
+            }
+
         if "already exists" in error:
             return {
                 "component": "openrag",
@@ -666,6 +874,19 @@ def _infer_failure_metadata(self, file_task: FileTask) -> dict | None:
             }
 
         if phase == IngestionPhase.LANGFLOW:
+            error_lower = error.lower()
+            if any(
+                marker in error_lower
+                for marker in ("timeout", "timed out", "unavailable", "connection refused")
+            ):
+                return {
+                    "component": "langflow",
+                    "failure_phase": "unknown",
+                    "user_facing_message": (
+                        "Ingestion timed out or the service was unavailable. Please retry."
+                    ),
+                    "actionable_by": "RETRYABLE",
+                }
             return {
                 "component": "langflow",
                 "failure_phase": "unknown",
diff --git a/tests/unit/test_task_service_get_task_status2.py b/tests/unit/test_task_service_get_task_status2.py
index 01b54321b..b141455cd 100644
--- a/tests/unit/test_task_service_get_task_status2.py
+++ b/tests/unit/test_task_service_get_task_status2.py
@@ -87,6 +87,57 @@ def test_docling_timeout_via_error_string(self, task_service):
         assert meta["failure_phase"] == "parsing"
         assert meta["actionable_by"] == "RETRYABLE"
 
+    def test_docling_polling_timeout_sets_failed_status(self, task_service):
+        """Backend polling marks TIMEOUT as docling_status=FAILED; still retryable."""
+        ft = _make_file_task(
+            phase=IngestionPhase.DOCLING,
+            docling_status=DoclingPhaseStatus.FAILED,
+            error=(
+                "Docling conversion did not complete (timeout): "
+                "Docling polling timed out after 10s"
+            ),
+        )
+        meta = task_service._infer_failure_metadata(ft)
+        assert meta is not None
+        assert meta["actionable_by"] == "RETRYABLE"
+
+    def test_docling_conversion_failed_not_retryable(self, task_service):
+        """Permanent conversion failure (e.g. corrupt file) is not retryable."""
+        ft = _make_file_task(
+            phase=IngestionPhase.DOCLING,
+            docling_status=DoclingPhaseStatus.FAILED,
+            error=(
+                "Docling conversion did not complete (failed): "
+                "Docling reported failure"
+            ),
+        )
+        meta = task_service._infer_failure_metadata(ft)
+        assert meta is not None
+        assert meta["actionable_by"] == "USER_ACTIONABLE"
+
+    def test_corrupt_docx_bad_zip_not_retryable(self, task_service):
+        ft = _make_file_task(
+            phase=IngestionPhase.DOCLING,
+            docling_status=DoclingPhaseStatus.FAILED,
+            error=(
+                "Docling conversion did not complete (failed): "
+                "BadZipFile: File is not a zip file"
+            ),
+        )
+        meta = task_service._infer_failure_metadata(ft)
+        assert meta is not None
+        assert meta["actionable_by"] == "USER_ACTIONABLE"
+
+    def test_langflow_empty_content_not_retryable(self, task_service):
+        ft = _make_file_task(
+            phase=IngestionPhase.LANGFLOW,
+            docling_status=DoclingPhaseStatus.SUCCESS,
+            error="No text content could be extracted from document",
+        )
+        meta = task_service._infer_failure_metadata(ft)
+        assert meta is not None
+        assert meta["actionable_by"] == "USER_ACTIONABLE"
+
     def test_docling_phase_still_processing(self, task_service):
         ft = _make_file_task(
             phase=IngestionPhase.DOCLING,

From f418f5fe3d9fb7163289ee4073fc6c54b639b7e4 Mon Sep 17 00:00:00 2001
From: "autofix-ci[bot]" <114827586+autofix-ci[bot]@users.noreply.github.com>
Date: Wed, 27 May 2026 21:34:43 +0000
Subject: [PATCH 15/25] style: ruff autofix (auto)

---
 src/api/tasks.py                                 |  3 +--
 src/services/task_service.py                     |  4 +---
 tests/unit/test_task_service_get_task_status2.py | 11 +++--------
 3 files changed, 5 insertions(+), 13 deletions(-)

diff --git a/src/api/tasks.py b/src/api/tasks.py
index 02435567d..ed27b24a0 100644
--- a/src/api/tasks.py
+++ b/src/api/tasks.py
@@ -55,8 +55,7 @@ class RetryTaskBody(BaseModel):
     file_paths: list[str] | None = Field(
         default=None,
         description=(
-            "Optional subset of task file paths to retry. "
-            "Omit to retry all failed RETRYABLE files."
+            "Optional subset of task file paths to retry. Omit to retry all failed RETRYABLE files."
         ),
     )
 
diff --git a/src/services/task_service.py b/src/services/task_service.py
index 4fa4d6c5b..9322cf13e 100644
--- a/src/services/task_service.py
+++ b/src/services/task_service.py
@@ -767,9 +767,7 @@ async def retry_failed_files(
             upload_task.updated_at = time.time()
 
         background_task = asyncio.create_task(
-            self.background_custom_processor(
-                store_user_id, task_id, paths_to_retry, processor
-            )
+            self.background_custom_processor(store_user_id, task_id, paths_to_retry, processor)
         )
         self.background_tasks.add(background_task)
         background_task.add_done_callback(self.background_tasks.discard)
diff --git a/tests/unit/test_task_service_get_task_status2.py b/tests/unit/test_task_service_get_task_status2.py
index b141455cd..8d7a4c082 100644
--- a/tests/unit/test_task_service_get_task_status2.py
+++ b/tests/unit/test_task_service_get_task_status2.py
@@ -93,8 +93,7 @@ def test_docling_polling_timeout_sets_failed_status(self, task_service):
             phase=IngestionPhase.DOCLING,
             docling_status=DoclingPhaseStatus.FAILED,
             error=(
-                "Docling conversion did not complete (timeout): "
-                "Docling polling timed out after 10s"
+                "Docling conversion did not complete (timeout): Docling polling timed out after 10s"
             ),
         )
         meta = task_service._infer_failure_metadata(ft)
@@ -106,10 +105,7 @@ def test_docling_conversion_failed_not_retryable(self, task_service):
         ft = _make_file_task(
             phase=IngestionPhase.DOCLING,
             docling_status=DoclingPhaseStatus.FAILED,
-            error=(
-                "Docling conversion did not complete (failed): "
-                "Docling reported failure"
-            ),
+            error=("Docling conversion did not complete (failed): Docling reported failure"),
         )
         meta = task_service._infer_failure_metadata(ft)
         assert meta is not None
@@ -120,8 +116,7 @@ def test_corrupt_docx_bad_zip_not_retryable(self, task_service):
             phase=IngestionPhase.DOCLING,
             docling_status=DoclingPhaseStatus.FAILED,
             error=(
-                "Docling conversion did not complete (failed): "
-                "BadZipFile: File is not a zip file"
+                "Docling conversion did not complete (failed): BadZipFile: File is not a zip file"
             ),
         )
         meta = task_service._infer_failure_metadata(ft)

From 4fff47b817f2d6d1337e50825fbf55d462d470d9 Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Wed, 27 May 2026 20:54:27 -0400
Subject: [PATCH 16/25] lint fix and re-rendering in gridRows changes

---
 .../app/api/mutations/useRetryTaskMutation.ts |  79 ++++++++++
 frontend/app/knowledge/page.tsx               |  68 ++++++---
 frontend/lib/task-error-display.ts            |   1 +
 .../test_task_service_retry_failed_files.py   | 137 ++++++++++++++++++
 4 files changed, 264 insertions(+), 21 deletions(-)
 create mode 100644 frontend/app/api/mutations/useRetryTaskMutation.ts
 create mode 100644 tests/unit/test_task_service_retry_failed_files.py

diff --git a/frontend/app/api/mutations/useRetryTaskMutation.ts b/frontend/app/api/mutations/useRetryTaskMutation.ts
new file mode 100644
index 000000000..7843b3720
--- /dev/null
+++ b/frontend/app/api/mutations/useRetryTaskMutation.ts
@@ -0,0 +1,79 @@
+import {
+  type UseMutationOptions,
+  useMutation,
+  useQueryClient,
+} from "@tanstack/react-query";
+import { taskDetailQueryKey } from "@/app/api/queries/useGetTaskQuery";
+
+export interface RetryTaskRequest {
+  taskId: string;
+  /** When set, only these task file paths are retried. Omit to retry all failed RETRYABLE files. */
+  filePaths?: string[];
+}
+
+export interface RetryTaskSkippedFile {
+  file_path: string;
+  filename?: string;
+  reason:
+    | "not_retryable"
+    | "source_file_missing"
+    | "file_not_in_task"
+    | "not_failed"
+    | string;
+}
+
+export interface RetryTaskResponse {
+  task_id: string;
+  retried: number;
+  skipped: RetryTaskSkippedFile[];
+  status: string;
+  message?: string;
+  error?: string;
+}
+
+export const useRetryTaskMutation = (
+  options?: Omit<
+    UseMutationOptions<RetryTaskResponse, Error, RetryTaskRequest>,
+    "mutationFn"
+  >,
+) => {
+  const queryClient = useQueryClient();
+
+  async function retryTask(
+    variables: RetryTaskRequest,
+  ): Promise<RetryTaskResponse> {
+    const body =
+      variables.filePaths != null
+        ? JSON.stringify({ file_paths: variables.filePaths })
+        : undefined;
+
+    const response = await fetch(`/api/tasks/${variables.taskId}/retry`, {
+      method: "POST",
+      headers: body ? { "Content-Type": "application/json" } : undefined,
+      body,
+    });
+
+    const payload = (await response
+      .json()
+      .catch(() => ({}))) as RetryTaskResponse;
+
+    if (!response.ok) {
+      throw new Error(
+        payload.message || payload.error || "Failed to retry task files",
+      );
+    }
+
+    return payload;
+  }
+
+  return useMutation({
+    mutationFn: retryTask,
+    onSuccess: (_data, variables) => {
+      queryClient.invalidateQueries({ queryKey: ["tasks"], exact: false });
+      queryClient.invalidateQueries({
+        queryKey: taskDetailQueryKey(variables.taskId),
+      });
+    },
+    ...options,
+  });
+};
diff --git a/frontend/app/knowledge/page.tsx b/frontend/app/knowledge/page.tsx
index 086148c55..eed4f51d6 100644
--- a/frontend/app/knowledge/page.tsx
+++ b/frontend/app/knowledge/page.tsx
@@ -67,6 +67,14 @@ import {
   useSyncAllConnectorsPreview,
 } from "../api/mutations/useSyncConnector";
 
+function sameFileSelection(a: File[], b: File[]): boolean {
+  if (a.length !== b.length) {
+    return false;
+  }
+  const identities = new Set(b.map((row) => getKnowledgeFileIdentity(row)));
+  return a.every((row) => identities.has(getKnowledgeFileIdentity(row)));
+}
+
 /** Failed overlays can stay selected after they lose their checkbox (processing → failed). */
 function syncGridSelectionToDeletableRows(
   api: NonNullable<AgGridReact<File>["api"]>,
@@ -80,6 +88,21 @@ function syncGridSelectionToDeletableRows(
   return api.getSelectedRows().filter(isDeletable);
 }
 
+/** Deselect non-deletable rows in the grid only; returns whether anything changed. */
+function pruneNonDeletableGridSelection(
+  api: NonNullable<AgGridReact<File>["api"]>,
+  isDeletable: (file?: File) => boolean,
+): boolean {
+  let pruned = false;
+  api.forEachNode((node) => {
+    if (node.isSelected() && !isDeletable(node.data)) {
+      node.setSelected(false);
+      pruned = true;
+    }
+  });
+  return pruned;
+}
+
 /** List-files uses term filters; "*" means "any" in the UI — do not send it literally. */
 function listFilesFilterParam(values?: string[]): string | undefined {
   const raw = values?.[0]?.trim();
@@ -464,28 +487,30 @@ function SearchPage() {
   const gridRows = fileResults;
   const gridRef = useRef<AgGridReact>(null);
 
+  // Re-run only when row identity/status changes, not on every list poll reference.
+  const gridRowsSelectionKey = useMemo(
+    () =>
+      gridRows
+        .map(
+          (row) => `${getKnowledgeFileIdentity(row)}:${row.status ?? "active"}`,
+        )
+        .join("\0"),
+    [gridRows],
+  );
+
   useEffect(() => {
     const api = gridRef.current?.api;
     if (!api) {
       return;
     }
-    const activeSelected = syncGridSelectionToDeletableRows(
-      api,
-      isDeletableKnowledgeRow,
+    if (!pruneNonDeletableGridSelection(api, isDeletableKnowledgeRow)) {
+      return;
+    }
+    const nextSelected = api.getSelectedRows().filter(isDeletableKnowledgeRow);
+    setSelectedRows((current) =>
+      sameFileSelection(current, nextSelected) ? current : nextSelected,
     );
-    setSelectedRows((current) => {
-      if (
-        current.length === activeSelected.length &&
-        current.every(
-          (row, index) =>
-            getFileIdentity(row) === getFileIdentity(activeSelected[index]),
-        )
-      ) {
-        return current;
-      }
-      return activeSelected;
-    });
-  }, [gridRows, getFileIdentity, isDeletableKnowledgeRow]);
+  }, [gridRowsSelectionKey, isDeletableKnowledgeRow]);
 
   const columnDefs: ColDef<File>[] = [
     {
@@ -758,11 +783,12 @@ function SearchPage() {
     if (!gridRef.current) {
       return;
     }
-    setSelectedRows(
-      syncGridSelectionToDeletableRows(
-        gridRef.current.api,
-        isDeletableKnowledgeRow,
-      ),
+    const nextSelected = syncGridSelectionToDeletableRows(
+      gridRef.current.api,
+      isDeletableKnowledgeRow,
+    );
+    setSelectedRows((current) =>
+      sameFileSelection(current, nextSelected) ? current : nextSelected,
     );
   }, [isDeletableKnowledgeRow]);
 
diff --git a/frontend/lib/task-error-display.ts b/frontend/lib/task-error-display.ts
index 6ba87d05e..bbe2e8277 100644
--- a/frontend/lib/task-error-display.ts
+++ b/frontend/lib/task-error-display.ts
@@ -58,6 +58,7 @@ const COMPONENT_LABELS: Record<TaskFailureComponent, TaskErrorComponentCause> =
     docling: "Docling",
     openrag: "OpenRAG",
     langflow: "Langflow",
+    opensearch: "OpenSearch",
   };
 
 function truncateLine(
diff --git a/tests/unit/test_task_service_retry_failed_files.py b/tests/unit/test_task_service_retry_failed_files.py
new file mode 100644
index 000000000..cf29433b5
--- /dev/null
+++ b/tests/unit/test_task_service_retry_failed_files.py
@@ -0,0 +1,137 @@
+"""Unit tests for TaskService.retry_failed_files."""
+
+from unittest.mock import AsyncMock, Mock, patch
+
+import pytest
+
+from models.tasks import DoclingPhaseStatus, FileTask, IngestionPhase, TaskStatus, UploadTask
+from services.task_service import TaskService
+
+
+@pytest.fixture
+def task_service():
+    return TaskService(document_service=Mock(), ingestion_timeout=2)
+
+
+def _retryable_failed_file(
+    file_path: str = "/data/doc.pdf",
+    *,
+    error: str = "Docling conversion did not complete (timeout)",
+) -> FileTask:
+    ft = FileTask(file_path=file_path, filename="doc.pdf")
+    ft.status = TaskStatus.FAILED
+    ft.phase = IngestionPhase.DOCLING
+    ft.docling_status = DoclingPhaseStatus.FAILED
+    ft.error = error
+    return ft
+
+
+def _store_task(
+    task_service: TaskService,
+    user_id: str,
+    upload_task: UploadTask,
+) -> None:
+    task_service.task_store.setdefault(user_id, {})[upload_task.task_id] = upload_task
+
+
+@pytest.mark.asyncio
+async def test_retry_all_failed_retryable_files(task_service):
+    processor = Mock()
+    ft_a = _retryable_failed_file("/data/a.pdf")
+    ft_b = _retryable_failed_file("/data/b.pdf")
+    task = UploadTask(
+        task_id="task-1",
+        total_files=2,
+        file_tasks={"/data/a.pdf": ft_a, "/data/b.pdf": ft_b},
+        status=TaskStatus.FAILED,
+        failed_files=2,
+        processor=processor,
+    )
+    _store_task(task_service, "user1", task)
+
+    with (
+        patch("os.path.isfile", return_value=True),
+        patch.object(
+            task_service,
+            "background_custom_processor",
+            new_callable=AsyncMock,
+        ) as mock_bg,
+        patch("asyncio.create_task", return_value=Mock()),
+    ):
+        result = await task_service.retry_failed_files("user1", "task-1")
+
+    assert result is not None
+    assert result["retried"] == 2
+    assert result["status"] == "accepted"
+    assert ft_a.status == TaskStatus.PENDING
+    assert ft_b.status == TaskStatus.PENDING
+    mock_bg.assert_called_once()
+    assert set(mock_bg.call_args[0][2]) == {"/data/a.pdf", "/data/b.pdf"}
+
+
+@pytest.mark.asyncio
+async def test_retry_subset_by_file_paths(task_service):
+    processor = Mock()
+    ft_a = _retryable_failed_file("/data/a.pdf")
+    ft_b = _retryable_failed_file("/data/b.pdf")
+    task = UploadTask(
+        task_id="task-1",
+        total_files=2,
+        file_tasks={"/data/a.pdf": ft_a, "/data/b.pdf": ft_b},
+        status=TaskStatus.FAILED,
+        failed_files=2,
+        processor=processor,
+    )
+    _store_task(task_service, "user1", task)
+
+    with (
+        patch("os.path.isfile", return_value=True),
+        patch.object(
+            task_service,
+            "background_custom_processor",
+            new_callable=AsyncMock,
+        ) as mock_bg,
+        patch("asyncio.create_task", return_value=Mock()),
+    ):
+        result = await task_service.retry_failed_files(
+            "user1",
+            "task-1",
+            file_paths=["/data/a.pdf"],
+        )
+
+    assert result is not None
+    assert result["retried"] == 1
+    assert ft_a.status == TaskStatus.PENDING
+    assert ft_b.status == TaskStatus.FAILED
+    mock_bg.assert_called_once()
+    assert mock_bg.call_args[0][2] == ["/data/a.pdf"]
+
+
+@pytest.mark.asyncio
+async def test_retry_unknown_path_is_skipped(task_service):
+    processor = Mock()
+    ft_a = _retryable_failed_file("/data/a.pdf")
+    task = UploadTask(
+        task_id="task-1",
+        total_files=1,
+        file_tasks={"/data/a.pdf": ft_a},
+        status=TaskStatus.FAILED,
+        failed_files=1,
+        processor=processor,
+    )
+    _store_task(task_service, "user1", task)
+
+    with patch("os.path.isfile", return_value=True):
+        result = await task_service.retry_failed_files(
+            "user1",
+            "task-1",
+            file_paths=["/data/missing.pdf"],
+        )
+
+    assert result is not None
+    assert result["retried"] == 0
+    assert result["status"] == "no_op"
+    assert result["skipped"] == [
+        {"file_path": "/data/missing.pdf", "reason": "file_not_in_task"}
+    ]
+    assert ft_a.status == TaskStatus.FAILED

From 42816a1f4b94c3656ca5efd1146110c9f6d02174 Mon Sep 17 00:00:00 2001
From: "autofix-ci[bot]" <114827586+autofix-ci[bot]@users.noreply.github.com>
Date: Thu, 28 May 2026 00:55:09 +0000
Subject: [PATCH 17/25] style: ruff autofix (auto)

---
 tests/unit/test_task_service_retry_failed_files.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/tests/unit/test_task_service_retry_failed_files.py b/tests/unit/test_task_service_retry_failed_files.py
index cf29433b5..dc50e818b 100644
--- a/tests/unit/test_task_service_retry_failed_files.py
+++ b/tests/unit/test_task_service_retry_failed_files.py
@@ -131,7 +131,5 @@ async def test_retry_unknown_path_is_skipped(task_service):
     assert result is not None
     assert result["retried"] == 0
     assert result["status"] == "no_op"
-    assert result["skipped"] == [
-        {"file_path": "/data/missing.pdf", "reason": "file_not_in_task"}
-    ]
+    assert result["skipped"] == [{"file_path": "/data/missing.pdf", "reason": "file_not_in_task"}]
     assert ft_a.status == TaskStatus.FAILED

From 8a9b7011374fb34b73cae47592f699cb5cef6de9 Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Wed, 27 May 2026 23:18:59 -0400
Subject: [PATCH 18/25] normalize task dialog styling with tokens and
 brand-aware surfaces: add task-dialog layout/color tokens in
 frontend/app/globals.css expose tokenized utilities in
 frontend/tailwind.config.ts apply OSS dialog background #171717 and OSS
 selected surfaces #232323 via tokens keep cloud contextual surfaces aligned
 and set cloud dialog typography to IBM Plex Sans improve task dialog UX
 details: update tabs/source row/chips/filter surfaces and spacing consistency
 make dropdown chevron reflect open/closed state align error details layout
 and keep failure flag + component tags inline harden mutation/query behavior:
 merge caller onSuccess with internal invalidation in useCancelTaskMutation
 and useRetryTaskMutation fix knowledge-page selection/delete flow: always
 sync grid selection state (remove early return) route bulk delete through
 useDeleteDocument().mutateAsync to honor mutation pending state keep query
 invalidation/refetch and deletion result handling explicit minor cleanup:
 remove unused category chip entry (partial) and simplify related dialog code
 paths

---
 .../api/mutations/useCancelTaskMutation.ts    |  10 +-
 .../app/api/mutations/useRetryTaskMutation.ts |   9 +-
 frontend/app/globals.css                      |  11 +
 frontend/app/knowledge/page.tsx               |  37 +--
 .../components/task-dialog/category-chips.tsx |  12 +-
 frontend/components/task-dialog/constants.ts  |  14 +-
 .../task-dialog/file-error-details.tsx        | 106 ++++-----
 frontend/components/task-dialog/file-list.tsx |  27 +--
 frontend/components/task-dialog/filters.tsx   | 210 +++++++++++-------
 frontend/components/task-dialog/header.tsx    |  10 +-
 .../components/task-dialog/task-dialog.tsx    |  48 +++-
 .../components/task-dialog/use-task-dialog.ts |   4 +-
 frontend/lib/task-utils.ts                    |  40 +---
 frontend/tailwind.config.ts                   |  16 ++
 src/api/tasks.py                              |   2 +-
 src/services/task_service.py                  | 114 +++++-----
 src/utils/telemetry/message_id.py             |   2 +
 17 files changed, 367 insertions(+), 305 deletions(-)

diff --git a/frontend/app/api/mutations/useCancelTaskMutation.ts b/frontend/app/api/mutations/useCancelTaskMutation.ts
index e96c0c19d..dd27b68f0 100644
--- a/frontend/app/api/mutations/useCancelTaskMutation.ts
+++ b/frontend/app/api/mutations/useCancelTaskMutation.ts
@@ -36,12 +36,16 @@ export const useCancelTaskMutation = (
     return response.json();
   }
 
+  const { onSuccess, onError, onSettled, ...restOptions } = options ?? {};
+
   return useMutation({
     mutationFn: cancelTask,
-    onSuccess: () => {
-      // Invalidate tasks query to refresh the list
+    ...restOptions,
+    onSuccess: (data, variables, context) => {
       queryClient.invalidateQueries({ queryKey: ["tasks"], exact: false });
+      onSuccess?.(data, variables, context);
     },
-    ...options,
+    onError,
+    onSettled,
   });
 };
diff --git a/frontend/app/api/mutations/useRetryTaskMutation.ts b/frontend/app/api/mutations/useRetryTaskMutation.ts
index 7843b3720..6e9305c48 100644
--- a/frontend/app/api/mutations/useRetryTaskMutation.ts
+++ b/frontend/app/api/mutations/useRetryTaskMutation.ts
@@ -66,14 +66,19 @@ export const useRetryTaskMutation = (
     return payload;
   }
 
+  const { onSuccess, onError, onSettled, ...restOptions } = options ?? {};
+
   return useMutation({
     mutationFn: retryTask,
-    onSuccess: (_data, variables) => {
+    ...restOptions,
+    onSuccess: (data, variables, context) => {
       queryClient.invalidateQueries({ queryKey: ["tasks"], exact: false });
       queryClient.invalidateQueries({
         queryKey: taskDetailQueryKey(variables.taskId),
       });
+      onSuccess?.(data, variables, context);
     },
-    ...options,
+    onError,
+    onSettled,
   });
 };
diff --git a/frontend/app/globals.css b/frontend/app/globals.css
index bdb8cd5d5..afdeda928 100644
--- a/frontend/app/globals.css
+++ b/frontend/app/globals.css
@@ -33,6 +33,15 @@
     /* App-level UI tokens (safe defaults, override per brand/theme) */
     --canvas: 0 0% 100%;
     --border-subtle-background-contextual: var(--border);
+    /* Task dialog layout (file row indent = px + checkbox + gaps + chevron) */
+    --task-dialog-width: 40rem;
+    --task-dialog-max-height: 90vh;
+    --task-dialog-file-type-width: 10rem;
+    --task-dialog-error-indent: 4.5rem;
+    --task-dialog-error-indent-cloud: 4.75rem;
+    --task-dialog-oss-bg: var(--background);
+    --task-dialog-oss-selected: var(--muted);
+    --z-task-dialog-menu: 100;
     --layered-select-bg: hsl(var(--muted) / 0.5);
     --chat-surface-gradient: rgba(69, 137, 255, 0.16);
     --chat-input-border: hsl(var(--input));
@@ -122,6 +131,8 @@
     /* App-level UI tokens (safe defaults, override per brand/theme) */
     --canvas: 0 0% 3.9%; /* #0A0A0A */
     --border-subtle-background-contextual: var(--border);
+    --task-dialog-oss-bg: 0 0% 9.02%; /* #171717 */
+    --task-dialog-oss-selected: 0 0% 13.73%; /* #232323 */
     --layered-select-bg: hsl(var(--muted) / 0.5);
     --chat-surface-gradient: rgba(69, 137, 255, 0.16);
     --chat-input-border: hsl(var(--input));
diff --git a/frontend/app/knowledge/page.tsx b/frontend/app/knowledge/page.tsx
index eed4f51d6..aef291d5e 100644
--- a/frontend/app/knowledge/page.tsx
+++ b/frontend/app/knowledge/page.tsx
@@ -56,10 +56,7 @@ import IBMCOSIcon from "../../components/icons/ibm-cos-icon";
 import OneDriveIcon from "../../components/icons/one-drive-logo";
 import SharePointIcon from "../../components/icons/share-point-logo";
 import { SyncConfirmDialog } from "../../components/sync-confirm-dialog";
-import {
-  deleteDocumentByFilename,
-  useDeleteDocument,
-} from "../api/mutations/useDeleteDocument";
+import { useDeleteDocument } from "../api/mutations/useDeleteDocument";
 import { useRefreshOpenragDocs } from "../api/mutations/useRefreshOpenragDocs";
 import {
   type SyncAllPreviewResponse,
@@ -366,25 +363,9 @@ function SearchPage() {
     return getKnowledgeFileIdentity(file);
   }, []);
 
-  const indexedFileIdentities = useMemo(
-    () =>
-      new Set(
-        effectiveData
-          .map((file) => getKnowledgeFileIdentity(file))
-          .filter(Boolean),
-      ),
-    [effectiveData],
-  );
-
-  const isDeletableKnowledgeRow = useCallback(
-    (file?: File) => {
-      if ((file?.status || "active") !== "active") {
-        return false;
-      }
-      return indexedFileIdentities.has(getKnowledgeFileIdentity(file));
-    },
-    [indexedFileIdentities],
-  );
+  const isDeletableKnowledgeRow = useCallback((file?: File) => {
+    return (file?.status || "active") === "active";
+  }, []);
 
   const resolveDeleteFilename = useCallback(
     (row: File) => {
@@ -503,9 +484,7 @@ function SearchPage() {
     if (!api) {
       return;
     }
-    if (!pruneNonDeletableGridSelection(api, isDeletableKnowledgeRow)) {
-      return;
-    }
+    pruneNonDeletableGridSelection(api, isDeletableKnowledgeRow);
     const nextSelected = api.getSelectedRows().filter(isDeletableKnowledgeRow);
     setSelectedRows((current) =>
       sameFileSelection(current, nextSelected) ? current : nextSelected,
@@ -799,7 +778,9 @@ function SearchPage() {
     try {
       const deleteResults = await Promise.allSettled(
         rowsToDelete.map((row) =>
-          deleteDocumentByFilename(resolveDeleteFilename(row)),
+          deleteDocumentMutation.mutateAsync({
+            filename: resolveDeleteFilename(row),
+          }),
         ),
       );
 
@@ -813,7 +794,7 @@ function SearchPage() {
         (
           result,
         ): result is PromiseFulfilledResult<
-          Awaited<ReturnType<typeof deleteDocumentByFilename>>
+          Awaited<ReturnType<typeof deleteDocumentMutation.mutateAsync>>
         > =>
           result.status === "fulfilled" &&
           (result.value.deleted_chunks || 0) > 0,
diff --git a/frontend/components/task-dialog/category-chips.tsx b/frontend/components/task-dialog/category-chips.tsx
index 3ed341cb8..d009c5f97 100644
--- a/frontend/components/task-dialog/category-chips.tsx
+++ b/frontend/components/task-dialog/category-chips.tsx
@@ -26,7 +26,7 @@ export function TaskDialogCategoryChips({
     <div
       className={cn(
         "flex flex-wrap items-center",
-        isCloudBrand ? "gap-2" : "gap-1.5",
+        isCloudBrand ? "gap-2 px-4" : "gap-1.5",
       )}
     >
       {CATEGORY_CHIPS.map((chip) => {
@@ -47,9 +47,13 @@ export function TaskDialogCategoryChips({
               "inline-flex min-h-10 items-center gap-2 border text-sm transition-colors",
               isCloudBrand ? "px-4" : "px-3",
               isCloudBrand ? "rounded-full" : "rounded-lg",
-              isActive
-                ? "border-badge bg-badge text-foreground"
-                : "border-border bg-muted hover:bg-badge hover:text-badge-foreground",
+              isCloudBrand
+                ? isActive
+                  ? "border-[var(--border-border-interactive)] bg-[#333333] text-foreground"
+                  : "border-border-subtle-contextual bg-[#333333] text-layer-contextual-foreground hover:bg-[#333333] hover:text-foreground"
+                : isActive
+                  ? "border-border bg-task-dialog-oss-selected text-foreground"
+                  : "border-border bg-muted hover:bg-badge hover:text-badge-foreground",
             )}
           >
             <Icon className={cn("size-4 shrink-0", chip.iconClassName)} />
diff --git a/frontend/components/task-dialog/constants.ts b/frontend/components/task-dialog/constants.ts
index 1c0351dbd..881f08f5d 100644
--- a/frontend/components/task-dialog/constants.ts
+++ b/frontend/components/task-dialog/constants.ts
@@ -1,10 +1,4 @@
-import {
-  AlertCircle,
-  CheckCircle,
-  Clock,
-  Focus,
-  type LucideIcon,
-} from "lucide-react";
+import { AlertCircle, CheckCircle, Clock, type LucideIcon } from "lucide-react";
 import type { TaskFileStatusCategory } from "@/lib/task-utils";
 
 export const CATEGORY_CHIPS: Array<{
@@ -31,10 +25,4 @@ export const CATEGORY_CHIPS: Array<{
     icon: Clock,
     iconClassName: "text-muted-foreground",
   },
-  {
-    id: "partial",
-    label: "Partial",
-    icon: Focus,
-    iconClassName: "text-muted-foreground",
-  },
 ];
diff --git a/frontend/components/task-dialog/file-error-details.tsx b/frontend/components/task-dialog/file-error-details.tsx
index 7a13b6dd0..1416d0be2 100644
--- a/frontend/components/task-dialog/file-error-details.tsx
+++ b/frontend/components/task-dialog/file-error-details.tsx
@@ -10,7 +10,6 @@ import { cn } from "@/lib/utils";
 
 interface TaskDialogFileErrorDetailsProps {
   isCloudBrand: boolean;
-  indentClassName?: string;
   fileInfo: TaskFileEntry;
   taskError?: string;
   analysis?: TaskFileIngestionFailureAnalysis;
@@ -18,7 +17,6 @@ interface TaskDialogFileErrorDetailsProps {
 
 export function TaskDialogFileErrorDetails({
   isCloudBrand,
-  indentClassName,
   fileInfo,
   taskError,
   analysis: analysisProp,
@@ -29,23 +27,36 @@ export function TaskDialogFileErrorDetails({
   return (
     <div
       className={cn(
-        "flex flex-col",
         isCloudBrand
-          ? "gap-3 pl-9 pr-4 pb-4"
-          : cn(
-              "gap-1 border-t border-muted/60 py-2 pr-3",
-              indentClassName ?? "pl-[4.75rem]",
-            ),
+          ? "pl-task-dialog-error-indent-cloud"
+          : "pl-task-dialog-error-indent",
+        "pr-4 pb-4",
+        isCloudBrand
+          ? "flex flex-col gap-3"
+          : "flex flex-col gap-1 border-t border-muted/60 py-2 pr-3",
       )}
     >
       <div className="flex flex-col">
         {analysis.pipelineSteps.map((step, index) => {
           const isFailed = step.status === "failed";
           const isLast = index === analysis.pipelineSteps.length - 1;
+          const showComponentTags =
+            isFailed && analysis.componentTags.length > 0;
+          const contentRowCount =
+            1 + (isFailed ? 2 + (showComponentTags ? 1 : 0) : 0);
 
           return (
-            <div key={step.id} className="flex gap-3">
-              <div className="flex flex-col items-center">
+            <div
+              key={step.id}
+              className={cn(
+                "grid grid-cols-[theme(spacing.4)_minmax(0,1fr)] items-start gap-x-3 gap-y-1",
+                isFailed && (isCloudBrand ? "gap-y-2" : "gap-y-1"),
+              )}
+            >
+              <div
+                className="flex flex-col items-center"
+                style={{ gridRow: `1 / span ${contentRowCount}` }}
+              >
                 {step.status === "completed" ? (
                   <Check
                     className="h-4 w-4 shrink-0 text-emerald-600 dark:text-emerald-400"
@@ -69,53 +80,44 @@ export function TaskDialogFileErrorDetails({
                 )}
               </div>
 
-              <div
+              <p
                 className={cn(
-                  "min-w-0 flex-1",
+                  "col-start-2 text-sm",
+                  isFailed
+                    ? "text-muted-foreground"
+                    : "text-muted-foreground/80",
                   !isLast && (isCloudBrand ? "pb-3" : "pb-1.5"),
                 )}
               >
-                <p
-                  className={cn(
-                    "text-sm",
-                    isFailed
-                      ? "text-muted-foreground"
-                      : "text-muted-foreground/80",
+                {step.label}
+              </p>
+
+              {isFailed && (
+                <>
+                  <p className="col-start-2 whitespace-pre-wrap break-words text-sm text-foreground/90">
+                    {analysis.resolvedError}
+                  </p>
+                  <p className="col-start-2 text-xs text-muted-foreground">
+                    {analysis.failureSummary}
+                  </p>
+                  {showComponentTags && (
+                    <div className="col-start-2 flex flex-wrap items-center gap-x-2 gap-y-1">
+                      <Flag
+                        className="size-3 shrink-0 text-destructive"
+                        aria-hidden
+                      />
+                      {analysis.componentTags.map((tag) => (
+                        <span
+                          key={tag}
+                          className="text-xs text-failure-component-cause"
+                        >
+                          {tag}
+                        </span>
+                      ))}
+                    </div>
                   )}
-                >
-                  {step.label}
-                </p>
-                {isFailed && (
-                  <div
-                    className={cn(
-                      isCloudBrand ? "mt-2 space-y-2" : "mt-1 space-y-1",
-                    )}
-                  >
-                    <p className="whitespace-pre-wrap break-words text-sm text-foreground/90">
-                      {analysis.resolvedError}
-                    </p>
-                    <p className="text-xs text-muted-foreground">
-                      {analysis.failureSummary}
-                    </p>
-                    {analysis.componentTags.length > 0 && (
-                      <div className="flex flex-wrap items-center gap-2 pt-1">
-                        <Flag
-                          className="size-3 shrink-0 text-destructive"
-                          aria-hidden
-                        />
-                        {analysis.componentTags.map((tag) => (
-                          <span
-                            key={tag}
-                            className="text-xs text-failure-component-cause"
-                          >
-                            {tag}
-                          </span>
-                        ))}
-                      </div>
-                    )}
-                  </div>
-                )}
-              </div>
+                </>
+              )}
             </div>
           );
         })}
diff --git a/frontend/components/task-dialog/file-list.tsx b/frontend/components/task-dialog/file-list.tsx
index 21275fde2..d709cebe5 100644
--- a/frontend/components/task-dialog/file-list.tsx
+++ b/frontend/components/task-dialog/file-list.tsx
@@ -15,9 +15,6 @@ import {
 import { cn } from "@/lib/utils";
 import { TaskDialogFileErrorDetails } from "./file-error-details";
 
-const OSS_ERROR_INDENT = "pl-9";
-const CHECKBOX_CLASS = "h-4 w-4 shrink-0 rounded border-border accent-primary";
-
 type TaskDialogFileListTab = "task-ingestions" | "retry-ingestions";
 
 interface TaskDialogFileListProps {
@@ -100,7 +97,9 @@ export function TaskDialogFileList({
 
   const containerClass = cn(
     "flex min-h-0 flex-1 flex-col overflow-hidden",
-    isCloudBrand ? "rounded-md border" : "border-b border-muted",
+    isCloudBrand
+      ? "rounded-md border-x border-b bg-layer-contextual"
+      : "border-b border-muted bg-task-dialog-oss",
   );
 
   const taskIngestionsTabCount =
@@ -124,7 +123,7 @@ export function TaskDialogFileList({
         : cn(
             "border-0",
             isActive
-              ? "rounded-none rounded-t-lg bg-muted text-foreground"
+              ? "rounded-none rounded-t-lg bg-task-dialog-oss-selected text-foreground"
               : "rounded-none bg-transparent text-muted-foreground hover:text-foreground",
           ),
     );
@@ -162,22 +161,21 @@ export function TaskDialogFileList({
           className={cn(
             "border-b last:border-b-0",
             isCloudBrand ? "border-border" : "border-muted",
-            isSelected && "bg-muted/30",
+            isSelected && (isCloudBrand ? "bg-muted" : "bg-muted/30"),
           )}
         >
           <div
             className={cn(
               rowGridClass,
-              isCloudBrand
-                ? "px-4 hover:bg-muted/40"
-                : "px-3 hover:bg-muted/30",
-              isSelected && "hover:bg-muted/40",
+              isCloudBrand ? "px-4 hover:bg-muted" : "px-3 hover:bg-muted/30",
+              isSelected &&
+                (isCloudBrand ? "hover:bg-muted" : "hover:bg-muted/40"),
             )}
           >
             {retryable ? (
               <input
                 type="checkbox"
-                className={CHECKBOX_CLASS}
+                className="h-4 w-4 shrink-0 rounded border-border accent-primary"
                 checked={isSelected}
                 disabled={isRowRetrying}
                 aria-label={`Select ${fileName}`}
@@ -243,7 +241,6 @@ export function TaskDialogFileList({
           {failed && isExpanded && analysis && (
             <TaskDialogFileErrorDetails
               isCloudBrand={isCloudBrand}
-              indentClassName={!isCloudBrand ? OSS_ERROR_INDENT : ""}
               fileInfo={fileInfo}
               taskError={task.error}
               analysis={analysis}
@@ -266,14 +263,14 @@ export function TaskDialogFileList({
   }) => (
     <div
       className={cn(
-        "flex min-h-10 shrink-0 items-center gap-3 bg-muted text-sm font-medium text-muted-foreground",
-        isCloudBrand ? "px-4" : "px-3",
+        "flex min-h-10 shrink-0 items-center gap-3 text-sm font-medium text-muted-foreground",
+        isCloudBrand ? "bg-muted px-4" : "bg-task-dialog-oss-selected px-3",
       )}
     >
       {showSelectAll ? (
         <input
           type="checkbox"
-          className={CHECKBOX_CLASS}
+          className="h-4 w-4 shrink-0 rounded border-border accent-primary"
           checked={allSelected}
           disabled={retryingTarget != null}
           aria-label="Select all retryable files"
diff --git a/frontend/components/task-dialog/filters.tsx b/frontend/components/task-dialog/filters.tsx
index 9ed34c512..a5d3b72b0 100644
--- a/frontend/components/task-dialog/filters.tsx
+++ b/frontend/components/task-dialog/filters.tsx
@@ -1,7 +1,7 @@
 "use client";
 
-import { ChevronDown, Search } from "lucide-react";
-import type { ReactNode } from "react";
+import { ChevronDown, ChevronUp, Search } from "lucide-react";
+import { useState } from "react";
 import { Button } from "@/components/ui/button";
 import {
   DropdownMenu,
@@ -25,27 +25,24 @@ interface TaskDialogFiltersProps {
   fileTypeDisabled: boolean;
 }
 
-function fileTypeItemClassName(selected: boolean) {
-  return cn(
-    "px-2",
-    selected &&
-      "bg-muted text-foreground focus:bg-muted data-[highlighted]:bg-muted",
-  );
-}
-
 function FileTypeMenu({
+  isCloudBrand,
   fileType,
   onFileTypeChange,
   fileTypes,
   allTypesLabel,
-  trigger,
+  fileTypeLabel,
+  disabled,
 }: {
+  isCloudBrand: boolean;
   fileType: string;
   onFileTypeChange: (value: string) => void;
   fileTypes: string[];
   allTypesLabel: string;
-  trigger: ReactNode;
+  fileTypeLabel: string;
+  disabled: boolean;
 }) {
+  const [open, setOpen] = useState(false);
   const options = [
     { value: ALL_TASK_FILE_TYPES, label: allTypesLabel },
     ...fileTypes.map((type) => ({
@@ -55,14 +52,66 @@ function FileTypeMenu({
   ];
 
   return (
-    <DropdownMenu>
-      <DropdownMenuTrigger asChild>{trigger}</DropdownMenuTrigger>
-      <DropdownMenuContent align="end" className="w-[160px]">
+    <DropdownMenu modal={false} open={open} onOpenChange={setOpen}>
+      <DropdownMenuTrigger asChild>
+        {isCloudBrand ? (
+          <button
+            type="button"
+            disabled={disabled}
+            className="inline-flex min-h-10 w-task-dialog-file-type shrink-0 items-center justify-between gap-2 bg-layer-contextual px-4 text-sm text-muted-foreground transition-colors hover:text-foreground disabled:pointer-events-none disabled:opacity-50"
+          >
+            <span className="truncate">{fileTypeLabel}</span>
+            {open ? (
+              <ChevronUp className="h-4 w-4 shrink-0 opacity-70" aria-hidden />
+            ) : (
+              <ChevronDown
+                className="h-4 w-4 shrink-0 opacity-70"
+                aria-hidden
+              />
+            )}
+          </button>
+        ) : (
+          <Button
+            type="button"
+            variant="outline"
+            disabled={disabled}
+            className="min-h-10 h-10 w-task-dialog-file-type shrink-0 justify-between font-normal"
+          >
+            <span className="truncate">{fileTypeLabel}</span>
+            {open ? (
+              <ChevronUp
+                className="ml-2 h-4 w-4 shrink-0 opacity-50"
+                aria-hidden
+              />
+            ) : (
+              <ChevronDown
+                className="ml-2 h-4 w-4 shrink-0 opacity-50"
+                aria-hidden
+              />
+            )}
+          </Button>
+        )}
+      </DropdownMenuTrigger>
+      <DropdownMenuContent
+        align="end"
+        className={cn(
+          "z-task-dialog-menu w-task-dialog-file-type",
+          isCloudBrand &&
+            "border-border-subtle-contextual bg-layer-contextual text-layer-contextual-foreground",
+        )}
+        onCloseAutoFocus={(event) => event.preventDefault()}
+      >
         {options.map(({ value, label }) => (
           <DropdownMenuItem
             key={value}
             onSelect={() => onFileTypeChange(value)}
-            className={fileTypeItemClassName(fileType === value)}
+            className={cn(
+              "px-2",
+              isCloudBrand &&
+                "bg-layer-contextual text-layer-contextual-foreground hover:bg-muted focus:bg-muted data-[highlighted]:bg-muted",
+              fileType === value &&
+                "bg-muted text-foreground focus:bg-muted data-[highlighted]:bg-muted",
+            )}
           >
             {label}
           </DropdownMenuItem>
@@ -72,6 +121,47 @@ function FileTypeMenu({
   );
 }
 
+function TaskDialogSearchField({
+  isCloudBrand,
+  search,
+  onSearchChange,
+  disabled,
+}: {
+  isCloudBrand: boolean;
+  search: string;
+  onSearchChange: (value: string) => void;
+  disabled: boolean;
+}) {
+  const input = (
+    <Input
+      type="search"
+      autoComplete="off"
+      placeholder="Search files..."
+      value={search}
+      onChange={(e) => onSearchChange(e.target.value)}
+      disabled={disabled}
+      icon={<Search className="h-4 w-4" aria-hidden />}
+      inputClassName={
+        isCloudBrand
+          ? "h-10 min-w-0 !rounded-none !border-0 bg-layer-contextual text-layer-contextual-foreground placeholder:text-muted-foreground focus:outline-none disabled:cursor-not-allowed disabled:opacity-50"
+          : "h-10 rounded-md !bg-canvas"
+      }
+    />
+  );
+
+  return (
+    <div
+      className={
+        isCloudBrand
+          ? "min-w-0 flex-1 border-r border-border-subtle-contextual bg-layer-contextual"
+          : "relative min-w-0 flex-1"
+      }
+    >
+      {input}
+    </div>
+  );
+}
+
 export function TaskDialogFilters({
   isCloudBrand,
   search,
@@ -83,74 +173,32 @@ export function TaskDialogFilters({
   searchDisabled,
   fileTypeDisabled,
 }: TaskDialogFiltersProps) {
-  const allTypesLabel = isCloudBrand ? "All categories" : "All file types";
-
-  if (isCloudBrand) {
-    return (
-      <div className="flex min-h-10 items-stretch border-b border-border [&_input]:min-h-10">
-        <div className="min-w-0 flex-1 border-r border-border-subtle-contextual bg-layer-contextual">
-          <Input
-            type="search"
-            autoComplete="off"
-            placeholder="Search files..."
-            value={search}
-            onChange={(e) => onSearchChange(e.target.value)}
-            disabled={searchDisabled}
-            icon={<Search className="h-4 w-4" aria-hidden />}
-            inputClassName="h-10 min-w-0 !rounded-none !border-0 bg-layer-contextual text-layer-contextual-foreground placeholder:text-muted-foreground focus:outline-none disabled:cursor-not-allowed disabled:opacity-50"
-          />
-        </div>
-        <FileTypeMenu
-          fileType={fileType}
-          onFileTypeChange={onFileTypeChange}
-          fileTypes={fileTypes}
-          allTypesLabel={allTypesLabel}
-          trigger={
-            <button
-              type="button"
-              disabled={fileTypeDisabled}
-              className="inline-flex min-h-10 w-[160px] shrink-0 items-center justify-between gap-2 px-4 text-sm text-muted-foreground transition-colors hover:text-foreground disabled:pointer-events-none disabled:opacity-50"
-            >
-              <span className="truncate">{fileTypeLabel}</span>
-              <ChevronDown className="h-4 w-4 shrink-0 opacity-70" />
-            </button>
-          }
-        />
-      </div>
-    );
-  }
+  const fileTypeMenuProps = {
+    isCloudBrand,
+    fileType,
+    onFileTypeChange,
+    fileTypes,
+    allTypesLabel: isCloudBrand ? "All categories" : "All file types",
+    fileTypeLabel,
+    disabled: fileTypeDisabled,
+  };
 
   return (
-    <div className="flex min-h-10 items-center gap-2">
-      <div className="relative min-w-0 flex-1">
-        <Input
-          type="search"
-          autoComplete="off"
-          placeholder="Search connectors..."
-          value={search}
-          onChange={(e) => onSearchChange(e.target.value)}
-          disabled={searchDisabled}
-          icon={<Search className="h-4 w-4" aria-hidden />}
-          inputClassName="h-10 rounded-md !bg-canvas"
-        />
-      </div>
-      <FileTypeMenu
-        fileType={fileType}
-        onFileTypeChange={onFileTypeChange}
-        fileTypes={fileTypes}
-        allTypesLabel={allTypesLabel}
-        trigger={
-          <Button
-            type="button"
-            variant="outline"
-            disabled={fileTypeDisabled}
-            className="min-h-10 h-10 w-[160px] shrink-0 justify-between font-normal"
-          >
-            <span className="truncate">{fileTypeLabel}</span>
-            <ChevronDown className="ml-2 h-4 w-4 shrink-0 opacity-50" />
-          </Button>
-        }
+    <div
+      className={cn(
+        "flex min-h-10",
+        isCloudBrand
+          ? "items-stretch border-y border-border bg-layer-contextual [&_input]:min-h-10"
+          : "items-center gap-2",
+      )}
+    >
+      <TaskDialogSearchField
+        isCloudBrand={isCloudBrand}
+        search={search}
+        onSearchChange={onSearchChange}
+        disabled={searchDisabled}
       />
+      <FileTypeMenu {...fileTypeMenuProps} />
     </div>
   );
 }
diff --git a/frontend/components/task-dialog/header.tsx b/frontend/components/task-dialog/header.tsx
index 2a42284b9..92bed7da0 100644
--- a/frontend/components/task-dialog/header.tsx
+++ b/frontend/components/task-dialog/header.tsx
@@ -49,13 +49,17 @@ export function TaskDialogHeader({
     <header
       className={cn(
         "shrink-0 flex-none",
-        isCloudBrand ? "border-b border-border" : "border-b-0",
+        isCloudBrand
+          ? "border-b border-border bg-layer-contextual"
+          : "border-b-0",
       )}
     >
       <DialogHeader
         className={cn(
           "space-y-0 border-b-0 text-left",
-          isCloudBrand ? "px-6 pt-4 pb-3" : "pt-3 pb-2 pr-12",
+          isCloudBrand
+            ? "bg-layer-contextual px-6 pt-4 pb-3"
+            : "pt-3 pb-2 pr-12",
         )}
       >
         <DialogTitle
@@ -71,7 +75,7 @@ export function TaskDialogHeader({
       <div
         className={cn(
           "flex flex-col gap-2 border-b-0",
-          isCloudBrand ? "gap-3 px-4 pb-4" : "px-4 pb-3",
+          isCloudBrand ? "bg-layer-contextual gap-3 px-0 pb-4" : "px-4 pb-3",
         )}
       >
         <TaskDialogFilters
diff --git a/frontend/components/task-dialog/task-dialog.tsx b/frontend/components/task-dialog/task-dialog.tsx
index 3fe715d9c..9163f8926 100644
--- a/frontend/components/task-dialog/task-dialog.tsx
+++ b/frontend/components/task-dialog/task-dialog.tsx
@@ -57,11 +57,19 @@ function TaskDialogContent({
   } = useTaskDialog(open, task_id);
 
   const filtersDisabled = !task;
-  const fileTypeDisabled = !task || fileTypes.length === 0;
+  // Always offer "All file types"; only disable while task data is loading.
+  const fileTypeDisabled = !task;
   const showRetryActions = retryableCount > 0;
 
   return (
-    <div className="flex min-h-0 flex-1 flex-col overflow-hidden">
+    <div
+      className={cn(
+        "flex min-h-0 flex-1 flex-col overflow-hidden",
+        isCloudBrand
+          ? "bg-layer-contextual font-ibm-plex-sans"
+          : "bg-task-dialog-oss",
+      )}
+    >
       <TaskDialogHeader
         isCloudBrand={isCloudBrand}
         taskId={task_id}
@@ -80,7 +88,7 @@ function TaskDialogContent({
       <div
         className={cn(
           "flex min-h-0 flex-1 flex-col overflow-hidden",
-          !isCloudBrand && "px-4",
+          isCloudBrand ? "bg-layer-contextual" : "bg-task-dialog-oss px-4",
         )}
       >
         {isLoading ? (
@@ -120,14 +128,21 @@ function TaskDialogContent({
 
       <DialogFooter
         className={cn(
-          "shrink-0 flex-row items-center gap-2 border-t sm:justify-end",
-          isCloudBrand ? "px-6 py-4" : "px-4 py-3",
+          "w-full shrink-0 flex-row items-stretch sm:justify-normal sm:space-x-0",
+          isCloudBrand
+            ? "gap-0 border-t bg-layer-contextual p-0"
+            : "gap-2 border-t bg-task-dialog-oss px-6 py-4",
         )}
       >
         <Button
           type="button"
           variant="ghost"
-          className={cn(showRetryActions && "flex-1")}
+          className={cn(
+            showRetryActions && "min-w-0 flex-1",
+            isCloudBrand &&
+              showRetryActions &&
+              "justify-start rounded-none px-4 text-left",
+          )}
           onClick={onClose}
           disabled={isRetrying}
         >
@@ -136,7 +151,10 @@ function TaskDialogContent({
         {showRetryActions && selectedCount > 0 ? (
           <Button
             type="button"
-            className="flex-1"
+            className={cn(
+              "min-w-0 flex-1",
+              isCloudBrand && "justify-start rounded-none px-4 text-left",
+            )}
             disabled={isRetrying || !task}
             onClick={() => void handleRetrySelected()}
           >
@@ -146,7 +164,10 @@ function TaskDialogContent({
         {showRetryActions && selectedCount === 0 ? (
           <Button
             type="button"
-            className="flex-1"
+            className={cn(
+              "min-w-0 flex-1",
+              isCloudBrand && "justify-start rounded-none px-4 text-left",
+            )}
             disabled={isRetrying || !task}
             onClick={() => void handleRetryAll()}
           >
@@ -164,9 +185,18 @@ export default function TaskDialog({
   task_id,
   onClose,
 }: TaskDialogProps) {
+  const isCloudBrand = useIsCloudBrand();
+
   return (
     <Dialog open={open} onOpenChange={onOpenChange}>
-      <DialogContent className="flex max-h-[90vh] w-[640px] max-w-[640px] flex-col gap-0 overflow-hidden p-0 sm:rounded-lg">
+      <DialogContent
+        className={cn(
+          "flex max-h-task-dialog w-task-dialog max-w-task-dialog flex-col gap-0 overflow-hidden p-0 sm:rounded-lg",
+          isCloudBrand
+            ? "bg-layer-contextual font-ibm-plex-sans"
+            : "bg-task-dialog-oss",
+        )}
+      >
         <TaskDialogContent
           key={task_id}
           open={open}
diff --git a/frontend/components/task-dialog/use-task-dialog.ts b/frontend/components/task-dialog/use-task-dialog.ts
index 5ef7dab52..3b04001e5 100644
--- a/frontend/components/task-dialog/use-task-dialog.ts
+++ b/frontend/components/task-dialog/use-task-dialog.ts
@@ -50,7 +50,7 @@ function showRetryResultToast(result: RetryTaskResponse) {
 }
 
 export function useTaskDialog(open: boolean, taskId: string) {
-  const { markTaskFilesProcessing } = useTask();
+  const { markTaskFilesProcessing, refreshTasks } = useTask();
 
   const [selectedPaths, setSelectedPaths] = useState<Set<string>>(
     () => new Set(),
@@ -236,6 +236,7 @@ export function useTaskDialog(open: boolean, taskId: string) {
           setSelectedPaths(new Set());
         }
       } catch (error) {
+        await refreshTasks();
         toast.error("Retry failed", {
           description:
             error instanceof Error ? error.message : "Could not retry files",
@@ -251,6 +252,7 @@ export function useTaskDialog(open: boolean, taskId: string) {
       retryMutation,
       refetchTask,
       markTaskFilesProcessing,
+      refreshTasks,
     ],
   );
 
diff --git a/frontend/lib/task-utils.ts b/frontend/lib/task-utils.ts
index 9de93438d..e41958507 100644
--- a/frontend/lib/task-utils.ts
+++ b/frontend/lib/task-utils.ts
@@ -7,11 +7,7 @@ import {
 export const ALL_TASK_FILE_TYPES = "__all__";
 export const ALL_TASK_STATUS_CATEGORIES = "__all__";
 
-export type TaskFileStatusCategory =
-  | "completed"
-  | "system_error"
-  | "indexing"
-  | "partial";
+export type TaskFileStatusCategory = "completed" | "system_error" | "indexing";
 
 export type TaskFileNameSort = "asc" | "desc";
 
@@ -22,11 +18,6 @@ export type TaskFileFilterOptions = {
   task?: Task;
 };
 
-interface TaskFileCategoryContext {
-  taskHasFailures: boolean;
-  successfulFileCount: number;
-}
-
 export function isTaskFileCompleted(fileInfo: TaskFileEntry): boolean {
   return fileInfo.status === "completed";
 }
@@ -128,21 +119,9 @@ export function countRetryIngestionFiles(task: Task): number {
   ).length;
 }
 
-function getTaskFileCategoryContext(task: Task): TaskFileCategoryContext {
-  return {
-    taskHasFailures: hasFailedFileEntries(task),
-    successfulFileCount: getSuccessfulFileCount(task),
-  };
-}
-
-/**
- * Maps a file to a dialog filter chip bucket.
- * Completed files in a mixed task (failures + successes) use `partial`, not `completed`.
- */
+/** Maps a file to a dialog filter chip bucket (aligned with per-file status labels). */
 export function getTaskFileStatusCategory(
   fileInfo: TaskFileEntry,
-  task: Task,
-  context: TaskFileCategoryContext = getTaskFileCategoryContext(task),
 ): TaskFileStatusCategory {
   if (isTaskFileFailed(fileInfo)) {
     return "system_error";
@@ -154,9 +133,6 @@ export function getTaskFileStatusCategory(
   }
 
   if (status === "completed") {
-    if (context.taskHasFailures && context.successfulFileCount > 0) {
-      return "partial";
-    }
     return "completed";
   }
 
@@ -170,12 +146,10 @@ export function countTaskFilesByCategory(
     completed: 0,
     system_error: 0,
     indexing: 0,
-    partial: 0,
   };
-  const context = getTaskFileCategoryContext(task);
 
   for (const [, fileInfo] of getTaskFileEntries(task)) {
-    const category = getTaskFileStatusCategory(fileInfo, task, context);
+    const category = getTaskFileStatusCategory(fileInfo);
     counts[category] += 1;
   }
 
@@ -203,9 +177,6 @@ export function filterTaskFileEntries(
   const query = options.search?.trim().toLowerCase() ?? "";
   const fileType = options.fileType ?? ALL_TASK_FILE_TYPES;
   const statusCategory = options.statusCategory ?? ALL_TASK_STATUS_CATEGORIES;
-  const categoryContext = options.task
-    ? getTaskFileCategoryContext(options.task)
-    : undefined;
 
   return entries.filter(([filePath, fileInfo]) => {
     if (fileType !== ALL_TASK_FILE_TYPES) {
@@ -216,11 +187,8 @@ export function filterTaskFileEntries(
     }
 
     if (
-      options.task &&
       statusCategory !== ALL_TASK_STATUS_CATEGORIES &&
-      categoryContext &&
-      getTaskFileStatusCategory(fileInfo, options.task, categoryContext) !==
-        statusCategory
+      getTaskFileStatusCategory(fileInfo) !== statusCategory
     ) {
       return false;
     }
diff --git a/frontend/tailwind.config.ts b/frontend/tailwind.config.ts
index 1c9a9f786..8ac93ccf4 100644
--- a/frontend/tailwind.config.ts
+++ b/frontend/tailwind.config.ts
@@ -24,6 +24,17 @@ const config = {
     extend: {
       maxWidth: {
         content: "960px",
+        "task-dialog": "var(--task-dialog-width)",
+      },
+      maxHeight: {
+        "task-dialog": "var(--task-dialog-max-height)",
+      },
+      width: {
+        "task-dialog": "var(--task-dialog-width)",
+        "task-dialog-file-type": "var(--task-dialog-file-type-width)",
+      },
+      zIndex: {
+        "task-dialog-menu": "var(--z-task-dialog-menu)",
       },
       screens: {
         xl: "1200px",
@@ -159,6 +170,8 @@ const config = {
         },
         canvas: "hsl(var(--canvas))",
         "layer-contextual": "hsl(var(--layer-contextual))",
+        "task-dialog-oss": "hsl(var(--task-dialog-oss-bg))",
+        "task-dialog-oss-selected": "hsl(var(--task-dialog-oss-selected))",
         "layer-contextual-foreground":
           "hsl(var(--layer-contextual-foreground))",
         "border-subtle-contextual":
@@ -218,6 +231,9 @@ const config = {
       },
       spacing: {
         mmd: "13px",
+        "task-dialog-error-indent": "var(--task-dialog-error-indent)",
+        "task-dialog-error-indent-cloud":
+          "var(--task-dialog-error-indent-cloud)",
       },
       borderRadius: {
         lg: "var(--radius)",
diff --git a/src/api/tasks.py b/src/api/tasks.py
index ed27b24a0..eb5b3cc32 100644
--- a/src/api/tasks.py
+++ b/src/api/tasks.py
@@ -79,7 +79,7 @@ async def retry_task(
     if result.get("status") == "no_op":
         return JSONResponse(result, status_code=400)
 
-    await TelemetryClient.send_event(Category.TASK_OPERATIONS, MessageId.ORB_TASK_CREATED)
+    await TelemetryClient.send_event(Category.TASK_OPERATIONS, MessageId.ORB_TASK_RETRIED)
     return JSONResponse(result, status_code=202)
 
 
diff --git a/src/services/task_service.py b/src/services/task_service.py
index 9322cf13e..3e28f9126 100644
--- a/src/services/task_service.py
+++ b/src/services/task_service.py
@@ -668,74 +668,74 @@ async def retry_failed_files(
 
         store_user_id, upload_task = resolved
 
-        if upload_task.status == TaskStatus.RUNNING:
-            return {
-                "error": "task_in_progress",
-                "message": "Task is still running",
-                "task_id": task_id,
-            }
-
-        processor = upload_task.processor
-        if processor is None:
-            return {
-                "error": "no_processor",
-                "message": "Cannot retry: task processor is no longer available",
-                "task_id": task_id,
-            }
-
         paths_to_retry: list[str] = []
         skipped: list[dict] = []
         requested_paths = set(file_paths) if file_paths is not None else None
 
-        if requested_paths is not None:
-            for path in requested_paths:
-                file_task = upload_task.file_tasks.get(path)
-                if file_task is None:
-                    skipped.append({"file_path": path, "reason": "file_not_in_task"})
-                elif file_task.status != TaskStatus.FAILED:
-                    skipped.append(
-                        {
-                            "file_path": path,
-                            "filename": file_task.filename,
-                            "reason": "not_failed",
-                        }
-                    )
+        # Keep status checks, candidate selection, and state transitions inside
+        # one lock to avoid concurrent retry requests enqueueing duplicates.
+        async with self._get_task_lock(task_id):
+            processor = upload_task.processor
+            if upload_task.status == TaskStatus.RUNNING:
+                return {
+                    "error": "task_in_progress",
+                    "message": "Task is still running",
+                    "task_id": task_id,
+                }
+
+            if processor is None:
+                return {
+                    "error": "no_processor",
+                    "message": "Cannot retry: task processor is no longer available",
+                    "task_id": task_id,
+                }
 
-        # Build retry candidates before mutating shared task/file state.
-        retry_candidates: list[tuple[str, FileTask]] = []
-        for file_path, file_task in list(upload_task.file_tasks.items()):
-            if requested_paths is not None and file_path not in requested_paths:
-                continue
-            if file_task.status != TaskStatus.FAILED:
-                continue
+            if requested_paths is not None:
+                for path in requested_paths:
+                    file_task = upload_task.file_tasks.get(path)
+                    if file_task is None:
+                        skipped.append({"file_path": path, "reason": "file_not_in_task"})
+                    elif file_task.status != TaskStatus.FAILED:
+                        skipped.append(
+                            {
+                                "file_path": path,
+                                "filename": file_task.filename,
+                                "reason": "not_failed",
+                            }
+                        )
 
-            if retryable_only:
-                metadata = self._infer_failure_metadata(file_task)
-                if not metadata or metadata.get("actionable_by") != "RETRYABLE":
+            # Build retry candidates before mutating shared task/file state.
+            retry_candidates: list[tuple[str, FileTask]] = []
+            for file_path, file_task in list(upload_task.file_tasks.items()):
+                if requested_paths is not None and file_path not in requested_paths:
+                    continue
+                if file_task.status != TaskStatus.FAILED:
+                    continue
+
+                if retryable_only:
+                    metadata = self._infer_failure_metadata(file_task)
+                    if not metadata or metadata.get("actionable_by") != "RETRYABLE":
+                        skipped.append(
+                            {
+                                "file_path": file_path,
+                                "filename": file_task.filename,
+                                "reason": "not_retryable",
+                            }
+                        )
+                        continue
+
+                if not os.path.isfile(file_path):
                     skipped.append(
                         {
                             "file_path": file_path,
                             "filename": file_task.filename,
-                            "reason": "not_retryable",
+                            "reason": "source_file_missing",
                         }
                     )
                     continue
 
-            if not os.path.isfile(file_path):
-                skipped.append(
-                    {
-                        "file_path": file_path,
-                        "filename": file_task.filename,
-                        "reason": "source_file_missing",
-                    }
-                )
-                continue
-
-            retry_candidates.append((file_path, file_task))
+                retry_candidates.append((file_path, file_task))
 
-        # All shared task/file state transitions are protected by the task lock
-        # so retry requests and background processors cannot interleave updates.
-        async with self._get_task_lock(task_id):
             now = time.time()
             for file_path, file_task in retry_candidates:
                 if upload_task.failed_files > 0:
@@ -753,6 +753,10 @@ async def retry_failed_files(
                 file_task.updated_at = now
                 paths_to_retry.append(file_path)
 
+            if paths_to_retry:
+                upload_task.status = TaskStatus.RUNNING
+                upload_task.updated_at = now
+
         if not paths_to_retry:
             return {
                 "task_id": task_id,
@@ -762,10 +766,6 @@ async def retry_failed_files(
                 "message": "No retryable files with available source data",
             }
 
-        async with self._get_task_lock(task_id):
-            upload_task.status = TaskStatus.RUNNING
-            upload_task.updated_at = time.time()
-
         background_task = asyncio.create_task(
             self.background_custom_processor(store_user_id, task_id, paths_to_retry, processor)
         )
diff --git a/src/utils/telemetry/message_id.py b/src/utils/telemetry/message_id.py
index 7b0f17d45..ff1986852 100644
--- a/src/utils/telemetry/message_id.py
+++ b/src/utils/telemetry/message_id.py
@@ -149,6 +149,8 @@ class MessageId:
     ORB_TASK_COMPLETE = "ORB_TASK_COMPLETE"
     # Message: Task failed
     ORB_TASK_FAILED = "ORB_TASK_FAILED"
+    # Message: Task retry requested
+    ORB_TASK_RETRIED = "ORB_TASK_RETRIED"
     # Message: Task cancelled
     ORB_TASK_CANCELLED = "ORB_TASK_CANCELLED"
     # Message: Task cancellation failed

From b85bf448decb4ca24258c6cb7239c1b4d2d56cfe Mon Sep 17 00:00:00 2001
From: "autofix-ci[bot]" <114827586+autofix-ci[bot]@users.noreply.github.com>
Date: Thu, 28 May 2026 03:20:42 +0000
Subject: [PATCH 19/25] style: ruff autofix (auto)

---
 src/utils/telemetry/message_id.py | 56 +++++++++++++++----------------
 1 file changed, 28 insertions(+), 28 deletions(-)

diff --git a/src/utils/telemetry/message_id.py b/src/utils/telemetry/message_id.py
index ff1986852..07121ad9a 100644
--- a/src/utils/telemetry/message_id.py
+++ b/src/utils/telemetry/message_id.py
@@ -7,18 +7,18 @@
 
 class MessageId:
     """Telemetry message IDs."""
-    
+
     # Category: APPLICATION_STARTUP ------------------------------------------->
-    
+
     # Message: Application started successfully
     ORB_APP_STARTED = "ORB_APP_STARTED"
     # Message: Application startup initiated
     ORB_APP_START_INIT = "ORB_APP_START_INIT"
     # Message: Application shutdown initiated
     ORB_APP_SHUTDOWN = "ORB_APP_SHUTDOWN"
-    
+
     # Category: SERVICE_INITIALIZATION ----------------------------------------->
-    
+
     # Message: Services initialized successfully
     ORB_SVC_INIT_SUCCESS = "ORB_SVC_INIT_SUCCESS"
     # Message: Service initialization started
@@ -29,9 +29,9 @@ class MessageId:
     ORB_SVC_OS_CLIENT_FAIL = "ORB_SVC_OS_CLIENT_FAIL"
     # Message: Failed to generate JWT keys
     ORB_SVC_JWT_KEY_FAIL = "ORB_SVC_JWT_KEY_FAIL"
-    
+
     # Category: OPENSEARCH_SETUP ---------------------------------------------->
-    
+
     # Message: OpenSearch connection established
     ORB_OS_CONN_ESTABLISHED = "ORB_OS_CONN_ESTABLISHED"
     # Message: OpenSearch connection failed
@@ -40,9 +40,9 @@ class MessageId:
     ORB_OS_WAITING = "ORB_OS_WAITING"
     # Message: OpenSearch ready check timeout
     ORB_OS_TIMEOUT = "ORB_OS_TIMEOUT"
-    
+
     # Category: OPENSEARCH_INDEX ---------------------------------------------->
-    
+
     # Message: OpenSearch index created successfully
     ORB_OS_INDEX_CREATED = "ORB_OS_INDEX_CREATED"
     # Message: OpenSearch index already exists
@@ -55,9 +55,9 @@ class MessageId:
     ORB_OS_KF_INDEX_CREATED = "ORB_OS_KF_INDEX_CREATED"
     # Message: Failed to create knowledge filters index
     ORB_OS_KF_INDEX_FAIL = "ORB_OS_KF_INDEX_FAIL"
-    
+
     # Category: DOCUMENT_INGESTION -------------------------------------------->
-    
+
     # Message: Document ingestion started
     ORB_DOC_INGEST_START = "ORB_DOC_INGEST_START"
     # Message: Document ingestion completed successfully
@@ -84,9 +84,9 @@ class MessageId:
     ORB_DOC_REFRESH_COMPLETE = "ORB_DOC_REFRESH_COMPLETE"
     # Message: Default docs refresh failed
     ORB_DOC_REFRESH_FAILED = "ORB_DOC_REFRESH_FAILED"
-    
+
     # Category: DOCUMENT_PROCESSING -------------------------------------------->
-    
+
     # Message: Document processing started
     ORB_DOC_PROCESS_START = "ORB_DOC_PROCESS_START"
     # Message: Document processing completed
@@ -95,9 +95,9 @@ class MessageId:
     ORB_DOC_PROCESS_FAILED = "ORB_DOC_PROCESS_FAILED"
     # Message: Process pool recreation attempted
     ORB_DOC_POOL_RECREATE = "ORB_DOC_POOL_RECREATE"
-    
+
     # Category: AUTHENTICATION ------------------------------------------------>
-    
+
     # Message: Authentication successful
     ORB_AUTH_SUCCESS = "ORB_AUTH_SUCCESS"
     # Message: Authentication failed
@@ -108,9 +108,9 @@ class MessageId:
     ORB_AUTH_OAUTH_CALLBACK = "ORB_AUTH_OAUTH_CALLBACK"
     # Message: OAuth callback failed
     ORB_AUTH_OAUTH_FAILED = "ORB_AUTH_OAUTH_FAILED"
-    
+
     # Category: CONNECTOR_OPERATIONS ------------------------------------------->
-    
+
     # Message: Connector connection established
     ORB_CONN_CONNECTED = "ORB_CONN_CONNECTED"
     # Message: Connector connection failed
@@ -127,9 +127,9 @@ class MessageId:
     ORB_CONN_WEBHOOK_FAILED = "ORB_CONN_WEBHOOK_FAILED"
     # Message: Failed to load persisted connections
     ORB_CONN_LOAD_FAILED = "ORB_CONN_LOAD_FAILED"
-    
+
     # Category: FLOW_OPERATIONS ------------------------------------------------>
-    
+
     # Message: Flow backup completed
     ORB_FLOW_BACKUP_COMPLETE = "ORB_FLOW_BACKUP_COMPLETE"
     # Message: Flow backup failed
@@ -140,9 +140,9 @@ class MessageId:
     ORB_FLOW_RESET_CHECK_FAIL = "ORB_FLOW_RESET_CHECK_FAIL"
     # Message: Settings reapplied after flow reset
     ORB_FLOW_SETTINGS_REAPPLIED = "ORB_FLOW_SETTINGS_REAPPLIED"
-    
+
     # Category: TASK_OPERATIONS ------------------------------------------------>
-    
+
     # Message: Task created successfully
     ORB_TASK_CREATED = "ORB_TASK_CREATED"
     # Message: Task completed successfully
@@ -155,25 +155,25 @@ class MessageId:
     ORB_TASK_CANCELLED = "ORB_TASK_CANCELLED"
     # Message: Task cancellation failed
     ORB_TASK_CANCEL_FAILED = "ORB_TASK_CANCEL_FAILED"
-    
+
     # Category: CHAT_OPERATIONS ------------------------------------------------>
-    
+
     # Message: Chat request received
     ORB_CHAT_REQUEST_RECV = "ORB_CHAT_REQUEST_RECV"
     # Message: Chat request completed
     ORB_CHAT_REQUEST_COMPLETE = "ORB_CHAT_REQUEST_COMPLETE"
     # Message: Chat request failed
     ORB_CHAT_REQUEST_FAILED = "ORB_CHAT_REQUEST_FAILED"
-    
+
     # Category: ERROR_CONDITIONS ----------------------------------------------->
-    
+
     # Message: Critical error occurred
     ORB_ERROR_CRITICAL = "ORB_ERROR_CRITICAL"
     # Message: Warning condition
     ORB_ERROR_WARNING = "ORB_ERROR_WARNING"
-    
+
     # Category: SETTINGS_OPERATIONS -------------------------------------------->
-    
+
     # Message: Settings updated successfully
     ORB_SETTINGS_UPDATED = "ORB_SETTINGS_UPDATED"
     # Message: Settings update failed
@@ -196,9 +196,9 @@ class MessageId:
     ORB_SETTINGS_INDEX_NAME_UPDATED = "ORB_SETTINGS_INDEX_NAME_UPDATED"
     # Message: Provider credentials updated
     ORB_SETTINGS_PROVIDER_CREDS = "ORB_SETTINGS_PROVIDER_CREDS"
-    
+
     # Category: ONBOARDING ----------------------------------------------------->
-    
+
     # Message: Onboarding started
     ORB_ONBOARD_START = "ORB_ONBOARD_START"
     # Message: Onboarding completed successfully

From 7a3dbb16079e9bb8156cbb7414ea3b2beee2542b Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Thu, 28 May 2026 00:03:26 -0400
Subject: [PATCH 20/25] adjust backend retry to work for connectors too

---
 .../api/mutations/useCancelTaskMutation.ts    |  3 +-
 .../app/api/mutations/useRetryTaskMutation.ts | 12 ++--
 src/services/task_service.py                  | 30 ++++++--
 .../test_task_service_retry_failed_files.py   | 72 +++++++++++++++++++
 4 files changed, 106 insertions(+), 11 deletions(-)

diff --git a/frontend/app/api/mutations/useCancelTaskMutation.ts b/frontend/app/api/mutations/useCancelTaskMutation.ts
index dd27b68f0..de5d82d85 100644
--- a/frontend/app/api/mutations/useCancelTaskMutation.ts
+++ b/frontend/app/api/mutations/useCancelTaskMutation.ts
@@ -3,6 +3,7 @@ import {
   useMutation,
   useQueryClient,
 } from "@tanstack/react-query";
+import { TASKS_QUERY_KEY } from "@/app/api/queries/useGetTasksQuery";
 
 export interface CancelTaskRequest {
   taskId: string;
@@ -42,7 +43,7 @@ export const useCancelTaskMutation = (
     mutationFn: cancelTask,
     ...restOptions,
     onSuccess: (data, variables, context) => {
-      queryClient.invalidateQueries({ queryKey: ["tasks"], exact: false });
+      queryClient.invalidateQueries({ queryKey: [...TASKS_QUERY_KEY] });
       onSuccess?.(data, variables, context);
     },
     onError,
diff --git a/frontend/app/api/mutations/useRetryTaskMutation.ts b/frontend/app/api/mutations/useRetryTaskMutation.ts
index 6e9305c48..04f3b831f 100644
--- a/frontend/app/api/mutations/useRetryTaskMutation.ts
+++ b/frontend/app/api/mutations/useRetryTaskMutation.ts
@@ -4,6 +4,7 @@ import {
   useQueryClient,
 } from "@tanstack/react-query";
 import { taskDetailQueryKey } from "@/app/api/queries/useGetTaskQuery";
+import { TASKS_QUERY_KEY } from "@/app/api/queries/useGetTasksQuery";
 
 export interface RetryTaskRequest {
   taskId: string;
@@ -42,14 +43,13 @@ export const useRetryTaskMutation = (
   async function retryTask(
     variables: RetryTaskRequest,
   ): Promise<RetryTaskResponse> {
-    const body =
-      variables.filePaths != null
-        ? JSON.stringify({ file_paths: variables.filePaths })
-        : undefined;
+    const body = JSON.stringify(
+      variables.filePaths != null ? { file_paths: variables.filePaths } : {},
+    );
 
     const response = await fetch(`/api/tasks/${variables.taskId}/retry`, {
       method: "POST",
-      headers: body ? { "Content-Type": "application/json" } : undefined,
+      headers: { "Content-Type": "application/json" },
       body,
     });
 
@@ -72,7 +72,7 @@ export const useRetryTaskMutation = (
     mutationFn: retryTask,
     ...restOptions,
     onSuccess: (data, variables, context) => {
-      queryClient.invalidateQueries({ queryKey: ["tasks"], exact: false });
+      queryClient.invalidateQueries({ queryKey: [...TASKS_QUERY_KEY] });
       queryClient.invalidateQueries({
         queryKey: taskDetailQueryKey(variables.taskId),
       });
diff --git a/src/services/task_service.py b/src/services/task_service.py
index 3e28f9126..25f301e21 100644
--- a/src/services/task_service.py
+++ b/src/services/task_service.py
@@ -47,6 +47,18 @@
     "polling timed out",
 )
 
+# Connector/download/network failures seen while file is still in Docling phase.
+# These are infrastructure/transient and should be retryable.
+_TRANSIENT_CONNECTIVITY_ERROR_MARKERS = (
+    "all connection attempts failed",
+    "connection refused",
+    "connection reset",
+    "temporary failure in name resolution",
+    "name or service not known",
+    "service unavailable",
+    "network is unreachable",
+)
+
 
 def _is_non_retryable_file_error(error: str) -> bool:
     lowered = error.lower()
@@ -55,9 +67,13 @@ def _is_non_retryable_file_error(error: str) -> bool:
 
 def _is_docling_transient_error(error: str) -> bool:
     lowered = error.lower()
-    if "docling conversion did not complete" not in lowered:
-        return False
-    return any(marker in lowered for marker in _DOCLING_TRANSIENT_ERROR_MARKERS)
+    # Legacy timeout messages emitted by Docling polling path.
+    if "docling conversion did not complete" in lowered:
+        return any(marker in lowered for marker in _DOCLING_TRANSIENT_ERROR_MARKERS)
+
+    # Connector-originated transient network failures can still surface while
+    # file phase is DOCLING (before conversion can complete).
+    return any(marker in lowered for marker in _TRANSIENT_CONNECTIVITY_ERROR_MARKERS)
 
 
 class IngestionTimeoutError(Exception):
@@ -661,6 +677,10 @@ async def retry_failed_files(
         considered; paths missing from the task or not in a failed state are
         reported in *skipped*. This reuses the task's original processor — it
         does not accept new uploads from the client.
+
+        Connector tasks often use provider IDs (not local absolute paths) as
+        ``file_path`` keys. For those non-absolute identifiers, skip local
+        filesystem existence checks and let the connector processor re-fetch.
         """
         resolved = self._resolve_upload_task_store(user_id, task_id)
         if resolved is None:
@@ -724,7 +744,9 @@ async def retry_failed_files(
                         )
                         continue
 
-                if not os.path.isfile(file_path):
+                # Only enforce local source-file existence for absolute paths.
+                # Connector-backed tasks typically store remote IDs as file_path.
+                if os.path.isabs(file_path) and not os.path.isfile(file_path):
                     skipped.append(
                         {
                             "file_path": file_path,
diff --git a/tests/unit/test_task_service_retry_failed_files.py b/tests/unit/test_task_service_retry_failed_files.py
index dc50e818b..4990d5267 100644
--- a/tests/unit/test_task_service_retry_failed_files.py
+++ b/tests/unit/test_task_service_retry_failed_files.py
@@ -133,3 +133,75 @@ async def test_retry_unknown_path_is_skipped(task_service):
     assert result["status"] == "no_op"
     assert result["skipped"] == [{"file_path": "/data/missing.pdf", "reason": "file_not_in_task"}]
     assert ft_a.status == TaskStatus.FAILED
+
+
+@pytest.mark.asyncio
+async def test_retry_connector_connectivity_error_is_retryable(task_service):
+    processor = Mock()
+    ft = FileTask(file_path="/data/connector.pdf", filename="connector.pdf")
+    ft.status = TaskStatus.FAILED
+    ft.phase = IngestionPhase.DOCLING
+    ft.docling_status = DoclingPhaseStatus.PENDING
+    ft.error = "All connection attempts failed"
+    task = UploadTask(
+        task_id="task-connector",
+        total_files=1,
+        file_tasks={"/data/connector.pdf": ft},
+        status=TaskStatus.FAILED,
+        failed_files=1,
+        processor=processor,
+    )
+    _store_task(task_service, "user1", task)
+
+    with (
+        patch("os.path.isfile", return_value=True),
+        patch.object(
+            task_service,
+            "background_custom_processor",
+            new_callable=AsyncMock,
+        ) as mock_bg,
+        patch("asyncio.create_task", return_value=Mock()),
+    ):
+        result = await task_service.retry_failed_files("user1", "task-connector")
+
+    assert result is not None
+    assert result["retried"] == 1
+    assert result["status"] == "accepted"
+    assert ft.status == TaskStatus.PENDING
+    mock_bg.assert_called_once()
+
+
+@pytest.mark.asyncio
+async def test_retry_connector_id_path_does_not_require_local_file(task_service):
+    processor = Mock()
+    ft = FileTask(file_path="remote-file-id-123", filename="connector.pdf")
+    ft.status = TaskStatus.FAILED
+    ft.phase = IngestionPhase.DOCLING
+    ft.docling_status = DoclingPhaseStatus.PENDING
+    ft.error = "All connection attempts failed"
+    task = UploadTask(
+        task_id="task-connector-id",
+        total_files=1,
+        file_tasks={"remote-file-id-123": ft},
+        status=TaskStatus.FAILED,
+        failed_files=1,
+        processor=processor,
+    )
+    _store_task(task_service, "user1", task)
+
+    with (
+        patch("os.path.isfile", return_value=False),
+        patch.object(
+            task_service,
+            "background_custom_processor",
+            new_callable=AsyncMock,
+        ) as mock_bg,
+        patch("asyncio.create_task", return_value=Mock()),
+    ):
+        result = await task_service.retry_failed_files("user1", "task-connector-id")
+
+    assert result is not None
+    assert result["retried"] == 1
+    assert result["status"] == "accepted"
+    assert ft.status == TaskStatus.PENDING
+    mock_bg.assert_called_once()

From cb4722a4c9eef8266e65643c4259591b23be643c Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Thu, 28 May 2026 00:36:07 -0400
Subject: [PATCH 21/25]  Treat disconnect / remote protocol errors as RETRYABLE
 Langflow failures with a clearer message

---
 src/config/settings.py                        | 96 +++++++++++++------
 src/models/processors.py                      |  3 +
 src/services/task_service.py                  | 69 +++++++++++--
 .../test_task_service_retry_failed_files.py   | 40 ++++++++
 4 files changed, 175 insertions(+), 33 deletions(-)

diff --git a/src/config/settings.py b/src/config/settings.py
index e4471a640..360b418b0 100644
--- a/src/config/settings.py
+++ b/src/config/settings.py
@@ -206,6 +206,8 @@ def _resolve_skip_os_security_default() -> str:
 # Default: 40 minutes total, 40 minutes read timeout
 LANGFLOW_TIMEOUT = get_env_float("LANGFLOW_TIMEOUT", 2400.0)  # 40 minutes
 LANGFLOW_CONNECT_TIMEOUT = get_env_float("LANGFLOW_CONNECT_TIMEOUT", 30.0)  # 30 seconds
+# Retries for transient Langflow HTTP failures (disconnects, 502/503/504).
+LANGFLOW_REQUEST_RETRIES = get_env_int("LANGFLOW_REQUEST_RETRIES", 2)
 
 # Per-file processing timeout for document ingestion tasks (in seconds)
 # Should be >= LANGFLOW_TIMEOUT to allow long-running ingestion to complete
@@ -807,42 +809,82 @@ async def close(self):
     async def langflow_request(self, method: str, endpoint: str, **kwargs):
         """Central method for all Langflow API requests.
 
-        Retries once with a fresh API key on auth failures (401/403).
+        Retries transient transport/server errors and once with a fresh API key on
+        auth failures (401/403).
         """
-        api_key = await get_langflow_api_key()
-        if not api_key:
-            raise ValueError("No Langflow API key available")
+        _TRANSIENT_STATUS_CODES = {408, 429, 500, 502, 503, 504}
+        max_attempts = max(1, LANGFLOW_REQUEST_RETRIES + 1)
+        last_error: Exception | None = None
+        request_kwargs = dict(kwargs)
+        passed_headers = request_kwargs.pop("headers", {}) or {}
 
-        # Merge headers properly - passed headers take precedence over defaults
-        default_headers = {"x-api-key": api_key, "Content-Type": "application/json"}
-        existing_headers = kwargs.pop("headers", {})
-        headers = {**default_headers, **existing_headers}
+        for attempt in range(max_attempts):
+            api_key = await get_langflow_api_key()
+            if not api_key:
+                raise ValueError("No Langflow API key available")
 
-        # Remove Content-Type if explicitly set to None (for file uploads)
-        if headers.get("Content-Type") is None:
-            headers.pop("Content-Type", None)
+            # Merge headers properly - passed headers take precedence over defaults
+            default_headers = {"x-api-key": api_key, "Content-Type": "application/json"}
+            headers = {**default_headers, **passed_headers}
 
-        url = f"{LANGFLOW_URL}{endpoint}"
+            # Remove Content-Type if explicitly set to None (for file uploads)
+            if headers.get("Content-Type") is None:
+                headers.pop("Content-Type", None)
 
-        response = await self.langflow_http_client.request(
-            method=method, url=url, headers=headers, **kwargs
-        )
+            url = f"{LANGFLOW_URL}{endpoint}"
 
-        # Retry once with a fresh API key on auth failure
-        if response.status_code in (401, 403):
-            logger.warning(
-                "Langflow request auth failed, regenerating API key and retrying",
-                status_code=response.status_code,
-                endpoint=endpoint,
-            )
-            api_key = await get_langflow_api_key(force_regenerate=True)
-            if api_key:
-                headers["x-api-key"] = api_key
+            try:
                 response = await self.langflow_http_client.request(
-                    method=method, url=url, headers=headers, **kwargs
+                    method=method, url=url, headers=headers, **request_kwargs
+                )
+            except httpx.RequestError as exc:
+                last_error = exc
+                if attempt + 1 < max_attempts:
+                    delay = min(2**attempt, 4)
+                    logger.warning(
+                        "Langflow request transport error, retrying",
+                        endpoint=endpoint,
+                        attempt=attempt + 1,
+                        max_attempts=max_attempts,
+                        error=str(exc),
+                        retry_in_seconds=delay,
+                    )
+                    await asyncio.sleep(delay)
+                    continue
+                raise
+
+            # Retry once with a fresh API key on auth failure
+            if response.status_code in (401, 403):
+                logger.warning(
+                    "Langflow request auth failed, regenerating API key and retrying",
+                    status_code=response.status_code,
+                    endpoint=endpoint,
+                )
+                api_key = await get_langflow_api_key(force_regenerate=True)
+                if api_key:
+                    headers["x-api-key"] = api_key
+                    response = await self.langflow_http_client.request(
+                        method=method, url=url, headers=headers, **kwargs
+                    )
+
+            if response.status_code in _TRANSIENT_STATUS_CODES and attempt + 1 < max_attempts:
+                delay = min(2**attempt, 4)
+                logger.warning(
+                    "Langflow request returned transient status, retrying",
+                    endpoint=endpoint,
+                    status_code=response.status_code,
+                    attempt=attempt + 1,
+                    max_attempts=max_attempts,
+                    retry_in_seconds=delay,
                 )
+                await asyncio.sleep(delay)
+                continue
+
+            return response
 
-        return response
+        if last_error is not None:
+            raise last_error
+        raise RuntimeError("Langflow request failed without a response")
 
     async def _create_langflow_global_variable(self, name: str, value: str, modify: bool = False):
         """Create a global variable in Langflow via API"""
diff --git a/src/models/processors.py b/src/models/processors.py
index 84f4d647a..fbfdd3620 100644
--- a/src/models/processors.py
+++ b/src/models/processors.py
@@ -798,6 +798,9 @@ async def process_item(self, upload_task: UploadTask, item: str, file_task: File
                     return
 
                 # Process using Langflow pipeline
+                from models.tasks import IngestionPhase
+
+                file_task.phase = IngestionPhase.LANGFLOW
                 result = await self.langflow_connector_service.process_connector_document(
                     document,
                     self.user_id,
diff --git a/src/services/task_service.py b/src/services/task_service.py
index 25f301e21..9d46f438b 100644
--- a/src/services/task_service.py
+++ b/src/services/task_service.py
@@ -57,6 +57,10 @@
     "name or service not known",
     "service unavailable",
     "network is unreachable",
+    "server disconnected",
+    "disconnected without sending a response",
+    "remote protocol error",
+    "broken pipe",
 )
 
 
@@ -65,6 +69,11 @@ def _is_non_retryable_file_error(error: str) -> bool:
     return any(marker in lowered for marker in _NON_RETRYABLE_FILE_ERROR_MARKERS)
 
 
+def _is_transient_connectivity_error(error: str) -> bool:
+    lowered = error.lower()
+    return any(marker in lowered for marker in _TRANSIENT_CONNECTIVITY_ERROR_MARKERS)
+
+
 def _is_docling_transient_error(error: str) -> bool:
     lowered = error.lower()
     # Legacy timeout messages emitted by Docling polling path.
@@ -73,7 +82,41 @@ def _is_docling_transient_error(error: str) -> bool:
 
     # Connector-originated transient network failures can still surface while
     # file phase is DOCLING (before conversion can complete).
-    return any(marker in lowered for marker in _TRANSIENT_CONNECTIVITY_ERROR_MARKERS)
+    return _is_transient_connectivity_error(error)
+
+
+def _transient_connectivity_user_message(error: str) -> str:
+    lowered = error.lower()
+    if any(
+        marker in lowered
+        for marker in (
+            "disconnect",
+            "without sending a response",
+            "connection refused",
+            "connection reset",
+            "broken pipe",
+            "remote protocol",
+        )
+    ):
+        return "Ingestion service connection was lost. Please retry ingestion."
+    if any(marker in lowered for marker in ("timeout", "timed out")):
+        return "Document processing timed out. Please retry ingestion."
+    return "Ingestion service was temporarily unavailable. Please retry ingestion."
+
+
+def _is_langflow_transport_failure(error: str) -> bool:
+    """HTTP client / Langflow transport failures on the connector ingest path."""
+    lowered = error.lower()
+    return any(
+        marker in lowered
+        for marker in (
+            "server disconnected",
+            "disconnected without sending a response",
+            "remote protocol error",
+            "read error",
+            "write error",
+        )
+    )
 
 
 class IngestionTimeoutError(Exception):
@@ -769,9 +812,14 @@ async def retry_failed_files(
                 file_task.error = None
                 file_task.result = None
                 file_task.retry_count += 1
-                file_task.docling_status = DoclingPhaseStatus.PENDING
-                file_task.phase = IngestionPhase.DOCLING
                 file_task.docling_task_id = None
+                # Connector tasks use remote IDs as file_path and ingest via Langflow.
+                if os.path.isabs(file_path):
+                    file_task.docling_status = DoclingPhaseStatus.PENDING
+                    file_task.phase = IngestionPhase.DOCLING
+                else:
+                    file_task.docling_status = DoclingPhaseStatus.PENDING
+                    file_task.phase = IngestionPhase.LANGFLOW
                 file_task.updated_at = now
                 paths_to_retry.append(file_path)
 
@@ -860,10 +908,11 @@ def _infer_failure_metadata(self, file_task: FileTask) -> dict | None:
             }
 
         if phase == IngestionPhase.DOCLING and _is_docling_transient_error(error):
+            langflow_transport = _is_langflow_transport_failure(error)
             return {
-                "component": "docling",
-                "failure_phase": "parsing",
-                "user_facing_message": "Document processing timed out. Please retry ingestion.",
+                "component": "langflow" if langflow_transport else "docling",
+                "failure_phase": "unknown" if langflow_transport else "parsing",
+                "user_facing_message": _transient_connectivity_user_message(error),
                 "actionable_by": "RETRYABLE",
             }
 
@@ -893,6 +942,14 @@ def _infer_failure_metadata(self, file_task: FileTask) -> dict | None:
                 "actionable_by": "USER_ACTIONABLE",
             }
 
+        if _is_transient_connectivity_error(error) or _is_langflow_transport_failure(error):
+            return {
+                "component": "langflow",
+                "failure_phase": "unknown",
+                "user_facing_message": _transient_connectivity_user_message(error),
+                "actionable_by": "RETRYABLE",
+            }
+
         if phase == IngestionPhase.LANGFLOW:
             error_lower = error.lower()
             if any(
diff --git a/tests/unit/test_task_service_retry_failed_files.py b/tests/unit/test_task_service_retry_failed_files.py
index 4990d5267..811374efb 100644
--- a/tests/unit/test_task_service_retry_failed_files.py
+++ b/tests/unit/test_task_service_retry_failed_files.py
@@ -171,6 +171,46 @@ async def test_retry_connector_connectivity_error_is_retryable(task_service):
     mock_bg.assert_called_once()
 
 
+@pytest.mark.asyncio
+async def test_langflow_disconnect_error_is_retryable(task_service):
+    processor = Mock()
+    ft = FileTask(file_path="google-drive-file-id", filename="statement.pdf")
+    ft.status = TaskStatus.FAILED
+    ft.phase = IngestionPhase.DOCLING
+    ft.docling_status = DoclingPhaseStatus.PENDING
+    ft.error = "Server disconnected without sending a response."
+    task = UploadTask(
+        task_id="task-langflow-disconnect",
+        total_files=1,
+        file_tasks={"google-drive-file-id": ft},
+        status=TaskStatus.FAILED,
+        failed_files=1,
+        processor=processor,
+    )
+    _store_task(task_service, "user1", task)
+
+    metadata = task_service._infer_failure_metadata(ft)
+    assert metadata is not None
+    assert metadata["actionable_by"] == "RETRYABLE"
+    assert metadata["component"] == "langflow"
+
+    with (
+        patch("os.path.isfile", return_value=False),
+        patch.object(
+            task_service,
+            "background_custom_processor",
+            new_callable=AsyncMock,
+        ) as mock_bg,
+        patch("asyncio.create_task", return_value=Mock()),
+    ):
+        result = await task_service.retry_failed_files("user1", "task-langflow-disconnect")
+
+    assert result is not None
+    assert result["retried"] == 1
+    assert ft.phase == IngestionPhase.LANGFLOW
+    mock_bg.assert_called_once()
+
+
 @pytest.mark.asyncio
 async def test_retry_connector_id_path_does_not_require_local_file(task_service):
     processor = Mock()

From 12d6c26df94b21608d507c06d9e543dd419b456d Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Thu, 28 May 2026 01:00:03 -0400
Subject: [PATCH 22/25] addressed rabbit code comments

---
 frontend/app/knowledge/page.tsx               |  2 +-
 .../components/task-dialog/use-task-dialog.ts |  9 ++++++--
 src/api/schemas/tasks.py                      | 22 +++++++++++++++++++
 src/api/tasks.py                              |  3 +++
 src/app/routes/internal.py                    | 11 +++++++++-
 src/config/settings.py                        |  2 +-
 src/services/task_service.py                  |  9 +++++++-
 7 files changed, 52 insertions(+), 6 deletions(-)
 create mode 100644 src/api/schemas/tasks.py

diff --git a/frontend/app/knowledge/page.tsx b/frontend/app/knowledge/page.tsx
index aef291d5e..b03e2f492 100644
--- a/frontend/app/knowledge/page.tsx
+++ b/frontend/app/knowledge/page.tsx
@@ -813,7 +813,7 @@ function SearchPage() {
         toast.success(
           `Deleted ${deleted.length} document${deleted.length > 1 ? "s" : ""}`,
         );
-      } else {
+      } else if (failed.length === 0) {
         toast.warning(
           "No document chunks were deleted. Files may be missing or not deletable in your current context.",
         );
diff --git a/frontend/components/task-dialog/use-task-dialog.ts b/frontend/components/task-dialog/use-task-dialog.ts
index 3b04001e5..2ee714a00 100644
--- a/frontend/components/task-dialog/use-task-dialog.ts
+++ b/frontend/components/task-dialog/use-task-dialog.ts
@@ -165,6 +165,11 @@ export function useTaskDialog(open: boolean, taskId: string) {
     [sortedEntries],
   );
 
+  const allRetryablePaths = useMemo(
+    () => (task ? getRetryableFilePaths(getRetryableFileEntries(task)) : []),
+    [task],
+  );
+
   const selectedCount = useMemo(() => {
     let count = 0;
     for (const path of selectablePaths) {
@@ -193,8 +198,8 @@ export function useTaskDialog(open: boolean, taskId: string) {
     retryIngestionSelectedCount === retryIngestionPaths.length;
 
   const selectedRetryablePaths = useMemo(
-    () => selectablePaths.filter((path) => selectedPaths.has(path)),
-    [selectablePaths, selectedPaths],
+    () => allRetryablePaths.filter((path) => selectedPaths.has(path)),
+    [allRetryablePaths, selectedPaths],
   );
 
   const runRetry = useCallback(
diff --git a/src/api/schemas/tasks.py b/src/api/schemas/tasks.py
new file mode 100644
index 000000000..de2d45138
--- /dev/null
+++ b/src/api/schemas/tasks.py
@@ -0,0 +1,22 @@
+from pydantic import BaseModel, Field
+
+
+class ErrorResponse(BaseModel):
+    error: str
+    message: str | None = None
+    task_id: str | None = None
+
+
+class TaskRetrySkippedFile(BaseModel):
+    file_path: str
+    filename: str | None = None
+    reason: str | None = None
+
+
+class TaskRetryResponse(BaseModel):
+    task_id: str
+    retried: int = 0
+    skipped: list[TaskRetrySkippedFile] = Field(default_factory=list)
+    status: str
+    message: str | None = None
+    error: str | None = None
diff --git a/src/api/tasks.py b/src/api/tasks.py
index eb5b3cc32..8e695c8d2 100644
--- a/src/api/tasks.py
+++ b/src/api/tasks.py
@@ -76,6 +76,9 @@ async def retry_task(
     if result.get("error") == "task_in_progress":
         return JSONResponse(result, status_code=409)
 
+    if result.get("error") == "no_processor":
+        return JSONResponse(result, status_code=400)
+
     if result.get("status") == "no_op":
         return JSONResponse(result, status_code=400)
 
diff --git a/src/app/routes/internal.py b/src/app/routes/internal.py
index 21bc25e7e..c6f43a2da 100644
--- a/src/app/routes/internal.py
+++ b/src/app/routes/internal.py
@@ -6,7 +6,7 @@
 Depends, not here. This module only wires URL → handler.
 """
 
-from fastapi import FastAPI
+from fastapi import FastAPI, status
 
 from api import (
     auth,
@@ -28,6 +28,7 @@
     tasks,
     upload,
 )
+from api.schemas.tasks import ErrorResponse, TaskRetryResponse
 from api import keys as api_keys
 from api.health import health_check, opensearch_health_ready
 from connectors.aws_s3.api import (
@@ -96,6 +97,14 @@ def register_internal_routes(app: FastAPI):
         tasks.retry_task,
         methods=["POST"],
         tags=["internal"],
+        status_code=status.HTTP_202_ACCEPTED,
+        response_model=TaskRetryResponse,
+        responses={
+            400: {"model": ErrorResponse},
+            404: {"model": ErrorResponse},
+            409: {"model": ErrorResponse},
+            500: {"model": ErrorResponse},
+        },
     )
     app.add_api_route(
         "/tasks/{task_id}/cancel",
diff --git a/src/config/settings.py b/src/config/settings.py
index 360b418b0..72144a93d 100644
--- a/src/config/settings.py
+++ b/src/config/settings.py
@@ -864,7 +864,7 @@ async def langflow_request(self, method: str, endpoint: str, **kwargs):
                 if api_key:
                     headers["x-api-key"] = api_key
                     response = await self.langflow_http_client.request(
-                        method=method, url=url, headers=headers, **kwargs
+                        method=method, url=url, headers=headers, **request_kwargs
                     )
 
             if response.status_code in _TRANSIENT_STATUS_CODES and attempt + 1 < max_attempts:
diff --git a/src/services/task_service.py b/src/services/task_service.py
index 9d46f438b..48a590a87 100644
--- a/src/services/task_service.py
+++ b/src/services/task_service.py
@@ -839,8 +839,15 @@ async def retry_failed_files(
         background_task = asyncio.create_task(
             self.background_custom_processor(store_user_id, task_id, paths_to_retry, processor)
         )
+        upload_task.background_task = background_task
         self.background_tasks.add(background_task)
-        background_task.add_done_callback(self.background_tasks.discard)
+
+        def _clear_retry_background_task(done_task: asyncio.Task) -> None:
+            self.background_tasks.discard(done_task)
+            if upload_task.background_task is done_task:
+                upload_task.background_task = None
+
+        background_task.add_done_callback(_clear_retry_background_task)
 
         return {
             "task_id": task_id,

From b3d1ad1c15842a50e10e98c04a82775d2b8919e9 Mon Sep 17 00:00:00 2001
From: "autofix-ci[bot]" <114827586+autofix-ci[bot]@users.noreply.github.com>
Date: Thu, 28 May 2026 05:00:39 +0000
Subject: [PATCH 23/25] style: ruff autofix (auto)

---
 src/app/routes/internal.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/app/routes/internal.py b/src/app/routes/internal.py
index c6f43a2da..2b80ac431 100644
--- a/src/app/routes/internal.py
+++ b/src/app/routes/internal.py
@@ -28,9 +28,9 @@
     tasks,
     upload,
 )
-from api.schemas.tasks import ErrorResponse, TaskRetryResponse
 from api import keys as api_keys
 from api.health import health_check, opensearch_health_ready
+from api.schemas.tasks import ErrorResponse, TaskRetryResponse
 from connectors.aws_s3.api import (
     s3_bucket_status,
     s3_configure,

From bfec39a2e52a7867645af87b2b825dbc8d1f08d2 Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Thu, 28 May 2026 07:46:49 -0400
Subject: [PATCH 24/25] addressed rabbit code comments

---
 frontend/app/api/mutations/useCancelTaskMutation.ts | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/frontend/app/api/mutations/useCancelTaskMutation.ts b/frontend/app/api/mutations/useCancelTaskMutation.ts
index de5d82d85..c18bb130c 100644
--- a/frontend/app/api/mutations/useCancelTaskMutation.ts
+++ b/frontend/app/api/mutations/useCancelTaskMutation.ts
@@ -3,6 +3,7 @@ import {
   useMutation,
   useQueryClient,
 } from "@tanstack/react-query";
+import { taskDetailQueryKey } from "@/app/api/queries/useGetTaskQuery";
 import { TASKS_QUERY_KEY } from "@/app/api/queries/useGetTasksQuery";
 
 export interface CancelTaskRequest {
@@ -44,6 +45,9 @@ export const useCancelTaskMutation = (
     ...restOptions,
     onSuccess: (data, variables, context) => {
       queryClient.invalidateQueries({ queryKey: [...TASKS_QUERY_KEY] });
+      queryClient.invalidateQueries({
+        queryKey: taskDetailQueryKey(variables.taskId),
+      });
       onSuccess?.(data, variables, context);
     },
     onError,

From 145773b2adfb69df2cca8f75ef688fd3a309bbef Mon Sep 17 00:00:00 2001
From: Olfa Maslah <olfamaslah@Olfas-MacBook-Pro.local>
Date: Thu, 28 May 2026 07:58:54 -0400
Subject: [PATCH 25/25] use regenerated-key retry safely limit auth-refresh
 retry to once per request call retry boundedly on persistent 401/403 instead
 of immediately returning

---
 src/config/settings.py | 39 +++++++++++++++++++++++++++++++++++----
 1 file changed, 35 insertions(+), 4 deletions(-)

diff --git a/src/config/settings.py b/src/config/settings.py
index 72144a93d..c9b5ab255 100644
--- a/src/config/settings.py
+++ b/src/config/settings.py
@@ -815,6 +815,7 @@ async def langflow_request(self, method: str, endpoint: str, **kwargs):
         _TRANSIENT_STATUS_CODES = {408, 429, 500, 502, 503, 504}
         max_attempts = max(1, LANGFLOW_REQUEST_RETRIES + 1)
         last_error: Exception | None = None
+        auth_retry_attempted = False
         request_kwargs = dict(kwargs)
         passed_headers = request_kwargs.pop("headers", {}) or {}
 
@@ -854,18 +855,48 @@ async def langflow_request(self, method: str, endpoint: str, **kwargs):
                 raise
 
             # Retry once with a fresh API key on auth failure
-            if response.status_code in (401, 403):
+            if response.status_code in (401, 403) and not auth_retry_attempted:
                 logger.warning(
                     "Langflow request auth failed, regenerating API key and retrying",
                     status_code=response.status_code,
                     endpoint=endpoint,
                 )
+                auth_retry_attempted = True
                 api_key = await get_langflow_api_key(force_regenerate=True)
                 if api_key:
                     headers["x-api-key"] = api_key
-                    response = await self.langflow_http_client.request(
-                        method=method, url=url, headers=headers, **request_kwargs
-                    )
+                    try:
+                        response = await self.langflow_http_client.request(
+                            method=method, url=url, headers=headers, **request_kwargs
+                        )
+                    except httpx.RequestError as exc:
+                        last_error = exc
+                        if attempt + 1 < max_attempts:
+                            delay = min(2**attempt, 4)
+                            logger.warning(
+                                "Langflow auth retry transport error, retrying",
+                                endpoint=endpoint,
+                                attempt=attempt + 1,
+                                max_attempts=max_attempts,
+                                error=str(exc),
+                                retry_in_seconds=delay,
+                            )
+                            await asyncio.sleep(delay)
+                            continue
+                        raise
+
+            if response.status_code in (401, 403) and attempt + 1 < max_attempts:
+                delay = min(2**attempt, 4)
+                logger.warning(
+                    "Langflow auth failure persists, retrying request",
+                    endpoint=endpoint,
+                    status_code=response.status_code,
+                    attempt=attempt + 1,
+                    max_attempts=max_attempts,
+                    retry_in_seconds=delay,
+                )
+                await asyncio.sleep(delay)
+                continue
 
             if response.status_code in _TRANSIENT_STATUS_CODES and attempt + 1 < max_attempts:
                 delay = min(2**attempt, 4)