@alia.onl/sdk 7.0.0 → 7.2.0

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # @alia.onl/sdk
 
+## 7.1.1
+
+### A stream either answers or fails
+
+Text chat now uses the linked Oxy client, so the session manager performs its
+preflight refresh and its one supported 401 retry. The SDK no longer copies a
+bearer token into a raw `fetch` call.
+
+The response must be SSE and must satisfy the Alia/OpenAI stream contract: valid
+UTF-8 and JSON, typed product events, a finish chunk, a visible assistant answer,
+and terminal `[DONE]`. A malformed, truncated, empty or error stream is a failed
+turn and receives the existing visible retry message instead of becoming an
+empty successful assistant bubble.
+
+Active text requests are cancelled when their component unmounts, when a sheet
+starts closing, when the user stops the turn, or when another send supersedes
+it. Parser failures cancel the response reader as well. The parser bounds total
+bytes, buffered frame size and line count so a broken stream cannot grow memory
+without limit.
+
+The 7.1.0 sampled-audio behavior and the root/voice entry split are unchanged.
+
+## 7.1.0
+
+### The read-aloud field answers the audio
+
+`useTTS` drove the ambient field from a four-keyframe loop keyed on "is it
+playing?" — the same animation for every clip, and for silence. It now reads the
+player's own samples through `setAudioSamplingEnabled`, and both sources of the
+field, dictation and playback, share one curve: `levelFromDbfs` in
+`src/lib/audio-level.ts`, the logarithmic -60 dBFS floor dictation already used.
+A linear reading of the same audio puts a normal speaking voice near the bottom
+of the range, which is why the two looked nothing alike.
+
+Nothing in the public surface changed shape: the hook keeps its signature and
+its return type. What changed is what the field does while a message plays.
+
 ## 7.0.0
 
 ### `AliaMark` is now `IdentityMark`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alia.onl/sdk",
-  "version": "7.0.0",
+  "version": "7.2.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",
@@ -24,26 +24,28 @@
   },
   "scripts": {
     "typecheck": "tsc --noEmit",
+    "test": "vitest run",
     "check:entries": "node scripts/check-entry-isolation.mjs"
   },
   "dependencies": {
     "@radix-ui/react-dropdown-menu": "^2.1.20",
     "@radix-ui/react-icons": "^1.3.2",
     "@tanstack/query-async-storage-persister": "^5.101.2",
-    "@tanstack/react-query": "^5.101.2",
-    "@tanstack/react-query-persist-client": "^5.101.2",
+    "@tanstack/react-query": "^5.102.8",
+    "@tanstack/react-query-persist-client": "^5.102.8",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "lucide-react-native": "^1.24.0",
     "react-native-markdown-display": "^7.0.2",
     "tailwind-merge": "^3.6.0",
     "zeego": "^3.0.6",
-    "zustand": "^5.0.14"
+    "zustand": "^5.0.15"
   },
   "peerDependencies": {
     "react": "^19.2.3",
     "react-native": "^0.86.0",
-    "@oxyhq/services": "^30.1.0",
+    "@oxyhq/core": "23.3.0",
+    "@oxyhq/services": "31.0.0",
     "@react-native-async-storage/async-storage": "^2.2.0",
     "socket.io-client": "^4.8.3",
     "expo-font": "^57.0.0",
@@ -71,6 +73,9 @@
     }
   },
   "devDependencies": {
-    "typescript": "^5.9.3"
+    "@types/react-test-renderer": "^19.1.0",
+    "react-test-renderer": "19.2.3",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10"
   }
 }

package/src/components/AliaChatContent.tsx

@@ -73,6 +73,8 @@ export interface AliaChatContentProps {
    * from this module. May be a `React.lazy` component.
    */
   voiceSession?: VoiceSessionComponent;
+  /** Internal sheet lifecycle bridge: receives the live request canceller. */
+  onStopReady?: (stop: (() => void) | null) => void;
 }
 
 /** Adapt a voice message into the chat message format. */
@@ -110,11 +112,17 @@ export function AliaChatContent({
   primaryColor,
   isDarkMode,
   voiceSession: VoiceSession,
+  onStopReady,
 }: AliaChatContentProps) {
   // ── Chat ──
   const chatOptions: UseAliaChatOptions = { apiUrl, model, clientContext };
   const { messages, setMessages, send, isStreaming, stop, clear } = useAliaChat(chatOptions);
 
+  useEffect(() => {
+    onStopReady?.(stop);
+    return () => onStopReady?.(null);
+  }, [onStopReady, stop]);
+
   // ── Input state ──
   const [inputValue, setInputValue] = useState('');
 

package/src/components/AliaChatScreen.tsx

@@ -28,7 +28,7 @@ import type { VoiceSessionComponent } from '../types';
 export interface AliaChatScreenProps {
   /** App context injected into system prompt */
   clientContext?: string;
-  /** Alia model. Checked against `GET /catalogue`; omitted, the build's preference is used. */
+  /** Kaana routing profile. Checked against `GET /catalogue`; omitted, the build's preference is used. */
   model?: string;
   /** API URL override */
   apiUrl?: string;
@@ -81,7 +81,7 @@ export function AliaChatScreen({
           <View className="flex-row items-center justify-between px-4 py-3">
             <View className="flex-row items-center gap-2.5">
               {headerLeft}
-              <IdentityMark size={28} state={markState} />
+              <IdentityMark size={28} state={markState} spinOnPress />
               <Text className="text-lg font-semibold text-foreground">Alia</Text>
             </View>
             <View className="flex-row items-center gap-2">

package/src/components/AliaChatSheet.tsx

@@ -45,7 +45,7 @@ const SPRING_CONFIG = {
 export interface AliaChatSheetProps {
   /** App context injected into system prompt */
   clientContext?: string;
-  /** Alia model. Checked against `GET /catalogue`; omitted, the build's preference is used. */
+  /** Kaana routing profile. Checked against `GET /catalogue`; omitted, the build's preference is used. */
   model?: string;
   /** API URL override */
   apiUrl?: string;
@@ -82,6 +82,7 @@ export const AliaChatSheet = forwardRef<AliaChatSheetRef, AliaChatSheetProps>(
     const [rendered, setRendered] = useState(false);
     const hasClosedRef = useRef(false);
     const closeTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+    const chatStopRef = useRef<(() => void) | null>(null);
 
     // Reanimated shared values
     const translateY = useSharedValue(SCREEN_HEIGHT);
@@ -112,6 +113,14 @@ export const AliaChatSheet = forwardRef<AliaChatSheetRef, AliaChatSheetProps>(
       setRendered(false);
     }, []);
 
+    const stopChat = useCallback(() => {
+      chatStopRef.current?.();
+    }, []);
+
+    const registerChatStop = useCallback((stop: (() => void) | null) => {
+      chatStopRef.current = stop;
+    }, []);
+
     const handlePresent = useCallback(() => {
       hasClosedRef.current = false;
       if (closeTimeoutRef.current) {
@@ -124,6 +133,7 @@ export const AliaChatSheet = forwardRef<AliaChatSheetRef, AliaChatSheetProps>(
     }, []);
 
     const handleDismiss = useCallback(() => {
+      stopChat();
       backdropOpacity.value = withTiming(0, { duration: 250 }, (finished) => {
         if (finished) runOnJS(finishDismiss)();
       });
@@ -136,7 +146,7 @@ export const AliaChatSheet = forwardRef<AliaChatSheetRef, AliaChatSheetProps>(
         finishDismiss();
         closeTimeoutRef.current = null;
       }, 350);
-    }, [finishDismiss]);
+    }, [finishDismiss, stopChat]);
 
     useEffect(
       () => () => {
@@ -181,6 +191,7 @@ export const AliaChatSheet = forwardRef<AliaChatSheetRef, AliaChatSheetProps>(
           velocity > 900 || (distance > closeThreshold && velocity > -300);
 
         if (shouldClose) {
+          runOnJS(stopChat)();
           translateY.value = withSpring(SCREEN_HEIGHT, {
             ...SPRING_CONFIG,
             velocity,
@@ -191,7 +202,7 @@ export const AliaChatSheet = forwardRef<AliaChatSheetRef, AliaChatSheetProps>(
         } else {
           translateY.value = withSpring(0, { ...SPRING_CONFIG, velocity });
         }
-      }), [nativeGesture, finishDismiss]);
+      }), [nativeGesture, finishDismiss, stopChat]);
 
     // Animated styles
     const backdropAnimStyle = useAnimatedStyle(() => ({
@@ -258,10 +269,11 @@ export const AliaChatSheet = forwardRef<AliaChatSheetRef, AliaChatSheetProps>(
                   primaryColor={primaryColor}
                   isDarkMode={isDarkMode ?? isDark}
                   voiceSession={voiceSession}
+                  onStopReady={registerChatStop}
                   header={({ markState, hasMessages, clear }) => (
                     <View style={styles.header}>
                       <View style={styles.headerLeft}>
-                        <IdentityMark size={28} state={markState} />
+                        <IdentityMark size={28} state={markState} spinOnPress />
                         <Text className="text-lg font-semibold text-foreground">
                           Alia
                         </Text>

package/src/components/AliaWelcomeMessage.tsx

@@ -28,7 +28,7 @@ export function AliaWelcomeMessage({
         {/* Mark + Title */}
         <View className="items-start mb-8">
           <View className="mb-4">
-            <IdentityMark size={markSize} />
+            <IdentityMark size={markSize} spinOnPress />
           </View>
           <View className="space-y-2">
             <Text className="text-3xl font-bold tracking-tight text-foreground">

package/src/components/IdentityMark.tsx

@@ -23,19 +23,39 @@ export interface IdentityMarkProps {
   /** Layout classes for the outer box (color comes from `color`, not classes). */
   className?: string;
   /**
-   * Who the mark stands for, as a colour. Defaults to the Alia brand purple —
-   * never a theme token. An agent passes its own colour and gets the same
-   * artwork at the same size, which is the whole of the difference between
-   * Alia's mark and an agent's.
+   * Who the mark stands for, as a colour. An agent passes its own colour and
+   * gets the same artwork at the same size, which is the whole of the
+   * difference between Alia's mark and an agent's.
+   *
+   * The default is the Alia brand purple, and that is what an agent-less
+   * surface gets when it passes nothing. But do not read the default as a rule:
+   * three of Alia's own surfaces — the sidebar logo, the chat's mark and the
+   * welcome message — deliberately pass `colors.primary`, so Alia's face
+   * follows the account's accent there and stays brand purple elsewhere
+   * (`welcome-intro.tsx`). That split predates this component and is not
+   * settled; it is written down here so the next reader picks a side knowingly
+   * rather than copying whichever neighbour they happened to open.
    */
   color?: string;
   /**
-   * Called after the press flourish, and the ONLY thing that makes the mark a
-   * button. Left off, the mark is drawn inert: no press target, so it can sit
-   * inside a row that is itself pressable — a sidebar entry, a card — without
-   * swallowing the tap meant for the row.
+   * Called after the press flourish, for a mark that is a control — the sidebar
+   * logo, which goes home.
    */
   onPress?: () => void;
+  /**
+   * Take the tap for the flourish alone: spin, haptic, nothing else.
+   *
+   * For a mark that IS Alia standing on its own — the welcome greeting, a chat
+   * header — where the spin has always been the whole of what a tap does. There
+   * is no callback to give it, and `onPress={() => {}}` would be a lie about
+   * that, so this is how such a mark asks to be pressable.
+   *
+   * Sibling of `spinOnMount`, and off by default like it. Off is what lets the
+   * mark sit inside a row that is itself pressable — a sidebar agent entry, a
+   * card — without swallowing the tap meant for the row, which is the whole
+   * reason the press target is opt-in.
+   */
+  spinOnPress?: boolean;
   /**
    * Accessible name. A mark standing in for whoever is speaking is not
    * decoration, so it says who; Alia's own, drawn beside her name, is.
@@ -77,6 +97,7 @@ export function IdentityMark({
   className,
   color,
   onPress,
+  spinOnPress = false,
   accessibilityLabel,
   spinOnMount = false,
 }: IdentityMarkProps) {
@@ -157,9 +178,11 @@ export function IdentityMark({
   );
 
   // A `Pressable` captures the touch whether or not the caller wanted one, so
-  // the inert mark is a plain view. Wrapping it in a pressable that only spins
-  // is what would stop a sidebar row from opening when you tap the face on it.
-  if (onPress === undefined) {
+  // the inert mark is a plain view — a mark drawn as somebody's face inside a
+  // row that is itself pressable must not stop that row from opening. Asking for
+  // the touch is therefore explicit, and either prop asks: a callback to run, or
+  // the flourish for its own sake.
+  if (onPress === undefined && !spinOnPress) {
     return (
       <View
         accessibilityRole="image"
@@ -175,7 +198,10 @@ export function IdentityMark({
   return (
     <Pressable
       onPress={handlePress}
-      accessibilityRole="button"
+      // Pressable, but a button only when the press DOES something beyond the
+      // flourish. A screen reader announcing the welcome greeting's mark as a
+      // button would promise an action it does not have.
+      accessibilityRole={onPress === undefined ? 'image' : 'button'}
       accessibilityLabel={accessibilityLabel}
       className={className}
       style={box}