@modelnex/sdk 0.5.53 → 0.5.55

package/dist/index.js

@@ -4643,6 +4643,13 @@ function useTourPlayback({
       const ownerKey = createTourPlaybackOwnerKey(serverUrl, websiteIdRef.current, experienceTypeRef.current);
       if (!shouldExecuteTourCommandBatch(isActiveRef.current) || !hasTourPlaybackOwnership(ownerKey, playbackOwnerIdRef.current)) {
         const activeType = experienceTypeRef.current;
+        console.warn("[TourClient] Dropping command batch: playback not active or ownership not held", {
+          isActive: isActiveRef.current,
+          hasOwnership: hasTourPlaybackOwnership(ownerKey, playbackOwnerIdRef.current),
+          experienceType: activeType,
+          stepIndex: payload.stepIndex,
+          commandBatchId: payload.commandBatchId ?? null
+        });
         emitSdkDebugLog("[TourClient] Ignoring command batch for inactive playback hook", {
           experienceType: activeType,
           stepIndex: payload.stepIndex
@@ -5258,10 +5265,13 @@ function useTourPlayback({
       }
       const tour = tourData.tourContext ?? tourRef.current;
       const expType = experienceTypeRef.current;
-      if (tour?.type && tour.type !== expType) {
+      const matchesType = !tour?.type || tour.type === expType;
+      const isCompatibleResumption = !!tourData.resumed && (expType === "onboarding" && tour?.type === "tour" || expType === "tour" && tour?.type === "onboarding");
+      if (!matchesType && !isCompatibleResumption) {
         emitSdkDebugLog("[TourClient] Ignoring tour start for mismatched experience type", {
-          incomingType: tour.type,
-          hookType: expType
+          incomingType: tour?.type,
+          hookType: expType,
+          resumed: tourData.resumed
         }, { devMode: devModeRef.current });
         return;
       }
@@ -5373,6 +5383,9 @@ function useTourPlayback({
     socket.on("tour:end", handleTourEndEvent);
     socket.on("tour:debug_log", handleDebugLog);
     emitSdkDebugLog("[ModelNex SDK] Tour playback initialized", void 0, { devMode: devModeRef.current });
+    if (socket.connected) {
+      handleConnect();
+    }
     return () => {
       socket.off("connect", handleConnect);
       socket.off("tour:server_state", handleServerState);

package/dist/index.mjs

@@ -3814,6 +3814,13 @@ function useTourPlayback({
       const ownerKey = createTourPlaybackOwnerKey(serverUrl, websiteIdRef.current, experienceTypeRef.current);
       if (!shouldExecuteTourCommandBatch(isActiveRef.current) || !hasTourPlaybackOwnership(ownerKey, playbackOwnerIdRef.current)) {
         const activeType = experienceTypeRef.current;
+        console.warn("[TourClient] Dropping command batch: playback not active or ownership not held", {
+          isActive: isActiveRef.current,
+          hasOwnership: hasTourPlaybackOwnership(ownerKey, playbackOwnerIdRef.current),
+          experienceType: activeType,
+          stepIndex: payload.stepIndex,
+          commandBatchId: payload.commandBatchId ?? null
+        });
         emitSdkDebugLog("[TourClient] Ignoring command batch for inactive playback hook", {
           experienceType: activeType,
           stepIndex: payload.stepIndex
@@ -4429,10 +4436,13 @@ function useTourPlayback({
       }
       const tour = tourData.tourContext ?? tourRef.current;
       const expType = experienceTypeRef.current;
-      if (tour?.type && tour.type !== expType) {
+      const matchesType = !tour?.type || tour.type === expType;
+      const isCompatibleResumption = !!tourData.resumed && (expType === "onboarding" && tour?.type === "tour" || expType === "tour" && tour?.type === "onboarding");
+      if (!matchesType && !isCompatibleResumption) {
         emitSdkDebugLog("[TourClient] Ignoring tour start for mismatched experience type", {
-          incomingType: tour.type,
-          hookType: expType
+          incomingType: tour?.type,
+          hookType: expType,
+          resumed: tourData.resumed
         }, { devMode: devModeRef.current });
         return;
       }
@@ -4544,6 +4554,9 @@ function useTourPlayback({
     socket.on("tour:end", handleTourEndEvent);
     socket.on("tour:debug_log", handleDebugLog);
     emitSdkDebugLog("[ModelNex SDK] Tour playback initialized", void 0, { devMode: devModeRef.current });
+    if (socket.connected) {
+      handleConnect();
+    }
     return () => {
       socket.off("connect", handleConnect);
       socket.off("tour:server_state", handleServerState);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelnex/sdk",
-  "version": "0.5.53",
+  "version": "0.5.55",
   "description": "React SDK for natural language control of web apps via AI agents",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -20,15 +20,6 @@
     "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",
@@ -67,5 +58,13 @@
   "bugs": {
     "url": "https://github.com/sharunaraksha/modelnex-sdk/issues"
   },
-  "homepage": "https://github.com/sharunaraksha/modelnex-sdk#readme"
-}
+  "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"
+  }
+}

package/dist/aom-HDYNCIOY.mjs

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

package/dist/aom-LJNCLNXL.mjs

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

package/dist/chunk-H4LUY7LI.mjs

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

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

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