feat(opentrons-ai-client, opentrons-ai-server): content field (#19080)

# Overview
Closes AUTH-2159

This PR addresses the handling of file attachments in the multipart
upload flow by restructuring how files are managed between the frontend
and backend. The primary focus is fixing the `content` field for file
attachments.

This field is essential for maintaining chat history, enabling users to
reference files across multi-turn conversations. Currently, the chat
system can only process files on a per-message basis. While users can
attach a file and ask a question about it in a single message, the
system loses context in subsequent turns. This happens because the
frontend only sends files attached to the current message, rather than
maintaining file references throughout the conversation history.

File attachments persist across the entire conversation, allowing for
more natural multi-turn interactions with uploaded files.

## Test Plan and Hands on Testing

CI

## Review requests
Multi-turn conversations with files: Upload pdf, csv, or python then ask
questions.

## Risk assessment

Mid

Author: Elyorcv

opentrons-ai-client/src/analytics/constants.ts

@@ -0,0 +1,28 @@
+export const ANALYTICS = {
+  // App lifecycle
+  APP_OPEN: 'appOpen',
+
+  // Authentication
+  USER_LOGIN: 'user-login',
+  USER_LOGOUT: 'user-logout',
+
+  // Chat interactions
+  CHAT_SUBMITTED: 'chat-submitted',
+  SUBMIT_PROMPT: 'submit-prompt',
+
+  // Protocol actions
+  GENERATED_PROTOCOL: 'generated-protocol',
+  REGENERATE_PROTOCOL: 'regenerate-protocol',
+  DOWNLOAD_PROTOCOL: 'download-protocol',
+  COPY_PROTOCOL: 'copy-protocol',
+
+  // Navigation
+  CREATE_NEW_PROTOCOL: 'create-new-protocol',
+  UPDATE_PROTOCOL: 'update-protocol',
+  GO_TO_CHAT: 'go-to-chat',
+
+  // Feedback
+  FEEDBACK_SENT: 'feedback-sent',
+} as const
+
+export type AnalyticsTrackEvent = typeof ANALYTICS[keyof typeof ANALYTICS]

opentrons-ai-client/src/molecules/FeedbackModal/__tests__/FeedbackModal.test.tsx

@@ -2,6 +2,7 @@ import { fireEvent, screen, waitFor } from '@testing-library/react'
 import { beforeEach, describe, expect, it, vi } from 'vitest'
 
 import { renderWithProviders } from '/ai-client/__testing-utils__'
+import { ANALYTICS } from '/ai-client/analytics/constants'
 import { feedbackModalAtom } from '/ai-client/resources/atoms'
 
 import { FeedbackModal } from '..'
@@ -21,6 +22,9 @@ vi.mock('/ai-client/hooks/useTrackEvent', () => ({
 vi.mock('/ai-client/resources/hooks', () => ({
   useApiCall: () => ({
     callApi: mockCallApi,
+    error: null,
+    isLoading: false,
+    data: { success: true },
   }),
 }))
 
@@ -77,7 +81,7 @@ describe('FeedbackModal', () => {
     // Then wait for the tracking event to be triggered
     await waitFor(() => {
       expect(mockUseTrackEvent).toHaveBeenCalledWith({
-        name: 'feedback-sent',
+        name: ANALYTICS.FEEDBACK_SENT,
         properties: {
           feedback: 'This is a test feedback',
         },

opentrons-ai-client/src/molecules/FeedbackModal/index.tsx

@@ -1,9 +1,11 @@
-import { useState } from 'react'
+import { useEffect, useState } from 'react'
 import { useTranslation } from 'react-i18next'
 import { useAtom } from 'jotai'
 
 import {
   ALIGN_FLEX_END,
+  COLORS,
+  DIRECTION_COLUMN,
   Flex,
   InputField,
   Modal,
@@ -13,6 +15,7 @@ import {
   StyledText,
 } from '@opentrons/components'
 
+import { ANALYTICS } from '/ai-client/analytics/constants'
 import { feedbackModalAtom, tokenAtom } from '/ai-client/resources/atoms'
 import {
   LOCAL_FEEDBACK_END_POINT,
@@ -31,51 +34,57 @@ export function FeedbackModal(): JSX.Element {
   const [feedbackValue, setFeedbackValue] = useState<string>('')
   const [, setShowFeedbackModal] = useAtom(feedbackModalAtom)
   const [token] = useAtom(tokenAtom)
-  const { callApi } = useApiCall()
+  const { callApi, error, isLoading, data } = useApiCall()
+  const [isSubmitting, setIsSubmitting] = useState<boolean>(false)
 
   const handleSendFeedback = async (): Promise<void> => {
-    try {
-      const headers = {
-        Authorization: `Bearer ${token}`,
-        'Content-Type': 'application/json',
-      }
+    const headers = {
+      Authorization: `Bearer ${token}`,
+      'Content-Type': 'application/json',
+    }
 
-      const getEndpoint = (): string => {
-        switch (process.env.NODE_ENV) {
-          case 'production':
-            return PROD_FEEDBACK_END_POINT
-          case 'development':
-            return LOCAL_FEEDBACK_END_POINT
-          default:
-            return STAGING_FEEDBACK_END_POINT
-        }
+    const getEndpoint = (): string => {
+      switch (process.env.NODE_ENV) {
+        case 'production':
+          return PROD_FEEDBACK_END_POINT
+        case 'development':
+          return LOCAL_FEEDBACK_END_POINT
+        default:
+          return STAGING_FEEDBACK_END_POINT
       }
+    }
 
-      const url = getEndpoint()
+    const url = getEndpoint()
 
-      const config = {
-        url,
-        method: 'POST',
-        headers,
-        data: {
-          feedbackText: feedbackValue,
-          fake: false,
-        },
-      }
-      await callApi(config as AxiosRequestConfig)
-      trackEvent({
-        name: 'feedback-sent',
-        properties: {
-          feedback: feedbackValue,
-        },
-      })
-      setShowFeedbackModal(false)
-    } catch (err: any) {
-      console.error(`error: ${err.message}`)
-      throw err
+    const config = {
+      url,
+      method: 'POST',
+      headers,
+      data: {
+        feedbackText: feedbackValue,
+        fake: false,
+      },
     }
+    setIsSubmitting(true)
+    await callApi(config as AxiosRequestConfig)
   }
 
+  useEffect(() => {
+    if (isSubmitting && !isLoading) {
+      if (!error && data) {
+        // Success - track event and close modal
+        trackEvent({
+          name: ANALYTICS.FEEDBACK_SENT,
+          properties: {
+            feedback: feedbackValue,
+          },
+        })
+        setShowFeedbackModal(false)
+      }
+      setIsSubmitting(false)
+    }
+  }, [isSubmitting, isLoading, error, data, feedbackValue])
+
   return (
     <Modal
       title={t(`send_feedback_to_opentrons`)}
@@ -98,7 +107,7 @@ export function FeedbackModal(): JSX.Element {
             </StyledText>
           </SecondaryButton>
           <PrimaryButton
-            disabled={feedbackValue === ''}
+            disabled={feedbackValue === '' || isLoading}
             onClick={async () => {
               await handleSendFeedback()
             }}
@@ -110,14 +119,21 @@ export function FeedbackModal(): JSX.Element {
         </Flex>
       }
     >
-      <InputField
-        title={t(`send_feedback_input_title`)}
-        size="medium"
-        value={feedbackValue}
-        onChange={event => {
-          setFeedbackValue(event.target.value as string)
-        }}
-      ></InputField>
+      <Flex flexDirection={DIRECTION_COLUMN} gridGap={SPACING.spacing16}>
+        {error && (
+          <StyledText desktopStyle="bodyDefaultRegular" color={COLORS.red50}>
+            {error}
+          </StyledText>
+        )}
+        <InputField
+          title={t(`send_feedback_input_title`)}
+          size="medium"
+          value={feedbackValue}
+          onChange={event => {
+            setFeedbackValue(event.target.value as string)
+          }}
+        />
+      </Flex>
     </Modal>
   )
 }