@convai/web-sdk 1.1.0 → 1.2.1-beta.0

package/dist/types/index.d.ts

@@ -49,8 +49,15 @@ export interface ConvaiConfig {
      * Use a unique UUID or device ID for persistent user experiences.
      */
     endUserId?: string;
+    /** Optional metadata object for the end user (sent as end_user_metadata to the API) */
+    endUserMetadata?: Record<string, unknown>;
     /** Custom Convai API URL (optional, defaults to production endpoint) */
     url?: string;
+    /**
+     * Character session ID (optional). Pass to resume an existing session;
+     * otherwise populated from the connect API response after first connection.
+     */
+    characterSessionId?: string;
     /**
      * Enable video capability (default: false).
      * If true, connection_type will be "video" (supports audio, video, and screenshare).
@@ -76,6 +83,8 @@ export interface ConvaiConfig {
      * When false, sets blendshape_provider to "none" (no facial animation data).
      */
     enableLipsync?: boolean;
+    /** Enable emotion detection and bot-emotion updates (default: true) */
+    enableEmotion?: boolean;
     /** Blendshape configuration for facial animation format */
     blendshapeConfig?: {
         /** Format of blendshapes: "arkit" or "mha" (Meta Human Animation, default: "mha") */
@@ -88,6 +97,17 @@ export interface ConvaiConfig {
          */
         frames_buffer_duration?: number;
     };
+    /** Emotion configuration for character emotional state (sent to server on connect) */
+    emotionConfig?: {
+        /** Emotion provider (default: "llm") */
+        provider?: "llm";
+        /** Minimum word threshold for emotion detection */
+        min_word_threshold?: number;
+        /** Low intensity threshold (0–1) */
+        low_intensity_threshold?: number;
+        /** High intensity threshold (0–1) */
+        high_intensity_threshold?: number;
+    };
     /** Configuration for character actions and environmental context */
     actionConfig?: {
         /** List of action names the character can perform */
@@ -134,8 +154,8 @@ export interface ChatMessage {
     content: string;
     /** ISO timestamp string of when the message was created */
     timestamp: string;
-    /** Whether this is the final version of the message (for streaming) */
-    isFinal?: boolean;
+    /** Whether this message is still streaming (mutable); false when finalized */
+    isStreaming?: boolean;
 }
 /**
  * Represents the current state of the Convai client connection and activity.
@@ -162,7 +182,7 @@ export interface ConvaiClientState {
     isConnected: boolean;
     /** Whether a connection attempt is in progress */
     isConnecting: boolean;
-    /** Whether the system is actively listening to user input */
+    /** True from user-started-speaking until user-stopped-speaking (user is speaking, bot is listening). Priority below isSpeaking. */
     isListening: boolean;
     /** Whether the character is processing/thinking about a response */
     isThinking: boolean;
@@ -170,9 +190,14 @@ export interface ConvaiClientState {
     isSpeaking: boolean;
     /**
      * Combined state indicator for the character's current activity.
-     * Use this as a single source of truth for UI state.
+     * Priority: speaking > listening (user speaking) > thinking > connected.
      */
     agentState: 'disconnected' | 'connected' | 'listening' | 'thinking' | 'speaking';
+    /** Current bot emotion (name and optional scale). Updated when bot-emotion messages are received. */
+    emotion: {
+        emotion: string;
+        scale?: number;
+    } | null;
 }
 import type { AudioControls, VideoControls, ScreenShareControls } from "../core/types";
 /**
@@ -275,5 +300,11 @@ export interface ConvaiClient {
      * When disabled, character responses won't be spoken aloud.
      */
     toggleTts: (enabled: boolean) => void;
+    /**
+     * Toggle speech-to-text on or off.
+     * When enabled, user speech is transcribed to text (e.g. for dictation).
+     * When disabled, STT is off.
+     */
+    toggleStt: (enabled: boolean) => void;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/utils/logger.d.ts

@@ -1,23 +1,23 @@
 /**
- * Logger utility that only logs in development mode.
- * Completely silent in production builds and npm packages.
+ * Logger utility that only logs in development mode (or when debug is enabled at runtime).
+ * Completely silent in production builds unless explicitly enabled.
  *
- * This logger is designed to be tree-shakeable and completely removed
- * from production builds when not used.
+ * To see logs after a production build, enable at runtime in the browser console:
+ *   window.__CONVAI_DEBUG__ = true
+ * Then refresh the page. Logs will appear with the [Convai] prefix.
  *
  * To test logger behavior:
  * - Development: Set NODE_ENV=development or run on localhost
  * - Production: Set NODE_ENV=production or deploy to production
- *
- * In npm packages, this logger will be completely silent by default.
+ * - Production + debug: Set window.__CONVAI_DEBUG__ = true before/during use
  */
 export declare const logger: {
-    log: (...args: any[]) => void;
-    warn: (...args: any[]) => void;
-    error: (...args: any[]) => void;
-    info: (...args: any[]) => void;
-    debug: (...args: any[]) => void;
-    trace: (...args: any[]) => void;
+    log: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    debug: (...args: unknown[]) => void;
+    trace: (...args: unknown[]) => void;
 };
 export declare const loggerConfig: {
     environment: string;

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAuFH,eAAO,MAAM,MAAM;mBAnBF,GAAG,EAAE;oBACJ,GAAG,EAAE;qBACJ,GAAG,EAAE;oBACN,GAAG,EAAE;qBACJ,GAAG,EAAE;qBACL,GAAG,EAAE;CAcoC,CAAC;AAG7D,eAAO,MAAM,YAAY;;;;CAIxB,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAwFH,eAAO,MAAM,MAAM;mBACF,OAAO,EAAE;oBACR,OAAO,EAAE;qBACR,OAAO,EAAE;oBACV,OAAO,EAAE;qBACR,OAAO,EAAE;qBACT,OAAO,EAAE;CAC3B,CAAC;AAGF,eAAO,MAAM,YAAY;;;;CAIxB,CAAC"}

package/dist/utils/logger.js

@@ -1,15 +1,15 @@
 /**
- * Logger utility that only logs in development mode.
- * Completely silent in production builds and npm packages.
+ * Logger utility that only logs in development mode (or when debug is enabled at runtime).
+ * Completely silent in production builds unless explicitly enabled.
  *
- * This logger is designed to be tree-shakeable and completely removed
- * from production builds when not used.
+ * To see logs after a production build, enable at runtime in the browser console:
+ *   window.__CONVAI_DEBUG__ = true
+ * Then refresh the page. Logs will appear with the [Convai] prefix.
  *
  * To test logger behavior:
  * - Development: Set NODE_ENV=development or run on localhost
  * - Production: Set NODE_ENV=production or deploy to production
- *
- * In npm packages, this logger will be completely silent by default.
+ * - Production + debug: Set window.__CONVAI_DEBUG__ = true before/during use
  */
 // Environment detection with multiple fallbacks
 const detectEnvironment = () => {
@@ -63,11 +63,21 @@ const detectEnvironment = () => {
 };
 const environment = detectEnvironment();
 const isDevelopment = environment === 'development';
-// No-op function that gets completely removed by tree shaking
-const noop = () => {
-    // This function is intentionally empty and will be removed in production
-};
-// Development logger functions
+/** At runtime, enable logging in built/production apps via window.__CONVAI_DEBUG__ = true */
+function shouldLog() {
+    if (isDevelopment)
+        return true;
+    try {
+        if (typeof window !== 'undefined' && window.__CONVAI_DEBUG__) {
+            return true;
+        }
+    }
+    catch {
+        // no window
+    }
+    return false;
+}
+// Development logger functions (used when shouldLog() is true)
 const devLogger = {
     log: (...args) => console.log('[Convai]', ...args),
     warn: (...args) => console.warn('[Convai]', ...args),
@@ -76,17 +86,17 @@ const devLogger = {
     debug: (...args) => console.debug('[Convai]', ...args),
     trace: (...args) => console.trace('[Convai]', ...args),
 };
-// Production logger functions (all no-ops)
-const prodLogger = {
-    log: noop,
-    warn: noop,
-    error: noop,
-    info: noop,
-    debug: noop,
-    trace: noop,
+// No-op when logging is disabled
+const noop = () => { };
+// Logger that checks shouldLog() at call time so production builds can enable logs via window.__CONVAI_DEBUG__
+export const logger = {
+    log: (...args) => (shouldLog() ? devLogger.log(...args) : noop()),
+    warn: (...args) => (shouldLog() ? devLogger.warn(...args) : noop()),
+    error: (...args) => (shouldLog() ? devLogger.error(...args) : noop()),
+    info: (...args) => (shouldLog() ? devLogger.info(...args) : noop()),
+    debug: (...args) => (shouldLog() ? devLogger.debug(...args) : noop()),
+    trace: (...args) => (shouldLog() ? devLogger.trace(...args) : noop()),
 };
-// Export the appropriate logger based on environment
-export const logger = isDevelopment ? devLogger : prodLogger;
 // Export environment info for debugging
 export const loggerConfig = {
     environment,

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}

package/dist/vanilla/ConvaiWidget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConvaiWidget.d.ts","sourceRoot":"","sources":["../../src/vanilla/ConvaiWidget.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EAGd,MAAM,SAAS,CAAC;AAWjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,WAAW,EACtB,OAAO,EAAE,oBAAoB,GAC5B,aAAa,CA++Df;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAE/D"}
+{"version":3,"file":"ConvaiWidget.d.ts","sourceRoot":"","sources":["../../src/vanilla/ConvaiWidget.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EAGd,MAAM,SAAS,CAAC;AAWjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,WAAW,EACtB,OAAO,EAAE,oBAAoB,GAC5B,aAAa,CAsjEf;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAE/D"}

package/dist/vanilla/ConvaiWidget.js

@@ -54,6 +54,7 @@ export function createConvaiWidget(container, options) {
                 enableVideo: options.enableVideo ?? false,
                 startWithVideoOn: options.startWithVideoOn ?? false,
                 enableLipsync: options.enableLipsync ?? false,
+                enableEmotion: options.enableEmotion,
                 blendshapeConfig: options.blendshapeConfig,
             });
         })();
@@ -71,6 +72,8 @@ export function createConvaiWidget(container, options) {
     let characterImage = "";
     let audioRenderer = null;
     let hasEnteredDefaultVoiceMode = false;
+    /** True after we have connected at least once; used to call reconnect() instead of connect() when opening after disconnect */
+    let hasConnectedBefore = false;
     // DOM elements (will be created below)
     let rootElement;
     let morphingContainer;
@@ -285,7 +288,7 @@ export function createConvaiWidget(container, options) {
             return;
         const bars = voiceModeOverlay.querySelectorAll(".voice-bar");
         const isTalking = client.state.isSpeaking;
-        const isListening = !client.audioControls.isAudioMuted;
+        const isListening = client.state.isListening; // User is speaking (from user-started-speaking)
         const isAnimating = isListening || isTalking;
         // Update colors based on state
         bars.forEach((bar) => {
@@ -311,8 +314,8 @@ export function createConvaiWidget(container, options) {
                     ? "Audio active"
                     : "Press and hold the microphone to talk";
         }
-        // Animation Logic - Matches React version
-        if (isListening && analyzer && dataArray) {
+        // Animation Logic - Matches React version (animate when user or bot is active)
+        if ((isListening || !client.audioControls.isAudioMuted) && analyzer && dataArray) {
             // Use time domain data (waveform) instead of frequency
             // @ts-ignore - TypeScript strict mode issue with Uint8Array type
             analyzer.getByteTimeDomainData(dataArray);
@@ -555,6 +558,62 @@ export function createConvaiWidget(container, options) {
       `;
             titleSection.appendChild(voiceBadge);
         }
+        // Speaking tag (top bar, same style as React)
+        if (client.state.isSpeaking) {
+            const speakingTag = document.createElement("span");
+            speakingTag.textContent = "SPEAKING";
+            speakingTag.style.cssText = `
+        font-size: 10px;
+        color: #10b981;
+        font-weight: 600;
+        margin-left: 8px;
+        padding: 3px 8px;
+        border-radius: 6px;
+        background-color: #10b98120;
+        border: 1px solid #10b98140;
+        display: inline-flex;
+        align-items: center;
+        gap: 4px;
+      `;
+            const dot = document.createElement("span");
+            dot.style.cssText = `
+        width: 6px;
+        height: 6px;
+        border-radius: 50%;
+        background-color: #10b981;
+        display: inline-block;
+      `;
+            speakingTag.insertBefore(dot, speakingTag.firstChild);
+            titleSection.appendChild(speakingTag);
+        }
+        // Listening tag (top bar, when user is speaking)
+        if (client.state.isListening && !client.state.isSpeaking) {
+            const listeningTag = document.createElement("span");
+            listeningTag.textContent = "LISTENING";
+            listeningTag.style.cssText = `
+        font-size: 10px;
+        color: #3b82f6;
+        font-weight: 600;
+        margin-left: 8px;
+        padding: 3px 8px;
+        border-radius: 6px;
+        background-color: #3b82f620;
+        border: 1px solid #3b82f640;
+        display: inline-flex;
+        align-items: center;
+        gap: 4px;
+      `;
+            const dot = document.createElement("span");
+            dot.style.cssText = `
+        width: 6px;
+        height: 6px;
+        border-radius: 50%;
+        background-color: #3b82f6;
+        display: inline-block;
+      `;
+            listeningTag.insertBefore(dot, listeningTag.firstChild);
+            titleSection.appendChild(listeningTag);
+        }
     };
     // Create message list
     const createMessageList = () => {
@@ -627,7 +686,7 @@ export function createConvaiWidget(container, options) {
         inputElement.placeholder = "Conversation";
         inputElement.style.cssText = `
       width: 100%;
-      padding: 0.75rem 3rem 0.75rem 1rem;
+      padding: 0.75rem 2.75rem 0.75rem 1rem;
       border-radius: ${aeroTheme.borderRadius.full};
       border: 1px solid ${aeroTheme.colors.neutral[300]};
       background: ${aeroTheme.colors.glass.medium};
@@ -1104,7 +1163,13 @@ export function createConvaiWidget(container, options) {
         // Connect on first click if not already connected/connecting
         if (!client.state.isConnected && !client.state.isConnecting) {
             try {
-                await client.connect();
+                // Use reconnect when opening again after a disconnect (reuses stored config)
+                if (hasConnectedBefore && typeof client.reconnect === "function") {
+                    await client.reconnect();
+                }
+                else {
+                    await client.connect();
+                }
                 setIsOpen(true);
             }
             catch (error) {
@@ -1602,6 +1667,9 @@ export function createConvaiWidget(container, options) {
         if (client.state.isConnecting || !client.isBotReady) {
             return { color: "#f59e0b", label: "Connecting" };
         }
+        if (client.state.isListening) {
+            return { color: "#3b82f6", label: "Listening" };
+        }
         return { color: "#10b981", label: "Connected" };
     };
     const formatMessages = () => {
@@ -1748,6 +1816,7 @@ export function createConvaiWidget(container, options) {
             updateHeader(); // Update header to show green status
         });
         client.on("connect", () => {
+            hasConnectedBefore = true;
             // Initialize audio renderer on connection
             if (client.room && !audioRenderer) {
                 audioRenderer = new AudioRenderer(client.room);