@alia.onl/sdk 11.1.0 → 13.0.0

package/CHANGELOG.md

@@ -1,5 +1,139 @@
 # @alia.onl/sdk
 
+## 13.0.0
+
+Fixes found by driving the sheet end to end (the sheet shows plans, links citations, nests lists):
+
+- **A plan is drawn.** `plan_preview` was parsed but the sheet passed no handlers, so the card
+  never showed. `useAliaChat` now returns `approvePlan` / `rejectPlan` (approve collapses the
+  card to "approved"; reject collapses it and stops the turn) and `AliaChatContent` uses them
+  unless the host passes its own.
+- **Citations link.** `[n]` markers in a reply link to their sources (`linkifyCitations`,
+  `normalizeCitationMarkers`, `citationLabel` are exported from `@alia.onl/sdk/tools`; the app
+  re-exports them instead of keeping a copy).
+- **Nested lists** draw under their parent instead of inline beside it.
+- A finished research step reads "Researched", not "Researching".
+- A turn that ends at a question card with no sentence before it counts as answered.
+
+- **BREAKING: an agent is drawn with the look the server stores for it.** `agentCharacter(id)` (a
+  look hashed from the id) is removed; `readAgentCharacter(value)` parses a stored character
+  (Bloom's `parseAvatarCharacter`) and falls back on `DEFAULT_AGENT_CHARACTER`. The `alia.agent`
+  event carries `agentCharacter`, and `agentInfo` has `character`. `AliaChatAgent` has `character`;
+  `AliaChatSheet` / `AliaChatScreen` take `agents` (the host's directory) so a delegation's
+  thinking avatar is the agent's own before its answer arrives. Needs a server that sends
+  `agentCharacter`; release this SDK first, since the stream parser rejects unknown keys.
+- **The one who answers thinks with its own avatar, and it is the same avatar that settles under
+  the reply** (Bloom's `AgentReplyIdentity`, as in the multi-agent chat). While Alia works, her
+  avatar is the indicator, large with "Thinking…", where the `AgentThinking` line was; when her
+  text starts it shrinks under it with her name. A call to an agent (`delegateToAgent` /
+  `askAgent`, its `agentId` and `agentName` or `agent` arguments) opens the agent's message at
+  once, empty and thinking, and its answer fills that same message, so the avatar never remounts;
+  an agent that never answers leaves no message. Alia's reply now carries her identity row, as the
+  agents' do.
+  The reasoning is part of that same component (`AgentReplyIdentity`'s `reasoning`): while the
+  turn thinks, "Thinking… ⌃" folds it under the avatar's row, and once the reply starts it is the
+  closed "Thought for N seconds" block above it (`ThinkingBlock` draws nothing while it streams, so
+  there is one thinking indicator, not two).
+- **No jumps of height, and no flash of the wrong thinker.** A reply, a new row, the reasoning and
+  a thinking agent's avatar open and close with their height eased (Bloom's `Collapsible`, now
+  with `appear`) instead of popping. Alia is shown thinking only once she has for a moment, so a
+  turn she hands to an agent at once shows the agent thinking, not Alia for an instant first.
+- **Bubbles are equal on every side as the eye reads them.** An agent's bubble sets its top and
+  bottom padding from the reply's text metrics (`AgentReplyBubble`'s `text`, 16 on 28 here), so
+  the gap from the edge to the text is the same above, below and at the sides. Nothing is cut:
+  an open `Collapsible` no longer clips.
+- **The greeting's avatar flies up into the header's profile** as the conversation begins
+  (Bloom's `avatar-flight`: `useAvatarFlights`, `AvatarAnchor`, `AvatarFlightLayer`), across the
+  main and conversation sheets. `AgentProfile`'s new `avatarHidden` keeps the header's avatar
+  waiting for it. Needs a Bloom with `avatar-flight` (after 10.3).
+- **`AliaChatSheet` opens the conversation in a second sheet stacked over the main one.** The
+  main sheet stays on the greeting, the suggestions and the composer; the first turn (typed or a
+  suggestion) opens a fresh conversation sheet on top, whose back button (and the menu's Clear)
+  closes just that sheet, back to the main screen. A phone gets sheets flush with the screen
+  edges, with the composer clearing the home indicator; from tablet width (768 px) they float.
+  `AliaChatContent` gains `onStart` (hand an empty chat's first turn to the host) and
+  `initialTurn` (a turn sent once on mount).
+- **The empty chat looks and behaves like the Alia app's, from the same code.** The avatar sits
+  beside the greeting (`AliaWelcomeMessage`, now just the greeting: always side by side, no
+  `hideMark`, no suggestions) and the header shows Alia's profile only once there is a
+  conversation. The suggestions are one-line rows **over the composer** (`ComposerSuggestions`),
+  and from two typed characters they become matches with the typed part highlighted, arrows /
+  Enter / Escape through the composer's `onKeyPress`. The app now draws its greeting and its
+  suggestions with these same components and only supplies its API's data.
+- **Several agents in one turn.** A delegated agent's answer (`alia.agent`) is now its own
+  message with its name and avatar, placed before Alia's reply as the app places it, so a turn
+  with Lumi, Atlas and Sol shows three speakers. Before, every answer was merged into one message
+  under the last agent's name. Alia's reply is dropped when she said nothing after handing over.
+- **A delegated agent shows its 3D avatar.** The speaker line of an agent's message is Bloom's
+  `AgentAvatar`, not an image (an agent's account has none): the character comes from the agent's
+  id (`agentCharacter(id)`, exported), so the same agent looks the same everywhere and two agents
+  in a turn are told apart. The app draws its agents' messages with the same avatar.
+- **Agents are bubbles, and the header holds the team.** As in Bloom's multi-agent chat, a
+  delegated agent's reply is a tinted bubble with its avatar and name beneath it. Once agents have
+  answered, the header profile stacks Alia with up to two of them and names them together
+  ("Alia + Lumi + Atlas"). `headerLeading` / `actions` receive `agents` in their state
+  (`AliaChatState`, `AliaChatAgent`), and `AliaChatHeader` takes `agents`.
+- **The row under every reply is Bloom's multi-agent one**: helpful, unhelpful and copy as 22px
+  tiles with 12px icons (read aloud is a fourth tile where the host reads), replacing the
+  `AiChatFeedbackRow`. New label keys `helpful` and `unhelpful`.
+- **Built on Bloom's `agent-reply`** (peer `@oxy.so/bloom ^10.1.1`): replies, their identity line and
+  action tiles, and the header profile are Bloom's `AgentReply`, `AgentReplyBubble`,
+  `AgentReplyIdentity`, `AgentReplyActions` and `AgentProfile`, the pieces `MultiAgentChat` is made
+  of, not copies. Pressing the profile makes every avatar in it wave.
+- **Questions are asked above the composer, not in the thread.** What Alia asks in her last turn
+  (`askUserQuestion`) docks above the composer as Bloom's `Questionnaire`, with a dismiss; typing a
+  reply answers just as well. The thread keeps the questions as plain lines (`AskedQuestions`).
+  **Breaking:** `QuestionCard` is now the docked questionnaire (`onSubmit` required, new
+  `onDismiss`) and no longer draws a read-only variant; the `onAnswerQuestions` prop of the message
+  list is gone. `pendingQuestions` joins `@alia.onl/sdk/tools`.
+- **The voice bar is Bloom's voice controls.** `VoiceControls` draws Bloom's `@oxy.so/bloom/voice`
+  `VoiceControls` (microphone and end) under the status text, instead of `CallControls`, which is
+  made for a dark call stage and lost its captions on the chat's light surface.
+- **The header is back, the profile, share and a menu.** Bloom's `PageHeader` with a back button at
+  its start, and at its end share and a three-dots menu (Bloom's `DropdownMenu`, aligned to its
+  button) holding Clear and the host's rows. Over the empty chat there is no bar: nothing to do
+  there. In the sheet, back returns to the main screen (a fresh chat) and the sheet stays open.
+  **Breaking:** `AliaChatHeader` / `AliaChatSheet` / `AliaChatScreen` lose `onClose`; they take
+  `onBack` (screen), `onShare` and `headerMenu`; the labels `close` becomes `back`, `share`,
+  `more`.
+- **The chat follows Bloom's theme, not the system's scheme.** `AliaMarkdown` and the sheet read
+  the app's resolved mode: a person who chose light on a dark OS got white text on a light surface.
+- **Every icon is Bloom's.** The voice button is `RiVolumeUpLine` (it was Entypo); the app's clock,
+  robot and connector glyphs are `RiTimeLine`, `RiRobot2Line`, `RiPlugLine` and the SVG generator
+  is gone; `@expo/vector-icons` is no longer a peer of the SDK.
+- **Greeting.** The avatar (88px) above the text, both centred; `max-w-xs`, so it always sets in two lines; more room above than below. The Alia app draws the same.
+- Peer `@oxy.so/bloom ^10.2.1` (scrollbar, pill groups, header scrim, voice controls).
+- **Breaking:** `WelcomeSuggestion { id, title, description }` becomes `AliaSuggestion { id, text }`
+  (`text` is what is shown and what is sent). New optional props on the sheet, screen and content:
+  `suggestionMatches` and `onSuggestionQuery(query)`, so a host can search as the person types.
+  New exports: `ComposerSuggestions`, `useComposerSuggestions`, `useSuggestionQuery`,
+  `composerCompletions`, `Completion`, `AliaSuggestion`.
+
+## 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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alia.onl/sdk",
-  "version": "11.1.0",
+  "version": "13.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.4.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,26 +1,18 @@
-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',
-    },
-  },
+export const ALIA_AVATAR: AvatarCharacter = {
+  preset: 'blue_beret',
+  accessory: 'none',
+  color: 'orchid',
 };
 
 const BUSY: ReadonlySet<AliaAvatarState> = new Set(['thinking', 'working']);
@@ -34,6 +26,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 +35,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 +50,13 @@ export function AliaAvatar({
 
   return (
     <AgentAvatar
-      config={ALIA_AVATAR}
+      character={ALIA_AVATAR}
       size={size}
       label="Alia"
       workingKey={workingKey}
       interactive={interactive}
       reactionKey={reactionKey}
+      portrait={portrait}
     />
   );
-}
+});