react-native-agentic-ai 0.5.3 → 0.5.5

package/README.md

@@ -34,8 +34,6 @@ Wrap your navigation with `<AIAgent>`. The AI automatically understands your ent
 ### 🎤 Voice Mode (Live Agent)
 - 🗣️ **Real-time voice chat** — Bidirectional audio with Gemini Live API. Speak naturally, the agent responds with voice.
 - 🔄 **Screen change detection** — The agent automatically detects when the screen changes (e.g., loading finishes) and updates its context — no polling tool needed.
-- 🛡️ **Tool-first protocol** — Tool calls are emitted before speech to prevent server crashes (Gemini Live API limitation).
-- 🔇 **Audio gating** — Mic is automatically paused during tool execution and resumed after, preventing race conditions.
 - 🚫 **Auto-navigation guard** — Code-level gate rejects tool calls before the user speaks, preventing the model from acting on screen context alone.
 
 ### Security & Production
@@ -172,12 +170,35 @@ import { useAction } from '@mobileai/react-native';
 // or: import { useAction } from 'react-native-agentic-ai';
 
 function CartScreen() {
-  const { clearCart, getTotal } = useCart();
+  const { cart, clearCart, getTotal } = useCart();
 
-  useAction('checkout', 'Place the order', {}, async () => {
+  // 'checkout' = tool name the AI calls, description = how the AI decides when to use it
+  useAction('checkout', 'Place the order and checkout', {}, async () => {
+    // Guard: return early with a failure message so the AI knows why
+    if (cart.length === 0) {
+      return { success: false, message: 'Cart is empty' };
+    }
     const total = getTotal();
-    clearCart();
-    return { success: true, message: `Order placed! Total: $${total}` };
+
+    // Human-in-the-loop: the AI's execution pauses here until the user taps Confirm/Cancel.
+    // This is how you prevent the AI from performing critical actions without explicit approval.
+    return new Promise((resolve) => {
+      Alert.alert(
+        'Confirm Order by AI',
+        `Do you want the AI to place your order for $${total}?`,
+        [
+          { text: 'Cancel', style: 'cancel',
+            onPress: () => resolve({ success: false, message: 'User denied the checkout.' }) },
+          { text: 'Confirm', style: 'default',
+            onPress: () => {
+              clearCart();
+              // Return success: true so the AI knows the action completed
+              resolve({ success: true, message: `Order placed! Total: $${total}` });
+            }
+          },
+        ]
+      );
+    });
   });
 }
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-agentic-ai",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "description": "Build autonomous AI agents for React Native and Expo apps. Provides AI-native UI traversal, tool calling, and structured reasoning.",
   "main": "./lib/module/index.js",
   "source": "./src/index.ts",