@modelnex/sdk 0.5.13 → 0.5.15

package/dist/aom-GA6W42DG.mjs

@@ -0,0 +1,71 @@
+import "./chunk-6DZX6EAA.mjs";
+
+// src/utils/aom.ts
+var uidMap = /* @__PURE__ */ new Map();
+var nextUid = 1;
+function generateMinifiedAOM() {
+  uidMap.clear();
+  nextUid = 1;
+  const interactives = document.querySelectorAll(
+    'button, a, input, select, textarea, [role="button"], [role="link"], [role="tab"], [role="menuitem"], [role="option"]'
+  );
+  const nodes = [];
+  interactives.forEach((el) => {
+    if (!el.offsetParent && (el.offsetWidth === 0 || el.offsetHeight === 0)) {
+      return;
+    }
+    if (el.closest("#modelnex-studio-root") || el.closest("#modelnex-active-agent-root")) {
+      return;
+    }
+    const uid = `node:${nextUid++}`;
+    uidMap.set(uid, el);
+    let text = (el.textContent || "").replace(/\s+/g, " ").trim();
+    const ariaLabel = el.getAttribute("aria-label");
+    const placeholder = el.getAttribute("placeholder");
+    let value = void 0;
+    if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement) {
+      value = el.value;
+    }
+    let role = el.tagName.toLowerCase();
+    if (el.hasAttribute("role")) {
+      role = el.getAttribute("role");
+    } else if (role === "a") {
+      role = "link";
+    } else if (el instanceof HTMLInputElement) {
+      role = el.type ? `input[${el.type}]` : "input";
+    }
+    const node = { uid, role };
+    const displayLabel = ariaLabel || text || placeholder;
+    if (displayLabel) {
+      node.text = displayLabel.substring(0, 100);
+    }
+    if (el.getAttribute("name")) {
+      node.name = el.getAttribute("name");
+    }
+    if (value) {
+      node.value = value.substring(0, 100);
+    }
+    if (el instanceof HTMLAnchorElement && el.href) {
+      try {
+        const url = new URL(el.href);
+        node.href = url.pathname + url.search + url.hash;
+      } catch {
+        node.href = el.getAttribute("href");
+      }
+    }
+    nodes.push(node);
+  });
+  return { nodes };
+}
+function getElementByUid(uid) {
+  return uidMap.get(uid) || null;
+}
+function clearAOMMap() {
+  uidMap.clear();
+  nextUid = 1;
+}
+export {
+  clearAOMMap,
+  generateMinifiedAOM,
+  getElementByUid
+};

package/dist/aom-J6NYMGDW.mjs

@@ -0,0 +1,69 @@
+// src/utils/aom.ts
+var uidMap = /* @__PURE__ */ new Map();
+var nextUid = 1;
+function generateMinifiedAOM() {
+  uidMap.clear();
+  nextUid = 1;
+  const interactives = document.querySelectorAll(
+    'button, a, input, select, textarea, [role="button"], [role="link"], [role="tab"], [role="menuitem"], [role="option"]'
+  );
+  const nodes = [];
+  interactives.forEach((el) => {
+    if (!el.offsetParent && (el.offsetWidth === 0 || el.offsetHeight === 0)) {
+      return;
+    }
+    if (el.closest("#modelnex-studio-root") || el.closest("#modelnex-active-agent-root")) {
+      return;
+    }
+    const uid = `node:${nextUid++}`;
+    uidMap.set(uid, el);
+    let text = (el.textContent || "").replace(/\s+/g, " ").trim();
+    const ariaLabel = el.getAttribute("aria-label");
+    const placeholder = el.getAttribute("placeholder");
+    let value = void 0;
+    if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement) {
+      value = el.value;
+    }
+    let role = el.tagName.toLowerCase();
+    if (el.hasAttribute("role")) {
+      role = el.getAttribute("role");
+    } else if (role === "a") {
+      role = "link";
+    } else if (el instanceof HTMLInputElement) {
+      role = el.type ? `input[${el.type}]` : "input";
+    }
+    const node = { uid, role };
+    const displayLabel = ariaLabel || text || placeholder;
+    if (displayLabel) {
+      node.text = displayLabel.substring(0, 100);
+    }
+    if (el.getAttribute("name")) {
+      node.name = el.getAttribute("name");
+    }
+    if (value) {
+      node.value = value.substring(0, 100);
+    }
+    if (el instanceof HTMLAnchorElement && el.href) {
+      try {
+        const url = new URL(el.href);
+        node.href = url.pathname + url.search + url.hash;
+      } catch {
+        node.href = el.getAttribute("href");
+      }
+    }
+    nodes.push(node);
+  });
+  return { nodes };
+}
+function getElementByUid(uid) {
+  return uidMap.get(uid) || null;
+}
+function clearAOMMap() {
+  uidMap.clear();
+  nextUid = 1;
+}
+export {
+  clearAOMMap,
+  generateMinifiedAOM,
+  getElementByUid
+};

package/dist/chunk-6DZX6EAA.mjs

@@ -0,0 +1,37 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __commonJS = (cb, mod) => function __require2() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+export {
+  __require,
+  __commonJS,
+  __toESM
+};

package/dist/dom-sync-Y7Z7TOU6.mjs

@@ -0,0 +1,57 @@
+import "./chunk-6DZX6EAA.mjs";
+
+// src/utils/dom-sync.ts
+function waitForDomSettle(options = {}) {
+  const { timeoutMs = 5e3, debounceMs = 400, minWaitMs = 100 } = options;
+  return new Promise((resolve) => {
+    let debounceTimer = null;
+    let resolved = false;
+    const maxTimer = setTimeout(() => {
+      if (!resolved) {
+        resolved = true;
+        cleanup();
+        console.log("[DOM Sync] Forced resolution by max timeout");
+        resolve();
+      }
+    }, Math.max(timeoutMs, minWaitMs));
+    const finish = () => {
+      if (!resolved) {
+        resolved = true;
+        cleanup();
+        resolve();
+      }
+    };
+    const observer = new MutationObserver((mutations) => {
+      const hasSignificantMutations = mutations.some((m) => {
+        if (m.target instanceof HTMLElement) {
+          if (m.target.hasAttribute("data-modelnex-tour-highlight")) return false;
+          if (m.target.hasAttribute("data-modelnex-caption")) return false;
+          if (m.target.closest("#modelnex-studio-root")) return false;
+          if (m.target.closest("#modelnex-active-agent-root")) return false;
+        }
+        return true;
+      });
+      if (!hasSignificantMutations) return;
+      if (debounceTimer) clearTimeout(debounceTimer);
+      debounceTimer = setTimeout(finish, debounceMs);
+    });
+    const cleanup = () => {
+      observer.disconnect();
+      if (debounceTimer) clearTimeout(debounceTimer);
+      clearTimeout(maxTimer);
+    };
+    setTimeout(() => {
+      if (resolved) return;
+      observer.observe(document.body, {
+        childList: true,
+        subtree: true,
+        attributes: true,
+        characterData: true
+      });
+      debounceTimer = setTimeout(finish, debounceMs);
+    }, minWaitMs);
+  });
+}
+export {
+  waitForDomSettle
+};

package/dist/index.d.mts

@@ -227,6 +227,9 @@ interface RecordingStep {
     onboarding?: OnboardingStepMetadata;
 }
 
+/** Default ModelNex server when `serverUrl` is omitted or React context is unavailable. */
+declare const DEFAULT_MODELNEX_SERVER_URL = "https://api.modelnex.com";
+
 /**
  * Automatic DOM element extraction with stable fingerprinting.
  *
@@ -818,6 +821,11 @@ declare function clearActiveDraftPreview(experienceType?: ExperienceType): void;
 
 interface ModelNexProviderProps {
     children?: unknown;
+    /**
+     * ModelNex Server URL (e.g. https://api.modelnex.com).
+     * When omitted, {@link DEFAULT_MODELNEX_SERVER_URL} is used.
+     */
+    serverUrl?: string;
     /** Identifier for the integrated website, for multi-tenancy */
     websiteId?: string;
     /**
@@ -838,4 +846,4 @@ interface ModelNexProviderProps {
 }
 declare const ModelNexProvider: React$1.FC<ModelNexProviderProps>;
 
-export { type AgentDebug, type AgentTraceLlmInput, type AgentTraceStep, type ChatMessage, type ExperienceGoal, type ExperiencePlaybackHook, type ExperiencePresentation, type ExperienceType, type ExtractedElement, ModelNexChatBubble, type ModelNexChatBubbleProps, ModelNexOnboardingPanel, type ModelNexOnboardingPanelProps, ModelNexProvider, type ModelNexProviderProps, type OnboardingPlaybackHook, type OnboardingStepMetadata, type PreviewLaunchSource, type RecordingModeHook, RecordingOverlay, type RunCommandResult, type SavedDraftPreview, StudioOverlay, type TagData, type TagStore, type Tour, type TourNotificationType, type TourPlaybackHook, type TourPlaybackState, TourProgressPanel, type TourStartPolicy, type TourStep, type TourStepType, type TourTrigger, UIStateProvider, type UserProfile, type VoiceHook, buildDraftPreviewUrl, buildRecordingCapturePayload, buildRecordingStepGoal, clearActiveDraftPreview, extractInteractiveElements, generateFingerprint, getPreviewQueryParamName, getRecordingDraftActionLabel, getRecordingDraftStatusMessage, inferOnboardingMetadataForStep, isAskDrivenInputStepType, isInteractiveInputStepType, isManualOnboardingStep, isRecordingDraftGenerating, persistActiveDraftPreview, readActiveDraftPreview, shouldPromptForPreviewStart, shouldShowRecordingOverlay, useActionHighlight, useAgentViewport, useAutoExtract, useExperiencePlayback, useOnboardingPlayback, useRecordingMode, useRunCommand, useTagStore, useTourPlayback, useUIState, useViewportTrack, useVisibleIds, useVoice };
+export { type AgentDebug, type AgentTraceLlmInput, type AgentTraceStep, type ChatMessage, DEFAULT_MODELNEX_SERVER_URL, type ExperienceGoal, type ExperiencePlaybackHook, type ExperiencePresentation, type ExperienceType, type ExtractedElement, ModelNexChatBubble, type ModelNexChatBubbleProps, ModelNexOnboardingPanel, type ModelNexOnboardingPanelProps, ModelNexProvider, type ModelNexProviderProps, type OnboardingPlaybackHook, type OnboardingStepMetadata, type PreviewLaunchSource, type RecordingModeHook, RecordingOverlay, type RunCommandResult, type SavedDraftPreview, StudioOverlay, type TagData, type TagStore, type Tour, type TourNotificationType, type TourPlaybackHook, type TourPlaybackState, TourProgressPanel, type TourStartPolicy, type TourStep, type TourStepType, type TourTrigger, UIStateProvider, type UserProfile, type VoiceHook, buildDraftPreviewUrl, buildRecordingCapturePayload, buildRecordingStepGoal, clearActiveDraftPreview, extractInteractiveElements, generateFingerprint, getPreviewQueryParamName, getRecordingDraftActionLabel, getRecordingDraftStatusMessage, inferOnboardingMetadataForStep, isAskDrivenInputStepType, isInteractiveInputStepType, isManualOnboardingStep, isRecordingDraftGenerating, persistActiveDraftPreview, readActiveDraftPreview, shouldPromptForPreviewStart, shouldShowRecordingOverlay, useActionHighlight, useAgentViewport, useAutoExtract, useExperiencePlayback, useOnboardingPlayback, useRecordingMode, useRunCommand, useTagStore, useTourPlayback, useUIState, useViewportTrack, useVisibleIds, useVoice };

package/dist/index.d.ts

@@ -227,6 +227,9 @@ interface RecordingStep {
     onboarding?: OnboardingStepMetadata;
 }
 
+/** Default ModelNex server when `serverUrl` is omitted or React context is unavailable. */
+declare const DEFAULT_MODELNEX_SERVER_URL = "https://api.modelnex.com";
+
 /**
  * Automatic DOM element extraction with stable fingerprinting.
  *
@@ -818,6 +821,11 @@ declare function clearActiveDraftPreview(experienceType?: ExperienceType): void;
 
 interface ModelNexProviderProps {
     children?: unknown;
+    /**
+     * ModelNex Server URL (e.g. https://api.modelnex.com).
+     * When omitted, {@link DEFAULT_MODELNEX_SERVER_URL} is used.
+     */
+    serverUrl?: string;
     /** Identifier for the integrated website, for multi-tenancy */
     websiteId?: string;
     /**
@@ -838,4 +846,4 @@ interface ModelNexProviderProps {
 }
 declare const ModelNexProvider: React$1.FC<ModelNexProviderProps>;
 
-export { type AgentDebug, type AgentTraceLlmInput, type AgentTraceStep, type ChatMessage, type ExperienceGoal, type ExperiencePlaybackHook, type ExperiencePresentation, type ExperienceType, type ExtractedElement, ModelNexChatBubble, type ModelNexChatBubbleProps, ModelNexOnboardingPanel, type ModelNexOnboardingPanelProps, ModelNexProvider, type ModelNexProviderProps, type OnboardingPlaybackHook, type OnboardingStepMetadata, type PreviewLaunchSource, type RecordingModeHook, RecordingOverlay, type RunCommandResult, type SavedDraftPreview, StudioOverlay, type TagData, type TagStore, type Tour, type TourNotificationType, type TourPlaybackHook, type TourPlaybackState, TourProgressPanel, type TourStartPolicy, type TourStep, type TourStepType, type TourTrigger, UIStateProvider, type UserProfile, type VoiceHook, buildDraftPreviewUrl, buildRecordingCapturePayload, buildRecordingStepGoal, clearActiveDraftPreview, extractInteractiveElements, generateFingerprint, getPreviewQueryParamName, getRecordingDraftActionLabel, getRecordingDraftStatusMessage, inferOnboardingMetadataForStep, isAskDrivenInputStepType, isInteractiveInputStepType, isManualOnboardingStep, isRecordingDraftGenerating, persistActiveDraftPreview, readActiveDraftPreview, shouldPromptForPreviewStart, shouldShowRecordingOverlay, useActionHighlight, useAgentViewport, useAutoExtract, useExperiencePlayback, useOnboardingPlayback, useRecordingMode, useRunCommand, useTagStore, useTourPlayback, useUIState, useViewportTrack, useVisibleIds, useVoice };
+export { type AgentDebug, type AgentTraceLlmInput, type AgentTraceStep, type ChatMessage, DEFAULT_MODELNEX_SERVER_URL, type ExperienceGoal, type ExperiencePlaybackHook, type ExperiencePresentation, type ExperienceType, type ExtractedElement, ModelNexChatBubble, type ModelNexChatBubbleProps, ModelNexOnboardingPanel, type ModelNexOnboardingPanelProps, ModelNexProvider, type ModelNexProviderProps, type OnboardingPlaybackHook, type OnboardingStepMetadata, type PreviewLaunchSource, type RecordingModeHook, RecordingOverlay, type RunCommandResult, type SavedDraftPreview, StudioOverlay, type TagData, type TagStore, type Tour, type TourNotificationType, type TourPlaybackHook, type TourPlaybackState, TourProgressPanel, type TourStartPolicy, type TourStep, type TourStepType, type TourTrigger, UIStateProvider, type UserProfile, type VoiceHook, buildDraftPreviewUrl, buildRecordingCapturePayload, buildRecordingStepGoal, clearActiveDraftPreview, extractInteractiveElements, generateFingerprint, getPreviewQueryParamName, getRecordingDraftActionLabel, getRecordingDraftStatusMessage, inferOnboardingMetadataForStep, isAskDrivenInputStepType, isInteractiveInputStepType, isManualOnboardingStep, isRecordingDraftGenerating, persistActiveDraftPreview, readActiveDraftPreview, shouldPromptForPreviewStart, shouldShowRecordingOverlay, useActionHighlight, useAgentViewport, useAutoExtract, useExperiencePlayback, useOnboardingPlayback, useRecordingMode, useRunCommand, useTagStore, useTourPlayback, useUIState, useViewportTrack, useVisibleIds, useVoice };

package/dist/index.js

@@ -172,6 +172,7 @@ var init_dom_sync = __esm({
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  DEFAULT_MODELNEX_SERVER_URL: () => DEFAULT_MODELNEX_SERVER_URL,
   ModelNexChatBubble: () => ModelNexChatBubble,
   ModelNexOnboardingPanel: () => ModelNexOnboardingPanel,
   ModelNexProvider: () => ModelNexProvider,
@@ -227,11 +228,11 @@ function resolveSocketIoTransports(serverUrl, order) {
   try {
     const host = new URL(serverUrl).hostname.toLowerCase();
     if (host.endsWith("awsapprunner.com")) {
-      return ["polling"];
+      return ["websocket"];
     }
   } catch {
   }
-  return order === "websocket-first" ? ["websocket", "polling"] : ["polling", "websocket"];
+  return ["websocket", "polling"];
 }
 
 // src/auto-extract.ts
@@ -2322,9 +2323,11 @@ function useBuiltinActions(registerAction, unregisterAction, tagStore, serverUrl
   }, [registerAction, unregisterAction]);
 }
 
+// src/constants.ts
+var DEFAULT_MODELNEX_SERVER_URL = "https://api.modelnex.com";
+
 // src/hooks/useRunCommand.ts
 var import_react9 = require("react");
-var DEFAULT_SERVER_URL = "https://69tgf4aic6.us-east-1.awsapprunner.com";
 function searchTaggedElementsForQuery(store, query, limit = 8) {
   const allTags = store.getAllTags();
   if (allTags.length === 0) return [];
@@ -2345,7 +2348,7 @@ function searchTaggedElementsForQuery(store, query, limit = 8) {
 }
 function useRunCommand(serverUrlOverride) {
   const context = (0, import_react9.useContext)(ModelNexContext);
-  const baseUrl = serverUrlOverride ?? context?.commandUrl ?? context?.serverUrl ?? DEFAULT_SERVER_URL;
+  const baseUrl = serverUrlOverride ?? context?.commandUrl ?? context?.serverUrl ?? DEFAULT_MODELNEX_SERVER_URL;
   const tagStore = context?.tagStore;
   return (0, import_react9.useCallback)(
     async (command, signal) => {
@@ -3151,6 +3154,12 @@ function useTourPlayback({
   const [serverState, setServerState] = (0, import_react12.useState)(null);
   const ctx = (0, import_react12.useContext)(ModelNexContext);
   const devMode = ctx?.devMode;
+  const devModeRef = (0, import_react12.useRef)(devMode);
+  devModeRef.current = devMode;
+  const userProfileRef = (0, import_react12.useRef)(userProfile);
+  userProfileRef.current = userProfile;
+  const experienceTypeRef = (0, import_react12.useRef)(experienceType);
+  experienceTypeRef.current = experienceType;
   const tourRef = (0, import_react12.useRef)(null);
   const stepIndexRef = (0, import_react12.useRef)(0);
   const skipRequestedRef = (0, import_react12.useRef)(false);
@@ -3190,18 +3199,27 @@ function useTourPlayback({
   (0, import_react12.useEffect)(() => {
     if (disabled) return;
     if (typeof window === "undefined") return;
+    let cancelled = false;
+    let createdSocket = null;
     import("socket.io-client").then((ioModule) => {
+      if (cancelled) return;
       const io2 = ioModule.default || ioModule;
       const socket = io2(serverUrl, {
         path: "/socket.io",
         // standard
-        transports: resolveSocketIoTransports(serverUrl, "websocket-first")
+        transports: resolveSocketIoTransports(serverUrl, "polling-first")
       });
+      if (cancelled) {
+        socket.disconnect();
+        return;
+      }
+      createdSocket = socket;
       socketRef.current = socket;
       socket.on("connect", () => {
         console.log("[TourClient] Connected to tour agent server:", socket.id);
-        if (websiteId && userProfile) {
-          socket.emit("tour:init", { websiteId, userId: userProfile.userId, userType: userProfile.type });
+        const profile = userProfileRef.current;
+        if (websiteId && profile?.userId) {
+          socket.emit("tour:init", { websiteId, userId: profile.userId, userType: profile.type });
         }
       });
       socket.on("tour:server_state", (payload) => {
@@ -3226,6 +3244,11 @@ function useTourPlayback({
         }
       });
       socket.on("tour:command", async (payload) => {
+        const emitIfOpen = (ev, data) => {
+          if (socketRef.current !== socket) return;
+          if (!socket.connected) return;
+          socket.emit(ev, data);
+        };
         console.log("[TourClient] Received command batch:", payload.stepIndex, payload.commands);
         runCleanup(pendingManualWaitCleanupRef.current);
         pendingManualWaitCleanupRef.current = null;
@@ -3284,7 +3307,7 @@ function useTourPlayback({
         if (!payload.commands || !Array.isArray(payload.commands)) {
           console.warn("[TourClient] Payload commands is not an array:", payload);
           commandInFlightRef.current = false;
-          socket.emit("tour:action_result", {
+          emitIfOpen("tour:action_result", {
             success: false,
             reason: "invalid_commands",
             commandBatchId,
@@ -3563,7 +3586,7 @@ function useTourPlayback({
                 currentStepOrder: stepIndexRef.current
               });
             }
-            socket.emit("tour:action_result", {
+            emitIfOpen("tour:action_result", {
               success: true,
               interrupted: true,
               results,
@@ -3588,7 +3611,7 @@ function useTourPlayback({
               currentStepOrder: stepIndexRef.current
             });
           }
-          socket.emit("tour:action_result", {
+          emitIfOpen("tour:action_result", {
             success: false,
             reason: "execution_error",
             error: String(err),
@@ -3657,7 +3680,7 @@ function useTourPlayback({
               currentStepOrder: stepIndexRef.current
             });
           }
-          socket.emit("tour:action_result", {
+          emitIfOpen("tour:action_result", {
             success: true,
             waitingForInput: true,
             results,
@@ -3690,7 +3713,7 @@ function useTourPlayback({
             const { waitForDomSettle: waitForDomSettle2 } = await Promise.resolve().then(() => (init_dom_sync(), dom_sync_exports));
             await waitForDomSettle2({ timeoutMs: 1500, debounceMs: 200 });
             await syncAOM();
-            socket.emit("tour:user_input", {
+            emitIfOpen("tour:user_input", {
               transcript,
               runId: runIdRef.current,
               turnId: turnIdRef.current
@@ -3709,7 +3732,7 @@ function useTourPlayback({
             currentStepOrder: stepIndexRef.current
           });
         }
-        socket.emit("tour:action_result", {
+        emitIfOpen("tour:action_result", {
           success: true,
           results,
           commandBatchId,
@@ -3722,8 +3745,9 @@ function useTourPlayback({
         if (isActiveRef.current) return;
         runIdRef.current = typeof tourData.runId === "number" ? tourData.runId : runIdRef.current;
         const tour = tourData.tourContext ?? tourRef.current;
-        if (tour?.type && tour.type !== experienceType) {
-          console.log(`[TourClient] Ignoring ${tour.type} start (this hook is for ${experienceType})`);
+        const expType = experienceTypeRef.current;
+        if (tour?.type && tour.type !== expType) {
+          console.log(`[TourClient] Ignoring ${tour.type} start (this hook is for ${expType})`);
           return;
         }
         skipRequestedRef.current = false;
@@ -3750,11 +3774,13 @@ function useTourPlayback({
         try {
           const { generateMinifiedAOM: generateMinifiedAOM2 } = await Promise.resolve().then(() => (init_aom(), aom_exports));
           const aom = generateMinifiedAOM2();
-          socket.emit("tour:sync_dom", {
-            url: window.location.pathname + window.location.search + window.location.hash,
-            aom: aom.nodes,
-            domSummary: captureDomSummary()
-          });
+          if (socketRef.current === socket && socket.connected) {
+            socket.emit("tour:sync_dom", {
+              url: window.location.pathname + window.location.search + window.location.hash,
+              aom: aom.nodes,
+              domSummary: captureDomSummary()
+            });
+          }
         } catch (e) {
           console.warn("[TourClient] Initial DOM sync failed:", e);
         }
@@ -3782,7 +3808,7 @@ function useTourPlayback({
         handleTourEnd();
       });
       socket.on("tour:debug_log", (entry) => {
-        const isDev = devMode || process.env.NODE_ENV === "development" || typeof window !== "undefined" && window.MODELNEX_DEBUG;
+        const isDev = devModeRef.current || process.env.NODE_ENV === "development" || typeof window !== "undefined" && window.MODELNEX_DEBUG;
         if (isDev) {
           console.log(`%c[ModelNex Tour] ${entry.type}`, "color: #3b82f6; font-weight: bold", entry);
           if (typeof window !== "undefined") {
@@ -3792,18 +3818,28 @@ function useTourPlayback({
           }
         }
       });
-      console.log("[ModelNex SDK] Tour playback initialized. Debug logs enabled:", devMode || process.env.NODE_ENV === "development");
+      console.log("[ModelNex SDK] Tour playback initialized. Debug logs enabled:", devModeRef.current || process.env.NODE_ENV === "development");
     });
     return () => {
-      if (socketRef.current) {
-        socketRef.current.disconnect();
-        socketRef.current = null;
+      cancelled = true;
+      const toClose = createdSocket ?? socketRef.current;
+      if (toClose) {
+        toClose.disconnect();
       }
+      createdSocket = null;
+      socketRef.current = null;
       setServerState(null);
       runIdRef.current = null;
       turnIdRef.current = null;
     };
-  }, [serverUrl, websiteId, userProfile, disabled, devMode, experienceType]);
+  }, [serverUrl, websiteId, disabled]);
+  (0, import_react12.useEffect)(() => {
+    if (disabled) return;
+    const s = socketRef.current;
+    const profile = userProfile;
+    if (!s?.connected || !websiteId || !profile?.userId) return;
+    s.emit("tour:init", { websiteId, userId: profile.userId, userType: profile.type });
+  }, [disabled, websiteId, userProfile?.userId, userProfile?.type]);
   (0, import_react12.useEffect)(() => {
     if (!showCaptions || !isReviewMode) {
       removeCaption();
@@ -3942,7 +3978,7 @@ function useTourPlayback({
     setPendingTour(null);
     pendingTourRef.current = null;
     let retries = 0;
-    while (!socketRef.current?.connected && retries < 15) {
+    while (!socketRef.current?.connected && retries < 30) {
       await new Promise((r) => setTimeout(r, 200));
       retries++;
     }
@@ -8419,7 +8455,7 @@ function ModelNexChatBubble({
   const messagesEndRef = (0, import_react18.useRef)(null);
   const abortControllerRef = (0, import_react18.useRef)(null);
   const panelRef = (0, import_react18.useRef)(null);
-  const serverUrl = ctx?.serverUrl ?? "https://69tgf4aic6.us-east-1.awsapprunner.com";
+  const serverUrl = ctx?.serverUrl ?? DEFAULT_MODELNEX_SERVER_URL;
   const voice = useVoice(serverUrl);
   const audioLevels = useAudioLevel(voice.isListening);
   const recordingMode = ctx?.recordingMode ?? false;
@@ -8506,7 +8542,7 @@ function ModelNexChatBubble({
     if (lastAutoTaggedUrlRef.current === currentUrl || localStorage.getItem(storageKey)) {
       return;
     }
-    const baseUrl = commandUrl ?? serverUrl2 ?? "https://69tgf4aic6.us-east-1.awsapprunner.com";
+    const baseUrl = commandUrl ?? serverUrl2 ?? DEFAULT_MODELNEX_SERVER_URL;
     const url = baseUrl.startsWith("/") ? `${window.location.origin}${baseUrl}/agent/auto-tag` : `${baseUrl}/agent/auto-tag`;
     const elements = extractedElements.map((el) => ({
       fingerprint: el.fingerprint,
@@ -8896,7 +8932,7 @@ function ModelNexChatBubble({
     }
   };
   const stopAgent = async () => {
-    const baseUrl = ctx?.commandUrl ?? ctx?.serverUrl ?? "https://69tgf4aic6.us-east-1.awsapprunner.com";
+    const baseUrl = ctx?.commandUrl ?? ctx?.serverUrl ?? DEFAULT_MODELNEX_SERVER_URL;
     const abortUrl = baseUrl.startsWith("/") ? `${window.location.origin}${baseUrl}/agent/abort` : `${baseUrl}/agent/abort`;
     try {
       await fetch(abortUrl, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ socketId: ctx?.socketId }) });
@@ -10163,7 +10199,7 @@ function ModelNexOnboardingPanel({
   title = "Getting Started"
 }) {
   const ctx = (0, import_react19.useContext)(ModelNexContext);
-  const serverUrl = ctx?.serverUrl ?? "https://69tgf4aic6.us-east-1.awsapprunner.com";
+  const serverUrl = ctx?.serverUrl ?? DEFAULT_MODELNEX_SERVER_URL;
   const voice = useVoice(serverUrl);
   const audioLevels = useAudioLevel(voice.isListening);
   const [input, setInput] = (0, import_react19.useState)("");
@@ -10862,15 +10898,15 @@ function TourProgressPanel({ tour, currentStepIndex, onSkip, voiceOnly }) {
 }
 
 // src/index.ts
-var DEFAULT_SERVER_URL2 = "https://69tgf4aic6.us-east-1.awsapprunner.com";
 var ModelNexProvider = ({
   children,
   websiteId,
   userProfile,
   toursApiBase,
-  devMode
+  devMode,
+  serverUrl: serverUrlProp
 }) => {
-  const serverUrl = DEFAULT_SERVER_URL2;
+  const serverUrl = serverUrlProp ?? DEFAULT_MODELNEX_SERVER_URL;
   const commandUrl = void 0;
   const disableSocket = false;
   const renderedChildren = children;
@@ -10983,6 +11019,7 @@ var ModelNexProvider = ({
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DEFAULT_MODELNEX_SERVER_URL,
   ModelNexChatBubble,
   ModelNexOnboardingPanel,
   ModelNexProvider,

package/dist/index.mjs

@@ -18,11 +18,11 @@ function resolveSocketIoTransports(serverUrl, order) {
   try {
     const host = new URL(serverUrl).hostname.toLowerCase();
     if (host.endsWith("awsapprunner.com")) {
-      return ["polling"];
+      return ["websocket"];
     }
   } catch {
   }
-  return order === "websocket-first" ? ["websocket", "polling"] : ["polling", "websocket"];
+  return ["websocket", "polling"];
 }
 
 // src/auto-extract.ts
@@ -2113,9 +2113,11 @@ function useBuiltinActions(registerAction, unregisterAction, tagStore, serverUrl
   }, [registerAction, unregisterAction]);
 }
 
+// src/constants.ts
+var DEFAULT_MODELNEX_SERVER_URL = "https://api.modelnex.com";
+
 // src/hooks/useRunCommand.ts
 import { useCallback as useCallback5, useContext as useContext2 } from "react";
-var DEFAULT_SERVER_URL = "https://69tgf4aic6.us-east-1.awsapprunner.com";
 function searchTaggedElementsForQuery(store, query, limit = 8) {
   const allTags = store.getAllTags();
   if (allTags.length === 0) return [];
@@ -2136,7 +2138,7 @@ function searchTaggedElementsForQuery(store, query, limit = 8) {
 }
 function useRunCommand(serverUrlOverride) {
   const context = useContext2(ModelNexContext);
-  const baseUrl = serverUrlOverride ?? context?.commandUrl ?? context?.serverUrl ?? DEFAULT_SERVER_URL;
+  const baseUrl = serverUrlOverride ?? context?.commandUrl ?? context?.serverUrl ?? DEFAULT_MODELNEX_SERVER_URL;
   const tagStore = context?.tagStore;
   return useCallback5(
     async (command, signal) => {
@@ -2942,6 +2944,12 @@ function useTourPlayback({
   const [serverState, setServerState] = useState7(null);
   const ctx = useContext4(ModelNexContext);
   const devMode = ctx?.devMode;
+  const devModeRef = useRef8(devMode);
+  devModeRef.current = devMode;
+  const userProfileRef = useRef8(userProfile);
+  userProfileRef.current = userProfile;
+  const experienceTypeRef = useRef8(experienceType);
+  experienceTypeRef.current = experienceType;
   const tourRef = useRef8(null);
   const stepIndexRef = useRef8(0);
   const skipRequestedRef = useRef8(false);
@@ -2981,18 +2989,27 @@ function useTourPlayback({
   useEffect11(() => {
     if (disabled) return;
     if (typeof window === "undefined") return;
+    let cancelled = false;
+    let createdSocket = null;
     import("socket.io-client").then((ioModule) => {
+      if (cancelled) return;
       const io2 = ioModule.default || ioModule;
       const socket = io2(serverUrl, {
         path: "/socket.io",
         // standard
-        transports: resolveSocketIoTransports(serverUrl, "websocket-first")
+        transports: resolveSocketIoTransports(serverUrl, "polling-first")
       });
+      if (cancelled) {
+        socket.disconnect();
+        return;
+      }
+      createdSocket = socket;
       socketRef.current = socket;
       socket.on("connect", () => {
         console.log("[TourClient] Connected to tour agent server:", socket.id);
-        if (websiteId && userProfile) {
-          socket.emit("tour:init", { websiteId, userId: userProfile.userId, userType: userProfile.type });
+        const profile = userProfileRef.current;
+        if (websiteId && profile?.userId) {
+          socket.emit("tour:init", { websiteId, userId: profile.userId, userType: profile.type });
         }
       });
       socket.on("tour:server_state", (payload) => {
@@ -3017,6 +3034,11 @@ function useTourPlayback({
         }
       });
       socket.on("tour:command", async (payload) => {
+        const emitIfOpen = (ev, data) => {
+          if (socketRef.current !== socket) return;
+          if (!socket.connected) return;
+          socket.emit(ev, data);
+        };
         console.log("[TourClient] Received command batch:", payload.stepIndex, payload.commands);
         runCleanup(pendingManualWaitCleanupRef.current);
         pendingManualWaitCleanupRef.current = null;
@@ -3075,7 +3097,7 @@ function useTourPlayback({
         if (!payload.commands || !Array.isArray(payload.commands)) {
           console.warn("[TourClient] Payload commands is not an array:", payload);
           commandInFlightRef.current = false;
-          socket.emit("tour:action_result", {
+          emitIfOpen("tour:action_result", {
             success: false,
             reason: "invalid_commands",
             commandBatchId,
@@ -3354,7 +3376,7 @@ function useTourPlayback({
                 currentStepOrder: stepIndexRef.current
               });
             }
-            socket.emit("tour:action_result", {
+            emitIfOpen("tour:action_result", {
               success: true,
               interrupted: true,
               results,
@@ -3379,7 +3401,7 @@ function useTourPlayback({
               currentStepOrder: stepIndexRef.current
             });
           }
-          socket.emit("tour:action_result", {
+          emitIfOpen("tour:action_result", {
             success: false,
             reason: "execution_error",
             error: String(err),
@@ -3448,7 +3470,7 @@ function useTourPlayback({
               currentStepOrder: stepIndexRef.current
             });
           }
-          socket.emit("tour:action_result", {
+          emitIfOpen("tour:action_result", {
             success: true,
             waitingForInput: true,
             results,
@@ -3481,7 +3503,7 @@ function useTourPlayback({
             const { waitForDomSettle } = await import("./dom-sync-L5KIP45X.mjs");
             await waitForDomSettle({ timeoutMs: 1500, debounceMs: 200 });
             await syncAOM();
-            socket.emit("tour:user_input", {
+            emitIfOpen("tour:user_input", {
               transcript,
               runId: runIdRef.current,
               turnId: turnIdRef.current
@@ -3500,7 +3522,7 @@ function useTourPlayback({
             currentStepOrder: stepIndexRef.current
           });
         }
-        socket.emit("tour:action_result", {
+        emitIfOpen("tour:action_result", {
           success: true,
           results,
           commandBatchId,
@@ -3513,8 +3535,9 @@ function useTourPlayback({
         if (isActiveRef.current) return;
         runIdRef.current = typeof tourData.runId === "number" ? tourData.runId : runIdRef.current;
         const tour = tourData.tourContext ?? tourRef.current;
-        if (tour?.type && tour.type !== experienceType) {
-          console.log(`[TourClient] Ignoring ${tour.type} start (this hook is for ${experienceType})`);
+        const expType = experienceTypeRef.current;
+        if (tour?.type && tour.type !== expType) {
+          console.log(`[TourClient] Ignoring ${tour.type} start (this hook is for ${expType})`);
           return;
         }
         skipRequestedRef.current = false;
@@ -3541,11 +3564,13 @@ function useTourPlayback({
         try {
           const { generateMinifiedAOM: generateMinifiedAOM2 } = await import("./aom-HDYNCIOY.mjs");
           const aom = generateMinifiedAOM2();
-          socket.emit("tour:sync_dom", {
-            url: window.location.pathname + window.location.search + window.location.hash,
-            aom: aom.nodes,
-            domSummary: captureDomSummary()
-          });
+          if (socketRef.current === socket && socket.connected) {
+            socket.emit("tour:sync_dom", {
+              url: window.location.pathname + window.location.search + window.location.hash,
+              aom: aom.nodes,
+              domSummary: captureDomSummary()
+            });
+          }
         } catch (e) {
           console.warn("[TourClient] Initial DOM sync failed:", e);
         }
@@ -3573,7 +3598,7 @@ function useTourPlayback({
         handleTourEnd();
       });
       socket.on("tour:debug_log", (entry) => {
-        const isDev = devMode || process.env.NODE_ENV === "development" || typeof window !== "undefined" && window.MODELNEX_DEBUG;
+        const isDev = devModeRef.current || process.env.NODE_ENV === "development" || typeof window !== "undefined" && window.MODELNEX_DEBUG;
         if (isDev) {
           console.log(`%c[ModelNex Tour] ${entry.type}`, "color: #3b82f6; font-weight: bold", entry);
           if (typeof window !== "undefined") {
@@ -3583,18 +3608,28 @@ function useTourPlayback({
           }
         }
       });
-      console.log("[ModelNex SDK] Tour playback initialized. Debug logs enabled:", devMode || process.env.NODE_ENV === "development");
+      console.log("[ModelNex SDK] Tour playback initialized. Debug logs enabled:", devModeRef.current || process.env.NODE_ENV === "development");
     });
     return () => {
-      if (socketRef.current) {
-        socketRef.current.disconnect();
-        socketRef.current = null;
+      cancelled = true;
+      const toClose = createdSocket ?? socketRef.current;
+      if (toClose) {
+        toClose.disconnect();
       }
+      createdSocket = null;
+      socketRef.current = null;
       setServerState(null);
       runIdRef.current = null;
       turnIdRef.current = null;
     };
-  }, [serverUrl, websiteId, userProfile, disabled, devMode, experienceType]);
+  }, [serverUrl, websiteId, disabled]);
+  useEffect11(() => {
+    if (disabled) return;
+    const s = socketRef.current;
+    const profile = userProfile;
+    if (!s?.connected || !websiteId || !profile?.userId) return;
+    s.emit("tour:init", { websiteId, userId: profile.userId, userType: profile.type });
+  }, [disabled, websiteId, userProfile?.userId, userProfile?.type]);
   useEffect11(() => {
     if (!showCaptions || !isReviewMode) {
       removeCaption();
@@ -3733,7 +3768,7 @@ function useTourPlayback({
     setPendingTour(null);
     pendingTourRef.current = null;
     let retries = 0;
-    while (!socketRef.current?.connected && retries < 15) {
+    while (!socketRef.current?.connected && retries < 30) {
       await new Promise((r) => setTimeout(r, 200));
       retries++;
     }
@@ -8209,7 +8244,7 @@ function ModelNexChatBubble({
   const messagesEndRef = useRef13(null);
   const abortControllerRef = useRef13(null);
   const panelRef = useRef13(null);
-  const serverUrl = ctx?.serverUrl ?? "https://69tgf4aic6.us-east-1.awsapprunner.com";
+  const serverUrl = ctx?.serverUrl ?? DEFAULT_MODELNEX_SERVER_URL;
   const voice = useVoice(serverUrl);
   const audioLevels = useAudioLevel(voice.isListening);
   const recordingMode = ctx?.recordingMode ?? false;
@@ -8296,7 +8331,7 @@ function ModelNexChatBubble({
     if (lastAutoTaggedUrlRef.current === currentUrl || localStorage.getItem(storageKey)) {
       return;
     }
-    const baseUrl = commandUrl ?? serverUrl2 ?? "https://69tgf4aic6.us-east-1.awsapprunner.com";
+    const baseUrl = commandUrl ?? serverUrl2 ?? DEFAULT_MODELNEX_SERVER_URL;
     const url = baseUrl.startsWith("/") ? `${window.location.origin}${baseUrl}/agent/auto-tag` : `${baseUrl}/agent/auto-tag`;
     const elements = extractedElements.map((el) => ({
       fingerprint: el.fingerprint,
@@ -8686,7 +8721,7 @@ function ModelNexChatBubble({
     }
   };
   const stopAgent = async () => {
-    const baseUrl = ctx?.commandUrl ?? ctx?.serverUrl ?? "https://69tgf4aic6.us-east-1.awsapprunner.com";
+    const baseUrl = ctx?.commandUrl ?? ctx?.serverUrl ?? DEFAULT_MODELNEX_SERVER_URL;
     const abortUrl = baseUrl.startsWith("/") ? `${window.location.origin}${baseUrl}/agent/abort` : `${baseUrl}/agent/abort`;
     try {
       await fetch(abortUrl, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ socketId: ctx?.socketId }) });
@@ -9953,7 +9988,7 @@ function ModelNexOnboardingPanel({
   title = "Getting Started"
 }) {
   const ctx = useContext6(ModelNexContext);
-  const serverUrl = ctx?.serverUrl ?? "https://69tgf4aic6.us-east-1.awsapprunner.com";
+  const serverUrl = ctx?.serverUrl ?? DEFAULT_MODELNEX_SERVER_URL;
   const voice = useVoice(serverUrl);
   const audioLevels = useAudioLevel(voice.isListening);
   const [input, setInput] = useState14("");
@@ -10652,15 +10687,15 @@ function TourProgressPanel({ tour, currentStepIndex, onSkip, voiceOnly }) {
 }
 
 // src/index.ts
-var DEFAULT_SERVER_URL2 = "https://69tgf4aic6.us-east-1.awsapprunner.com";
 var ModelNexProvider = ({
   children,
   websiteId,
   userProfile,
   toursApiBase,
-  devMode
+  devMode,
+  serverUrl: serverUrlProp
 }) => {
-  const serverUrl = DEFAULT_SERVER_URL2;
+  const serverUrl = serverUrlProp ?? DEFAULT_MODELNEX_SERVER_URL;
   const commandUrl = void 0;
   const disableSocket = false;
   const renderedChildren = children;
@@ -10772,6 +10807,7 @@ var ModelNexProvider = ({
   );
 };
 export {
+  DEFAULT_MODELNEX_SERVER_URL,
   ModelNexChatBubble,
   ModelNexOnboardingPanel,
   ModelNexProvider,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelnex/sdk",
-  "version": "0.5.13",
+  "version": "0.5.15",
   "description": "React SDK for natural language control of web apps via AI agents",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -20,6 +20,15 @@
     "dist",
     "README.md"
   ],
+  "scripts": {
+    "prepublishOnly": "npm run build",
+    "build": "npm exec -- tsup src/index.ts --format cjs,esm --dts",
+    "dev": "npm exec -- tsup src/index.ts --format cjs,esm --watch --dts",
+    "lint": "eslint src/",
+    "test": "npm run build && node --test tests/*.test.js",
+    "test:ci": "npm run test && npm run test:unit",
+    "test:unit": "node --import tsx --test tests/*.test.ts"
+  },
   "peerDependencies": {
     "react": ">=17.0.0",
     "react-dom": ">=17.0.0",
@@ -58,13 +67,5 @@
   "bugs": {
     "url": "https://github.com/sharunaraksha/modelnex-sdk/issues"
   },
-  "homepage": "https://github.com/sharunaraksha/modelnex-sdk#readme",
-  "scripts": {
-    "build": "npm exec -- tsup src/index.ts --format cjs,esm --dts",
-    "dev": "npm exec -- tsup src/index.ts --format cjs,esm --watch --dts",
-    "lint": "eslint src/",
-    "test": "npm run build && node --test tests/*.test.js",
-    "test:ci": "npm run test && npm run test:unit",
-    "test:unit": "node --import tsx --test tests/*.test.ts"
-  }
-}
+  "homepage": "https://github.com/sharunaraksha/modelnex-sdk#readme"
+}