@skippr/live-agent-sdk 0.88.0 → 0.90.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/LinkCard.d.ts

@@ -0,0 +1,7 @@
+import type { LinkCardData } from '../hooks/useLinkCard';
+interface LinkCardProps {
+    card: LinkCardData;
+    onDismiss: () => void;
+}
+export declare function LinkCard({ card, onDismiss }: LinkCardProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -1,5 +1,5 @@
 import { type ReactNode } from 'react';
-import { type AgentControls } from '../context/LiveAgentContext';
+import { type AgentControls, type UserContext } from '../context/LiveAgentContext';
 import { CAPTURE_MODE } from '../lib/constants';
 import { type VerticalAlign } from '../lib/launcher';
 interface LiveAgentBaseProps {
@@ -8,6 +8,7 @@ interface LiveAgentBaseProps {
     appKey?: string | undefined;
     getUserToken?: (() => Promise<string>) | undefined;
     userToken?: string | undefined;
+    userContext?: UserContext | undefined;
     verticalAlign?: VerticalAlign | undefined;
     variant?: 'floating' | 'sidebar' | undefined;
     minimizable?: boolean | undefined;

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

@@ -1,3 +1,4 @@
+import type { LinkCardData } from '../hooks/useLinkCard';
 import { type PlanCardData } from '../hooks/usePlanUpdates';
 import type { Message } from '../types';
 interface MessageListProps {
@@ -6,8 +7,9 @@ interface MessageListProps {
     sendChatMessage?: (message: string) => Promise<unknown>;
     isSendingChat?: boolean;
     plan?: PlanCardData | null;
+    linkCard?: LinkCardData | null;
     autoFocus?: boolean;
     readOnly?: boolean;
 }
-export declare function MessageList({ messages, isStreaming, sendChatMessage, isSendingChat, plan, autoFocus, readOnly, }: MessageListProps): import("react/jsx-runtime").JSX.Element;
+export declare function MessageList({ messages, isStreaming, sendChatMessage, isSendingChat, plan, linkCard, autoFocus, readOnly, }: MessageListProps): import("react/jsx-runtime").JSX.Element;
 export {};

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/VoiceBarLinkCard.d.ts

@@ -0,0 +1,7 @@
+import type { LinkCardData } from '../hooks/useLinkCard';
+interface VoiceBarLinkCardProps {
+    card: LinkCardData;
+    onDismiss: () => void;
+}
+export declare function VoiceBarLinkCard({ card, onDismiss }: VoiceBarLinkCardProps): 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';
@@ -13,6 +13,7 @@ export interface AgentControls {
     micMode?: MicMode;
     chat?: ChatSurface;
 }
+export type UserContext = Record<string, string | number | boolean>;
 export interface UiPreferences {
     animateCursor?: boolean;
     autoStart?: boolean;
@@ -43,12 +44,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 +132,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 +166,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/hooks/useLinkCard.d.ts

@@ -0,0 +1,7 @@
+export interface LinkCardData {
+    cardId: string;
+    title: string;
+    url: string;
+}
+export declare function parseLinkCard(json: string): LinkCardData | null;
+export declare function useLinkCard(): LinkCardData | null;

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

@@ -1,4 +1,4 @@
-import type { AgentControls, CaptureMode } from '../context/LiveAgentContext';
+import type { AgentControls, CaptureMode, UserContext } from '../context/LiveAgentContext';
 import type { Message } from '../types';
 export type AuthedFetch = (input: string, init?: RequestInit) => Promise<Response>;
 interface LiveKitConnection {
@@ -11,6 +11,7 @@ interface UseSessionParams {
     appKey?: string | undefined;
     getUserToken?: (() => Promise<string>) | undefined;
     userToken?: string | undefined;
+    userContext?: UserContext | undefined;
     onStart?: () => void;
     onStartError?: () => void;
     onDisconnect?: () => void;
@@ -22,7 +23,7 @@ export interface StartSessionOptions {
     adoptionGoalId?: string | undefined;
     autoStarted?: boolean | undefined;
 }
-export declare function useSession({ captureMode, authToken, appKey, getUserToken, userToken, onStart, onStartError, onDisconnect, }: UseSessionParams): {
+export declare function useSession({ captureMode, authToken, appKey, getUserToken, userToken, userContext, onStart, onStartError, onDisconnect, }: UseSessionParams): {
     connection: LiveKitConnection | null;
     shouldConnect: boolean;
     isStarting: boolean;

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

@@ -0,0 +1 @@
+export declare function copyToClipboard(text: string): Promise<boolean>;

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";
@@ -60,4 +92,5 @@ export declare const NOTIFICATION_KIND: {
 };
 export type NotificationKind = (typeof NOTIFICATION_KIND)[keyof typeof NOTIFICATION_KIND];
 export declare const PLAN_ATTR = "skippr.action-plan";
+export declare const LINK_CARD_ATTR = "skippr.link-card";
 export declare const NAME_MAX_CHARS = 80;

package/dist/types/lib-exports.d.ts

@@ -1,5 +1,5 @@
 export * from './components/LiveAgent';
-export type { Module } from './context/LiveAgentContext';
+export type { Module, UserContext } from './context/LiveAgentContext';
 export * from './hooks/useAgentVoiceState';
 export * from './hooks/useElapsedSeconds';
 export * from './hooks/useIsLocalSpeaking';

package/package.json

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