@graineai/inapp-react-native 0.26.0 → 0.26.2

package/INTEGRATION.md

@@ -819,11 +819,18 @@ fourth. The guarantees, so you do not have to think about them:
   applies only to the SDK's own text socket, never to a host's channel.
 - **Ordered.** Every context frame carries a monotonic `seq`; the runtime keeps
   the newest and drops anything that arrives late. The last screen always wins.
-- **Cleanup-safe.** A screen's unmount clears the screen only if it is still
-  the one being described (`client.clearScreen(id)`), so a navigation library
-  unmounting the old screen after the new one mounted cannot erase it.
+- **Cleanup-safe.** The description is re-sent whenever its state changes and
+  withdrawn only on unmount — never on a change (0.26.2; earlier versions sent
+  a screen-less frame before every navigation). The withdrawal clears the
+  screen only if it is still the one being described (`client.clearScreen(id)`),
+  so a navigation library unmounting the old screen after the new one mounted
+  cannot erase it.
 - **Reconnect-safe.** The newest context is replayed whenever the media or the
   screen channel (re)connects.
+- **Self-healing.** The newest screen is re-asserted every few seconds during
+  a call and when the app returns to the foreground, with its original
+  sequence number — so a frame lost in flight is repaired within seconds, not
+  at the next screen change; one that arrived is simply ignored.
 - **Applied every turn.** The runtime puts the last-reported screen on the
   prompt at every generation, so nothing that rewrites the prompt mid-call — a
   language switch, a summary — can make the agent forget where the customer is.
@@ -916,7 +923,7 @@ told to ignore).
 
 | Prop | Type | Notes |
 |---|---|---|
-| `publishableKey` | `string` | Required unless you pass `client`. |
+| `publishableKey` | `string` | Required unless you pass `client`. Selects the agent — one key per agent; there is no `agentId` prop. |
 | `baseUrl` | `string` | Defaults to Graine's host. |
 | `client` | `GraineInAppClient` | Use **your** instance instead of building one. Pass this if your app has a module-level client. |
 | `navigationRef` | `ref` | The same ref you give `NavigationContainer`. Makes the agent screen-aware with no per-screen code. |

package/dist/react-native/index.js

@@ -346,8 +346,12 @@ export function useGraineScreen(context) {
     const serialised = JSON.stringify(context ?? null);
     useEffect(() => {
         client.setScreen(context);
-        return () => client.clearScreen(context?.screen);
     }, [client, serialised]);
+    const reported = useRef(context?.screen);
+    reported.current = context?.screen;
+    useEffect(() => () => {
+        client.clearScreen(reported.current);
+    }, [client]);
 }
 export function useGraineField(name, field) {
     const client = useGraineClient();

package/dist/react-native/voice-launcher.js

@@ -192,6 +192,7 @@ export function GraineVoiceLauncher({ webView: WebView, autoStart = false, trans
                     clearTimeout(pending);
                     pending = null;
                 }
+                pushContext();
                 return;
             }
             if (next === "background" && wasActive && !pending) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graineai/inapp-react-native",
-  "version": "0.26.0",
+  "version": "0.26.2",
   "type": "module",
   "description": "Graine in-app agent for React Native — an agent that sees the screen your customer is on and can act on it.",
   "license": "MIT",