@skippr/live-agent-sdk 0.35.0 → 0.36.0

package/dist/esm/lib-exports.js

@@ -8,7 +8,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 
 // src/components/LiveAgent.tsx
 import { LiveKitRoom, RoomAudioRenderer } from "@livekit/components-react";
-import { useCallback as useCallback8, useMemo as useMemo6, useRef as useRef10, useState as useState11 } from "react";
+import { useCallback as useCallback8, useMemo as useMemo5, useRef as useRef10, useState as useState11 } from "react";
 
 // src/context/LiveAgentContext.tsx
 import { createContext } from "react";
@@ -273,7 +273,6 @@ function useSession({
   const [pendingScreenStream, setPendingScreenStream] = useState3(null);
   const [isPaused, setIsPaused] = useState3(false);
   const [isPausing, setIsPausing] = useState3(false);
-  const [resumableSessions, setResumableSessions] = useState3([]);
   const [historyMessages, setHistoryMessages] = useState3([]);
   useEffect3(() => {
     let stale = false;
@@ -294,29 +293,6 @@ function useSession({
       stale = true;
     };
   }, [authToken, appKey, userToken]);
-  const refetchResumable = useCallback3(async () => {
-    if (!bearerToken) {
-      setResumableSessions([]);
-      return;
-    }
-    try {
-      const resp = await fetch(`${API_URL3}/v1/sessions/resumable`, {
-        credentials: "omit",
-        headers: { Authorization: `Bearer ${bearerToken}` }
-      });
-      if (!resp.ok) {
-        setResumableSessions([]);
-        return;
-      }
-      const { sessions } = await resp.json();
-      setResumableSessions(sessions);
-    } catch {
-      setResumableSessions([]);
-    }
-  }, [bearerToken]);
-  useEffect3(() => {
-    refetchResumable();
-  }, [refetchResumable]);
   const pauseOnUnloadRef = useRef(null);
   pauseOnUnloadRef.current = connection !== null && !isPaused && sessionId && bearerToken ? { sessionId, bearerToken } : null;
   useEffect3(() => {
@@ -334,12 +310,12 @@ function useSession({
     window.addEventListener("pagehide", onPageHide);
     return () => window.removeEventListener("pagehide", onPageHide);
   }, []);
-  const startSession = useCallback3(async ({ agentId, agentControls }) => {
+  const startSession = useCallback3(async ({ agentId, agentControls, existingSessionId }) => {
     if (!bearerToken) {
       setError("No auth token available");
       return;
     }
-    if (!agentId) {
+    if (!agentId && !existingSessionId) {
       setError("No agent selected");
       return;
     }
@@ -354,35 +330,41 @@ function useSession({
     const requestAgentControls = agentControls?.highlight === true ? { highlight: true } : undefined;
     const headers = { Authorization: `Bearer ${bearerToken}` };
     try {
-      const createResp = await fetch(`${API_URL3}/v1/sessions`, {
-        method: "POST",
-        credentials: "omit",
-        headers: { "Content-Type": "application/json", ...headers },
-        body: JSON.stringify({
-          agentId,
-          captureMode,
-          agentControls: requestAgentControls
-        })
-      });
-      if (!createResp.ok) {
-        const body = await createResp.json().catch(() => null);
-        setErrorCode(createResp.status);
-        throw new Error(body?.detail || `Failed to create session: ${createResp.status}`);
+      let resolvedSessionId = existingSessionId;
+      if (!resolvedSessionId) {
+        const createResp = await fetch(`${API_URL3}/v1/sessions`, {
+          method: "POST",
+          credentials: "omit",
+          headers: { "Content-Type": "application/json", ...headers },
+          body: JSON.stringify({
+            agentId,
+            captureMode,
+            agentControls: requestAgentControls
+          })
+        });
+        if (!createResp.ok) {
+          const body = await createResp.json().catch(() => null);
+          setErrorCode(createResp.status);
+          throw new Error(body?.detail || `Failed to create session: ${createResp.status}`);
+        }
+        const { session: session2 } = await createResp.json();
+        resolvedSessionId = session2.id;
       }
-      const { session } = await createResp.json();
-      const startResp = await fetch(`${API_URL3}/v1/sessions/${session.id}/start`, {
+      const startResp = await fetch(`${API_URL3}/v1/sessions/${resolvedSessionId}/start`, {
         method: "POST",
         credentials: "omit",
-        headers
+        headers: { "Content-Type": "application/json", ...headers },
+        body: JSON.stringify({ captureMode, agentControls: requestAgentControls })
       });
       if (!startResp.ok) {
         const body = await startResp.json().catch(() => null);
         setErrorCode(startResp.status);
         throw new Error(body?.detail || `Failed to start session: ${startResp.status}`);
       }
-      const { connection: conn } = await startResp.json();
+      const { session, connection: conn } = await startResp.json();
+      const history2 = existingSessionId ? await fetchSessionMessages(session.id, bearerToken) : [];
       setSessionId(session.id);
-      setHistoryMessages([]);
+      setHistoryMessages(history2);
       setConnection({
         livekitUrl: conn.livekitUrl,
         token: conn.token
@@ -425,64 +407,16 @@ function useSession({
     setHistoryMessages(history2);
     setIsPaused(true);
     setIsPausing(false);
-    await refetchResumable();
-  }, [sessionId, bearerToken, pendingScreenStream, refetchResumable]);
-  const resumeSession = useCallback3(async ({
-    sessionId: resumeId,
-    agentControls
-  }) => {
-    if (!bearerToken) {
-      setError("No auth token available");
-      return;
-    }
-    setIsStarting(true);
-    setError("");
-    setErrorCode(null);
-    onStart?.();
-    let screenStream = null;
-    if (captureMode === "screenshare") {
-      screenStream = await requestScreenShare();
-    }
-    const requestAgentControls = agentControls?.highlight === true ? { highlight: true } : undefined;
-    try {
-      const resp = await fetch(`${API_URL3}/v1/sessions/${resumeId}/resume`, {
-        method: "POST",
-        credentials: "omit",
-        headers: { "Content-Type": "application/json", Authorization: `Bearer ${bearerToken}` },
-        body: JSON.stringify({ captureMode, agentControls: requestAgentControls })
-      });
-      if (!resp.ok) {
-        const body = await resp.json().catch(() => null);
-        setErrorCode(resp.status);
-        throw new Error(body?.detail || `Failed to resume: ${resp.status}`);
-      }
-      const { session, connection: conn } = await resp.json();
-      const history2 = await fetchSessionMessages(session.id, bearerToken);
-      setSessionId(session.id);
-      setConnection({ livekitUrl: conn.livekitUrl, token: conn.token });
-      setPendingScreenStream(screenStream);
-      setHistoryMessages(history2);
-      setShouldConnect(true);
-      setIsPaused(false);
-      setResumableSessions((prev) => prev.filter((s) => s.id !== resumeId));
-    } catch (e) {
-      stopStream(screenStream);
-      setError(e instanceof Error ? e.message : "Failed to resume session");
-      onStartError?.();
-    } finally {
-      setIsStarting(false);
-    }
-  }, [captureMode, bearerToken, onStart, onStartError]);
+  }, [sessionId, bearerToken, pendingScreenStream]);
   const disconnect = useCallback3(async () => {
     setIsDisconnecting(true);
     try {
       if (sessionId && bearerToken) {
         try {
-          await fetch(`${API_URL3}/v1/sessions/${sessionId}/complete`, {
+          await fetch(`${API_URL3}/v1/sessions/${sessionId}/pause`, {
             method: "POST",
             credentials: "omit",
-            headers: { "Content-Type": "application/json", Authorization: `Bearer ${bearerToken}` },
-            body: JSON.stringify({})
+            headers: { Authorization: `Bearer ${bearerToken}` }
           });
         } catch {}
       }
@@ -495,11 +429,10 @@ function useSession({
       setHistoryMessages([]);
       setIsPaused(false);
       onDisconnect?.();
-      await refetchResumable();
     } finally {
       setIsDisconnecting(false);
     }
-  }, [sessionId, bearerToken, pendingScreenStream, onDisconnect, refetchResumable]);
+  }, [sessionId, bearerToken, pendingScreenStream, onDisconnect]);
   return {
     connection,
     shouldConnect,
@@ -509,13 +442,10 @@ function useSession({
     errorCode,
     startSession,
     pauseSession,
-    resumeSession,
     disconnect,
     isPaused,
     isPausing,
-    resumableSessions,
     historyMessages,
-    refetchResumable,
     pendingScreenStream,
     bearerToken
   };
@@ -531,6 +461,27 @@ var DOM_EVENTS_TOPIC = "skippr.dom-events";
 var HIGHLIGHT_TOPIC = "skippr.highlight";
 var NAME_MAX_CHARS = 80;
 
+// src/lib/session.ts
+function getResumableSessionId(currentSession, mode) {
+  if (!currentSession)
+    return;
+  const { id, status } = currentSession;
+  if (status === "paused" || status === "active")
+    return id;
+  if (status === "expired" && mode === "always_on")
+    return id;
+  return;
+}
+function canResumeSession(currentSession, mode) {
+  return getResumableSessionId(currentSession, mode) !== undefined;
+}
+function getResumableSession(module) {
+  if (!module)
+    return null;
+  const id = getResumableSessionId(module.currentSession, module.mode);
+  return id ? { id, agentId: module.id } : null;
+}
+
 // src/components/AutoStartMedia.tsx
 import { useConnectionState, useLocalParticipant } from "@livekit/components-react/hooks";
 import { ConnectionState, Track } from "livekit-client";
@@ -3279,7 +3230,7 @@ function MessageList({
 }
 
 // src/components/ModuleSelector.tsx
-import { useEffect as useEffect15, useMemo as useMemo5, useRef as useRef9, useState as useState10 } from "react";
+import { useEffect as useEffect15, useRef as useRef9, useState as useState10 } from "react";
 import { jsx as jsx14, jsxs as jsxs13 } from "react/jsx-runtime";
 var AGENT_TYPE_ICONS = {
   onboarding: UserPlus,
@@ -3299,11 +3250,9 @@ function ModuleSelector() {
     selectModule,
     isStarting,
     isDisconnecting,
-    error,
-    resumableSessions
+    error
   } = useLiveAgent();
   const isBusy = isStarting || isDisconnecting;
-  const resumableAgentIds = useMemo5(() => new Set(resumableSessions.map((s) => s.agentId)), [resumableSessions]);
   const scrollRef = useRef9(null);
   const [showScrollHint, setShowScrollHint] = useState10(false);
   const [isScrolled, setIsScrolled] = useState10(false);
@@ -3391,7 +3340,7 @@ function ModuleSelector() {
                   const isFeatured = index2 === 0;
                   const isWide = index2 === availableModules.length - 1 && availableModules.length % 2 === 1;
                   const Icon2 = getAgentIcon(module.type);
-                  const canResume = resumableAgentIds.has(module.id);
+                  const canResume = canResumeSession(module.currentSession, module.mode);
                   const base = "skippr:group skippr:flex skippr:cursor-pointer skippr:gap-3 skippr:rounded-xl skippr:text-left skippr:transition-colors skippr:disabled:cursor-not-allowed skippr:disabled:opacity-50";
                   const layout = isWide ? "skippr:items-center skippr:p-3.5 skippr:pb-5" : "skippr:flex-col skippr:items-start skippr:p-3.5";
                   const variant = isFeatured ? "skippr:bg-primary skippr:text-primary-foreground skippr:hover:bg-primary/90" : "skippr:bg-background skippr:ring-1 skippr:ring-foreground/10 skippr:hover:bg-muted/50";
@@ -3597,8 +3546,10 @@ function Sidebar({
     captureMode,
     hasModuleSelector,
     agentId,
+    agentMode,
     agentControls
   } = useLiveAgent();
+  const showAgenda = agentMode !== "always_on";
   const isFloating = variant === "floating";
   const isSidebar = variant === "sidebar";
   useEffect16(() => {
@@ -3650,7 +3601,8 @@ function Sidebar({
         showScreenShareToggle: captureMode === "screenshare",
         hasModuleSelector,
         agentId,
-        agentControls
+        agentControls,
+        showAgenda
       })
     ]
   });
@@ -3675,11 +3627,13 @@ function AuthenticatedContent({
   showScreenShareToggle,
   hasModuleSelector,
   agentId,
-  agentControls
+  agentControls,
+  showAgenda
 }) {
   const inSession = isConnected || isStarting || isPaused || isPausing;
   const showSelectorAsPrompt = hasModuleSelector && !inSession && !isDisconnecting;
   const showTabBar = !showSelectorAsPrompt;
+  const effectiveTab = showAgenda ? activeTab : "chat";
   let transitionLabel = null;
   if (isPausing) {
     transitionLabel = "Pausing...";
@@ -3708,7 +3662,7 @@ function AuthenticatedContent({
               })
             ]
           }),
-          /* @__PURE__ */ jsxs16("button", {
+          showAgenda && /* @__PURE__ */ jsxs16("button", {
             type: "button",
             className: cn("skippr:relative skippr:inline-flex skippr:cursor-pointer skippr:items-center skippr:gap-1.5 skippr:rounded-lg skippr:px-3 skippr:py-2 skippr:text-sm skippr:font-medium skippr:transition-all", activeTab === "agenda" ? "skippr:text-foreground" : "skippr:text-muted-foreground skippr:hover:text-foreground"),
             onClick: () => onTabChange("agenda"),
@@ -3738,7 +3692,7 @@ function AuthenticatedContent({
               children: transitionLabel
             }),
             /* @__PURE__ */ jsx18(ConnectedBody, {
-              activeTab,
+              activeTab: effectiveTab,
               autoFocusChat
             })
           ]
@@ -3884,10 +3838,8 @@ function LiveAgent(props) {
     errorCode,
     startSession,
     pauseSession,
-    resumeSession: resumeSessionById,
     disconnect,
     isPaused,
-    resumableSessions,
     historyMessages,
     pendingScreenStream,
     bearerToken
@@ -3907,12 +3859,6 @@ function LiveAgent(props) {
       return;
     disconnect();
   }, [disconnect]);
-  const resumableSession = resumableSessions.find((s) => s.agentId === agentId) ?? null;
-  const resumeSession = useCallback8(async () => {
-    if (!resumableSession)
-      return;
-    await resumeSessionById({ sessionId: resumableSession.id, agentControls });
-  }, [resumableSession, resumeSessionById, agentControls]);
   const [isPanelOpen, setIsPanelOpen] = useState11(defaultOpen);
   const [isMinimized, setIsMinimized] = useState11(minimizable && !defaultOpen);
   const [sidebarTab, setSidebarTab] = useState11("agenda");
@@ -3926,18 +3872,35 @@ function LiveAgent(props) {
     enabled: hasModuleSelector && isPanelOpen,
     bearerToken
   });
+  const activeModuleForAgent = useMemo5(() => {
+    if (activeModule)
+      return activeModule;
+    if (!hostAgentId)
+      return null;
+    return availableModules.find((m) => m.id === hostAgentId) ?? null;
+  }, [activeModule, hostAgentId, availableModules]);
+  const agentMode = activeModuleForAgent?.mode ?? null;
+  const resumableSession = useMemo5(() => getResumableSession(activeModuleForAgent), [activeModuleForAgent]);
+  const resumeSession = useCallback8(async () => {
+    if (!resumableSession)
+      return;
+    await startSession({
+      agentId: resumableSession.agentId,
+      agentControls,
+      existingSessionId: resumableSession.id
+    });
+  }, [resumableSession, startSession, agentControls]);
   const selectModule = useCallback8((moduleId) => {
     const found = availableModules.find((m) => m.id === moduleId);
     if (!found)
       return;
     setActiveModule(found);
-    const resumable = resumableSessions.find((s) => s.agentId === found.id);
-    if (resumable) {
-      resumeSessionById({ sessionId: resumable.id, agentControls: found.controls });
-    } else {
-      startSession({ agentId: found.id, agentControls: found.controls });
-    }
-  }, [availableModules, resumableSessions, startSession, resumeSessionById]);
+    startSession({
+      agentId: found.id,
+      agentControls: found.controls,
+      existingSessionId: getResumableSessionId(found.currentSession, found.mode)
+    });
+  }, [availableModules, startSession]);
   const [welcomeDismissed, setWelcomeDismissed] = useState11(false);
   const dismissWelcome = useCallback8(() => setWelcomeDismissed(true), []);
   const [currentPosition, setCurrentPosition] = useState11(() => {
@@ -3969,7 +3932,7 @@ function LiveAgent(props) {
   }, [minimizable]);
   const isConnected = connection !== null;
   const isAuthenticated = !!userToken || !!authTokenProp || auth.isAuthenticated;
-  const ctx = useMemo6(() => ({
+  const ctx = useMemo5(() => ({
     connection,
     shouldConnect,
     isConnected,
@@ -3984,7 +3947,6 @@ function LiveAgent(props) {
     disconnect,
     isPaused,
     resumableSession,
-    resumableSessions,
     historyMessages,
     phasesSnapshot,
     setPhasesSnapshot,
@@ -4011,6 +3973,7 @@ function LiveAgent(props) {
     autoFocusChat,
     captureMode,
     agentId,
+    agentMode,
     agentControls,
     hasModuleSelector,
     availableModules,
@@ -4034,7 +3997,6 @@ function LiveAgent(props) {
     disconnect,
     isPaused,
     resumableSession,
-    resumableSessions,
     historyMessages,
     phasesSnapshot,
     isPanelOpen,
@@ -4059,6 +4021,7 @@ function LiveAgent(props) {
     autoFocusChat,
     captureMode,
     agentId,
+    agentMode,
     agentControls,
     hasModuleSelector,
     availableModules,