Open-Source-Legal
diff --git a/‎CHANGELOG.md‎
Lines changed: 41 additions & 5 deletions b/‎CHANGELOG.md‎
Lines changed: 41 additions & 5 deletions
diff --git a/‎config/graphql/research_queries.py‎
Lines changed: 22 additions & 0 deletions b/‎config/graphql/research_queries.py‎
Lines changed: 22 additions & 0 deletions
diff --git a/‎docs/assets/images/screenshots/auto/research--corpus-report-cards--empty.png‎
22.3 KB b/‎docs/assets/images/screenshots/auto/research--corpus-report-cards--empty.png‎
22.3 KB
diff --git a/‎docs/assets/images/screenshots/auto/research--report-detail--citations.png‎
40.6 KB b/‎docs/assets/images/screenshots/auto/research--report-detail--citations.png‎
40.6 KB
diff --git a/‎docs/assets/images/screenshots/auto/research--report-detail--completed.png‎
46.8 KB b/‎docs/assets/images/screenshots/auto/research--report-detail--completed.png‎
46.8 KB
diff --git a/‎docs/assets/images/screenshots/auto/research--start-research-modal--open.png‎
29.3 KB b/‎docs/assets/images/screenshots/auto/research--start-research-modal--open.png‎
29.3 KB
diff --git a/‎frontend/src/App.tsx‎
Lines changed: 2 additions & 0 deletions b/‎frontend/src/App.tsx‎
Lines changed: 2 additions & 0 deletions
diff --git a/‎frontend/src/assets/configurations/constants.ts‎
Lines changed: 47 additions & 0 deletions b/‎frontend/src/assets/configurations/constants.ts‎
Lines changed: 47 additions & 0 deletions
diff --git a/‎frontend/src/components/notifications/JobNotificationToast.tsx‎
Lines changed: 43 additions & 7 deletions b/‎frontend/src/components/notifications/JobNotificationToast.tsx‎
Lines changed: 43 additions & 7 deletions
@@ -68,3 +68,25 @@ def resolve_research_reports(self, info, **kwargs) -> Any:
                 return qs.none()
             qs = qs.filter(status=status)
         return qs.order_by("-created")
+
+    research_report_by_slug = graphene.Field(
+        ResearchReportType,
+        slug=graphene.String(required=True),
+        description=(
+            "Fetch a single research report by its unique slug. The "
+            "deep-research completion chat message links to /research/{slug}, "
+            "so the frontend resolves that route through this field. "
+            "Creator-only visibility (returns null for non-owners or unknown "
+            "slugs — IDOR-safe)."
+        ),
+    )
+
+    @login_required
+    def resolve_research_report_by_slug(self, info, slug) -> Any:
+        return (
+            BaseService.filter_visible(
+                ResearchReport, info.context.user, request=info.context
+            )
+            .filter(slug=slug)
+            .first()
+        )
@@ -74,6 +74,7 @@ import {
 } from "./components/admin";
 import { useEnv } from "./components/hooks/UseEnv";
 import { ExtractDetailRoute } from "./components/routes/ExtractDetailRoute";
+import { ResearchReportRoute } from "./components/routes/ResearchReportRoute";
 import { FileUploadPackageProps } from "./components/widgets/modals/DocumentUploadModal";
 import { DocumentLandingRoute } from "./components/routes/DocumentLandingRoute";
 import { LabelSetLandingRoute } from "./components/routes/LabelSetLandingRoute";
@@ -406,6 +407,7 @@ export const App = () => {
           <Route path="/about" element={<About />} />
           <Route path="/extracts/:extractId" element={<ExtractDetailRoute />} />
           <Route path="/extracts" element={<Extracts />} />
+          <Route path="/research/:slug" element={<ResearchReportRoute />} />
           <Route path="/admin/badges" element={<BadgeManagement />} />
           <Route path="/admin/settings" element={<GlobalSettingsPanel />} />
           <Route path="/admin/agents" element={<GlobalAgentManagement />} />
 
@@ -128,6 +128,8 @@ export const SELECTION_MENU = {
 export const DEBOUNCE = {
   SEARCH_MS: 1000,
   EXTRACT_SEARCH_MS: 500,
+  /** Generic debounce for client-side list search boxes (extracts, research, …). */
+  LIST_SEARCH_MS: 500,
   CLICK_OUTSIDE_DELAY_MS: 100,
   CORPUS_SEARCH_MS: 400,
   CORPUS_SEARCH_MAX_WAIT_MS: 1000,
@@ -229,6 +231,51 @@ export const EXTRACT_STATUS_COLORS = {
   [EXTRACT_STATUS.NOT_STARTED]: "default",
 } as const;
 
+// Deep-research report status constants.
+// Keys match the backend JobStatus enum values
+// (opencontractserver/types/enums.py); values are the display labels.
+export const RESEARCH_STATUS = {
+  QUEUED: "Queued",
+  RUNNING: "Researching",
+  COMPLETED: "Completed",
+  FAILED: "Failed",
+  CANCELLED: "Cancelled",
+} as const;
+
+export type ResearchStatusLabel =
+  (typeof RESEARCH_STATUS)[keyof typeof RESEARCH_STATUS];
+
+// Research chip color mapping (Chip `color` tokens from @os-legal/ui)
+export const RESEARCH_STATUS_COLORS = {
+  [RESEARCH_STATUS.QUEUED]: "default",
+  [RESEARCH_STATUS.RUNNING]: "info",
+  [RESEARCH_STATUS.COMPLETED]: "success",
+  [RESEARCH_STATUS.FAILED]: "error",
+  [RESEARCH_STATUS.CANCELLED]: "warning",
+} as const;
+
+// Poll interval (ms) the research report detail view uses while a job is
+// non-terminal. The backend emits no per-step progress events in v1, so the
+// view polls the (indexed, creator-only) single-report query for live
+// stepCount/lastProgressAt and stops on the terminal WebSocket notification.
+export const RESEARCH_REPORT_POLL_INTERVAL_MS = 5000;
+
+// Guardian object-permission string that gates cancelling a research report.
+// Centralised here (not inlined) so a typo can't silently disable Cancel for
+// every user and any future check on the same model stays consistent.
+export const RESEARCH_REPORT_UPDATE_PERMISSION = "update_researchreport";
+
+// Max research prompt length. Mirrors the backend cap
+// (opencontractserver/research/constants.py MAX_RESEARCH_PROMPT_CHARS) so the
+// UI rejects over-long prompts before the round-trip.
+export const MAX_RESEARCH_PROMPT_CHARS = 10000;
+
+// Max research report title length. Mirrors the backend model column
+// (opencontractserver/research/models.py ResearchReport.title max_length=255)
+// so the UI caps the optional title before the round-trip rather than letting
+// the DB silently truncate / the service reject it.
+export const MAX_RESEARCH_TITLE_CHARS = 255;
+
 // Tool usage UI constants (used by chat ToolUsageIndicator)
 export const TOOL_UNKNOWN_LABEL = "Unknown Tool";
 
 
@@ -6,15 +6,27 @@ import {
   BarChart3,
   Download,
   XCircle,
+  Sparkles,
+  Ban,
   LucideIcon,
 } from "lucide-react";
 import type { JobNotification } from "../../hooks/useJobNotifications";
 import type { NotificationType } from "../../hooks/useNotificationWebSocket";
+import { OS_LEGAL_COLORS } from "../../assets/configurations/osLegalStyles";
 
-const ToastContainer = styled.div`
+// Semantic status colors for job toasts, sourced from the design tokens so we
+// don't scatter raw hex literals (no-magic-numbers). The IconContainer appends
+// a "20" alpha suffix, so each must be a 6-digit hex.
+const STATUS_SUCCESS = OS_LEGAL_COLORS.success;
+const STATUS_FAILED = OS_LEGAL_COLORS.danger;
+const STATUS_INFO = OS_LEGAL_COLORS.primaryBlue;
+const STATUS_NEUTRAL = OS_LEGAL_COLORS.textMuted;
+
+const ToastContainer = styled.div<{ $clickable?: boolean }>`
   display: flex;
   align-items: center;
   gap: 12px;
+  cursor: ${({ $clickable }) => ($clickable ? "pointer" : "default")};
 `;
 
 const IconContainer = styled.div<{ $color: string }>`
@@ -62,14 +74,14 @@ interface JobNotificationConfig {
 const JOB_NOTIFICATION_CONFIG: Record<string, JobNotificationConfig> = {
   DOCUMENT_PROCESSED: {
     icon: FileText,
-    color: "#4CAF50",
+    color: STATUS_SUCCESS,
     title: "Document Ready",
     getMessage: (data) =>
       `"${(data.documentTitle as string) || "Document"}" finished processing`,
   },
   EXTRACT_COMPLETE: {
     icon: Table2,
-    color: "#2196F3",
+    color: STATUS_INFO,
     title: "Extract Complete",
     getMessage: (data) =>
       `"${(data.extractName as string) || "Extract"}" completed (${
@@ -78,31 +90,54 @@ const JOB_NOTIFICATION_CONFIG: Record<string, JobNotificationConfig> = {
   },
   ANALYSIS_COMPLETE: {
     icon: BarChart3,
-    color: "#4CAF50",
+    color: STATUS_SUCCESS,
     title: "Analysis Complete",
     getMessage: (data) =>
       `"${(data.analyzerName as string) || "Analysis"}" finished successfully`,
   },
   ANALYSIS_FAILED: {
     icon: XCircle,
-    color: "#F44336",
+    color: STATUS_FAILED,
     title: "Analysis Failed",
     getMessage: (data) =>
       `"${(data.analyzerName as string) || "Analysis"}" encountered an error`,
   },
   EXPORT_COMPLETE: {
     icon: Download,
-    color: "#4CAF50",
+    color: STATUS_SUCCESS,
     title: "Export Ready",
     getMessage: (data) =>
       `"${
         (data.exportName as string) || (data.corpusName as string) || "Export"
       }" is ready for download`,
   },
+  RESEARCH_REPORT_COMPLETE: {
+    icon: Sparkles,
+    color: STATUS_SUCCESS,
+    title: "Research Complete",
+    getMessage: (data) =>
+      `"${(data.title as string) || "Research"}" is ready to read`,
+  },
+  RESEARCH_REPORT_FAILED: {
+    icon: XCircle,
+    color: STATUS_FAILED,
+    title: "Research Failed",
+    getMessage: (data) =>
+      `"${(data.title as string) || "Research"}" could not be completed`,
+  },
+  RESEARCH_REPORT_CANCELLED: {
+    icon: Ban,
+    color: STATUS_NEUTRAL,
+    title: "Research Cancelled",
+    getMessage: (data) =>
+      `"${(data.title as string) || "Research"}" was cancelled`,
+  },
 };
 
 export interface JobNotificationToastProps {
   notification: JobNotification;
+  /** Optional click handler — e.g. deep-link a research toast to its report. */
+  onClick?: () => void;
 }
 
 /**
@@ -111,6 +146,7 @@ export interface JobNotificationToastProps {
  */
 export function JobNotificationToast({
   notification,
+  onClick,
 }: JobNotificationToastProps) {
   const config =
     JOB_NOTIFICATION_CONFIG[notification.type] ||
@@ -119,7 +155,7 @@ export function JobNotificationToast({
   const Icon = config.icon;
 
   return (
-    <ToastContainer>
+    <ToastContainer $clickable={Boolean(onClick)} onClick={onClick}>
       <IconContainer $color={config.color}>
         <Icon />
       </IconContainer>