feat(seer): Add widget-level LLM context to dashboard widgets

Register each dashboard widget as a child node in the LLM context
tree so the Seer Explorer agent gets per-widget metadata: title,
display type, widget type, query config, and tool-use hints that
map directly to Seer's telemetry_live_search parameters. Big number
widgets also include their fetched data value. Capitalize node type
headings in the backend markdown renderer for readability.

Co-Authored-By: Claude Opus 4.6 <noreply@example.com>

Author: Mihir-Mavalankar

src/sentry/seer/explorer/client_utils.py

@@ -345,7 +345,7 @@ def poll_until_done(
 def _render_node(node: dict[str, Any], depth: int) -> str:
     """Recursively render an LLMContextSnapshot node and its children as markdown."""
     heading = "#" * min(depth + 1, 6)
-    lines = [f"{heading} {node.get('nodeType', 'unknown')}"]
+    lines = [f"{heading} {node.get('nodeType', 'unknown').capitalize()}"]
 
     data = node.get("data")
     if isinstance(data, dict):

static/app/views/dashboards/widgetCard/index.spec.tsx

@@ -1032,3 +1032,48 @@ describe('Dashboards > WidgetCard', () => {
     });
   });
 });
+
+describe('getQueryHint', () => {
+  const {getQueryHint} = require('sentry/views/dashboards/widgetCard');
+
+  it.each([
+    [DisplayType.LINE, 'timeseries'],
+    [DisplayType.AREA, 'timeseries'],
+    [DisplayType.BAR, 'timeseries'],
+  ])('returns timeseries hint for %s', (displayType, expected) => {
+    expect(getQueryHint(displayType)).toContain(expected);
+  });
+
+  it('returns table hint for TABLE', () => {
+    expect(getQueryHint(DisplayType.TABLE)).toContain('table query');
+  });
+
+  it('returns single aggregate hint for BIG_NUMBER', () => {
+    expect(getQueryHint(DisplayType.BIG_NUMBER)).toContain('single aggregate');
+    expect(getQueryHint(DisplayType.BIG_NUMBER)).toContain('value is included below');
+  });
+
+  it('returns table hint as default for unknown types', () => {
+    expect(getQueryHint(DisplayType.WHEEL)).toContain('table query');
+  });
+});
+
+describe('getWidgetData', () => {
+  const {getWidgetData} = require('sentry/views/dashboards/widgetCard');
+
+  it('returns table data for BIG_NUMBER when data is available', () => {
+    const tableData = [{count: 42}];
+    const data = {tableResults: [{title: 'test', data: tableData}]};
+    expect(getWidgetData(DisplayType.BIG_NUMBER, data)).toEqual({data: tableData});
+  });
+
+  it('returns empty object for BIG_NUMBER when no data', () => {
+    expect(getWidgetData(DisplayType.BIG_NUMBER, undefined)).toEqual({});
+  });
+
+  it('returns empty object for non-BIG_NUMBER types even with data', () => {
+    const data = {tableResults: [{title: 'test', data: [{count: 42}]}]};
+    expect(getWidgetData(DisplayType.LINE, data)).toEqual({});
+    expect(getWidgetData(DisplayType.TABLE, data)).toEqual({});
+  });
+});

static/app/views/dashboards/widgetCard/index.tsx

@@ -52,6 +52,8 @@ import {WidgetCardChartContainer} from 'sentry/views/dashboards/widgetCard/widge
 import type {WidgetLegendSelectionState} from 'sentry/views/dashboards/widgetLegendSelectionState';
 import type {TabularColumn} from 'sentry/views/dashboards/widgets/common/types';
 import {Widget} from 'sentry/views/dashboards/widgets/widget/widget';
+import {useLLMContext} from 'sentry/views/seerExplorer/contexts/llmContext';
+import {registerLLMContext} from 'sentry/views/seerExplorer/contexts/registerLLMContext';
 
 import {useDashboardsMEPContext} from './dashboardsMEPContext';
 import {VisualizationWidget} from './visualizationWidget';
@@ -140,13 +142,58 @@ type Data = {
   totalIssuesCount?: string;
 };
 
+/**
+ * Returns a hint for the Seer Explorer agent describing how to re-query this
+ * widget's data using a tool call, if the user wants to dig deeper.
+ */
+export function getQueryHint(displayType: DisplayType): string {
+  switch (displayType) {
+    case DisplayType.LINE:
+    case DisplayType.AREA:
+    case DisplayType.BAR:
+      return 'To dig deeper into this widget, run a timeseries query using y_axes (aggregates) + group_by (columns) + query (conditions)';
+    case DisplayType.TABLE:
+      return 'To dig deeper into this widget, run a table query using fields (aggregates + columns) + query (conditions) + sort (orderby)';
+    case DisplayType.BIG_NUMBER:
+      return 'To dig deeper into this widget, run a single aggregate query using fields (aggregates) + query (conditions); current value is included below';
+    default:
+      return 'To dig deeper into this widget, run a table query using fields (aggregates + columns) + query (conditions)';
+  }
+}
+
+export function getWidgetData(
+  displayType: DisplayType,
+  data: Data | undefined
+): Record<string, unknown> {
+  if (displayType === DisplayType.BIG_NUMBER && data?.tableResults?.[0]) {
+    return {data: data.tableResults[0].data};
+  }
+  return {};
+}
+
 function WidgetCard(props: Props) {
   const [data, setData] = useState<Data>();
   const [isLoadingTextVisible, setIsLoadingTextVisible] = useState(false);
   const navigate = useNavigate();
   const {dashboardId: currentDashboardId} = useParams<{dashboardId: string}>();
   const timeoutRef = useRef<NodeJS.Timeout | null>(null);
 
+  // Push widget metadata into the LLM context tree for Seer Explorer.
+  useLLMContext({
+    title: props.widget.title,
+    displayType: props.widget.displayType,
+    widgetType: props.widget.widgetType,
+    queryHint: getQueryHint(props.widget.displayType),
+    queries: props.widget.queries.map(q => ({
+      name: q.name,
+      conditions: q.conditions,
+      aggregates: q.aggregates,
+      columns: q.columns,
+      orderby: q.orderby,
+    })),
+    ...getWidgetData(props.widget.displayType, data),
+  });
+
   const onDataFetched = (newData: Data) => {
     if (props.onDataFetched) {
       props.onDataFetched({
@@ -435,7 +482,10 @@ function WidgetCard(props: Props) {
   );
 }
 
-export default withApi(withOrganization(withPageFilters(withSentryRouter(WidgetCard))));
+export default registerLLMContext(
+  'widget',
+  withApi(withOrganization(withPageFilters(withSentryRouter(WidgetCard))))
+);
 
 function useOnDemandWarning(props: {widget: TWidget}): string | null {
   const organization = useOrganization();

tests/sentry/seer/explorer/test_client_utils.py

@@ -200,7 +200,7 @@ def test_single_node(self) -> None:
             ],
         }
         result = snapshot_to_markdown(snapshot)
-        assert "# dashboard" in result
+        assert "# Dashboard" in result
         assert '- **title**: "Backend Health"' in result
         assert "- **widgetCount**: 3" in result
 
@@ -228,9 +228,9 @@ def test_nested_nodes(self) -> None:
             ],
         }
         result = snapshot_to_markdown(snapshot)
-        assert "# dashboard" in result
-        assert "## widget" in result
-        assert "### chart" in result
+        assert "# Dashboard" in result
+        assert "## Widget" in result
+        assert "### Chart" in result
         assert '- **query**: "count()"' in result
 
     def test_empty_nodes(self) -> None:
@@ -242,7 +242,7 @@ def test_node_with_no_data(self) -> None:
             "nodes": [{"nodeType": "dashboard", "data": None, "children": []}],
         }
         result = snapshot_to_markdown(snapshot)
-        assert "# dashboard" in result
+        assert "# Dashboard" in result
         assert "not an exact screenshot" in result
 
     def test_node_with_non_dict_data(self) -> None:
@@ -251,5 +251,5 @@ def test_node_with_non_dict_data(self) -> None:
             "nodes": [{"nodeType": "widget", "data": "some string", "children": []}],
         }
         result = snapshot_to_markdown(snapshot)
-        assert "# widget" in result
+        assert "# Widget" in result
         assert '- "some string"' in result