@alia.onl/sdk 15.8.0 → 19.0.0

package/src/lib/copy-en.ts

@@ -0,0 +1,284 @@
+/**
+ * The chat's own English, keyed the way the Alia app's catalogue keys it, so the app hands its
+ * translator in (`labels.t`) and a host without one reads English. Generated from the app's
+ * `locales/en.json` and kept by hand from here: a key a component asks for belongs here.
+ */
+export type CopyEntry = string | { zero?: string; one?: string; other: string };
+
+export const COPY_EN: Readonly<Record<string, CopyEntry>> = {
+  'automations.cron.dailyAt': 'Daily at {{time}}',
+  'automations.cron.dayPlural.0': 'Sundays',
+  'automations.cron.dayPlural.1': 'Mondays',
+  'automations.cron.dayPlural.2': 'Tuesdays',
+  'automations.cron.dayPlural.3': 'Wednesdays',
+  'automations.cron.dayPlural.4': 'Thursdays',
+  'automations.cron.dayPlural.5': 'Fridays',
+  'automations.cron.dayPlural.6': 'Saturdays',
+  'automations.cron.daysAt': '{{days}} at {{time}}',
+  'automations.cron.everyHour': 'Every hour',
+  'automations.cron.everyHours': 'Every {{count}} hours',
+  'automations.cron.everyMinutes': { one: 'Every minute', other: 'Every {{count}} minutes' },
+  'automations.cron.weekdaysAt': 'Weekdays at {{time}}',
+  'automations.cron.weekendsAt': 'Weekends at {{time}}',
+  'automations.trigger.anyApp': 'Any app',
+  'automations.trigger.anyEvent': 'Any event',
+  'automations.trigger.manual': 'Manual request',
+  'automations.trigger.unscheduled': 'Unscheduled',
+  'chat.agentRun.by': 'by %{name}',
+  'chat.agentRun.complete': 'Task complete',
+  'chat.agentRun.completed': 'Completed',
+  'chat.agentRun.credits': '%{count} credits',
+  'chat.agentRun.error': 'Error',
+  'chat.agentRun.failed': 'Failed',
+  'chat.agentRun.planItems': '%{done}/%{total} plan items',
+  'chat.agentRun.planSummary': 'Plan summary',
+  'chat.agentRun.steps': '%{count} steps',
+  'chat.agentRun.taskComplete': 'Task complete',
+  'chat.agentRun.taskFailed': 'Task failed',
+  'chat.agentRun.unknown': 'Unknown',
+  'chat.agentRun.working': 'Agent working',
+  'chat.backToLatest': 'Back to the latest',
+  'chat.blockFailed': "This part of the answer couldn't be shown.",
+  'chat.bloom.context.freeSpace': 'Free space',
+  'chat.bloom.context.mcp': 'MCP tools',
+  'chat.bloom.context.memory': 'Memory',
+  'chat.bloom.context.messages': 'Messages',
+  'chat.bloom.context.skills': 'Skills',
+  'chat.bloom.context.system': 'System prompt',
+  'chat.bloom.context.title': 'Context window',
+  'chat.bloom.context.tools': 'Tools',
+  'chat.bloom.createdFile': 'Created',
+  'chat.bloom.limits.close': 'Close credits panel',
+  'chat.bloom.limits.dailyFree': 'Daily free credits',
+  'chat.bloom.limits.planUsage': 'Plan usage limits',
+  'chat.bloom.limits.resetsDaily': 'Resets every 24 hours',
+  'chat.bloom.limits.resetsInHours': 'Resets in {{hours}} hr {{minutes}} min',
+  'chat.bloom.limits.resetsInMinutes': 'Resets in {{minutes}} min',
+  'chat.bloom.limits.resetsSoon': 'Resets soon',
+  'chat.bloom.limits.window': '{{hours}}-hour limit',
+  'chat.bloom.limits.windowFresh': 'Resets {{hours}} hours after your next message',
+  'chat.bloom.noResults': 'No results',
+  'chat.bloom.researched': 'Researched',
+  'chat.bloom.researching': 'Researching',
+  'chat.bloom.resultCount': { one: '1 result', other: '{{count}} results' },
+  'chat.bloom.scrollToLatest': 'Scroll to latest messages',
+  'chat.bloom.searchCount': { one: '1 search', other: '{{count}} searches' },
+  'chat.bloom.searchFailed': 'Search failed',
+  'chat.bloom.searchedWeb': 'Searched the web for',
+  'chat.bloom.sourceCount': { one: '1 source', other: '{{count}} sources' },
+  'chat.bloom.taskFailed': 'Returned an error',
+  'chat.bloom.taskInput': 'With',
+  'chat.bloom.taskStopped': "Didn't finish",
+  'chat.bloom.visited': 'Visited',
+  'chat.bloom.writingFile': 'Writing',
+  'chat.copied': 'Copied!',
+  'chat.copiedToClipboard': 'Copied to clipboard',
+  'chat.copy': 'Copy',
+  'chat.copyFailed': "Couldn't copy to the clipboard",
+  'chat.dislike': 'Dislike',
+  'chat.edit': 'Edit',
+  'chat.feedbackFailed': "Your feedback couldn't be saved.",
+  'chat.like': 'Like',
+  'chat.loadingHistory': 'Loading earlier messages…',
+  'chat.newConversationAccept': 'Start a new one',
+  'chat.newConversationDismiss': 'Not now',
+  'chat.newConversationOffer': 'Start a new conversation?',
+  'chat.newStretch': 'New conversation',
+  'chat.readAloud': 'Read Aloud',
+  'chat.readAloudFailed': "Couldn't read this aloud",
+  'chat.regenerate': 'Regenerate',
+  'chat.retry': 'Retry',
+  'chat.richBlocks.source': 'Source: {{source}}',
+  'chat.searchThreadAgent': 'Agent',
+  'chat.searchThreadEmpty': 'Nothing matched.',
+  'chat.searchThreadFailed': 'The search could not be run.',
+  'chat.searchThreadHint':
+    'Search everything you have said to this agent, across every conversation.',
+  'chat.searchThreadPlaceholder': 'Search this thread',
+  'chat.searchThreadSearching': 'Searching…',
+  'chat.searchThreadYou': 'You',
+  'chat.sources': 'Sources',
+  'chat.stopReading': 'Stop reading',
+  'chat.thanksFeedback': 'Thanks for your feedback!',
+  'chat.thinking': 'Thinking',
+  'chat.today': 'Today',
+  'chat.toolCard.openTask': 'Open scheduled task %{objective}',
+  'chat.toolCard.paused': 'Paused',
+  'chat.toolCard.scheduled': 'Scheduled',
+  'chat.turnActions': 'Message actions',
+  'chat.consultFailed': "%{name} couldn't answer.",
+  'chat.shareFailed': "Couldn't create the share link.",
+  'chat.sharedFailed': "Couldn't load this conversation.",
+  'chat.sharedGone': 'This shared conversation is no longer available.',
+  'chat.turnFailed': "Alia couldn't answer right now.",
+  'chat.turnFailedRetryHint': 'Try again.',
+  'chat.turnInterrupted': 'Alia was interrupted before finishing.',
+  'chat.working': 'Working',
+  'chat.yesterday': 'Yesterday',
+  'common.close': 'Close',
+  'composer.cancelEdit': 'Cancel',
+  'composer.editPlaceholder': 'Edit your message',
+  'composer.editingMessage': 'Editing message',
+  'faircoin.indexed':
+    'Indexed price from the WFAIR/USDC pool on Base — FairCoin has no exchange listing',
+  'faircoin.liquidity': 'Liquidity',
+  'faircoin.marketCap': 'Market cap',
+  'faircoin.name': 'FairCoin',
+  'faircoin.noChart': 'Only one sample so far — not enough to draw a line.',
+  'faircoin.noPrice': 'No price',
+  'faircoin.noPriceHint': 'The WFAIR/USDC pool had no indexed price when this was asked.',
+  'faircoin.noSamples': 'No samples for this period yet.',
+  'faircoin.range.1y': '1Y',
+  'faircoin.range.24h': '24h',
+  'faircoin.range.30d': '30D',
+  'faircoin.range.7d': '7D',
+  'faircoin.range.all': 'All',
+  'faircoin.scale.billion': 'B',
+  'faircoin.scale.million': 'M',
+  'faircoin.scale.thousand': 'K',
+  'faircoin.scale.trillion': 'T',
+  'faircoin.source': 'From %{source}',
+  'faircoin.symbol': 'FAIR',
+  'faircoin.unavailable': 'No history for %{ranges}',
+  'faircoin.updated': 'Updated %{time}',
+  'faircoin.volume': '24h volume',
+  'market.dayHigh': 'Day high',
+  'market.dayLow': 'Day low',
+  'market.marketCap': 'Market cap',
+  'market.noChart': 'Not enough history to chart this range',
+  'market.noPrice': 'No quote available',
+  'market.open': 'Open',
+  'market.range.1D': '1D',
+  'market.range.1M': '1M',
+  'market.range.1Y': '1Y',
+  'market.range.5D': '5D',
+  'market.range.5Y': '5Y',
+  'market.range.6M': '6M',
+  'market.range.MAX': 'MAX',
+  'market.range.YTD': 'YTD',
+  'market.volume': 'Volume (24h)',
+  'panels.canvas.image': 'Image',
+  'panels.canvas.unsupported': 'Unsupported component type: {{type}}',
+  'panels.chart.share': 'Share',
+  'panels.chart.value': 'Value',
+  'panels.code.copied': 'Code copied',
+  'panels.code.copy': 'Copy code',
+  'panels.form.enter': 'Enter {{field}}',
+  'panels.form.select': 'Select…',
+  'panels.form.submit': 'Submit',
+  'powerLevels.auto.description': 'Picks the right level for each message',
+  'powerLevels.auto.label': 'Auto',
+  'powerLevels.high.description': 'Thinks harder on tougher questions',
+  'powerLevels.high.label': 'High',
+  'powerLevels.instant.description': 'Fastest and cheapest, for quick answers',
+  'powerLevels.instant.label': 'Instant',
+  'powerLevels.medium.description': 'Quick and capable, for everyday tasks',
+  'powerLevels.medium.label': 'Medium',
+  'powerLevels.onDevice': 'On %{device}',
+  'powerLevels.pro.description': 'Frontier models; slower and costs more',
+  'powerLevels.pro.label': 'Pro',
+  'powerLevels.ultra.description': 'Most capable; slowest and costs the most',
+  'powerLevels.ultra.label': 'Ultra',
+  'powerLevels.xhigh.description': 'Thinks even harder; a little slower',
+  'powerLevels.xhigh.label': 'XHigh',
+  'tasks.tool.done.agentSearch': 'Searched agents',
+  'tasks.tool.done.browse': 'Browsed',
+  'tasks.tool.done.codeInterpreter': 'Ran code',
+  'tasks.tool.done.consultAgent': 'Consulted an agent',
+  'tasks.tool.done.fileEdit': 'Edited file',
+  'tasks.tool.done.generateFile': 'Generated file',
+  'tasks.tool.done.shellExec': 'Ran command',
+  'tasks.tool.done.loadTools': 'Loaded tools',
+  'tasks.tool.done.userMemory': 'Remembered',
+  'tasks.tool.done.webScraper': 'Read page',
+  'tasks.tool.pill.agentSearch': 'Searching agents',
+  'tasks.tool.pill.browse': 'Browsing',
+  'tasks.tool.pill.codeInterpreter': 'Running code',
+  'tasks.tool.pill.consultAgent': 'Consulting an agent',
+  'tasks.tool.pill.fileEdit': 'Editing file',
+  'tasks.tool.pill.generateFile': 'Generating file',
+  'tasks.tool.pill.sendDiscord': 'Discord',
+  'tasks.tool.pill.sendEmail': 'Email',
+  'tasks.tool.pill.sendSignal': 'Signal',
+  'tasks.tool.pill.sendSlack': 'Slack',
+  'tasks.tool.pill.sendTelegramMessage': 'Telegram',
+  'tasks.tool.pill.shellExec': 'Running command',
+  'tasks.tool.pill.loadTools': 'Loading tools',
+  'tasks.tool.pill.userMemory': 'Remembering',
+  'tasks.tool.pill.webScraper': 'Reading page',
+  'tasks.tool.pill.webSearch': 'Web search',
+  'thought.activity': 'Activity',
+  'thought.audit.agent': 'Agent: {{name}}',
+  'thought.audit.fileGenerated': 'File generated',
+  'thought.audit.plan': 'Plan',
+  'thought.audit.planSteps': { one: '1 step', other: '{{count}} steps' },
+  'thought.audit.researchComplete': 'Research complete',
+  'thought.audit.researchIncomplete': 'Research incomplete',
+  'thought.audit.researchPhase.decomposing': 'Research: breaking down the question',
+  'thought.audit.researchPhase.finalizing': 'Research: finishing up',
+  'thought.audit.researchPhase.follow_up': 'Research: following up',
+  'thought.audit.researchPhase.reading': 'Research: reading articles',
+  'thought.audit.researchPhase.searching': 'Research: searching sources',
+  'thought.audit.researchPhase.synthesizing': 'Research: synthesizing findings',
+  'thought.audit.researching': 'Researching',
+  'thought.cancelled': 'Stopped',
+  'thought.done': 'Done',
+  'thought.failed': 'Failed',
+  'thought.failedAfter': 'Failed after {{elapsed}}',
+  'thought.filesAndSources': 'Files and sources',
+  'thought.input': 'Input',
+  'thought.loadFailed': "This conversation couldn't be loaded",
+  'thought.loading': 'Loading this conversation…',
+  'thought.messageGone': 'This message is no longer in the conversation',
+  'thought.noActivity': 'No actions recorded yet',
+  'thought.noOutputs': 'No files generated',
+  'thought.noSources': 'No sources used',
+  'thought.noSteps': 'No steps to display',
+  'thought.openOutput': 'Open {{name}} in the canvas',
+  'thought.output': 'Output',
+  'thought.outputs': 'Outputs',
+  'thought.reasoning': 'Reasoning',
+  'thought.references': 'References',
+  'thought.sourceLabel': 'Source {{n}}: {{title}}',
+  'thought.sources': 'Sources',
+  'thought.steps': 'Steps',
+  'thought.stoppedAfter': 'Stopped after {{elapsed}}',
+  'thought.thinking': 'Thinking',
+  'thought.thinkingFor': 'Thinking for {{seconds}}s...',
+  'thought.thoughtFor': 'Thought for {{seconds}} seconds',
+  'thought.title': 'Thought',
+  'thought.tool.browse': 'Browsing the web',
+  'thought.tool.generateFile': 'Generating file',
+  'thought.tool.getCurrentDate': 'Getting current date',
+  'thought.tool.getTimeline': 'Getting timeline',
+  'thought.tool.getWhatsAppChats': 'Loading WhatsApp chats',
+  'thought.tool.getWhatsAppMessages': 'Reading WhatsApp messages',
+  'thought.tool.saveUserMemory': 'Saving to memory',
+  'thought.tool.scrapeURL': 'Reading URL',
+  'thought.tool.searchKnowledgeBase': 'Searching knowledge base',
+  'thought.tool.sendTelegramMessage': 'Sending Telegram message',
+  'thought.tool.sendWhatsAppMessage': 'Sending WhatsApp message',
+  'thought.tool.updateUserContext': 'Updating context',
+  'thought.tool.updateUserPreferences': 'Updating preferences',
+  'thought.tool.webScraper': 'Reading web page',
+  'thought.tool.webSearch': 'Searching the web',
+  'thought.viewDetails': 'View details',
+  'thought.websites': 'Websites',
+  'thought.worked': 'Worked',
+  'thought.workedFor': 'Worked for {{elapsed}}',
+  'thought.working': 'Working…',
+  'thought.workingFor': 'Working for {{elapsed}}…',
+  'thought.writing': 'Writing',
+  'usageLimit.inputDisabledPlaceholder': 'Usage limit reached',
+  'weather.condition.clear': 'Clear',
+  'weather.condition.cloudy': 'Cloudy',
+  'weather.condition.drizzle': 'Drizzle',
+  'weather.condition.fog': 'Fog',
+  'weather.condition.partly-cloudy': 'Partly cloudy',
+  'weather.condition.rain': 'Rain',
+  'weather.condition.showers': 'Showers',
+  'weather.condition.snow': 'Snow',
+  'weather.condition.snow-showers': 'Snow showers',
+  'weather.condition.thunderstorm': 'Thunderstorm',
+  'weather.toggleUnit': 'Switch temperature unit',
+};

package/src/lib/copy.ts

@@ -0,0 +1,32 @@
+import { COPY_EN, type CopyEntry } from './copy-en';
+
+/**
+ * A translator keyed the way the Alia app's own catalogue keys its strings, so the app hands its
+ * `t` straight in (`labels.t`). The words the chat draws that are not one fixed `labels` field —
+ * the thread, its cards, the thought panel, the work log — are asked for by key.
+ */
+export type Translate = (key: string, params?: Record<string, unknown>) => string;
+
+function entryFor(entry: CopyEntry, count: number | undefined): string {
+  if (typeof entry === 'string') return entry;
+  if (count === 0 && entry.zero !== undefined) return entry.zero;
+  if (count === 1 && entry.one !== undefined) return entry.one;
+  return entry.other;
+}
+
+/** `{{name}}` and `%{name}` both name a parameter, as in the app's catalogue. */
+const PLACEHOLDER = /\{\{\s*(\w+)\s*\}\}|%\{(\w+)\}/g;
+
+/**
+ * The default translator: the English in `copy-en.ts`, with `{{count}}` plurals and parameters.
+ * A key it does not know answers itself, so a missing string is visible rather than blank.
+ */
+export const englishCopy: Translate = (key, params) => {
+  const entry = COPY_EN[key];
+  if (entry === undefined) return key;
+  const count = typeof params?.count === 'number' ? params.count : undefined;
+  return entryFor(entry, count).replace(PLACEHOLDER, (placeholder, a?: string, b?: string) => {
+    const value = params?.[(a ?? b) as string];
+    return value === undefined ? placeholder : String(value);
+  });
+};

package/src/lib/document-picker.ts

@@ -0,0 +1,31 @@
+import * as DocumentPicker from 'expo-document-picker';
+
+export type DocumentPickerResult = {
+  uri: string;
+  name: string;
+  size: number;
+  mimeType: string;
+};
+
+/** The platform's document picker, several at once; nothing when the person cancels or it fails. */
+export async function pickDocuments(): Promise<DocumentPickerResult[] | undefined> {
+  try {
+    const result = await DocumentPicker.getDocumentAsync({
+      type: '*/*',
+      multiple: true,
+      copyToCacheDirectory: true,
+    });
+
+    if (result.canceled === false && result.assets && result.assets.length > 0) {
+      return result.assets.map((asset) => ({
+        uri: asset.uri,
+        name: asset.name,
+        size: asset.size || 0,
+        mimeType: asset.mimeType || 'application/octet-stream',
+      }));
+    }
+  } catch (error) {
+    console.warn('Failed to pick document:', error);
+  }
+  return undefined;
+}

package/src/lib/flights.ts

@@ -1,24 +1,33 @@
 import { createContext, useContext } from 'react';
 import type { AvatarFlights, AvatarFlightSpec } from '@oxy.so/bloom/avatar-flight';
 
-import { ALIA_AVATAR } from '../components/AliaAvatar';
+import type { AliaParticipant } from './participants';
 
-/** Where Alia's avatar is in the chat: large in the greeting, then small in the header's profile. */
-export const ALIA_ANCHORS = { welcome: 'alia:welcome', profile: 'alia:profile' } as const;
+/**
+ * Where the conversation's avatars are: the lead's, large in the greeting; everybody's, small in
+ * the header's participants; and a consulted agent's, beside the reply it is writing.
+ */
+export const ANCHORS = {
+  welcome: 'lead:welcome',
+  profile: 'participants',
+  reply: (agentId: string) => `reply:${agentId}`,
+} as const;
 
-/** The greeting's avatar flies up into the header's profile as the conversation begins. */
-export const ALIA_TO_PROFILE: AvatarFlightSpec = {
-  key: 'alia',
-  character: ALIA_AVATAR,
-  from: ALIA_ANCHORS.welcome,
-  to: ALIA_ANCHORS.profile,
-  duration: 800,
-};
+/** The greeting's avatar flies up into the header's participants as the conversation begins. */
+export function leadToProfile(lead: AliaParticipant): AvatarFlightSpec {
+  return {
+    key: 'lead',
+    character: lead.character,
+    from: ANCHORS.welcome,
+    to: ANCHORS.profile,
+    duration: 800,
+  };
+}
 
 const FlightsContext = createContext<AvatarFlights | null>(null);
 
-/** The chat's avatar flights, for the greeting and the header that share them. */
+/** The chat's avatar flights, for the greeting, the thread and the header that share them. */
 export const AliaFlightsProvider = FlightsContext.Provider;
 
-/** `null` outside a chat: the greeting and the header then draw their avatars without flying. */
+/** `null` outside a chat: the greeting, the replies and the header then draw their avatars without flying. */
 export const useAliaFlights = () => useContext(FlightsContext);

package/src/lib/focus-return.ts

@@ -0,0 +1,66 @@
+import { Platform } from 'react-native';
+
+/**
+ * Where keyboard focus goes back to when the execution panel closes.
+ *
+ * The panel is opened from a row in the conversation — a tool step, the
+ * sources row, the reasoning trigger — and on the web the desktop rail is not
+ * a dialog: nothing moves focus into it and nothing would move it back. So a
+ * screen-reader or keyboard user who opened it and pressed Escape was left
+ * with focus wherever the browser had put it, which after a click on a
+ * `Pressable` is `body` in Safari. The opener is remembered here at open time
+ * and focused again at close.
+ *
+ * One slot, module-level: there is one panel, and the store's own selection
+ * already says which message it is about. A DOM element in the store would
+ * also be a DOM element in a persisted store's state tree, which it must not
+ * be.
+ */
+type Focusable = { focus: () => void };
+
+let opener: Focusable | null = null;
+
+function isFocusable(value: unknown): value is Focusable {
+  return (
+    typeof value === 'object' &&
+    value !== null &&
+    typeof (value as { focus?: unknown }).focus === 'function'
+  );
+}
+
+/**
+ * Remember what opened the panel. A caller with a ref to its own control
+ * passes it; one without (a memoised row whose ref would be one more prop)
+ * lets this read the element that is focused right now, which on the web is
+ * the button that was just activated by keyboard, and the button or `body`
+ * after a pointer press depending on the browser. Nothing is remembered on
+ * native, where focus does not work this way.
+ */
+export function rememberOpener(candidate?: unknown): void {
+  if (isFocusable(candidate)) {
+    opener = candidate;
+    return;
+  }
+  if (
+    Platform.OS === 'web' &&
+    typeof document !== 'undefined' &&
+    isFocusable(document.activeElement)
+  ) {
+    opener = document.activeElement;
+    return;
+  }
+  opener = null;
+}
+
+/** Focus the remembered opener, once, and forget it. */
+export function restoreOpenerFocus(): void {
+  const target = opener;
+  opener = null;
+  if (target === null) return;
+  try {
+    target.focus();
+  } catch {
+    // An element that has since left the document cannot take focus; there
+    // is nowhere better to send it.
+  }
+}

package/src/lib/keyboard.native.tsx

@@ -1,6 +1,25 @@
 // Native: re-export react-native-keyboard-controller components
+import Animated, { useAnimatedStyle } from 'react-native-reanimated';
+import { useReanimatedKeyboardAnimation } from 'react-native-keyboard-controller';
+
 export {
   KeyboardAwareScrollView,
   KeyboardAvoidingView,
   KeyboardProvider,
 } from 'react-native-keyboard-controller';
+
+/**
+ * The room under a bottom-anchored control for the gesture bar, while the gesture bar is what lies
+ * under it.
+ *
+ * With the keyboard up, a keyboard-avoiding host already ends at the keyboard's top edge, and the
+ * keyboard covers the gesture bar. Keeping this room then counts the bar twice: the chat's composer
+ * floated a bar's height above the keyboard, with the transcript showing through the gap (Pixel 8a).
+ * It follows the keyboard's own animation, so the control settles onto the keyboard as it rises
+ * instead of jumping after.
+ */
+export function KeyboardSafeAreaFloor({ inset }: { inset: number }) {
+  const { progress } = useReanimatedKeyboardAnimation();
+  const style = useAnimatedStyle(() => ({ height: inset * (1 - progress.value) }), [inset]);
+  return <Animated.View style={style} />;
+}

package/src/lib/keyboard.tsx

@@ -5,6 +5,7 @@ import {
   type ScrollViewProps,
   KeyboardAvoidingView as RNKeyboardAvoidingView,
   type KeyboardAvoidingViewProps as RNKeyboardAvoidingViewProps,
+  View,
 } from 'react-native';
 
 // Accept native-only props so shared components don't cause TS errors
@@ -41,3 +42,11 @@ export { KeyboardAwareScrollView, KeyboardAvoidingView };
 export function KeyboardProvider({ children }: { children: React.ReactNode }) {
   return <>{children}</>;
 }
+
+/**
+ * The room under a bottom-anchored control for the system's bottom bar. The web's keyboard resizes
+ * the page rather than covering it, so that room never has to give way to it (see the native file).
+ */
+export function KeyboardSafeAreaFloor({ inset }: { inset: number }) {
+  return <View style={{ height: inset }} />;
+}

package/src/lib/labels.tsx

@@ -1,6 +1,11 @@
 import { createContext, type ReactNode, useContext, useMemo } from 'react';
 import { VOICE_ERROR_MESSAGES, type VoiceErrorCode } from './speech-messages';
-import { englishWorkLog, type Translate } from './work-log-copy';
+import { englishCopy, type Translate } from './copy';
+import { VOICE_CONTROLS_LABELS, type VoiceControlsLabels } from './voice-controls-labels';
+import type { VoiceCloseReason } from './voice-protocol';
+
+/** Why a call could not be opened; the host's `canStartVoice` answers with one. */
+export type VoiceBlockReason = 'sign-in' | 'plan-required' | 'credits-exhausted';
 
 /** Every string the chat UI draws itself. Bloom's own copy follows `BloomProvider locale`. */
 export interface AliaChatLabels {
@@ -11,11 +16,21 @@ export interface AliaChatLabels {
   more: string;
   chatActions: string;
   // Composer
-  placeholder: string;
+  /** The empty composer's prompt, naming the conversation's lead ("Ask Sindi..."). */
+  placeholder: (leadName: string) => string;
   addMenuGroup: string;
   addPhotos: string;
+  /** The add menu's row for documents, where the lead takes them. */
+  addDocuments: string;
   startVoice: string;
-  voiceFailed: string;
+  /** The call bar's words (status, mute, end). */
+  voiceControls: VoiceControlsLabels;
+  /** Why a call ended without failing; `null` for a hang-up (the person knows). */
+  voiceEnded: (reason: VoiceCloseReason) => string | null;
+  /** Said once, and shown in the bar, when the call is about to reach its time limit. */
+  voiceEndingSoon: string;
+  /** Why a call was not opened, told instead of a button that silently does nothing. */
+  voiceBlocked: (reason: VoiceBlockReason) => string;
   /** The field's accessible name. */
   composerMessage: string;
   /** The add button's accessible name. */
@@ -61,30 +76,61 @@ export interface AliaChatLabels {
   stopReading: string;
   // Plan
   planTitle: string;
-  planApprove: string;
-  planCancel: string;
-  planApproved: string;
-  planCancelled: string;
   // Reasoning
   reasoning: string;
   thoughtFor: (seconds: number) => string;
-  // The turn's work log
-  /** The words of the tool log, keyed as the Alia app keys them (see `work-log-copy.ts`). */
-  workLog: Translate;
+  // The words that are not one fixed field
+  /** The words that are not one fixed field (the thread, its cards, the work log), keyed as the Alia app keys them (see `copy.ts`). */
+  t: Translate;
+  /** The language `t` speaks, as a BCP 47 tag: dates, days and prices in the thread are formatted in it. */
+  locale: string;
+  // Conversations (the runtime's own words: toasts and the errors it raises)
+  /** A conversation's title until it has one. */
+  newChat: string;
+  /** A turn could not be sent and the composer got its text back. */
+  sendFailed: string;
+  /** The session ended mid-request. */
+  signInRequired: string;
+  conversationSaveFailed: string;
+  conversationDeleteFailed: string;
+  conversationCreateFailed: string;
+  conversationClearFailed: string;
+  /** An attachment of a kind the chat API does not carry was left out of the turn. */
+  attachmentNotSent: (name: string) => string;
+  /** A photo whose bytes could not be read was left out of the turn. */
+  attachmentUnreadable: (name: string) => string;
   // Research
 }
 
+const ENDED_ENGLISH: Partial<Record<VoiceCloseReason, string>> = {
+  'call-moved-elsewhere': 'The call continues on your other device',
+  'max-duration': 'The call reached its time limit',
+  'idle-timeout': 'The call ended after two minutes of silence',
+  'credits-exhausted': 'The call ended: you ran out of credits',
+  'server-shutdown': 'The call ended while Alia was updating — start a new one',
+};
+
+const BLOCKED_ENGLISH: Record<VoiceBlockReason, string> = {
+  'sign-in': 'Sign in to use voice',
+  'plan-required': 'Voice mode needs a paid plan',
+  'credits-exhausted': "You've run out of credits",
+};
+
 export const DEFAULT_LABELS: AliaChatLabels = {
   clear: 'Clear',
   back: 'Back',
   share: 'Share',
   more: 'More',
   chatActions: 'Chat actions',
-  placeholder: 'Ask Alia...',
+  placeholder: (leadName) => `Ask ${leadName}...`,
   addMenuGroup: 'Add',
   addPhotos: 'Photos',
+  addDocuments: 'Files',
   startVoice: 'Start voice',
-  voiceFailed: "Couldn't start the voice call",
+  voiceControls: VOICE_CONTROLS_LABELS,
+  voiceEnded: (reason) => ENDED_ENGLISH[reason] ?? null,
+  voiceEndingSoon: 'One minute left in this call',
+  voiceBlocked: (reason) => BLOCKED_ENGLISH[reason],
   composerMessage: 'Message',
   composerAddMenu: 'Add to chat',
   composerModes: 'Power level',
@@ -114,13 +160,19 @@ export const DEFAULT_LABELS: AliaChatLabels = {
   readAloud: 'Read aloud',
   stopReading: 'Stop reading',
   planTitle: "Here's my plan",
-  planApprove: 'Approve',
-  planCancel: 'Cancel',
-  planApproved: 'Plan approved',
-  planCancelled: 'Plan cancelled',
   reasoning: 'Reasoning',
   thoughtFor: (seconds) => `Thought for ${seconds} seconds`,
-  workLog: englishWorkLog,
+  t: englishCopy,
+  locale: 'en',
+  newChat: 'New chat',
+  sendFailed: "Your message couldn't be sent",
+  signInRequired: 'Sign in to keep chatting',
+  conversationSaveFailed: 'Failed to save conversation',
+  conversationDeleteFailed: 'Failed to delete conversation',
+  conversationCreateFailed: 'Failed to create conversation',
+  conversationClearFailed: "The conversation couldn't be cleared",
+  attachmentNotSent: (name) => `${name} wasn't sent — only photos can be sent`,
+  attachmentUnreadable: (name) => `${name} couldn't be read and wasn't sent`,
 };
 
 const LabelsContext = createContext<AliaChatLabels>(DEFAULT_LABELS);