@alxxsck/ai-assistant 1.4.0 → 1.7.0

package/dist/domain/command/CommandRuntime.d.ts

@@ -4,7 +4,7 @@ type AckSender = (ack: CommandAck) => Promise<unknown>;
 type InternalHandlers = {
     setAssistantVisible?: (visible: boolean) => void;
     setChatOpen?: (open: boolean) => void;
-    playAnimation?: (animation: string) => void;
+    playAnimation?: (animation: string, expiresAt?: string | null) => void | Promise<void>;
     showCta?: (context: CtaCommandContext) => void;
     speakText?: (context: SpeakTextCommandContext) => void | Promise<void>;
     startVoiceConversation?: (context: StartVoiceConversationCommandContext) => void | Promise<void>;

package/dist/domain/command/command.errors.d.ts

@@ -1,5 +1,5 @@
 export declare class CommandExecutionError extends Error {
     readonly code: string;
-    readonly status: "failed" | "unsupported";
-    constructor(code: string, status?: "failed" | "unsupported", options?: ErrorOptions);
+    readonly status: "failed" | "expired" | "unsupported";
+    constructor(code: string, status?: "failed" | "expired" | "unsupported", options?: ErrorOptions);
 }

package/dist/domain/command/command.types.d.ts

@@ -131,7 +131,6 @@ export type StartVoiceConversationCommandContext = {
     text: string;
     voice: string;
     requiresUserGesture: true;
-    webrtcPath: string;
     introAudioPath: string;
 };
 export type SpeakTextCommandContext = {

package/dist/domain/message/cable/widget-frame.d.ts

@@ -3,7 +3,7 @@ import type { CommandAck } from "@/domain/command/command.types";
 import type { CommandRuntime } from "@/domain/command/CommandRuntime";
 import type { MessageStoreActions } from "@/domain/message/message.store";
 type WidgetFrameDependencies = {
-    messageActions: Pick<MessageStoreActions, "handleConversationCreated" | "handleMessagesAgenticSteps" | "handleMessage">;
+    messageActions: Pick<MessageStoreActions, "handleConversationCreated" | "handleMessageDelta" | "handleMessagesAgenticSteps" | "handleMessage">;
     commandRuntime: CommandRuntime;
     session: CustomerInteractionSession;
     sendAck: (ack: CommandAck) => Promise<unknown>;

package/dist/domain/message/cable/widget-message.d.ts

@@ -1,4 +1,5 @@
-import type { AgenticStepsAppendedData, ConversationData, MessageData } from "@/api/messages.api.types";
+import type { AgenticStepsAppendedData, ChatMessageDeltaData, ConversationData, MessageData } from "@/api/messages.api.types";
 export declare const getConversationCreatedFromFrame: (frame: unknown) => ConversationData | null;
 export declare const getMessageFromFrame: (frame: unknown) => MessageData | null;
+export declare const getMessageDeltaFromFrame: (frame: unknown) => ChatMessageDeltaData | null;
 export declare const getAgenticStepsFromFrame: (frame: unknown) => AgenticStepsAppendedData | null;

package/dist/domain/message/message-stream.d.ts

@@ -0,0 +1,10 @@
+import type { ChatMessageDeltaData } from "@/api/messages.api.types";
+export type MessageStreamState = ChatMessageDeltaData & {
+    stableText: string;
+    incomingText: string;
+};
+export declare const splitStreamingText: (previous: string, current: string) => {
+    stableText: string;
+    incomingText: string;
+};
+export declare const createMessageStreamState: (previous: MessageStreamState | undefined, delta: ChatMessageDeltaData) => MessageStreamState;

package/dist/domain/message/message.store.d.ts

@@ -1,10 +1,21 @@
-import { type AgenticStepsAppendedData, type ConversationData, type MessageData } from "@/api/messages.api.types";
+import { type AgenticStepsAppendedData, type ChatMessageDeltaData, type ConversationData, type MessageData } from "@/api/messages.api.types";
 import type { AppApi } from "@/App";
 import type { WidgetConfig } from "@/index.types";
+import { type MessageStreamState } from "./message-stream";
 export interface ThreadSummary {
     threadId: string;
     lastMessage: MessageData;
 }
+export type AgentResponsePhase = "idle" | "awaiting-first-token" | "streaming";
+export type PendingCustomerMessage = {
+    id: string;
+    text: string;
+    createdAt: string;
+    conversationId: string | undefined;
+    afterMessageId: string | null;
+    acknowledged: boolean;
+    canonicalMessageId: string | null;
+};
 export type MessageStore = {
     currentThreadId: string | undefined;
     currentThreadMessages: MessageData[];
@@ -18,6 +29,11 @@ export type MessageStore = {
     api: AppApi | null;
     latestReadMessageDate: string | null;
     latestMessageDate: string | null;
+    messageStreams: Map<string, MessageStreamState>;
+    pendingMessageDeltas: Map<string, ChatMessageDeltaData>;
+    pendingCustomerMessage: PendingCustomerMessage | null;
+    responsePhase: AgentResponsePhase;
+    sendInFlight: boolean;
     actions: MessageStoreActions;
 };
 export type MessageStoreActions = {
@@ -26,6 +42,8 @@ export type MessageStoreActions = {
     createNewConversation: () => Promise<string>;
     handleConversationCreated: (conversation: ConversationData) => void;
     handleMessage: (message: MessageData) => void;
+    handleMessageDelta: (delta: ChatMessageDeltaData) => void;
+    settleMessageStream: (messageId: string) => void;
     sendMessage: (message: string) => Promise<MessageData | undefined>;
     clearSendError: () => void;
     getThreadsSummaryData: () => ThreadSummary[];
@@ -48,4 +66,9 @@ export declare const useCurrentThreadId: () => string | undefined;
 export declare const useLatestReadMessageDate: () => string | null;
 export declare const useLatestMessageDate: () => string | null;
 export declare const useSendError: () => string | null;
+export declare const useIsAwaitingFirstToken: () => boolean;
+export declare const useIsResponseActive: () => boolean;
+export declare const selectCurrentThreadPendingCustomerMessage: (state: MessageStore) => PendingCustomerMessage | null;
+export declare const usePendingCustomerMessage: () => PendingCustomerMessage | null;
+export declare const useMessageStream: (messageId: string) => MessageStreamState | undefined;
 export declare const useMessageStoreActions: () => MessageStoreActions;

package/dist/domain/voice/voice.store.d.ts

@@ -1,3 +1,4 @@
+import { type Socket } from "socket.io-client";
 import type { AppApi } from "@/App";
 import type { VoiceSessionData } from "@/api/voice.api.types";
 import type { SpeakTextCommandContext, StartVoiceConversationCommandContext } from "@/domain/command/command.types";
@@ -9,11 +10,10 @@ type VoiceStore = {
     session: VoiceSessionData | null;
     status: VoiceStatus;
     errorMessage: string | null;
-    connection: RTCPeerConnection | null;
-    eventsChannel: RTCDataChannel | null;
+    socket: Socket | null;
     localStream: MediaStream | null;
-    remoteStream: MediaStream | null;
-    remoteAudioElement: HTMLAudioElement | null;
+    inputAudioContext: AudioContext | null;
+    inputAudioNode: AudioWorkletNode | null;
     pendingInvitation: StartVoiceConversationCommandContext | null;
     customerMessageTranscript: string;
     customerMessageTranscriptVisible: boolean;

package/dist/index.d.ts

@@ -13,6 +13,10 @@ export declare class ChatWidgetInstance extends EventTarget {
     private pendingOpenState;
     private sendServiceMessageImpl;
     private playAnimationImpl;
+    private avatarLoadError;
+    private avatarLoadGeneration;
+    private readonly pendingAvatarAnimations;
+    private destroyed;
     private executeReactionImpl;
     private resolveAssetPath;
     private setLocaleImpl;
@@ -23,6 +27,9 @@ export declare class ChatWidgetInstance extends EventTarget {
     private init;
     private fetchAndMergeRemoteConfig;
     private onAvatarReady;
+    private onAvatarLoadStarted;
+    private onAvatarLoadFailed;
+    private playAvatarAnimation;
     private onSessionExpired;
     private onCommandStatus;
     private injectStyles;

package/dist/index.types.d.ts

@@ -9,7 +9,7 @@ export type WidgetConfig = {
     customerId?: string;
     wsUrl: string;
     apiUrl: string;
-    /** Optional Lola Realtime voice passed when creating a voice session. */
+    /** Optional xAI voice passed to Lola when creating a voice session. */
     voiceConfig?: {
         voice: string;
     };

package/dist/lib/retrieveContent.d.ts

@@ -3,4 +3,5 @@ import { type MessageData } from "@/api/messages.api.types";
  * Plain-text preview from HTML for list items etc. Truncation works with CSS (e.g. truncate).
  */
 export declare function htmlToPlainPreview(html: string, maxLength?: number): string;
-export declare function retrieveContent(m: MessageData): string;
+export declare function getRenderableMessageContent(message: MessageData): MessageData["content"] | null;
+export declare function retrieveContent(message: MessageData): string;

package/dist/ui/components/ChatMessage.d.ts

@@ -4,5 +4,5 @@ export type MessageAuthor = "me" | "them";
 type ChatMessageProps = ComponentProps<"div"> & {
     message: MessageData;
 };
-export declare function ChatMessage({ message, className, ...props }: ChatMessageProps): import("react/jsx-runtime").JSX.Element | null;
+export declare const ChatMessage: import("react").NamedExoticComponent<ChatMessageProps>;
 export {};

package/dist/ui/components/ChatTypingIndicator.d.ts

@@ -1,4 +1,6 @@
 import type { ComponentProps } from "react";
-type ChatTypingIndicatorProps = ComponentProps<"div">;
-export declare function ChatTypingIndicator({ className }: ChatTypingIndicatorProps): import("react/jsx-runtime").JSX.Element;
+type ChatTypingIndicatorProps = Omit<ComponentProps<"div">, "children"> & {
+    label?: string;
+};
+export declare function ChatTypingIndicator({ className, label, ...props }: ChatTypingIndicatorProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/ui/components/OptimisticCustomerMessage.d.ts

@@ -0,0 +1,6 @@
+import type { PendingCustomerMessage } from "@/domain/message/message.store";
+type OptimisticCustomerMessageProps = {
+    message: PendingCustomerMessage;
+};
+export declare function OptimisticCustomerMessage({ message, }: OptimisticCustomerMessageProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/ui/components/PendingAssistantMessage.d.ts

@@ -0,0 +1,6 @@
+import type { ComponentProps } from "react";
+type PendingAssistantMessageProps = Omit<ComponentProps<"div">, "children"> & {
+    label?: string;
+};
+export declare function PendingAssistantMessage({ className, label, ...props }: PendingAssistantMessageProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/ui/components/StreamingMessageText.d.ts

@@ -0,0 +1,10 @@
+type StreamingMessageTextProps = {
+    stableText: string;
+    incomingText: string;
+    sequence: number;
+    targetText?: string;
+    finished?: boolean;
+    onSettled?: () => void;
+};
+export declare function StreamingMessageText({ stableText, incomingText, targetText, finished, onSettled, }: StreamingMessageTextProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/ui/hooks/usePinnedAutoScroll.d.ts

@@ -0,0 +1,10 @@
+import { type RefObject, type UIEventHandler } from "react";
+type UsePinnedAutoScrollOptions = {
+    containerRef: RefObject<HTMLElement | null>;
+    contentRef: RefObject<HTMLElement | null>;
+    messageCount: number;
+    threadId: string | undefined;
+    threshold?: number;
+};
+export declare function usePinnedAutoScroll({ containerRef, contentRef, messageCount, threadId, threshold, }: UsePinnedAutoScrollOptions): UIEventHandler<HTMLElement>;
+export {};

package/dist/ui/hooks/useSmoothStreamingText.d.ts

@@ -0,0 +1,7 @@
+export declare const useSmoothStreamingText: (targetText: string) => {
+    isSettled: boolean;
+    displayedText: string;
+    stableText: string;
+    animatedText: string;
+    revision: number;
+};

package/dist/ui/streaming/smooth-text.d.ts

@@ -0,0 +1,21 @@
+export type SmoothTextFrame = {
+    displayedText: string;
+    stableText: string;
+    animatedText: string;
+    revision: number;
+};
+export type SmoothTextController = {
+    setTarget: (text: string) => void;
+    advance: (timestamp: number) => SmoothTextFrame | null;
+    flush: () => SmoothTextFrame | null;
+    getSnapshot: () => SmoothTextFrame;
+    isSettled: () => boolean;
+};
+type SmoothTextControllerOptions = {
+    characterIntervalMs?: number;
+    segment?: (text: string) => string[];
+};
+export declare const segmentGraphemesFallback: (text: string) => string[];
+export declare const segmentGraphemes: (text: string) => string[];
+export declare const createSmoothTextController: ({ characterIntervalMs, segment, }?: SmoothTextControllerOptions) => SmoothTextController;
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alxxsck/ai-assistant",
   "private": false,
-  "version": "1.4.0",
+  "version": "1.7.0",
   "description": "Embeddable chat widget for communication with Bridge AI agent",
   "type": "module",
   "main": "dist/bridge-ai-chat-widget.es.js",
@@ -61,6 +61,7 @@
     "react-error-boundary": "^6.1.1",
     "react-router-dom": "^7.13.1",
     "react-use": "^17.6.0",
+    "socket.io-client": "^4.8.3",
     "tailwind-merge": "^3.4.0",
     "three": "^0.182.0",
     "vite-plugin-lib-inject-css": "^2.2.2",