@novoagents/react 0.2.0-alpha.0 → 0.2.0-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.2.0-alpha.1 - 2026-07-14
+
+- `useNovoRun` normalizes `enabled` and `runKey` before its dependency arrays,
+  so identity toggles (`enabled: undefined <-> true`, `runKey: undefined <->
+  null`) no longer dispose and recreate a live controller.
+- Picks up `novoagents` 0.4.0-alpha.1 controller fixes: fatal (non-retried)
+  initial-connect errors, per-drop `transportError` publication, a final
+  `disposed` snapshot published before listeners detach, and interaction-race
+  hardening.
+
 ## 0.2.0-alpha.0 - 2026-07-14
 
 - Replaced the alpha store/transport hooks with effect-owned bindings over the

package/dist/useNovoRun.js

@@ -54,34 +54,38 @@ export function useNovoRun(options) {
     slotRef.current ??= createControllerSlot();
     const slot = slotRef.current;
     const ownedRunKeyRef = useRef(UNOWNED_RUN_KEY);
+    // Normalize before any dependency array: `enabled: undefined <-> true` and
+    // `runKey: undefined <-> null` toggles are identity changes and must not
+    // dispose and recreate a live controller.
+    const enabled = options.enabled !== false;
+    const runKey = options.runKey ?? null;
     useEffect(() => {
-        if (options.enabled === false) {
+        if (!enabled) {
             slot.setController(undefined);
             return;
         }
         const controller = factoryRef.current();
-        ownedRunKeyRef.current = options.runKey ?? null;
+        ownedRunKeyRef.current = runKey;
         slot.setController(controller);
         return () => {
             controller.stop();
             controller.dispose();
-            if (ownedRunKeyRef.current === (options.runKey ?? null)) {
+            if (ownedRunKeyRef.current === runKey) {
                 ownedRunKeyRef.current = UNOWNED_RUN_KEY;
             }
             if (slot.getController() === controller)
                 slot.setController(undefined);
         };
-    }, [options.enabled, options.runKey, slot]);
+    }, [enabled, runKey, slot]);
     useEffect(() => {
-        if (options.enabled !== false &&
+        if (enabled &&
             options.autoStart !== false &&
-            ownedRunKeyRef.current === (options.runKey ?? null)) {
+            ownedRunKeyRef.current === runKey) {
             void slot.getController()?.start();
         }
-    }, [options.autoStart, options.enabled, options.runKey, slot]);
+    }, [options.autoStart, enabled, runKey, slot]);
     const observedState = useSyncExternalStore(slot.subscribe, slot.getSnapshot, () => NOVO_IDLE_RUN_STATE);
-    const ownsRenderedKey = options.enabled !== false &&
-        ownedRunKeyRef.current === (options.runKey ?? null);
+    const ownsRenderedKey = enabled && ownedRunKeyRef.current === runKey;
     const state = ownsRenderedKey
         ? observedState
         : NOVO_IDLE_RUN_STATE;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@novoagents/react",
-  "version": "0.2.0-alpha.0",
+  "version": "0.2.0-alpha.1",
   "description": "Browser-safe React hooks for Novo Agents streams and interactions.",
   "license": "UNLICENSED",
   "type": "module",
@@ -23,7 +23,7 @@
     "access": "public"
   },
   "dependencies": {
-    "novoagents": "0.4.0-alpha.0"
+    "novoagents": "0.4.0-alpha.1"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"