@modelnex/sdk 0.5.51 → 0.5.53

package/dist/aom-HDYNCIOY.mjs

@@ -0,0 +1,10 @@
+import {
+  clearAOMMap,
+  generateMinifiedAOM,
+  getElementByUid
+} from "./chunk-N65UEB6X.mjs";
+export {
+  clearAOMMap,
+  generateMinifiedAOM,
+  getElementByUid
+};

package/dist/aom-LJNCLNXL.mjs

@@ -0,0 +1,10 @@
+import {
+  clearAOMMap,
+  generateMinifiedAOM,
+  getElementByUid
+} from "./chunk-H4LUY7LI.mjs";
+export {
+  clearAOMMap,
+  generateMinifiedAOM,
+  getElementByUid
+};

package/dist/chunk-H4LUY7LI.mjs

@@ -0,0 +1,243 @@
+// src/utils/editable-controls.ts
+var EDITABLE_ROLES = /* @__PURE__ */ new Set(["textbox", "combobox"]);
+var EDITABLE_CONTROL_SELECTOR = [
+  'input:not([type="hidden"])',
+  "textarea",
+  "select",
+  '[contenteditable="true"]',
+  '[role="textbox"]',
+  '[role="combobox"]'
+].join(", ");
+function getTagName(element) {
+  return String(element?.tagName || "").toLowerCase();
+}
+function getRole(element) {
+  const role = element && typeof element.getAttribute === "function" ? element.getAttribute("role") : null;
+  return String(role || "").toLowerCase();
+}
+function getLabelControl(element) {
+  const labelCtor = typeof HTMLLabelElement !== "undefined" ? HTMLLabelElement : null;
+  if (labelCtor && element instanceof labelCtor && element.control instanceof HTMLElement) {
+    return element.control;
+  }
+  return null;
+}
+function isValueBearingElement(element) {
+  if (!element) return false;
+  const inputCtor = typeof HTMLInputElement !== "undefined" ? HTMLInputElement : null;
+  if (inputCtor && element instanceof inputCtor) return true;
+  const textareaCtor = typeof HTMLTextAreaElement !== "undefined" ? HTMLTextAreaElement : null;
+  if (textareaCtor && element instanceof textareaCtor) return true;
+  const selectCtor = typeof HTMLSelectElement !== "undefined" ? HTMLSelectElement : null;
+  if (selectCtor && element instanceof selectCtor) return true;
+  return ["input", "textarea", "select"].includes(getTagName(element));
+}
+function findEditableControlInShadowRoot(root) {
+  if (!root) return null;
+  if (root.shadowRoot) {
+    const found = root.shadowRoot.querySelector(EDITABLE_CONTROL_SELECTOR);
+    if (found) {
+      return resolveEditableControlElement(found);
+    }
+  }
+  for (const child of Array.from(root.children)) {
+    if (child instanceof HTMLElement) {
+      const found = findEditableControlInShadowRoot(child);
+      if (found) return found;
+    }
+  }
+  return null;
+}
+function resolveEditableControlElement(element) {
+  const labelControl = getLabelControl(element);
+  if (labelControl) {
+    return resolveEditableControlElement(labelControl);
+  }
+  if (isValueBearingElement(element) || element.isContentEditable) {
+    return element;
+  }
+  const role = getRole(element);
+  if (EDITABLE_ROLES.has(role)) {
+    const nested2 = element.querySelector(EDITABLE_CONTROL_SELECTOR);
+    if (nested2 && nested2 !== element) {
+      return resolveEditableControlElement(nested2);
+    }
+    const shadowNested2 = findEditableControlInShadowRoot(element);
+    return shadowNested2 ?? element;
+  }
+  const nested = element.querySelector(EDITABLE_CONTROL_SELECTOR);
+  if (nested) {
+    return resolveEditableControlElement(nested);
+  }
+  const shadowNested = findEditableControlInShadowRoot(element);
+  return shadowNested ?? element;
+}
+function readEditableControlValue(element, options = {}) {
+  const target = resolveEditableControlElement(element);
+  const maskPasswords = options.maskPasswords !== false;
+  if (isValueBearingElement(target)) {
+    const type = String(target.type || "").toLowerCase();
+    if (maskPasswords && type === "password") {
+      return "***";
+    }
+    return String(target.value || "").trim().slice(0, 100);
+  }
+  const genericValue = target.value;
+  if (typeof genericValue === "string") {
+    return genericValue.trim().slice(0, 100);
+  }
+  if (typeof genericValue === "number" && Number.isFinite(genericValue)) {
+    return String(genericValue).trim().slice(0, 100);
+  }
+  if (target.isContentEditable) {
+    return String(target.textContent || "").trim().slice(0, 100);
+  }
+  const ariaValueText = target.getAttribute("aria-valuetext");
+  if (ariaValueText?.trim()) {
+    return ariaValueText.trim().slice(0, 100);
+  }
+  const ariaValueNow = target.getAttribute("aria-valuenow");
+  if (ariaValueNow?.trim()) {
+    return ariaValueNow.trim().slice(0, 100);
+  }
+  return String(target.textContent || "").trim().slice(0, 100);
+}
+function readEditableControlPlaceholder(element) {
+  const target = resolveEditableControlElement(element);
+  if (typeof target.placeholder === "string") {
+    return String(target.placeholder || "").trim().slice(0, 100);
+  }
+  return String(target.getAttribute("placeholder") || "").trim().slice(0, 100);
+}
+function readEditableControlName(element) {
+  const target = resolveEditableControlElement(element);
+  const explicitName = target.name;
+  if (typeof explicitName === "string" && explicitName.trim()) {
+    return explicitName.trim().slice(0, 100);
+  }
+  return String(
+    target.getAttribute("name") || target.getAttribute("id") || target.getAttribute("aria-label") || ""
+  ).trim().slice(0, 100);
+}
+function readEditableControlType(element) {
+  const target = resolveEditableControlElement(element);
+  const role = getRole(target);
+  if (role) return role;
+  const explicitType = target.type;
+  if (typeof explicitType === "string" && explicitType.trim()) {
+    return explicitType.trim().toLowerCase().slice(0, 50);
+  }
+  const attributeType = target.getAttribute("type");
+  if (attributeType?.trim()) {
+    return attributeType.trim().toLowerCase().slice(0, 50);
+  }
+  return getTagName(target);
+}
+function isEditableControlDisabled(element) {
+  const target = resolveEditableControlElement(element);
+  const ariaDisabled = String(target.getAttribute("aria-disabled") || "").toLowerCase();
+  if (ariaDisabled === "true") return true;
+  return Boolean(target.disabled);
+}
+function collectEditableControls(scope) {
+  const seen = /* @__PURE__ */ new Set();
+  const controls = [];
+  for (const rawElement of Array.from(scope.querySelectorAll(EDITABLE_CONTROL_SELECTOR))) {
+    const resolved = resolveEditableControlElement(rawElement);
+    if (seen.has(resolved)) continue;
+    if (isValueBearingElement(resolved) && String(resolved.type || "").toLowerCase() === "hidden") {
+      continue;
+    }
+    seen.add(resolved);
+    controls.push(resolved);
+  }
+  return controls;
+}
+
+// src/utils/aom.ts
+var uidMap = /* @__PURE__ */ new Map();
+var nextUid = 1;
+function generateMinifiedAOM() {
+  uidMap.clear();
+  nextUid = 1;
+  const interactiveSet = /* @__PURE__ */ new Set();
+  const interactiveCandidates = [
+    ...Array.from(document.querySelectorAll(
+      'button, a, input, select, textarea, [role="button"], [role="link"], [role="tab"], [role="menuitem"], [role="option"], [role="textbox"], [role="combobox"], [contenteditable="true"]'
+    )),
+    ...collectEditableControls(document)
+  ];
+  const nodes = [];
+  interactiveCandidates.forEach((candidate) => {
+    const el = resolveEditableControlElement(candidate);
+    if (interactiveSet.has(el)) {
+      return;
+    }
+    interactiveSet.add(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");
+    const value = readEditableControlValue(el, { maskPasswords: false }) || void 0;
+    let role = el.tagName.toLowerCase();
+    if (el.hasAttribute("role")) {
+      role = el.getAttribute("role");
+    } else if (role === "a") {
+      role = "link";
+    } else if (el.tagName.toLowerCase() === "input") {
+      const inputType = el.type;
+      role = inputType ? `input[${inputType}]` : "input";
+    }
+    const node = { uid, role };
+    const displayLabel = ariaLabel || text || placeholder;
+    if (displayLabel) {
+      node.text = displayLabel.substring(0, 100);
+    }
+    const controlName = readEditableControlName(el);
+    if (controlName) {
+      node.name = controlName;
+    }
+    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 {
+  isValueBearingElement,
+  findEditableControlInShadowRoot,
+  resolveEditableControlElement,
+  readEditableControlValue,
+  readEditableControlPlaceholder,
+  readEditableControlName,
+  readEditableControlType,
+  isEditableControlDisabled,
+  collectEditableControls,
+  generateMinifiedAOM,
+  getElementByUid,
+  clearAOMMap
+};

package/dist/chunk-N65UEB6X.mjs

@@ -0,0 +1,70 @@
+// 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 {
+  generateMinifiedAOM,
+  getElementByUid,
+  clearAOMMap
+};

package/dist/dom-sync-L5KIP45X.mjs

@@ -0,0 +1,55 @@
+// 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

@@ -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

@@ -4592,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);
@@ -5955,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,
@@ -5973,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);
@@ -6181,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(
@@ -10273,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";
@@ -10346,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

@@ -3763,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);
@@ -5126,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,
@@ -5144,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);
@@ -5352,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(
@@ -9442,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";
@@ -9515,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.51",
+  "version": "0.5.53",
   "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"
+}