refactor: drop isRecordLike pass-through wrappers and return audioLevels directly

useSpeechToText returns its stable, in-place-filled Float32Array instead of a
nullable ref; MicButton and the composer, search, and user-input props follow.

Author: waleedlatif1

apps/sim/app/o/[organizationId]/home/components/composer/composer.test.tsx

@@ -175,7 +175,7 @@ beforeEach(() => {
   mocks.speech.mockReturnValue({
     isSupported: true,
     isListening: false,
-    audioLevelsRef: { current: new Float32Array(5) },
+    audioLevels: new Float32Array(5),
     toggleListening: mocks.toggleListening,
     resetTranscript: mocks.resetTranscript,
   })

apps/sim/app/o/[organizationId]/home/components/composer/composer.tsx

@@ -249,7 +249,7 @@ export function Composer({
   )
   const voiceControl = voice.isSupported && (
     <MicButton
-      audioLevelsRef={voice.audioLevelsRef}
+      audioLevels={voice.audioLevels}
       isListening={voice.isListening}
       onToggle={voice.toggleListening}
     />

apps/sim/app/o/[organizationId]/search/search.tsx

@@ -88,7 +88,7 @@ function SearchField({ userId, initialValue, onSubmit }: SearchFieldProps) {
       voiceControl={
         voice.isSupported && (
           <MicButton
-            audioLevelsRef={voice.audioLevelsRef}
+            audioLevels={voice.audioLevels}
             isListening={voice.isListening}
             onToggle={voice.toggleListening}
           />

apps/sim/app/workspace/[workspaceId]/home/components/user-input/components/mic-button/mic-button.tsx

@@ -1,6 +1,6 @@
 'use client'
 
-import { memo, type RefObject, useEffect, useRef } from 'react'
+import { memo, useEffect, useRef } from 'react'
 import { Button, cn, Tooltip, usePrefersReducedMotion } from '@sim/emcn'
 import { Mic } from '@sim/emcn/icons'
 
@@ -12,16 +12,16 @@ const WAVEFORM_EASING = 0.24
 
 interface MicButtonProps {
   isListening: boolean
-  audioLevelsRef: RefObject<Float32Array | null>
+  audioLevels: Float32Array
   onToggle: () => void
 }
 
 interface VoiceWaveformProps {
-  audioLevelsRef: RefObject<Float32Array | null>
+  audioLevels: Float32Array
   isListening: boolean
 }
 
-function VoiceWaveform({ audioLevelsRef, isListening }: VoiceWaveformProps) {
+function VoiceWaveform({ audioLevels, isListening }: VoiceWaveformProps) {
   const prefersReducedMotion = usePrefersReducedMotion()
   const barRefs = useRef<Array<SVGLineElement | null>>([])
 
@@ -32,10 +32,8 @@ function VoiceWaveform({ audioLevelsRef, isListening }: VoiceWaveformProps) {
     let animationFrameId = 0
 
     const draw = () => {
-      const levels = audioLevelsRef.current
-
       for (let index = 0; index < WAVEFORM_BAR_COUNT; index++) {
-        const level = levels?.[index] ?? 0
+        const level = audioLevels[index] ?? 0
         const targetHeight =
           WAVEFORM_MIN_HEIGHT +
           Math.sqrt(Math.max(0, level)) * (WAVEFORM_MAX_HEIGHT - WAVEFORM_MIN_HEIGHT)
@@ -53,7 +51,7 @@ function VoiceWaveform({ audioLevelsRef, isListening }: VoiceWaveformProps) {
 
     animationFrameId = window.requestAnimationFrame(draw)
     return () => window.cancelAnimationFrame(animationFrameId)
-  }, [audioLevelsRef, isListening, prefersReducedMotion])
+  }, [audioLevels, isListening, prefersReducedMotion])
 
   return (
     <svg aria-hidden viewBox='0 0 18 18' className='size-[18px] overflow-hidden'>
@@ -81,7 +79,7 @@ function VoiceWaveform({ audioLevelsRef, isListening }: VoiceWaveformProps) {
 
 export const MicButton = memo(function MicButton({
   isListening,
-  audioLevelsRef,
+  audioLevels,
   onToggle,
 }: MicButtonProps) {
   return (
@@ -105,7 +103,7 @@ export const MicButton = memo(function MicButton({
               isListening ? 'scale-100 opacity-100 blur-none' : 'scale-[0.25] opacity-0 blur-[4px]'
             )}
           >
-            <VoiceWaveform audioLevelsRef={audioLevelsRef} isListening={isListening} />
+            <VoiceWaveform audioLevels={audioLevels} isListening={isListening} />
           </span>
           <Mic
             strokeWidth='1.25'

apps/sim/app/workspace/[workspaceId]/home/components/user-input/user-input.tsx

@@ -324,7 +324,7 @@ const UserInputImpl = forwardRef<UserInputHandle, UserInputProps>(function UserI
   }
 
   const {
-    audioLevelsRef,
+    audioLevels,
     isListening,
     isSupported: isSttSupported,
     toggleListening,
@@ -641,7 +641,7 @@ const UserInputImpl = forwardRef<UserInputHandle, UserInputProps>(function UserI
         voiceControl={
           isSttSupported && (
             <MicButton
-              audioLevelsRef={audioLevelsRef}
+              audioLevels={audioLevels}
               isListening={isListening}
               onToggle={toggleListening}
             />

apps/sim/hooks/use-speech-to-text.ts

@@ -1,6 +1,6 @@
 'use client'
 
-import { type RefObject, useCallback, useEffect, useRef, useState } from 'react'
+import { useCallback, useEffect, useRef, useState } from 'react'
 import { createLogger } from '@sim/logger'
 import { isApiClientError } from '@/lib/api/client/errors'
 import { requestJson } from '@/lib/api/client/request'
@@ -57,7 +57,8 @@ interface UseSpeechToTextProps {
 interface UseSpeechToTextReturn {
   isListening: boolean
   isSupported: boolean
-  audioLevelsRef: RefObject<Float32Array | null>
+  /** Live input levels, filled in place while listening; the array identity never changes. */
+  audioLevels: Float32Array
   toggleListening: () => void
   resetTranscript: () => void
 }
@@ -119,8 +120,8 @@ export function useSpeechToText({
   const streamRef = useRef<MediaStream | null>(null)
   const audioContextRef = useRef<AudioContext | null>(null)
   const processorRef = useRef<ScriptProcessorNode | null>(null)
-  const audioLevelsRef = useRef<Float32Array | null>(null)
-  const audioLevels = (audioLevelsRef.current ??= new Float32Array(AUDIO_LEVEL_COUNT))
+  const levelsRef = useRef<Float32Array | null>(null)
+  const audioLevels = (levelsRef.current ??= new Float32Array(AUDIO_LEVEL_COUNT))
 
   const pcmBufferRef = useRef<Float32Array[]>([])
   const sendIntervalRef = useRef<ReturnType<typeof setInterval> | null>(null)
@@ -440,7 +441,7 @@ export function useSpeechToText({
   return {
     isListening,
     isSupported,
-    audioLevelsRef,
+    audioLevels,
     toggleListening,
     resetTranscript,
   }

apps/sim/hooks/use-voice-input.test.tsx

@@ -34,7 +34,7 @@ beforeEach(() => {
   mocks.speech.mockReturnValue({
     isListening: false,
     isSupported: true,
-    audioLevelsRef: { current: new Float32Array(5) },
+    audioLevels: new Float32Array(5),
     toggleListening: vi.fn(),
     resetTranscript: vi.fn(),
   })

packages/sim-cli/src/commands/protocol/workflow-run-get.ts

@@ -39,10 +39,6 @@ interface WorkflowBlock {
   name: string
 }
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return isRecordLike(value)
-}
-
 /**
  * The workflow's blocks, read from its draft graph.
  *
@@ -56,11 +52,12 @@ async function loadWorkflowBlocks(client: SimClient, workflowId: string): Promis
   const raw = await client.request<unknown>(resolvePath(operation.path, { workflowId }), {
     method: operation.method,
   })
-  const state = isRecord(raw) && isRecord(raw.data) ? raw.data : raw
-  const blocks = isRecord(state) && isRecord(state.blocks) ? Object.entries(state.blocks) : []
+  const state = isRecordLike(raw) && isRecordLike(raw.data) ? raw.data : raw
+  const blocks =
+    isRecordLike(state) && isRecordLike(state.blocks) ? Object.entries(state.blocks) : []
   return blocks.map(([key, block]) => ({
-    id: isRecord(block) && typeof block.id === 'string' ? block.id : key,
-    name: isRecord(block) && typeof block.name === 'string' ? block.name : '',
+    id: isRecordLike(block) && typeof block.id === 'string' ? block.id : key,
+    name: isRecordLike(block) && typeof block.name === 'string' ? block.name : '',
   }))
 }
 
@@ -148,7 +145,7 @@ function resolveSelection(
  * matches it.
  */
 function keyByTyped(payload: unknown, typedBy: ReadonlyMap<string, string>): unknown {
-  if (!isRecord(payload) || !isRecord(payload.blockOutputs)) return payload
+  if (!isRecordLike(payload) || !isRecordLike(payload.blockOutputs)) return payload
   const blockOutputs: Record<string, unknown> = {}
   for (const [key, value] of Object.entries(payload.blockOutputs)) {
     blockOutputs[typedBy.get(key) ?? key] = value

packages/testing/src/mocks/human-in-the-loop-manager.mock.ts

@@ -16,14 +16,10 @@ class MockResumeAdmissionError extends Error {
   }
 }
 
-function isMockRecord(value: unknown): value is Record<string, unknown> {
-  return isRecordLike(value)
-}
-
 function isPausedOutputForContext(output: unknown, contextId: string): boolean {
-  if (!isMockRecord(output)) return false
+  if (!isRecordLike(output)) return false
   const metadata = output._pauseMetadata
-  return isMockRecord(metadata) && metadata.contextId === contextId
+  return isRecordLike(metadata) && metadata.contextId === contextId
 }
 
 interface MockAggregationState {
@@ -124,7 +120,7 @@ export const humanInTheLoopManagerMockFns = {
       mergedOutput: Record<string, unknown>
     ): void => {
       for (const scope of Object.values(state.loopExecutions ?? {})) {
-        if (!isMockRecord(scope) || !isMockRecord(scope.currentIterationOutputs)) continue
+        if (!isRecordLike(scope) || !isRecordLike(scope.currentIterationOutputs)) continue
         const outputs = scope.currentIterationOutputs
         const pausedEntry =
           outputs[stateBlockKey] !== undefined
@@ -144,7 +140,7 @@ export const humanInTheLoopManagerMockFns = {
       }
 
       for (const scope of Object.values(state.parallelExecutions ?? {})) {
-        if (!isMockRecord(scope) || !isMockRecord(scope.branchOutputs)) continue
+        if (!isRecordLike(scope) || !isRecordLike(scope.branchOutputs)) continue
         const branches = scope.branchOutputs
         for (const [branchIndex, branchOutputs] of Object.entries(branches)) {
           if (!Array.isArray(branchOutputs)) continue