@alia.onl/sdk 7.1.1 → 7.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alia.onl/sdk",
-  "version": "7.1.1",
+  "version": "7.2.1",
   "description": "Alia AI chat SDK — reusable chat UI, voice, and streaming components for Oxy apps",
   "main": "src/index.ts",
   "react-native": "src/index.ts",
@@ -8,6 +8,7 @@
   "types": "src/index.ts",
   "exports": {
     ".": "./src/index.ts",
+    "./content": "./src/lib/content-utils.ts",
     "./voice": "./src/voice.ts",
     "./package.json": "./package.json"
   },
@@ -44,8 +45,8 @@
   "peerDependencies": {
     "react": "^19.2.3",
     "react-native": "^0.86.0",
-    "@oxyhq/core": "^23.2.1",
-    "@oxyhq/services": "^30.2.5",
+    "@oxyhq/core": "23.3.1",
+    "@oxyhq/services": "31.0.1",
     "@react-native-async-storage/async-storage": "^2.2.0",
     "socket.io-client": "^4.8.3",
     "expo-font": "^57.0.0",

package/src/components/AliaChatScreen.tsx

@@ -28,7 +28,7 @@ import type { VoiceSessionComponent } from '../types';
 export interface AliaChatScreenProps {
   /** App context injected into system prompt */
   clientContext?: string;
-  /** Alia model. Checked against `GET /catalogue`; omitted, the build's preference is used. */
+  /** Kaana routing profile. Checked against `GET /catalogue`; omitted, the build's preference is used. */
   model?: string;
   /** API URL override */
   apiUrl?: string;

package/src/components/AliaChatSheet.tsx

@@ -45,7 +45,7 @@ const SPRING_CONFIG = {
 export interface AliaChatSheetProps {
   /** App context injected into system prompt */
   clientContext?: string;
-  /** Alia model. Checked against `GET /catalogue`; omitted, the build's preference is used. */
+  /** Kaana routing profile. Checked against `GET /catalogue`; omitted, the build's preference is used. */
   model?: string;
   /** API URL override */
   apiUrl?: string;

package/src/hooks/useAliaChat.ts

@@ -12,7 +12,14 @@ const API_URL = process.env.EXPO_PUBLIC_ALIA_API_URL ?? 'https://api.alia.onl';
 export interface UseAliaChatOptions {
   /** Alia API base URL (default: EXPO_PUBLIC_ALIA_API_URL or https://api.alia.onl) */
   apiUrl?: string;
-  /** Alia model or routing profile to use. */
+  /**
+   * Kaana routing profile to use.
+   *
+   * Optional, and checked against `GET /catalogue` before a request carries it:
+   * an identifier the server no longer offers is replaced rather than sent, so a
+   * retirement does not turn into a 400 inside a consumer's app. Omitted, the
+   * build's `PREFERRED_CHAT_MODEL_ID` is what gets checked.
+   */
   model?: string;
   /** App context injected as system message so Alia knows which app the user is in. */
   clientContext?: string;

package/src/lib/catalogue.ts

@@ -3,7 +3,7 @@
  * workstream 5).
  *
  * Every surface used to hardcode an `alia-*` identifier as its default —
- * `useAliaChat` sent `alia-v1`, `useTTS` and `useVoiceRoom` sent `alia-v1-voice`
+ * `useAliaChat` sent `route:auto`, `useTTS` and `useVoiceRoom` sent `route:voice`
  * — which meant a retired identifier became a 400 in a consumer's app with
  * nothing the consumer could do about it, since the string was baked into the
  * package they installed. This module is how the SDK asks the server what it
@@ -200,6 +200,7 @@ export async function resolveModelId(
   accessToken?: string,
   preferredId?: string,
 ): Promise<string> {
+  if (requestedId.startsWith('mode:')) return requestedId;
   try {
     const entries = await fetchCatalogue(apiUrl, accessToken);
     return resolveSelection(requestedId, entries, preferredId).effectiveId;

package/src/lib/config.ts

@@ -11,12 +11,11 @@
  *
  * Overridable per build so a consumer is not stranded on a retired identifier
  * until the SDK ships a new version, which is the failure the hardcoded
- * `'alia-v1'` inside `useAliaChat` used to guarantee.
+ * `'route:auto'` inside `useAliaChat` used to guarantee.
  */
 
 /** What a chat request asks for when the caller names no model. Checked against the catalogue. */
-export const PREFERRED_CHAT_MODEL_ID =
-  process.env.EXPO_PUBLIC_ALIA_DEFAULT_MODEL ?? 'profile:v1';
+export const PREFERRED_CHAT_MODEL_ID = 'mode:auto';
 
 /**
  * What speech synthesis and the voice session ask for.
@@ -34,5 +33,4 @@ export const PREFERRED_CHAT_MODEL_ID =
  * Resolving it properly needs a catalogue that describes voice capability as a
  * first-class filter; that is workstream 5's business, not a thing to fake here.
  */
-export const PREFERRED_VOICE_MODEL_ID =
-  process.env.EXPO_PUBLIC_ALIA_VOICE_MODEL ?? 'profile:v1-voice';
+export const PREFERRED_VOICE_MODEL_ID = 'route:voice';

package/src/lib/tool-registry.ts

@@ -28,12 +28,28 @@ const TOOL_REGISTRY: Record<string, ToolDefinition> = {
   updateUserContext:     { label: 'Updating context',      category: 'memory' },
 };
 
+/**
+ * `Object.hasOwn`, not a bare index, in all three lookups below.
+ *
+ * Every key here comes off the wire — a tool name the server chose, a research
+ * phase the server chose — and these are plain object literals, so
+ * `REGISTRY['constructor']` is `Object.prototype`'s and not a miss.
+ * `getResearchActiveLabel('constructor')` returned that FUNCTION, which reaches
+ * a caption as `[object Function]`; the two tool lookups happened to survive
+ * only because `?.label` on a function is `undefined`, which is luck rather
+ * than a guard. The API states the same rule for its own lookups
+ * (`prototype-keyed-lookups.test.ts`).
+ */
+function lookup<T>(table: Record<string, T>, key: string): T | undefined {
+  return Object.hasOwn(table, key) ? table[key] : undefined;
+}
+
 export function getToolLabel(toolName: string): string {
-  return TOOL_REGISTRY[toolName]?.label || toolName;
+  return lookup(TOOL_REGISTRY, toolName)?.label || toolName;
 }
 
 export function getToolActiveLabel(toolName: string): string | undefined {
-  const label = TOOL_REGISTRY[toolName]?.label;
+  const label = lookup(TOOL_REGISTRY, toolName)?.label;
   if (!label) return undefined;
   return label + '...';
 }
@@ -49,7 +65,7 @@ const RESEARCH_ACTIVE_LABELS: Record<string, string> = {
 };
 
 export function getResearchActiveLabel(phase: string): string | undefined {
-  return RESEARCH_ACTIVE_LABELS[phase];
+  return lookup(RESEARCH_ACTIVE_LABELS, phase);
 }
 
 export { TOOL_REGISTRY };

package/src/lib/utils.ts

@@ -17,9 +17,19 @@ export function errorMessage(err: unknown, fallback = 'Something went wrong'): s
 }
 
 export function formatFileSize(bytes: number): string {
-  if (bytes === 0) return '0 B';
+  if (!Number.isFinite(bytes) || bytes <= 0) return '0 B';
   const k = 1024;
-  const sizes = ['B', 'KB', 'MB', 'GB'];
-  const i = Math.floor(Math.log(bytes) / Math.log(k));
-  return Math.round((bytes / Math.pow(k, i)) * 100) / 100 + ' ' + sizes[i];
+  const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
+  /**
+   * Clamped to the unit table.
+   *
+   * `Math.floor(Math.log(bytes) / Math.log(k))` is unbounded at both ends, and
+   * `sizes[i]` is `undefined` outside it — so a file of a terabyte or more read
+   * "1 undefined", and any size below one byte (a fractional value, which
+   * `attachment.size` can be) took `log` of a number below 1, giving `i = -1`
+   * and the same undefined unit. Negative and non-finite inputs went further:
+   * `Math.log` of them is `NaN`, and `sizes[NaN]` is undefined too.
+   */
+  const i = Math.min(sizes.length - 1, Math.max(0, Math.floor(Math.log(bytes) / Math.log(k))));
+  return `${String(Math.round((bytes / Math.pow(k, i)) * 100) / 100)} ${sizes[i]}`;
 }