@skippr/live-agent-sdk 0.66.0 → 0.67.0

package/README.md

@@ -217,7 +217,6 @@ Self-contained widget component. Renders a floating button that opens a sidebar
 | `startSessionLabel` | `string` | `'Talk to Skippr'` | Label for the start-session button (only shown when `agentId` is pinned) |
 | `autoFocusChat` | `boolean` | `true` | Whether the chat input auto-focuses when opened |
 | `captureMode` | `'screenshare' \| 'auto'` | `'screenshare'` | How the agent sees the page — `'screenshare'` prompts the user to share, `'auto'` uses DOM capture (no permission prompt) |
-| `agentControls` | `{ highlight?: boolean; actions?: boolean }` | — | Opt-in agent capabilities — `highlight` (element highlighting) and `actions` (on-screen actions). **Requires `captureMode: 'auto'`** and only applies when `agentId` is pinned. In picker mode, controls are configured per module in the dashboard. |
 | `animateAgentCursor` | `boolean` | `false` | Animate the agent's cursor as it points to elements on the page. Primarily configured per agent in the dashboard; this prop is a fallback when the agent has no preference set. |
 
 ### `useLiveAgent()`
@@ -298,7 +297,7 @@ Available on `window.Skippr` when using the script tag bundle.
 
 | Method | Description |
 |--------|-------------|
-| `Skippr.initialize(config)` | Mount the widget. Accepts `appKey` (required), `agentId` (optional — omit for picker), `getUserToken`, `userToken`, `position`, `variant`, `minimizable`, `captureMode`, `agentControls`. |
+| `Skippr.initialize(config)` | Mount the widget. Accepts `appKey` (required), `agentId` (optional — omit for picker), `getUserToken`, `userToken`, `position`, `variant`, `minimizable`, `captureMode`. |
 | `Skippr.logout()` | Revoke the current session server-side, clear stored auth tokens, and show the login form (direct auth mode) |
 | `Skippr.destroy()` | Remove the widget from the page and clear auth tokens |
 

package/dist/esm/lib-exports.js

@@ -3063,9 +3063,8 @@ function MinimizedBubble({
     popsDown,
     adoptionGoals,
     startAdoptionSession,
-    hasModuleSelector,
     isAuthenticated,
-    availableModules,
+    displayModules,
     hasResolvedModules,
     selectModule,
     expandPanel,
@@ -3091,15 +3090,15 @@ function MinimizedBubble({
     };
   }, []);
   const { wasDraggedRef } = useLauncherDrag(hoverContainerRef, commitLauncherDrop);
-  const actionableModules = hasModuleSelector ? availableModules.filter((module) => {
+  const actionableModules = displayModules.filter((module) => {
     const state = getModuleSessionState(module.currentSession, module.mode);
     return state !== "completed" && state !== "expired";
-  }) : [];
+  });
   const alwaysOnModule = actionableModules.find((module) => module.mode === AGENT_MODE.AlwaysOn);
   const pillCandidates = actionableModules.filter((module) => module.mode !== AGENT_MODE.AlwaysOn);
   const onboardingModule = pillCandidates.find((module) => module.type === "onboarding");
   const modulePills = onboardingModule ? [onboardingModule] : pillCandidates.slice(0, MAX_MODULE_PILLS).reverse();
-  const goalsEligible = adoptionGoals.length > 0 && !onboardingModule && (!hasModuleSelector || hasResolvedModules);
+  const goalsEligible = adoptionGoals.length > 0 && !onboardingModule && hasResolvedModules;
   useEffect12(() => {
     if (!goalsEligible)
       return;
@@ -3128,13 +3127,12 @@ function MinimizedBubble({
   const launchDefaultSession = () => {
     if (wasDraggedRef.current || isStarting)
       return;
-    if (!hasModuleSelector || !isAuthenticated) {
+    const target = isAuthenticated ? alwaysOnModule ?? onboardingModule ?? pillCandidates[0] : null;
+    if (target) {
+      selectModule(target.id);
+    } else {
       expandPanel();
-      return;
     }
-    const target = alwaysOnModule ?? onboardingModule ?? pillCandidates[0];
-    if (target)
-      selectModule(target.id);
   };
   return /* @__PURE__ */ jsxs4("div", {
     ref: hoverContainerRef,
@@ -5453,10 +5451,7 @@ function LiveAgent(props) {
   const auth = useAuth({ appKey });
   const usesHostAuth = !!getUserToken || !!userToken || !!authTokenProp;
   const effectiveAuthToken = usesHostAuth ? authTokenProp : auth.authToken ?? undefined;
-  const hasModuleSelector = !hostAgentId;
   const [activeModule, setActiveModule] = useState17(null);
-  const agentId = hasModuleSelector ? activeModule?.id ?? null : hostAgentId;
-  const agentControls = hasModuleSelector ? activeModule?.controls : hostAgentControls;
   const minimizeOnSessionStart = useCallback14(() => {
     if (minimizable) {
       setIsMinimized(true);
@@ -5468,14 +5463,12 @@ function LiveAgent(props) {
     setIsPanelOpen(true);
   }, []);
   const minimizeOnSessionDisconnect = useCallback14(() => {
-    if (hasModuleSelector) {
-      setActiveModule(null);
-    }
+    setActiveModule(null);
     if (minimizable) {
       setIsMinimized(true);
       setIsPanelOpen(false);
     }
-  }, [minimizable, hasModuleSelector]);
+  }, [minimizable]);
   const {
     connection,
     shouldConnect,
@@ -5546,16 +5539,13 @@ function LiveAgent(props) {
     bearerToken,
     authedFetch
   });
-  const activeModuleForAgent = useMemo6(() => {
-    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 shouldAnimateCursor = activeModuleForAgent?.uiPreferences?.animateCursor ?? animateAgentCursor;
-  const resumableSession = useMemo6(() => getResumableSession(activeModuleForAgent), [activeModuleForAgent]);
+  const displayModules = useMemo6(() => hostAgentId ? availableModules.filter((m) => m.id === hostAgentId) : availableModules, [hostAgentId, availableModules]);
+  const operatingModule = activeModule ?? (hostAgentId ? displayModules[0] ?? null : null);
+  const agentId = operatingModule?.id ?? null;
+  const agentControls = operatingModule?.controls ?? hostAgentControls;
+  const agentMode = operatingModule?.mode ?? null;
+  const shouldAnimateCursor = operatingModule?.uiPreferences?.animateCursor ?? animateAgentCursor;
+  const resumableSession = useMemo6(() => getResumableSession(operatingModule), [operatingModule]);
   const resumeSession = useCallback14(async () => {
     if (!resumableSession)
       return;
@@ -5708,8 +5698,7 @@ function LiveAgent(props) {
     agentId,
     agentMode,
     agentControls,
-    hasModuleSelector,
-    availableModules,
+    displayModules,
     activeModule,
     isLoadingModules,
     modulesError,
@@ -5769,8 +5758,7 @@ function LiveAgent(props) {
     agentId,
     agentMode,
     agentControls,
-    hasModuleSelector,
-    availableModules,
+    displayModules,
     activeModule,
     isLoadingModules,
     modulesError,