@modelnex/sdk 0.5.18 → 0.5.19

package/dist/index.js

@@ -2719,6 +2719,7 @@ function createTourSocketPool({
 var tourSocketPool = createTourSocketPool();
 
 // src/utils/tour-playback-guards.ts
+var playbackOwners = /* @__PURE__ */ new Map();
 function shouldExecuteTourCommandBatch(isPlaybackActive) {
   return isPlaybackActive;
 }
@@ -2742,6 +2743,25 @@ function shouldLogTourDebugEntry(state) {
   }
   return true;
 }
+function createTourPlaybackOwnerKey(serverUrl, websiteId, experienceType) {
+  return `${serverUrl}::${websiteId || "__default__"}::${experienceType}`;
+}
+function claimTourPlaybackOwnership(key, ownerId) {
+  const currentOwner = playbackOwners.get(key);
+  if (currentOwner && currentOwner !== ownerId) {
+    return false;
+  }
+  playbackOwners.set(key, ownerId);
+  return true;
+}
+function hasTourPlaybackOwnership(key, ownerId) {
+  return playbackOwners.get(key) === ownerId;
+}
+function releaseTourPlaybackOwnership(key, ownerId) {
+  if (playbackOwners.get(key) === ownerId) {
+    playbackOwners.delete(key);
+  }
+}
 
 // src/hooks/useTourPlayback.ts
 function resolveElement(step) {
@@ -3277,6 +3297,8 @@ function useTourPlayback({
   const runIdRef = (0, import_react12.useRef)(null);
   const turnIdRef = (0, import_react12.useRef)(null);
   const startRequestedRef = (0, import_react12.useRef)(false);
+  const playbackOwnerIdRef = (0, import_react12.useRef)(`playback-owner-${Math.random().toString(36).slice(2, 10)}`);
+  const claimedPlaybackOwnerKeyRef = (0, import_react12.useRef)(null);
   const socketRef = (0, import_react12.useRef)(null);
   const socketIdRef = (0, import_react12.useRef)(socketId);
   const commandUrlRef = (0, import_react12.useRef)(commandUrl);
@@ -3294,6 +3316,12 @@ function useTourPlayback({
   toursApiBaseRef.current = toursApiBase;
   pendingTourRef.current = pendingTour;
   showCaptionsRef.current = showCaptions;
+  const releasePlaybackOwnership = (0, import_react12.useCallback)(() => {
+    const claimedKey = claimedPlaybackOwnerKeyRef.current;
+    if (!claimedKey) return;
+    releaseTourPlaybackOwnership(claimedKey, playbackOwnerIdRef.current);
+    claimedPlaybackOwnerKeyRef.current = null;
+  }, []);
   (0, import_react12.useEffect)(() => {
     if (disabled) return;
     if (typeof window === "undefined") return;
@@ -3329,7 +3357,8 @@ function useTourPlayback({
       }
     };
     const handleCommand = async (payload) => {
-      if (!shouldExecuteTourCommandBatch(isActiveRef.current)) {
+      const ownerKey = createTourPlaybackOwnerKey(serverUrl, websiteIdRef.current, experienceTypeRef.current);
+      if (!shouldExecuteTourCommandBatch(isActiveRef.current) || !hasTourPlaybackOwnership(ownerKey, playbackOwnerIdRef.current)) {
         const activeType = experienceTypeRef.current;
         console.log("[TourClient] Ignoring command batch for inactive playback hook:", activeType, payload.stepIndex);
         return;
@@ -3839,6 +3868,12 @@ function useTourPlayback({
         console.log(`[TourClient] Ignoring ${tour.type} start (this hook is for ${expType})`);
         return;
       }
+      const ownerKey = createTourPlaybackOwnerKey(serverUrl, websiteIdRef.current, expType);
+      if (!claimTourPlaybackOwnership(ownerKey, playbackOwnerIdRef.current)) {
+        console.log(`[TourClient] Ignoring ${expType} start because another hook already owns playback`);
+        return;
+      }
+      claimedPlaybackOwnerKeyRef.current = ownerKey;
       skipRequestedRef.current = false;
       startRequestedRef.current = false;
       const total = tourData.totalSteps ?? tour?.steps?.length ?? 0;
@@ -3900,12 +3935,13 @@ function useTourPlayback({
     const handleDebugLog = (entry) => {
       const isDev = devModeRef.current || process.env.NODE_ENV === "development" || typeof window !== "undefined" && window.MODELNEX_DEBUG;
       const entryTourType = entry?.data?.tourContext?.type ?? tourRef.current?.type ?? null;
+      const ownerKey = createTourPlaybackOwnerKey(serverUrl, websiteIdRef.current, experienceTypeRef.current);
       if (!shouldLogTourDebugEntry({
         isPlaybackActive: isActiveRef.current,
         entryType: entry?.type,
         entryTourType,
         experienceType: experienceTypeRef.current
-      })) {
+      }) || isActiveRef.current && !hasTourPlaybackOwnership(ownerKey, playbackOwnerIdRef.current)) {
         return;
       }
       if (isDev) {
@@ -3940,9 +3976,10 @@ function useTourPlayback({
       setServerState(null);
       runIdRef.current = null;
       turnIdRef.current = null;
+      releasePlaybackOwnership();
       tourSocketPool.release(serverUrl, toClose);
     };
-  }, [serverUrl, disabled]);
+  }, [serverUrl, disabled, releasePlaybackOwnership]);
   (0, import_react12.useEffect)(() => {
     if (disabled) return;
     const s = socketRef.current;
@@ -4014,6 +4051,7 @@ function useTourPlayback({
     skipRequestedRef.current = true;
     isActiveRef.current = false;
     startRequestedRef.current = false;
+    releasePlaybackOwnership();
     activeExecutionTokenRef.current += 1;
     commandInFlightRef.current = false;
     activeCommandBatchIdRef.current = null;
@@ -4049,13 +4087,14 @@ function useTourPlayback({
     setIsReviewMode(false);
     pendingInputBufRef.current = null;
     onTourEnd?.();
-  }, [voice, onTourEnd, serverUrl, websiteId]);
+  }, [voice, onTourEnd, serverUrl, websiteId, releasePlaybackOwnership]);
   const handleTourEnd = (0, import_react12.useCallback)(() => {
     const endingTourId = tourRef.current?.id;
     const endingPreviewRunId = previewRunIdRef.current;
     const endingStepOrder = stepIndexRef.current;
     isActiveRef.current = false;
     startRequestedRef.current = false;
+    releasePlaybackOwnership();
     setPlaybackState("complete");
     removeHighlight();
     removeCaption();
@@ -4087,7 +4126,7 @@ function useTourPlayback({
       clearActiveDraftPreview(experienceType);
     }
     onTourEnd?.();
-  }, [experienceType, userProfile, serverUrl, voice, onTourEnd, websiteId]);
+  }, [experienceType, userProfile, serverUrl, voice, onTourEnd, websiteId, releasePlaybackOwnership]);
   const runTour = (0, import_react12.useCallback)(async (tour, options) => {
     if (!shouldAcceptTourStart({
       isPlaybackActive: isActiveRef.current,
@@ -4107,6 +4146,12 @@ function useTourPlayback({
       console.warn("[TourClient] Cannot run tour, socket not connected.");
       return;
     }
+    const ownerKey = createTourPlaybackOwnerKey(serverUrl, websiteIdRef.current, tour.type ?? experienceTypeRef.current);
+    if (!claimTourPlaybackOwnership(ownerKey, playbackOwnerIdRef.current)) {
+      console.log("[TourClient] Ignoring duplicate start request because another hook already owns this experience:", tour.id);
+      return;
+    }
+    claimedPlaybackOwnerKeyRef.current = ownerKey;
     startRequestedRef.current = true;
     const shouldReview = Boolean(options?.reviewMode);
     resetCaptionSuppression();

package/dist/index.mjs

@@ -2509,6 +2509,7 @@ function createTourSocketPool({
 var tourSocketPool = createTourSocketPool();
 
 // src/utils/tour-playback-guards.ts
+var playbackOwners = /* @__PURE__ */ new Map();
 function shouldExecuteTourCommandBatch(isPlaybackActive) {
   return isPlaybackActive;
 }
@@ -2532,6 +2533,25 @@ function shouldLogTourDebugEntry(state) {
   }
   return true;
 }
+function createTourPlaybackOwnerKey(serverUrl, websiteId, experienceType) {
+  return `${serverUrl}::${websiteId || "__default__"}::${experienceType}`;
+}
+function claimTourPlaybackOwnership(key, ownerId) {
+  const currentOwner = playbackOwners.get(key);
+  if (currentOwner && currentOwner !== ownerId) {
+    return false;
+  }
+  playbackOwners.set(key, ownerId);
+  return true;
+}
+function hasTourPlaybackOwnership(key, ownerId) {
+  return playbackOwners.get(key) === ownerId;
+}
+function releaseTourPlaybackOwnership(key, ownerId) {
+  if (playbackOwners.get(key) === ownerId) {
+    playbackOwners.delete(key);
+  }
+}
 
 // src/hooks/useTourPlayback.ts
 function resolveElement(step) {
@@ -3067,6 +3087,8 @@ function useTourPlayback({
   const runIdRef = useRef8(null);
   const turnIdRef = useRef8(null);
   const startRequestedRef = useRef8(false);
+  const playbackOwnerIdRef = useRef8(`playback-owner-${Math.random().toString(36).slice(2, 10)}`);
+  const claimedPlaybackOwnerKeyRef = useRef8(null);
   const socketRef = useRef8(null);
   const socketIdRef = useRef8(socketId);
   const commandUrlRef = useRef8(commandUrl);
@@ -3084,6 +3106,12 @@ function useTourPlayback({
   toursApiBaseRef.current = toursApiBase;
   pendingTourRef.current = pendingTour;
   showCaptionsRef.current = showCaptions;
+  const releasePlaybackOwnership = useCallback7(() => {
+    const claimedKey = claimedPlaybackOwnerKeyRef.current;
+    if (!claimedKey) return;
+    releaseTourPlaybackOwnership(claimedKey, playbackOwnerIdRef.current);
+    claimedPlaybackOwnerKeyRef.current = null;
+  }, []);
   useEffect11(() => {
     if (disabled) return;
     if (typeof window === "undefined") return;
@@ -3119,7 +3147,8 @@ function useTourPlayback({
       }
     };
     const handleCommand = async (payload) => {
-      if (!shouldExecuteTourCommandBatch(isActiveRef.current)) {
+      const ownerKey = createTourPlaybackOwnerKey(serverUrl, websiteIdRef.current, experienceTypeRef.current);
+      if (!shouldExecuteTourCommandBatch(isActiveRef.current) || !hasTourPlaybackOwnership(ownerKey, playbackOwnerIdRef.current)) {
         const activeType = experienceTypeRef.current;
         console.log("[TourClient] Ignoring command batch for inactive playback hook:", activeType, payload.stepIndex);
         return;
@@ -3629,6 +3658,12 @@ function useTourPlayback({
         console.log(`[TourClient] Ignoring ${tour.type} start (this hook is for ${expType})`);
         return;
       }
+      const ownerKey = createTourPlaybackOwnerKey(serverUrl, websiteIdRef.current, expType);
+      if (!claimTourPlaybackOwnership(ownerKey, playbackOwnerIdRef.current)) {
+        console.log(`[TourClient] Ignoring ${expType} start because another hook already owns playback`);
+        return;
+      }
+      claimedPlaybackOwnerKeyRef.current = ownerKey;
       skipRequestedRef.current = false;
       startRequestedRef.current = false;
       const total = tourData.totalSteps ?? tour?.steps?.length ?? 0;
@@ -3690,12 +3725,13 @@ function useTourPlayback({
     const handleDebugLog = (entry) => {
       const isDev = devModeRef.current || process.env.NODE_ENV === "development" || typeof window !== "undefined" && window.MODELNEX_DEBUG;
       const entryTourType = entry?.data?.tourContext?.type ?? tourRef.current?.type ?? null;
+      const ownerKey = createTourPlaybackOwnerKey(serverUrl, websiteIdRef.current, experienceTypeRef.current);
       if (!shouldLogTourDebugEntry({
         isPlaybackActive: isActiveRef.current,
         entryType: entry?.type,
         entryTourType,
         experienceType: experienceTypeRef.current
-      })) {
+      }) || isActiveRef.current && !hasTourPlaybackOwnership(ownerKey, playbackOwnerIdRef.current)) {
         return;
       }
       if (isDev) {
@@ -3730,9 +3766,10 @@ function useTourPlayback({
       setServerState(null);
       runIdRef.current = null;
       turnIdRef.current = null;
+      releasePlaybackOwnership();
       tourSocketPool.release(serverUrl, toClose);
     };
-  }, [serverUrl, disabled]);
+  }, [serverUrl, disabled, releasePlaybackOwnership]);
   useEffect11(() => {
     if (disabled) return;
     const s = socketRef.current;
@@ -3804,6 +3841,7 @@ function useTourPlayback({
     skipRequestedRef.current = true;
     isActiveRef.current = false;
     startRequestedRef.current = false;
+    releasePlaybackOwnership();
     activeExecutionTokenRef.current += 1;
     commandInFlightRef.current = false;
     activeCommandBatchIdRef.current = null;
@@ -3839,13 +3877,14 @@ function useTourPlayback({
     setIsReviewMode(false);
     pendingInputBufRef.current = null;
     onTourEnd?.();
-  }, [voice, onTourEnd, serverUrl, websiteId]);
+  }, [voice, onTourEnd, serverUrl, websiteId, releasePlaybackOwnership]);
   const handleTourEnd = useCallback7(() => {
     const endingTourId = tourRef.current?.id;
     const endingPreviewRunId = previewRunIdRef.current;
     const endingStepOrder = stepIndexRef.current;
     isActiveRef.current = false;
     startRequestedRef.current = false;
+    releasePlaybackOwnership();
     setPlaybackState("complete");
     removeHighlight();
     removeCaption();
@@ -3877,7 +3916,7 @@ function useTourPlayback({
       clearActiveDraftPreview(experienceType);
     }
     onTourEnd?.();
-  }, [experienceType, userProfile, serverUrl, voice, onTourEnd, websiteId]);
+  }, [experienceType, userProfile, serverUrl, voice, onTourEnd, websiteId, releasePlaybackOwnership]);
   const runTour = useCallback7(async (tour, options) => {
     if (!shouldAcceptTourStart({
       isPlaybackActive: isActiveRef.current,
@@ -3897,6 +3936,12 @@ function useTourPlayback({
       console.warn("[TourClient] Cannot run tour, socket not connected.");
       return;
     }
+    const ownerKey = createTourPlaybackOwnerKey(serverUrl, websiteIdRef.current, tour.type ?? experienceTypeRef.current);
+    if (!claimTourPlaybackOwnership(ownerKey, playbackOwnerIdRef.current)) {
+      console.log("[TourClient] Ignoring duplicate start request because another hook already owns this experience:", tour.id);
+      return;
+    }
+    claimedPlaybackOwnerKeyRef.current = ownerKey;
     startRequestedRef.current = true;
     const shouldReview = Boolean(options?.reviewMode);
     resetCaptionSuppression();

package/package.json

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