@alia.onl/sdk 21.1.0 → 21.3.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @alia.onl/sdk
 
+## 21.3.0
+
+The SDK runs on Expo SDK 58 (React Native 0.88, React 19.3) as well as Expo 57.
+
+### Changed
+
+- **Peers admit Expo SDK 58.** Every `expo-*` peer is `^57.0.0 || ^58.0.0`, `react-native` is
+  `^0.86.0 || ^0.88.0` and `react-native-gesture-handler` `^2.32.0 || ^3.3.0` (SDK 58 ships 3.3).
+  `@oxy.so/bloom` is `>=10.21.0`, the first Bloom whose `TextInput` ref props type-check under
+  React Native 0.88's strict TypeScript API.
+
+### Fixed
+
+- **A picked image is read with `expo-file-system`'s `File` API** (`new File(uri).base64()`). The
+  root entry's `readAsStringAsync` is the legacy API, which throws at runtime since the package
+  moved it to `expo-file-system/legacy`, so attaching a photo on iOS or Android failed.
+- **An edit and a regenerate call `AliaRuntimeHost.onTurnStart`**, like a send from the composer
+  or a retry: each sends a new turn. A host that judges what a turn does against the moment it
+  was sent (a host tool's staleness check) used to judge an edited or regenerated turn against the
+  turn before it. An edit that sends nothing (an unknown message, empty content) calls nothing.
+
+## 21.2.0
+
+### Added
+
+- **`parseCatalogueTool` and `toolRendererKey` from `@alia.onl/sdk/tools`.** Which app a tool call
+  belongs to (`oxy_<app>__<tool>` / `self_<app>__<tool>`) is now readable without loading React
+  Native, so a host's own pure models and tests — the code that decides what a screen shows —
+  can tell its catalogue's results apart. The main entry exports the same two functions as before.
+
 ## 21.1.0
 
 A shared conversation has one address, Alia's, whichever app minted it (`docs/agent-embedding.md`

package/README.md

@@ -357,6 +357,8 @@ const host: AliaRuntimeHost = {
 </AliaRuntimeProvider>;
 ```
 
+`onTurnStart` is called just before each turn the runtime sends — from the composer, a retry,
+an edit or a regenerate — so a host can take what the turn will be judged against at that send.
 `onTurnEnd` is called exactly once for each turn the runtime sends, when it stops streaming —
 the answer was written, the person pressed Stop, or the turn failed — and only while the
 conversation that sent it is still mounted. A host that holds back what would take the chat off

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alia.onl/sdk",
-  "version": "21.1.0",
+  "version": "21.3.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",
@@ -50,28 +50,28 @@
   },
   "peerDependencies": {
     "react": "^19.2.3",
-    "react-native": "^0.86.0",
+    "react-native": "^0.86.0 || ^0.88.0",
     "@expo/vector-icons": "^15.1.1",
-    "@oxy.so/bloom": ">=10.17.0",
+    "@oxy.so/bloom": ">=10.21.0",
     "@oxy.so/core": ">=3.0.0",
     "@oxy.so/services": ">=11.12.0",
     "@tanstack/react-query": "^5.101",
     "@react-native-async-storage/async-storage": "^2.2.0",
-    "expo-blur": "^57.0.0",
+    "expo-blur": "^57.0.0 || ^58.0.0",
     "react-native-reanimated": "^4.5.0",
-    "react-native-gesture-handler": "^2.32.0",
+    "react-native-gesture-handler": "^2.32.0 || ^3.3.0",
     "react-native-safe-area-context": "^5.8.0",
     "react-native-keyboard-controller": "^1.21.9",
     "react-native-svg": "^15.15.5",
-    "expo-audio": "^57.0.0",
-    "expo-image": "^57.0.0",
-    "expo-image-picker": "^57.0.2",
-    "expo-document-picker": "^57.0.0",
-    "expo-haptics": "^57.0.0",
+    "expo-audio": "^57.0.0 || ^58.0.0",
+    "expo-image": "^57.0.0 || ^58.0.0",
+    "expo-image-picker": "^57.0.2 || ^58.0.0",
+    "expo-document-picker": "^57.0.0 || ^58.0.0",
+    "expo-haptics": "^57.0.0 || ^58.0.0",
     "nativewind": "^5.0.0-preview.3",
-    "expo-clipboard": "^57.0.0",
-    "expo-file-system": "^57.0.0",
-    "expo-web-browser": "^57.0.0",
+    "expo-clipboard": "^57.0.0 || ^58.0.0",
+    "expo-file-system": "^57.0.0 || ^58.0.0",
+    "expo-web-browser": "^57.0.0 || ^58.0.0",
     "react-native-css": "^3.0.7",
     "react-native-audio-api": "^0.13.6"
   },
@@ -85,7 +85,7 @@
   },
   "devDependencies": {
     "@types/react-test-renderer": "^19.1.0",
-    "react-test-renderer": "19.2.3",
+    "react-test-renderer": "19.3.0",
     "typescript": "^5.9.3",
     "vitest": "^4.1.10",
     "react-native-audio-api": "0.13.6",

package/src/index.ts

@@ -17,7 +17,7 @@ export type { AliaParticipantsHeaderProps } from './components/AliaParticipantsH
 export { ALIA_LEAD, leadOf } from './lib/participants';
 export type { AliaChatParticipants, AliaLead, AliaParticipant } from './lib/participants';
 export { ANCHORS, leadToProfile } from './lib/flights';
-export { parseCatalogueTool, toolRendererKey } from './lib/tool-renderers';
+export { parseCatalogueTool, toolRendererKey } from './lib/catalogue-tool';
 export type { AliaToolRenderers, AliaToolResult } from './lib/tool-renderers';
 export { AliaAskProvider, useAskAgent } from './components/AliaAskProvider';
 export type { AliaAsk, AliaAskAgents, AliaAskProviderProps } from './components/AliaAskProvider';

package/src/lib/catalogue-tool.ts

@@ -0,0 +1,22 @@
+/**
+ * The canonical name of an app's catalogue tool — `oxy_<app>__<tool>` for the person's
+ * account, `self_<app>__<tool>` for the agent's own — read back into its app and tool.
+ *
+ * Pure (no React, no React Native), so a host's own models and tests can tell which
+ * app a tool call belongs to: it is the `@alia.onl/sdk/tools` entry's, and the renderers
+ * (`tool-renderers.tsx`) key on it. The app part is an Oxy app slug; the tool part is
+ * whatever follows the separator. Nothing else names a renderer — never the model's text.
+ */
+const CANONICAL_TOOL = /^(?:oxy|self)_([a-z][a-z0-9-]{0,63})__([A-Za-z0-9_-]+)$/;
+
+/** The app and tool of a canonical catalogue tool name, or `null` for any other name. */
+export function parseCatalogueTool(toolName: string): { app: string; tool: string } | null {
+  const match = CANONICAL_TOOL.exec(toolName);
+  return match ? { app: match[1], tool: match[2] } : null;
+}
+
+/** The renderer key of a tool name (`<app>:<tool>`), or `null` when it is not a catalogue tool. */
+export function toolRendererKey(toolName: string): string | null {
+  const parsed = parseCatalogueTool(toolName);
+  return parsed ? `${parsed.app}:${parsed.tool}` : null;
+}

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

@@ -1,4 +1,4 @@
-import * as FileSystem from 'expo-file-system';
+import { File } from 'expo-file-system';
 import { Platform } from 'react-native';
 
 /**
@@ -12,9 +12,8 @@ import { Platform } from 'react-native';
 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,
-    });
+    // The `File` API: the legacy `readAsStringAsync` from the package root throws at runtime.
+    const base64 = await new File(uri).base64();
     return `data:${mimeType || 'image/jpeg'};base64,${base64}`;
   }
   const blob = await (await fetch(uri)).blob();

package/src/lib/text-input.ts

@@ -4,6 +4,7 @@ import type { TextInput } from 'react-native';
 /**
  * What a ref to a `TextInput` holds. `ComponentRef`, not `TextInput` itself: React Native 0.88
  * types `TextInput` as a function component, so the class is no longer its instance type, and
- * `focus()` is only on the instance.
+ * `focus()` is only on the instance. An interface rather than an alias, so a declaration that
+ * returns one can name it: on 0.88 the instance type lives in a file React Native does not export.
  */
-export type TextInputHandle = ComponentRef<typeof TextInput>;
+export interface TextInputHandle extends ComponentRef<typeof TextInput> {}

package/src/lib/tool-renderers.tsx

@@ -22,23 +22,7 @@ export interface AliaToolResult {
  */
 export type AliaToolRenderers = Readonly<Record<string, (result: AliaToolResult) => ReactNode>>;
 
-/**
- * `oxy_<app>__<tool>` or `self_<app>__<tool>`: the only names a renderer is keyed from. The app
- * part is an Oxy app slug; the tool part is whatever follows the separator.
- */
-const CANONICAL_TOOL = /^(?:oxy|self)_([a-z][a-z0-9-]{0,63})__([A-Za-z0-9_-]+)$/;
-
-/** The app and tool of a canonical catalogue tool name, or `null` for any other name. */
-export function parseCatalogueTool(toolName: string): { app: string; tool: string } | null {
-  const match = CANONICAL_TOOL.exec(toolName);
-  return match ? { app: match[1], tool: match[2] } : null;
-}
-
-/** The renderer key of a tool name (`<app>:<tool>`), or `null` when it is not a catalogue tool. */
-export function toolRendererKey(toolName: string): string | null {
-  const parsed = parseCatalogueTool(toolName);
-  return parsed ? `${parsed.app}:${parsed.tool}` : null;
-}
+export { parseCatalogueTool, toolRendererKey } from './catalogue-tool';
 
 const RenderersContext = createContext<AliaToolRenderers>({});
 

package/src/runtime/config.tsx

@@ -70,7 +70,7 @@ export interface AliaRuntimeHost {
   deviceInfo?: () => Promise<unknown>;
   /** The modes the host's composer controls own; read when the turn is sent, not when it is built. */
   turnRequest?: () => AliaTurnRequest;
-  /** A turn is about to be sent from the composer or a retry. */
+  /** A turn is about to be sent: from the composer, a retry, an edit or a regenerate. */
   onTurnStart?: () => void;
   /**
    * A turn this runtime sent has stopped streaming: it finished, was stopped, or failed. Called

package/src/runtime/use-conversation-thread.ts

@@ -394,6 +394,9 @@ export function useConversationThread({
       }
       if (isEmptyContent(content)) return false;
 
+      // An edit sends a new turn (so does a regenerate, through here).
+      host.onTurnStart?.();
+
       setMessages((prev) => {
         const idx = prev.findIndex((msg) => msg.id === messageId);
         return idx < 0 ? prev : prev.slice(0, idx);
@@ -420,7 +423,7 @@ export function useConversationThread({
       releaseAttachments(attachments ?? []);
       return true;
     },
-    [setMessages, append, messages, conversationId, labels, upload],
+    [setMessages, append, messages, conversationId, host, labels, upload],
   );
 
   /** The user turn a reply answers: the nearest one before it, or `undefined`. */

package/src/tools.ts

@@ -9,6 +9,7 @@ export {
   normalizeCitationMarkers,
 } from './lib/citations';
 export { domainOf } from './lib/domain';
+export { parseCatalogueTool, toolRendererKey } from './lib/catalogue-tool';
 export type { CitationSource } from './lib/citations';
 export { getToolDoneLabel, getToolPillLabel } from './lib/task-labels';
 export {