@alia.onl/sdk 11.0.0 → 12.0.0

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # @alia.onl/sdk
 
+## 12.0.0
+
+Breaking: Bloom 10 peer; the `header` render prop replaces the breadcrumb path (`title`, `actions`)
+and the mark-state context. Hosts on Bloom 9 stay on 11.1.0.
+
+- **The `@oxy.so` peers are open-ended** above their floors (`bloom >=10.0.0`, `core >=3.0.0`,
+  `services >=8.0.0`). The `^10.0.0`, `^4.0.0` and `^11.0.0` caps made each new Oxy major a peer
+  conflict in every app until this package republished; apps always run the latest Oxy SDK.
+
+- **`AmbientField` takes `layout="sheet"`** for a short card (the chat's sheet): the blobs are
+  drawn at the size of a phone screen, spread wider and shifted back to the right, cropped by the
+  card's edges. It is asked for, not inferred from the field's height, so a short app screen is
+  never reinterpreted. `AmbientField`, `AliaAvatar` and `AliaChatHeader` are memoised and the
+  chat body no longer repaints them on every streamed token; read-aloud and starting a call no
+  longer change identity per flush. `AliaAvatar` takes `portrait` (a still thumbnail, used for
+  the sidebar's permanent mark).
+- **One `header` render prop** on `AliaChatContent`, handed `hasMessages`, `clear` and the live
+  avatar `markState`; the breadcrumb path (`title`, `actions`) and the mark-state context are gone.
+- The profile and the screen's background are NativeWind classes with Bloom tokens
+  (`bg-background-full`, `group-hover/profile:…`), not JS-computed colours.
+- **Bloom is a peer at `^10.0.0`** (was `^9.0.0`). Bloom 10 makes an avatar one flat
+  `AvatarCharacter`; `AliaAvatar` is `{ preset: 'blue_beret', accessory: 'none', color: 'orchid' }`
+  and no longer builds a `config`. Hosts mount `AgentAvatarProvider` as before. Hosts on Bloom 9
+  stay on the previous release.
+
+## 11.1.0
+
+Alia can ask clarifying questions, as ChatGPT and Claude do.
+
+- **New:** `QuestionCard` (Bloom's `Questionnaire`: single or multiple choice, a free-text
+  "Other", one question per step), drawn under a reply that asked. `AliaChatMessageList`
+  renders it from the turn's `askUserQuestion` tool call; `AliaChatContent` sends the
+  answers as the person's next message (`onAnswerQuestions` on the list, for hosts that
+  compose their own).
+- **New, pure** (root entry and `@alia.onl/sdk/tools`): `askedQuestions`, `formatAnswers`,
+  `isQuestionInvocation`, `ASK_USER_QUESTION_TOOL`. The question is the stored tool call, so
+  it survives a reload; it is answered once any later message exists, typed or picked.
+- The turn **ends** at the card: the server stops after the call and writes no answer under it.
+
 ## 11.0.0
 
 The chat UI is Bloom's, not a copy of it. Breaking:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alia.onl/sdk",
-  "version": "11.0.0",
+  "version": "12.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",
@@ -39,9 +39,9 @@
     "react": "^19.2.3",
     "react-native": "^0.86.0",
     "@expo/vector-icons": "^15.1.1",
-    "@oxy.so/bloom": "^9.0.0",
-    "@oxy.so/core": "^3.0.0 || ^4.0.0",
-    "@oxy.so/services": "^8.0.0 || ^9.0.0 || ^10.0.0 || ^11.0.0",
+    "@oxy.so/bloom": ">=10.0.0",
+    "@oxy.so/core": ">=3.0.0",
+    "@oxy.so/services": ">=8.0.0",
     "@react-native-async-storage/async-storage": "^2.2.0",
     "expo-blur": "^57.0.0",
     "react-native-reanimated": "^4.5.0",
@@ -56,6 +56,7 @@
     "expo-haptics": "^57.0.0",
     "nativewind": "^5.0.0-preview.3",
     "expo-clipboard": "^57.0.0",
+    "expo-file-system": "^57.0.0",
     "expo-speech-recognition": "^57.1.0"
   },
   "peerDependenciesMeta": {

package/src/components/AliaAvatar.tsx

@@ -1,27 +1,15 @@
-import { AgentAvatar, type AvatarConfig, DEFAULT_CONFIG } from '@oxy.so/bloom/agent-avatar';
-import { useEffect, useState } from 'react';
+import { AgentAvatar, type AvatarCharacter } from '@oxy.so/bloom/agent-avatar';
+import { memo, useEffect, useState } from 'react';
 
 /** What Alia is doing; the avatar plays a working turn each time it starts to think or work. */
 export type AliaAvatarState = 'idle' | 'thinking' | 'working' | 'writing';
 
 /**
- * Alia's likeness in Bloom's 3D character engine: the six-lobed flower in orchid,
- * plain oval eyes, nothing on its head. The engine ids come from Bloom's catalog
- * (`character-shapes.ts`, `character-colors.ts`); change them here and nowhere else.
+ * Alia's likeness in Bloom's 3D character engine: the six-lobed flower in orchid, plain oval
+ * eyes, nothing on its head. It is `blue_beret` with the hat taken off and the paint changed,
+ * so Bloom retargets that preset's animation onto it; change it here and nowhere else.
  */
-const ALIA_AVATAR: AvatarConfig = {
-  ...DEFAULT_CONFIG,
-  character: {
-    preset: 'blue_beret',
-    selections: {
-      shape: 'six_lobed_flower',
-      color: 'orchid',
-      eyes: 'oval',
-      eyewear: 'none',
-      accessory: 'none',
-    },
-  },
-};
+const ALIA_AVATAR: AvatarCharacter = { preset: 'blue_beret', accessory: 'none', color: 'orchid' };
 
 const BUSY: ReadonlySet<AliaAvatarState> = new Set(['thinking', 'working']);
 
@@ -34,6 +22,8 @@ export interface AliaAvatarProps {
   interactive?: boolean;
   /** Change it to replay the avatar's reaction (a wave) — for a button that wraps it. */
   reactionKey?: number;
+  /** A still thumbnail instead of a live 3D avatar: for small, permanent spots like a sidebar. */
+  portrait?: boolean;
 }
 
 /**
@@ -41,11 +31,12 @@ export interface AliaAvatarProps {
  * app must mount `AgentAvatarProvider` with the URL of the hosted `character-runtime`;
  * without it Bloom shows its own "unavailable" state.
  */
-export function AliaAvatar({
+export const AliaAvatar = memo(function AliaAvatar({
   size,
   state = 'idle',
   interactive = false,
   reactionKey,
+  portrait = false,
 }: AliaAvatarProps) {
   const [workingKey, setWorkingKey] = useState(0);
   const busy = BUSY.has(state);
@@ -55,12 +46,13 @@ export function AliaAvatar({
 
   return (
     <AgentAvatar
-      config={ALIA_AVATAR}
+      character={ALIA_AVATAR}
       size={size}
       label="Alia"
       workingKey={workingKey}
       interactive={interactive}
       reactionKey={reactionKey}
+      portrait={portrait}
     />
   );
-}
+});

package/src/components/AliaChatContent.tsx

@@ -7,17 +7,8 @@
  * breadcrumb header is Bloom's `AiChatContainer`, the one the app's conversation uses.
  */
 
-import React, {
-  createContext,
-  Suspense,
-  useContext,
-  useState,
-  useCallback,
-  useEffect,
-  useMemo,
-  useRef,
-} from 'react';
-import { View, StyleSheet } from 'react-native';
+import React, { Suspense, useState, useCallback, useEffect, useMemo, useRef } from 'react';
+import { View } from 'react-native';
 import { useAliaChat, type UseAliaChatOptions } from '../hooks/useAliaChat';
 import { useTTS } from '../hooks/useTTS';
 import { useSpeechToText } from '../hooks/useSpeechToText';
@@ -34,7 +25,7 @@ import { RiImageLine } from '@oxy.so/bloom/icons';
 import { toast } from '@oxy.so/bloom/toast';
 import { Button } from '@oxy.so/bloom/button';
 import { type AliaChatLabels, AliaChatLabelsProvider, useLabels } from '../lib/labels';
-import { AliaAvatar, type AliaAvatarState } from './AliaAvatar';
+import type { AliaAvatarState } from './AliaAvatar';
 import { VoiceModeIcon } from './VoiceModeIcon';
 import type { ChatMessage, VoiceMessage, VoiceSessionComponent, VoiceSessionState } from '../types';
 
@@ -56,17 +47,12 @@ export interface AliaChatContentProps {
   onRejectPlan?: (planId: string) => void;
   /** Override markdown renderer (app passes CustomMarkdown) */
   renderMarkdown?: (content: string) => React.ReactNode;
-  /** Breadcrumb title beside the brand mark. Default `Alia`; `null` drops the breadcrumb. */
-  title?: string | null;
-  /**
-   * Above the breadcrumb row — a back button, a menu, or a whole custom header
-   * (given `title={null}`). A function receives the clear handler.
-   */
-  headerLeading?:
-    | React.ReactNode
-    | ((state: { hasMessages: boolean; clear: () => void }) => React.ReactNode);
-  /** Right end of the breadcrumb row; receives the clear handler. Replaces Bloom's share/more. */
-  actions?: (state: { hasMessages: boolean; clear: () => void }) => React.ReactNode;
+  /** The chat's top bar. Receives what it needs from the chat: whether there is anything to clear, how, and what Alia is doing. */
+  header?: (state: {
+    hasMessages: boolean;
+    clear: () => void;
+    markState: AliaAvatarState;
+  }) => React.ReactNode;
   /** Dark-mode flag — forwarded to the ambient wave overlay. */
   isDarkMode?: boolean;
   /**
@@ -81,19 +67,6 @@ export interface AliaChatContentProps {
   labels?: Partial<AliaChatLabels>;
 }
 
-/** The live state of the chat, read by the avatar wherever the header or welcome draws it. */
-const MarkStateContext = createContext<AliaAvatarState>('idle');
-
-/** Alia's avatar at any size, following the chat's live state. */
-export function AliaChatMark({ size, reactionKey }: { size: number; reactionKey?: number }) {
-  return <AliaAvatar size={size} state={useContext(MarkStateContext)} reactionKey={reactionKey} />;
-}
-
-/** `AiChatContainer`'s `projectIcon` takes a component that is handed its size as `width`. */
-function BreadcrumbMark({ width }: { width?: number }) {
-  return <AliaChatMark size={width ?? 16} />;
-}
-
 /** The add menu: photos are the one attachment the chat API carries (`image_url` parts). */
 function addMenu(labels: AliaChatLabels): ComposerPanelAddMenuGroup[] {
   return [
@@ -131,9 +104,7 @@ function AliaChatContentBody({
   onApprovePlan,
   onRejectPlan,
   renderMarkdown,
-  title = 'Alia',
-  headerLeading,
-  actions,
+  header,
   isDarkMode,
   voiceSession: VoiceSession,
   onStopReady,
@@ -162,7 +133,9 @@ function AliaChatContentBody({
   const [inputValue, setInputValue] = useState('');
 
   // Picked photos wait here, as tiles above the field, until the turn is sent.
-  const [photos, setPhotos] = useState<Array<{ id: string; name: string; uri: string }>>([]);
+  const [photos, setPhotos] = useState<
+    Array<{ id: string; name: string; uri: string; mimeType?: string }>
+  >([]);
   const { pickImage } = useImagePicker();
 
   const handleAddMenuSelect = useCallback(
@@ -176,6 +149,7 @@ function AliaChatContentBody({
           id: `img-${Date.now()}-${Math.random().toString(36).slice(2)}`,
           name: asset.name,
           uri: asset.uri,
+          mimeType: asset.mimeType,
         })),
       ]);
     },
@@ -190,7 +164,9 @@ function AliaChatContentBody({
       setInputValue('');
       setPhotos([]);
       try {
-        const images = await Promise.all(pending.map((photo) => imageUriToDataUrl(photo.uri)));
+        const images = await Promise.all(
+          pending.map((photo) => imageUriToDataUrl(photo.uri, photo.mimeType)),
+        );
         send(text, { images });
       } catch (err) {
         // Keep the draft: the photos could not be read, nothing was sent.
@@ -237,11 +213,13 @@ function AliaChatContentBody({
     setMessages([...textSnapshotRef.current, ...voiceMessages.map(adaptVoiceMessage)]);
   }, [voiceMessages, setMessages]);
 
+  const messagesRef = useRef(messages);
+  messagesRef.current = messages;
   const activateVoice = useCallback(() => {
     if (isVoiceActive) return;
-    textSnapshotRef.current = [...messages];
+    textSnapshotRef.current = [...messagesRef.current];
     setIsVoiceActive(true);
-  }, [isVoiceActive, messages]);
+  }, [isVoiceActive]);
 
   // Unmounting the session disconnects the room; the transcript merged above
   // stays in the chat.
@@ -258,11 +236,12 @@ function AliaChatContentBody({
   );
 
   // ── TTS read aloud handler ──
+  const { readAloud } = tts;
   const handleReadAloud = useCallback(
     (messageId: string, text: string) => {
-      tts.readAloud(messageId, text);
+      readAloud(messageId, text);
     },
-    [tts],
+    [readAloud],
   );
 
   // ── Mark state (drives the header brand mark) ──
@@ -329,6 +308,17 @@ function AliaChatContentBody({
     [VoiceSession, activateVoice, labels.startVoice],
   );
 
+  const pillAttachments = useMemo(
+    () =>
+      photos.map((photo) => ({
+        id: photo.id,
+        name: photo.name,
+        kind: 'image' as const,
+        src: photo.uri,
+      })),
+    [photos],
+  );
+
   const composer =
     VoiceSession && isVoiceActive ? (
       /* Suspense so the session may be handed to us as a React.lazy import. */
@@ -350,12 +340,7 @@ function AliaChatContentBody({
             placeholder={labels.placeholder}
             addMenu={addMenuGroups}
             onAddMenuSelect={handleAddMenuSelect}
-            attachments={photos.map((photo) => ({
-              id: photo.id,
-              name: photo.name,
-              kind: 'image' as const,
-              src: photo.uri,
-            }))}
+            attachments={pillAttachments}
             onRemoveAttachment={(id) => setPhotos((prev) => prev.filter((p) => p.id !== id))}
             voiceState={
               stt.isTranscribing ? 'transcribing' : stt.isRecording ? 'recording' : 'idle'
@@ -366,63 +351,56 @@ function AliaChatContentBody({
       </>
     );
 
+  const hasMessages = messages.length > 0;
+  const headerNode = useMemo(
+    () => header?.({ hasMessages, clear, markState }),
+    [header, hasMessages, clear, markState],
+  );
+  const background = useMemo(
+    () => (
+      <AmbientField
+        layout="sheet"
+        waveAmplitude={wave.waveAmplitude}
+        agentState={wave.agentState}
+        intensity={ambientIntensity}
+        isDarkMode={isDarkMode}
+      />
+    ),
+    [wave.waveAmplitude, wave.agentState, ambientIntensity, isDarkMode],
+  );
+
   return (
-    <MarkStateContext.Provider value={markState}>
-      <AiChatContainer
-        project={title ?? undefined}
-        projectIcon={BreadcrumbMark}
-        header={
-          typeof headerLeading === 'function'
-            ? headerLeading({ hasMessages: messages.length > 0, clear })
-            : headerLeading
-        }
-        actions={actions?.({ hasMessages: messages.length > 0, clear })}
-        composer={composer}
-        // The thread scrolls behind the header and the composer, which fade in over it — as
-        // in the app's conversation. The wave is the container's background layer, between
-        // its surface and the turns.
-        floatingChrome
-        background={
-          <AmbientField
-            waveAmplitude={wave.waveAmplitude}
-            agentState={wave.agentState}
-            intensity={ambientIntensity}
-            isDarkMode={isDarkMode}
-          />
-        }
-      >
-        <View style={styles.body}>
-          {/* Welcome or Messages */}
-          <AliaChatMessageList
-            messages={messages}
-            isStreaming={isStreaming}
-            onReadAloud={handleReadAloud}
-            ttsActiveMessageId={tts.activeMessageId}
-            ttsPlaybackState={tts.playbackState}
-            onEditMessage={onEditMessage}
-            onThumbsUp={onThumbsUp}
-            onThumbsDown={onThumbsDown}
-            onApprovePlan={onApprovePlan}
-            onRejectPlan={onRejectPlan}
-            renderMarkdown={renderMarkdown}
-            welcomeComponent={welcomeComponent}
-          />
-        </View>
-      </AiChatContainer>
-    </MarkStateContext.Provider>
+    <AiChatContainer
+      header={headerNode}
+      composer={composer}
+      // The thread scrolls behind the header and the composer, which fade in over it — as
+      // in the app's conversation. The wave is the container's background layer, between
+      // its surface and the turns.
+      floatingChrome
+      background={background}
+    >
+      <View className="flex-1">
+        {/* Welcome or Messages */}
+        <AliaChatMessageList
+          messages={messages}
+          isStreaming={isStreaming}
+          onReadAloud={handleReadAloud}
+          ttsActiveMessageId={tts.activeMessageId}
+          ttsPlaybackState={tts.playbackState}
+          onEditMessage={onEditMessage}
+          onThumbsUp={onThumbsUp}
+          onThumbsDown={onThumbsDown}
+          onApprovePlan={onApprovePlan}
+          onRejectPlan={onRejectPlan}
+          onAnswerQuestions={(message) => send(message)}
+          renderMarkdown={renderMarkdown}
+          welcomeComponent={welcomeComponent}
+        />
+      </View>
+    </AiChatContainer>
   );
 }
 
-const styles = StyleSheet.create({
-  container: {
-    flex: 1,
-    position: 'relative',
-  },
-  body: {
-    flex: 1,
-  },
-});
-
 /** The chat: header, thread and composer, with the host's labels in reach of all of it. */
 export function AliaChatContent({ labels, ...props }: AliaChatContentProps) {
   return (

package/src/components/AliaChatHeader.tsx

@@ -1,14 +1,15 @@
 import { ButtonGroup, ButtonGroupItem } from '@oxy.so/bloom/button-group';
 import { RiCloseLine, RiDeleteBin6Line } from '@oxy.so/bloom/icons';
 import { PageHeader } from '@oxy.so/bloom/page-header';
-import { useTheme } from '@oxy.so/bloom/theme';
 import { Text } from '@oxy.so/bloom/typography';
-import { type ReactNode, useState } from 'react';
-import { Pressable, StyleSheet, View } from 'react-native';
+import { memo, type ReactNode, useState } from 'react';
+import { Pressable, View } from 'react-native';
 import { useLabels } from '../lib/labels';
-import { AliaChatMark } from './AliaChatContent';
+import { AliaAvatar, type AliaAvatarState } from './AliaAvatar';
 
 export interface AliaChatHeaderProps {
+  /** What Alia is doing; the avatar shows it. */
+  markState: AliaAvatarState;
   /** The chat has messages to clear. */
   hasMessages: boolean;
   onClear: () => void;
@@ -29,9 +30,7 @@ export interface AliaChatHeaderProps {
  * of radius 14, `backgroundSecondary` with a hairline border) but is not exported, so
  * this repeats its geometry. Use Bloom's component when it is.
  */
-function AliaProfile({ onPress }: { onPress?: () => void }) {
-  const { colors } = useTheme();
-  const [hovered, setHovered] = useState(false);
+function AliaProfile({ markState, onPress }: { markState: AliaAvatarState; onPress?: () => void }) {
   const [reactionKey, setReactionKey] = useState(0);
 
   // Without a host action the profile is still a button: the avatar waves back.
@@ -45,21 +44,14 @@ function AliaProfile({ onPress }: { onPress?: () => void }) {
       accessibilityRole="button"
       accessibilityLabel="Alia"
       onPress={handlePress}
-      onHoverIn={() => setHovered(true)}
-      onHoverOut={() => setHovered(false)}
-      className="items-center"
+      className="group/profile items-center"
     >
-      <View pointerEvents="none" style={{ marginBottom: -2, zIndex: 1 }}>
-        <AliaChatMark size={56} reactionKey={reactionKey} />
+      <View pointerEvents="none" className="z-10 -mb-0.5">
+        <AliaAvatar size={56} state={markState} reactionKey={reactionKey} />
       </View>
       <View
         pointerEvents="none"
-        className="items-center justify-center rounded-[14px] px-2.5 py-1"
-        style={{
-          backgroundColor: hovered ? colors.backgroundTertiary : colors.backgroundSecondary,
-          borderWidth: StyleSheet.hairlineWidth,
-          borderColor: colors.border,
-        }}
+        className="items-center justify-center rounded-[14px] border border-border-secondary bg-background-secondary-default px-2.5 py-1 group-hover/profile:bg-background-tertiary-default"
       >
         <Text numberOfLines={1} className="text-[16px] font-medium leading-5 text-text-primary">
           Alia
@@ -73,7 +65,8 @@ function AliaProfile({ onPress }: { onPress?: () => void }) {
  * The chat's top bar: Bloom's `PageHeader`, set up as the shell sets it up for the
  * agents' screens (inline, no scrim, no safe area), with Alia's profile as its title.
  */
-export function AliaChatHeader({
+export const AliaChatHeader = memo(function AliaChatHeader({
+  markState,
   hasMessages,
   onClear,
   onClose,
@@ -85,7 +78,7 @@ export function AliaChatHeader({
   return (
     <PageHeader
       leading={leading}
-      title={<AliaProfile onPress={onProfilePress} />}
+      title={<AliaProfile markState={markState} onPress={onProfilePress} />}
       titleAlign="center"
       actions={
         <>
@@ -115,4 +108,4 @@ export function AliaChatHeader({
       safeArea={false}
     />
   );
-}
+});

package/src/components/AliaChatMessageList.tsx

@@ -33,6 +33,8 @@ import {
 } from '@oxy.so/bloom/icons';
 import { ThinkingBlock } from './ThinkingBlock';
 import { PlanPreviewCard } from './PlanPreviewCard';
+import { QuestionCard } from './QuestionCard';
+import { askedQuestions, isQuestionInvocation } from '../lib/questions';
 import { chatMessageEnter } from '../animations';
 import { getToolLabel, getToolActiveLabel, getResearchActiveLabel } from '../lib/tool-registry';
 import { getTextFromContent, getImagesFromContent } from '../lib/content-utils';
@@ -67,6 +69,8 @@ export interface AliaChatMessageListProps {
   onThumbsDown?: (messageId: string) => void;
   onApprovePlan?: (planId: string) => void;
   onRejectPlan?: (planId: string) => void;
+  /** Sends the answers to Alia's questions as the person's next message. */
+  onAnswerQuestions?: (message: string) => void;
   // Welcome
   welcomeComponent?: React.ReactNode;
   // Markdown renderer override (app passes CustomMarkdown, SDK uses AliaMarkdown)
@@ -150,11 +154,7 @@ const UserBubble = React.memo(function UserBubble({
             <AiChatMessageLine block>
               <View className="flex-row flex-wrap gap-2">
                 {images.map((imgUrl) => (
-                  <View
-                    key={imgUrl}
-                    className="rounded-xl overflow-hidden"
-                    style={{ width: 120, height: 120 }}
-                  >
+                  <View key={imgUrl} className="size-[120px] overflow-hidden rounded-xl">
                     <ExpoImage
                       source={{ uri: imgUrl }}
                       className="w-full h-full"
@@ -188,6 +188,7 @@ const AssistantMessage = React.memo(function AssistantMessage({
   onThumbsDown,
   onApprovePlan,
   onRejectPlan,
+  onAnswerQuestions,
   renderMarkdown,
 }: {
   message: ChatMessage;
@@ -203,6 +204,7 @@ const AssistantMessage = React.memo(function AssistantMessage({
   onThumbsDown?: (messageId: string) => void;
   onApprovePlan?: (planId: string) => void;
   onRejectPlan?: (planId: string) => void;
+  onAnswerQuestions?: (message: string) => void;
   renderMarkdown?: (content: string) => React.ReactNode;
 }) {
   const labels = useLabels();
@@ -217,8 +219,16 @@ const AssistantMessage = React.memo(function AssistantMessage({
     () => webSearchLog(toolInvocations, researchProgress, { t: labels.workLog }),
     [toolInvocations, researchProgress, labels.workLog],
   );
+  // The questions Alia asked, drawn as a card. Answerable only on the last message once the
+  // turn is over; any later message (typed or sent from the card) is the answer.
+  const questions = useMemo(
+    () => (toolInvocations ?? []).flatMap((inv) => askedQuestions(inv) ?? []),
+    [toolInvocations],
+  );
   const taskLog = useMemo(() => {
-    const tasks = (toolInvocations ?? []).filter((inv) => !isWebInvocation(inv));
+    const tasks = (toolInvocations ?? []).filter(
+      (inv) => !isWebInvocation(inv) && !isQuestionInvocation(inv),
+    );
     return tasks.length === 0 || isStreamingThis
       ? null
       : taskListLog(tasks, false, { t: labels.workLog });
@@ -338,6 +348,16 @@ const AssistantMessage = React.memo(function AssistantMessage({
         </View>
       )}
 
+      {questions.length === 0 ? null : (
+        <QuestionCard
+          questions={questions}
+          onSubmit={
+            isLastMessage && !isLoading && onAnswerQuestions !== undefined
+              ? onAnswerQuestions
+              : undefined
+          }
+        />
+      )}
       {thinkingIndicator}
     </View>
   );
@@ -356,6 +376,7 @@ export function AliaChatMessageList({
   onThumbsDown,
   onApprovePlan,
   onRejectPlan,
+  onAnswerQuestions,
   welcomeComponent,
   renderMarkdown,
 }: AliaChatMessageListProps) {
@@ -459,6 +480,7 @@ export function AliaChatMessageList({
                     onThumbsDown={onThumbsDown}
                     onApprovePlan={onApprovePlan}
                     onRejectPlan={onRejectPlan}
+                    onAnswerQuestions={onAnswerQuestions}
                     renderMarkdown={renderMarkdown}
                   />
                 )}

package/src/components/AliaChatScreen.tsx

@@ -17,12 +17,11 @@
  * `livekit-client` never enters the bundle.
  */
 
-import React from 'react';
-import { useTheme } from '@oxy.so/bloom/theme';
+import React, { useCallback } from 'react';
 import { View } from 'react-native';
 import { useSafeAreaInsets } from 'react-native-safe-area-context';
 import { KeyboardAvoidingView } from '../lib/keyboard';
-import { AliaChatContent } from './AliaChatContent';
+import { AliaChatContent, type AliaChatContentProps } from './AliaChatContent';
 import { AliaChatHeader } from './AliaChatHeader';
 import type { WelcomeSuggestion } from './AliaWelcomeMessage';
 import type { AliaChatLabels } from '../lib/labels';
@@ -67,7 +66,18 @@ export function AliaChatScreen({
   labels,
 }: AliaChatScreenProps) {
   const insets = useSafeAreaInsets();
-  const { colors } = useTheme();
+  const header = useCallback<NonNullable<AliaChatContentProps['header']>>(
+    ({ hasMessages, clear, markState }) => (
+      <AliaChatHeader
+        markState={markState}
+        hasMessages={hasMessages}
+        onClear={clear}
+        leading={headerLeft}
+        trailing={headerRight}
+      />
+    ),
+    [headerLeft, headerRight],
+  );
 
   // The screen owns the whole window, so it keeps its composer out of both
   // system bars: the top inset clears the status bar, the bottom one the
@@ -81,12 +91,8 @@ export function AliaChatScreen({
   // this deep in a host's tree, which is why the offset is measured.)
   return (
     <View
-      className="flex-1"
-      style={{
-        backgroundColor: colors.background,
-        paddingTop: insets.top,
-        paddingBottom: insets.bottom,
-      }}
+      className="flex-1 bg-background-full"
+      style={{ paddingTop: insets.top, paddingBottom: insets.bottom }}
     >
       <KeyboardAvoidingView behavior="padding" automaticOffset style={{ flex: 1 }}>
         <AliaChatContent
@@ -99,15 +105,7 @@ export function AliaChatScreen({
           isDarkMode={isDarkMode}
           voiceSession={voiceSession}
           labels={labels}
-          title={null}
-          headerLeading={({ hasMessages, clear }) => (
-            <AliaChatHeader
-              hasMessages={hasMessages}
-              onClear={clear}
-              leading={headerLeft}
-              trailing={headerRight}
-            />
-          )}
+          header={header}
         />
       </KeyboardAvoidingView>
     </View>

package/src/components/AliaChatSheet.tsx

@@ -3,7 +3,7 @@ import { forwardRef, useCallback, useImperativeHandle, useRef } from 'react';
 import { useColorScheme, View } from 'react-native';
 import type { AliaChatLabels } from '../lib/labels';
 import type { VoiceSessionComponent } from '../types';
-import { AliaChatContent } from './AliaChatContent';
+import { AliaChatContent, type AliaChatContentProps } from './AliaChatContent';
 import { AliaChatHeader } from './AliaChatHeader';
 import type { WelcomeSuggestion } from './AliaWelcomeMessage';
 
@@ -90,6 +90,22 @@ export const AliaChatSheet = forwardRef<AliaChatSheetRef, AliaChatSheetProps>(
       return true;
     }, [stopChat]);
 
+    // The top padding clears the 28px drag handle, which Bloom floats over the content instead
+    // of reserving room for. Stable, so the chat's memoised header only re-renders when it must.
+    const header = useCallback<NonNullable<AliaChatContentProps['header']>>(
+      ({ hasMessages, clear, markState }) => (
+        <View className="pt-8">
+          <AliaChatHeader
+            markState={markState}
+            hasMessages={hasMessages}
+            onClear={clear}
+            onClose={handleDismiss}
+          />
+        </View>
+      ),
+      [handleDismiss],
+    );
+
     return (
       <BottomSheet
         ref={sheetRef}
@@ -113,12 +129,7 @@ export const AliaChatSheet = forwardRef<AliaChatSheetRef, AliaChatSheetProps>(
           onStopReady={registerChatStop}
           // The top padding clears the 28px drag handle, which Bloom floats over the content
           // instead of reserving room for.
-          title={null}
-          headerLeading={({ hasMessages, clear }) => (
-            <View className="pt-8">
-              <AliaChatHeader hasMessages={hasMessages} onClear={clear} onClose={handleDismiss} />
-            </View>
-          )}
+          header={header}
         />
       </BottomSheet>
     );

package/src/components/AmbientField.tsx

@@ -1,4 +1,4 @@
-import { useEffect, useRef, useState } from 'react';
+import { memo, useEffect, useRef, useState } from 'react';
 import { AppState, Platform, View, type LayoutChangeEvent, type ViewStyle } from 'react-native';
 import Animated, {
   cancelAnimation,
@@ -55,16 +55,16 @@ const EXIT_EASE = Easing.bezier(0.2, 0.7, 0.2, 1);
 const PULSE_DURATION = 900;
 
 /**
- * A field shorter than a phone screen (the chat's sheet) is not drawn at its own scale: the
- * blobs are sized in `vmax` of the field, which would be its small side, and laid out across
- * its width, which would pile them on the centre. It takes the blob size of a phone screen,
- * and its blobs are spread wider (`SHORT_FIELD_SPREAD`), cropped by its edges — the blue, warm
- * and green of the intro side by side, not one smudge in the middle.
+ * How the field lays itself out in a container that is not a screen. The blobs are sized in
+ * `vmax` of the field and laid out across its width, which on a short, wide card (the chat's
+ * sheet) would make them half as big and pile them on the centre. The `sheet` layout draws
+ * them at the size of a phone screen (`reference`), spread wider across the width (`spread`)
+ * and shifted back toward the right (`shift`, a share of the width, since the spread leaves the
+ * composition leaning left), cropped by the card's edges: the blue, warm and green of the
+ * intro side by side. Asked for, not inferred from the height, so a short app screen is
+ * never reinterpreted.
  */
-const MIN_FIELD_REFERENCE = 800;
-const SHORT_FIELD_SPREAD = 1.4;
-/** The spread leaves the composition leaning left; this much of the width puts it back. */
-const SHORT_FIELD_SHIFT = 0.17;
+const SHEET_LAYOUT = { reference: 800, spread: 1.4, shift: 0.17 } as const;
 
 /** One keyframe stop of a float loop: [translateX in vw, translateY in vh, scale]. */
 type FloatStop = readonly [number, number, number];
@@ -368,6 +368,8 @@ function Flourish({
 }
 
 export interface AmbientFieldProps {
+  /** `screen` (default) fills a page; `sheet` is for a short card, see `SHEET_LAYOUT`. */
+  layout?: 'screen' | 'sheet';
   /**
    * Combined amplitude from `useAmbientWave` — swells and brightens the blobs.
    * Omit where there is no audio (the intro) and the field simply rests.
@@ -420,7 +422,8 @@ export interface AmbientFieldProps {
  * layer, nothing is seen THROUGH it, and the translucent surfaces over it are
  * Bloom's, which follow that setting themselves.
  */
-export function AmbientField({
+export const AmbientField = memo(function AmbientField({
+  layout = 'screen',
   waveAmplitude,
   agentState = 'idle',
   intensity = 1,
@@ -487,11 +490,11 @@ export function AmbientField({
     setField({ width, height });
   };
 
-  const short = field.height > 0 && field.height < MIN_FIELD_REFERENCE;
-  const vw = (field.width / 100) * (short ? SHORT_FIELD_SPREAD : 1);
+  const sheet = layout === 'sheet';
+  const vw = (field.width / 100) * (sheet ? SHEET_LAYOUT.spread : 1);
   const vh = field.height / 100;
-  const vmax = Math.max(field.width, field.height, short ? MIN_FIELD_REFERENCE : 0) / 100;
-  const shiftX = short ? field.width * SHORT_FIELD_SHIFT : 0;
+  const vmax = Math.max(field.width, field.height, sheet ? SHEET_LAYOUT.reference : 0) / 100;
+  const shiftX = sheet ? field.width * SHEET_LAYOUT.shift : 0;
 
   const fieldStyle = useAnimatedStyle(() => ({
     // On the way out the field keeps 45% of its opacity, sinking as it goes.
@@ -572,6 +575,6 @@ export function AmbientField({
       ) : null}
     </View>
   );
-}
+});
 
 export { PARALLAX_DURATION, PARALLAX_EASE };

package/src/components/IdentityMark.tsx

@@ -1,5 +1,6 @@
 import { useState } from 'react';
 import { Pressable, View } from 'react-native';
+import type { AliaAvatarState } from './AliaAvatar';
 import * as Haptics from 'expo-haptics';
 import Svg, { Path } from 'react-native-svg';
 import Animated, {
@@ -13,7 +14,8 @@ import Animated, {
   Easing,
 } from 'react-native-reanimated';
 
-export type IdentityMarkState = 'idle' | 'thinking' | 'working' | 'writing';
+/** What the mark is doing: the same states as the avatar's. */
+export type IdentityMarkState = AliaAvatarState;
 
 export interface IdentityMarkProps {
   /** Width & height in px. Default 24. */

package/src/components/QuestionCard.tsx

@@ -0,0 +1,62 @@
+import { Questionnaire, type QuestionnaireAnswers } from '@oxy.so/bloom/questionnaire';
+import { Muted } from '@oxy.so/bloom/typography';
+import { View } from 'react-native';
+import { type AskedQuestion, formatAnswers } from '../lib/questions';
+
+interface QuestionCardProps {
+  questions: AskedQuestion[];
+  /** Sends the answers as the person's next message. Absent: the card is read-only. */
+  onSubmit?: (message: string) => void;
+}
+
+/** Ids are positions: the questions are the model's, and carry none. */
+const idOf = (index: number) => `q${index}`;
+
+/**
+ * The questions Alia asked: Bloom's `Questionnaire` while the person can still answer, and
+ * the questions as plain lines once they have (the answer is their message, right below).
+ * Typing a reply in the composer answers just as well, which is why there is no dismiss.
+ */
+export function QuestionCard({ questions, onSubmit }: QuestionCardProps) {
+  if (onSubmit === undefined) {
+    return (
+      <View className="my-2 gap-1">
+        {questions.map((q, i) => (
+          // The model's questions never reorder: the position is the identity.
+          // biome-ignore lint/suspicious/noArrayIndexKey: see above
+          <Muted key={i}>{q.question}</Muted>
+        ))}
+      </View>
+    );
+  }
+
+  const complete = (answers: QuestionnaireAnswers) =>
+    onSubmit(
+      formatAnswers(
+        questions,
+        questions.map((_, i) => ({
+          picked: (answers[idOf(i)]?.values ?? []).map(Number),
+          other: answers[idOf(i)]?.other,
+        })),
+      ),
+    );
+
+  return (
+    <View className="my-2">
+      <Questionnaire
+        questions={questions.map((q, i) => ({
+          id: idOf(i),
+          question: q.question,
+          select: q.multiSelect ? 'multiple' : 'single',
+          other: true,
+          options: q.options.map((option, index) => ({
+            value: String(index),
+            label: option.label,
+            description: option.description,
+          })),
+        }))}
+        onComplete={complete}
+      />
+    </View>
+  );
+}

package/src/index.ts

@@ -22,6 +22,14 @@ export { AliaMarkdown } from './components/Markdown';
 export type { AliaMarkdownProps, RenderCodeBlock } from './components/Markdown';
 export { AliaWelcomeMessage } from './components/AliaWelcomeMessage';
 export { PlanPreviewCard } from './components/PlanPreviewCard';
+export { QuestionCard } from './components/QuestionCard';
+export {
+  ASK_USER_QUESTION_TOOL,
+  askedQuestions,
+  formatAnswers,
+  isQuestionInvocation,
+} from './lib/questions';
+export type { AskedOption, AskedQuestion, QuestionAnswer } from './lib/questions';
 
 // ── Chat hook ──
 export { useAliaChat } from './hooks/useAliaChat';
@@ -75,13 +83,7 @@ export { getTextFromContent, getImagesFromContent } from './lib/content-utils';
 // ── The turn's work log: tool calls as Bloom's `WebSearch` and `TaskList` ──
 export { isWebInvocation, taskListLog, webSearchLog } from './lib/work-log';
 export type { LiveResearch, TaskListLog, WebSearchLog, WorkLogOptions } from './lib/work-log';
-export { englishWorkLog } from './lib/work-log-copy';
-export type { Translate } from './lib/work-log-copy';
-export { getToolDoneLabel, getToolPillLabel } from './lib/task-labels';
-export { extractCitationSources } from './lib/citations';
-export type { CitationSource } from './lib/citations';
-export { toolCallStatus } from './lib/tool-call-status';
-export type { ToolCallStatus } from './lib/tool-call-status';
+// The pure parts (call status, citations, tool labels, `Translate`) are `@alia.onl/sdk/tools`.
 
 // ── Picker hooks ──
 export { useImagePicker } from './hooks/useImagePicker';

package/src/lib/chat-stream.ts

@@ -1,4 +1,5 @@
 import type { PlanStep, ResearchProgress, ResearchSource } from '../types';
+import { ASK_USER_QUESTION_TOOL } from './questions';
 
 const MAX_STREAM_BYTES = 8 * 1024 * 1024;
 const MAX_STREAM_LINES = 65_536;
@@ -579,6 +580,10 @@ export async function consumeAliaChatStream(
     }
     for (const event of parsed.events) {
       if (event.kind === 'content' && event.content.trim().length > 0) answerReceived = true;
+      // A turn that ends at a question card is answered by the card, even with no sentence before it.
+      if (event.kind === 'tool_call' && event.toolName === ASK_USER_QUESTION_TOOL) {
+        answerReceived = true;
+      }
       onEvent(event);
     }
     if (parsed.finishReason !== null) {

package/src/lib/citations.ts

@@ -1,4 +1,5 @@
 import type { ToolInvocation } from '../types';
+import { domainOf } from './domain';
 
 export interface CitationSource {
   /** The citation number, as it appears in `[n]`. */
@@ -14,14 +15,6 @@ interface PersistedResearchSource {
   title?: unknown;
 }
 
-function domainOf(url: string): string {
-  try {
-    return new URL(url).hostname.replace(/^www\./, '');
-  } catch {
-    return url;
-  }
-}
-
 /**
  * The numbered sources of a research answer.
  *
@@ -43,8 +36,8 @@ export function extractCitationSources(
     const title =
       typeof raw.title === 'string' && raw.title.trim().length > 0
         ? raw.title.trim()
-        : domainOf(url);
-    byId.set(id, { id, url, title, domain: domainOf(url) });
+        : domainOf(url, { stripWww: true });
+    byId.set(id, { id, url, title, domain: domainOf(url, { stripWww: true }) });
   };
 
   for (const inv of toolInvocations ?? []) {

package/src/lib/domain.ts

@@ -0,0 +1,12 @@
+/**
+ * The host of a URL, or the string itself when it is not one. Citations drop a leading `www.`
+ * (the number in `[3]` names a site); a source row in the work log keeps the host as served.
+ */
+export function domainOf(url: string, { stripWww = false }: { stripWww?: boolean } = {}): string {
+  try {
+    const host = new URL(url).hostname;
+    return stripWww ? host.replace(/^www\./, '') : host;
+  } catch {
+    return url;
+  }
+}

package/src/lib/image-data-url.ts

@@ -1,15 +1,36 @@
+import * as FileSystem from 'expo-file-system';
+import { Platform } from 'react-native';
+
 /**
- * Reads a picked image (a `file://` URI on native, a `blob:` URL on web) into a
- * `data:` URL, the one form the chat API accepts as an `image_url` part without
- * the server having to reach the device.
+ * Reads a picked image into a `data:` URL, the one form the chat API accepts as an `image_url`
+ * part without the server having to reach the device. The picker's URI means nothing off the
+ * device: on web it is a `blob:` URL (a handle into this tab's memory), on native a `file://`
+ * path, and sent as it is either arrives as a string the model cannot open.
+ *
+ * Web reads the blob back; native reads the file with `expo-file-system`, as the Alia app does.
  */
-export async function imageUriToDataUrl(uri: string): Promise<string> {
+export async function imageUriToDataUrl(uri: string, mimeType?: string): Promise<string> {
   if (uri.startsWith('data:')) return uri;
+  if (Platform.OS !== 'web') {
+    const base64 = await FileSystem.readAsStringAsync(uri, {
+      encoding: FileSystem.EncodingType.Base64,
+    });
+    return `data:${mimeType || 'image/jpeg'};base64,${base64}`;
+  }
   const blob = await (await fetch(uri)).blob();
   return await new Promise<string>((resolve, reject) => {
     const reader = new FileReader();
     reader.onerror = () => reject(reader.error ?? new Error('Could not read the image'));
-    reader.onload = () => resolve(String(reader.result));
+    reader.onload = () => {
+      const result = String(reader.result);
+      // `readAsDataURL` stamps the blob's own type; it is only octet-stream when the blob has
+      // none, and then the picker's type is the better guess.
+      resolve(
+        mimeType && result.startsWith('data:application/octet-stream')
+          ? result.replace('data:application/octet-stream', `data:${mimeType}`)
+          : result,
+      );
+    };
     reader.readAsDataURL(blob);
   });
 }

package/src/lib/questions.ts

@@ -0,0 +1,78 @@
+// The clarifying questions an assistant turn asked, read back from the stored tool call.
+//
+// The server's `askUserQuestion` ends the turn at the card, so the question IS the tool
+// call: it is stored with the message, survives a reload, and is answered by the person's
+// next message. Pure functions, no React Native, so a host's models and tests can use them.
+
+import type { ToolInvocation } from '../types';
+
+/** The tool's name on the wire. */
+export const ASK_USER_QUESTION_TOOL = 'askUserQuestion';
+
+export interface AskedOption {
+  label: string;
+  description?: string;
+}
+
+export interface AskedQuestion {
+  question: string;
+  options: AskedOption[];
+  multiSelect: boolean;
+}
+
+/** What the person picked for one question: option indexes, in option order, and typed text. */
+export interface QuestionAnswer {
+  picked: number[];
+  other?: string;
+}
+
+export const isQuestionInvocation = (inv: Pick<ToolInvocation, 'toolName'>): boolean =>
+  inv.toolName === ASK_USER_QUESTION_TOOL;
+
+const text = (value: unknown): string | null =>
+  typeof value === 'string' && value.trim() !== '' ? value.trim() : null;
+
+/**
+ * The questions of a finished call, or `null` when it is not one or its arguments are not
+ * drawable. Model output is data the app did not write: every field is checked, and a
+ * malformed card is no card rather than a thrown render.
+ */
+export function askedQuestions(inv: ToolInvocation): AskedQuestion[] | null {
+  if (!isQuestionInvocation(inv) || inv.state !== 'result') return null;
+  const raw = (inv.args as { questions?: unknown } | undefined)?.questions;
+  if (!Array.isArray(raw)) return null;
+
+  const questions: AskedQuestion[] = [];
+  for (const item of raw) {
+    const q = item as { question?: unknown; options?: unknown; multiSelect?: unknown };
+    const question = text(q.question);
+    if (question === null || !Array.isArray(q.options)) return null;
+    const options: AskedOption[] = [];
+    for (const o of q.options) {
+      const label = text((o as { label?: unknown })?.label);
+      if (label === null) return null;
+      const description = text((o as { description?: unknown }).description);
+      options.push(description === null ? { label } : { label, description });
+    }
+    if (options.length < 2) return null;
+    questions.push({ question, options, multiSelect: q.multiSelect === true });
+  }
+  return questions.length === 0 ? null : questions;
+}
+
+/**
+ * The answers as the message the person "sends": one line per question, so the thread reads
+ * as what they said and the model reads the same text. Language-neutral on purpose.
+ */
+export function formatAnswers(questions: AskedQuestion[], answers: QuestionAnswer[]): string {
+  return questions
+    .map((q, i) => {
+      const answer = answers[i];
+      const parts = [
+        ...(answer?.picked ?? []).map((index) => q.options[index]?.label),
+        answer?.other?.trim(),
+      ].filter((part): part is string => !!part);
+      return `${q.question}\n→ ${parts.join(', ')}`;
+    })
+    .join('\n\n');
+}

package/src/lib/task-labels.ts

@@ -1,46 +1,14 @@
 import { englishWorkLog, type Translate } from './work-log-copy';
 
-/** Tools that have a name of their own in the catalogue. Others are named from their id. */
-const NAMED_PILL = new Set([
-  'browse',
-  'webSearch',
-  'webScraper',
-  'generateFile',
-  'sendTelegramMessage',
-  'sendSlack',
-  'sendDiscord',
-  'sendSignal',
-  'sendEmail',
-  'delegateToAgent',
-  'askAgent',
-  // The API's app router: the model opening a connected app whose tools did not all fit in
-  // one request.
-  'useApps',
-  'agentSearch',
-  'userMemory',
-  'shellExec',
-  'fileEdit',
-  'codeInterpreter',
-]);
-
-/** Tools whose finished label differs from the running one; the rest read the same. */
-const NAMED_DONE = new Set([
-  'browse',
-  'webScraper',
-  'generateFile',
-  'delegateToAgent',
-  'askAgent',
-  'useApps',
-  'agentSearch',
-  'userMemory',
-  'shellExec',
-  'fileEdit',
-  'codeInterpreter',
-]);
+/** Whether the catalogue names this tool itself; otherwise the label is made from its id. */
+function isNamed(kind: 'pill' | 'done', toolName: string): boolean {
+  const key = `tasks.tool.${kind}.${toolName}`;
+  return englishWorkLog(key) !== key;
+}
 
 /** A tool's short label, in the reader's language when a translator is given. */
 export function getToolPillLabel(toolName: string, t: Translate = englishWorkLog): string {
-  if (NAMED_PILL.has(toolName)) return t(`tasks.tool.pill.${toolName}`);
+  if (isNamed('pill', toolName)) return t(`tasks.tool.pill.${toolName}`);
 
   // Oxy service tools: oxy_serviceName__toolName → "ServiceName"
   if (toolName.startsWith('oxy_')) {
@@ -61,7 +29,7 @@ export function getToolPillLabel(toolName: string, t: Translate = englishWorkLog
  * ("Telegram", "Email") read the same either way, so they fall back to the running label.
  */
 export function getToolDoneLabel(toolName: string, t: Translate = englishWorkLog): string {
-  return NAMED_DONE.has(toolName)
+  return isNamed('done', toolName)
     ? t(`tasks.tool.done.${toolName}`)
     : getToolPillLabel(toolName, t);
 }

package/src/lib/work-log.ts

@@ -10,6 +10,7 @@ import type { TaskListChip, TaskListStep, TaskListTask } from '@oxy.so/bloom/tas
 import type { WebSearchBrand, WebSearchSource, WebSearchStep } from '@oxy.so/bloom/web-search';
 import type { ToolInvocation } from '../types';
 import { extractCitationSources } from './citations';
+import { domainOf } from './domain';
 import { getToolDoneLabel, getToolPillLabel } from './task-labels';
 import { toolCallStatus } from './tool-call-status';
 import { englishWorkLog, type Translate } from './work-log-copy';
@@ -63,14 +64,6 @@ function str(value: unknown): string | undefined {
   return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
 }
 
-function domainOf(url: string): string {
-  try {
-    return new URL(url).hostname;
-  } catch {
-    return url;
-  }
-}
-
 /** The site marks Bloom draws, by registrable domain. Anything else is a quiet dot. */
 const BRANDS: Array<[string, WebSearchBrand]> = [
   ['github.com', 'github'],

package/src/tools.ts

@@ -3,8 +3,16 @@
 // words for a tool. They load no React Native, so a host's models and tests can use them.
 
 export { extractCitationSources } from './lib/citations';
+export { domainOf } from './lib/domain';
 export type { CitationSource } from './lib/citations';
 export { getToolDoneLabel, getToolPillLabel } from './lib/task-labels';
+export {
+  ASK_USER_QUESTION_TOOL,
+  askedQuestions,
+  formatAnswers,
+  isQuestionInvocation,
+} from './lib/questions';
+export type { AskedOption, AskedQuestion, QuestionAnswer } from './lib/questions';
 export { toolCallStatus } from './lib/tool-call-status';
 export type { ToolCallStatus } from './lib/tool-call-status';
 export { englishWorkLog } from './lib/work-log-copy';