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

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## Unreleased
+
+## 0.2.0-alpha.2 - 2026-07-15
+
+- Updates the packed `novoagents` dependency to 0.4.0-alpha.2, so React run
+  hooks consume targeted `data-novo-model-step-restart` retractions through the
+  canonical browser controller.
+
+## 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/README.md

@@ -5,6 +5,10 @@ Headless React bindings for the canonical browser run controller in
 accepts a Novo API key. Browser requests go only to your authenticated proxy
 routes.
 
+```sh
+npm install novoagents@alpha @novoagents/react@alpha
+```
+
 ```tsx
 'use client';
 
@@ -60,5 +64,6 @@ There are no compatibility aliases for the alpha API.
 
 ## Publishing
 
-Publish with `pnpm publish`: pnpm rewrites the `workspace:*` dependency on
-`novoagents` to the packed version.
+After publishing `novoagents`, publish with
+`pnpm publish --access public --tag alpha`: pnpm rewrites the `workspace:*`
+dependency on `novoagents` to the packed version.

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.2",
   "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.2"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"
@@ -41,7 +41,8 @@
   "scripts": {
     "build": "tsc -p tsconfig.json && node scripts/check-dist.mjs",
     "clean": "rm -rf dist",
-    "test": "vitest run",
+    "test": "vitest run && pnpm run test:react18",
+    "test:react18": "node scripts/test-react18.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   }
 }