@voxket-ai/voxket-live 1.0.31 → 1.0.32

package/README.md

@@ -87,6 +87,12 @@ The `VoxketWidget` component accepts the following props:
 | `suportsChatInput`  | `boolean`    | No       | `true`      | Enables or disables the text chat input feature.                                                           |
 | `suportsVideoInput` | `boolean`    | No       | `true`      | Enables or disables the user's video input feature.                                                        |
 | `suportsScreenShare`| `boolean`    | No       | `true`      | Enables or disables the screen sharing feature for the user.                                               |
+| `theme`             | `'dark' \| 'light' \| 'vox'` | No | `'vox'` | Sets the widget's visual theme.                                                                             |
+| `onSessionStart`    | `(sessionId: string) => void` | No | `undefined` | Callback fired when a session starts. Receives the session ID.                                             |
+| `onSessionEnd`      | `(metrics: SessionMetrics) => void` | No | `undefined` | Callback fired when a session ends. Receives session metrics.                                              |
+| `enableSessionLogging` | `boolean` | No       | `true`      | Enables or disables session logging functionality.                                                         |
+| `onSessionLogsUpdate` | `(logs: SessionLog[]) => void` | No | `undefined` | Callback fired when session logs are updated. Provides real-time access to session events.                |
+| `onSessionMetricsUpdate` | `(metrics: SessionMetrics) => void` | No | `undefined` | Callback fired when session metrics are updated. Provides real-time access to session metrics.            |
 
 *(Note: `suportsChatInput` had a typo `suportsChatInput` in some internal example files, but the correct prop name used by the widget is `suportsChatInput`.)*
 
@@ -97,6 +103,83 @@ The `VoxketWidget` component accepts the following props:
 - **Device Permissions:** The widget will request microphone and camera permissions as needed when the session starts.
 - **Error Handling:** Basic error messages are displayed for connection issues or media device errors using toast notifications.
 
+## Session Logging
+
+The widget provides comprehensive session logging capabilities that allow you to capture and analyze user interactions in real-time.
+
+### Basic Session Logging
+
+```tsx
+import VoxketWidget from '@voxket-ai/voxket-live';
+
+function App() {
+  const handleSessionStart = (sessionId: string) => {
+    console.log('Session started:', sessionId);
+  };
+
+  const handleSessionEnd = (metrics: any) => {
+    console.log('Session ended:', metrics);
+  };
+
+  return (
+    <VoxketWidget
+      agentId="your-agent-id"
+      // ... other props
+      onSessionStart={handleSessionStart}
+      onSessionEnd={handleSessionEnd}
+      enableSessionLogging={true}
+    />
+  );
+}
+```
+
+### Real-time Session Data Access
+
+Get access to session logs and metrics in real-time:
+
+```tsx
+import VoxketWidget, { SessionLog, SessionMetrics } from '@voxket-ai/voxket-live';
+
+function App() {
+  const [sessionLogs, setSessionLogs] = useState<SessionLog[]>([]);
+  const [sessionMetrics, setSessionMetrics] = useState<SessionMetrics | null>(null);
+
+  const handleSessionLogsUpdate = (logs: SessionLog[]) => {
+    setSessionLogs(logs);
+    // Send to your analytics service
+    analytics.track('session_logs_update', { logCount: logs.length });
+  };
+
+  const handleSessionMetricsUpdate = (metrics: SessionMetrics) => {
+    setSessionMetrics(metrics);
+    // Update your dashboard
+    updateDashboard(metrics);
+  };
+
+  return (
+    <VoxketWidget
+      agentId="your-agent-id"
+      // ... other props
+      onSessionLogsUpdate={handleSessionLogsUpdate}
+      onSessionMetricsUpdate={handleSessionMetricsUpdate}
+      enableSessionLogging={true}
+    />
+  );
+}
+```
+
+### Available Session Events
+
+- `SESSION_STARTED` - When a session begins
+- `SESSION_ENDED` - When a session ends
+- `PARTICIPANT_CONNECTED` - When a participant joins
+- `PARTICIPANT_DISCONNECTED` - When a participant leaves
+- `DATA_RECEIVED` - When a message is received
+- `TRACK_PUBLISHED` - When media tracks are published
+- `CONNECTION_ISSUE` - When connection problems occur
+
+For detailed session logging documentation, see [CONSUMER_SESSION_LOGGING.md](./CONSUMER_SESSION_LOGGING.md).
+
 ## Styling
 
 The widget is styled using Tailwind CSS. You can customize its appearance:
@@ -111,7 +194,3 @@ This SDK is part of the Voxket AI agent marketplace. For issues, feature request
 ## License
 
 This SDK is [MIT Licensed](./LICENSE). (Assuming MIT from the existing LICENSE file).
-```
-
-
-pacakge link: https://www.npmjs.com/package/@voxket-ai/voxket-live

package/dist/components/livekit/agent-control-bar/agent-control-bar.d.ts

@@ -1,6 +1,7 @@
 import { Track } from 'livekit-client';
 import { AppConfig } from '../../../lib/types';
 import { UseAgentControlBarProps } from './hooks/use-agent-control-bar';
+import { ThemeType } from '../../../styles';
 import * as React from 'react';
 export interface AgentControlBarProps extends React.HTMLAttributes<HTMLDivElement>, UseAgentControlBarProps {
     capabilities: Pick<AppConfig, 'suportsChatInput' | 'suportsVideoInput' | 'suportsScreenShare'>;
@@ -11,8 +12,9 @@ export interface AgentControlBarProps extends React.HTMLAttributes<HTMLDivElemen
         source: Track.Source;
         error: Error;
     }) => void;
+    theme?: ThemeType;
 }
 /**
  * A control bar specifically designed for voice assistant interfaces
  */
-export declare function AgentControlBar({ controls, saveUserChoices, capabilities, className, onSendMessage, onChatOpenChange, onDisconnect, onDeviceError, ...props }: AgentControlBarProps): import("react/jsx-runtime").JSX.Element;
+export declare function AgentControlBar({ controls, saveUserChoices, capabilities, className, onSendMessage, onChatOpenChange, onDisconnect, onDeviceError, theme, ...props }: AgentControlBarProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/session-logger.d.ts

@@ -0,0 +1,11 @@
+interface SessionLogViewerProps {
+    logs: any[];
+    onClear?: () => void;
+    onExport?: () => void;
+}
+export declare function SessionLogViewer({ logs, onClear, onExport }: SessionLogViewerProps): import("react/jsx-runtime").JSX.Element;
+interface SessionMetricsProps {
+    metrics: any;
+}
+export declare function SessionMetrics({ metrics }: SessionMetricsProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/components/session-view.d.ts

@@ -1,4 +1,5 @@
 import { default as React } from 'react';
+import { ThemeType } from '../styles';
 interface SessionViewProps {
     disabled: boolean;
     capabilities: {
@@ -9,6 +10,7 @@ interface SessionViewProps {
     sessionStarted: boolean;
     participantName: string;
     loadingText?: string;
+    theme?: ThemeType;
 }
-export declare const SessionView: ({ disabled, capabilities, sessionStarted, ref, participantName, loadingText, }: React.ComponentProps<"div"> & SessionViewProps) => import("react/jsx-runtime").JSX.Element;
+export declare const SessionView: ({ disabled, capabilities, sessionStarted, ref, participantName, loadingText, theme, }: React.ComponentProps<"div"> & SessionViewProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/welcome.d.ts

@@ -1,3 +1,4 @@
+import { ThemeType } from '../styles';
 interface WelcomeProps {
     disabled: boolean;
     onStartCall: () => void;
@@ -9,6 +10,7 @@ interface WelcomeProps {
     statusMessage?: string;
     title?: string;
     subTitle?: string;
+    theme?: ThemeType;
 }
-export declare const Welcome: ({ disabled, onStartCall, prompts, statusMessage, title, subTitle, }: WelcomeProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Welcome: ({ disabled, onStartCall, prompts, statusMessage, title, subTitle, theme, }: WelcomeProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/widget.d.ts

@@ -1,3 +1,4 @@
+import { ThemeType } from '../styles';
 export interface VoxketWidgetProps {
     agentId: string;
     participantName?: string;
@@ -15,6 +16,12 @@ export interface VoxketWidgetProps {
     suportsChatInput?: boolean;
     suportsVideoInput?: boolean;
     suportsScreenShare?: boolean;
+    theme?: ThemeType;
+    onSessionStart?: (sessionId: string) => void;
+    onSessionEnd?: (metrics: any) => void;
+    enableSessionLogging?: boolean;
+    onSessionLogsUpdate?: (logs: any[]) => void;
+    onSessionMetricsUpdate?: (metrics: any) => void;
 }
 export default function Widget(props: VoxketWidgetProps & {
     prompts?: string[];

package/dist/hooks/useSessionLogging.d.ts

@@ -0,0 +1,34 @@
+import { Room } from 'livekit-client';
+export interface SessionLog {
+    timestamp: Date;
+    event: string;
+    data?: any;
+    sessionId?: string;
+    participantId?: string;
+}
+export interface SessionMetrics {
+    sessionId: string;
+    startTime: Date;
+    endTime?: Date;
+    duration?: number;
+    totalMessages: number;
+    connectionIssues: number;
+    participantCount: number;
+    events: SessionLog[];
+}
+interface UseSessionLoggingProps {
+    room?: Room;
+    onSessionEnd?: (metrics: SessionMetrics) => void;
+    onSessionStart?: (sessionId: string) => void;
+    enableConsoleLogging?: boolean;
+    enableLocalStorage?: boolean;
+}
+export declare function useSessionLogging({ room, onSessionEnd, onSessionStart, enableConsoleLogging, enableLocalStorage, }?: UseSessionLoggingProps): {
+    sessionMetrics: SessionMetrics | null;
+    sessionLogs: SessionLog[];
+    logEvent: (event: string, data?: any) => SessionLog;
+    getSessionLogs: () => any;
+    clearSessionLogs: () => void;
+    exportSessionLogs: () => void;
+};
+export {};