@alia.onl/sdk 4.0.1 → 5.0.0

package/CHANGELOG.md

@@ -0,0 +1,96 @@
+# @alia.onl/sdk
+
+## 5.0.0
+
+### Breaking
+
+- **Voice is now an injected capability on `AliaChatScreen` and
+  `AliaChatSheet`.** Pass `voiceSession={VoiceSession}` (from
+  `@alia.onl/sdk/voice`) to offer voice calls; without it the chat is text-only
+  and the microphone button is not rendered.
+
+  ```tsx
+  import { AliaChatScreen } from '@alia.onl/sdk';
+  import { VoiceSession } from '@alia.onl/sdk/voice';
+
+  <AliaChatScreen voiceSession={VoiceSession} />;
+  ```
+
+  `voiceSession` may be a `React.lazy` component — the chat renders it inside
+  its own `Suspense` boundary.
+
+  v4.0.0 moved the voice exports out of the root barrel so that text-chat
+  consumers would stop compiling `livekit-client`, but `AliaChatContent` still
+  imported `useVoiceRoom` and `useAudioLevelMonitor` directly from their
+  modules, and `AliaChatScreen`/`AliaChatSheet` reach it. Since this package
+  ships raw source, that put the whole LiveKit client (1,204,825 bytes raw,
+  ~250 KiB gzip) back into every text-chat consumer's module graph. The split
+  could not be made real while the shell owned voice, so it no longer does.
+
+### Added
+
+- `VoiceSession` (`@alia.onl/sdk/voice`) — the LiveKit half of the chat as one
+  component. It dials on mount, ends the call on unmount, renders
+  `VoiceControls`, and reports room state, agent state, audio amplitude, and the
+  transcript back to the chat shell.
+- `VoiceSessionComponent`, `VoiceSessionProps`, and `VoiceSessionState` types,
+  exported from both entries.
+
+### Fixed
+
+- An unexpected room drop now always ends voice mode. It previously required a
+  non-empty pre-call transcript, so a dropped call in a fresh chat left the
+  voice UI up with no room behind it.
+
+### Internal
+
+- `bun run --filter @alia.onl/sdk check:entries` walks the real import graph and
+  fails if the root entry can reach `livekit-client` (or if the voice entry
+  cannot). Wired into CI alongside a new SDK typecheck step.
+
+## 4.1.0
+
+### Changed
+
+- Every `lucide-react-native` import is now a per-icon subpath
+  (`lucide-react-native/icons/<name>`) instead of the package barrel, and the
+  dependency moved from `^0.562.0` to `^1.24.0` (the first line that exposes
+  `./icons/*` in its `exports` map, with per-icon type declarations).
+
+  The barrel statically re-exports ~1750 icon modules and Metro does not
+  tree-shake, so a single named import pulled roughly 1.2 MB of unused icon
+  source into every consumer bundle. Measured with a real Metro build of the
+  same eight icons: 1755 modules / 1 656 869 bytes via the barrel versus
+  16 modules / 18 312 bytes via subpaths.
+
+- **Consumers must enable Metro's package-exports resolution.** Set
+  `resolver.unstable_enablePackageExports = true` in `metro.config.js`. It is
+  the default in Expo SDK 53+ and Metro 0.82+, so most projects already have
+  it. Without it the bundle fails at build time with
+  `Unable to resolve module lucide-react-native/icons/…` — a loud failure, not
+  a silent runtime one.
+
+The public API is unchanged: no icon is re-exported from `.` or `./voice`, and
+no exported component, hook, or type was added, removed, or renamed.
+
+## 4.0.1
+
+- Expose `./package.json` in the `exports` map.
+
+## 4.0.0
+
+### Breaking
+
+- The voice surface moved from the root entry to `@alia.onl/sdk/voice` so
+  text-chat consumers no longer pull `livekit-client` through the export
+  barrel. Update imports of `AudioWaveVisualizer`, `VoiceOverlay`,
+  `VoiceControls`, `useVoiceRoom`, `useAudioLevelMonitor`, `useAudioLevels`,
+  `useAmbientWave`, `useSoundEffects`, `useVoiceSoundEffects`, and the
+  `RoomState` / `AgentState` / `VoiceMessage` / `VoiceToolInvocation` types.
+
+  Note that rendering `AliaChatScreen` or `AliaChatSheet` still reaches
+  `livekit-client`: `AliaChatContent` imports `useVoiceRoom` and
+  `useAudioLevelMonitor` directly. Only consumers composing the leaf
+  primitives themselves avoid it.
+- An `exports` map was introduced, so deep imports into package internals no
+  longer resolve. Only `.`, `./voice`, and `./package.json` are public.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alia.onl/sdk",
-  "version": "4.0.1",
+  "version": "5.0.0",
   "description": "Alia AI chat SDK — reusable chat UI, voice, and streaming components for Oxy apps",
   "main": "src/index.ts",
   "react-native": "src/index.ts",
@@ -13,12 +13,17 @@
   },
   "files": [
     "src",
-    "tsconfig.json"
+    "tsconfig.json",
+    "CHANGELOG.md"
   ],
   "private": false,
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "check:entries": "node scripts/check-entry-isolation.mjs"
+  },
   "dependencies": {
     "@radix-ui/react-dropdown-menu": "^2.1.20",
     "@radix-ui/react-icons": "^1.3.2",
@@ -27,7 +32,7 @@
     "@tanstack/react-query-persist-client": "^5.101.2",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react-native": "^0.562.0",
+    "lucide-react-native": "^1.24.0",
     "react-native-markdown-display": "^7.0.2",
     "tailwind-merge": "^3.6.0",
     "zeego": "^3.0.6",
@@ -36,7 +41,7 @@
   "peerDependencies": {
     "react": "^19.2.3",
     "react-native": "^0.86.0",
-    "@oxyhq/services": "^20.0.0",
+    "@oxyhq/services": "^23.0.1",
     "@react-native-async-storage/async-storage": "^2.2.0",
     "socket.io-client": "^4.8.3",
     "expo-font": "^57.0.0",

package/src/components/AliaChatContent.tsx

@@ -1,12 +1,14 @@
 /**
  * Shared chat content component used by both AliaChatSheet and AliaChatScreen.
  *
- * Owns all chat + voice state internally. Containers only handle
- * layout chrome (sheet modal, full-screen SafeAreaView) and pass a `header`
- * render prop that receives the live mark state.
+ * Owns the text chat; voice is an injected capability (`voiceSession`) so that
+ * nothing here reaches `livekit-client` at module-evaluation time. Containers
+ * only handle layout chrome (sheet modal, full-screen SafeAreaView) and pass a
+ * `header` render prop that receives the live mark state.
  */
 
 import React, {
+  Suspense,
   useState,
   useCallback,
   useEffect,
@@ -16,21 +18,22 @@ import React, {
 import { View, StyleSheet } from 'react-native';
 import { useSharedValue } from 'react-native-reanimated';
 import type { SharedValue } from 'react-native-reanimated';
-import { Volume2 } from 'lucide-react-native';
+import Volume2 from 'lucide-react-native/icons/volume-2';
 import { useAliaChat, type UseAliaChatOptions } from '../hooks/useAliaChat';
-import { useVoiceRoom } from '../hooks/useVoiceRoom';
-import { useAudioLevelMonitor } from '../hooks/useAudioLevelMonitor';
-import { useAudioLevels } from '../hooks/useAudioLevels';
 import { useTTS } from '../hooks/useTTS';
 import { useAmbientWave } from '../hooks/useAmbientWave';
 import { VoiceOverlay } from './voice/VoiceOverlay';
-import { VoiceControls } from './voice/VoiceControls';
 import { AliaChatMessageList } from './AliaChatMessageList';
 import { AliaWelcomeMessage, type WelcomeSuggestion } from './AliaWelcomeMessage';
 import { PromptInput } from './ui/prompt-input/prompt-input';
 import { Button } from './ui/button';
 import type { AliaMarkState } from './AliaMark';
-import type { ChatMessage, VoiceMessage } from '../types';
+import type {
+  ChatMessage,
+  VoiceMessage,
+  VoiceSessionComponent,
+  VoiceSessionState,
+} from '../types';
 import type { Completion } from './ui/prompt-input/context';
 
 export interface AliaChatContentProps {
@@ -64,6 +67,12 @@ export interface AliaChatContentProps {
   primaryColor?: string;
   /** Dark-mode flag — forwarded to the ambient wave overlay. */
   isDarkMode?: boolean;
+  /**
+   * Voice capability — pass `VoiceSession` from `@alia.onl/sdk/voice` to offer
+   * voice calls. Omitted, the chat is text-only and no LiveKit code is reachable
+   * from this module. May be a `React.lazy` component.
+   */
+  voiceSession?: VoiceSessionComponent;
 }
 
 /** Adapt a voice message into the chat message format. */
@@ -100,6 +109,7 @@ export function AliaChatContent({
   header,
   primaryColor,
   isDarkMode,
+  voiceSession: VoiceSession,
 }: AliaChatContentProps) {
   // ── Chat ──
   const chatOptions: UseAliaChatOptions = { apiUrl, model, clientContext };
@@ -119,60 +129,36 @@ export function AliaChatContent({
   const internalScrollOffsetY = useSharedValue(0);
   const scrollOffsetY = externalScrollOffsetY ?? internalScrollOffsetY;
 
-  // ── Voice room ──
-  const voiceRoom = useVoiceRoom({ apiUrl });
-  const { captureLevel, playbackLevel } = useAudioLevelMonitor(voiceRoom.room, voiceRoom.isConnected);
-  const { waveAmplitude } = useAudioLevels({
-    captureLevel,
-    playbackLevel,
-    agentState: voiceRoom.agentState,
-    isConnected: voiceRoom.isConnected,
-  });
-
   // ── TTS ──
   const tts = useTTS({ apiUrl });
 
   // ── Voice mode state ──
+  // `isVoiceActive` mounts the session; `voiceState` is what the session reports
+  // back, and stays null until the call is under way.
   const [isVoiceActive, setIsVoiceActive] = useState(false);
+  const [voiceState, setVoiceState] = useState<VoiceSessionState | null>(null);
   const textSnapshotRef = useRef<ChatMessage[]>([]);
 
   // Merge voice messages into chat messages
+  const voiceMessages = voiceState?.messages;
   useEffect(() => {
-    if (!isVoiceActive) return;
-    const adapted = voiceRoom.messages.map(adaptVoiceMessage);
-    setMessages([...textSnapshotRef.current, ...adapted]);
-  }, [voiceRoom.messages, isVoiceActive, setMessages]);
-
-  // Auto-deactivate on error
-  useEffect(() => {
-    if (!isVoiceActive) return;
-    if (voiceRoom.error) {
-      deactivateVoice();
-    } else if (voiceRoom.roomState === 'error') {
-      deactivateVoice();
-    }
-  }, [voiceRoom.error, voiceRoom.roomState, isVoiceActive]);
-
-  // Auto-deactivate on unexpected disconnection
-  useEffect(() => {
-    if (!isVoiceActive) return;
-    if (voiceRoom.roomState === 'disconnected' && textSnapshotRef.current.length > 0) {
-      deactivateVoice();
-    }
-  }, [voiceRoom.roomState, isVoiceActive]);
+    if (!voiceMessages) return;
+    setMessages([...textSnapshotRef.current, ...voiceMessages.map(adaptVoiceMessage)]);
+  }, [voiceMessages, setMessages]);
 
   const activateVoice = useCallback(() => {
-    if (isVoiceActive || voiceRoom.roomState === 'connecting') return;
+    if (isVoiceActive) return;
     textSnapshotRef.current = [...messages];
     setIsVoiceActive(true);
-    voiceRoom.connect();
-  }, [isVoiceActive, voiceRoom, messages]);
+  }, [isVoiceActive, messages]);
 
+  // Unmounting the session disconnects the room; the transcript merged above
+  // stays in the chat.
   const deactivateVoice = useCallback(() => {
-    voiceRoom.disconnect();
     setIsVoiceActive(false);
+    setVoiceState(null);
     textSnapshotRef.current = [];
-  }, [voiceRoom]);
+  }, []);
 
   // ── TTS read aloud handler ──
   const handleReadAloud = useCallback(
@@ -183,10 +169,11 @@ export function AliaChatContent({
   );
 
   // ── Mark state (drives the header brand mark) ──
+  const voiceAgentState = voiceState?.agentState;
   const markState = useMemo<AliaMarkState>(() => {
     if (isVoiceActive) {
-      if (voiceRoom.agentState === 'speaking') return 'writing';
-      if (voiceRoom.agentState === 'thinking') return 'thinking';
+      if (voiceAgentState === 'speaking') return 'writing';
+      if (voiceAgentState === 'thinking') return 'thinking';
       return 'idle';
     }
     if (!isStreaming) return 'idle';
@@ -195,7 +182,7 @@ export function AliaChatContent({
       return 'working';
     if (lastMsg?.thinking) return 'thinking';
     return 'writing';
-  }, [messages, isStreaming, isVoiceActive, voiceRoom.agentState]);
+  }, [messages, isStreaming, isVoiceActive, voiceAgentState]);
 
   const welcomeComponent = useMemo(() => {
     if (!welcomeGreeting || messages.length > 0) return undefined;
@@ -211,29 +198,32 @@ export function AliaChatContent({
 
   // ── Ambient wave — one persistent overlay across idle/voice/TTS/STT ──
   const wave = useAmbientWave({
-    voice: {
-      isActive: isVoiceActive,
-      isConnected: voiceRoom.isConnected,
-      agentState: voiceRoom.agentState,
-      waveAmplitude,
-    },
+    voice: voiceState
+      ? {
+          isActive: isVoiceActive,
+          isConnected: voiceState.isConnected,
+          agentState: voiceState.agentState,
+          waveAmplitude: voiceState.waveAmplitude,
+        }
+      : undefined,
     isTTSPlaying: tts.playbackState === 'playing',
     ttsWaveAmplitude: tts.ttsWaveAmplitude,
     isGenerating: isStreaming,
   });
 
-  // ── Voice activate button for empty submit ──
+  // ── Voice activate button for empty submit (only if voice was provided) ──
   const voiceActivateButton = useMemo(
-    () => (
-      <Button
-        size="icon"
-        onPress={activateVoice}
-        className="h-8 w-8 rounded-full"
-      >
-        <Volume2 size={16} color="white" />
-      </Button>
-    ),
-    [activateVoice],
+    () =>
+      VoiceSession ? (
+        <Button
+          size="icon"
+          onPress={activateVoice}
+          className="h-8 w-8 rounded-full"
+        >
+          <Volume2 size={16} color="white" />
+        </Button>
+      ) : undefined,
+    [VoiceSession, activateVoice],
   );
 
   return (
@@ -269,20 +259,15 @@ export function AliaChatContent({
       />
 
       {/* Input or Voice Controls */}
-      {isVoiceActive ? (
-        <VoiceControls
-          roomState={voiceRoom.roomState}
-          agentState={voiceRoom.agentState}
-          isMuted={voiceRoom.isMuted}
-          cohostActive={voiceRoom.cohostActive}
-          currentSpeaker={voiceRoom.currentSpeaker}
-          roundComplete={voiceRoom.roundComplete}
-          onToggleMute={voiceRoom.toggleMute}
-          onEnableCohost={voiceRoom.enableCohost}
-          onDisableCohost={voiceRoom.disableCohost}
-          onContinueCohost={voiceRoom.continueCohost}
-          onEnd={deactivateVoice}
-        />
+      {VoiceSession && isVoiceActive ? (
+        /* Suspense so the session may be handed to us as a React.lazy import. */
+        <Suspense fallback={null}>
+          <VoiceSession
+            apiUrl={apiUrl}
+            onStateChange={setVoiceState}
+            onEnd={deactivateVoice}
+          />
+        </Suspense>
       ) : (
         <View style={styles.inputContainer}>
           <PromptInput

package/src/components/AliaChatMessageList.tsx

@@ -11,15 +11,13 @@ import Animated, {
   cancelAnimation,
   type SharedValue,
 } from 'react-native-reanimated';
-import {
-  Copy,
-  Check,
-  Volume2,
-  Square,
-  ThumbsUp,
-  ThumbsDown,
-  Pencil,
-} from 'lucide-react-native';
+import Copy from 'lucide-react-native/icons/copy';
+import Check from 'lucide-react-native/icons/check';
+import Volume2 from 'lucide-react-native/icons/volume-2';
+import Square from 'lucide-react-native/icons/square';
+import ThumbsUp from 'lucide-react-native/icons/thumbs-up';
+import ThumbsDown from 'lucide-react-native/icons/thumbs-down';
+import Pencil from 'lucide-react-native/icons/pencil';
 import { Text } from './ui/text';
 import { AliaMarkdown } from './Markdown';
 import { ThinkingIndicator } from './ThinkingIndicator';

package/src/components/AliaChatScreen.tsx

@@ -11,6 +11,10 @@
  *   headerLeft={<BackButton />}
  * />
  * ```
+ *
+ * Voice is opt-in — pass `voiceSession={VoiceSession}` from
+ * `@alia.onl/sdk/voice` to offer calls. Without it the screen is text-only and
+ * `livekit-client` never enters the bundle.
  */
 
 import React from 'react';
@@ -19,6 +23,7 @@ import { useSafeAreaInsets } from 'react-native-safe-area-context';
 import { AliaChatContent } from './AliaChatContent';
 import { AliaMark } from './AliaMark';
 import type { WelcomeSuggestion } from './AliaWelcomeMessage';
+import type { VoiceSessionComponent } from '../types';
 
 export interface AliaChatScreenProps {
   /** App context injected into system prompt */
@@ -41,6 +46,8 @@ export interface AliaChatScreenProps {
   primaryColor?: string;
   /** Dark-mode flag — forwarded to the ambient wave overlay. */
   isDarkMode?: boolean;
+  /** Voice capability — `VoiceSession` from `@alia.onl/sdk/voice`. */
+  voiceSession?: VoiceSessionComponent;
 }
 
 export function AliaChatScreen({
@@ -54,6 +61,7 @@ export function AliaChatScreen({
   welcomeSuggestions,
   primaryColor,
   isDarkMode,
+  voiceSession,
 }: AliaChatScreenProps) {
   const insets = useSafeAreaInsets();
 
@@ -68,6 +76,7 @@ export function AliaChatScreen({
         welcomeSuggestions={welcomeSuggestions}
         primaryColor={primaryColor}
         isDarkMode={isDarkMode}
+        voiceSession={voiceSession}
         header={({ markState, hasMessages, clear }) => (
           <View className="flex-row items-center justify-between px-4 py-3">
             <View className="flex-row items-center gap-2.5">

package/src/components/AliaChatSheet.tsx

@@ -32,6 +32,7 @@ import { useSafeAreaInsets } from 'react-native-safe-area-context';
 import { AliaChatContent } from './AliaChatContent';
 import { AliaMark } from './AliaMark';
 import type { WelcomeSuggestion } from './AliaWelcomeMessage';
+import type { VoiceSessionComponent } from '../types';
 
 const { height: SCREEN_HEIGHT } = Dimensions.get('window');
 
@@ -58,6 +59,12 @@ export interface AliaChatSheetProps {
   primaryColor?: string;
   /** Dark-mode flag — forwarded to the ambient wave overlay (defaults to the sheet's own color scheme). */
   isDarkMode?: boolean;
+  /**
+   * Voice capability — pass `VoiceSession` from `@alia.onl/sdk/voice` to offer
+   * voice calls. Omitted, the sheet is text-only and `livekit-client` never
+   * enters the bundle.
+   */
+  voiceSession?: VoiceSessionComponent;
 }
 
 export interface AliaChatSheetRef {
@@ -66,7 +73,7 @@ export interface AliaChatSheetRef {
 }
 
 export const AliaChatSheet = forwardRef<AliaChatSheetRef, AliaChatSheetProps>(
-  ({ clientContext, model, apiUrl, welcomeGreeting, welcomeSubtitle, welcomeSuggestions, primaryColor, isDarkMode }, ref) => {
+  ({ clientContext, model, apiUrl, welcomeGreeting, welcomeSubtitle, welcomeSuggestions, primaryColor, isDarkMode, voiceSession }, ref) => {
     const scheme = useColorScheme();
     const isDark = scheme === 'dark';
     const insets = useSafeAreaInsets();
@@ -250,6 +257,7 @@ export const AliaChatSheet = forwardRef<AliaChatSheetRef, AliaChatSheetProps>(
                   welcomeSuggestions={welcomeSuggestions}
                   primaryColor={primaryColor}
                   isDarkMode={isDarkMode ?? isDark}
+                  voiceSession={voiceSession}
                   header={({ markState, hasMessages, clear }) => (
                     <View style={styles.header}>
                       <View style={styles.headerLeft}>

package/src/components/PlanPreviewCard.tsx

@@ -1,7 +1,9 @@
 import { View, Pressable } from 'react-native';
 import { Text } from './ui/text';
 import { Button } from './ui/button';
-import { Check, X, ListChecks } from 'lucide-react-native';
+import Check from 'lucide-react-native/icons/check';
+import X from 'lucide-react-native/icons/x';
+import ListChecks from 'lucide-react-native/icons/list-checks';
 import Animated from 'react-native-reanimated';
 import { planPreviewEnter } from '../animations';
 import type { PlanStep } from '../types';

package/src/components/ResearchProgressCard.tsx

@@ -2,15 +2,13 @@ import { useState } from 'react';
 import { View, Pressable } from 'react-native';
 import { Text } from './ui/text';
 import { cn } from '../lib/utils';
-import {
-  Search,
-  BookOpen,
-  CheckCircle,
-  ChevronDown,
-  ChevronUp,
-  ExternalLink,
-  Loader2,
-} from 'lucide-react-native';
+import Search from 'lucide-react-native/icons/search';
+import BookOpen from 'lucide-react-native/icons/book-open';
+import CircleCheckBig from 'lucide-react-native/icons/circle-check-big';
+import ChevronDown from 'lucide-react-native/icons/chevron-down';
+import ChevronUp from 'lucide-react-native/icons/chevron-up';
+import ExternalLink from 'lucide-react-native/icons/external-link';
+import LoaderCircle from 'lucide-react-native/icons/loader-circle';
 import type { ResearchProgress } from '../types';
 
 interface ResearchProgressCardProps {
@@ -42,7 +40,7 @@ export function ResearchProgressCard({ progress }: ResearchProgressCardProps) {
       <View className="flex-row items-center gap-2">
         <View className="w-8 h-8 rounded-full bg-primary/10 items-center justify-center">
           {isComplete ? (
-            <CheckCircle size={16} className="text-green-500" />
+            <CircleCheckBig size={16} className="text-green-500" />
           ) : (
             <Search size={16} className="text-primary" />
           )}
@@ -111,7 +109,7 @@ export function ResearchProgressCard({ progress }: ResearchProgressCardProps) {
       {/* Current search query indicator */}
       {progress.currentQuery && !isComplete && (
         <View className="flex-row items-center gap-2 bg-muted/50 rounded-lg px-3 py-1.5">
-          <Loader2 size={12} className="text-muted-foreground" />
+          <LoaderCircle size={12} className="text-muted-foreground" />
           <Text className="text-xs text-muted-foreground flex-1" numberOfLines={1}>
             {progress.currentQuery}
           </Text>

package/src/components/ThinkingIndicator.tsx

@@ -30,7 +30,7 @@ const workingPhrases = [
   "Doing the thing...",
 ];
 
-export function ThinkingIndicator({ isWorking = false, statusText }: { isWorking?: boolean; statusText?: string }) {
+export function ThinkingIndicator({ isWorking = false, statusText, color }: { isWorking?: boolean; statusText?: string; color?: string }) {
   const phrases = isWorking ? workingPhrases : thinkingPhrases;
   const [phraseIndex, setPhraseIndex] = useState(() =>
     Math.floor(Math.random() * phrases.length)
@@ -84,7 +84,7 @@ export function ThinkingIndicator({ isWorking = false, statusText }: { isWorking
 
   return (
     <View className="flex-row items-center gap-2 py-2">
-      <AliaMark size={16} state={isWorking ? 'working' : 'thinking'} className="text-muted-foreground" />
+      <AliaMark size={16} state={isWorking ? 'working' : 'thinking'} color={color} />
       <View className="flex-row items-center">
         <Text className="text-base text-muted-foreground">{shownText}</Text>
         {(statusText || isTyping) && (

package/src/components/ui/dropdown-menu.web.tsx

@@ -5,27 +5,54 @@ import * as DropdownMenuPrimitive from "@radix-ui/react-dropdown-menu";
 import { CheckIcon, ChevronRightIcon } from "@radix-ui/react-icons";
 import * as React from "react";
 import type { LucideIcon } from "lucide-react-native";
-import {
-  Star, Pencil, Trash2, Share2, Download, Settings, HelpCircle,
-  Image, FileText, Search, ShoppingBag, MoreHorizontal, ExternalLink,
-  BookOpen, Globe, PenTool, Sparkles, User, CreditCard, Bell, LogOut,
-  Folder, Check, Brain, Ghost, Bot, Bookmark, AlertTriangle, Pin,
-} from "lucide-react-native";
+// Per-icon subpaths, never the `lucide-react-native` barrel: the barrel
+// statically re-exports all ~1500 icons, and Metro has no tree shaking, so a
+// single named import pulls ~1.3 MB of unused icon modules into every consumer
+// bundle.
+import Star from "lucide-react-native/icons/star";
+import Pencil from "lucide-react-native/icons/pencil";
+import Trash2 from "lucide-react-native/icons/trash-2";
+import Share2 from "lucide-react-native/icons/share-2";
+import Download from "lucide-react-native/icons/download";
+import Settings from "lucide-react-native/icons/settings";
+import CircleQuestionMark from "lucide-react-native/icons/circle-question-mark";
+import Image from "lucide-react-native/icons/image";
+import FileText from "lucide-react-native/icons/file-text";
+import Search from "lucide-react-native/icons/search";
+import ShoppingBag from "lucide-react-native/icons/shopping-bag";
+import Ellipsis from "lucide-react-native/icons/ellipsis";
+import ExternalLink from "lucide-react-native/icons/external-link";
+import BookOpen from "lucide-react-native/icons/book-open";
+import Globe from "lucide-react-native/icons/globe";
+import PenTool from "lucide-react-native/icons/pen-tool";
+import Sparkles from "lucide-react-native/icons/sparkles";
+import User from "lucide-react-native/icons/user";
+import CreditCard from "lucide-react-native/icons/credit-card";
+import Bell from "lucide-react-native/icons/bell";
+import LogOut from "lucide-react-native/icons/log-out";
+import Folder from "lucide-react-native/icons/folder";
+import Check from "lucide-react-native/icons/check";
+import Brain from "lucide-react-native/icons/brain";
+import Ghost from "lucide-react-native/icons/ghost";
+import Bot from "lucide-react-native/icons/bot";
+import Bookmark from "lucide-react-native/icons/bookmark";
+import TriangleAlert from "lucide-react-native/icons/triangle-alert";
+import Pin from "lucide-react-native/icons/pin";
 
 // Map iOS SF Symbol names to Lucide icons for web rendering
 const SF_SYMBOL_MAP: Record<string, LucideIcon> = {
   "star": Star, "star.fill": Star, "pencil": Pencil, "trash": Trash2,
   "square.and.arrow.up": Share2, "arrow.down.doc": Download,
-  "gearshape": Settings, "questionmark.circle": HelpCircle,
+  "gearshape": Settings, "questionmark.circle": CircleQuestionMark,
   "photo": Image, "doc": FileText, "magnifyingglass": Search,
-  "bag": ShoppingBag, "ellipsis": MoreHorizontal, "link": ExternalLink,
+  "bag": ShoppingBag, "ellipsis": Ellipsis, "link": ExternalLink,
   "book": BookOpen, "globe": Globe, "pencil.tip": PenTool,
   "sparkle": Sparkles, "person.circle": User, "creditcard": CreditCard,
   "bell": Bell, "rectangle.portrait.and.arrow.right": LogOut,
   "folder": Folder, "checkmark": Check, "brain": Brain,
   "eye.slash": Ghost, "cpu": Bot,
   "bookmark": Bookmark, "bookmark.fill": Bookmark,
-  "exclamationmark.triangle": AlertTriangle,
+  "exclamationmark.triangle": TriangleAlert,
   "pin": Pin, "pin.fill": Pin,
 };
 

package/src/components/ui/prompt-input/add-menu.tsx

@@ -1,5 +1,5 @@
 import React from "react";
-import { Plus } from "lucide-react-native";
+import Plus from "lucide-react-native/icons/plus";
 import { cn } from "../../../lib/utils";
 import { Button } from "../button";
 import * as DropdownMenu from "../dropdown-menu";

package/src/components/ui/prompt-input/attachments.tsx

@@ -1,15 +1,13 @@
 import React from "react";
 import { View, Pressable, ScrollView, ActivityIndicator } from "react-native";
 import { Image } from "expo-image";
-import {
-  FileText,
-  FileSpreadsheet,
-  FileCode,
-  FileArchive,
-  FileAudio,
-  File,
-  X,
-} from "lucide-react-native";
+import FileText from "lucide-react-native/icons/file-text";
+import FileSpreadsheet from "lucide-react-native/icons/file-spreadsheet";
+import FileCode from "lucide-react-native/icons/file-code";
+import FileArchive from "lucide-react-native/icons/file-archive";
+import FileHeadphone from "lucide-react-native/icons/file-headphone";
+import File from "lucide-react-native/icons/file";
+import X from "lucide-react-native/icons/x";
 import { Text } from "../text";
 import { formatFileSize } from "../../../lib/utils";
 import { usePromptInput, type Attachment } from "./context";
@@ -48,7 +46,7 @@ function getDocumentIcon(mimeType: string, name: string) {
     mimeType.startsWith("audio/") ||
     ["mp3", "wav", "ogg", "flac", "aac"].includes(ext)
   )
-    return { Icon: FileAudio, color: "#EC4899", bgColor: "#EC489918" };
+    return { Icon: FileHeadphone, color: "#EC4899", bgColor: "#EC489918" };
   if (
     mimeType === "text/plain" ||
     ["txt", "md", "rtf"].includes(ext)

package/src/components/ui/prompt-input/mic-button.tsx

@@ -1,6 +1,7 @@
 import React, { useEffect } from "react";
 import { Pressable, ActivityIndicator } from "react-native";
-import { Mic, MicOff } from "lucide-react-native";
+import Mic from "lucide-react-native/icons/mic";
+import MicOff from "lucide-react-native/icons/mic-off";
 import { cn } from "../../../lib/utils";
 import { useSpeechToText } from "../../../hooks/useSpeechToText";
 import { usePromptInput } from "./context";

package/src/components/ui/prompt-input/prompt-input.tsx

@@ -6,7 +6,8 @@ import {
   type ViewStyle,
 } from "react-native";
 import { KeyboardAvoidingView } from "../../../lib/keyboard";
-import { Maximize2, Minimize2 } from "lucide-react-native";
+import Maximize2 from "lucide-react-native/icons/maximize-2";
+import Minimize2 from "lucide-react-native/icons/minimize-2";
 import { cn } from "../../../lib/utils";
 import { PromptInputContext, type Attachment, type Completion } from "./context";
 import { PromptInputTextarea } from "./textarea";

package/src/components/ui/prompt-input/submit-button.tsx

@@ -1,5 +1,6 @@
 import React from "react";
-import { ArrowUp, Square } from "lucide-react-native";
+import ArrowUp from "lucide-react-native/icons/arrow-up";
+import Square from "lucide-react-native/icons/square";
 import { cn } from "../../../lib/utils";
 import { Button } from "../button";
 import { usePromptInput } from "./context";

package/src/components/voice/VoiceControls.tsx

@@ -4,7 +4,10 @@
  */
 
 import { View, Text, Pressable, ActivityIndicator, StyleSheet } from 'react-native';
-import { Mic, MicOff, PhoneOff, Users } from 'lucide-react-native';
+import Mic from 'lucide-react-native/icons/mic';
+import MicOff from 'lucide-react-native/icons/mic-off';
+import PhoneOff from 'lucide-react-native/icons/phone-off';
+import Users from 'lucide-react-native/icons/users';
 import type { RoomState, AgentState } from '../../types';
 
 interface VoiceControlsProps {

package/src/components/voice/VoiceSession.tsx

@@ -0,0 +1,88 @@
+/**
+ * A live LiveKit call, mounted only while voice mode is on.
+ *
+ * This is the only place the chat UI touches `livekit-client`. The chat shell
+ * receives it as the `voiceSession` prop rather than importing it, so a
+ * text-only consumer never pulls the LiveKit client into its module graph —
+ * which is the whole reason the `@alia.onl/sdk/voice` entry exists.
+ *
+ * Mounting starts the call; unmounting ends it (`useVoiceRoom` tears the room
+ * down on unmount), so the shell only has to decide whether to render it.
+ */
+
+import { useEffect, useRef } from 'react';
+import { useVoiceRoom } from '../../hooks/useVoiceRoom';
+import { useAudioLevelMonitor } from '../../hooks/useAudioLevelMonitor';
+import { useAudioLevels } from '../../hooks/useAudioLevels';
+import { VoiceControls } from './VoiceControls';
+import type { VoiceSessionProps } from '../../types';
+
+export function VoiceSession({ apiUrl, onStateChange, onEnd }: VoiceSessionProps) {
+  const {
+    room,
+    roomState,
+    agentState,
+    isMuted,
+    error,
+    messages,
+    cohostActive,
+    currentSpeaker,
+    roundComplete,
+    isConnected,
+    connect,
+    toggleMute,
+    enableCohost,
+    disableCohost,
+    continueCohost,
+  } = useVoiceRoom({ apiUrl });
+
+  const { captureLevel, playbackLevel } = useAudioLevelMonitor(room, isConnected);
+  const { waveAmplitude } = useAudioLevels({
+    captureLevel,
+    playbackLevel,
+    agentState,
+    isConnected,
+  });
+
+  // Dial out once per mount. The ref keeps a new `connect` identity from
+  // placing a second call on top of the live one.
+  const dialedRef = useRef(false);
+  useEffect(() => {
+    if (dialedRef.current) return;
+    dialedRef.current = true;
+    connect();
+  }, [connect]);
+
+  useEffect(() => {
+    onStateChange({ isConnected, agentState, waveAmplitude, messages });
+  }, [isConnected, agentState, waveAmplitude, messages, onStateChange]);
+
+  // End the call on failure, or once a room we actually reached goes away. The
+  // "reached" flag is what keeps the pre-connect `disconnected` state — which
+  // every session starts in — from ending the call before it begins.
+  const reachedRoomRef = useRef(false);
+  useEffect(() => {
+    if (roomState === 'connected') reachedRoomRef.current = true;
+    if (error || roomState === 'error') {
+      onEnd();
+      return;
+    }
+    if (roomState === 'disconnected' && reachedRoomRef.current) onEnd();
+  }, [error, roomState, onEnd]);
+
+  return (
+    <VoiceControls
+      roomState={roomState}
+      agentState={agentState}
+      isMuted={isMuted}
+      cohostActive={cohostActive}
+      currentSpeaker={currentSpeaker}
+      roundComplete={roundComplete}
+      onToggleMute={toggleMute}
+      onEnableCohost={enableCohost}
+      onDisableCohost={disableCohost}
+      onContinueCohost={continueCohost}
+      onEnd={onEnd}
+    />
+  );
+}

package/src/index.ts

@@ -40,6 +40,13 @@ export type {
   PlanStep,
 } from './types';
 
+// ── Voice capability contract (the implementation lives in `./voice`) ──
+export type {
+  VoiceSessionComponent,
+  VoiceSessionProps,
+  VoiceSessionState,
+} from './types';
+
 // ── UI Primitives (NativeWind) ──
 export { Button, buttonVariants, buttonTextVariants } from './components/ui/button';
 export type { ButtonProps } from './components/ui/button';

package/src/types.ts

@@ -1,3 +1,6 @@
+import type { ComponentType } from 'react';
+import type { SharedValue } from 'react-native-reanimated';
+
 // ── Welcome / Suggestion Types ──
 
 export interface WelcomeSuggestion {
@@ -93,3 +96,32 @@ export interface VoiceMessage {
   isStreaming: boolean;
   toolInvocations?: VoiceToolInvocation[];
 }
+
+// ── Voice Session (injected capability) ──
+
+/** Everything a live call reports back to the chat shell. */
+export interface VoiceSessionState {
+  /** The room is up and the agent is live. */
+  isConnected: boolean;
+  agentState: AgentState;
+  /** Audio amplitude channel that drives the ambient wave overlay. */
+  waveAmplitude: SharedValue<number>;
+  /** Transcript so far; the shell adapts it into the chat message list. */
+  messages: VoiceMessage[];
+}
+
+export interface VoiceSessionProps {
+  /** Alia API base URL. */
+  apiUrl?: string;
+  /** Called on every room, agent, or transcript change. */
+  onStateChange: (state: VoiceSessionState) => void;
+  /** The call is over — the user ended it, it errored, or the room dropped. */
+  onEnd: () => void;
+}
+
+/**
+ * The voice capability handed to `AliaChatScreen` / `AliaChatSheet`. Pass
+ * `VoiceSession` from `@alia.onl/sdk/voice` to enable voice calls; leave it out
+ * and the chat is text-only, with `livekit-client` absent from the module graph.
+ */
+export type VoiceSessionComponent = ComponentType<VoiceSessionProps>;

package/src/voice.ts

@@ -4,6 +4,7 @@
 // into their module graph.
 
 // ── Voice components ──
+export { VoiceSession } from './components/voice/VoiceSession';
 export { AudioWaveVisualizer } from './components/voice/AudioWaveVisualizer';
 export { VoiceOverlay } from './components/voice/VoiceOverlay';
 export { VoiceControls } from './components/voice/VoiceControls';
@@ -23,4 +24,6 @@ export type {
   AgentState,
   VoiceMessage,
   VoiceToolInvocation,
+  VoiceSessionProps,
+  VoiceSessionState,
 } from './types';