@skippr/live-agent-sdk 0.89.0 → 0.91.0

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

@@ -0,0 +1,10 @@
+interface FamilyFaceProps {
+    eyeDx: number;
+    eyeDy: number;
+    asleep: boolean;
+}
+export declare function ColorfulFace({ eyeDx, eyeDy, asleep, animated, }: FamilyFaceProps & {
+    animated?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function PixelFace({ eyeDx, eyeDy, asleep }: FamilyFaceProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -1,10 +1,18 @@
 import type { AgentControls, WidgetAppearance } from '../context/LiveAgentContext';
 export declare const SKIPPR_BUDDY_POS_KEY = "skippr_buddy_pos";
+export declare const SKIPPR_BUDDY_EDGE_KEY = "skippr_buddy_edge";
 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 type BuddyEdge = 'left' | 'right' | 'top' | 'bottom';
+export interface BuddyEdgePos {
+    edge: BuddyEdge;
+    top: number;
+    left: number;
+}
+export declare function isVerticalEdge(edge: BuddyEdge): boolean;
 export interface BuddyPos {
     x: number;
     y: number;
@@ -18,3 +26,12 @@ export declare function seedBuddyPosFromAppearance(position: 'left' | 'right' |
     innerWidth: number;
     innerHeight: number;
 }, sizePx?: number): BuddyPos;
+export declare function clampBuddyTop(top: number, sizePx?: number): number;
+export declare function clampBuddyLeft(left: number, sizePx?: number): number;
+export declare function nearestBuddyEdge(pointerX: number, pointerY: number): BuddyEdge;
+export declare function readSavedBuddyEdgePos(sizePx?: number): BuddyEdgePos | null;
+export declare function persistBuddyEdgePos(pos: BuddyEdgePos): void;
+export declare function seedBuddyEdgePosFromAppearance(position: 'left' | 'right' | null, verticalAlign: 'top' | 'middle' | 'bottom' | null, viewport: {
+    innerWidth: number;
+    innerHeight: number;
+}, sizePx?: number): BuddyEdgePos;

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

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

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

@@ -1,5 +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;
+export declare function PopBody(): import("react/jsx-runtime").JSX.Element;
+export declare function RoboBody(): import("react/jsx-runtime").JSX.Element;

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

@@ -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;

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

@@ -7,8 +7,8 @@ export declare const BUDDY_SHAPE: {
     readonly Bloom: "bloom";
     readonly Wobble: "wobble";
     readonly Splat: "splat";
-    readonly Cloud: "cloud";
-    readonly Boop: "boop";
+    readonly Pop: "pop";
+    readonly Robo: "robo";
     readonly Boulder: "boulder";
     readonly Kite: "kite";
     readonly Loaf: "loaf";
@@ -92,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.89.0",
+  "version": "0.91.0",
   "type": "module",
   "main": "dist/esm/lib-exports.js",
   "module": "dist/esm/lib-exports.js",