♻️(backend) control metadata collector agent launch via feature flag

Allow controlling when the metadata collector agent is started,
enabling users to try the feature and disable it if needed.

Introduce a user-level feature flag to toggle the agent for the
initial release.

src/backend/core/api/serializers.py

@@ -232,11 +232,14 @@ class RecordingOptions(BaseModel):
             When `None`, falls back to the application default.
         original_mode: The original recording mode before any override.
             Must be one of the valid RecordingModeChoices values when provided.
+        collect_metadata: Whether to collect additional metadata during recording.
+            When `None`, no metadata are collected.
 
     """
 
     language: str | None = None
     transcribe: bool | None = None
+    collect_metadata: bool | None = None
     original_mode: Literal["screen_recording", "transcript"] | None = None
 
     model_config = {"extra": "forbid"}

src/backend/core/api/viewsets.py

@@ -343,8 +343,7 @@ class RoomViewSet(
             )
 
         if settings.METADATA_COLLECTOR_ENABLED and (
-            recording.mode == models.RecordingModeChoices.TRANSCRIPT
-            or recording.options.get("transcribe", False)
+            recording.options.get("collect_metadata", False)
         ):
             try:
                 MetadataCollectorService().start(recording)

src/backend/core/services/livekit_events.py

@@ -178,9 +178,7 @@ class LiveKitEventsService:
         except utils.MetadataUpdateException as e:
             logger.exception("Failed to update room's metadata: %s", e)
 
-        if settings.METADATA_COLLECTOR_ENABLED and recording.options.get(
-            "metadata_collector_dispatch_id"
-        ):
+        if recording.options.get("metadata_collector_dispatch_id", None) is not None:
             try:
                 MetadataCollectorService().stop(recording)
             except MetadataCollectorException:

src/frontend/src/features/analytics/enums.ts

@@ -5,4 +5,5 @@ export enum FeatureFlags {
   noiseReduction = 'noise-reduction',
   subtitles = 'subtitles',
   candidatePolling = 'candidate-polling',
+  metadataCollector = 'metadata-collector',
 }

src/frontend/src/features/recording/components/TranscriptSidePanel.tsx

@@ -32,6 +32,7 @@ import { NoAccessView } from './NoAccessView'
 import { ControlsButton } from './ControlsButton'
 import { RowWrapper } from './RowWrapper'
 import { useMutateRecording } from '../hooks/useMutateRecording'
+import { useIsMetadataCollectorEnabled } from '../hooks/useMetadataCollectorEnabled'
 import { useSidePanel } from '@/features/rooms/livekit/hooks/useSidePanel'
 
 export const TranscriptSidePanel = () => {
@@ -59,6 +60,8 @@ export const TranscriptSidePanel = () => {
     FeatureFlags.Transcript
   )
 
+  const isMetadataCollectorEnabled = useIsMetadataCollectorEnabled()
+
   const roomId = useRoomId()
 
   const { startRecording, isPendingToStart, stopRecording, isPendingToStop } =
@@ -106,6 +109,7 @@ export const TranscriptSidePanel = () => {
             transcribe: true,
             original_mode: RecordingMode.Transcript,
           }),
+          collect_metadata: isMetadataCollectorEnabled,
         }
 
         await startRecording({

src/frontend/src/features/recording/hooks/useMetadataCollectorEnabled.ts

@@ -0,0 +1,10 @@
+import { useFeatureFlagEnabled } from 'posthog-js/react'
+import { useIsAnalyticsEnabled } from '@/features/analytics/hooks/useIsAnalyticsEnabled'
+import { FeatureFlags } from '@/features/analytics/enums'
+
+export const useIsMetadataCollectorEnabled = () => {
+  const featureEnabled = useFeatureFlagEnabled(FeatureFlags.metadataCollector)
+  const isAnalyticsEnabled = useIsAnalyticsEnabled()
+
+  return (featureEnabled && isAnalyticsEnabled) || true
+}