@alia.onl/sdk 13.0.0 → 13.1.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @alia.onl/sdk
 
+## 13.1.0
+
+The chat works in any app without host setup it did not document in code:
+
+- **The avatar loads.** The chat mounts Bloom's `AgentAvatarProvider` itself, pointing at Alia's
+  shared runtime (`ALIA_CHARACTER_RUNTIME_URL`, served with CORS open); a host that serves its own
+  passes `characterRuntimeUrl`. Before, an app that had not hosted the 214 MB runtime showed
+  Bloom's "unavailable" state.
+- **The empty chat greets.** With no `welcomeGreeting` it greets the signed-in person by name
+  (`labels.greeting` / `labels.greetingNamed`). Before, it drew nothing.
+
 ## 13.0.0
 
 Fixes found by driving the sheet end to end (the sheet shows plans, links citations, nests lists):

package/README.md

@@ -25,20 +25,18 @@ the default in Expo SDK 53+), because every icon import is a subpath.
 The chat is built from Bloom (`@oxy.so/bloom`, a peer dependency): mount Bloom's
 `BloomProvider` above it, with the one `KeyboardProvider` your app already has.
 
-Alia's avatar is Bloom's 3D character (`AgentAvatar`), which draws through a
-runtime Bloom ships as static files (about 11 MB). Serve the package's
-`assets/character-runtime/` directory unchanged and give the URL of `runtime.mjs`
-to Bloom's provider, once, near the root:
-
-```tsx
-import { AgentAvatarProvider } from '@oxy.so/bloom/agent-avatar';
-
-<AgentAvatarProvider runtimeUrl="/bloom-character/runtime.mjs">…</AgentAvatarProvider>
-```
-
-Without it the avatar shows Bloom's "unavailable" state. Native avatars run in a
+Alia's avatar is Bloom's 3D character (`AgentAvatar`). It draws through a runtime of
+static files (about 214 MB), which the chat loads from Alia's own origin
+(`ALIA_CHARACTER_RUNTIME_URL`, served with CORS open), so the app hosts nothing and mounts
+no avatar provider. An app with a strict CSP allows `https://alia.onl` in `script-src` and
+`connect-src` (and `'wasm-unsafe-eval'`). To serve your own copy instead, serve the Bloom
+package's `assets/character-runtime/` directory unchanged and pass the URL of `runtime.mjs`
+as `characterRuntimeUrl` to `AliaChatSheet` or `AliaChatScreen`; native avatars run in a
 WebView, so there the URL must be absolute and reachable from the device.
 
+The empty chat greets the signed-in person by name ("Hi Nate, what's on your mind?"); pass
+`welcomeGreeting` to say something else, or `labels.greeting` / `labels.greetingNamed` to translate it.
+
 Failures (a voice call that cannot start, a dictation error) are shown with Bloom's `toast`,
 so the app needs a `ToastOutlet` (`OxyProvider` mounts one), or pass `onError` to handle them.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alia.onl/sdk",
-  "version": "13.0.0",
+  "version": "13.1.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",
@@ -32,7 +32,7 @@
   "dependencies": {
     "clsx": "^2.1.1",
     "react-native-markdown-display": "^7.0.2",
-    "tailwind-merge": "^3.6.0",
+    "tailwind-merge": "^3.7.0",
     "zustand": "^5.0.15"
   },
   "peerDependencies": {

package/src/components/AliaChatContent.tsx

@@ -17,6 +17,10 @@ import { imageUriToDataUrl } from '../lib/image-data-url';
 import { useAmbientWave } from '../hooks/useAmbientWave';
 import { AmbientField } from './AmbientField';
 import { QuestionCard } from './QuestionCard';
+import { getAccountDisplayName } from '@oxy.so/core';
+import { useOxy } from '@oxy.so/services/ui/client';
+import { AgentAvatarProvider } from '@oxy.so/bloom/agent-avatar';
+import { ALIA_CHARACTER_RUNTIME_URL } from '../lib/character-runtime';
 import { pendingQuestions } from '../lib/questions';
 import { AliaChatMessageList } from './AliaChatMessageList';
 import { AliaFlightsProvider, ALIA_TO_PROFILE } from '../lib/flights';
@@ -84,7 +88,7 @@ export interface AliaChatContentProps {
   apiUrl?: string;
   /** Error handler (e.g. toast) */
   onError?: (message: string) => void;
-  // Welcome message
+  /** The empty chat's greeting; omitted, Alia greets the signed-in person by name (`labels`). */
   welcomeGreeting?: string;
   welcomeSubtitle?: string;
   /** The lines offered over the composer on an empty chat. */
@@ -137,6 +141,8 @@ export interface AliaChatContentProps {
   onStopReady?: (stop: (() => void) | null) => void;
   /** Overrides for the chat's own copy; anything omitted is English. */
   labels?: Partial<AliaChatLabels>;
+  /** Where the 3D avatar's runtime is served from; omitted, Alia's shared copy (`ALIA_CHARACTER_RUNTIME_URL`). */
+  characterRuntimeUrl?: string;
 }
 
 /** The add menu: photos are the one attachment the chat API carries (`image_url` parts). */
@@ -399,14 +405,17 @@ function AliaChatContentBody({
     return 'writing';
   }, [messages, isStreaming, isVoiceActive, voiceAgentState]);
 
+  const { user } = useOxy();
+  const greeting =
+    welcomeGreeting ?? (user ? labels.greetingNamed(getAccountDisplayName(user)) : labels.greeting);
   const welcomeComponent = useMemo(() => {
-    if (!welcomeGreeting || messages.length > 0) return undefined;
+    if (messages.length > 0) return undefined;
     return (
       <View className="flex-1 items-center justify-center px-4 py-10">
-        <AliaWelcomeMessage greeting={welcomeGreeting} subtitle={welcomeSubtitle} />
+        <AliaWelcomeMessage greeting={greeting} subtitle={welcomeSubtitle} />
       </View>
     );
-  }, [welcomeGreeting, welcomeSubtitle, messages.length]);
+  }, [greeting, welcomeSubtitle, messages.length]);
 
   // ── Ambient wave — one persistent overlay across idle/voice/TTS/STT ──
   const wave = useAmbientWave({
@@ -563,10 +572,16 @@ function AliaChatContentBody({
 }
 
 /** The chat: header, thread and composer, with the host's labels in reach of all of it. */
-export function AliaChatContent({ labels, ...props }: AliaChatContentProps) {
+export function AliaChatContent({
+  labels,
+  characterRuntimeUrl = ALIA_CHARACTER_RUNTIME_URL,
+  ...props
+}: AliaChatContentProps) {
   return (
-    <AliaChatLabelsProvider labels={labels}>
-      <AliaChatContentBody {...props} />
-    </AliaChatLabelsProvider>
+    <AgentAvatarProvider runtimeUrl={characterRuntimeUrl}>
+      <AliaChatLabelsProvider labels={labels}>
+        <AliaChatContentBody {...props} />
+      </AliaChatLabelsProvider>
+    </AgentAvatarProvider>
   );
 }

package/src/components/AliaChatScreen.tsx

@@ -62,6 +62,8 @@ export interface AliaChatScreenProps {
   voiceSession?: VoiceSessionComponent;
   /** Overrides for the chat's own copy (header, composer, plan, research…); omitted, English. */
   labels?: Partial<AliaChatLabels>;
+  /** Where the 3D avatar's runtime is served from; omitted, Alia's shared copy (`ALIA_CHARACTER_RUNTIME_URL`). */
+  characterRuntimeUrl?: string;
 }
 
 export function AliaChatScreen({
@@ -82,6 +84,7 @@ export function AliaChatScreen({
   isDarkMode,
   voiceSession,
   labels,
+  characterRuntimeUrl,
 }: AliaChatScreenProps) {
   const insets = useSafeAreaInsets();
   // The screen owns the whole window, so it keeps its composer out of both
@@ -129,6 +132,7 @@ export function AliaChatScreen({
           isDarkMode={isDarkMode}
           voiceSession={voiceSession}
           labels={labels}
+          characterRuntimeUrl={characterRuntimeUrl}
           header={header}
         />
       </KeyboardAvoidingView>

package/src/components/AliaChatSheet.tsx

@@ -52,6 +52,8 @@ export interface AliaChatSheetProps {
   voiceSession?: VoiceSessionComponent;
   /** Overrides for the chat's own copy (header, composer, plan, research…); omitted, English. */
   labels?: Partial<AliaChatLabels>;
+  /** Where the 3D avatar's runtime is served from; omitted, Alia's shared copy (`ALIA_CHARACTER_RUNTIME_URL`). */
+  characterRuntimeUrl?: string;
   /** Draws the header's share button once there is a conversation; omitted, no share button. */
   onShare?: () => void;
   /** More rows for the header's menu (`DropdownMenuItem`s from `@oxy.so/bloom/dropdown-menu`). */
@@ -78,6 +80,7 @@ export const AliaChatSheet = forwardRef<AliaChatSheetRef, AliaChatSheetProps>(
       isDarkMode,
       voiceSession,
       labels,
+      characterRuntimeUrl,
       onShare,
       headerMenu,
     },
@@ -159,6 +162,7 @@ export const AliaChatSheet = forwardRef<AliaChatSheetRef, AliaChatSheetProps>(
       voiceSession,
       bottomInset: detached ? 0 : bottom,
       labels,
+      characterRuntimeUrl,
     };
 
     return (

package/src/index.ts

@@ -10,6 +10,7 @@ export { AliaChatScreen } from './components/AliaChatScreen';
 export type { AliaChatScreenProps } from './components/AliaChatScreen';
 
 // ── Chat UI components ──
+export { ALIA_CHARACTER_RUNTIME_URL } from './lib/character-runtime';
 export { DEFAULT_LABELS } from './lib/labels';
 export type { AliaChatLabels } from './lib/labels';
 export { VoiceModeIcon } from './components/VoiceModeIcon';

package/src/lib/character-runtime.ts

@@ -0,0 +1,10 @@
+/**
+ * Where the 3D character runtime (Alia's avatar) is served from when the host does not say.
+ *
+ * The runtime is ~214 MB of engine and data, so the chat loads it from Alia's own web origin
+ * instead of asking every app to host a copy. That origin serves it with CORS open
+ * (`packages/app/worker/index.js`), which a cross-origin module import needs; an app with a
+ * strict CSP allows it in `script-src` and `connect-src`. A host that serves its own copy
+ * passes `characterRuntimeUrl`.
+ */
+export const ALIA_CHARACTER_RUNTIME_URL = 'https://alia.onl/bloom-character/runtime.mjs';

package/src/lib/labels.tsx

@@ -15,6 +15,11 @@ export interface AliaChatLabels {
   addPhotos: string;
   startVoice: string;
   voiceFailed: string;
+  // Welcome
+  /** The empty chat's greeting for a signed-out visitor. */
+  greeting: string;
+  /** The empty chat's greeting for a named person. */
+  greetingNamed: (name: string) => string;
   // Messages
   copy: string;
   helpful: string;
@@ -51,6 +56,8 @@ export const DEFAULT_LABELS: AliaChatLabels = {
   addPhotos: 'Photos',
   startVoice: 'Start voice',
   voiceFailed: "Couldn't start the voice call",
+  greeting: "Hi, what's on your mind?",
+  greetingNamed: (name) => `Hi ${name}, what's on your mind?`,
   copy: 'Copy',
   helpful: 'Helpful response',
   unhelpful: 'Unhelpful response',