@skippr/live-agent-sdk 0.88.0 → 0.89.0

package/dist/types/buddy/BuddyCreature.d.ts

@@ -0,0 +1,10 @@
+import { type BuddyMode, type BuddyShape } from '../lib/constants';
+interface BuddyCreatureProps {
+    shape: BuddyShape;
+    mode: BuddyMode;
+    eyeDx: number;
+    eyeDy: number;
+    isTalking: boolean;
+}
+export declare function BuddyCreature({ shape, mode, eyeDx, eyeDy, isTalking }: BuddyCreatureProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/buddy/BuddyFace.d.ts

@@ -0,0 +1,10 @@
+interface BuddyFaceProps {
+    eyeDx: number;
+    eyeDy: number;
+    mouthPath: string;
+    mouthFill: string;
+    lidsPath: string;
+    pupilOpacity: number;
+}
+export declare function BuddyFace({ eyeDx, eyeDy, mouthPath, mouthFill, lidsPath, pupilOpacity, }: BuddyFaceProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/buddy/BuddyVoiceBar.d.ts

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

package/dist/types/buddy/buddy.d.ts

@@ -0,0 +1,20 @@
+import type { AgentControls, WidgetAppearance } from '../context/LiveAgentContext';
+export declare const SKIPPR_BUDDY_POS_KEY = "skippr_buddy_pos";
+export declare const BUDDY_SLEEP_MS = 14000;
+export declare const BUDDY_HAPPY_MS = 1300;
+export declare const BUDDY_SIZE_PX = 96;
+export declare const BUDDY_EDGE_MARGIN_PX = 16;
+export declare const BUDDY_DRAG_THRESHOLD_PX = 5;
+export interface BuddyPos {
+    x: number;
+    y: number;
+}
+export declare function isBuddyActive(appearance: WidgetAppearance | null): boolean;
+export declare function buddyEffectiveControls(base: AgentControls | undefined): AgentControls;
+export declare function clampBuddyPos(pos: BuddyPos, sizePx?: number): BuddyPos;
+export declare function readSavedBuddyPos(): BuddyPos | null;
+export declare function persistBuddyPos(pos: BuddyPos): void;
+export declare function seedBuddyPosFromAppearance(position: 'left' | 'right' | null, verticalAlign: 'top' | 'middle' | 'bottom' | null, viewport: {
+    innerWidth: number;
+    innerHeight: number;
+}, sizePx?: number): BuddyPos;

package/dist/types/buddy/hooks/useBuddyEyeTracking.d.ts

@@ -0,0 +1,9 @@
+export interface BuddyEyeDeltas {
+    eyeDx: number;
+    eyeDy: number;
+}
+export interface UseBuddyEyeTrackingOptions {
+    containerRef: React.RefObject<HTMLElement | null>;
+    disabled?: boolean;
+}
+export declare function useBuddyEyeTracking({ containerRef, disabled, }: UseBuddyEyeTrackingOptions): BuddyEyeDeltas;

package/dist/types/buddy/hooks/useBuddyFreeDrag.d.ts

@@ -0,0 +1,14 @@
+import { type BuddyPos } from '../buddy';
+export interface UseBuddyFreeDragOptions {
+    appearancePosition: 'left' | 'right' | null;
+    appearanceVerticalAlign: 'top' | 'middle' | 'bottom' | null;
+    sizePx?: number;
+}
+export interface UseBuddyFreeDragValue {
+    pos: BuddyPos;
+    isDragging: boolean;
+    startDrag: (event: React.PointerEvent) => {
+        didDrag: () => boolean;
+    };
+}
+export declare function useBuddyFreeDrag({ appearancePosition, appearanceVerticalAlign, sizePx, }: UseBuddyFreeDragOptions): UseBuddyFreeDragValue;

package/dist/types/buddy/hooks/useBuddyIdleMode.d.ts

@@ -0,0 +1,12 @@
+import { type BuddyMode } from '../../lib/constants';
+export interface UseBuddyIdleModeOptions {
+    isConnected: boolean;
+    isSpeaking: boolean;
+    isListening: boolean;
+}
+export interface UseBuddyIdleModeValue {
+    mode: BuddyMode;
+    reportActivity: () => void;
+    reportHover: () => void;
+}
+export declare function useBuddyIdleMode({ isConnected, isSpeaking, isListening, }: UseBuddyIdleModeOptions): UseBuddyIdleModeValue;

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

@@ -0,0 +1,3 @@
+export { BuddyCreature } from './BuddyCreature';
+export { BuddyVoiceBar } from './BuddyVoiceBar';
+export { buddyEffectiveControls, isBuddyActive } from './buddy';

package/dist/types/buddy/shapes/bespoke.d.ts

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

package/dist/types/buddy/shapes/colorful.d.ts

@@ -0,0 +1,5 @@
+export declare function BloomBody(): import("react/jsx-runtime").JSX.Element;
+export declare function WobbleBody(): import("react/jsx-runtime").JSX.Element;
+export declare function SplatBody(): import("react/jsx-runtime").JSX.Element;
+export declare function CloudBody(): import("react/jsx-runtime").JSX.Element;
+export declare function BoopBody(): import("react/jsx-runtime").JSX.Element;

package/dist/types/buddy/shapes/constants.d.ts

@@ -0,0 +1,6 @@
+import type { CSSProperties } from 'react';
+export declare const BODY_SIZE: {
+    readonly width: 96;
+    readonly height: 92;
+};
+export declare const BOX_ANIM_STYLE: CSSProperties;

package/dist/types/buddy/shapes/glass.d.ts

@@ -0,0 +1,5 @@
+export declare function BoulderBody(): import("react/jsx-runtime").JSX.Element;
+export declare function KiteBody(): import("react/jsx-runtime").JSX.Element;
+export declare function LoafBody(): import("react/jsx-runtime").JSX.Element;
+export declare function FacetBody(): import("react/jsx-runtime").JSX.Element;
+export declare function BellBody(): import("react/jsx-runtime").JSX.Element;

package/dist/types/buddy/shapes/index.d.ts

@@ -0,0 +1,9 @@
+import type { ReactElement } from 'react';
+import { type BuddyShape } from '../../lib/constants';
+export { BODY_SIZE } from './constants';
+export declare const SHAPE_BODY: Record<BuddyShape, () => ReactElement>;
+export interface ShapeFaceOffset {
+    left: number;
+    top: number;
+}
+export declare const SHAPE_FACE_OFFSET: Record<BuddyShape, ShapeFaceOffset>;

package/dist/types/buddy/shapes/original.d.ts

@@ -0,0 +1,4 @@
+export declare function BoltBody(): import("react/jsx-runtime").JSX.Element;
+export declare function TermBody(): import("react/jsx-runtime").JSX.Element;
+export declare function HexBody(): import("react/jsx-runtime").JSX.Element;
+export declare function BubBody(): import("react/jsx-runtime").JSX.Element;

package/dist/types/buddy/shapes/pixel.d.ts

@@ -0,0 +1,5 @@
+export declare function TotemBody(): import("react/jsx-runtime").JSX.Element;
+export declare function MelonBody(): import("react/jsx-runtime").JSX.Element;
+export declare function SunnyBody(): import("react/jsx-runtime").JSX.Element;
+export declare function StormBody(): import("react/jsx-runtime").JSX.Element;
+export declare function ReedBody(): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,6 @@
+export interface WidgetAnchor {
+    x: number;
+    y: number;
+}
+export declare function setWidgetAnchor(next: WidgetAnchor | null): void;
+export declare function getWidgetAnchor(): WidgetAnchor | null;

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

@@ -3,6 +3,7 @@ interface VoiceBarChatLineProps {
     dock: BarDock;
     canSend: boolean;
     onClose: () => void;
+    embedded?: boolean;
 }
-export declare function VoiceBarChatLine({ dock, canSend, onClose }: VoiceBarChatLineProps): import("react/jsx-runtime").JSX.Element;
+export declare function VoiceBarChatLine({ dock, canSend, onClose, embedded, }: VoiceBarChatLineProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -3,6 +3,7 @@ interface VoiceBarPlanCardProps {
     plan: PlanCardData;
     sendChatMessage: (message: string) => Promise<unknown>;
     onDismiss: () => void;
+    embedded?: boolean;
 }
-export declare function VoiceBarPlanCard({ plan, sendChatMessage, onDismiss }: VoiceBarPlanCardProps): import("react/jsx-runtime").JSX.Element;
+export declare function VoiceBarPlanCard({ plan, sendChatMessage, onDismiss, embedded, }: VoiceBarPlanCardProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,7 +1,7 @@
 import type { LauncherDropTarget } from '../hooks/useLauncherDrag';
 import type { PhaseStatus } from '../hooks/usePhaseUpdates';
 import type { AgentMode } from '../lib/agentMode';
-import { CAPTURE_MODE, type CaptureMode, type ChatSurface, DEFAULT_CAPTURE_MODE, type LauncherMode, MIC_MODE, type MicMode } from '../lib/constants';
+import { type BuddyShape, 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';
@@ -43,12 +43,17 @@ export interface ModuleDefault {
     agentId: string | null;
     sessionId: string | null;
 }
+export interface BuddyAppearance {
+    enabled: boolean;
+    shape: BuddyShape;
+}
 export interface WidgetAppearance {
     accentColor: string | null;
     logoUrl: string | null;
     position: 'left' | 'right' | null;
     verticalAlign: 'top' | 'middle' | 'bottom' | null;
     launcherMode: LauncherMode | null;
+    buddy: BuddyAppearance | null;
 }
 export interface IdleSessionHistory {
     messages: Message[];
@@ -126,6 +131,8 @@ export interface LiveAgentPublicValue {
 export interface LiveAgentContextValue extends LiveAgentPublicValue {
     defaultAgentId: string | null;
     startDefaultSession: () => void;
+    buddyActive: boolean;
+    buddyShape: BuddyShape;
     pauseTimeoutSeconds: number | null;
     usesHostAuth: boolean;
     authFailed: boolean;
@@ -158,5 +165,7 @@ export interface LiveAgentContextValue extends LiveAgentPublicValue {
     setIsDragging: (dragging: boolean) => void;
     chatActivityAt: number;
     reportChatActivity: () => void;
+    chatDraft: string;
+    setChatDraft: (text: string) => void;
 }
 export declare const LiveAgentContext: import("react").Context<LiveAgentContextValue | null>;

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

@@ -1,11 +1,11 @@
 import type { Module } from '../context/LiveAgentContext';
 interface UseAutoStartParams {
     availableModules: Module[];
-    isSessionLive: boolean;
+    suppressed: boolean;
     bearerToken: string | null;
     selectModule: (id: string, opts?: {
         autoStarted?: boolean;
     }) => void;
 }
-export declare function useAutoStart({ availableModules, isSessionLive, bearerToken, selectModule, }: UseAutoStartParams): void;
+export declare function useAutoStart({ availableModules, suppressed, bearerToken, selectModule, }: UseAutoStartParams): void;
 export {};

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

@@ -1,3 +1,35 @@
+export declare const BUDDY_SHAPE: {
+    readonly Bolt: "bolt";
+    readonly Term: "term";
+    readonly Bub: "bub";
+    readonly Hex: "hex";
+    readonly Peek: "peek";
+    readonly Bloom: "bloom";
+    readonly Wobble: "wobble";
+    readonly Splat: "splat";
+    readonly Cloud: "cloud";
+    readonly Boop: "boop";
+    readonly Boulder: "boulder";
+    readonly Kite: "kite";
+    readonly Loaf: "loaf";
+    readonly Facet: "facet";
+    readonly Bell: "bell";
+    readonly Totem: "totem";
+    readonly Melon: "melon";
+    readonly Sunny: "sunny";
+    readonly Storm: "storm";
+    readonly Reed: "reed";
+};
+export type BuddyShape = (typeof BUDDY_SHAPE)[keyof typeof BUDDY_SHAPE];
+export declare const DEFAULT_BUDDY_SHAPE: BuddyShape;
+export declare const BUDDY_MODE: {
+    readonly Idle: "idle";
+    readonly Happy: "happy";
+    readonly Sleep: "sleep";
+    readonly Talking: "talking";
+    readonly Listening: "listening";
+};
+export type BuddyMode = (typeof BUDDY_MODE)[keyof typeof BUDDY_MODE];
 export declare const SIDEBAR_WIDTH = 255;
 export declare const CAPTURE_MODE: {
     readonly Screenshare: "screenshare";

package/package.json

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