@mobileai/react-native 0.1.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 Mohamed Salah
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,190 @@
+# @mobileai/react-native
+
+> **Autonomous AI agent for React Native** — Your app gets an AI copilot that can see, understand, and interact with your UI. Zero wrappers, zero view rewriting.
+
+[![npm](https://img.shields.io/npm/v/@mobileai/react-native)](https://www.npmjs.com/package/@mobileai/react-native)
+[![license](https://img.shields.io/npm/l/@mobileai/react-native)](https://github.com/mohamed2m2018/react-native-ai-agent/blob/main/LICENSE)
+[![platform](https://img.shields.io/badge/platform-iOS%20%7C%20Android-brightgreen)]()
+
+Wrap your navigation with `<AIAgent>`. The AI automatically understands your entire screen — every button, every input, every label — and acts on it.
+
+## ✨ Features
+
+- 🤖 **Zero-config UI understanding** — No need to annotate your views. The AI reads your UI automatically.
+- 🧭 **Auto-navigation** — Navigates between screens to complete multi-step tasks.
+- 🔒 **Production-grade security** — Element gating, content masking, lifecycle hooks, human-in-the-loop confirmation.
+- 🧩 **Custom actions** — Expose any business logic (checkout, API calls) as AI-callable tools with `useAction`.
+- 🌐 **MCP bridge** — Let external AI agents (OpenClaw, Claude Desktop) control your app remotely.
+- 🌍 **Bilingual** — English and Arabic support built-in.
+
+## 📦 Installation
+
+```bash
+npm install @mobileai/react-native
+```
+
+No native modules required. Works with Expo managed workflow out of the box — **no eject needed**.
+
+## 🚀 Quick Start
+
+```tsx
+import { AIAgent } from '@mobileai/react-native';
+import { NavigationContainer, useNavigationContainerRef } from '@react-navigation/native';
+
+export default function App() {
+  const navRef = useNavigationContainerRef();
+
+  return (
+    <AIAgent apiKey="YOUR_GEMINI_API_KEY" navRef={navRef}>
+      <NavigationContainer ref={navRef}>
+        {/* Your existing screens — zero changes needed */}
+      </NavigationContainer>
+    </AIAgent>
+  );
+}
+```
+
+A floating chat bar appears automatically. Ask the AI to navigate, tap buttons, fill forms — it reads your live UI and acts.
+
+## 🔌 API Reference
+
+### `<AIAgent>` Component
+
+The root provider. Wrap your app once at the top level.
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `apiKey` | `string` | — | **Required.** Gemini API key. |
+| `model` | `string` | `'gemini-2.5-flash'` | Gemini model name. |
+| `navRef` | `NavigationContainerRef` | — | Navigation ref for auto-navigation. |
+| `language` | `'en' \| 'ar'` | `'en'` | UI language. |
+| `maxSteps` | `number` | `10` | Max steps per task. |
+| `showChatBar` | `boolean` | `true` | Show the floating chat bar. |
+| `onResult` | `(result) => void` | — | Called when the agent finishes. |
+
+### `useAction(name, description, params, handler)`
+
+Register a **non-UI action** the AI can call — for business logic that isn't a visible button.
+
+```tsx
+import { useAction } from '@mobileai/react-native';
+
+function CartScreen() {
+  const { clearCart, getTotal } = useCart();
+
+  useAction('checkout', 'Place the order', {}, async () => {
+    const total = getTotal();
+    clearCart();
+    return { success: true, message: `Order placed! Total: $${total}` };
+  });
+}
+```
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `name` | `string` | Unique action name. |
+| `description` | `string` | Natural language description for the AI. |
+| `parameters` | `Record<string, string>` | Parameter schema (e.g., `{ itemName: 'string' }`). |
+| `handler` | `(args) => any` | Execution handler. Can be sync or async. |
+
+## 🔒 Security
+
+### Element Gating
+
+Hide specific elements from the AI:
+
+```tsx
+// Per-element: add aiIgnore prop
+<Pressable aiIgnore={true} onPress={handleAdmin}>
+  <Text>Admin Panel</Text>
+</Pressable>
+
+// Per-ref: blacklist by reference
+const secretRef = useRef(null);
+<AIAgent interactiveBlacklist={[secretRef]}>
+  <Pressable ref={secretRef}>Hidden from AI</Pressable>
+</AIAgent>
+```
+
+### Content Masking
+
+Sanitize sensitive data before the LLM sees it:
+
+```tsx
+<AIAgent
+  transformScreenContent={(content) =>
+    content.replace(/\b\d{13,16}\b/g, '****-****-****-****')
+  }
+/>
+```
+
+### Screen-Specific Instructions
+
+Guide the AI's behavior on sensitive screens:
+
+```tsx
+<AIAgent
+  instructions={{
+    system: 'You are a food delivery assistant.',
+    getScreenInstructions: (screenName) => {
+      if (screenName === 'Cart') {
+        return 'Always confirm the total with the user before checkout.';
+      }
+    },
+  }}
+/>
+```
+
+### Human-in-the-Loop
+
+Force native confirmation before critical actions:
+
+```tsx
+useAction('checkout', 'Place the order', {}, () => {
+  return new Promise((resolve) => {
+    Alert.alert('Confirm?', 'Place this order?', [
+      { text: 'Cancel', onPress: () => resolve({ success: false }) },
+      { text: 'Yes', onPress: () => resolve({ success: true }) },
+    ]);
+  });
+});
+```
+
+### Lifecycle Hooks
+
+| Prop | Description |
+|------|-------------|
+| `onBeforeStep` | Called before each agent step. |
+| `onAfterStep` | Called after each step with full history. |
+| `onBeforeTask` | Called before task execution starts. |
+| `onAfterTask` | Called after task completes. |
+
+## 🌐 MCP Bridge
+
+Connect external AI agents to your app via the Model Context Protocol:
+
+```tsx
+<AIAgent apiKey="..." mcpServerUrl="ws://localhost:3101" />
+```
+
+See the `mcp-server/` directory for the companion Node.js server setup.
+
+## 🛠️ Built-in Tools
+
+| Tool | Description |
+|------|-------------|
+| `tap(index)` | Tap an interactive element. |
+| `type(index, text)` | Type text into an input. |
+| `navigate(screen)` | Navigate to a screen. |
+| `done(text)` | Complete the task. |
+| `ask_user(question)` | Ask the user for clarification. |
+
+## 📋 Requirements
+
+- React Native 0.72+
+- Expo SDK 49+ (or bare React Native)
+- Gemini API key — [Get one free](https://aistudio.google.com/apikey)
+
+## 📄 License
+
+MIT © [Mohamed Salah](https://github.com/mohamed2m2018)

package/lib/module/components/AIAgent.js

@@ -0,0 +1,149 @@
+"use strict";
+
+/**
+ * AIAgent — Root provider component for the AI agent.
+ *
+ * Wraps the app and provides:
+ * - Fiber tree root ref for element auto-detection
+ * - Navigation ref for auto-navigation
+ * - Floating chat bar for user input
+ * - Agent runtime context for useAction hooks
+ */
+
+import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { View, StyleSheet } from 'react-native';
+import { AgentRuntime } from "../core/AgentRuntime.js";
+import { GeminiProvider } from "../providers/GeminiProvider.js";
+import { AgentContext } from "../hooks/useAction.js";
+import { AgentChatBar } from "./AgentChatBar.js";
+import { AgentOverlay } from "./AgentOverlay.js";
+import { logger } from "../utils/logger.js";
+import { MCPBridge } from "../core/MCPBridge.js";
+
+// ─── Context ───────────────────────────────────────────────────
+
+// ─── Props ─────────────────────────────────────────────────────
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// ─── Component ─────────────────────────────────────────────────
+
+export function AIAgent({
+  apiKey,
+  model = 'gemini-2.5-flash',
+  navRef,
+  language = 'en',
+  maxSteps = 10,
+  showChatBar = true,
+  children,
+  onResult,
+  // Security props
+  interactiveBlacklist,
+  interactiveWhitelist,
+  onBeforeStep,
+  onAfterStep,
+  onBeforeTask,
+  onAfterTask,
+  transformScreenContent,
+  customTools,
+  instructions,
+  stepDelay,
+  mcpServerUrl
+}) {
+  const rootViewRef = useRef(null);
+  const [isThinking, setIsThinking] = useState(false);
+  const [statusText, setStatusText] = useState('');
+  const [lastResult, setLastResult] = useState(null);
+
+  // ─── Create Runtime ──────────────────────────────────────────
+
+  const config = useMemo(() => ({
+    apiKey,
+    model,
+    language,
+    maxSteps,
+    interactiveBlacklist,
+    interactiveWhitelist,
+    onBeforeStep,
+    onAfterStep,
+    onBeforeTask,
+    onAfterTask,
+    transformScreenContent,
+    customTools,
+    instructions,
+    stepDelay,
+    mcpServerUrl
+  }), [apiKey, model, language, maxSteps, interactiveBlacklist, interactiveWhitelist, onBeforeStep, onAfterStep, onBeforeTask, onAfterTask, transformScreenContent, customTools, instructions, stepDelay, mcpServerUrl]);
+  const provider = useMemo(() => new GeminiProvider(apiKey, model), [apiKey, model]);
+  const runtime = useMemo(() => new AgentRuntime(provider, config, rootViewRef.current, navRef),
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  [provider, config]);
+
+  // Update refs when they change
+  useEffect(() => {
+    runtime.updateRefs(rootViewRef.current, navRef);
+  }, [runtime, navRef]);
+
+  // ─── MCP Bridge ──────────────────────────────────────────────
+
+  useEffect(() => {
+    if (!mcpServerUrl) return;
+    logger.info('AIAgent', `Setting up MCP bridge at ${mcpServerUrl}`);
+    const bridge = new MCPBridge(mcpServerUrl, runtime);
+    return () => {
+      bridge.destroy();
+    };
+  }, [mcpServerUrl, runtime]);
+
+  // ─── Execute ──────────────────────────────────────────────────
+
+  const handleSend = useCallback(async message => {
+    if (!message.trim()) return;
+    logger.info('AIAgent', `User message: "${message}"`);
+    setIsThinking(true);
+    setStatusText('Thinking...');
+    setLastResult(null);
+    try {
+      // Ensure we have the latest Fiber tree ref
+      runtime.updateRefs(rootViewRef.current, navRef);
+      const result = await runtime.execute(message);
+      setLastResult(result);
+      onResult?.(result);
+      logger.info('AIAgent', `Result: ${result.success ? '✅' : '❌'} ${result.message}`);
+    } catch (error) {
+      logger.error('AIAgent', 'Execution failed:', error);
+      setLastResult({
+        success: false,
+        message: `Error: ${error.message}`,
+        steps: []
+      });
+    } finally {
+      setIsThinking(false);
+      setStatusText('');
+    }
+  }, [runtime, navRef, onResult]);
+
+  // ─── Render ──────────────────────────────────────────────────
+
+  return /*#__PURE__*/_jsxs(AgentContext.Provider, {
+    value: runtime,
+    children: [/*#__PURE__*/_jsx(View, {
+      ref: rootViewRef,
+      style: styles.root,
+      collapsable: false,
+      children: children
+    }), /*#__PURE__*/_jsx(AgentOverlay, {
+      visible: isThinking,
+      statusText: statusText
+    }), showChatBar && /*#__PURE__*/_jsx(AgentChatBar, {
+      onSend: handleSend,
+      isThinking: isThinking,
+      lastResult: lastResult,
+      language: language
+    })]
+  });
+}
+const styles = StyleSheet.create({
+  root: {
+    flex: 1
+  }
+});
+//# sourceMappingURL=AIAgent.js.map

package/lib/module/components/AIAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","useCallback","useEffect","useMemo","useRef","useState","View","StyleSheet","AgentRuntime","GeminiProvider","AgentContext","AgentChatBar","AgentOverlay","logger","MCPBridge","jsx","_jsx","jsxs","_jsxs","AIAgent","apiKey","model","navRef","language","maxSteps","showChatBar","children","onResult","interactiveBlacklist","interactiveWhitelist","onBeforeStep","onAfterStep","onBeforeTask","onAfterTask","transformScreenContent","customTools","instructions","stepDelay","mcpServerUrl","rootViewRef","isThinking","setIsThinking","statusText","setStatusText","lastResult","setLastResult","config","provider","runtime","current","updateRefs","info","bridge","destroy","handleSend","message","trim","result","execute","success","error","steps","Provider","value","ref","style","styles","root","collapsable","visible","onSend","create","flex"],"sourceRoot":"../../../src","sources":["components/AIAgent.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/components/AgentChatBar.js

@@ -0,0 +1,120 @@
+"use strict";
+
+/**
+ * AgentChatBar — Floating chat input at the bottom of the screen.
+ * User sends messages here, and results are shown inline.
+ */
+
+import { useState } from 'react';
+import { View, TextInput, Pressable, Text, StyleSheet, KeyboardAvoidingView, Platform } from 'react-native';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function AgentChatBar({
+  onSend,
+  isThinking,
+  lastResult,
+  language
+}) {
+  const [text, setText] = useState('');
+  const isArabic = language === 'ar';
+  const handleSend = () => {
+    if (text.trim() && !isThinking) {
+      onSend(text.trim());
+      setText('');
+    }
+  };
+  return /*#__PURE__*/_jsxs(KeyboardAvoidingView, {
+    behavior: Platform.OS === 'ios' ? 'padding' : undefined,
+    style: styles.container,
+    children: [lastResult && /*#__PURE__*/_jsx(View, {
+      style: [styles.resultBubble, lastResult.success ? styles.resultSuccess : styles.resultError],
+      children: /*#__PURE__*/_jsx(Text, {
+        style: styles.resultText,
+        children: lastResult.message
+      })
+    }), /*#__PURE__*/_jsxs(View, {
+      style: styles.inputRow,
+      children: [/*#__PURE__*/_jsx(TextInput, {
+        style: [styles.input, isArabic && styles.inputRTL],
+        placeholder: isArabic ? 'اكتب طلبك...' : 'Ask the AI agent...',
+        placeholderTextColor: "#999",
+        value: text,
+        onChangeText: setText,
+        onSubmitEditing: handleSend,
+        returnKeyType: "send",
+        editable: !isThinking,
+        multiline: false
+      }), /*#__PURE__*/_jsx(Pressable, {
+        style: [styles.sendButton, isThinking && styles.sendButtonDisabled],
+        onPress: handleSend,
+        disabled: isThinking || !text.trim(),
+        children: /*#__PURE__*/_jsx(Text, {
+          style: styles.sendButtonText,
+          children: isThinking ? '⏳' : '🚀'
+        })
+      })]
+    })]
+  });
+}
+const styles = StyleSheet.create({
+  container: {
+    position: 'absolute',
+    bottom: 0,
+    left: 0,
+    right: 0,
+    paddingHorizontal: 12,
+    paddingBottom: Platform.OS === 'ios' ? 34 : 12,
+    paddingTop: 8,
+    backgroundColor: 'rgba(26, 26, 46, 0.95)',
+    borderTopLeftRadius: 20,
+    borderTopRightRadius: 20
+  },
+  resultBubble: {
+    borderRadius: 12,
+    padding: 12,
+    marginBottom: 8
+  },
+  resultSuccess: {
+    backgroundColor: 'rgba(40, 167, 69, 0.2)'
+  },
+  resultError: {
+    backgroundColor: 'rgba(220, 53, 69, 0.2)'
+  },
+  resultText: {
+    color: '#fff',
+    fontSize: 14,
+    lineHeight: 20
+  },
+  inputRow: {
+    flexDirection: 'row',
+    alignItems: 'center',
+    gap: 8
+  },
+  input: {
+    flex: 1,
+    backgroundColor: 'rgba(255, 255, 255, 0.1)',
+    borderRadius: 24,
+    paddingHorizontal: 16,
+    paddingVertical: 12,
+    color: '#fff',
+    fontSize: 16
+  },
+  inputRTL: {
+    textAlign: 'right',
+    writingDirection: 'rtl'
+  },
+  sendButton: {
+    width: 44,
+    height: 44,
+    borderRadius: 22,
+    backgroundColor: 'rgba(255, 255, 255, 0.15)',
+    justifyContent: 'center',
+    alignItems: 'center'
+  },
+  sendButtonDisabled: {
+    opacity: 0.5
+  },
+  sendButtonText: {
+    fontSize: 20
+  }
+});
+//# sourceMappingURL=AgentChatBar.js.map

package/lib/module/components/AgentChatBar.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useState","View","TextInput","Pressable","Text","StyleSheet","KeyboardAvoidingView","Platform","jsx","_jsx","jsxs","_jsxs","AgentChatBar","onSend","isThinking","lastResult","language","text","setText","isArabic","handleSend","trim","behavior","OS","undefined","style","styles","container","children","resultBubble","success","resultSuccess","resultError","resultText","message","inputRow","input","inputRTL","placeholder","placeholderTextColor","value","onChangeText","onSubmitEditing","returnKeyType","editable","multiline","sendButton","sendButtonDisabled","onPress","disabled","sendButtonText","create","position","bottom","left","right","paddingHorizontal","paddingBottom","paddingTop","backgroundColor","borderTopLeftRadius","borderTopRightRadius","borderRadius","padding","marginBottom","color","fontSize","lineHeight","flexDirection","alignItems","gap","flex","paddingVertical","textAlign","writingDirection","width","height","justifyContent","opacity"],"sourceRoot":"../../../src","sources":["components/AgentChatBar.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/components/AgentOverlay.js

@@ -0,0 +1,53 @@
+"use strict";
+
+/**
+ * AgentOverlay — Subtle thinking indicator shown while the AI agent is processing.
+ */
+
+import { View, Text, StyleSheet, ActivityIndicator } from 'react-native';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function AgentOverlay({
+  visible,
+  statusText
+}) {
+  if (!visible) return null;
+  return /*#__PURE__*/_jsx(View, {
+    style: styles.overlay,
+    pointerEvents: "none",
+    children: /*#__PURE__*/_jsxs(View, {
+      style: styles.pill,
+      children: [/*#__PURE__*/_jsx(ActivityIndicator, {
+        size: "small",
+        color: "#fff"
+      }), /*#__PURE__*/_jsx(Text, {
+        style: styles.text,
+        children: statusText || 'Thinking...'
+      })]
+    })
+  });
+}
+const styles = StyleSheet.create({
+  overlay: {
+    position: 'absolute',
+    top: 60,
+    left: 0,
+    right: 0,
+    alignItems: 'center',
+    zIndex: 9999
+  },
+  pill: {
+    flexDirection: 'row',
+    alignItems: 'center',
+    gap: 8,
+    backgroundColor: 'rgba(26, 26, 46, 0.9)',
+    paddingHorizontal: 16,
+    paddingVertical: 10,
+    borderRadius: 20
+  },
+  text: {
+    color: '#fff',
+    fontSize: 14,
+    fontWeight: '500'
+  }
+});
+//# sourceMappingURL=AgentOverlay.js.map

package/lib/module/components/AgentOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["View","Text","StyleSheet","ActivityIndicator","jsx","_jsx","jsxs","_jsxs","AgentOverlay","visible","statusText","style","styles","overlay","pointerEvents","children","pill","size","color","text","create","position","top","left","right","alignItems","zIndex","flexDirection","gap","backgroundColor","paddingHorizontal","paddingVertical","borderRadius","fontSize","fontWeight"],"sourceRoot":"../../../src","sources":["components/AgentOverlay.tsx"],"mappings":";;AAAA;AACA;AACA;;AAEA,SAASA,IAAI,EAAEC,IAAI,EAAEC,UAAU,EAAEC,iBAAiB,QAAQ,cAAc;AAAC,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAOzE,OAAO,SAASC,YAAYA,CAAC;EAAEC,OAAO;EAAEC;AAA8B,CAAC,EAAE;EACvE,IAAI,CAACD,OAAO,EAAE,OAAO,IAAI;EAEzB,oBACEJ,IAAA,CAACL,IAAI;IAACW,KAAK,EAAEC,MAAM,CAACC,OAAQ;IAACC,aAAa,EAAC,MAAM;IAAAC,QAAA,eAC/CR,KAAA,CAACP,IAAI;MAACW,KAAK,EAAEC,MAAM,CAACI,IAAK;MAAAD,QAAA,gBACvBV,IAAA,CAACF,iBAAiB;QAACc,IAAI,EAAC,OAAO;QAACC,KAAK,EAAC;MAAM,CAAE,CAAC,eAC/Cb,IAAA,CAACJ,IAAI;QAACU,KAAK,EAAEC,MAAM,CAACO,IAAK;QAAAJ,QAAA,EAAEL,UAAU,IAAI;MAAa,CAAO,CAAC;IAAA,CAC1D;EAAC,CACH,CAAC;AAEX;AAEA,MAAME,MAAM,GAAGV,UAAU,CAACkB,MAAM,CAAC;EAC/BP,OAAO,EAAE;IACPQ,QAAQ,EAAE,UAAU;IACpBC,GAAG,EAAE,EAAE;IACPC,IAAI,EAAE,CAAC;IACPC,KAAK,EAAE,CAAC;IACRC,UAAU,EAAE,QAAQ;IACpBC,MAAM,EAAE;EACV,CAAC;EACDV,IAAI,EAAE;IACJW,aAAa,EAAE,KAAK;IACpBF,UAAU,EAAE,QAAQ;IACpBG,GAAG,EAAE,CAAC;IACNC,eAAe,EAAE,uBAAuB;IACxCC,iBAAiB,EAAE,EAAE;IACrBC,eAAe,EAAE,EAAE;IACnBC,YAAY,EAAE;EAChB,CAAC;EACDb,IAAI,EAAE;IACJD,KAAK,EAAE,MAAM;IACbe,QAAQ,EAAE,EAAE;IACZC,UAAU,EAAE;EACd;AACF,CAAC,CAAC","ignoreList":[]}