@alxxsck/ai-assistant 1.8.0 → 2.2.0

package/dist/index.d.ts

@@ -1,49 +1,46 @@
-import type { ExternallyAvailableActions } from "./avatar/Avatar";
 import type { WidgetConfig } from "./index.types";
 import type { CustomerInteractionSession } from "./types";
-import type { HostCommandHandlerName, UiTarget } from "./domain/command/command.types";
-export type { WidgetConfig } from "./index.types";
-export declare const ASSETS_URL = "https://metamediastatic.com";
+import type { CommandEventDetail } from "./domain/command/command.types";
+export type { CustomerInteractionSession, CommandEventDetail, HighlightCommandContext, HostCommandHandlers, OpenModalContext, OpenPageContext, WidgetConfig, } from "./index.types";
+export { EXTERNALLY_AVAILABLE_ACTIONS, isExternallyAvailableAction, } from "./avatar/publicAnimations";
+export type { ExternallyAvailableActions } from "./avatar/publicAnimations";
+type WidgetEventMap = {
+    renew_session: CustomEvent<void>;
+    command_received: CustomEvent<CommandEventDetail>;
+    command_succeeded: CustomEvent<CommandEventDetail>;
+    command_failed: CustomEvent<CommandEventDetail>;
+    command_expired: CustomEvent<CommandEventDetail>;
+    command_unsupported: CustomEvent<CommandEventDetail>;
+};
 export declare class ChatWidgetInstance extends EventTarget {
     private root;
+    private hostElement;
     private shadowRoot;
     private config;
-    private gui;
     private setOpenImpl;
     private pendingOpenState;
-    private sendServiceMessageImpl;
     private playAnimationImpl;
     private avatarLoadError;
     private avatarLoadGeneration;
     private readonly pendingAvatarAnimations;
     private destroyed;
-    private executeReactionImpl;
+    private disableDebugLogging;
     private resolveAssetPath;
-    private setLocaleImpl;
     private setSessionImpl;
     private readonly commandRuntime;
+    private readonly onSessionExpired;
+    addEventListener<K extends keyof WidgetEventMap>(type: K, listener: (this: ChatWidgetInstance, event: WidgetEventMap[K]) => void, options?: boolean | AddEventListenerOptions): void;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject | null, options?: boolean | AddEventListenerOptions): void;
     constructor(config: WidgetConfig);
-    private initGui;
     private init;
-    private fetchAndMergeRemoteConfig;
     private onAvatarReady;
     private onAvatarLoadStarted;
     private onAvatarLoadFailed;
     private playAvatarAnimation;
-    private onSessionExpired;
     private onCommandStatus;
     private injectStyles;
+    private validateCustomerInteractionSession;
     setOpen(open: boolean): void;
-    playAnimation(name: ExternallyAvailableActions): void;
     setCustomerInteractionSession(session: CustomerInteractionSession): void;
-    registerUiTarget(code: string, target: UiTarget): () => void;
-    registerCommandHandler<K extends HostCommandHandlerName>(name: K, handler: NonNullable<NonNullable<WidgetConfig["commandHandlers"]>[K]>): () => void;
-    executeReaction(params: {
-        animation: string;
-        voice: string;
-        text: string;
-    }): void;
-    sendServiceMessage(message: string, animationName: ExternallyAvailableActions): void;
-    setLocale(locale: string): void;
     destroy(): void;
 }

package/dist/index.types.d.ts

@@ -1,50 +1,13 @@
-import type { ExternallyAvailableActions } from "./avatar/Avatar";
 import type { CustomerInteractionSession } from "./types";
-import type { CommandEventDetail, HostCommandHandlerName, HostCommandHandlers, UiTarget } from "./domain/command/command.types";
+import type { HostCommandHandlers } from "./domain/command/command.types";
 export type WidgetConfig = {
-    mountElementId: string;
-    configName?: string;
     customerInteractionSession: CustomerInteractionSession;
-    agentId: string;
-    customerId?: string;
-    wsUrl: string;
-    apiUrl: string;
-    /** Optional xAI voice passed to Lola when creating a voice session. */
-    voiceConfig?: {
-        voice: string;
-    };
-    AIAvatar?: boolean;
+    /** Hides the built-in launcher while preserving programmatic `setOpen`. */
+    hideOpenButton?: boolean;
+    /** Enables verbose `[Lola-Widget]` diagnostics. Errors are always logged. */
     debug?: boolean;
-    avatarDebug?: boolean;
-    background?: boolean;
-    voiceEnabled?: boolean;
-    footer?: boolean;
-    /** When true, launcher + open/close behave as today. When false, closing hides the widget entirely until `setOpen(true)`. */
-    manualOpen?: boolean;
-    locale?: string;
-    /** Host-owned UI targets that commands are allowed to address. */
-    uiTargets?: Record<string, UiTarget>;
-    /** Optional host integrations. Built-in fallbacks cover CTA and data-lola highlights. */
-    commandHandlers?: HostCommandHandlers;
-    /** Lola SDK-compatible alias for commandHandlers. */
+    /** Optional product integrations for navigation, modals, and highlighting. */
     handlers?: HostCommandHandlers;
 };
-export declare class ChatWidgetInstance extends EventTarget {
-    constructor(config: WidgetConfig);
-    destroy(): void;
-    playAnimation(name: ExternallyAvailableActions): void;
-    setCustomerInteractionSession(session: CustomerInteractionSession): void;
-    setOpen(open: boolean): void;
-    setLocale(locale: string): void;
-    executeReaction(params: {
-        animation: string;
-        voice: string;
-        text: string;
-    }): void;
-    registerUiTarget(code: string, target: UiTarget): () => void;
-    registerCommandHandler<K extends HostCommandHandlerName>(name: K, handler: NonNullable<HostCommandHandlers[K]>): () => void;
-    addEventListener(type: "command_received" | "command_succeeded" | "command_failed" | "command_expired" | "command_unsupported", listener: (event: CustomEvent<CommandEventDetail>) => void, options?: boolean | AddEventListenerOptions): void;
-    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
-}
 export type { CustomerInteractionSession };
-export type { CommandAck, CommandAckStatus, CommandEnvelope, CommandEventDetail, CommandType, CtaCommandContext, HighlightCommandContext, HostCommandContext, HostCommandHandler, HostCommandHandlerName, HostCommandHandlers, ModalCommandTarget, OpenModalContext, OpenPageContext, PageCommandTarget, SpeakTextCommandContext, StartVoiceConversationCommandContext, UiCommandActionSnapshot, UiCommandTarget, UiTarget, UiTargetKind, } from "./domain/command/command.types";
+export type { CommandEventDetail, HighlightCommandContext, HostCommandHandlers, OpenModalContext, OpenPageContext, } from "./domain/command/command.types";

package/dist/lib/isAuthenticationError.d.ts

@@ -0,0 +1 @@
+export declare const isAuthenticationError: (error: unknown) => boolean;

package/dist/lib/logger.d.ts

@@ -1,8 +1,11 @@
 type LogLevel = "debug" | "info" | "warn" | "error";
 declare class Logger {
-    private level;
-    private prefix;
+    private readonly level;
+    private readonly prefix;
+    private debugOwnerCount;
     constructor(prefix?: string, level?: LogLevel);
+    enableDebug(): () => void;
+    private isEnabled;
     debug(...args: unknown[]): void;
     info(...args: unknown[]): void;
     warn(...args: unknown[]): void;

package/dist/lib/markdownRenderer.d.ts

@@ -0,0 +1,4 @@
+export declare function getSafeHttpUrl(value: unknown): string | null;
+export declare function renderMarkdown(markdown: string): string;
+export declare function renderInlineMarkdown(markdown: string): string;
+export declare function renderPlainText(text: string): string;

package/dist/types/index.d.ts

@@ -1,9 +1,7 @@
 import type { ExternallyAvailableActions } from "@/avatar/Avatar";
 export type CustomerInteractionSession = {
-    accessToken: string;
-    chatId: string;
-    /** Lola Backend interaction session id. Defaults to chatId for compatibility transports. */
-    sessionId?: string;
-    expiresAt: string;
+    readonly accessToken: string;
+    readonly interactionSessionId: string;
+    readonly expiresAt: string;
 };
-export type OnAvatarReady = (playAnimation: (name: ExternallyAvailableActions) => void) => void;
+export type OnAvatarReady = (playAnimation: (name: ExternallyAvailableActions) => void | Promise<void>) => void;

package/dist/ui/chat-routes.d.ts

@@ -10,8 +10,10 @@ export declare const CHAT_PATHS: {
 export type ChatListNavigationState = {
     chatMode: ChatMode;
 };
+export type ChatPageTransitionDirection = "forward" | "backward";
 export declare function getChatModeFromNavigationState(state: unknown): ChatMode | null;
 export declare function getChatModeFromPathname(pathname: string): ChatMode;
 export declare function isChatListPath(pathname: string): boolean;
+export declare function getChatPageTransitionDirection(fromPathname: string, toPathname: string): ChatPageTransitionDirection | null;
 export declare function isVoiceChatPath(pathname: string): boolean;
 export declare function shouldOpenIncomingMessageInTextMode(pathname: string): boolean;

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

@@ -0,0 +1 @@
+export declare function ChatAvatarStage(): import("react/jsx-runtime").JSX.Element;

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

@@ -1,4 +1,2 @@
 export { CHAT_PATHS, ChatMode } from "@/ui/chat-routes";
-export declare const DEFAULT_WIDGET_WIDTH = 360;
-export declare const DEFAULT_WIDGET_HEIGHT = 680;
 export declare function ChatWidget(): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1 @@
+export default function ChatWidgetContent(): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,13 @@
+import type { PropsWithChildren } from "react";
+type ChatWidgetFrameProps = PropsWithChildren<{
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    isMobile: boolean;
+    fullscreen: boolean;
+    hideOpenButton: boolean;
+    loadingProgress: number;
+    launcherImageSrc: string;
+    unreadIndicator?: React.ReactNode;
+}>;
+export declare function ChatWidgetFrame({ open, onOpenChange, isMobile, fullscreen, hideOpenButton, loadingProgress, launcherImageSrc, unreadIndicator, children, }: ChatWidgetFrameProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

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

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

@@ -1,7 +1,8 @@
-export declare const useSmoothStreamingText: (targetText: string) => {
+export declare const useSmoothStreamingText: (targetText: string, initialText: string) => {
     isSettled: boolean;
     displayedText: string;
     stableText: string;
     animatedText: string;
+    animatedFragments: import("@/ui/streaming/smooth-text").SmoothTextFragment[];
     revision: number;
 };

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

@@ -1,7 +1,12 @@
+export type SmoothTextFragment = {
+    text: string;
+    revision: number;
+};
 export type SmoothTextFrame = {
     displayedText: string;
     stableText: string;
     animatedText: string;
+    animatedFragments: SmoothTextFragment[];
     revision: number;
 };
 export type SmoothTextController = {

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@alxxsck/ai-assistant",
   "private": false,
-  "version": "1.8.0",
-  "description": "Embeddable chat widget for communication with Bridge AI agent",
+  "version": "2.2.0",
+  "description": "Embeddable Lola AI assistant library",
   "type": "module",
   "main": "dist/bridge-ai-chat-widget.es.js",
   "module": "dist/bridge-ai-chat-widget.es.js",
-  "types": "dist/index.types.d.ts",
+  "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.types.d.ts",
+      "types": "./dist/index.d.ts",
       "import": "./dist/bridge-ai-chat-widget.es.js"
     }
   },
@@ -28,22 +28,14 @@
     "last 2 versions"
   ],
   "scripts": {
-    "dev": "vite",
     "lint": "eslint .",
     "lint-fix": "eslint . --fix",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "test": "vitest run",
-    "deploy-g-spot-prod": "npm run build-dev && npm run clean-g-spot-prod-bucket && npm run upload-g-spot-prod-bucket",
-    "deploy-bridge-demo": "npm run build-dev && npm run clean-bridge-demo-bucket && npm run upload-bridge-demo-bucket",
-    "build-dev": "vite build",
+    "typecheck": "tsc -p tsconfig.typecheck.json --noEmit",
     "build-lib": "vite build --config vite.config.lib.ts && tsc -p tsconfig.build.json",
-    "preview": "vite preview",
     "prepublishOnly": "npm run build-lib",
-    "clean-g-spot-prod-bucket": "aws s3 rm s3://bridgeapp-ai-chat-widget-dev.com --recursive",
-    "upload-g-spot-prod-bucket": "aws s3 cp dist-demo s3://bridgeapp-ai-chat-widget-dev.com/g-spot-prod --recursive",
-    "clean-bridge-demo-bucket": "aws s3 rm s3://bridge-ai-assistant --recursive",
-    "upload-bridge-demo-bucket": "aws s3 cp dist-demo s3://bridge-ai-assistant/bridge-demo --recursive",
     "push-assets-metamediastatic": "bash scripts/push-assets-to-metamediastatic.sh"
   },
   "dependencies": {
@@ -55,19 +47,15 @@
     "clsx": "^2.1.1",
     "gsap": "^3.14.2",
     "howler": "^2.2.4",
-    "lil-gui": "^0.21.0",
     "lodash-es": "^4.17.23",
     "lucide-react": "^0.562.0",
+    "markdown-it": "^14.3.0",
     "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",
-    "vite-plugin-mkcert": "^2.0.0",
     "vite-plugin-svgr": "^4.5.0",
-    "zukeeper": "^1.0.2",
     "zustand": "^5.0.10"
   },
   "devDependencies": {
@@ -75,6 +63,7 @@
     "@tailwindcss/postcss": "^4.1.18",
     "@tailwindcss/vite": "^4.1.18",
     "@types/howler": "^2.2.12",
+    "@types/markdown-it": "^14.1.2",
     "@types/node": "^24.10.4",
     "@types/react": "^19.2.5",
     "@types/react-dom": "^19.2.3",
@@ -91,13 +80,11 @@
     "prettier-plugin-tailwindcss": "^0.7.2",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",
-    "rollup-plugin-visualizer": "^7.0.1",
     "tailwindcss": "^4.1.18",
     "tw-animate-css": "^1.4.0",
     "typescript": "~5.9.3",
     "typescript-eslint": "^8.46.4",
     "vite": "^7.2.4",
-    "vite-plugin-static-copy": "^3.2.0",
     "vitest": "^4.1.10"
   }
 }