@convai/web-sdk 0.0.1

package/dist/hooks/useMessageHandler.js

@@ -0,0 +1,317 @@
+import { useCallback } from "react";
+import { RoomEvent } from "livekit-client";
+import { logger } from "../utils/logger";
+/**
+ * Hook for handling incoming messages from Convai.
+ *
+ * Sets up data message listeners to process various message types
+ * from the AI assistant and updates the chat message history.
+ *
+ * @param {Room} room - LiveKit room instance
+ * @param {Function} setChatMessages - Function to update chat messages state
+ * @returns {Function} Cleanup function to remove message listeners
+ *
+ * @example
+ * ```tsx
+ * function ChatComponent() {
+ *   const [chatMessages, setChatMessages] = useState([]);
+ *   const cleanup = useMessageHandler(room, setChatMessages);
+ *
+ *   useEffect(() => {
+ *     return cleanup;
+ *   }, []);
+ * }
+ * ```
+ */
+export const useMessageHandler = (room, setChatMessages, onUserTranscription, setIsBotResponding, isBotResponding, setIsSpeaking, onConnectionStateChange, setActivity, setIsBotReady) => {
+    const handleDataReceived = useCallback((payload, participant) => {
+        try {
+            // Decode bytes to string
+            const decoder = new TextDecoder();
+            const messageString = decoder.decode(payload);
+            // Parse JSON
+            const messageData = JSON.parse(messageString);
+            logger.log("📨 Data message received:", messageData);
+            // Extract and categorize messages for chat display
+            const timestamp = new Date().toISOString();
+            const messageId = `${messageData.type}-${Date.now()}-${Math.random()}`;
+            // Debug: Log all incoming messages to see what's being received
+            logger.log("%c📨 INCOMING MESSAGE%c", "background: #673ab7; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;", {
+                type: messageData.type,
+                data: messageData.data,
+                message: messageData.message,
+                text: messageData.text,
+                content: messageData.content,
+                fullMessage: messageData,
+            });
+            // Handle different message types
+            switch (messageData.type) {
+                // User text messages - Skip these, only allow user-transcription
+                case "user_text_message":
+                case "user-llm-text":
+                case "text-input":
+                case "user-input":
+                case "text-message":
+                case "chat-message":
+                case "input-text":
+                case "message":
+                    // Skip user text messages - only allow user-transcription
+                    logger.log("%c🚫 SKIPPED USER TEXT%c %c" +
+                        (messageData.data?.text ||
+                            messageData.message ||
+                            messageData.text ||
+                            messageData.content ||
+                            "unknown"), "background: #ff5722; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;", "color: #ff5722; font-weight: bold;", "color: #f7f1e3;");
+                    break;
+                // Bot Ready - Bot is ready, connection should be true
+                case "bot-ready":
+                    logger.log("%c✅ BOT READY%c", "background: #4caf50; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;");
+                    // Set connection state to true when bot is ready
+                    if (onConnectionStateChange) {
+                        onConnectionStateChange(true);
+                    }
+                    // Set bot-ready state to true - bot can now receive messages
+                    if (setIsBotReady) {
+                        setIsBotReady(true);
+                    }
+                    // Update activity state
+                    if (setActivity) {
+                        setActivity("Connected");
+                    }
+                    break;
+                // Bot LLM Started - Begin streaming response
+                case "bot-llm-started":
+                    logger.log("%c🤖 BOT RESPONSE STARTED%c", "background: #4caf50; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;");
+                    if (setIsBotResponding) {
+                        setIsBotResponding(true);
+                    }
+                    // Add initial streaming message to chat
+                    const streamingMessage = {
+                        id: messageId,
+                        type: "bot-llm-text",
+                        content: "",
+                        timestamp: timestamp,
+                        isFinal: true,
+                    };
+                    setChatMessages((prev) => [...prev, streamingMessage]);
+                    break;
+                // Bot LLM Text Messages - Streaming chunks
+                case "bot-llm-text":
+                    if (messageData.data?.text) {
+                        const newChunk = messageData.data.text;
+                        logger.log("%c🤖 BOT CHUNK%c %c" + newChunk, "background: #45b7d1; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;", "color: #45b7d1; font-weight: bold;", "color: #f7f1e3;");
+                        // Update the streaming message in chat
+                        setChatMessages((prevMessages) => {
+                            const lastMessage = prevMessages[prevMessages.length - 1];
+                            if (lastMessage && lastMessage.isFinal) {
+                                return [
+                                    ...prevMessages.slice(0, -1),
+                                    { ...lastMessage, content: lastMessage.content + newChunk }
+                                ];
+                            }
+                            else {
+                                // If no streaming message exists yet, create one
+                                const streamingMessage = {
+                                    id: `${messageData.type}-${Date.now()}-${Math.random()}`,
+                                    type: "bot-llm-text",
+                                    content: newChunk,
+                                    timestamp: new Date().toISOString(),
+                                    isFinal: true,
+                                };
+                                return [...prevMessages, streamingMessage];
+                            }
+                        });
+                    }
+                    break;
+                // Bot LLM Stopped - Complete streaming response
+                case "bot-llm-stopped":
+                    // Get the most up-to-date content from the current message in chat
+                    setChatMessages((prevMessages) => {
+                        const lastMessage = prevMessages[prevMessages.length - 1];
+                        if (lastMessage && lastMessage.isFinal) {
+                            const finalContent = lastMessage.content;
+                            logger.log("%c🤖 BOT RESPONSE COMPLETED%c %c" + finalContent, "background: #ff9800; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;", "color: #ff9800; font-weight: bold;", "color: #f7f1e3;");
+                            return [
+                                ...prevMessages.slice(0, -1),
+                                { ...lastMessage, content: finalContent, isFinal: false }
+                            ];
+                        }
+                        return prevMessages;
+                    });
+                    // Clear streaming state
+                    if (setIsBotResponding) {
+                        setIsBotResponding(false);
+                    }
+                    break;
+                // User Transcription Messages
+                case "user-transcription":
+                    if (messageData.data?.text) {
+                        const messageContent = messageData.data.text;
+                        if (messageData.data?.final) {
+                            // Final transcription - add to chat messages
+                            // Check if this transcription already exists to prevent duplicates
+                            setChatMessages((prev) => {
+                                const alreadyExists = prev.some((msg) => msg.type === "user-transcription" &&
+                                    msg.content.toLowerCase().trim() ===
+                                        messageContent.toLowerCase().trim());
+                                if (alreadyExists) {
+                                    logger.log("%c🔄 DUPLICATE SKIPPED%c UserTranscription: %c" +
+                                        messageContent, "background: #ff6b6b; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;", "color: #ff6b6b; font-weight: bold;", "color: #ffa726; font-weight: bold;");
+                                    return prev;
+                                }
+                                const userMessage = {
+                                    id: messageId,
+                                    type: "user-transcription",
+                                    content: messageContent,
+                                    timestamp: timestamp,
+                                };
+                                logger.log("%c🎤 USER TRANSCRIPTION (FINAL)%c %c" + messageContent, "background: #ffa726; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;", "color: #ffa726; font-weight: bold;", "color: #f7f1e3;");
+                                return [...prev, userMessage];
+                            });
+                            // Clear live transcription when final
+                            if (onUserTranscription) {
+                                onUserTranscription('');
+                            }
+                        }
+                        else {
+                            // Non-final transcription - show in input field
+                            if (onUserTranscription) {
+                                onUserTranscription(messageContent);
+                                logger.log("%c🎤 LIVE TRANSCRIPTION%c %c" + messageContent, "background: #4caf50; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;", "color: #4caf50; font-weight: bold;", "color: #f7f1e3;");
+                            }
+                        }
+                    }
+                    break;
+                // Bot Emotion Messages
+                case "bot-emotion":
+                    if (messageData.data?.emotion) {
+                        const emotionMessage = {
+                            id: messageId,
+                            type: "bot-emotion",
+                            content: `${messageData.data.emotion} (scale: ${messageData.data.scale || 1})`,
+                            timestamp,
+                        };
+                        setChatMessages((prev) => [...prev, emotionMessage]);
+                        logger.log("%c😊 CONVAI EMOTION%c %c" +
+                            messageData.data.emotion +
+                            "%c (scale: %c" +
+                            (messageData.data.scale || 1) +
+                            "%c)", "background: #e91e63; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;", "color: #e91e63; font-weight: bold;", "color: #f7f1e3; font-weight: bold;", "color: #e91e63;", "color: #ffeb3b; font-weight: bold;", "color: #e91e63;");
+                    }
+                    break;
+                // Bot Started Speaking
+                case "bot-started-speaking":
+                    logger.log("%c🔊 BOT STARTED SPEAKING%c", "background: #10b981; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;");
+                    if (setIsSpeaking) {
+                        setIsSpeaking(true);
+                    }
+                    break;
+                // Bot Stopped Speaking
+                case "bot-stopped-speaking":
+                    logger.log("%c🔇 BOT STOPPED SPEAKING%c", "background: #6b7280; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;");
+                    if (setIsSpeaking) {
+                        setIsSpeaking(false);
+                    }
+                    break;
+                // Action Response Messages
+                case "action-response":
+                    if (messageData.data?.actions) {
+                        const actionMessage = {
+                            id: messageId,
+                            type: "action",
+                            content: `Actions: ${messageData.data.actions.join(", ")}`,
+                            timestamp,
+                        };
+                        setChatMessages((prev) => [...prev, actionMessage]);
+                        logger.log("%c🎭 ACTION RESPONSE%c %c" +
+                            messageData.data.actions.join(", "), "background: #9c27b0; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;", "color: #9c27b0; font-weight: bold;", "color: #f7f1e3;");
+                    }
+                    break;
+                // Behavior Tree Response Messages
+                case "behavior-tree-response":
+                    if (messageData.data?.narrative_section_id) {
+                        const behaviorMessage = {
+                            id: messageId,
+                            type: "behavior-tree",
+                            content: `Narrative Section: ${messageData.data.narrative_section_id}`,
+                            timestamp,
+                        };
+                        setChatMessages((prev) => [...prev, behaviorMessage]);
+                        logger.log("%c🌳 BEHAVIOR TREE%c %c" +
+                            messageData.data.narrative_section_id, "background: #4caf50; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;", "color: #4caf50; font-weight: bold;", "color: #f7f1e3;");
+                        logger.log("%c🌳 BT DETAILS%c", "background: #4caf50; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;", {
+                            narrativeSection: messageData.data.narrative_section_id,
+                            btCode: messageData.data.bt_code,
+                            btConstants: messageData.data.bt_constants,
+                        });
+                    }
+                    break;
+                // Moderation Response Messages
+                case "moderation-response":
+                    logger.log("%c🛡️ MODERATION%c %c" + (messageData.data?.result || "unknown"), "background: #ff9800; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;", "color: #ff9800; font-weight: bold;", "color: #f7f1e3;");
+                    logger.log("%c🛡️ MODERATION DETAILS%c", "background: #ff9800; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;", {
+                        result: messageData.data?.result,
+                        userInput: messageData.data?.user_input,
+                        reason: messageData.data?.reason,
+                    });
+                    break;
+                // Trigger Messages
+                case "trigger-message":
+                    logger.log("%c🎯 TRIGGER MESSAGE%c", "background: #2196f3; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;", messageData.data);
+                    break;
+                // Template Keys Updates
+                case "update-template-keys":
+                    logger.log("%c🔑 TEMPLATE KEYS%c", "background: #607d8b; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;", messageData.data);
+                    break;
+                // Dynamic Info Updates
+                case "update-dynamic-info":
+                    logger.log("%c🔄 DYNAMIC INFO%c", "background: #795548; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;", messageData.data);
+                    break;
+            }
+            // Log any unhandled message types
+            if (![
+                "user_text_message",
+                "user-llm-text",
+                "text-input",
+                "user-input",
+                "text-message",
+                "chat-message",
+                "input-text",
+                "message",
+                "bot-llm-text",
+                "bot-llm-started",
+                "bot-llm-stopped",
+                "user-transcription",
+                "bot-emotion",
+                "bot-started-speaking",
+                "bot-stopped-speaking",
+                "action-response",
+                "behavior-tree-response",
+                "moderation-response",
+                "trigger-message",
+                "update-template-keys",
+                "update-dynamic-info",
+            ].includes(messageData.type)) {
+                logger.log("%c🔍 UNHANDLED MESSAGE TYPE%c %c" + messageData.type, "background: #f44336; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;", "color: #f44336; font-weight: bold;", "color: #f7f1e3;");
+                logger.log("%c🔍 UNHANDLED DATA%c", "background: #f44336; color: white; padding: 2px 6px; border-radius: 3px; font-weight: bold;", messageData);
+            }
+        }
+        catch (error) {
+            logger.error("Failed to parse data message:", error);
+        }
+    }, [setChatMessages, onUserTranscription, setIsBotResponding, isBotResponding, setIsSpeaking, onConnectionStateChange, setActivity]);
+    const setupMessageListener = useCallback(() => {
+        if (!room)
+            return;
+        // Listen for data received events
+        room.on(RoomEvent.DataReceived, handleDataReceived);
+        // Return cleanup function
+        return () => {
+            room.off(RoomEvent.DataReceived, handleDataReceived);
+        };
+    }, [room, handleDataReceived]);
+    return {
+        setupMessageListener,
+    };
+};
+//# sourceMappingURL=useMessageHandler.js.map

package/dist/hooks/useMessageHandler.js.map

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

package/dist/hooks/useScreenShare.d.ts

@@ -0,0 +1,45 @@
+import { Room } from "livekit-client";
+export interface ScreenShareControls {
+    isScreenShareEnabled: boolean;
+    isScreenShareActive: boolean;
+    enableScreenShare: () => Promise<void>;
+    disableScreenShare: () => Promise<void>;
+    toggleScreenShare: () => Promise<void>;
+    enableScreenShareWithAudio: () => Promise<void>;
+    getScreenShareTracks: () => Promise<any[]>;
+}
+/**
+ * Hook for managing screen sharing controls in LiveKit.
+ *
+ * Provides methods to enable/disable screen sharing, manage screen share state,
+ * and handle screen sharing with audio support.
+ *
+ * Features:
+ * - Includes current tab in screen share options (selfBrowserSurface: "include")
+ * - Supports surface switching during screen share
+ * - Supports system audio capture
+ *
+ * Note: By default, browsers exclude the current tab from screen share to prevent
+ * infinite recursion ("hall of mirrors" effect). This hook enables it by setting
+ * selfBrowserSurface: "include", but be aware this may cause visual feedback loops.
+ *
+ * @param {Room | null} room - LiveKit room instance
+ * @returns {ScreenShareControls} Object containing screen share control methods and state
+ *
+ * @example
+ * ```tsx
+ * function ScreenShareControls() {
+ *   const screenShareControls = useScreenShare(room);
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={screenShareControls.toggleScreenShare}>
+ *         {screenShareControls.isScreenShareEnabled ? 'Stop Sharing' : 'Share Screen'}
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare const useScreenShare: (room: Room | null) => ScreenShareControls;
+//# sourceMappingURL=useScreenShare.d.ts.map

package/dist/hooks/useScreenShare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScreenShare.d.ts","sourceRoot":"","sources":["../../src/hooks/useScreenShare.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAGtC,MAAM,WAAW,mBAAmB;IAElC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,mBAAmB,EAAE,OAAO,CAAC;IAG7B,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,kBAAkB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAGvC,0BAA0B,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAGhD,oBAAoB,EAAE,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;CAC5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,IAAI,GAAG,IAAI,KAAG,mBAsLlD,CAAC"}

package/dist/hooks/useScreenShare.js

@@ -0,0 +1,198 @@
+import { useCallback, useState, useEffect } from "react";
+import { logger } from "../utils/logger";
+/**
+ * Hook for managing screen sharing controls in LiveKit.
+ *
+ * Provides methods to enable/disable screen sharing, manage screen share state,
+ * and handle screen sharing with audio support.
+ *
+ * Features:
+ * - Includes current tab in screen share options (selfBrowserSurface: "include")
+ * - Supports surface switching during screen share
+ * - Supports system audio capture
+ *
+ * Note: By default, browsers exclude the current tab from screen share to prevent
+ * infinite recursion ("hall of mirrors" effect). This hook enables it by setting
+ * selfBrowserSurface: "include", but be aware this may cause visual feedback loops.
+ *
+ * @param {Room | null} room - LiveKit room instance
+ * @returns {ScreenShareControls} Object containing screen share control methods and state
+ *
+ * @example
+ * ```tsx
+ * function ScreenShareControls() {
+ *   const screenShareControls = useScreenShare(room);
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={screenShareControls.toggleScreenShare}>
+ *         {screenShareControls.isScreenShareEnabled ? 'Stop Sharing' : 'Share Screen'}
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export const useScreenShare = (room) => {
+    const [isScreenShareEnabled, setIsScreenShareEnabled] = useState(false);
+    const [isScreenShareActive, setIsScreenShareActive] = useState(false);
+    // Update screen share state when room changes
+    useEffect(() => {
+        if (!room) {
+            setIsScreenShareEnabled(false);
+            setIsScreenShareActive(false);
+            return;
+        }
+        const localParticipant = room.localParticipant;
+        // Set initial state
+        setIsScreenShareEnabled(localParticipant.isScreenShareEnabled);
+        setIsScreenShareActive(localParticipant.isScreenShareEnabled);
+        // Listen for screen share state changes
+        const handleTrackPublished = (track) => {
+            if (track.source === 'screen_share') {
+                setIsScreenShareActive(true);
+                logger.log("🖥️ Screen share started");
+            }
+        };
+        const handleTrackUnpublished = (track) => {
+            if (track.source === 'screen_share') {
+                setIsScreenShareActive(false);
+                logger.log("🖥️ Screen share stopped");
+            }
+        };
+        const handleTrackMuted = (track) => {
+            if (track.source === 'screen_share') {
+                setIsScreenShareActive(false);
+                logger.log("🖥️ Screen share muted");
+            }
+        };
+        const handleTrackUnmuted = (track) => {
+            if (track.source === 'screen_share') {
+                setIsScreenShareActive(true);
+                logger.log("🖥️ Screen share unmuted");
+            }
+        };
+        // Subscribe to events
+        localParticipant.on('trackPublished', handleTrackPublished);
+        localParticipant.on('trackUnpublished', handleTrackUnpublished);
+        localParticipant.on('trackMuted', handleTrackMuted);
+        localParticipant.on('trackUnmuted', handleTrackUnmuted);
+        return () => {
+            localParticipant.off('trackPublished', handleTrackPublished);
+            localParticipant.off('trackUnpublished', handleTrackUnpublished);
+            localParticipant.off('trackMuted', handleTrackMuted);
+            localParticipant.off('trackUnmuted', handleTrackUnmuted);
+        };
+    }, [room]);
+    // Enable screen share
+    const enableScreenShare = useCallback(async () => {
+        if (!room) {
+            logger.warn("Cannot enable screen share: no room connection");
+            return;
+        }
+        try {
+            // Use setScreenShareEnabled with options to include current tab
+            await room.localParticipant.setScreenShareEnabled(true, {
+                // @ts-ignore - selfBrowserSurface is a valid Chrome option but may not be in types
+                selfBrowserSurface: "include",
+                surfaceSwitching: "include",
+                systemAudio: "include",
+            });
+            setIsScreenShareEnabled(true);
+            logger.log("🖥️ Screen share enabled successfully");
+        }
+        catch (error) {
+            logger.error("Failed to enable screen share:", error);
+            throw error;
+        }
+    }, [room]);
+    // Disable screen share
+    const disableScreenShare = useCallback(async () => {
+        if (!room) {
+            logger.warn("Cannot disable screen share: no room connection");
+            return;
+        }
+        try {
+            await room.localParticipant.setScreenShareEnabled(false);
+            setIsScreenShareEnabled(false);
+            logger.log("🖥️ Screen share disabled successfully");
+        }
+        catch (error) {
+            logger.error("Failed to disable screen share:", error);
+            throw error;
+        }
+    }, [room]);
+    // Toggle screen share
+    const toggleScreenShare = useCallback(async () => {
+        if (isScreenShareEnabled) {
+            await disableScreenShare();
+        }
+        else {
+            await enableScreenShare();
+        }
+    }, [isScreenShareEnabled, enableScreenShare, disableScreenShare]);
+    // Enable screen share with audio
+    const enableScreenShareWithAudio = useCallback(async () => {
+        if (!room) {
+            logger.warn("Cannot enable screen share with audio: no room connection");
+            return;
+        }
+        try {
+            // Create screen tracks with audio enabled and include current tab
+            const tracks = await room.localParticipant.createScreenTracks({
+                audio: true,
+                // @ts-ignore - selfBrowserSurface is a valid Chrome option but may not be in types
+                selfBrowserSurface: "include",
+                surfaceSwitching: "include",
+                systemAudio: "include",
+            });
+            // Publish each track
+            tracks.forEach((track) => {
+                room.localParticipant.publishTrack(track);
+            });
+            setIsScreenShareEnabled(true);
+            logger.log("🖥️ Screen share with audio enabled successfully");
+        }
+        catch (error) {
+            logger.error("Failed to enable screen share with audio:", error);
+            throw error;
+        }
+    }, [room]);
+    // Get screen share tracks
+    const getScreenShareTracks = useCallback(async () => {
+        if (!room) {
+            logger.warn("Cannot get screen share tracks: no room connection");
+            return [];
+        }
+        try {
+            const localParticipant = room.localParticipant;
+            const screenShareTracks = [];
+            // Get all published tracks
+            localParticipant.trackPublications.forEach((publication) => {
+                if (publication.source === 'screen_share' && publication.track) {
+                    screenShareTracks.push(publication.track);
+                }
+            });
+            logger.log("🖥️ Screen share tracks:", screenShareTracks);
+            return screenShareTracks;
+        }
+        catch (error) {
+            logger.error("Failed to get screen share tracks:", error);
+            throw error;
+        }
+    }, [room]);
+    return {
+        // Screen share state
+        isScreenShareEnabled,
+        isScreenShareActive,
+        // Screen share controls
+        enableScreenShare,
+        disableScreenShare,
+        toggleScreenShare,
+        // Screen share with audio
+        enableScreenShareWithAudio,
+        // Screen share settings
+        getScreenShareTracks,
+    };
+};
+//# sourceMappingURL=useScreenShare.js.map

package/dist/hooks/useScreenShare.js.map

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

package/dist/hooks/useTemplateKeysUpdater.d.ts

@@ -0,0 +1,35 @@
+import { Room } from "livekit-client";
+export interface TemplateKeys {
+    [key: string]: string;
+}
+/**
+ * Hook for updating template keys in Convai.
+ *
+ * Updates dynamic template variables that can be used in AI responses
+ * to provide personalized and contextual information.
+ *
+ * @param {Room} room - LiveKit room instance
+ * @param {string} participantSid - Participant session ID
+ * @returns {Object} Object containing updateTemplateKeys function
+ *
+ * @example
+ * ```tsx
+ * function TemplateComponent() {
+ *   const { updateTemplateKeys } = useTemplateKeysUpdater(room, participantSid);
+ *
+ *   const handleUpdate = () => {
+ *     updateTemplateKeys({
+ *       user_name: "John",
+ *       location: "New York",
+ *       mood: "happy"
+ *     });
+ *   };
+ *
+ *   return <button onClick={handleUpdate}>Update Templates</button>;
+ * }
+ * ```
+ */
+export declare const useTemplateKeysUpdater: (room: Room, participantSid: string) => {
+    updateTemplateKeys: (templateKeys: TemplateKeys) => void;
+};
+//# sourceMappingURL=useTemplateKeysUpdater.d.ts.map

package/dist/hooks/useTemplateKeysUpdater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTemplateKeysUpdater.d.ts","sourceRoot":"","sources":["../../src/hooks/useTemplateKeysUpdater.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAGtC,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,IAAI,EACV,gBAAgB,MAAM;uCAGL,YAAY;CA4B9B,CAAC"}