Skip to content

🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.

fix(web): move the compare-traces toggle into the migration action items (#16129)

Trang Nguyen63272e181aa6
diff --git a/web/src/features/v4-migration/V4MigrationBadgeContent.tsx b/web/src/features/v4-migration/V4MigrationBadgeContent.tsx
index eef5389721..11f44a1731 100644
--- a/web/src/features/v4-migration/V4MigrationBadgeContent.tsx
+++ b/web/src/features/v4-migration/V4MigrationBadgeContent.tsx
@@ -8,16 +8,18 @@ import { cn } from "@/src/utils/tailwind";
export function V4MigrationStatusDot({
variant,
}: {
- variant: "action" | "done";
+ // "neutral" marks optional helpers in the checklist — neither pending
+ // work (amber) nor a completed check (green).
+ variant: "action" | "done" | "neutral";
}) {
return (
<span
aria-hidden
className={cn(
"size-1.75 shrink-0 rounded-full",
- variant === "action"
- ? "bg-orange-400 dark:bg-orange-400"
- : "bg-green-400 dark:bg-green-400",
+ variant === "action" && "bg-orange-400 dark:bg-orange-400",
+ variant === "done" && "bg-green-400 dark:bg-green-400",
+ variant === "neutral" && "bg-gray-400 dark:bg-gray-400",
)}
/>
);
diff --git a/web/src/features/v4-migration/V4MigrationContent.tsx b/web/src/features/v4-migration/V4MigrationContent.tsx
index c6c69aa041..c11876d9b0 100644
--- a/web/src/features/v4-migration/V4MigrationContent.tsx
+++ b/web/src/features/v4-migration/V4MigrationContent.tsx
@@ -1503,6 +1503,47 @@ export function V4MigrationDetailsContent({
sdk={migrationData.sdk}
projectId={evidenceProjectId}
/>
+
+ {/* Always the last checklist row. Hides itself when the session
+ cannot toggle v4 (legacy/events_only write mode, post-rollout
+ auto-enrollment). Neutral dot + muted text: an optional helper
+ in the settled-summary style, not pending work. */}
+ {canToggleV4 && (
+ <div className="flex w-full items-center gap-2.5 py-2.5">
+ <V4MigrationStatusDot variant="neutral" />
+ <span className="text-muted-foreground flex min-w-0 items-center gap-1.5 text-sm">
+ Compare traces while you upgrade
+ <HoverCard openDelay={200}>
+ <HoverCardTrigger asChild>
+ <button
+ type="button"
+ aria-label="Why compare traces?"
+ className="shrink-0"
+ >
+ <Info className="h-3.5 w-3.5" />
+ </button>
+ </HoverCardTrigger>
+ <HoverCardPortal>
+ <HoverCardContent className="w-80 text-sm">
+ The latest SDK no longer sets trace input and output;{" "}
+ <ExternalLink
+ href={OBSERVATIONS_DATA_MODEL_URL}
+ analytics={{
+ section: "compare_row",
+ link: "observations_data_model_docs",
+ }}
+ >
+ v4 infers them from observations
+ </ExternalLink>
+ .
+ </HoverCardContent>
+ </HoverCardPortal>
+ </HoverCard>
+ </span>
+ <span className="flex-1" />
+ <V4PreviewToggleRow projectId={projectId} />
+ </div>
+ )}
</div>
</div>
@@ -1510,46 +1551,6 @@ export function V4MigrationDetailsContent({
<V4MigrationAgentUpgradeSection projectId={projectId} />
- {/* The toggle row hides itself when the session cannot toggle v4
- (legacy/events_only write mode, post-rollout auto-enrollment), so the
- copy describing it must hide on the same condition. */}
- {canToggleV4 && (
- <>
- <div className="flex items-center justify-between gap-2">
- <p className="text-muted-foreground flex min-w-0 items-center gap-1.5 text-sm">
- Compare traces while you upgrade
- <HoverCard openDelay={200}>
- <HoverCardTrigger asChild>
- <button
- type="button"
- aria-label="Why compare traces?"
- className="shrink-0"
- >
- <Info className="h-3.5 w-3.5" />
- </button>
- </HoverCardTrigger>
- <HoverCardPortal>
- <HoverCardContent className="w-80 text-sm">
- The latest SDK no longer sets trace input and output;{" "}
- <ExternalLink
- href={OBSERVATIONS_DATA_MODEL_URL}
- analytics={{
- section: "compare_row",
- link: "observations_data_model_docs",
- }}
- >
- v4 infers them from observations
- </ExternalLink>
- .
- </HoverCardContent>
- </HoverCardPortal>
- </HoverCard>
- </p>
- <V4PreviewToggleRow projectId={projectId} />
- </div>
- </>
- )}
-
<Separator />
<div className="flex flex-col gap-2">