@burdenoff/website-sdk 2026.1104.3 → 2026.1105.1

package/README.md

@@ -63,8 +63,9 @@ in `tsup.config.ts`) and the package declares `"sideEffects": false`:
 
 The live-avatar guarantees are unchanged: `livekit-client` stays external to
 the `./avatar-live` entry alone, and the avatar's view remains a chunk of its
-own that only the root loads on demand (`scripts/validate-avatar-live.mjs`
-fails the build otherwise).
+own that only the root loads on demand, as does the Avatar tab's mic, which
+only the view loads (`scripts/validate-avatar-live.mjs` fails the build
+otherwise).
 
 ## Quick Start
 
@@ -387,9 +388,38 @@ publishes audio, video or data, and it sends the avatar nothing to say.
   browser's own note of a session today, kept in `localStorage` as
   `boff.explore.avatarUsedOn`), the box asks ordinary questions, without
   `surface`, and the answer shows in the tab as text, with "Read the answer and
-  sources in Chat". Pass `currentPath` to `ExplorePanel` (as
-  `SiteAssistantDock` does) so a page change calls off a "Start when ready"
-  at once; without it, the window's path is checked before the create.
+  sources in Chat". The text is the answer's words, not its markdown: the form
+  the chat's read-aloud says (`answerSpeechText`), so a link is its label, a
+  table its rows, and the marks of emphasis, headings and quotes go, and on
+  this screen list markers as well (each item keeps its own line); citation
+  markers such as `[1]` stay, as in the chat. Pass `currentPath` to
+  `ExplorePanel` (as `SiteAssistantDock` does) so a page change calls off a
+  "Start when ready" at once; without it, the window's path is checked before
+  the create.
+- **A mic in the Avatar tab's box (BOFF-9797 Stage C, opt-in, dark).** With
+  `mic: true` on `avatar.live` (or `websiteAvatarLive({ …, mic: true })`; no
+  site sets it yet), the box gets a mic button beside Send, but only while the
+  last availability answer carries the gateway's mic offer (`stt: {token,
+  expiresAt}`, sent only while the gateway's website speech-to-text is on) and
+  the box takes the first question of a new chat. Tap to start, tap to stop,
+  thirty seconds at most (it stops by itself), with a recording dot, the time
+  against `0:30` and the words as they are recognised. The final text goes into
+  the box (after anything typed, within its 300 characters): the visitor
+  corrects it and presses Send. **Nothing is ever sent by itself.** The first
+  tap shows a mic notice of its own (versioned: the SDK shows and names
+  `web-mic-2026-11-05`, and the speech service takes a press only when that is
+  its `AVATAR_WEB_STT_NOTICE_VERSION`), then the browser's permission prompt; a
+  refused permission says so and the box stays for typing. The stream is the
+  gateway's `wss://…/api/web-avatar/v1/stt/stream` (subprotocols
+  `boff.web-stt.v1` and `offer.<token>`, `en-IN`, 16 kHz PCM); a refused
+  upgrade (4401) asks availability again and retries once. The microphone is
+  released on tap-stop, the limit, Stop, closing the panel, the Chat tab, a
+  hidden page, `pagehide`, the view going and any error. Its capture (ported
+  from fe-libs), stream and state machine are a chunk of their own,
+  `dist/avatar-mic/`, loaded from the view the first time the mic is used: a
+  site's main bundle and the view's chunk carry none of it. On alpha, a browser
+  WebSocket cannot carry Cloudflare Access service-token headers, so the
+  stream needs the Access cookie for the gateway host.
 - **One answer: the first, to a suggested question.** The avatar service
   accepts a conversation only when it holds exactly two messages: the first user
   message (a suggested question) and the first assistant answer, completed. The
@@ -421,7 +451,22 @@ publishes audio, video or data, and it sends the avatar nothing to say.
   back (Safari, iOS), a "Tap to turn on sound" button appears. A refusal (busy,
   limits, region, language, paused, a question the avatar cannot read) is one
   short sentence and "Continue in Chat". A network or CORS failure, or a route
-  that is not there, shows the view as it was before.
+  that is not there, shows the view as it was before, until the create request
+  has been sent: from then on the server may have made the session, so a create
+  that gets no answer (its request failing on the way, its body cut off, or
+  nothing within 30 s) says "The live avatar couldn't start." with the way back
+  to Chat, never "Live avatar coming soon". The 30 s are a timer raced against
+  the request, so the view leaves "Connecting…" by then whatever the network
+  does. A create is never sent again by itself (the bot check's token is good
+  for one, and a second create could be paid twice), and a 201 that arrives
+  after the 30 s is never joined: its session is ended at once with its own
+  secret (reason `client_error`, or the visitor's own where they had stopped it
+  first). For that, only a request with no answer yet is aborted at 30 s: an
+  answer whose status is in by then is read to its end, so a 201 whose body is
+  still on its way keeps its secret. A request aborted with no answer at all
+  brings nothing back where the browser honours the abort, so a session the
+  server made for it is ended by the server's own deadlines (`no_show`). A 401,
+  403, 404 or 405 answer is still the view as it was before.
 - **Ending.** Stop, closing the panel, leaving the page (`pagehide`), and the
   live avatar going off under a session (the panel's locale changing to one
   whose strings have not been reviewed) all end the session with a `keepalive`

package/dist/avatar-live-view/index.d.mts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { E as ExplorePanelAvatarLive, a as ExploreLocale, A as AvatarConversation } from '../explore-avatar-live-config-B6_p0q1c.mjs';
+import { E as ExplorePanelAvatarLive, a as ExploreLocale, A as AvatarConversation } from '../explore-avatar-live-config-OO0hvQCK.mjs';
 import '../types-CXqaLlNB.mjs';
 import '../use-explore-chat-CbfohA9O.mjs';
 import '../explore-types-Ol1Mm3dW.mjs';

package/dist/avatar-live-view/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { E as ExplorePanelAvatarLive, a as ExploreLocale, A as AvatarConversation } from '../explore-avatar-live-config-DRpS-mqQ.js';
+import { E as ExplorePanelAvatarLive, a as ExploreLocale, A as AvatarConversation } from '../explore-avatar-live-config-C-OwXNje.js';
 import '../types-CXqaLlNB.js';
 import '../use-explore-chat-B3dOOvJN.js';
 import '../explore-types-Ol1Mm3dW.js';