fix(grafana): list annotations outputs

Author: icecrasher321

apps/sim/tools/grafana/list_annotations.ts

@@ -110,32 +110,34 @@ export const listAnnotationsTool: ToolConfig<
   transformResponse: async (response: Response) => {
     const data = await response.json()
 
+    // Handle potential nested array structure
+    const rawAnnotations = Array.isArray(data) ? data.flat() : []
+
     return {
       success: true,
       output: {
-        annotations: Array.isArray(data)
-          ? data.map((a: any) => ({
-              id: a.id,
-              alertId: a.alertId,
-              alertName: a.alertName,
-              dashboardId: a.dashboardId,
-              dashboardUID: a.dashboardUID,
-              panelId: a.panelId,
-              userId: a.userId,
-              newState: a.newState,
-              prevState: a.prevState,
-              created: a.created,
-              updated: a.updated,
-              time: a.time,
-              timeEnd: a.timeEnd,
-              text: a.text,
-              tags: a.tags || [],
-              login: a.login,
-              email: a.email,
-              avatarUrl: a.avatarUrl,
-              data: a.data,
-            }))
-          : [],
+        annotations: rawAnnotations.map((a: any) => ({
+          id: a.id,
+          dashboardId: a.dashboardId,
+          dashboardUID: a.dashboardUID,
+          created: a.created,
+          updated: a.updated,
+          time: a.time,
+          timeEnd: a.timeEnd,
+          text: a.text,
+          tags: a.tags || [],
+          login: a.login,
+          email: a.email,
+          avatarUrl: a.avatarUrl,
+          data: a.data || {},
+          // Optional fields - only included if they exist in the response
+          ...(a.alertId !== undefined && { alertId: a.alertId }),
+          ...(a.alertName !== undefined && { alertName: a.alertName }),
+          ...(a.panelId !== undefined && { panelId: a.panelId }),
+          ...(a.userId !== undefined && { userId: a.userId }),
+          ...(a.newState !== undefined && { newState: a.newState }),
+          ...(a.prevState !== undefined && { prevState: a.prevState }),
+        })),
       },
     }
   },
@@ -148,12 +150,21 @@ export const listAnnotationsTool: ToolConfig<
         type: 'object',
         properties: {
           id: { type: 'number', description: 'Annotation ID' },
-          text: { type: 'string', description: 'Annotation text' },
-          tags: { type: 'array', description: 'Annotation tags' },
+          dashboardId: { type: 'number', description: 'Dashboard ID' },
+          dashboardUID: { type: 'string', description: 'Dashboard UID' },
+          created: { type: 'number', description: 'Creation timestamp in epoch ms' },
+          updated: { type: 'number', description: 'Last update timestamp in epoch ms' },
           time: { type: 'number', description: 'Start time in epoch ms' },
           timeEnd: { type: 'number', description: 'End time in epoch ms' },
-          dashboardUID: { type: 'string', description: 'Dashboard UID' },
-          panelId: { type: 'number', description: 'Panel ID' },
+          text: { type: 'string', description: 'Annotation text' },
+          tags: { type: 'array', items: { type: 'string' }, description: 'Annotation tags' },
+          login: { type: 'string', description: 'Login of the user who created the annotation' },
+          email: { type: 'string', description: 'Email of the user who created the annotation' },
+          avatarUrl: { type: 'string', description: 'Avatar URL of the user' },
+          data: {
+            type: 'json',
+            description: 'Additional annotation data object from Grafana',
+          },
         },
       },
     },

apps/sim/tools/grafana/types.ts

@@ -267,14 +267,8 @@ export interface GrafanaCreateAnnotationParams extends GrafanaBaseParams {
 
 export interface GrafanaAnnotation {
   id: number
-  alertId: number
-  alertName: string
   dashboardId: number
   dashboardUID: string
-  panelId: number
-  userId: number
-  newState: string
-  prevState: string
   created: number
   updated: number
   time: number
@@ -285,6 +279,13 @@ export interface GrafanaAnnotation {
   email: string
   avatarUrl: string
   data: any
+  // Optional fields - only present for alert annotations or specific cases
+  alertId?: number
+  alertName?: string
+  panelId?: number
+  userId?: number
+  newState?: string
+  prevState?: string
 }
 
 export interface GrafanaCreateAnnotationResponse extends ToolResponse {