@alia.onl/sdk 21.3.2 → 21.5.0

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # @alia.onl/sdk
 
+## 21.5.0
+
+### Fixed
+
+- **The SDK no longer ships every Oxy account screen to the app.** The host's app assertion
+  (`useAppAssertion`) was read from `@oxy.so/services/ui`, the only entry that exported it, and
+  that entry registers every account screen at import (with Bloom's phone flags and the rest), so
+  every app using the SDK carried them in its first-paint JS: +0.58 MiB in CrowdSource's reviewer.
+  It now comes from the lean `@oxy.so/services/ui/client`, like `useOxy` and `useAuth`.
+  `check:entries` refuses `@oxy.so/services/ui` from every entry, as it already refused the root.
+
+### Changed
+
+- The `@oxy.so/services` peer is `>=12.1.0`, the first release whose `ui/client` exports
+  `useAppAssertion`.
+
+## 21.4.0
+
+### Added
+
+- **`@alia.onl/sdk/text` and `@alia.onl/sdk/ask/text`: the chat without bundling the voice
+  call.** `voice={false}` hid the call, but its code still shipped: since 21.3.2 the web build
+  inlines the call into the chat's chunk, so a text-only app paid for it. The new entries export
+  the same `AliaChatSheet`, `AliaChatScreen` and `AliaChatContent`, and `AliaAskProvider` /
+  `useAskAgent` with a lazily loaded sheet. None of them reaches the call's modules (its socket,
+  protocol and audio engine), and they never offer a call. Read-aloud and dictation stay.
+  CrowdSource's reviewer, which switched `AliaChatSheet` to `@alia.onl/sdk/text`: lazy sheet
+  chunk 1,455,831 → 1,357,287 bytes (413.8 → 374.2 KB gzip), `__common.js` 3,978,158 →
+  3,962,370 bytes, no new chunk. The README has a table of which entry to import.
+
+### Changed
+
+- `AliaChatContent` no longer imports the call. It draws whatever call `VoiceCallContext` hands it,
+  and the root entry and `@alia.onl/sdk/ask` export their chat through `withVoiceCall`, so those
+  two behave as before. `check:entries` checks that the text entries never reach the call, on any
+  platform, and draw no async boundary on web other than the ask sheet's.
+
 ## 21.3.2
 
 ### Fixed

package/README.md

@@ -143,6 +143,26 @@ The sheet, the screen and the Alia app are three frames around ONE conversation
 stop, retry, edit and clear conversations through the same hooks, and a conversation started in
 one is the same conversation in the others.
 
+### Which entry to import
+
+| You want | Import from | Bundles the voice call |
+|---|---|---|
+| The chat with the call (`AliaChatSheet`, `AliaChatScreen`, `AliaChatContent`) | `@alia.onl/sdk` | yes |
+| The same chat, text only | `@alia.onl/sdk/text` | no |
+| One "Ask" sheet at the app's root, loaded with the first `ask` | `@alia.onl/sdk/ask` | yes, in the sheet's chunk |
+| The same, text only | `@alia.onl/sdk/ask/text` | no |
+| Data only: conversations, the stream, the model | `@alia.onl/sdk/runtime`, `@alia.onl/sdk/model` | no |
+| Her face on a button | `@alia.onl/sdk/avatar` | no |
+
+`voice={false}` hides the call, but the code still ships: the root entry and `@alia.onl/sdk/ask`
+bundle the call (its socket, protocol and audio engine) because their chat can open one. A
+text-only app imports from `@alia.onl/sdk/text` or `@alia.onl/sdk/ask/text`. Their chat never
+reaches those modules and never offers a call, whatever `voice` says. Read-aloud and dictation
+are still there, because they belong to the thread and the composer. Types can still come from
+`@alia.onl/sdk`, since type imports are erased. A value imported from the root brings the call
+along with it. In CrowdSource's reviewer, `@alia.onl/sdk/text` made its lazy sheet chunk 98 KB
+smaller (raw; 39 KB gzip).
+
 ## Any agent, from any app
 
 Every agent — Alia included — is the same agent (ADR 0020), and any Oxy app opens any agent the
@@ -181,7 +201,8 @@ stays out of the app's entry bundle. The root entry exports the same two, with t
 two async chunks share into `__common.js`, which loads at first paint. The SDK draws no async chunk
 boundary of its own on web (the call, sounds and pickers import statically there), except the one
 of `@alia.onl/sdk/ask`. So either mount the provider from `@alia.onl/sdk/ask`, or lazy-import your
-own module that imports the root entry — not both, or the chat they share lands in `__common.js`.
+own module that imports the root entry (or `@alia.onl/sdk/text`). Don't do both, or the chat they
+share lands in `__common.js`. The text-only entries draw no extra boundary either.
 
 The sheet offers the person's latest conversations with its lead under the greeting
 (`recentConversations={false}` turns it off). The code that configures the sheet sits above it, so

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alia.onl/sdk",
-  "version": "21.3.2",
+  "version": "21.5.0",
   "description": "Alia AI chat SDK — the conversation runtime, chat UI, voice calls and dictation for Oxy apps",
   "main": "src/index.ts",
   "react-native": "src/index.ts",
@@ -9,11 +9,13 @@
   "exports": {
     ".": "./src/index.ts",
     "./ask": "./src/ask.ts",
+    "./ask/text": "./src/ask-text.ts",
     "./avatar": "./src/avatar.ts",
     "./content": "./src/lib/content-utils.ts",
     "./csp": "./src/csp.ts",
     "./model": "./src/runtime/model.ts",
     "./runtime": "./src/runtime/index.ts",
+    "./text": "./src/text.ts",
     "./tools": "./src/tools.ts",
     "./voice": "./src/voice.ts",
     "./package.json": "./package.json"
@@ -54,7 +56,7 @@
     "@expo/vector-icons": "^15.1.1",
     "@oxy.so/bloom": ">=10.21.0",
     "@oxy.so/core": ">=3.0.0",
-    "@oxy.so/services": ">=11.12.0",
+    "@oxy.so/services": ">=12.1.0",
     "@tanstack/react-query": "^5.101",
     "@react-native-async-storage/async-storage": "^2.2.0",
     "expo-blur": "^57.0.0 || ^58.0.0",

package/src/ask-text.ts

@@ -0,0 +1,10 @@
+// @alia.onl/sdk/ask/text — `@alia.onl/sdk/ask` without the voice call, and without bundling it
+// The provider and its hook; the sheet loads with the first `ask`, and neither reaches the call's
+// modules. `useAskAgent` is the same hook as `@alia.onl/sdk/ask`'s.
+
+export { AliaAskProvider, useAskAgent } from './components/AliaAskProviderText';
+export type {
+  AliaAsk,
+  AliaAskAgents,
+  AliaAskProviderProps,
+} from './components/AliaAskProviderText';

package/src/components/AliaAskProvider.tsx

@@ -10,7 +10,7 @@
  */
 
 import { createAskProvider } from './AliaAskCore';
-import { AliaAskSheet } from './AliaAskSheet';
+import { AliaAskSheet } from './AliaAskSheetWithVoice';
 
 export type { AliaAsk, AliaAskAgents, AliaAskProviderProps } from './AliaAskCore';
 export { useAskAgent } from './AliaAskCore';

package/src/components/AliaAskProviderLazy.tsx

@@ -4,15 +4,15 @@
  * Signed in, the sheet's module is fetched in the background so the first `ask` does not wait on
  * the network.
  *
- * This `import()` is the ONE async boundary the SDK draws, and only for this entry: everything
- * behind it (`AliaAskSheet` and the chat) imports statically on web, so Metro emits one chunk for
+ * This `import()` is the ONE async boundary the SDK draws, and only for this entry (and
+ * `@alia.onl/sdk/ask/text`): everything behind it (`AliaAskSheetWithVoice` and the chat) imports statically on web, so Metro emits one chunk for
  * the sheet and hoists nothing of it into `__common.js` (`scripts/check-entry-isolation.mjs`).
  */
 
 import { lazy, Suspense } from 'react';
 import { type AskSheetComponent, createAskProvider } from './AliaAskCore';
 
-const loadSheet = () => import('./AliaAskSheet');
+const loadSheet = () => import('./AliaAskSheetWithVoice');
 const LazyAskSheet = lazy(() => loadSheet().then((module) => ({ default: module.AliaAskSheet })));
 
 const SuspendedAskSheet: AskSheetComponent = (props) => (

package/src/components/AliaAskProviderText.tsx

@@ -0,0 +1,25 @@
+/**
+ * The ask provider of `@alia.onl/sdk/ask/text`: `AliaAskProviderLazy` without the voice call. Its
+ * sheet is loaded lazily, with the first `ask`, and neither the provider nor the sheet reaches the
+ * call's modules, so a text-only app bundles none of them.
+ *
+ * Its `import()` is the one async boundary of this entry, as in `AliaAskProviderLazy`: behind it
+ * everything imports statically on web (`scripts/check-entry-isolation.mjs`).
+ */
+
+import { lazy, Suspense } from 'react';
+import { type AskSheetComponent, createAskProvider } from './AliaAskCore';
+
+const loadSheet = () => import('./AliaAskSheet');
+const LazyAskSheet = lazy(() => loadSheet().then((module) => ({ default: module.AliaAskSheet })));
+
+const SuspendedAskSheet: AskSheetComponent = (props) => (
+  <Suspense fallback={null}>
+    <LazyAskSheet {...props} />
+  </Suspense>
+);
+
+export type { AliaAsk, AliaAskAgents, AliaAskProviderProps } from './AliaAskCore';
+export { useAskAgent } from './AliaAskCore';
+
+export const AliaAskProvider = createAskProvider(SuspendedAskSheet, loadSheet);

package/src/components/AliaAskSheetWithVoice.tsx

@@ -0,0 +1,10 @@
+/**
+ * The ask sheet with the voice call: what the root entry's `AliaAskProvider` imports and
+ * `@alia.onl/sdk/ask` loads with the first `ask`. `@alia.onl/sdk/ask/text` loads `AliaAskSheet`
+ * itself, which never reaches the call.
+ */
+
+import { AliaAskSheet as TextAskSheet } from './AliaAskSheet';
+import { withVoiceCall } from './voice/withVoiceCall';
+
+export const AliaAskSheet = withVoiceCall(TextAskSheet, 'AliaAskSheet');

package/src/components/AliaChatContent.tsx

@@ -7,8 +7,9 @@
  * (`useChatComposer`, `useChatVoice`, `useThreadView`), and this, which draws it — the thread
  * (`AliaThread`) and the agent's history behind it, the composer with its levels, suggestions and
  * questions, and the voice call: the button that opens it, the bar that replaces the composer, the
- * notices and the transcript in the thread. The call loads on the first call, so nothing here
- * reaches its audio engine at module-evaluation time.
+ * notices and the transcript in the thread. The call itself is not imported here: the entry that
+ * bundles it hands it down (`VoiceCallContext`, `withVoiceCall`), so the text-only entries
+ * (`@alia.onl/sdk/text`, `@alia.onl/sdk/ask/text`) never reach its modules.
  *
  * What a host brings is data and places: the conversation to show, the chrome around it
  * (`chrome`), its rows in the add menu, its words (`labels`), where the thought panel and a
@@ -30,7 +31,15 @@ import { RiEditLine } from '@oxy.so/bloom/icons/RiEditLine';
 import { toast } from '@oxy.so/bloom/toast';
 import { Text } from '@oxy.so/bloom/typography';
 import { useQueryClient } from '@tanstack/react-query';
-import { type ReactNode, useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import {
+  type ReactNode,
+  useCallback,
+  useContext,
+  useEffect,
+  useMemo,
+  useRef,
+  useState,
+} from 'react';
 import { View } from 'react-native';
 import type { SharedValue } from 'react-native-reanimated';
 import { useAmbientWave } from '../hooks/useAmbientWave';
@@ -66,7 +75,7 @@ import { AmbientField } from './AmbientField';
 import { AliaThread } from './thread/AliaThread';
 import { ThreadSearch } from './thread/ThreadSearch';
 import { VoiceModeIcon } from './VoiceModeIcon';
-import { AliaVoiceCall } from './voice/AliaVoiceCall';
+import { VoiceCallContext } from './voice/VoiceCallContext';
 
 /** The agent a chat is opened on: its lead instead of Alia. */
 export interface AliaChatAgentRef {
@@ -227,7 +236,8 @@ export interface AliaChatContentProps {
    */
   renderUsageLimit?: (limit: { error: UsageLimitError; dismiss: () => void }) => ReactNode;
   /**
-   * The chat's voice call. On by default; `false` makes the chat text-only. An object brings
+   * The chat's voice call. On by default where the call is bundled (the root entry and
+   * `@alia.onl/sdk/ask`); the text-only entries have none. `false` makes the chat text-only. An object brings
    * what only the host knows: the gate before a call (`canStartVoice`, `onVoiceBlocked`), what
    * to refresh when one ends (`onCallEnded`), where its notices go (`onNotice`), the sounds it
    * plays. The call always lives in the chat's conversation, made when it starts if the chat has
@@ -405,8 +415,10 @@ function AliaConversationView({
     onSuggestionPicked,
     presentedProgress,
   });
+  // Without a call handed down (a text-only entry), the chat is text-only whatever `voice` says.
+  const VoiceCall = useContext(VoiceCallContext);
   const voice = useChatVoice({
-    options: voiceOptions,
+    options: VoiceCall === null ? false : voiceOptions,
     conversationId,
     agentId,
     isFocused,
@@ -600,8 +612,8 @@ function AliaConversationView({
 
   const composerNode = (
     <>
-      {voice.enabled && voice.isActive ? (
-        <AliaVoiceCall {...voice.launcher.sessionProps} />
+      {VoiceCall !== null && voice.enabled && voice.isActive ? (
+        <VoiceCall {...voice.launcher.sessionProps} />
       ) : (
         <AliaComposer
           // A different account is a different composer: reads in flight for the last one are

package/src/components/AliaChatWithVoice.tsx

@@ -0,0 +1,13 @@
+/**
+ * The chat components of the root entry: each draws the voice call (`withVoiceCall`). The same
+ * components without it — and without bundling it — are `@alia.onl/sdk/text`.
+ */
+
+import { AliaChatContent as TextChatContent } from './AliaChatContent';
+import { AliaChatScreen as TextChatScreen } from './AliaChatScreen';
+import { AliaChatSheet as TextChatSheet } from './AliaChatSheet';
+import { withVoiceCall } from './voice/withVoiceCall';
+
+export const AliaChatContent = withVoiceCall(TextChatContent, 'AliaChatContent');
+export const AliaChatSheet = withVoiceCall(TextChatSheet, 'AliaChatSheet');
+export const AliaChatScreen = withVoiceCall(TextChatScreen, 'AliaChatScreen');

package/src/components/voice/VoiceCallContext.ts

@@ -0,0 +1,13 @@
+/**
+ * The voice call a conversation can open, handed down by the entry that bundles it.
+ *
+ * `AliaChatContent` draws the call through this rather than importing it, so a text-only entry
+ * (`@alia.onl/sdk/text`, `@alia.onl/sdk/ask/text`) never reaches the call's modules — its socket,
+ * protocol and audio engine. The root and `@alia.onl/sdk/ask` provide `AliaVoiceCall` around their
+ * chat (`withVoiceCall`); without a provider the chat is text-only, whatever its `voice` prop says.
+ */
+
+import { type ComponentType, createContext } from 'react';
+import type { VoiceSessionProps } from '../../types';
+
+export const VoiceCallContext = createContext<ComponentType<VoiceSessionProps> | null>(null);

package/src/components/voice/withVoiceCall.tsx

@@ -0,0 +1,25 @@
+/**
+ * A chat component with the voice call: `Component` drawn under `VoiceCallContext`, which hands
+ * it `AliaVoiceCall`. The root entry and `@alia.onl/sdk/ask` export their chat through this; the
+ * text-only entries export the components as they are.
+ */
+
+import type { ComponentType } from 'react';
+import { AliaVoiceCall } from './AliaVoiceCall';
+import { VoiceCallContext } from './VoiceCallContext';
+
+export function withVoiceCall<P extends object>(
+  Component: ComponentType<P>,
+  displayName: string,
+): ComponentType<P> {
+  // A ref is a prop of a function component (React 19), so it reaches a `forwardRef` `Component`.
+  function WithVoiceCall(props: P) {
+    return (
+      <VoiceCallContext.Provider value={AliaVoiceCall}>
+        <Component {...props} />
+      </VoiceCallContext.Provider>
+    );
+  }
+  WithVoiceCall.displayName = displayName;
+  return WithVoiceCall;
+}

package/src/index.ts

@@ -3,7 +3,7 @@
 // Reusable chat UI, voice, and streaming components for Oxy apps
 
 // ── Main components ──
-export { AliaChatContent } from './components/AliaChatContent';
+export { AliaChatContent } from './components/AliaChatWithVoice';
 export type {
   AliaChatAgentRef,
   AliaChatChrome,
@@ -25,11 +25,11 @@ export { AliaSharedConversation } from './components/AliaSharedConversation';
 export type { AliaSharedConversationProps } from './components/AliaSharedConversation';
 export type { AliaAddMenu } from './lib/add-menu';
 export type { AliaVoiceOptions } from './hooks/useChatVoice';
-export { AliaChatSheet } from './components/AliaChatSheet';
+export { AliaChatSheet } from './components/AliaChatWithVoice';
 export type { AliaChatSheetProps, AliaChatSheetRef } from './components/AliaChatSheet';
 export { AliaRecentConversations } from './components/AliaRecentConversations';
 export type { AliaTurn } from './hooks/useChatComposer';
-export { AliaChatScreen } from './components/AliaChatScreen';
+export { AliaChatScreen } from './components/AliaChatWithVoice';
 export type { AliaChatScreenProps } from './components/AliaChatScreen';
 
 // ── Chat UI components ──

package/src/runtime/app-assertion.ts

@@ -1,6 +1,4 @@
-// `@oxy.so/services/ui`, not the root barrel (which ships the sign-in panels, `check:entries`):
-// `ui/client` does not export `useAppAssertion`.
-import { useAppAssertion } from '@oxy.so/services/ui';
+import { useAppAssertion } from '@oxy.so/services/ui/client';
 import { useMemo } from 'react';
 
 /**

package/src/text.ts

@@ -0,0 +1,18 @@
+// @alia.onl/sdk/text — the chat without the voice call, and without bundling it
+// The same `AliaChatSheet`, `AliaChatScreen` and `AliaChatContent` as the root entry, but none of
+// them reaches the call's modules (its socket, protocol and audio engine): a text-only app takes
+// its chat from here. Read-aloud and dictation stay — they are the composer's and the thread's.
+// Types can be imported from the root entry (they are erased); values from the root would bring
+// the call along.
+
+export { AliaChatContent } from './components/AliaChatContent';
+export type {
+  AliaChatAgentRef,
+  AliaChatChrome,
+  AliaChatContentProps,
+  AliaChatState,
+} from './components/AliaChatContent';
+export { AliaChatSheet } from './components/AliaChatSheet';
+export type { AliaChatSheetProps, AliaChatSheetRef } from './components/AliaChatSheet';
+export { AliaChatScreen } from './components/AliaChatScreen';
+export type { AliaChatScreenProps } from './components/AliaChatScreen';