@modelnex/sdk 0.5.28 → 0.5.30

package/README.md

@@ -86,7 +86,6 @@ Current behavior:
 | `serverUrl` | Backend base URL for chat, tags, tours, voice, and recording APIs |
 | `websiteId` | Tenant/integration identifier |
 | `userProfile` | End-user targeting data for tours/workflows |
-| `devMode` | Enables recording/studio tooling for your internal users |
 
 ## Chat Bubble Props
 
@@ -115,10 +114,7 @@ export function AppShell({ children, currentUser }) {
   return (
     <ModelNexProvider
       websiteId="prod_site_123"
-      
-      // Development setup
-      devMode={process.env.NODE_ENV === 'development'}
-      
+
       // User Targeting for Tours & Workflows
       userProfile={{
         userId: currentUser.id,
@@ -132,6 +128,16 @@ export function AppShell({ children, currentUser }) {
 }
 ```
 
+### Browser-Injected Dev Mode
+
+```html
+<script>
+  window.__MODELNEX_DEV_MODE_KEY__ = 'dmk_live_xxxxxxxxx';
+</script>
+```
+
+The SDK now enables dev tooling only after it finds a browser-injected dev mode key and validates it with the backend for the current `websiteId`.
+
 ### Themed Chat Bubble
 
 ```tsx

package/dist/dom-sync-GABDEODR.mjs

@@ -0,0 +1,54 @@
+// 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();
+        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

@@ -284,7 +284,7 @@ declare function extractInteractiveElements(): ExtractedElement[];
  * Hook that automatically extracts all interactive DOM elements and keeps
  * the list up-to-date via MutationObserver (debounced at 500ms).
  */
-declare function useAutoExtract(): ExtractedElement[];
+declare function useAutoExtract(devMode?: boolean): ExtractedElement[];
 
 /**
  * Tag store for human-in-the-loop tagging.
@@ -346,10 +346,10 @@ interface AgentTraceLlmInput {
 /** Single step in agent execution trace */
 interface AgentTraceStep {
     step: number;
-    /** Chain-of-thought reasoning from the agent */
+    /** Internal reasoning is intentionally stripped from customer-visible traces */
     reasoning?: string;
     llmInput?: AgentTraceLlmInput;
-    llmOutput: string;
+    llmOutput?: string;
     actions: Array<{
         actionId: string;
         params?: Record<string, unknown>;
@@ -361,7 +361,7 @@ interface AgentTraceStep {
         error?: string;
     }>;
 }
-/** Debug payload from /agent/command */
+/** Sanitized debug payload from /agent/command */
 interface AgentDebug {
     actions?: Array<{
         actionId: string;
@@ -845,10 +845,6 @@ interface ModelNexProviderProps {
      * Same-origin base for tour API (avoids CORS for ?modelnex_test_tour=)
      */
     toursApiBase?: string;
-    /**
-     * Enable SDK dev tools unconditionally (tour recording, studio mode)
-     */
-    devMode?: boolean;
 }
 declare const ModelNexProvider: React$1.FC<ModelNexProviderProps>;
 

package/dist/index.d.ts

@@ -284,7 +284,7 @@ declare function extractInteractiveElements(): ExtractedElement[];
  * Hook that automatically extracts all interactive DOM elements and keeps
  * the list up-to-date via MutationObserver (debounced at 500ms).
  */
-declare function useAutoExtract(): ExtractedElement[];
+declare function useAutoExtract(devMode?: boolean): ExtractedElement[];
 
 /**
  * Tag store for human-in-the-loop tagging.
@@ -346,10 +346,10 @@ interface AgentTraceLlmInput {
 /** Single step in agent execution trace */
 interface AgentTraceStep {
     step: number;
-    /** Chain-of-thought reasoning from the agent */
+    /** Internal reasoning is intentionally stripped from customer-visible traces */
     reasoning?: string;
     llmInput?: AgentTraceLlmInput;
-    llmOutput: string;
+    llmOutput?: string;
     actions: Array<{
         actionId: string;
         params?: Record<string, unknown>;
@@ -361,7 +361,7 @@ interface AgentTraceStep {
         error?: string;
     }>;
 }
-/** Debug payload from /agent/command */
+/** Sanitized debug payload from /agent/command */
 interface AgentDebug {
     actions?: Array<{
         actionId: string;
@@ -845,10 +845,6 @@ interface ModelNexProviderProps {
      * Same-origin base for tour API (avoids CORS for ?modelnex_test_tour=)
      */
     toursApiBase?: string;
-    /**
-     * Enable SDK dev tools unconditionally (tour recording, studio mode)
-     */
-    devMode?: boolean;
 }
 declare const ModelNexProvider: React$1.FC<ModelNexProviderProps>;