feat(seer): Poll Seer Explorer by UUID

trevor-e · trevor-e · commit 0c8031ad77c1 · 2026-06-16T11:38:54.000-04:00
Adopt the run's UUID (sentry_run_id) for Seer Explorer polling instead of
the numeric run id, mirroring the search agent. The run id widens to
number | string and new runs take sentry_run_id ?? run_id. Existing
numeric-keyed runs keep working unchanged (the endpoint resolves both
forms). The persisted run id and explorerRunId deep links accept UUIDs too.
diff --git a/static/app/utils/analytics/seerAnalyticsEvents.tsx b/static/app/utils/analytics/seerAnalyticsEvents.tsx
@@ -1,4 +1,5 @@
 import type {Organization} from 'sentry/types/organization';
+import type {SeerExplorerRunId} from 'sentry/views/seerExplorer/types';
 
 export type SeerAnalyticsEventsParameters = {
   'ai_query.applied': {
@@ -136,7 +137,7 @@ export type SeerAnalyticsEventsParameters = {
     conversations_url: string | undefined;
     explorer_url: string | undefined;
     langfuse_url: string | undefined;
-    run_id: number | undefined;
+    run_id: SeerExplorerRunId | undefined;
     type: 'positive' | 'negative';
   };
   'seer.explorer.global_panel.opened': {
@@ -158,7 +159,7 @@ export type SeerAnalyticsEventsParameters = {
   };
   'seer.explorer.session_link_copied': Record<string, unknown>;
   'seer.explorer.timed_out': {
-    run_id: number | null;
+    run_id: SeerExplorerRunId | null;
   };
 };
 
diff --git a/static/app/views/seerExplorer/components/chat/assistant.tsx b/static/app/views/seerExplorer/components/chat/assistant.tsx
@@ -11,7 +11,7 @@ import {trackAnalytics} from 'sentry/utils/analytics';
 import {useOrganization} from 'sentry/utils/useOrganization';
 import {useSessionStorage} from 'sentry/utils/useSessionStorage';
 import {getConversationsUrlForExternalUse} from 'sentry/views/explore/conversations/utils/urlParams';
-import type {Block} from 'sentry/views/seerExplorer/types';
+import type {Block, SeerExplorerRunId} from 'sentry/views/seerExplorer/types';
 import {getExplorerUrl, getLangfuseUrl} from 'sentry/views/seerExplorer/utils';
 
 import type {AssistantBlockProps} from './shared';
@@ -53,7 +53,11 @@ export function AssistantBlock({
   );
 }
 
-function useBlockFeedback(block: Block, blockIndex: number, runId: number | undefined) {
+function useBlockFeedback(
+  block: Block,
+  blockIndex: number,
+  runId: SeerExplorerRunId | undefined
+) {
   const organization = useOrganization();
   const [feedbackSubmitted, setFeedbackSubmitted] = useSessionStorage(
     `seer-explorer-feedback:run-${runId ?? 'null'}:block-${block.id}`,
diff --git a/static/app/views/seerExplorer/components/chat/index.tsx b/static/app/views/seerExplorer/components/chat/index.tsx
@@ -3,7 +3,7 @@ import {motion} from 'framer-motion';
 import {Container} from '@sentry/scraps/layout';
 
 import {unreachable} from 'sentry/utils/unreachable';
-import type {Block} from 'sentry/views/seerExplorer/types';
+import type {Block, SeerExplorerRunId} from 'sentry/views/seerExplorer/types';
 
 import {AssistantBlock} from './assistant';
 import {ToolUseBlock} from './toolUse';
@@ -18,7 +18,7 @@ interface BlockProps {
   onClick?: () => void;
   readOnly?: boolean;
   ref?: React.Ref<HTMLDivElement>;
-  runId?: number;
+  runId?: SeerExplorerRunId;
   showThinking?: boolean;
 }
 
diff --git a/static/app/views/seerExplorer/components/chat/shared.tsx b/static/app/views/seerExplorer/components/chat/shared.tsx
@@ -8,7 +8,7 @@ import {Link} from '@sentry/scraps/link';
 import {Markdown, type MarkdownProps} from '@sentry/scraps/markdown';
 import {Heading} from '@sentry/scraps/text';
 
-import type {Block} from 'sentry/views/seerExplorer/types';
+import type {Block, SeerExplorerRunId} from 'sentry/views/seerExplorer/types';
 
 interface BlockVariantProps {
   block: Block;
@@ -20,7 +20,7 @@ export interface AssistantBlockProps extends BlockVariantProps {
   blockIndex: number;
   interactionPending?: boolean;
   readOnly?: boolean;
-  runId?: number;
+  runId?: SeerExplorerRunId;
 }
 
 export interface ToolUseBlockProps extends BlockVariantProps {
diff --git a/static/app/views/seerExplorer/components/drawer/useSeerExplorerDrawer.tsx b/static/app/views/seerExplorer/components/drawer/useSeerExplorerDrawer.tsx
@@ -7,6 +7,7 @@ import {trackAnalytics} from 'sentry/utils/analytics';
 import {useOrganization} from 'sentry/utils/useOrganization';
 import {ExplorerDrawerContent} from 'sentry/views/seerExplorer/components/drawer/explorerDrawerContent';
 import {useSeerExplorerChatDispatch} from 'sentry/views/seerExplorer/seerExplorerChatStateContext';
+import type {SeerExplorerRunId} from 'sentry/views/seerExplorer/types';
 import {isSeerExplorerEnabled, usePageReferrer} from 'sentry/views/seerExplorer/utils';
 
 export type OpenSeerExplorerDrawerOptions = {
@@ -19,7 +20,7 @@ export type OpenSeerExplorerDrawerOptions = {
    * Optional run ID to open. If provided, opens an existing session.
    * Cannot be used together with `startNewRun`.
    */
-  runId?: number;
+  runId?: SeerExplorerRunId;
   /**
    * If true, switches to a new session before opening.
    * Cannot be used together with `runId`.
diff --git a/static/app/views/seerExplorer/components/emptyState.tsx b/static/app/views/seerExplorer/components/emptyState.tsx
@@ -7,6 +7,7 @@ import {Flex} from '@sentry/scraps/layout';
 import {LoadingIndicator} from 'sentry/components/loadingIndicator';
 import {IconSeer} from 'sentry/icons';
 import {t, tct} from 'sentry/locale';
+import type {SeerExplorerRunId} from 'sentry/views/seerExplorer/types';
 
 const SUGGESTED_QUESTIONS = [
   t('Which of my open issues are getting worse, not better?'),
@@ -19,7 +20,7 @@ interface EmptyStateProps {
   isError?: boolean;
   isLoading?: boolean;
   onSuggestionClick?: (question: string) => void;
-  runId?: number | null;
+  runId?: SeerExplorerRunId | null;
 }
 
 export function EmptyState({
diff --git a/static/app/views/seerExplorer/hooks/useSeerExplorer.tsx b/static/app/views/seerExplorer/hooks/useSeerExplorer.tsx
@@ -20,6 +20,7 @@ import type {
   Block,
   RepoPRState,
   SeerExplorerResponse,
+  SeerExplorerRunId,
 } from 'sentry/views/seerExplorer/types';
 import {
   isSeerExplorerEnabled,
@@ -30,6 +31,7 @@ import {
 type SeerExplorerChatResponse = {
   message: Block;
   run_id: number;
+  sentry_run_id?: string | null;
 };
 
 type SeerExplorerUpdateResponse = {
@@ -170,7 +172,7 @@ export const useSeerExplorer = () => {
       overrideCtxEngEnable: boolean;
       pageName: string;
       query: string;
-      runId: number | null;
+      runId: SeerExplorerRunId | null;
       screenshot: string | undefined;
     }
   >({
@@ -209,8 +211,11 @@ export const useSeerExplorer = () => {
     },
     onSuccess: (response, params) => {
       if (params.runId === null) {
-        // set run ID if this is a new session
-        dispatch({type: 'set run id', payload: response.run_id});
+        // Prefer the UUID; fall back to the numeric run_id for legacy runs.
+        dispatch({
+          type: 'set run id',
+          payload: response.sentry_run_id ?? response.run_id,
+        });
       } else {
         // invalidate the query so fresh data is fetched
         queryClient.invalidateQueries({
@@ -243,7 +248,7 @@ export const useSeerExplorer = () => {
     {
       inputId: string;
       orgSlug: string;
-      runId: number | null;
+      runId: SeerExplorerRunId | null;
       responseData?: Record<string, any>;
     }
   >({
@@ -309,7 +314,7 @@ export const useSeerExplorer = () => {
   const {mutate: createPRMutate} = useMutation<
     SeerExplorerUpdateResponse,
     RequestError,
-    {orgSlug: string; runId: number | null; repoName?: string}
+    {orgSlug: string; runId: SeerExplorerRunId | null; repoName?: string}
   >({
     mutationFn: async params => {
       setHasSentInterrupt(false);
@@ -367,7 +372,7 @@ export const useSeerExplorer = () => {
     RequestError,
     {
       orgSlug: string;
-      runId: number | null;
+      runId: SeerExplorerRunId | null;
     }
   >({
     mutationFn: async params => {
@@ -405,7 +410,7 @@ export const useSeerExplorer = () => {
 
   /** Switches to a different run and fetches its latest state. */
   const switchToRun = useCallback(
-    (newRunId: number | null, {onSuccess}: {onSuccess?: () => void} = {}) => {
+    (newRunId: SeerExplorerRunId | null, {onSuccess}: {onSuccess?: () => void} = {}) => {
       if (newRunId === runId) {
         return;
       }
@@ -436,7 +441,11 @@ export const useSeerExplorer = () => {
   );
 
   const sendMessage = useCallback(
-    (query: string, explicitInsertIndex?: number, explicitRunId?: number | null) => {
+    (
+      query: string,
+      explicitInsertIndex?: number,
+      explicitRunId?: SeerExplorerRunId | null
+    ) => {
       if (!orgSlug) {
         return;
       }
@@ -643,7 +652,6 @@ export const useSeerExplorer = () => {
     ];
 
     const baseSession = rawSessionData ?? {
-      run_id: runId ?? undefined,
       blocks: [],
       status: 'processing' as const,
       updated_at: new Date().toISOString(),
diff --git a/static/app/views/seerExplorer/hooks/useSeerExplorerPolling.tsx b/static/app/views/seerExplorer/hooks/useSeerExplorerPolling.tsx
@@ -5,7 +5,10 @@ import {useApiQuery} from 'sentry/utils/queryClient';
 import {useOrganization} from 'sentry/utils/useOrganization';
 import {useTimeout} from 'sentry/utils/useTimeout';
 import type {PollingState} from 'sentry/views/seerExplorer/seerExplorerChatStateContext';
-import type {SeerExplorerResponse} from 'sentry/views/seerExplorer/types';
+import type {
+  SeerExplorerResponse,
+  SeerExplorerRunId,
+} from 'sentry/views/seerExplorer/types';
 import type {Block} from 'sentry/views/seerExplorer/types';
 import {
   isSeerExplorerEnabled,
@@ -36,7 +39,7 @@ const getTimestampAge = (updatedAt: string | undefined): number | null => {
 };
 
 const getPollingState = (
-  runId: number | null,
+  runId: SeerExplorerRunId | null,
   sessionData: SeerExplorerResponse['session'] | undefined,
   isError: boolean,
   errorStatusCode: number | undefined,
@@ -70,7 +73,7 @@ const getPollingState = (
  * Called exclusively by `SeerExplorerChatStateProvider`, which dispatches the
  * derived polling state into context for all consumers.
  */
-export const useSeerExplorerPolling = ({runId}: {runId: number | null}) => {
+export const useSeerExplorerPolling = ({runId}: {runId: SeerExplorerRunId | null}) => {
   const organization = useOrganization({allowNull: true});
   const orgSlug = organization?.slug;
   const errorPollCountRef = useRef(0);
diff --git a/static/app/views/seerExplorer/seerExplorerChatStateContext.tsx b/static/app/views/seerExplorer/seerExplorerChatStateContext.tsx
@@ -10,6 +10,7 @@ import {
 
 import {sessionStorageWrapper} from 'sentry/utils/sessionStorage';
 import {useSeerExplorerPolling} from 'sentry/views/seerExplorer/hooks/useSeerExplorerPolling';
+import type {SeerExplorerRunId} from 'sentry/views/seerExplorer/types';
 
 export type PollingState =
   | 'polling'
@@ -22,24 +23,24 @@ type ChatState = {
 };
 
 type SeerExplorerChatState = {
-  chatStates: Record<number, ChatState>;
-  runId: number | null;
+  chatStates: Record<SeerExplorerRunId, ChatState>;
+  runId: SeerExplorerRunId | null;
 };
 
 type ChatStateAction =
-  | {payload: {polling: PollingState; runId: number}; type: 'set polling'}
-  | {payload: number | null; type: 'set run id'};
+  | {payload: {polling: PollingState; runId: SeerExplorerRunId}; type: 'set polling'}
+  | {payload: SeerExplorerRunId | null; type: 'set run id'};
 
 const RUN_ID_STORAGE_KEY = 'seer-explorer-run-id';
 
-function readRunIdFromStorage(): number | null {
+function readRunIdFromStorage(): SeerExplorerRunId | null {
   const raw = sessionStorageWrapper.getItem(RUN_ID_STORAGE_KEY);
   if (raw === null || raw === 'undefined') {
     return null;
   }
   try {
     const parsed: unknown = JSON.parse(raw);
-    return typeof parsed === 'number' ? parsed : null;
+    return typeof parsed === 'number' || typeof parsed === 'string' ? parsed : null;
   } catch {
     return null;
   }
@@ -121,7 +122,7 @@ function SeerExplorerChatStatePolling({
 }: {
   children: ReactNode;
   dispatch: Dispatch<ChatStateAction>;
-  runId: number | null;
+  runId: SeerExplorerRunId | null;
 }) {
   const {pollingState} = useSeerExplorerPolling({runId});
 
diff --git a/static/app/views/seerExplorer/types.tsx b/static/app/views/seerExplorer/types.tsx
@@ -142,6 +142,8 @@ export type PendingUserInput = {
   input_type: 'file_change_approval' | 'ask_user_question';
 };
 
+export type SeerExplorerRunId = number | string;
+
 export type SeerExplorerResponse = {
   session: {
     blocks: Block[];
@@ -152,4 +154,5 @@ export type SeerExplorerResponse = {
     repo_pr_states?: Record<string, RepoPRState>;
     run_id?: number;
   } | null;
+  sentry_run_id?: string | null;
 };
diff --git a/static/app/views/seerExplorer/useSeerExplorerContext.tsx b/static/app/views/seerExplorer/useSeerExplorerContext.tsx
@@ -19,6 +19,7 @@ import {
 } from 'sentry/views/seerExplorer/components/drawer/useSeerExplorerDrawer';
 import {useSeerExplorerPolling} from 'sentry/views/seerExplorer/hooks/useSeerExplorerPolling';
 import {useSeerExplorerChatState} from 'sentry/views/seerExplorer/seerExplorerChatStateContext';
+import type {SeerExplorerRunId} from 'sentry/views/seerExplorer/types';
 import {useSeerExplorerDeepLink} from 'sentry/views/seerExplorer/utils';
 
 type SeerExplorerSessionState = 'inactive' | 'thinking' | 'done-thinking';
@@ -152,7 +153,7 @@ export function SeerExplorerContextProvider({children}: {children: ReactNode}) {
 
   // Deep link effect while drawer closed (drawer content handles when open)
   const deepLinkCallback = useCallback(
-    (_runId: number) => openSeerExplorerDrawer({runId: _runId}),
+    (_runId: SeerExplorerRunId) => openSeerExplorerDrawer({runId: _runId}),
     [openSeerExplorerDrawer]
   );
 
diff --git a/static/app/views/seerExplorer/utils.tsx b/static/app/views/seerExplorer/utils.tsx
@@ -35,6 +35,7 @@ import {VisualizeFunction} from 'sentry/views/explore/queryParams/visualize';
 import {makeReplaysPathname} from 'sentry/views/explore/replays/pathnames';
 import type {
   Block,
+  SeerExplorerRunId,
   ToolCall,
   ToolLink,
   ToolResult,
@@ -53,7 +54,7 @@ type ToolFormatter = (
 
 export const makeSeerExplorerQueryKey = (
   orgSlug: string,
-  runId: number | null
+  runId: SeerExplorerRunId | null
 ): ApiQueryKey => [
   runId
     ? getApiUrl('/organizations/$organizationIdOrSlug/seer/explorer-chat/$runId/', {
@@ -1067,7 +1068,7 @@ export function useSeerExplorerDeepLink({
   callback,
   enabled = true,
 }: {
-  callback: (runId: number) => void;
+  callback: (runId: SeerExplorerRunId) => void;
   enabled?: boolean;
 }) {
   const location = useLocation();
@@ -1083,12 +1084,10 @@ export function useSeerExplorerDeepLink({
       return;
     }
 
-    const parsedRunId = Number(paramValue);
-    if (!Number.isNaN(parsedRunId)) {
-      const {[RUN_ID_QUERY_PARAM]: _removed, ...restQuery} = location.query ?? {};
-      navigate({...location, query: restQuery}, {replace: true});
-      callback(parsedRunId);
-    }
+    const {[RUN_ID_QUERY_PARAM]: _removed, ...restQuery} = location.query ?? {};
+    navigate({...location, query: restQuery}, {replace: true});
+    const numericRunId = Number(paramValue);
+    callback(Number.isNaN(numericRunId) ? paramValue : numericRunId);
   }, [location, navigate, callback, enabled]);
 }
 
@@ -1105,7 +1104,9 @@ export function getLangfuseUrl(runId: number | string): string {
   return `https://langfuse.getsentry.net/project/clx9kma1k0001iebwrfw4oo0z/sessions/${runId}`;
 }
 
-export function getExplorerFeedbackOptions(runId: number | null): UseFeedbackOptions {
+export function getExplorerFeedbackOptions(
+  runId: SeerExplorerRunId | null
+): UseFeedbackOptions {
   return {
     formTitle: 'Seer Agent Feedback',
     messagePlaceholder: 'How can we make Seer better for you?',
