@modelnex/sdk 0.1.1

package/README.md

@@ -0,0 +1,66 @@
+# @modelnex/sdk
+
+React SDK for natural language control of web apps. Register actions and context; an AI agent executes actions in response to user commands.
+
+## Install
+
+```bash
+npm install @modelnex/sdk react zod
+```
+
+## Quick Start
+
+```tsx
+import { ModelNexProvider, ModelNexChatBubble } from "@modelnex/sdk";
+
+function App() {
+  const [items, setItems] = React.useState([]);
+
+  return (
+    <div>
+      <ModelNexChatBubble placeholder="Add item, list all..." />
+      <ul>{items.map(i => <li key={i.id}>{i.title}</li>)}</ul>
+    </div>
+  );
+}
+
+// Wrap your app (serverUrl defaults to http://localhost:3002)
+export default () => (
+  <ModelNexProvider>
+    <App />
+  </ModelNexProvider>
+);
+```
+
+## Exports
+
+| Export | Purpose |
+|--------|---------|
+| `ModelNexProvider` | Wraps app, connects to agent server |
+| `useRunCommand` | Run commands programmatically (for custom UI) |
+| `UIStateProvider` | Holds UI state synced to agent |
+| `useUIState` | Read/update UI state |
+| `useViewportTrack` | Track element visibility |
+| `useVisibleIds` | Get visible element IDs |
+| `useAgentViewport` | Register visible IDs with agent |
+| `ModelNexChatBubble` | Optional chat bubble UI |
+
+## Custom UI
+
+Use `useRunCommand` instead of `ModelNexChatBubble` for your own command UI:
+
+```tsx
+const runCommand = useRunCommand();
+
+<button onClick={() => runCommand("Add a new card")}>Run</button>
+```
+
+
+## Peer Dependencies
+
+- `react` >= 17
+- `zod` >= 3
+
+## License
+
+MIT

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/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
+};