@skippr/live-agent-sdk 0.87.0 → 0.88.0

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

@@ -0,0 +1,11 @@
+import type { BarNotification } from '../hooks/useBarNotifications';
+import { type LauncherMode } from '../lib/constants';
+import { type BarDock } from '../lib/voiceBar';
+interface LauncherNotificationProps {
+    notifications: BarNotification[];
+    dock: BarDock;
+    mode: Exclude<LauncherMode, 'none'>;
+    onDismiss: () => void;
+}
+export declare function LauncherNotification({ notifications, dock, mode, onDismiss, }: LauncherNotificationProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

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

@@ -1,4 +1,4 @@
-import type { PlanCardData } from '../hooks/usePlanUpdates';
+import { type PlanCardData } from '../hooks/usePlanUpdates';
 import type { Message } from '../types';
 interface MessageListProps {
     messages: Message[];

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

@@ -4,5 +4,8 @@ interface PlanCardProps {
     sendChatMessage: (message: string) => Promise<unknown>;
     onDismiss: () => void;
 }
+export declare const APPROVE_MESSAGE = "Yes, go ahead.";
+export declare const CANCEL_MESSAGE = "No, cancel that.";
+export declare const COMPLETED_CARD_VISIBLE_MS = 2500;
 export declare function PlanCard({ plan, sendChatMessage, onDismiss }: PlanCardProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -0,0 +1,5 @@
+interface VoiceBarProps {
+    revealed: boolean;
+}
+export declare function VoiceBar({ revealed }: VoiceBarProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

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

@@ -0,0 +1,8 @@
+import type { BarDock } from '../lib/voiceBar';
+interface VoiceBarChatLineProps {
+    dock: BarDock;
+    canSend: boolean;
+    onClose: () => void;
+}
+export declare function VoiceBarChatLine({ dock, canSend, onClose }: VoiceBarChatLineProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,11 @@
+import type { BarNotification } from '../hooks/useBarNotifications';
+import { type BarDock } from '../lib/voiceBar';
+interface VoiceBarFrameProps {
+    dock: BarDock;
+    canFold: boolean;
+    notifications: BarNotification[];
+    onDrop: (dock: BarDock) => void;
+    setDragging: (dragging: boolean) => void;
+}
+export declare function VoiceBarFrame({ dock, canFold, notifications, onDrop, setDragging, }: VoiceBarFrameProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,15 @@
+import type { BarNotification } from '../hooks/useBarNotifications';
+import { type LauncherMode } from '../lib/constants';
+import { type BarDock } from '../lib/voiceBar';
+interface VoiceBarLauncherProps {
+    dock: BarDock;
+    mode: Exclude<LauncherMode, 'none'>;
+    logoUrl: string | null;
+    notifications: BarNotification[];
+    onOpen: () => void;
+    onChat: (() => void) | null;
+    onDrop: (dock: BarDock) => void;
+    setDragging: (dragging: boolean) => void;
+}
+export declare function VoiceBarLauncher({ dock, mode, logoUrl, notifications, onOpen, onChat, onDrop, setDragging, }: VoiceBarLauncherProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,9 @@
+import type { BarNotification } from '../hooks/useBarNotifications';
+import { type BarDock } from '../lib/voiceBar';
+interface VoiceBarNotificationProps {
+    notifications: BarNotification[];
+    dock: BarDock;
+    onDismiss: () => void;
+}
+export declare function VoiceBarNotification({ notifications, dock, onDismiss, }: VoiceBarNotificationProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

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

@@ -0,0 +1,8 @@
+import type { PlanCardData } from '../hooks/usePlanUpdates';
+interface VoiceBarPlanCardProps {
+    plan: PlanCardData;
+    sendChatMessage: (message: string) => Promise<unknown>;
+    onDismiss: () => void;
+}
+export declare function VoiceBarPlanCard({ plan, sendChatMessage, onDismiss }: VoiceBarPlanCardProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -1,8 +1,9 @@
 import type { LauncherDropTarget } from '../hooks/useLauncherDrag';
 import type { PhaseStatus } from '../hooks/usePhaseUpdates';
 import type { AgentMode } from '../lib/agentMode';
-import { CAPTURE_MODE, type CaptureMode, DEFAULT_CAPTURE_MODE, MIC_MODE, type MicMode } from '../lib/constants';
+import { CAPTURE_MODE, type CaptureMode, type ChatSurface, DEFAULT_CAPTURE_MODE, type LauncherMode, MIC_MODE, type MicMode } from '../lib/constants';
 import type { SessionStatus } from '../lib/sessionStatus';
+import type { BarDock } from '../lib/voiceBar';
 import type { Message } from '../types';
 export type SidebarTab = 'chat' | 'agenda';
 export { CAPTURE_MODE, type CaptureMode, DEFAULT_CAPTURE_MODE, MIC_MODE, type MicMode };
@@ -10,6 +11,7 @@ export interface AgentControls {
     highlight?: boolean;
     actions?: boolean;
     micMode?: MicMode;
+    chat?: ChatSurface;
 }
 export interface UiPreferences {
     animateCursor?: boolean;
@@ -46,6 +48,7 @@ export interface WidgetAppearance {
     logoUrl: string | null;
     position: 'left' | 'right' | null;
     verticalAlign: 'top' | 'middle' | 'bottom' | null;
+    launcherMode: LauncherMode | null;
 }
 export interface IdleSessionHistory {
     messages: Message[];
@@ -65,6 +68,7 @@ export interface AdoptionGoalMatch {
     goalId: string;
     agentId: string;
     displayMessage: string;
+    objective: string;
     matchType: AdoptionMatchType;
     hashPattern: string | null;
     priority: number;
@@ -117,6 +121,7 @@ export interface LiveAgentPublicValue {
     modulesError: string | null;
     refetchModules: () => Promise<void>;
     selectModule: (id: string) => void;
+    textMode: boolean;
 }
 export interface LiveAgentContextValue extends LiveAgentPublicValue {
     defaultAgentId: string | null;
@@ -137,17 +142,21 @@ export interface LiveAgentContextValue extends LiveAgentPublicValue {
     appearance: WidgetAppearance | null;
     adoptionGoals: AdoptionGoalMatch[];
     startAdoptionSession: (goal: AdoptionGoalMatch) => void;
-    textMode: boolean;
+    attendGoal: (goalId: string) => void;
     setTextModeState: (enabled: boolean) => void;
     launcherBottomPx: number;
     setLauncherBottomPx: (px: number) => void;
     commitLauncherDrop: (target: LauncherDropTarget) => void;
     popsDown: boolean;
+    barDock: BarDock | null;
+    setBarDock: (next: BarDock) => void;
     panelExpanded: boolean;
     togglePanelExpanded: () => void;
     panelRef: React.RefObject<HTMLDivElement | null>;
     controlBarRef: React.RefObject<HTMLDivElement | null>;
     isDragging: boolean;
     setIsDragging: (dragging: boolean) => void;
+    chatActivityAt: number;
+    reportChatActivity: () => void;
 }
 export declare const LiveAgentContext: import("react").Context<LiveAgentContextValue | null>;

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

@@ -0,0 +1,2 @@
+import { type AdoptionGoalMatch } from '../context/LiveAgentContext';
+export declare function useAdoptionTips(): AdoptionGoalMatch[];

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

@@ -0,0 +1,9 @@
+import { type NotificationKind } from '../lib/constants';
+export interface BarNotification {
+    id: string;
+    kind: NotificationKind;
+    message: string;
+    accentColor: string;
+    activate: () => void;
+}
+export declare function useBarNotifications(): BarNotification[];

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

@@ -0,0 +1,9 @@
+export interface UseIdleAutoOffOptions {
+    enabled: boolean;
+    active: boolean;
+    onExpire: () => void;
+}
+export interface UseIdleAutoOffValue {
+    reportActivity: () => void;
+}
+export declare function useIdleAutoOff({ enabled, active, onExpire, }: UseIdleAutoOffOptions): UseIdleAutoOffValue;

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

@@ -3,6 +3,8 @@ interface UseKeyboardPushToTalkOptions {
     onStart: () => void;
     onCommit: () => void;
     onKeyUsed?: () => void;
+    code?: string;
+    requireCtrl?: boolean;
 }
-export declare function useKeyboardPushToTalk({ enabled, onStart, onCommit, onKeyUsed, }: UseKeyboardPushToTalkOptions): void;
+export declare function useKeyboardPushToTalk({ enabled, onStart, onCommit, onKeyUsed, code, requireCtrl, }: UseKeyboardPushToTalkOptions): void;
 export {};

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

@@ -0,0 +1,6 @@
+interface UseKeyboardStopOptions {
+    enabled: boolean;
+    onStop: () => void;
+}
+export declare function useKeyboardStop({ enabled, onStop }: UseKeyboardStopOptions): void;
+export {};

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

@@ -11,4 +11,5 @@ export interface PlanCardData {
     state: PlanState;
 }
 export declare function parsePlan(json: string): PlanCardData | null;
+export declare function isPlanVisible(plan: PlanCardData | null | undefined): plan is PlanCardData;
 export declare function usePlanUpdates(): PlanCardData | null;

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

@@ -0,0 +1 @@
+export declare function usePointerHold(onStart: () => void, onCommit: () => void): (event: React.PointerEvent) => void;

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

@@ -0,0 +1,5 @@
+export interface SessionTimer {
+    label: string;
+    warning: boolean;
+}
+export declare function useSessionTimer(isRunning: boolean, resetSignal?: unknown): SessionTimer | null;

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

@@ -0,0 +1,6 @@
+import { type BarDock } from '../lib/voiceBar';
+type FollowerRef = React.RefObject<HTMLElement | null>;
+export declare function useVoiceBarDrag(containerRef: React.RefObject<HTMLElement | null>, onDrop: (dock: BarDock) => void, followRefs?: FollowerRef[] | null, reportDragging?: (dragging: boolean) => void): {
+    wasDraggedRef: React.RefObject<boolean>;
+};
+export {};

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

@@ -1,4 +1,4 @@
-export declare const SIDEBAR_WIDTH = 280;
+export declare const SIDEBAR_WIDTH = 255;
 export declare const CAPTURE_MODE: {
     readonly Screenshare: "screenshare";
     readonly Auto: "auto";
@@ -8,6 +8,7 @@ export declare const DEFAULT_CAPTURE_MODE: CaptureMode;
 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 NO_DRAG_ATTR = "data-skippr-no-drag";
 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";
@@ -24,8 +25,39 @@ export declare const MIC_MODE: {
 export type MicMode = (typeof MIC_MODE)[keyof typeof MIC_MODE];
 export declare const DEFAULT_MIC_MODE: MicMode;
 export declare function isRequestResponseMicMode(micMode: MicMode | undefined): micMode is typeof MIC_MODE.PushToTalk | typeof MIC_MODE.TapToTalk;
+export declare const CHAT_SURFACE: {
+    readonly Line: "line";
+    readonly Room: "room";
+};
+export type ChatSurface = (typeof CHAT_SURFACE)[keyof typeof CHAT_SURFACE];
+export declare const DEFAULT_CHAT_SURFACE: ChatSurface;
+export declare const LAUNCHER_MODE: {
+    readonly Avatar: "avatar";
+    readonly Strip: "strip";
+    readonly None: "none";
+    readonly Custom: "custom";
+};
+export type LauncherMode = (typeof LAUNCHER_MODE)[keyof typeof LAUNCHER_MODE];
+export declare const DEFAULT_LAUNCHER_MODE: LauncherMode;
 export declare const PUSH_TO_TALK_KEY = "Backquote";
 export declare const PUSH_TO_TALK_KEY_LABEL = "`";
+export declare const STOP_AGENT_KEY = "KeyX";
 export declare const IDLE_AUTO_PAUSE_MS: number;
+export declare const IDLE_AUTO_OFF_MS: number;
+export declare const AUTO_OFF_NOTICE_MS = 3500;
+export declare const CHAT_ACTIVITY_THROTTLE_MS = 15000;
+export declare const MAX_ADOPTION_TIPS = 3;
+export declare const TIP_ROTATE_MS = 2000;
+export declare const TIP_HIDE_MS = 6000;
+export declare const SESSION_TIMER_WARNING_S = 120;
+export declare const SESSION_TIMER_HOLD_MS = 6000;
+export declare const SESSION_TIMER_INTERVAL_MS: number;
+export declare const NOTIF_ACCENT_COLOR = "#199a89";
+export declare const MODULE_ACCENT_COLOR = "#e0574f";
+export declare const NOTIFICATION_KIND: {
+    readonly Tip: "tip";
+    readonly Module: "module";
+};
+export type NotificationKind = (typeof NOTIFICATION_KIND)[keyof typeof NOTIFICATION_KIND];
 export declare const PLAN_ATTR = "skippr.action-plan";
 export declare const NAME_MAX_CHARS = 80;

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

@@ -1,2 +1,3 @@
 import { type ClassValue } from 'clsx';
 export declare function cn(...inputs: ClassValue[]): string;
+export declare function isEditableTarget(): boolean;

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

@@ -0,0 +1,18 @@
+export type BarEdge = 'left' | 'right' | 'top' | 'bottom';
+export declare const VOICE_BAR_EDGE_MARGIN_PX = 16;
+export declare const VOICE_BAR_HEIGHT_PX = 46;
+export declare const VOICE_BAR_WIDTH_PX = 255;
+export interface BarDock {
+    edge: BarEdge;
+    offsetPx: number;
+}
+export type DockKind = 'bar' | 'launcher';
+export declare function isHorizontalEdge(edge: BarEdge): boolean;
+export declare function readSavedDock(kind: DockKind): BarDock | null;
+export declare function persistDock(kind: DockKind, dock: BarDock): void;
+export declare function clampOffset(edge: BarEdge, offsetPx: number): number;
+export declare function defaultOffset(edge: BarEdge): number;
+export declare function nearestEdge(clientX: number, clientY: number): BarEdge;
+export declare function dropTargetFromPointer(clientX: number, clientY: number): BarDock;
+export declare function dockStyle(dock: BarDock): React.CSSProperties;
+export declare function dockStyleFlush(dock: BarDock): React.CSSProperties;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skippr/live-agent-sdk",
-  "version": "0.87.0",
+  "version": "0.88.0",
   "type": "module",
   "main": "dist/esm/lib-exports.js",
   "module": "dist/esm/lib-exports.js",