@skippr/live-agent-sdk 0.27.0 → 0.29.0

package/dist/types/capture/a11yTree.d.ts

@@ -0,0 +1,11 @@
+interface AccessibilityTreeResult {
+    pageContent: string;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    refCount: number;
+    truncated: boolean;
+}
+export declare function buildAccessibilityTree(): AccessibilityTreeResult;
+export {};

package/dist/types/capture/a11yUtils.d.ts

@@ -0,0 +1,6 @@
+export declare function inferRole(element: Element): string | null;
+interface AccessibleNameOptions {
+    quick?: boolean;
+}
+export declare function accessibleName(element: Element, options?: AccessibleNameOptions): string;
+export {};

package/dist/types/capture/domEvents.d.ts

@@ -0,0 +1,31 @@
+import type { LocalParticipant } from 'livekit-client';
+export type DomEvent = {
+    type: 'click';
+    ref: string | null;
+    role: string;
+    name: string;
+    timestamp: number;
+} | {
+    type: 'navigation';
+    from: string;
+    to: string;
+    title: string;
+    timestamp: number;
+} | {
+    type: 'submit';
+    ref: string | null;
+    formName: string;
+    action: string;
+    timestamp: number;
+} | {
+    type: 'mutation';
+    summary: string;
+    addedRefs: string[];
+    removedRefs: string[];
+    timestamp: number;
+};
+interface DomEventListenerOptions {
+    onTriggerEvent?: () => void;
+}
+export declare function installDomEventListeners(localParticipant: LocalParticipant, options?: DomEventListenerOptions): () => void;
+export {};

package/dist/types/capture/snapdom.d.ts

@@ -0,0 +1,2 @@
+import type { SnapdomOptions } from '@zumer/snapdom';
+export declare function snapToCanvas(element: Element, options?: SnapdomOptions): Promise<HTMLCanvasElement>;

package/dist/types/components/DomCapture.d.ts

@@ -0,0 +1 @@
+export declare function DomCapture(): null;

package/dist/types/components/HighlightOverlay.d.ts

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

package/dist/types/components/LiveAgent.d.ts

@@ -1,5 +1,6 @@
 import { type ReactNode } from 'react';
-interface LiveAgentProps {
+import { type AgentControls } from '../context/LiveAgentContext';
+interface LiveAgentBaseProps {
     agentId: string;
     authToken?: string | undefined;
     appKey?: string | undefined;
@@ -16,5 +17,12 @@ interface LiveAgentProps {
     showAgentStateBanner?: boolean;
     children?: ReactNode;
 }
-export declare function LiveAgent({ agentId, authToken: authTokenProp, appKey, userToken, position, variant, minimizable, defaultOpen, welcomeMessage, hideControls, hideHeader, startSessionLabel, autoFocusChat, showAgentStateBanner, children, }: LiveAgentProps): import("react/jsx-runtime").JSX.Element;
+export type LiveAgentProps = (LiveAgentBaseProps & {
+    captureMode?: 'screenshare' | undefined;
+    agentControls?: never;
+}) | (LiveAgentBaseProps & {
+    captureMode: 'auto';
+    agentControls?: AgentControls | undefined;
+});
+export declare function LiveAgent(props: LiveAgentProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/MeetingControls.d.ts

@@ -1,5 +1,6 @@
 interface MeetingControlsProps {
     onHangUp: () => void;
+    showScreenShareToggle?: boolean;
 }
-export declare function MeetingControls({ onHangUp }: MeetingControlsProps): import("react/jsx-runtime").JSX.Element;
+export declare function MeetingControls({ onHangUp, showScreenShareToggle }: MeetingControlsProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/context/LiveAgentContext.d.ts

@@ -1,4 +1,8 @@
 export type SidebarTab = 'chat' | 'agenda';
+export type CaptureMode = 'screenshare' | 'auto';
+export interface AgentControls {
+    highlight?: boolean;
+}
 export interface LiveAgentPublicValue {
     isConnected: boolean;
     isStarting: boolean;
@@ -27,6 +31,8 @@ export interface LiveAgentPublicValue {
     sidebarTab: SidebarTab;
     setSidebarTab: (tab: SidebarTab) => void;
     autoFocusChat: boolean;
+    captureMode: CaptureMode;
+    agentControls?: AgentControls | undefined;
 }
 export interface LiveAgentContextValue extends LiveAgentPublicValue {
     connection: {

package/dist/types/hooks/useAgentVoiceState.d.ts

@@ -1,4 +1,4 @@
-import { useVoiceAssistant } from '@livekit/components-react';
+import { useVoiceAssistant } from '@livekit/components-react/hooks';
 export type AgentState = ReturnType<typeof useVoiceAssistant>['state'];
 export interface UseAgentVoiceStateValue {
     state: AgentState;

package/dist/types/hooks/useSession.d.ts

@@ -1,14 +1,17 @@
+import type { AgentControls, CaptureMode } from '../context/LiveAgentContext';
 interface LiveKitConnection {
     livekitUrl: string;
     token: string;
 }
 interface UseSessionParams {
     agentId: string;
+    captureMode?: CaptureMode | undefined;
+    agentControls?: AgentControls | undefined;
     authToken?: string | undefined;
     appKey?: string | undefined;
     userToken?: string | undefined;
 }
-export declare function useSession({ agentId, authToken, appKey, userToken }: UseSessionParams): {
+export declare function useSession({ agentId, captureMode, agentControls, authToken, appKey, userToken, }: UseSessionParams): {
     connection: LiveKitConnection | null;
     shouldConnect: boolean;
     isStarting: boolean;

package/dist/types/lib/constants.d.ts

@@ -1 +1,8 @@
 export declare const SIDEBAR_WIDTH = 360;
+export declare const WIDGET_ROOT_ID = "skippr-sdk-root";
+export declare const REF_ATTR = "data-skippr-ref";
+export declare const PRIVATE_ATTR = "data-skippr-private";
+export declare const DOM_SNAPSHOT_TOPIC = "skippr.dom-snapshot";
+export declare const DOM_EVENTS_TOPIC = "skippr.dom-events";
+export declare const HIGHLIGHT_TOPIC = "skippr.highlight";
+export declare const NAME_MAX_CHARS = 80;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skippr/live-agent-sdk",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "type": "module",
   "main": "dist/esm/lib-exports.js",
   "module": "dist/esm/lib-exports.js",
@@ -31,6 +31,7 @@
     "release": "release-it"
   },
   "dependencies": {
+    "@zumer/snapdom": "^2.9.0",
     "clsx": "2.1.1",
     "lucide-react": "1.8.0",
     "tailwind-merge": "3.5.0"