@mobileai/react-native 0.1.0

package/lib/module/providers/GeminiProvider.js

@@ -0,0 +1,178 @@
+"use strict";
+
+/**
+ * GeminiProvider — Simplified Gemini API integration.
+ * Sends dehydrated screen state + tools to Gemini and parses tool call responses.
+ */
+
+import { logger } from "../utils/logger.js";
+
+// ─── Gemini API Types ──────────────────────────────────────────
+
+// ─── Provider ──────────────────────────────────────────────────
+
+export class GeminiProvider {
+  constructor(apiKey, model = 'gemini-2.5-flash') {
+    this.apiKey = apiKey;
+    this.model = model;
+  }
+  async generateContent(systemPrompt, userMessage, tools, history) {
+    logger.info('GeminiProvider', `Sending request. Model: ${this.model}, Tools: ${tools.length}`);
+
+    // Build Gemini tools
+    const geminiTools = this.buildGeminiTools(tools);
+
+    // Build conversation history
+    const contents = this.buildContents(userMessage, history);
+
+    // Make API request
+    const url = `https://generativelanguage.googleapis.com/v1beta/models/${this.model}:generateContent?key=${this.apiKey}`;
+    const body = {
+      contents,
+      tools: geminiTools.length > 0 ? geminiTools : undefined,
+      systemInstruction: {
+        parts: [{
+          text: systemPrompt
+        }]
+      },
+      generationConfig: {
+        temperature: 0.2,
+        maxOutputTokens: 2048
+      }
+    };
+    const startTime = Date.now();
+    try {
+      const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json'
+        },
+        body: JSON.stringify(body)
+      });
+      const elapsed = Date.now() - startTime;
+      logger.info('GeminiProvider', `Response received in ${elapsed}ms`);
+      if (!response.ok) {
+        const errorText = await response.text();
+        logger.error('GeminiProvider', `API error ${response.status}: ${errorText}`);
+        throw new Error(`Gemini API error ${response.status}: ${errorText}`);
+      }
+      const data = await response.json();
+
+      // Parse response
+      return this.parseResponse(data);
+    } catch (error) {
+      logger.error('GeminiProvider', 'Request failed:', error.message);
+      throw error;
+    }
+  }
+
+  // ─── Build Gemini Tools ────────────────────────────────────
+
+  buildGeminiTools(tools) {
+    const declarations = tools.map(tool => ({
+      name: tool.name,
+      description: tool.description,
+      parameters: {
+        type: 'OBJECT',
+        properties: Object.fromEntries(Object.entries(tool.parameters).map(([key, param]) => [key, {
+          type: this.mapParamType(param.type),
+          description: param.description,
+          ...(param.enum ? {
+            enum: param.enum
+          } : {})
+        }])),
+        required: Object.entries(tool.parameters).filter(([, param]) => param.required !== false).map(([key]) => key)
+      }
+    }));
+    return [{
+      functionDeclarations: declarations
+    }];
+  }
+  mapParamType(type) {
+    switch (type) {
+      case 'number':
+        return 'NUMBER';
+      case 'boolean':
+        return 'BOOLEAN';
+      case 'string':
+      default:
+        return 'STRING';
+    }
+  }
+
+  // ─── Build Contents ────────────────────────────────────────
+
+  buildContents(userMessage, history) {
+    const contents = [];
+
+    // Add history as conversation turns
+    for (const step of history) {
+      // User turn (screen state was sent)
+      contents.push({
+        role: 'user',
+        parts: [{
+          text: `Step ${step.stepIndex + 1} result: ${step.action.output}`
+        }]
+      });
+    }
+
+    // Current user message
+    contents.push({
+      role: 'user',
+      parts: [{
+        text: userMessage
+      }]
+    });
+
+    // Ensure alternating roles (Gemini requirement)
+    return this.ensureAlternatingRoles(contents);
+  }
+  ensureAlternatingRoles(contents) {
+    if (contents.length <= 1) return contents;
+    const merged = [contents[0]];
+    for (let i = 1; i < contents.length; i++) {
+      const prev = merged[merged.length - 1];
+      const curr = contents[i];
+      if (prev.role === curr.role) {
+        // Merge same-role messages
+        prev.parts.push(...curr.parts);
+      } else {
+        merged.push(curr);
+      }
+    }
+    return merged;
+  }
+
+  // ─── Parse Response ────────────────────────────────────────
+
+  parseResponse(data) {
+    const toolCalls = [];
+    let text;
+    if (!data.candidates || data.candidates.length === 0) {
+      logger.warn('GeminiProvider', 'No candidates in response');
+      return {
+        toolCalls,
+        text: 'No response generated.'
+      };
+    }
+    const candidate = data.candidates[0];
+    const parts = candidate.content?.parts || [];
+    for (const part of parts) {
+      if (part.functionCall) {
+        toolCalls.push({
+          name: part.functionCall.name,
+          args: part.functionCall.args || {}
+        });
+      }
+      if (part.text) {
+        text = (text || '') + part.text;
+      }
+    }
+    logger.info('GeminiProvider', `Parsed: ${toolCalls.length} tool calls, text: ${text ? 'yes' : 'no'}`);
+    return {
+      toolCalls,
+      text
+    };
+  }
+}
+//# sourceMappingURL=GeminiProvider.js.map

package/lib/module/providers/GeminiProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["logger","GeminiProvider","constructor","apiKey","model","generateContent","systemPrompt","userMessage","tools","history","info","length","geminiTools","buildGeminiTools","contents","buildContents","url","body","undefined","systemInstruction","parts","text","generationConfig","temperature","maxOutputTokens","startTime","Date","now","response","fetch","method","headers","JSON","stringify","elapsed","ok","errorText","error","status","Error","data","json","parseResponse","message","declarations","map","tool","name","description","parameters","type","properties","Object","fromEntries","entries","key","param","mapParamType","enum","required","filter","functionDeclarations","step","push","role","stepIndex","action","output","ensureAlternatingRoles","merged","i","prev","curr","toolCalls","candidates","warn","candidate","content","part","functionCall","args"],"sourceRoot":"../../../src","sources":["providers/GeminiProvider.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/utils/logger.js

@@ -0,0 +1,17 @@
+"use strict";
+
+/**
+ * Logger utility — prefixed console output for easy filtering.
+ */
+const TAG = '[AIAgent]';
+export const logger = {
+  info: (context, ...args) => console.log(`${TAG} [${context}]`, ...args),
+  warn: (context, ...args) => console.warn(`${TAG} [${context}]`, ...args),
+  error: (context, ...args) => console.error(`${TAG} [${context}]`, ...args),
+  debug: (context, ...args) => {
+    if (__DEV__) {
+      console.log(`${TAG} [${context}] 🐛`, ...args);
+    }
+  }
+};
+//# sourceMappingURL=logger.js.map

package/lib/module/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TAG","logger","info","context","args","console","log","warn","error","debug","__DEV__"],"sourceRoot":"../../../src","sources":["utils/logger.ts"],"mappings":";;AAAA;AACA;AACA;AACA,MAAMA,GAAG,GAAG,WAAW;AAEvB,OAAO,MAAMC,MAAM,GAAG;EACpBC,IAAI,EAAEA,CAACC,OAAe,EAAE,GAAGC,IAAW,KACpCC,OAAO,CAACC,GAAG,CAAC,GAAGN,GAAG,KAAKG,OAAO,GAAG,EAAE,GAAGC,IAAI,CAAC;EAE7CG,IAAI,EAAEA,CAACJ,OAAe,EAAE,GAAGC,IAAW,KACpCC,OAAO,CAACE,IAAI,CAAC,GAAGP,GAAG,KAAKG,OAAO,GAAG,EAAE,GAAGC,IAAI,CAAC;EAE9CI,KAAK,EAAEA,CAACL,OAAe,EAAE,GAAGC,IAAW,KACrCC,OAAO,CAACG,KAAK,CAAC,GAAGR,GAAG,KAAKG,OAAO,GAAG,EAAE,GAAGC,IAAI,CAAC;EAE/CK,KAAK,EAAEA,CAACN,OAAe,EAAE,GAAGC,IAAW,KAAK;IAC1C,IAAIM,OAAO,EAAE;MACXL,OAAO,CAACC,GAAG,CAAC,GAAGN,GAAG,KAAKG,OAAO,MAAM,EAAE,GAAGC,IAAI,CAAC;IAChD;EACF;AACF,CAAC","ignoreList":[]}

package/lib/typescript/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/src/components/AIAgent.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 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 from 'react';
+import type { ExecutionResult, ToolDefinition, AgentStep } from '../core/types';
+interface AIAgentProps {
+    /** Gemini API key */
+    apiKey: string;
+    /** Gemini model name */
+    model?: string;
+    /** Navigation container ref (from useNavigationContainerRef) */
+    navRef?: any;
+    /** UI language */
+    language?: 'en' | 'ar';
+    /** Max agent steps per request */
+    maxSteps?: number;
+    /** Show/hide the chat bar */
+    showChatBar?: boolean;
+    /** Children — the actual app */
+    children: React.ReactNode;
+    /** Callback when agent completes */
+    onResult?: (result: ExecutionResult) => void;
+    /** Refs of elements the AI must NOT interact with */
+    interactiveBlacklist?: React.RefObject<any>[];
+    /** If set, AI can ONLY interact with these elements */
+    interactiveWhitelist?: React.RefObject<any>[];
+    /** Called before each step */
+    onBeforeStep?: (stepCount: number) => Promise<void> | void;
+    /** Called after each step */
+    onAfterStep?: (history: AgentStep[]) => Promise<void> | void;
+    /** Called before task starts */
+    onBeforeTask?: () => Promise<void> | void;
+    /** Called after task completes */
+    onAfterTask?: (result: ExecutionResult) => Promise<void> | void;
+    /** Transform screen content before LLM sees it (for data masking) */
+    transformScreenContent?: (content: string) => Promise<string> | string;
+    /** Override or remove built-in tools (null = remove) */
+    customTools?: Record<string, ToolDefinition | null>;
+    /** Instructions to guide agent behavior */
+    instructions?: {
+        system?: string;
+        getScreenInstructions?: (screenName: string) => string | undefined | null;
+    };
+    /** Delay between steps in ms */
+    stepDelay?: number;
+    /** WebSocket URL to companion MCP server bridge (e.g., ws://localhost:3101) */
+    mcpServerUrl?: string;
+}
+export declare function AIAgent({ apiKey, model, navRef, language, maxSteps, showChatBar, children, onResult, interactiveBlacklist, interactiveWhitelist, onBeforeStep, onAfterStep, onBeforeTask, onAfterTask, transformScreenContent, customTools, instructions, stepDelay, mcpServerUrl, }: AIAgentProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=AIAgent.d.ts.map

package/lib/typescript/src/components/AIAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIAgent.d.ts","sourceRoot":"","sources":["../../../../src/components/AIAgent.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAMN,MAAM,OAAO,CAAC;AASf,OAAO,KAAK,EAAe,eAAe,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAO7F,UAAU,YAAY;IACpB,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,kBAAkB;IAClB,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gCAAgC;IAChC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IAI7C,qDAAqD;IACrD,oBAAoB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9C,uDAAuD;IACvD,oBAAoB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9C,8BAA8B;IAC9B,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3D,6BAA6B;IAC7B,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7D,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,kCAAkC;IAClC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAChE,qEAAqE;IACrE,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IACvE,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC,CAAC;IACpD,2CAA2C;IAC3C,YAAY,CAAC,EAAE;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,qBAAqB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;KAC3E,CAAC;IACF,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,wBAAgB,OAAO,CAAC,EACtB,MAAM,EACN,KAA0B,EAC1B,MAAM,EACN,QAAe,EACf,QAAa,EACb,WAAkB,EAClB,QAAQ,EACR,QAAQ,EAER,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,WAAW,EACX,sBAAsB,EACtB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,YAAY,GACb,EAAE,YAAY,2CAiHd"}

package/lib/typescript/src/components/AgentChatBar.d.ts

@@ -0,0 +1,14 @@
+/**
+ * AgentChatBar — Floating chat input at the bottom of the screen.
+ * User sends messages here, and results are shown inline.
+ */
+import type { ExecutionResult } from '../core/types';
+interface AgentChatBarProps {
+    onSend: (message: string) => void;
+    isThinking: boolean;
+    lastResult: ExecutionResult | null;
+    language: 'en' | 'ar';
+}
+export declare function AgentChatBar({ onSend, isThinking, lastResult, language }: AgentChatBarProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=AgentChatBar.d.ts.map

package/lib/typescript/src/components/AgentChatBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentChatBar.d.ts","sourceRoot":"","sources":["../../../../src/components/AgentChatBar.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,UAAU,iBAAiB;IACzB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IACnC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;CACvB;AAED,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,iBAAiB,2CAgD3F"}

package/lib/typescript/src/components/AgentOverlay.d.ts

@@ -0,0 +1,10 @@
+/**
+ * AgentOverlay — Subtle thinking indicator shown while the AI agent is processing.
+ */
+interface AgentOverlayProps {
+    visible: boolean;
+    statusText: string;
+}
+export declare function AgentOverlay({ visible, statusText }: AgentOverlayProps): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=AgentOverlay.d.ts.map

package/lib/typescript/src/components/AgentOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentOverlay.d.ts","sourceRoot":"","sources":["../../../../src/components/AgentOverlay.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAIH,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,iBAAiB,kDAWtE"}

package/lib/typescript/src/core/AgentRuntime.d.ts

@@ -0,0 +1,37 @@
+/**
+ * AgentRuntime — The main agent loop, inspired by page-agent.js.
+ *
+ * Flow:
+ * 1. Walk Fiber tree → detect interactive elements
+ * 2. Dehydrate screen → text for LLM
+ * 3. Send to AI provider with tools
+ * 4. Parse tool call → execute (tap, type, navigate, done)
+ * 5. If not done, repeat from step 1 (re-dehydrate after UI change)
+ */
+import type { AIProvider, AgentConfig, ExecutionResult, ActionDefinition } from './types';
+export declare class AgentRuntime {
+    private provider;
+    private config;
+    private rootRef;
+    private navRef;
+    private tools;
+    private actions;
+    private history;
+    private isRunning;
+    private lastAskUserQuestion;
+    constructor(provider: AIProvider, config: AgentConfig, rootRef: any, navRef: any);
+    private registerBuiltInTools;
+    registerAction(action: ActionDefinition): void;
+    unregisterAction(name: string): void;
+    private getRouteNames;
+    private getCurrentScreenName;
+    private buildToolsForProvider;
+    private getWalkConfig;
+    private getInstructions;
+    execute(userMessage: string): Promise<ExecutionResult>;
+    /** Update refs (called when component re-renders) */
+    updateRefs(rootRef: any, navRef: any): void;
+    /** Check if agent is currently executing */
+    getIsRunning(): boolean;
+}
+//# sourceMappingURL=AgentRuntime.d.ts.map

package/lib/typescript/src/core/AgentRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntime.d.ts","sourceRoot":"","sources":["../../../../src/core/AgentRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EAEX,eAAe,EAEf,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAmDjB,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,OAAO,CAA4C;IAC3D,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,mBAAmB,CAAuB;gBAGhD,QAAQ,EAAE,UAAU,EACpB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,GAAG;IAyBb,OAAO,CAAC,oBAAoB;IAkH5B,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAK9C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMpC,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,oBAAoB;IAc5B,OAAO,CAAC,qBAAqB;IA8B7B,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,eAAe;IAyBjB,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAsK5D,qDAAqD;IACrD,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI;IAK3C,4CAA4C;IAC5C,YAAY,IAAI,OAAO;CAGxB"}

package/lib/typescript/src/core/FiberTreeWalker.d.ts

@@ -0,0 +1,26 @@
+/**
+ * FiberTreeWalker — Traverses React's Fiber tree to discover interactive elements.
+ *
+ * This is the React Native equivalent of page-agent.js reading the DOM.
+ * Instead of traversing HTML nodes, we traverse React Fiber nodes and detect
+ * interactive elements by their type and props (onPress, onChangeText, etc.).
+ *
+ * Architecture inspired by: https://github.com/alibaba/page-agent
+ */
+import type { InteractiveElement } from './types';
+export interface WalkConfig {
+    /** React refs of elements to exclude — mirrors page-agent interactiveBlacklist */
+    interactiveBlacklist?: React.RefObject<any>[];
+    /** If set, only these elements are interactive — mirrors page-agent interactiveWhitelist */
+    interactiveWhitelist?: React.RefObject<any>[];
+}
+export interface WalkResult {
+    elementsText: string;
+    interactives: InteractiveElement[];
+}
+/**
+ * Walk the React Fiber tree from a root and collect all interactive elements
+ * as well as a hierarchical layout representation for the LLM.
+ */
+export declare function walkFiberTree(rootRef: any, config?: WalkConfig): WalkResult;
+//# sourceMappingURL=FiberTreeWalker.d.ts.map

package/lib/typescript/src/core/FiberTreeWalker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FiberTreeWalker.d.ts","sourceRoot":"","sources":["../../../../src/core/FiberTreeWalker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAe,MAAM,SAAS,CAAC;AAI/D,MAAM,WAAW,UAAU;IACzB,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9C,4FAA4F;IAC5F,oBAAoB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;CAC/C;AAmOD,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,CA0F3E"}

package/lib/typescript/src/core/MCPBridge.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MCPBridge — Connects the React Native app to the local MCP Server bridge.
+ *
+ * Flow:
+ * - Connects via WebSocket to the Node.js MCP server
+ * - Listens for 'request' messages containing an MCP command
+ * - Forwards the command to AgentRuntime.execute()
+ * - Sends the ExecutionResult back via WebSocket as a 'response'
+ */
+import type { AgentRuntime } from './AgentRuntime';
+export declare class MCPBridge {
+    private url;
+    private ws;
+    private runtime;
+    private reconnectTimer;
+    private isDestroyed;
+    constructor(url: string, runtime: AgentRuntime);
+    private connect;
+    private sendResponse;
+    private scheduleReconnect;
+    destroy(): void;
+}
+//# sourceMappingURL=MCPBridge.d.ts.map

package/lib/typescript/src/core/MCPBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MCPBridge.d.ts","sourceRoot":"","sources":["../../../../src/core/MCPBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,qBAAa,SAAS;IACpB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,WAAW,CAAS;gBAEhB,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY;IAM9C,OAAO,CAAC,OAAO;IAsDf,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,iBAAiB;IAQlB,OAAO;CAWf"}

package/lib/typescript/src/core/ScreenDehydrator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ScreenDehydrator — Converts discovered interactive elements into
+ * a text representation for the LLM, matching page-agent.js format.
+ *
+ * Output example:
+ * ```
+ * Screen: Home | Available screens: Home, Menu, Cart
+ * Interactive elements:
+ * [0]<pressable>🍕 Pizzas</>
+ * [1]<pressable>🍔 Burgers</>
+ * [2]<pressable>🥤 Drinks</>
+ * [3]<pressable>🛒 View Cart</>
+ * ```
+ */
+import type { InteractiveElement, DehydratedScreen } from './types';
+/**
+ * Dehydrate the current screen state into a text format for the LLM.
+ */
+export declare function dehydrateScreen(screenName: string, availableScreens: string[], elementsText: string, elements: InteractiveElement[]): DehydratedScreen;
+//# sourceMappingURL=ScreenDehydrator.d.ts.map

package/lib/typescript/src/core/ScreenDehydrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScreenDehydrator.d.ts","sourceRoot":"","sources":["../../../../src/core/ScreenDehydrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEpE;;GAEG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,EAAE,EAC1B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,kBAAkB,EAAE,GAC7B,gBAAgB,CA2BlB"}

package/lib/typescript/src/core/types.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Core types for the page-agent-style React Native AI SDK.
+ */
+export type ElementType = 'pressable' | 'text-input' | 'switch' | 'scrollable';
+export interface InteractiveElement {
+    /** Unique index assigned during tree walk */
+    index: number;
+    /** Element type */
+    type: ElementType;
+    /** Human-readable label (extracted from Text children or accessibilityLabel) */
+    label: string;
+    /** Reference to the Fiber node for execution */
+    fiberNode: any;
+    /** Key props snapshot */
+    props: {
+        onPress?: (...args: any[]) => void;
+        onChangeText?: (text: string) => void;
+        value?: string;
+        placeholder?: string;
+        checked?: boolean;
+        disabled?: boolean;
+        accessibilityLabel?: string;
+        accessibilityRole?: string;
+    };
+}
+export interface DehydratedScreen {
+    /** Current screen name (from navigation state) */
+    screenName: string;
+    /** All available screen names (from routeNames) */
+    availableScreens: string[];
+    /** Indexed interactive elements as text */
+    elementsText: string;
+    /** Raw elements array */
+    elements: InteractiveElement[];
+}
+export interface AgentStep {
+    stepIndex: number;
+    reflection: {
+        evaluationPreviousGoal: string;
+        memory: string;
+        nextGoal: string;
+    };
+    action: {
+        name: string;
+        input: Record<string, any>;
+        output: string;
+    };
+}
+export interface AgentConfig {
+    apiKey: string;
+    model?: string;
+    language?: 'en' | 'ar';
+    /** Maximum steps per task (page-agent default: 40) */
+    maxSteps?: number;
+    /**
+     * React refs of elements the AI must NOT interact with.
+     * Mirrors page-agent.js `interactiveBlacklist: Element[]`.
+     * The Fiber walker skips any node whose ref matches one in this list.
+     */
+    interactiveBlacklist?: React.RefObject<any>[];
+    /**
+     * If set, the AI can ONLY interact with these elements.
+     * Mirrors page-agent.js `interactiveWhitelist: Element[]`.
+     */
+    interactiveWhitelist?: React.RefObject<any>[];
+    /** Called before each agent step. */
+    onBeforeStep?: (stepCount: number) => Promise<void> | void;
+    /** Called after each agent step with full history. */
+    onAfterStep?: (history: AgentStep[]) => Promise<void> | void;
+    /** Called before task execution starts. */
+    onBeforeTask?: () => Promise<void> | void;
+    /** Called after task completes (success or failure). */
+    onAfterTask?: (result: ExecutionResult) => Promise<void> | void;
+    /**
+     * Transform dehydrated screen text before sending to LLM.
+     * Use to mask sensitive data (credit cards, PII, etc).
+     * Mirrors page-agent.js `transformPageContent`.
+     */
+    transformScreenContent?: (content: string) => Promise<string> | string;
+    /**
+     * Override or remove built-in tools.
+     * Set tool to `null` to remove it (e.g., `{ navigate: null }`).
+     * Mirrors page-agent.js `customTools: Record<string, Tool | null>`.
+     */
+    customTools?: Record<string, ToolDefinition | null>;
+    /** Instructions to guide the agent's behavior. */
+    instructions?: {
+        /** Global system-level instructions, applied to all tasks. */
+        system?: string;
+        /**
+         * Dynamic per-screen instructions callback.
+         * Called before each step to get instructions for the current screen.
+         * Mirrors page-agent.js `getPageInstructions(url)`.
+         */
+        getScreenInstructions?: (screenName: string) => string | undefined | null;
+    };
+    /** Delay between steps in ms (page-agent default: 400ms). */
+    stepDelay?: number;
+    /**
+     * Optional URL of the companion Node.js MCP server bridge (e.g. ws://localhost:3101).
+     * If set, the SDK will connect to this server and listen for execution requests
+     * from external AI agents (like OpenClaw, Claude Desktop, etc).
+     */
+    mcpServerUrl?: string;
+}
+export interface ExecutionResult {
+    success: boolean;
+    message: string;
+    steps: AgentStep[];
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, ToolParam>;
+    execute: (args: Record<string, any>) => Promise<string>;
+}
+export interface ToolParam {
+    type: 'string' | 'number' | 'boolean';
+    description: string;
+    required?: boolean;
+    enum?: string[];
+}
+export interface ActionDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, string>;
+    handler: (args: Record<string, any>) => any;
+}
+export interface AIProvider {
+    generateContent(systemPrompt: string, userMessage: string, tools: ToolDefinition[], history: AgentStep[]): Promise<{
+        toolCalls: Array<{
+            name: string;
+            args: Record<string, any>;
+        }>;
+        text?: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/hooks/useAction.d.ts

@@ -0,0 +1,13 @@
+/**
+ * useAction — Optional hook to register non-UI actions for the AI agent.
+ *
+ * Use this for business logic that doesn't correspond to a visible UI element,
+ * e.g., API calls, cart operations, calculations.
+ *
+ * The Fiber tree walker handles visible UI elements automatically.
+ * useAction is for invisible operations the AI should be able to trigger.
+ */
+import type { AgentRuntime } from '../core/AgentRuntime';
+export declare const AgentContext: import("react").Context<AgentRuntime | null>;
+export declare function useAction(name: string, description: string, parameters: Record<string, string>, handler: (args: Record<string, any>) => any): void;
+//# sourceMappingURL=useAction.d.ts.map

package/lib/typescript/src/hooks/useAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAction.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useAction.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,eAAO,MAAM,YAAY,8CAA2C,CAAC;AAErE,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,GAAG,GAC1C,IAAI,CAkBN"}

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @mobileai/react-native — Page-Agent Architecture
+ *
+ * Zero-wrapper AI agent for React Native.
+ * Auto-detects interactive elements via React Fiber tree traversal.
+ */
+export { AIAgent } from './components/AIAgent';
+export { useAction } from './hooks/useAction';
+export type { AgentConfig, ExecutionResult, InteractiveElement, DehydratedScreen, ToolDefinition, ActionDefinition, } from './core/types';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,YAAY,EACV,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC"}

package/lib/typescript/src/providers/GeminiProvider.d.ts

@@ -0,0 +1,23 @@
+/**
+ * GeminiProvider — Simplified Gemini API integration.
+ * Sends dehydrated screen state + tools to Gemini and parses tool call responses.
+ */
+import type { AIProvider, ToolDefinition, AgentStep } from '../core/types';
+export declare class GeminiProvider implements AIProvider {
+    private apiKey;
+    private model;
+    constructor(apiKey: string, model?: string);
+    generateContent(systemPrompt: string, userMessage: string, tools: ToolDefinition[], history: AgentStep[]): Promise<{
+        toolCalls: Array<{
+            name: string;
+            args: Record<string, any>;
+        }>;
+        text?: string;
+    }>;
+    private buildGeminiTools;
+    private mapParamType;
+    private buildContents;
+    private ensureAlternatingRoles;
+    private parseResponse;
+}
+//# sourceMappingURL=GeminiProvider.d.ts.map

package/lib/typescript/src/providers/GeminiProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeminiProvider.d.ts","sourceRoot":"","sources":["../../../../src/providers/GeminiProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAyB3E,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;gBAGV,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAA2B;IAKxD,eAAe,CACnB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,EAAE,SAAS,EAAE,GACnB,OAAO,CAAC;QAAE,SAAS,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;SAAE,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAqD5F,OAAO,CAAC,gBAAgB;IAyBxB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,sBAAsB;IAsB9B,OAAO,CAAC,aAAa;CA8BtB"}