@modelnex/sdk 0.5.50 → 0.5.52

package/dist/index.d.mts

@@ -477,13 +477,15 @@ interface ModelNexChatBubbleProps {
         borderRadius?: string;
         zIndex?: number;
     };
+    /** Whether to auto-start tours configured with auto_start policies based on user state */
+    enableAutoDiscovery?: boolean;
 }
 /**
  * Chat interface for natural language commands.
  * Shows conversation history; on exit, the agent summarizes what it did and suggests next steps.
  * Use within ModelNexProvider. Omit to use your own UI with useRunCommand.
  */
-declare function ModelNexChatBubble({ placeholder, defaultCommand, className, welcomeMessage, agentName, appName, theme, }: ModelNexChatBubbleProps): React$1.ReactPortal | null;
+declare function ModelNexChatBubble({ placeholder, defaultCommand, className, welcomeMessage, agentName, appName, theme, enableAutoDiscovery, }: ModelNexChatBubbleProps): React$1.ReactPortal | null;
 
 interface ModelNexOnboardingPanelProps {
     appName?: string;

package/dist/index.d.ts

@@ -477,13 +477,15 @@ interface ModelNexChatBubbleProps {
         borderRadius?: string;
         zIndex?: number;
     };
+    /** Whether to auto-start tours configured with auto_start policies based on user state */
+    enableAutoDiscovery?: boolean;
 }
 /**
  * Chat interface for natural language commands.
  * Shows conversation history; on exit, the agent summarizes what it did and suggests next steps.
  * Use within ModelNexProvider. Omit to use your own UI with useRunCommand.
  */
-declare function ModelNexChatBubble({ placeholder, defaultCommand, className, welcomeMessage, agentName, appName, theme, }: ModelNexChatBubbleProps): React$1.ReactPortal | null;
+declare function ModelNexChatBubble({ placeholder, defaultCommand, className, welcomeMessage, agentName, appName, theme, enableAutoDiscovery, }: ModelNexChatBubbleProps): React$1.ReactPortal | null;
 
 interface ModelNexOnboardingPanelProps {
     appName?: string;

package/dist/index.js

@@ -3881,16 +3881,17 @@ function compactTourForTransport(tour) {
 
 // src/utils/tourSessionPersistence.ts
 var ACTIVE_TOUR_SESSION_STORAGE_KEY = "modelnex-active-tour-session";
-var ACTIVE_TOUR_SESSION_VERSION = 1;
+var ACTIVE_TOUR_SESSION_VERSION = 2;
 var ACTIVE_TOUR_SESSION_MAX_AGE_MS = 10 * 60 * 1e3;
 function canUseSessionStorage2() {
   return typeof window !== "undefined" && typeof window.sessionStorage !== "undefined";
 }
-function persistActiveTourSession(runId) {
+function persistActiveTourSession(runId, experienceType) {
   if (!canUseSessionStorage2() || !Number.isFinite(runId)) return;
   const session = {
     version: ACTIVE_TOUR_SESSION_VERSION,
     runId,
+    experienceType,
     savedAt: Date.now()
   };
   try {
@@ -3911,7 +3912,7 @@ function readPersistedActiveTourSession() {
     const raw = window.sessionStorage.getItem(ACTIVE_TOUR_SESSION_STORAGE_KEY);
     if (!raw) return null;
     const parsed = JSON.parse(raw);
-    const isValid = parsed && parsed.version === ACTIVE_TOUR_SESSION_VERSION && typeof parsed.runId === "number" && Number.isFinite(parsed.runId) && typeof parsed.savedAt === "number" && Number.isFinite(parsed.savedAt);
+    const isValid = parsed && parsed.version === ACTIVE_TOUR_SESSION_VERSION && typeof parsed.runId === "number" && Number.isFinite(parsed.runId) && typeof parsed.experienceType === "string" && typeof parsed.savedAt === "number" && Number.isFinite(parsed.savedAt);
     if (!isValid) {
       clearPersistedActiveTourSession();
       return null;
@@ -4543,7 +4544,9 @@ function useTourPlayback({
   const pendingTourOptionsRef = (0, import_react12.useRef)(null);
   const showCaptionsRef = (0, import_react12.useRef)(showCaptions);
   const initialPersistedTourSessionRef = (0, import_react12.useRef)(readPersistedActiveTourSession());
-  const runIdRef = (0, import_react12.useRef)(initialPersistedTourSessionRef.current?.runId ?? null);
+  const runIdRef = (0, import_react12.useRef)(
+    initialPersistedTourSessionRef.current?.experienceType === experienceType ? initialPersistedTourSessionRef.current.runId : null
+  );
   const turnIdRef = (0, import_react12.useRef)(null);
   const startRequestedRef = (0, import_react12.useRef)(false);
   const serverStateRef = (0, import_react12.useRef)(null);
@@ -4574,7 +4577,8 @@ function useTourPlayback({
     claimedPlaybackOwnerKeyRef.current = null;
   }, []);
   const emitTourInit = (0, import_react12.useCallback)((socket, currentWebsiteId, profile) => {
-    const persistedRunId = runIdRef.current ?? readPersistedActiveTourSession()?.runId ?? null;
+    const persistedSession = readPersistedActiveTourSession();
+    const persistedRunId = runIdRef.current ?? (persistedSession?.experienceType === experienceTypeRef.current ? persistedSession.runId : null);
     const payload = {};
     if (currentWebsiteId) {
       payload.websiteId = currentWebsiteId;
@@ -4588,7 +4592,7 @@ function useTourPlayback({
     if (typeof persistedRunId === "number") {
       payload.resumeRunId = persistedRunId;
     }
-    if (!payload.resumeRunId && (!payload.websiteId || !payload.userType)) {
+    if (!payload.resumeRunId && (!payload.websiteId || !payload.userType && !payload.userId)) {
       return;
     }
     emitSocketEvent(socket, "tour:init", payload);
@@ -4615,7 +4619,7 @@ function useTourPlayback({
         turnIdRef.current = payload.turnId ?? null;
       }
       if (payload?.isActive && typeof payload?.runId === "number") {
-        persistActiveTourSession(payload.runId);
+        persistActiveTourSession(payload.runId, experienceTypeRef.current);
       } else if (payload?.isActive === false) {
         clearPersistedActiveTourSession();
       }
@@ -5250,7 +5254,7 @@ function useTourPlayback({
       if (isActiveRef.current) return;
       runIdRef.current = typeof tourData.runId === "number" ? tourData.runId : runIdRef.current;
       if (typeof runIdRef.current === "number") {
-        persistActiveTourSession(runIdRef.current);
+        persistActiveTourSession(runIdRef.current, experienceTypeRef.current);
       }
       const tour = tourData.tourContext ?? tourRef.current;
       const expType = experienceTypeRef.current;
@@ -5951,9 +5955,10 @@ function shouldDiscoverEligibleTours({
   isPreviewDiscoveryInFlight,
   isStartingExperience,
   hasUserProfile,
-  hasWebsiteId
+  hasWebsiteId,
+  enableAutoDiscovery
 }) {
-  return !disabled && !hasPendingPrompt && !hasPreviewSession && !isPlaybackActive && !isPreviewDiscoveryInFlight && !isStartingExperience && hasUserProfile && hasWebsiteId;
+  return enableAutoDiscovery && !disabled && !hasPendingPrompt && !hasPreviewSession && !isPlaybackActive && !isPreviewDiscoveryInFlight && !isStartingExperience && hasUserProfile && hasWebsiteId;
 }
 function useExperiencePlaybackController({
   serverUrl,
@@ -5969,7 +5974,8 @@ function useExperiencePlaybackController({
   onTourEnd,
   disabled = false,
   showCaptions = true,
-  initialExperienceType = "tour"
+  initialExperienceType = "tour",
+  enableAutoDiscovery = true
 }) {
   const locationSignature = typeof window === "undefined" ? "" : getLocationSignature(window.location);
   const [activeExperienceType, setActiveExperienceType] = (0, import_react13.useState)(initialExperienceType);
@@ -6177,8 +6183,10 @@ function useExperiencePlaybackController({
       isPreviewDiscoveryInFlight: previewDiscoveryInFlightRef.current,
       isStartingExperience: startingExperienceType !== null,
       hasUserProfile: Boolean(userProfile),
-      hasWebsiteId: Boolean(websiteId)
+      hasWebsiteId: Boolean(websiteId),
+      enableAutoDiscovery
     })) return;
+    if (!userProfile || !websiteId) return;
     let cancelled = false;
     const checkTours = async () => {
       const toursByExperience = await Promise.all(
@@ -10269,7 +10277,8 @@ function ModelNexChatBubble({
   welcomeMessage = "Hi! I can help you navigate and manage your documents. Try asking me to open a document, go to templates, or filter by status.",
   agentName = "ModelNex AI",
   appName = "this app",
-  theme
+  theme,
+  enableAutoDiscovery = true
 }) {
   const onCommand = void 0;
   const recordingExperienceType = "tour";
@@ -10342,7 +10351,8 @@ function ModelNexChatBubble({
     },
     showCaptions: !expanded,
     disabled: recordingMode || !hydrated,
-    initialExperienceType: recordingExperienceType
+    initialExperienceType: recordingExperienceType,
+    enableAutoDiscovery
   });
   const activePlayback = playbackController.playback;
   const activeExperienceType = playbackController.activeExperienceType;

package/dist/index.mjs

@@ -3056,16 +3056,17 @@ function compactTourForTransport(tour) {
 
 // src/utils/tourSessionPersistence.ts
 var ACTIVE_TOUR_SESSION_STORAGE_KEY = "modelnex-active-tour-session";
-var ACTIVE_TOUR_SESSION_VERSION = 1;
+var ACTIVE_TOUR_SESSION_VERSION = 2;
 var ACTIVE_TOUR_SESSION_MAX_AGE_MS = 10 * 60 * 1e3;
 function canUseSessionStorage2() {
   return typeof window !== "undefined" && typeof window.sessionStorage !== "undefined";
 }
-function persistActiveTourSession(runId) {
+function persistActiveTourSession(runId, experienceType) {
   if (!canUseSessionStorage2() || !Number.isFinite(runId)) return;
   const session = {
     version: ACTIVE_TOUR_SESSION_VERSION,
     runId,
+    experienceType,
     savedAt: Date.now()
   };
   try {
@@ -3086,7 +3087,7 @@ function readPersistedActiveTourSession() {
     const raw = window.sessionStorage.getItem(ACTIVE_TOUR_SESSION_STORAGE_KEY);
     if (!raw) return null;
     const parsed = JSON.parse(raw);
-    const isValid = parsed && parsed.version === ACTIVE_TOUR_SESSION_VERSION && typeof parsed.runId === "number" && Number.isFinite(parsed.runId) && typeof parsed.savedAt === "number" && Number.isFinite(parsed.savedAt);
+    const isValid = parsed && parsed.version === ACTIVE_TOUR_SESSION_VERSION && typeof parsed.runId === "number" && Number.isFinite(parsed.runId) && typeof parsed.experienceType === "string" && typeof parsed.savedAt === "number" && Number.isFinite(parsed.savedAt);
     if (!isValid) {
       clearPersistedActiveTourSession();
       return null;
@@ -3714,7 +3715,9 @@ function useTourPlayback({
   const pendingTourOptionsRef = useRef7(null);
   const showCaptionsRef = useRef7(showCaptions);
   const initialPersistedTourSessionRef = useRef7(readPersistedActiveTourSession());
-  const runIdRef = useRef7(initialPersistedTourSessionRef.current?.runId ?? null);
+  const runIdRef = useRef7(
+    initialPersistedTourSessionRef.current?.experienceType === experienceType ? initialPersistedTourSessionRef.current.runId : null
+  );
   const turnIdRef = useRef7(null);
   const startRequestedRef = useRef7(false);
   const serverStateRef = useRef7(null);
@@ -3745,7 +3748,8 @@ function useTourPlayback({
     claimedPlaybackOwnerKeyRef.current = null;
   }, []);
   const emitTourInit = useCallback6((socket, currentWebsiteId, profile) => {
-    const persistedRunId = runIdRef.current ?? readPersistedActiveTourSession()?.runId ?? null;
+    const persistedSession = readPersistedActiveTourSession();
+    const persistedRunId = runIdRef.current ?? (persistedSession?.experienceType === experienceTypeRef.current ? persistedSession.runId : null);
     const payload = {};
     if (currentWebsiteId) {
       payload.websiteId = currentWebsiteId;
@@ -3759,7 +3763,7 @@ function useTourPlayback({
     if (typeof persistedRunId === "number") {
       payload.resumeRunId = persistedRunId;
     }
-    if (!payload.resumeRunId && (!payload.websiteId || !payload.userType)) {
+    if (!payload.resumeRunId && (!payload.websiteId || !payload.userType && !payload.userId)) {
       return;
     }
     emitSocketEvent(socket, "tour:init", payload);
@@ -3786,7 +3790,7 @@ function useTourPlayback({
         turnIdRef.current = payload.turnId ?? null;
       }
       if (payload?.isActive && typeof payload?.runId === "number") {
-        persistActiveTourSession(payload.runId);
+        persistActiveTourSession(payload.runId, experienceTypeRef.current);
       } else if (payload?.isActive === false) {
         clearPersistedActiveTourSession();
       }
@@ -4421,7 +4425,7 @@ function useTourPlayback({
       if (isActiveRef.current) return;
       runIdRef.current = typeof tourData.runId === "number" ? tourData.runId : runIdRef.current;
       if (typeof runIdRef.current === "number") {
-        persistActiveTourSession(runIdRef.current);
+        persistActiveTourSession(runIdRef.current, experienceTypeRef.current);
       }
       const tour = tourData.tourContext ?? tourRef.current;
       const expType = experienceTypeRef.current;
@@ -5122,9 +5126,10 @@ function shouldDiscoverEligibleTours({
   isPreviewDiscoveryInFlight,
   isStartingExperience,
   hasUserProfile,
-  hasWebsiteId
+  hasWebsiteId,
+  enableAutoDiscovery
 }) {
-  return !disabled && !hasPendingPrompt && !hasPreviewSession && !isPlaybackActive && !isPreviewDiscoveryInFlight && !isStartingExperience && hasUserProfile && hasWebsiteId;
+  return enableAutoDiscovery && !disabled && !hasPendingPrompt && !hasPreviewSession && !isPlaybackActive && !isPreviewDiscoveryInFlight && !isStartingExperience && hasUserProfile && hasWebsiteId;
 }
 function useExperiencePlaybackController({
   serverUrl,
@@ -5140,7 +5145,8 @@ function useExperiencePlaybackController({
   onTourEnd,
   disabled = false,
   showCaptions = true,
-  initialExperienceType = "tour"
+  initialExperienceType = "tour",
+  enableAutoDiscovery = true
 }) {
   const locationSignature = typeof window === "undefined" ? "" : getLocationSignature(window.location);
   const [activeExperienceType, setActiveExperienceType] = useState7(initialExperienceType);
@@ -5348,8 +5354,10 @@ function useExperiencePlaybackController({
       isPreviewDiscoveryInFlight: previewDiscoveryInFlightRef.current,
       isStartingExperience: startingExperienceType !== null,
       hasUserProfile: Boolean(userProfile),
-      hasWebsiteId: Boolean(websiteId)
+      hasWebsiteId: Boolean(websiteId),
+      enableAutoDiscovery
     })) return;
+    if (!userProfile || !websiteId) return;
     let cancelled = false;
     const checkTours = async () => {
       const toursByExperience = await Promise.all(
@@ -9438,7 +9446,8 @@ function ModelNexChatBubble({
   welcomeMessage = "Hi! I can help you navigate and manage your documents. Try asking me to open a document, go to templates, or filter by status.",
   agentName = "ModelNex AI",
   appName = "this app",
-  theme
+  theme,
+  enableAutoDiscovery = true
 }) {
   const onCommand = void 0;
   const recordingExperienceType = "tour";
@@ -9511,7 +9520,8 @@ function ModelNexChatBubble({
     },
     showCaptions: !expanded,
     disabled: recordingMode || !hydrated,
-    initialExperienceType: recordingExperienceType
+    initialExperienceType: recordingExperienceType,
+    enableAutoDiscovery
   });
   const activePlayback = playbackController.playback;
   const activeExperienceType = playbackController.activeExperienceType;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelnex/sdk",
-  "version": "0.5.50",
+  "version": "0.5.52",
   "description": "React SDK for natural language control of web apps via AI agents",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",