@alia.onl/sdk 7.2.7 → 8.0.0

package/CHANGELOG.md

@@ -1,5 +1,96 @@
 # @alia.onl/sdk
 
+## Unreleased
+
+### The consumer-backend path is documented
+
+Documentation only; no code, wire or default changed, and no version is cut for
+it.
+
+The package now has a README. It says which endpoint `useAliaChat` calls and
+why it is `/v1/chat/completions` rather than `/alia/chat`: this package ships
+raw source and compiles into apps on origins Alia does not enumerate, and
+`/alia/chat` answers CORS preflights only for Alia's own origins. It then
+documents the path that works from any origin today — `useAliaChat({ apiUrl })`
+pointed at the consumer's own backend, which calls `POST /alia/chat`
+server-to-server, forwards the user's Oxy token, and streams the SSE body back
+unchanged — with a minimal relay. The `apiUrl` option's JSDoc says the same in
+short. Issue #244 records the two other shapes and why neither is available
+yet.
+
+## 8.0.0
+
+### Voice runs on the device
+
+Dictation and voice calls work again. Both used Alia endpoints that called
+speech providers directly — `POST /v1/voice/transcribe` and a LiveKit room from
+`POST /v1/voice/token` — and both have been refusing since Alia's inference
+moved behind Oxy, which serves chat and speech synthesis but no transcription or
+realtime session. Those endpoints are removed from the API.
+
+- **`useSpeechToText`** recognizes on the device (Web Speech API on web,
+  `expo-speech-recognition` on iOS/Android). Its shape is unchanged —
+  `startRecording`, `stopAndTranscribe`, `cancel`, the three states,
+  `useSTTStore` metering — and it gains `lang` and `isSupported`.
+- **`useVoiceRoom`** is a turn loop: on-device listening with end-of-utterance
+  detection, each utterance sent through the chat path (`sendTurn`, by default
+  `createAliaVoiceTurnSender`, which posts `/v1/chat/completions` with
+  `responseMode: 'voice'`), the answer spoken sentence by sentence through
+  `/v1/audio/speech`, and barge-in. `connect`, `disconnect`, `roomState`,
+  `agentState`, `messages`, `isMuted`, `toggleMute` and `error` keep their
+  meaning; it adds `turnError` and the options `sendTurn`, `chatModel`, `lang`,
+  `endOfUtteranceMs` and `bargeIn`.
+- The call asks `/v1/audio/speech` for the product voices `male` / `female`;
+  it no longer sends upstream voice names.
+
+**Breaking:**
+
+- `livekit-client` is no longer a peer dependency; `expo-speech-recognition`
+  is a new one (the root entry's dictation reaches it on native), and a native
+  app needs a new build with its config plugin.
+- `useVoiceRoom().room` is a `VoiceLevelSource` (live capture and playback
+  levels), not a LiveKit `Room`; `useAudioLevelMonitor` takes that.
+- `livekit-client` is gone from the package entirely; nothing in either entry
+  reaches it (`check:entries` asserts that).
+- The cohost is removed. `useVoiceRoom` no longer returns `cohostActive`,
+  `roundComplete`, `enableCohost`, `disableCohost` or `continueCohost`, and
+  `currentSpeaker` is `'primary' | 'user' | null`. `VoiceControls` no longer
+  takes `cohostActive`, `currentSpeaker`, `roundComplete`, `onEnableCohost`,
+  `onDisableCohost` or `onContinueCohost`, and draws no cohost button or
+  "Continue conversation" prompt. `ChatMessage.speaker` and
+  `VoiceMessage.speaker` are `'primary'` only, and the message list draws no
+  "Cohost" label.
+- `useSpeechToText` no longer takes `apiUrl` or `accessToken`; dictation never
+  talks to the Alia API. Pass `lang` or nothing.
+- The pre-Bloom composer is no longer public. `PromptInput`,
+  `PromptInputTextarea`, `PromptInputActions`, `PromptInputSubmitButton`,
+  `PromptInputMicButton`, `PromptInputAddMenu`, `PromptInputAttachments`,
+  `PromptInputAutocomplete`, `PromptInputContext`, `usePromptInput`,
+  `useIsFullscreen`, `ChatTextInput` and the types `PromptInputProps`,
+  `PromptInputContextType`, `Attachment` and `Completion` are removed from the
+  root entry. `AliaChatScreen` / `AliaChatSheet` still draw their composer;
+  build your own from the primitives if you composed one from these parts.
+- Dependencies trimmed: `@tanstack/react-query`,
+  `@tanstack/react-query-persist-client` and
+  `@tanstack/query-async-storage-persister` are no longer dependencies (no
+  module imported them), and `socket.io-client` and `expo-font` are no longer
+  peer dependencies (likewise unused). Keep them in your app if your app uses
+  them itself.
+
+**Server side, alongside this release:** the `alia_sk_*` developer keys are
+retired and refused by the Alia API. The SDK never used them — it sends the
+signed-in user's Oxy session — but a backend that relays the SDK's requests
+with such a key must forward the user's Oxy token instead (see the README).
+
+## 7.2.8
+
+### One Oxy runtime and a native-only notifications boundary
+
+The Alia app now consumes the canonical `@oxy.so/*` packages throughout, so
+the provider and SDK hooks resolve the same Services context. Its notification
+setup also loads `expo-notifications` only after confirming a native platform;
+web no longer evaluates Expo's unsupported device push-token listener.
+
 ## 7.2.7
 
 ### Compatible Oxy 1.0 peers

package/README.md

@@ -0,0 +1,234 @@
+# @alia.onl/sdk
+
+Alia's chat SDK for React Native and Expo apps built on Oxy: the chat sheet and
+screen, the streaming hook, speech in and out, and the primitives they are made
+of. It renders inside the one `OxyProvider` your app already mounts and sends
+the signed-in user's Oxy session with every request; it never holds a token of
+its own.
+
+The package ships **raw TypeScript source** — `main`, `types` and every
+`exports` entry point at `src/`. Your bundler compiles it with the rest of your
+app, which is why the section on endpoints below matters more than it would for
+a prebuilt library.
+
+## Install
+
+```sh
+bun add @alia.onl/sdk
+```
+
+`react`, `react-native`, `@oxy.so/core`, `@oxy.so/services` and the Expo modules
+listed under `peerDependencies` in `package.json` are yours to install. Metro
+must resolve package `exports` (`resolver.unstable_enablePackageExports = true`,
+the default in Expo SDK 53+), because every icon import is a subpath.
+
+Two entry points:
+
+- `@alia.onl/sdk` — text chat, dictation, read-aloud, catalogue, primitives.
+- `@alia.onl/sdk/voice` — `VoiceSession` and `useVoiceRoom`, the voice call.
+  Pass `VoiceSession` to the shell as `voiceSession` to offer calls; leave it
+  out for text-only chat and the call is never compiled.
+
+## Speech
+
+Dictation (`useSpeechToText`) and the voice call (`useVoiceRoom`) recognize
+speech **on the device**: the Web Speech API in browsers that have it (Chromium
+and Safari — not Firefox, where `useSpeechToText().isSupported` is `false`), and
+[`expo-speech-recognition`](https://github.com/jamsch/expo-speech-recognition)
+on iOS and Android. No audio is sent to Alia; whether the platform's recognizer
+uses a network service of its own is the platform's (Chrome's does).
+
+On native, add `expo-speech-recognition` (a peer dependency, like `expo-audio`:
+the root entry's mic button reaches it) and its config plugin to your app, then
+make a new native build:
+
+```json
+["expo-speech-recognition", {
+  "microphonePermission": "Allow $(PRODUCT_NAME) to hear what you dictate and say in voice calls.",
+  "speechRecognitionPermission": "Allow $(PRODUCT_NAME) to turn your speech into text."
+}]
+```
+
+A voice call is a turn loop, not a realtime session: it listens until the
+person pauses, sends what they said through the ordinary chat path
+(`POST /v1/chat/completions` with `responseMode: "voice"`, or your own
+`sendTurn`), and speaks the answer sentence by sentence through
+`POST /v1/audio/speech` in the product voice (`male` / `female`). Talking over
+the answer interrupts it. Pass `lang` to both hooks to follow your app's
+language.
+
+## Use
+
+```tsx
+import { AliaChatScreen } from '@alia.onl/sdk';
+
+export function Assistant() {
+  return <AliaChatScreen />;
+}
+```
+
+Or the hook on its own, with your own UI:
+
+```tsx
+import { useAliaChat } from '@alia.onl/sdk';
+
+const { messages, send, isStreaming, stop, error } = useAliaChat({
+  clientContext: 'The user is looking at their order history.',
+});
+```
+
+`useAliaChat` streams a turn as Server-Sent Events and switches on Alia's
+product events — `alia.reasoning`, `alia.tool_result`, `alia.research_progress`,
+`alia.plan_preview`, delegated-agent answers — into `ChatMessage` fields your
+components render. Those events are the product runtime's, not part of the Oxy
+generic inference contract, and this package is written against them on
+purpose: it is a **product** client.
+
+## Which endpoint the SDK calls, and why
+
+The hook sends its turns to `POST {apiUrl}/v1/chat/completions`, with `apiUrl`
+defaulting to `EXPO_PUBLIC_ALIA_API_URL` or `https://api.alia.onl`. It also
+reads `GET {apiUrl}/catalogue` once per base URL, to check the requested model
+identifier against what the server offers.
+
+That is the compatibility surface, not the product route. `POST /alia/chat` is
+the same handler with the same authentication, and it is where Alia's own
+clients go — but the two mounts answer browsers differently:
+
+| Preflight | `access-control-allow-origin` |
+| --- | --- |
+| `OPTIONS /alia/chat` from `https://alia.onl` or `https://console.alia.onl` | that origin, with credentials |
+| `OPTIONS /alia/chat` from an origin Alia does not enumerate | **absent** |
+| `OPTIONS /v1/chat/completions` from anywhere | `*` |
+
+`/alia/chat` takes Alia's exact-origin allowlist (`packages/api/src/lib/cors-origins.ts`);
+`/v1` is public CORS. Because this package compiles into *your* app on *your*
+origin, defaulting the hook to `/alia/chat` would fail every consumer's
+preflight on web. So it stays on `/v1/chat/completions`, which is Alia's
+**permanent product API** — it does not sunset
+([ADR 0010](https://github.com/OxyHQ/Alia/blob/main/docs/adr/0010-alia-keeps-a-product-api-credentials-come-from-oxy-console.md)).
+Generic model access is a different product, Kaana through Oxy; this package
+is written against Alia's, and the credential a consumer presents is an Oxy
+one — the signed-in user's session today. A change of default to `/alia/chat`
+would be a semver-major of this package, would reach only consumers who upgrade
+**and** rebuild, and is not needed to escape a sunset; it is taken only if the
+per-application origin policy below makes it worthwhile
+([#244](https://github.com/OxyHQ/Alia/issues/244), closed on that decision).
+
+Native apps are not subject to CORS at all — React Native sends no `Origin`
+header — so the table above is about web builds and the backend path below.
+
+## Using the SDK from your own product: the consumer-backend path
+
+The supported way for an application outside Alia's origins to use this SDK
+today is to put your own backend between the SDK and Alia. Your backend
+receives the SDK's request, calls Alia's product route server-to-server — a
+server sends no `Origin` header, so `/alia/chat` answers it on its credential
+alone — and streams the SSE body back unchanged. Then point the hook at that
+backend:
+
+```tsx
+useAliaChat({ apiUrl: 'https://your-backend.example' });
+```
+
+The hook keeps its paths, so your backend answers
+`POST /v1/chat/completions` and `GET /catalogue` under whatever base URL you
+give it. Nothing about the stream changes: the SDK's parser reads the bytes Alia
+wrote.
+
+**Which credential.** The SDK attaches the signed-in user's Oxy access token as
+`Authorization: Bearer …` on the request your backend receives. Forward that
+header as it is. `POST /alia/chat` authenticates with
+`authenticateTokenOrApiKey` (`packages/api/src/routes/chat.ts`,
+`packages/api/src/middleware/auth.ts`), which accepts an Oxy session token —
+verified with Oxy, the same way it would be if the browser had called Alia
+directly — and the turn is metered to that user's Alia entitlement, the same as
+a direct call. The other credentials the middleware recognises are
+Alia-internal. There is no consumer-application credential for this route yet — that is Oxy Applications' to issue (OxyHQ/oxy#972).
+
+A minimal relay, Node 18+ and Express:
+
+```ts
+import express from 'express';
+
+const ALIA = 'https://api.alia.onl';
+const app = express();
+app.use(express.json({ limit: '1mb' }));
+
+/** Relay one request to Alia and stream the answer back unchanged. */
+async function relay(
+  req: express.Request,
+  res: express.Response,
+  method: 'GET' | 'POST',
+  path: string,
+): Promise<void> {
+  const controller = new AbortController();
+  req.on('close', () => controller.abort());
+
+  const authorization = req.get('authorization');
+  const upstream = await fetch(`${ALIA}${path}`, {
+    method,
+    headers: {
+      ...(authorization ? { Authorization: authorization } : {}),
+      Accept: req.get('accept') ?? 'application/json',
+      ...(method === 'POST' ? { 'Content-Type': 'application/json' } : {}),
+    },
+    body: method === 'POST' ? JSON.stringify(req.body) : undefined,
+    signal: controller.signal,
+  });
+
+  res.status(upstream.status);
+  res.setHeader('Content-Type', upstream.headers.get('content-type') ?? 'application/json');
+  res.setHeader('Cache-Control', 'no-cache');
+  res.setHeader('X-Accel-Buffering', 'no'); // keep proxies from buffering the SSE stream
+  res.flushHeaders();
+
+  if (upstream.body === null) {
+    res.end();
+    return;
+  }
+  try {
+    for await (const chunk of upstream.body) res.write(chunk);
+  } catch (error) {
+    if (!controller.signal.aborted) throw error;
+  } finally {
+    res.end();
+  }
+}
+
+// The SDK's turn: answered by Alia's PRODUCT route, server-to-server.
+app.post('/v1/chat/completions', (req, res) => relay(req, res, 'POST', '/alia/chat'));
+
+// The SDK's model check. Without this the hook still works — an unreadable
+// catalogue leaves the requested identifier alone — but it never learns what
+// the server offers.
+app.get('/catalogue', (req, res) => relay(req, res, 'GET', '/catalogue'));
+
+app.listen(3000);
+```
+
+The request body the SDK sends is `{ model, messages, stream: true }` and the
+response Alia writes is `text/event-stream`; the relay forwards both without
+reading them. CORS between your web app and your backend is yours to configure,
+as it would be for any of your own routes.
+
+**The trade-off.** This is one more hop, and one more process in the path of a
+stream. Some consumers will not want it, which is why it is documented as the
+path that works today rather than chosen as the only one. The other two shapes
+— a CORS policy on `/alia/chat` for registered consumer origins, and the SDK
+default moving to `/alia/chat` in a major — are recorded in #244: the first is
+blocked on Oxy Applications carrying an origin registry (OxyHQ/oxy#972), and
+the second is an adoption window rather than a switch, for the raw-source
+reason above.
+
+## Scripts
+
+```sh
+bun run typecheck       # tsc --noEmit
+bun run test            # vitest
+bun run check:entries   # the root entry must not reach the voice call
+```
+
+## Licence
+
+Apache-2.0. See `LICENSE` and `NOTICE`.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alia.onl/sdk",
-  "version": "7.2.7",
-  "description": "Alia AI chat SDK — reusable chat UI, voice, and streaming components for Oxy apps",
+  "version": "8.0.0",
+  "description": "Alia AI chat SDK \u2014 reusable chat UI, voice, and streaming components for Oxy apps",
   "main": "src/index.ts",
   "react-native": "src/index.ts",
   "source": "src/index.ts",
@@ -31,9 +31,6 @@
   "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.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",
@@ -45,25 +42,23 @@
   "peerDependencies": {
     "react": "^19.2.3",
     "react-native": "^0.86.0",
-    "@oxy.so/core": "^1.0.1",
-    "@oxy.so/services": "^1.0.1",
+    "@oxy.so/core": "^1.7.0",
+    "@oxy.so/services": "^3.0.0 || ^4.0.0",
     "@react-native-async-storage/async-storage": "^2.2.0",
-    "socket.io-client": "^4.8.3",
-    "expo-font": "^57.0.0",
     "expo-blur": "^57.0.0",
     "react-native-reanimated": "^4.5.0",
     "react-native-gesture-handler": "^2.32.0",
     "react-native-safe-area-context": "^5.8.0",
     "react-native-keyboard-controller": "^1.21.9",
-    "react-native-svg": "^15.15.4",
-    "livekit-client": "^2.20.1",
+    "react-native-svg": "^15.15.5",
     "expo-audio": "^57.0.0",
     "expo-image": "^57.0.0",
     "expo-image-picker": "^57.0.2",
     "expo-document-picker": "^57.0.0",
     "expo-haptics": "^57.0.0",
     "nativewind": "^5.0.0-preview.3",
-    "expo-clipboard": "^57.0.0"
+    "expo-clipboard": "^57.0.0",
+    "expo-speech-recognition": "^57.1.0"
   },
   "peerDependenciesMeta": {
     "nativewind": {
@@ -77,6 +72,7 @@
     "@types/react-test-renderer": "^19.1.0",
     "react-test-renderer": "19.2.3",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.10",
+    "expo-speech-recognition": "~57.1.0"
   }
 }

package/src/components/AliaChatContent.tsx

@@ -286,7 +286,6 @@ export function AliaChatContent({
             onStop={stop}
             emptyAction={voiceActivateButton}
             placeholder="Ask Alia..."
-            apiUrl={apiUrl}
             autocomplete={!!useSuggestions}
             useSuggestions={useSuggestions}
             onSuggestionUsed={onSuggestionUsed}

package/src/components/AliaChatMessageList.tsx

@@ -337,10 +337,6 @@ const AssistantMessage = React.memo(function AssistantMessage({
       {/* Message Content */}
       {(hasContent || message.isStreaming) && (
         <View className="flex-col items-start gap-0.5">
-          {/* Voice cohost label */}
-          {message.source === 'voice' && message.speaker === 'cohost' && (
-            <Text className="text-xs text-indigo-400 mb-0.5">Cohost</Text>
-          )}
           {/* Agent identity */}
           {message.agentInfo && (
             <View className="flex-row items-center gap-2 mb-0.5">

package/src/components/ResearchProgressCard.tsx

@@ -23,6 +23,9 @@ const PHASE_LABELS: Record<string, string> = {
   follow_up: 'Follow-up research',
   finalizing: 'Polishing report',
   complete: 'Research complete',
+  // The engine finished searching but could not write the final answer; the
+  // message carries what was found, and this label keeps the card honest.
+  failed: 'Research incomplete',
 };
 
 const PHASE_ORDER = ['decomposing', 'searching', 'synthesizing', 'follow_up', 'finalizing', 'complete'];

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

@@ -8,12 +8,11 @@ import { usePromptInput } from "./context";
 
 export type PromptInputMicButtonProps = {
   className?: string;
-  apiUrl?: string;
 };
 
-export function PromptInputMicButton({ className, apiUrl }: PromptInputMicButtonProps) {
+export function PromptInputMicButton({ className }: PromptInputMicButtonProps) {
   const { value, setValue, onError } = usePromptInput();
-  const stt = useSpeechToText({ apiUrl });
+  const stt = useSpeechToText();
 
   useEffect(() => {
     if (stt.error) {

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

@@ -49,8 +49,6 @@ export type PromptInputProps = {
   onSuggestionUsed?: (suggestionId: string) => void;
   // Injectable error handler (replaces toast)
   onError?: (message: string) => void;
-  // Mic button API URL
-  apiUrl?: string;
 } & Omit<React.ComponentProps<typeof View>, "children">;
 
 export function PromptInput({
@@ -77,7 +75,6 @@ export function PromptInput({
   useSuggestions,
   onSuggestionUsed,
   onError,
-  apiUrl,
   ...props
 }: PromptInputProps) {
   const [internalValue, setInternalValue] = useState(value || "");
@@ -182,7 +179,7 @@ export function PromptInput({
           {actionsLeft ?? <PromptInputAddMenu />}
         </View>
         <View className="flex-row items-center gap-1.5">
-          <PromptInputMicButton apiUrl={apiUrl} />
+          <PromptInputMicButton />
           <PromptInputSubmitButton
             isLoading={isLoading}
             onStop={onStop}

package/src/components/voice/VoiceControls.tsx

@@ -1,26 +1,19 @@
 /**
- * Bottom voice control bar that replaces PromptInput when voice mode is active.
- * Contains status text, mute/cohost/end buttons, and "Continue" for cohost rounds.
+ * Bottom voice control bar that replaces the composer when voice mode is active.
+ * Contains status text and mute/end buttons.
  */
 
 import { View, Text, Pressable, ActivityIndicator, StyleSheet } from '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 {
   roomState: RoomState;
   agentState: AgentState;
   isMuted: boolean;
-  cohostActive: boolean;
-  currentSpeaker: 'primary' | 'cohost' | 'user' | null;
-  roundComplete: boolean;
   onToggleMute: () => void;
-  onEnableCohost: () => void;
-  onDisableCohost: () => void;
-  onContinueCohost: () => void;
   onEnd: () => void;
   /** Override theme primary color (resolved hex/hsl value, not CSS var) */
   primaryColor?: string;
@@ -30,13 +23,9 @@ function getStatusText(
   roomState: RoomState,
   agentState: AgentState,
   isMuted: boolean,
-  cohostActive: boolean,
-  currentSpeaker: string | null,
 ): string {
   if (roomState === 'connecting') return 'Connecting...';
   if (roomState === 'connected') {
-    if (cohostActive && currentSpeaker === 'cohost') return 'Cohost speaking...';
-    if (cohostActive && currentSpeaker === 'primary') return 'Alia speaking...';
     if (agentState === 'listening') return isMuted ? 'Muted' : 'Listening...';
     if (agentState === 'thinking') return 'Thinking...';
     if (agentState === 'speaking') return 'Speaking...';
@@ -49,17 +38,11 @@ export function VoiceControls({
   roomState,
   agentState,
   isMuted,
-  cohostActive,
-  currentSpeaker,
-  roundComplete,
   onToggleMute,
-  onEnableCohost,
-  onDisableCohost,
-  onContinueCohost,
   onEnd,
   primaryColor,
 }: VoiceControlsProps) {
-  const statusText = getStatusText(roomState, agentState, isMuted, cohostActive, currentSpeaker);
+  const statusText = getStatusText(roomState, agentState, isMuted);
 
   return (
     <View style={styles.container}>
@@ -69,18 +52,6 @@ export function VoiceControls({
         </Text>
       ) : null}
 
-      {roundComplete && (
-        <Pressable
-          onPress={onContinueCohost}
-          className="bg-primary/30"
-          style={[styles.continueButton, primaryColor ? { backgroundColor: primaryColor + '4D' } : undefined]}
-        >
-          <Text className="text-sm font-medium text-primary" style={primaryColor ? { color: primaryColor } : undefined}>
-            Continue conversation
-          </Text>
-        </Pressable>
-      )}
-
       {roomState === 'connected' && (
         <View style={styles.buttonRow}>
           <View style={styles.buttonWrapper}>
@@ -100,22 +71,6 @@ export function VoiceControls({
             </Text>
           </View>
 
-          <View style={styles.buttonWrapper}>
-            <Pressable
-              onPress={cohostActive ? onDisableCohost : onEnableCohost}
-              className={cohostActive ? 'bg-primary' : 'bg-muted'}
-              style={[
-                styles.button,
-                cohostActive && primaryColor ? { backgroundColor: primaryColor } : undefined,
-              ]}
-            >
-              <Users size={24} color="white" />
-            </Pressable>
-            <Text className="text-xs text-muted-foreground">
-              {cohostActive ? 'Solo' : 'Cohost'}
-            </Text>
-          </View>
-
           <View style={styles.buttonWrapper}>
             <Pressable
               onPress={onEnd}
@@ -157,10 +112,4 @@ const styles = StyleSheet.create({
     alignItems: 'center',
     justifyContent: 'center',
   },
-  continueButton: {
-    marginBottom: 16,
-    paddingHorizontal: 20,
-    paddingVertical: 8,
-    borderRadius: 24,
-  },
 });

package/src/components/voice/VoiceSession.tsx

@@ -1,13 +1,12 @@
 /**
- * A live LiveKit call, mounted only while voice mode is on.
+ * A live voice 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.
+ * The chat shell receives it as the `voiceSession` prop rather than importing
+ * it, so a text-only consumer never compiles the voice loop, speech playback or
+ * the call UI — which is the 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.
+ * Mounting starts the call; unmounting ends it (`useVoiceRoom` stops listening
+ * and speaking on unmount), so the shell only has to decide whether to render it.
  */
 
 import { useEffect, useRef } from 'react';
@@ -25,15 +24,9 @@ export function VoiceSession({ apiUrl, onStateChange, onEnd }: VoiceSessionProps
     isMuted,
     error,
     messages,
-    cohostActive,
-    currentSpeaker,
-    roundComplete,
     isConnected,
     connect,
     toggleMute,
-    enableCohost,
-    disableCohost,
-    continueCohost,
   } = useVoiceRoom({ apiUrl });
 
   const { captureLevel, playbackLevel } = useAudioLevelMonitor(room, isConnected);
@@ -75,13 +68,7 @@ export function VoiceSession({ apiUrl, onStateChange, onEnd }: VoiceSessionProps
       roomState={roomState}
       agentState={agentState}
       isMuted={isMuted}
-      cohostActive={cohostActive}
-      currentSpeaker={currentSpeaker}
-      roundComplete={roundComplete}
       onToggleMute={toggleMute}
-      onEnableCohost={enableCohost}
-      onDisableCohost={disableCohost}
-      onContinueCohost={continueCohost}
       onEnd={onEnd}
     />
   );

package/src/hooks/useAliaChat.ts

@@ -10,7 +10,22 @@ import type { AliaChatStreamEvent } from '../lib/chat-stream';
 const API_URL = process.env.EXPO_PUBLIC_ALIA_API_URL ?? 'https://api.alia.onl';
 
 export interface UseAliaChatOptions {
-  /** Alia API base URL (default: EXPO_PUBLIC_ALIA_API_URL or https://api.alia.onl) */
+  /**
+   * Base URL the hook sends its requests to. Defaults to
+   * `EXPO_PUBLIC_ALIA_API_URL`, then `https://api.alia.onl`.
+   *
+   * The hook appends its own paths — `POST /v1/chat/completions` for a turn and
+   * `GET /catalogue` for the model check — so the value is a host, not a route.
+   *
+   * Point this at YOUR OWN backend to use the SDK from an origin Alia does not
+   * enumerate: Alia's product route, `POST /alia/chat`, answers CORS preflights
+   * only for Alia's own origins, while a server-to-server call carries no
+   * `Origin` header and is answered on its credential alone. Your backend
+   * receives the SDK's request, forwards the `Authorization` header it carries
+   * (the signed-in user's Oxy access token) to `/alia/chat`, and streams the
+   * SSE body back unchanged. The README's *consumer-backend path* section has
+   * the minimal relay; issue #244 records why this is the supported shape today.
+   */
   apiUrl?: string;
   /**
    * Kaana routing profile to use.