agora-appbuilder-core 4.1.24-beta.3 → 4.1.25-beta.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agora-appbuilder-core",
-  "version": "4.1.24-beta.3",
+  "version": "4.1.25-beta.1",
   "description": "React Native template for RTE app builder",
   "main": "index.js",
   "files": [

package/template/customization-api/index.ts

@@ -21,7 +21,6 @@ export {customize, $config};
 export * from './action-library';
 export * from './app-state';
 export * from './customEvents';
-export * from './logger';
 export * from './sub-components';
 export * from './typeDefinition';
 export * from './utils';

package/template/defaultConfig.js

@@ -77,8 +77,8 @@ const DefaultConfig = {
   CHAT_ORG_NAME: "",
   CHAT_APP_NAME: "",
   CHAT_URL: "",
-  CLI_VERSION: "3.1.24-beta.3",
-  CORE_VERSION: "4.1.24-beta.3",
+  CLI_VERSION: "3.1.25-beta.1",
+  CORE_VERSION: "4.1.25-beta.1",
   DISABLE_LANDSCAPE_MODE: false,
   STT_AUTO_START: false,
   CLOUD_RECORDING_AUTO_START: false,

package/template/src/auth/AuthProvider.tsx

@@ -137,15 +137,6 @@ const AuthProvider = (props: AuthProviderProps) => {
     }
   }, [store?.token]);
 
-  // A running native app is already authenticated when it receives a URL
-  // event, so there may be no later token change to consume returnTo.
-  useEffect(() => {
-    if (authenticated && returnTo && (isAndroid() || isIOS())) {
-      history.push(returnTo);
-      setReturnTo('');
-    }
-  }, [authenticated, history, returnTo]);
-
   const deepLinkUrl = (link: string | null) => {
     if (link !== null) {
       if (lifecycle?.onDeepLink?.(link)) {

package/template/src/logger/AppBuilderLogger.tsx

@@ -38,8 +38,6 @@ export declare const StatusTypes: {
 
 export type StatusType = (typeof StatusTypes)[keyof typeof StatusTypes];
 
-export type CustomizationLogType = string;
-
 export enum LogSource {
   AgoraSDK = 'Agora-SDK',
   /** Logs related to all features */
@@ -109,7 +107,10 @@ type LogType = {
     | 'recording_delete'
     | 'ban_user';
   [LogSource.Events]: 'CUSTOM_EVENTS' | 'RTM_EVENTS';
-  [LogSource.CustomizationAPI]: CustomizationLogType;
+  [LogSource.CustomizationAPI]:
+    | 'Log'
+    | 'AI_AGENT_CUSTOMIZATION'
+    | 'EXTERNAL_CUSTOMIZATION';
   [LogSource.SDK]: 'Log' | 'Event';
 };
 

package/template/src/subComponents/caption/Transcript.tsx

@@ -40,8 +40,6 @@ import {
   sttTranscriptPanelSearchText,
   sttTranscriptPanelViewLatestText,
 } from '../../../src/language/default-labels/videoCallScreenLabels';
-import {logger, LogSource} from '../../logger/AppBuilderLogger';
-import {TRANSCRIPT_JOURNEY} from './transcriptJourney';
 
 export interface TranscriptProps {
   showHeader?: boolean;
@@ -58,7 +56,6 @@ const Transcript = (props: TranscriptProps) => {
     isSTTActive,
     selectedTranslationLanguage,
     transcriptViewMode,
-    isSTTListenerAdded,
   } = useCaption();
 
   const settingSpokenLanguageLabel = useString(sttSettingSpokenLanguageText)();
@@ -71,39 +68,6 @@ const Transcript = (props: TranscriptProps) => {
 
   const data = meetingTranscript; // Object.entries(transcript);
   console.log('[STT_GLOBAL] meetingTranscript data: ', data);
-  const hasLoggedFirstEntryRef = React.useRef(false);
-  const transcriptEntryCountRef = React.useRef(data.length);
-  transcriptEntryCountRef.current = data.length;
-
-  React.useEffect(() => {
-    logger.log(
-      LogSource.Internals,
-      'TRANSCRIPT',
-      `${TRANSCRIPT_JOURNEY} transcript panel state`,
-      {
-        stage: 'transcript_panel',
-        isSTTActive,
-        listenerRegistered: isSTTListenerAdded,
-        transcriptEntryCount: transcriptEntryCountRef.current,
-      },
-    );
-  }, [isSTTActive, isSTTListenerAdded]);
-
-  React.useEffect(() => {
-    if (data.length > 0 && !hasLoggedFirstEntryRef.current) {
-      hasLoggedFirstEntryRef.current = true;
-      logger.log(
-        LogSource.Internals,
-        'TRANSCRIPT',
-        `${TRANSCRIPT_JOURNEY} first transcript entry available to panel`,
-        {
-          stage: 'transcript_panel_data',
-          outcome: 'success',
-          transcriptEntryCount: data.length,
-        },
-      );
-    }
-  }, [data.length]);
 
   const [showButton, setShowButton] = React.useState(false);
 

package/template/src/subComponents/caption/__tests__/transcriptStreamListener.test.ts

@@ -0,0 +1,47 @@
+import {
+  registerTranscriptStreamListener,
+  removeTranscriptStreamListener,
+  TranscriptStreamEngine,
+} from '../transcriptStreamListener';
+
+describe('transcript stream listener lifecycle', () => {
+  it('tracks and removes a native listener when addListener returns void', () => {
+    const listener = jest.fn();
+    const engine: TranscriptStreamEngine = {
+      addListener: jest.fn(),
+      removeListener: jest.fn(),
+    };
+
+    const registration = registerTranscriptStreamListener(engine, listener);
+
+    expect(registration).toEqual({subscription: null});
+    expect(engine.addListener).toHaveBeenCalledTimes(1);
+    expect(engine.addListener).toHaveBeenCalledWith(
+      'onStreamMessage',
+      listener,
+    );
+
+    removeTranscriptStreamListener(engine, listener, registration, false);
+
+    expect(engine.removeListener).toHaveBeenCalledTimes(1);
+    expect(engine.removeListener).toHaveBeenCalledWith(
+      'onStreamMessage',
+      listener,
+    );
+  });
+
+  it('uses the subscription returned by the web bridge', () => {
+    const listener = jest.fn();
+    const remove = jest.fn();
+    const engine: TranscriptStreamEngine = {
+      addListener: jest.fn(() => ({remove})),
+      removeListener: jest.fn(),
+    };
+
+    const registration = registerTranscriptStreamListener(engine, listener);
+    removeTranscriptStreamListener(engine, listener, registration, true);
+
+    expect(remove).toHaveBeenCalledTimes(1);
+    expect(engine.removeListener).not.toHaveBeenCalled();
+  });
+});

package/template/src/subComponents/caption/transcriptStreamListener.ts

@@ -0,0 +1,50 @@
+export type TranscriptStreamListener = (...args: any[]) => void;
+
+type TranscriptStreamSubscription = {
+  remove: () => void;
+};
+
+export type TranscriptStreamEngine = {
+  addListener: (
+    event: 'onStreamMessage',
+    listener: TranscriptStreamListener,
+  ) => unknown;
+  removeListener: (
+    event: 'onStreamMessage',
+    listener: TranscriptStreamListener,
+  ) => void;
+};
+
+export type TranscriptStreamListenerRegistration = {
+  subscription: TranscriptStreamSubscription | null;
+};
+
+export const registerTranscriptStreamListener = (
+  engine: TranscriptStreamEngine,
+  listener: TranscriptStreamListener,
+): TranscriptStreamListenerRegistration => {
+  const result = engine.addListener('onStreamMessage', listener);
+  const subscription =
+    result &&
+    typeof (result as TranscriptStreamSubscription).remove === 'function'
+      ? (result as TranscriptStreamSubscription)
+      : null;
+
+  // Native Agora returns void from addListener. The registration object is our
+  // platform-independent proof that registration completed successfully.
+  return {subscription};
+};
+
+export const removeTranscriptStreamListener = (
+  engine: TranscriptStreamEngine,
+  listener: TranscriptStreamListener,
+  registration: TranscriptStreamListenerRegistration,
+  web: boolean,
+) => {
+  if (web) {
+    registration.subscription?.remove();
+    return;
+  }
+
+  engine.removeListener('onStreamMessage', listener);
+};

package/template/src/subComponents/caption/useCaption.tsx

@@ -22,6 +22,12 @@ import {useContent, useRtc} from 'customization-api';
 import useStreamMessageUtils from './useStreamMessageUtils';
 import {isWebInternal} from '../../utils/common';
 import {TRANSCRIPT_JOURNEY} from './transcriptJourney';
+import {
+  registerTranscriptStreamListener,
+  removeTranscriptStreamListener,
+  TranscriptStreamEngine,
+  TranscriptStreamListenerRegistration,
+} from './transcriptStreamListener';
 
 // Types
 type GlobalSttState = {
@@ -321,22 +327,20 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
       prevSpeakerRef,
       selectedTranslationLanguageRef,
     });
-  const transcriptListenerSubscriptionRef = React.useRef<{
-    remove: () => void;
-  } | null>(null);
-
-  const handleStreamMessageCallback = React.useCallback(
-    (...args: any[]) => {
-      if (isWebInternal()) {
-        const [uid, data] = args;
-        streamMessageCallback([uid, data]);
-      } else {
-        const [, uid, , data] = args;
-        streamMessageCallback([uid, data]);
-      }
-    },
-    [streamMessageCallback],
-  );
+  const streamMessageCallbackRef = React.useRef(streamMessageCallback);
+  streamMessageCallbackRef.current = streamMessageCallback;
+  const transcriptListenerRegistrationRef =
+    React.useRef<TranscriptStreamListenerRegistration | null>(null);
+
+  const handleStreamMessageCallback = React.useCallback((...args: any[]) => {
+    if (isWebInternal()) {
+      const [uid, data] = args;
+      streamMessageCallbackRef.current([uid, data]);
+    } else {
+      const [, uid, , data] = args;
+      streamMessageCallbackRef.current([uid, data]);
+    }
+  }, []);
 
   // Register once for the lifetime of the active call. Keeping collection in
   // the provider makes it independent of whether caption/transcript UI is open.
@@ -344,7 +348,7 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
     if (
       !$config.ENABLE_STT ||
       !callActive ||
-      transcriptListenerSubscriptionRef.current
+      transcriptListenerRegistrationRef.current
     ) {
       return;
     }
@@ -356,10 +360,11 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
       {stage: 'listener_registration', outcome: 'started'},
     );
     try {
-      transcriptListenerSubscriptionRef.current = RtcEngineUnsafe.addListener(
-        'onStreamMessage',
-        handleStreamMessageCallback,
-      );
+      transcriptListenerRegistrationRef.current =
+        registerTranscriptStreamListener(
+          RtcEngineUnsafe as unknown as TranscriptStreamEngine,
+          handleStreamMessageCallback,
+        );
       setIsSTTListenerAdded(true);
       logger.log(
         LogSource.Internals,
@@ -378,10 +383,9 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
           error: error ?? null,
         },
       );
+      return;
     }
-  }, [RtcEngineUnsafe, callActive, handleStreamMessageCallback]);
 
-  React.useEffect(() => {
     return () => {
       logger.log(
         LogSource.Internals,
@@ -390,19 +394,27 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
         {
           stage: 'listener_cleanup',
           outcome: 'started',
-          listenerReferencePresent: !!transcriptListenerSubscriptionRef.current,
+          listenerRegistered: !!transcriptListenerRegistrationRef.current,
         },
       );
-      transcriptListenerSubscriptionRef.current?.remove();
-      transcriptListenerSubscriptionRef.current = null;
+      if (transcriptListenerRegistrationRef.current) {
+        removeTranscriptStreamListener(
+          RtcEngineUnsafe as unknown as TranscriptStreamEngine,
+          handleStreamMessageCallback,
+          transcriptListenerRegistrationRef.current,
+          isWebInternal(),
+        );
+      }
+      transcriptListenerRegistrationRef.current = null;
+      setIsSTTListenerAdded(false);
       logger.log(
         LogSource.Internals,
         'TRANSCRIPT',
-        `${TRANSCRIPT_JOURNEY} stream listener subscription remove called and local reference cleared`,
+        `${TRANSCRIPT_JOURNEY} stream listener removed and local references cleared`,
         {stage: 'listener_cleanup', outcome: 'completed'},
       );
     };
-  }, []);
+  }, [RtcEngineUnsafe, callActive, handleStreamMessageCallback]);
 
   const flushPendingTranscript = React.useCallback(async () => {
     await flushStreamMessageQueue();
@@ -435,12 +447,17 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
   const updateErrorLabel = useString(sttUpdateError)();
 
   // --- Derived readiness flag for STT ---
+  const localUidReady = !!localUid;
+  const localBotUidReady = !!localBotUid;
+  const rtmJoined = !!hasUserJoinedRTM;
+  const activeCallReady = !!callActive;
+  const roomInfoReady = !!(roomId?.host || roomId?.attendee);
   const sttDepsReady =
-    !!localUid &&
-    !!localBotUid &&
-    !!hasUserJoinedRTM &&
-    !!callActive &&
-    !!(roomId?.host || roomId?.attendee);
+    localUidReady &&
+    localBotUidReady &&
+    rtmJoined &&
+    activeCallReady &&
+    roomInfoReady;
 
   const sttStartGuardRef = React.useRef(false);
   const sttAutoStartGuardRef = React.useRef(false);
@@ -452,27 +469,42 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
   }, [sttDepsReady]);
 
   React.useEffect(() => {
+    const missingDependencies = [
+      !localUidReady && 'localUid',
+      !localBotUidReady && 'localBotUid',
+      !rtmJoined && 'RTM',
+      !activeCallReady && 'activeCall',
+      !roomInfoReady && 'roomInfo',
+      !isSTTListenerAdded && 'streamListener',
+    ].filter(Boolean);
+    const transcriptReady = sttDepsReady && isSTTListenerAdded;
+
     logger.log(
       LogSource.Internals,
       'TRANSCRIPT',
-      `${TRANSCRIPT_JOURNEY} STT readiness changed`,
+      `${TRANSCRIPT_JOURNEY} STT readiness: ${
+        transcriptReady
+          ? 'READY'
+          : `WAITING (missing: ${missingDependencies.join(', ')})`
+      }`,
       {
         stage: 'stt_readiness',
-        outcome: sttDepsReady ? 'ready' : 'waiting',
-        localUidReady: !!localUid,
-        localBotUidReady: !!localBotUid,
-        rtmJoined: !!hasUserJoinedRTM,
-        callActive: !!callActive,
-        roomInfoReady: !!(roomId?.host || roomId?.attendee),
-        listenerRegistered: !!transcriptListenerSubscriptionRef.current,
+        outcome: transcriptReady ? 'ready' : 'waiting',
+        localUidReady,
+        localBotUidReady,
+        rtmJoined,
+        callActive: activeCallReady,
+        roomInfoReady,
+        listenerRegistered: isSTTListenerAdded,
       },
     );
   }, [
-    callActive,
-    hasUserJoinedRTM,
-    localBotUid,
-    localUid,
-    roomId,
+    activeCallReady,
+    isSTTListenerAdded,
+    localBotUidReady,
+    localUidReady,
+    roomInfoReady,
+    rtmJoined,
     sttDepsReady,
   ]);
 
@@ -593,21 +625,22 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
     try {
       setIsLangChangeInProgress(true);
       const result = await start(localBotUidRef.current, newConfig);
+      console.log('[STT] start result: ', result);
       if (result.success) {
         setIsSTTError(false);
         logger.log(
           LogSource.NetworkRest,
           'stt',
-          `${TRANSCRIPT_JOURNEY} STT started successfully`,
-          result.data ?? null,
+          'STT started successfully',
+          result.data,
         );
       } else {
         setIsSTTError(true);
         logger.error(
           LogSource.NetworkRest,
           'stt',
-          `${TRANSCRIPT_JOURNEY} failed to start STT`,
-          result.error ?? null,
+          'Failed to start STT',
+          result.error,
         );
         Toast.show({
           leadingIconName: 'alert',
@@ -624,12 +657,7 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
     } catch (error: any) {
       setIsLangChangeInProgress(false);
       setIsSTTError(true);
-      logger.error(
-        LogSource.NetworkRest,
-        'stt',
-        `${TRANSCRIPT_JOURNEY} STT start error`,
-        error ?? null,
-      );
+      logger.error(LogSource.NetworkRest, 'stt', 'STT start error', error);
       // Show error toast: text1 = translated label, text2 = exception error
       Toast.show({
         leadingIconName: 'alert',
@@ -674,16 +702,16 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
         logger.log(
           LogSource.NetworkRest,
           'stt',
-          `${TRANSCRIPT_JOURNEY} STT updated successfully`,
-          result.data ?? null,
+          'STT updated successfully',
+          result.data,
         );
       } else {
         setIsSTTError(true);
         logger.error(
           LogSource.NetworkRest,
           'stt',
-          `${TRANSCRIPT_JOURNEY} failed to update STT`,
-          result.error ?? null,
+          'Failed to update STT',
+          result.error,
         );
         // Show error toast: text1 = translated label, text2 = API error
         Toast.show({
@@ -701,12 +729,7 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
     } catch (error: any) {
       setIsLangChangeInProgress(false);
       setIsSTTError(true);
-      logger.error(
-        LogSource.NetworkRest,
-        'stt',
-        `${TRANSCRIPT_JOURNEY} STT update error`,
-        error ?? null,
-      );
+      logger.error(LogSource.NetworkRest, 'stt', 'STT update error', error);
       // Show error toast: text1 = translated label, text2 = exception error
       Toast.show({
         leadingIconName: 'alert',
@@ -725,20 +748,10 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
   };
 
   const stopSTTBotSession = React.useCallback(async () => {
-    logger.log(
-      LogSource.Internals,
-      'TRANSCRIPT',
-      `${TRANSCRIPT_JOURNEY} STT stop requested`,
-      {stage: 'stt_stop', localBotUid: localBotUidRef.current ?? null},
-    );
+    console.log('[STT] stopSTTBotSession called');
 
     if (!localBotUidRef.current) {
-      logger.warn(
-        LogSource.Internals,
-        'TRANSCRIPT',
-        `${TRANSCRIPT_JOURNEY} STT stop skipped because bot UID is missing`,
-        {stage: 'stt_stop', outcome: 'skipped'},
-      );
+      console.warn('[STT] Missing botUid for stop');
       return;
     }
 
@@ -754,16 +767,16 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
         logger.log(
           LogSource.NetworkRest,
           'stt',
-          `${TRANSCRIPT_JOURNEY} STT stopped successfully`,
-          result.data ?? null,
+          'STT stopped successfully',
+          result.data,
         );
       } else {
         setIsSTTError(true);
         logger.error(
           LogSource.NetworkRest,
           'stt',
-          `${TRANSCRIPT_JOURNEY} failed to stop STT`,
-          result.error ?? null,
+          'Failed to stop STT',
+          result.error,
         );
       }
     } catch (error) {
@@ -771,8 +784,8 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
       logger.error(
         LogSource.NetworkRest,
         'stt',
-        `${TRANSCRIPT_JOURNEY} error in stopSTTBotSession`,
-        error ?? null,
+        'Error in stopSTTBotSession',
+        error,
       );
     }
   }, [stop]);
@@ -843,29 +856,12 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
         // Queue
         enqueueSttEvent(updatedState, true, targetChange);
 
-        logger.log(
-          LogSource.Internals,
-          'TRANSCRIPT',
-          `${TRANSCRIPT_JOURNEY} local spoken-language state queued`,
-          {
-            stage: 'global_state_queue',
-            outcome: 'queued',
-            spokenLanguage: updatedState.globalSpokenLanguage ?? null,
-            translationTargetCount:
-              updatedState.globalTranslationTargets.length,
-          },
+        console.log(
+          '[STT_GLOBAL] confirmSpokenLanguageChange sent STT_GLOBAL_STATE: ',
+          updatedState,
         );
       } catch (error) {
-        logger.error(
-          LogSource.Internals,
-          'TRANSCRIPT',
-          `${TRANSCRIPT_JOURNEY} local spoken-language state failed`,
-          {
-            stage: 'global_state_queue',
-            outcome: 'failure',
-            error: error ?? null,
-          },
-        );
+        console.log('[STT_GLOBAL] confirmSpokenLanguageChange error: ', error);
       }
     },
     [localUid], // only real dependency
@@ -920,24 +916,15 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
   // Queues all local + remote stt events
   const enqueueSttEvent = React.useCallback(
     (state: GlobalSttState, isLocal: boolean, targetChange?: TargetChange) => {
+      console.log(
+        '[STT_GLOBAL] inside enqueueSttEvent - sttDepsReadyRef flag',
+        sttDepsReadyRef.current,
+      );
       sttEventQueueRef.current.push({
         state,
         isLocal,
         targetChange,
       });
-      logger.log(
-        LogSource.Internals,
-        'TRANSCRIPT',
-        `${TRANSCRIPT_JOURNEY} STT global state queued`,
-        {
-          stage: 'global_state_queue',
-          outcome: 'queued',
-          stateOrigin: isLocal ? 'local' : 'remote',
-          sttEnabled: state.globalSttEnabled,
-          sttDepsReady: sttDepsReadyRef.current,
-          queueSize: sttEventQueueRef.current.length,
-        },
-      );
       if (sttDepsReadyRef.current) {
         processSttEventQueue();
       }
@@ -964,12 +951,7 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
         !globalSttStateRef.current.globalSttEnabled &&
         sttEventQueueRef.current.length === 0
       ) {
-        logger.log(
-          LogSource.Internals,
-          'TRANSCRIPT',
-          `${TRANSCRIPT_JOURNEY} STT auto-start state injected`,
-          {stage: 'global_state_queue', outcome: 'queued'},
-        );
+        console.log('[STT] AUTO_START  injecting auto start state');
 
         sttAutoStartGuardRef.current = true;
 
@@ -996,12 +978,7 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
       const {state: newState, isLocal, targetChange} = item;
       const prevState = globalSttStateRef.current;
       if (isSameState(prevState, newState)) {
-        logger.log(
-          LogSource.Internals,
-          'TRANSCRIPT',
-          `${TRANSCRIPT_JOURNEY} duplicate STT global state skipped`,
-          {stage: 'global_state_queue', outcome: 'skipped'},
-        );
+        console.log('[STT] Skipped duplicate STT_GLOBAL_STATE');
         continue; // no call to processGlobalSttSingleEvent
       }
       const ok = await processGlobalSttSingleEvent(
@@ -1011,22 +988,16 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
       );
       if (!ok) {
         if (isLocal) {
-          logger.warn(
-            LogSource.Internals,
-            'TRANSCRIPT',
-            `${TRANSCRIPT_JOURNEY} local global state update skipped because API failed`,
-            {stage: 'global_state_apply', outcome: 'skipped'},
+          console.warn(
+            '[STT] Skipping local global state update because API failed.',
           );
           continue;
         }
         // A received RTM event is authoritative for the meeting-level state.
         // Failure to provision this participant's bot must not make the UI
         // report that meeting STT is disabled while captions are arriving.
-        logger.warn(
-          LogSource.Internals,
-          'TRANSCRIPT',
-          `${TRANSCRIPT_JOURNEY} remote global state applied after local STT API failure`,
-          {stage: 'global_state_apply', outcome: 'applied_with_api_failure'},
+        console.warn(
+          '[STT] Applying remote global state after local STT API failure.',
         );
       }
       // update global state AFTER processing
@@ -1051,24 +1022,10 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
       const isStopOperation = wasEnabledBefore && !isEnabledNow;
       try {
         if (isStartOperation) {
-          logger.log(
-            LogSource.Internals,
-            'TRANSCRIPT',
-            `${TRANSCRIPT_JOURNEY} STT global state selected start operation`,
-            {
-              stage: 'global_state_operation',
-              outcome: 'started',
-              stateOrigin: isLocal ? 'local' : 'remote',
-            },
-          );
+          console.log('[STT] Remote global STT -> starting session', newState);
           // Start guard starts
           if (sttStartGuardRef.current) {
-            logger.log(
-              LogSource.Internals,
-              'TRANSCRIPT',
-              `${TRANSCRIPT_JOURNEY} STT start skipped by start guard`,
-              {stage: 'global_state_operation', outcome: 'skipped'},
-            );
+            console.log('[STT] Start skipped (already started)');
             return;
           }
           sttStartGuardRef.current = true;
@@ -1139,16 +1096,7 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
           }
           return true;
         } else if (isUpdateOperation) {
-          logger.log(
-            LogSource.Internals,
-            'TRANSCRIPT',
-            `${TRANSCRIPT_JOURNEY} STT global state selected update operation`,
-            {
-              stage: 'global_state_operation',
-              outcome: 'started',
-              stateOrigin: isLocal ? 'local' : 'remote',
-            },
-          );
+          console.log('[STT] Global STT -> updating session', newState);
           const result = await updateSTTBotSession(
             {
               source: [newState.globalSpokenLanguage],
@@ -1212,16 +1160,7 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
           }
           return true;
         } else if (isStopOperation) {
-          logger.log(
-            LogSource.Internals,
-            'TRANSCRIPT',
-            `${TRANSCRIPT_JOURNEY} STT global state selected stop operation`,
-            {
-              stage: 'global_state_operation',
-              outcome: 'started',
-              stateOrigin: isLocal ? 'local' : 'remote',
-            },
-          );
+          console.log('[STT] Global STT -> stopping session', newState);
           await stopSTTBotSession();
           sttStartGuardRef.current = false;
           return true;
@@ -1234,8 +1173,8 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
         logger.error(
           LogSource.Internals,
           'STT',
-          `${TRANSCRIPT_JOURNEY} error handling STT_GLOBAL_STATE event`,
-          error ?? null,
+          'Error handling STT_GLOBAL_STATE event',
+          error,
         );
         return false;
       }
@@ -1247,16 +1186,7 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
   React.useEffect(() => {
     const handleGlobalSTTChange = async (evt: any) => {
       const {payload} = evt || {};
-      logger.log(
-        LogSource.Internals,
-        'TRANSCRIPT',
-        `${TRANSCRIPT_JOURNEY} STT_GLOBAL_STATE event received`,
-        {
-          stage: 'global_state_event',
-          outcome: 'received',
-          payloadPresent: typeof payload === 'string' && payload.length > 0,
-        },
-      );
+      console.log('[STT] STT_GLOBAL_STATE event received: ', evt);
       let newState: GlobalSttState;
       try {
         newState = JSON.parse(payload);
@@ -1264,8 +1194,8 @@ const CaptionProvider: React.FC<CaptionProviderProps> = ({
         logger.error(
           LogSource.Internals,
           'STT',
-          `${TRANSCRIPT_JOURNEY} failed to parse STT_GLOBAL_STATE event payload`,
-          error ?? null,
+          'Failed to parse STT_GLOBAL_STATE event payload',
+          error,
         );
         return;
       }

package/template/src/subComponents/caption/useSTTAPI.tsx

@@ -7,7 +7,6 @@ import {logger, LogSource} from '../../logger/AppBuilderLogger';
 import getUniqueID from '../../utils/getUniqueID';
 import {buildSTTRequestBody, type STTMethod} from './sttRequestBody';
 import {ensureSTTSessionId} from './sttSessionId';
-import {TRANSCRIPT_JOURNEY} from './transcriptJourney';
 
 export interface STTAPIResponse {
   success: boolean;
@@ -100,12 +99,12 @@ const useSTTAPI = (): IuseSTTAPI => {
       });
 
       console.log(
-        `${TRANSCRIPT_JOURNEY} [STT_BOT_SUBSCRIPTION] ${method.toUpperCase()} - Bot UID: ${botUid} will subscribe to User UID: ${ownerUid}`,
+        `[STT_BOT_SUBSCRIPTION] ${method.toUpperCase()} - Bot UID: ${botUid} will subscribe to User UID: ${ownerUid}`,
         {
           method,
           botUid,
           ownerUid,
-          translationConfig: translationConfig ?? null,
+          translationConfig,
         },
       );
       const response = await fetch(`${STT_API_URL}/${method}`, {
@@ -147,10 +146,10 @@ const useSTTAPI = (): IuseSTTAPI => {
         logger.error(
           LogSource.NetworkRest,
           'stt',
-          `${TRANSCRIPT_JOURNEY} STT API Failure - Called ${method}`,
-          errorPayload ?? {message},
+          `STT API Failure - Called ${method}`,
+          errorPayload,
           {
-            responseData: res ?? null,
+            responseData: res,
             httpStatus,
             requestId,
             startReqTs,
@@ -173,9 +172,9 @@ const useSTTAPI = (): IuseSTTAPI => {
       logger.log(
         LogSource.NetworkRest,
         'stt',
-        `${TRANSCRIPT_JOURNEY} STT API Success - Called ${method}`,
+        `STT API Success - Called ${method}`,
         {
-          responseData: res ?? null,
+          responseData: res,
           httpStatus,
           requestId,
           startReqTs,
@@ -195,8 +194,8 @@ const useSTTAPI = (): IuseSTTAPI => {
       logger.error(
         LogSource.NetworkRest,
         'stt',
-        `${TRANSCRIPT_JOURNEY} STT API Failure - Called ${method}`,
-        error ?? null,
+        `STT API Failure - Called ${method}`,
+        error,
         {
           requestId,
           startReqTs,
@@ -236,14 +235,14 @@ const useSTTAPI = (): IuseSTTAPI => {
       logger.log(
         LogSource.NetworkRest,
         'stt',
-        `${TRANSCRIPT_JOURNEY} Retrying STT start after transient failure`,
+        'Retrying STT start after transient failure',
         {
           attempt,
           maxAttempts: STT_START_MAX_ATTEMPTS,
           retryDelayMs,
           botUid,
-          httpStatus: result.httpStatus ?? null,
-          errorCode: result.error?.code ?? null,
+          httpStatus: result.httpStatus,
+          errorCode: result.error?.code,
         },
       );
       await wait(retryDelayMs);

package/template/src/subComponents/caption/useStreamMessageUtils.ts

@@ -3,8 +3,6 @@ import protoRoot from './proto/ptoto';
 import PQueue from 'p-queue';
 import type {CaptionObj, TranscriptItem} from './useCaption';
 import type {LanguageType} from './utils';
-import {logger, LogSource} from '../../logger/AppBuilderLogger';
-import {TRANSCRIPT_JOURNEY} from './transcriptJourney';
 
 type StreamMessageCallback = (args: [number, Uint8Array]) => void;
 type FinalListType = {
@@ -44,29 +42,8 @@ const useStreamMessageUtils = ({
   const finalTranscriptListRef = React.useRef<FinalListType>({});
   const finalTranslationListRef = React.useRef<FinalTranslationListType>({});
   const queue = React.useMemo(() => new PQueue({concurrency: 1}), []);
-  const messagesReceivedRef = React.useRef(0);
-  const messagesProcessedRef = React.useRef(0);
-  const finalizedSegmentsRef = React.useRef(0);
-  const speakersWithFinalizedSegmentsRef = React.useRef(new Set<string>());
 
   const streamMessageCallback: StreamMessageCallback = args => {
-    const [receivedBotUid, receivedPayload] = args;
-    const messageNumber = ++messagesReceivedRef.current;
-    if (messageNumber === 1 || messageNumber % 50 === 0) {
-      logger.log(
-        LogSource.Internals,
-        'TRANSCRIPT',
-        `${TRANSCRIPT_JOURNEY} stream message received`,
-        {
-          stage: 'stream_message_received',
-          outcome: 'success',
-          botUid: receivedBotUid ?? null,
-          payloadByteLength: receivedPayload?.byteLength || 0,
-          messagesReceived: messageNumber,
-          messagesProcessed: messagesProcessedRef.current,
-        },
-      );
-    }
     const queueCallback = (args1: [number, Uint8Array]) => {
       const finalList = finalListRef.current;
       const finalTranscriptList = finalTranscriptListRef.current;
@@ -244,29 +221,11 @@ const useStreamMessageUtils = ({
         finalList[textstream.uid].push(finalText);
         finalTranscriptList[textstream.uid].push(finalText);
         currentFinalText = finalText;
-        const speakerUid = textstream.uid ?? null;
-        const speakerKey = String(speakerUid ?? 'unknown');
-        const isFirstFinalizedSegmentForSpeaker =
-          !speakersWithFinalizedSegmentsRef.current.has(speakerKey);
-        finalizedSegmentsRef.current += 1;
+        // log info to show measure the duration of passes in which a sentence gets finalized
         const duration = performance.now() - captionStartTimeRef.current;
-        if (isFirstFinalizedSegmentForSpeaker) {
-          speakersWithFinalizedSegmentsRef.current.add(speakerKey);
-          logger.log(
-            LogSource.Internals,
-            'TRANSCRIPT',
-            `${TRANSCRIPT_JOURNEY} first transcript segment finalized for speaker`,
-            {
-              stage: 'segment_finalized',
-              outcome: 'success',
-              botUid: botUid ?? null,
-              speakerUid,
-              finalCharacterCount: currentFinalText.length,
-              finalizeDurationMs: duration,
-              finalizedSegments: finalizedSegmentsRef.current,
-            },
-          );
-        }
+        console.log(
+          `stt-Time taken to finalize caption ${currentFinalText}: ${duration}ms`,
+        );
         captionStartTimeRef.current = 0; // Reset start time
       }
 
@@ -405,74 +364,14 @@ const useStreamMessageUtils = ({
     };
     void queue
       .add(() => queueCallback(args))
-      .then(() => {
-        const processedCount = ++messagesProcessedRef.current;
-        if (processedCount === 1 || processedCount % 50 === 0) {
-          logger.log(
-            LogSource.Internals,
-            'TRANSCRIPT',
-            `${TRANSCRIPT_JOURNEY} stream message processed`,
-            {
-              stage: 'stream_message_processed',
-              outcome: 'success',
-              botUid: receivedBotUid ?? null,
-              messagesReceived: messagesReceivedRef.current,
-              messagesProcessed: processedCount,
-              queueSize: queue.size,
-            },
-          );
-        }
-      })
-      .catch(error => {
-        logger.error(
-          LogSource.Internals,
-          'TRANSCRIPT',
-          `${TRANSCRIPT_JOURNEY} failed to process stream message`,
-          {
-            stage: 'stream_message_processing',
-            outcome: 'failure',
-            botUid: receivedBotUid ?? null,
-            messageNumber,
-            messagesReceived: messagesReceivedRef.current,
-            messagesProcessed: messagesProcessedRef.current,
-            error: error ?? null,
-          },
-        );
-      });
+      .then(() => console.log('stt- using pq queue'))
+      .catch(error =>
+        console.error('Failed to process STT stream message', error),
+      );
   };
 
   const flushStreamMessageQueue = React.useCallback(async () => {
-    logger.log(
-      LogSource.Internals,
-      'TRANSCRIPT',
-      `${TRANSCRIPT_JOURNEY} stream queue flush requested`,
-      {
-        stage: 'stream_queue_flush',
-        outcome: 'started',
-        messagesReceived: messagesReceivedRef.current,
-        messagesProcessed: messagesProcessedRef.current,
-        finalizedSegments: finalizedSegmentsRef.current,
-        speakersWithFinalizedSegments:
-          speakersWithFinalizedSegmentsRef.current.size,
-        queueSize: queue.size,
-      },
-    );
     await queue.onIdle();
-    logger.log(
-      LogSource.Internals,
-      'TRANSCRIPT',
-      `${TRANSCRIPT_JOURNEY} stream queue flush completed`,
-      {
-        stage: 'stream_queue_flush',
-        outcome: 'success',
-        messagesReceived: messagesReceivedRef.current,
-        messagesProcessed: messagesProcessedRef.current,
-        finalizedSegments: finalizedSegmentsRef.current,
-        speakersWithFinalizedSegments:
-          speakersWithFinalizedSegmentsRef.current.size,
-        queueSize: queue.size,
-      },
-    );
   }, [queue]);
 
   return {

package/template/customization-api/logger.ts

@@ -1,33 +0,0 @@
-import {
-  CustomizationLogType,
-  LogSource,
-  logger,
-} from '../src/logger/AppBuilderLogger';
-
-export type CustomizationLogLevel = 'debug' | 'info' | 'warn' | 'error';
-export type CustomizationLogData = Record<string, unknown>;
-export type CustomizationLogEvent = {
-  type: CustomizationLogType;
-  event: string;
-  data?: CustomizationLogData;
-  level?: CustomizationLogLevel;
-};
-
-/**
- * Sends a customization event through the active App Builder log transport.
- * The logger adds the current session, room, user, platform, and SDK context.
- * Callers must redact credentials and other sensitive values before logging.
- */
-export const logCustomizationEvent = ({
-  type,
-  event,
-  data,
-  level = 'info',
-}: CustomizationLogEvent) => {
-  if (data) {
-    logger[level](LogSource.CustomizationAPI, type, event, data);
-    return;
-  }
-
-  logger[level](LogSource.CustomizationAPI, type, event);
-};

package/template/src/subComponents/caption/__tests__/transcriptJourney.test.ts

@@ -1,7 +0,0 @@
-import {TRANSCRIPT_JOURNEY} from '../transcriptJourney';
-
-describe('transcript journey logging', () => {
-  it('uses one searchable prefix', () => {
-    expect(TRANSCRIPT_JOURNEY).toBe('[TRANSCRIPT_JOURNEY]');
-  });
-});