react-native-agentic-ai 0.0.2 → 0.2.0

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

@@ -0,0 +1,15 @@
+/**
+ * AgentChatBar — Floating, draggable, compressible chat widget.
+ * Does not block underlying UI natively.
+ */
+import type { ExecutionResult } from '../core/types';
+interface AgentChatBarProps {
+    onSend: (message: string) => void;
+    isThinking: boolean;
+    lastResult: ExecutionResult | null;
+    language: 'en' | 'ar';
+    onDismiss?: () => void;
+}
+export declare function AgentChatBar({ onSend, isThinking, lastResult, language, onDismiss }: 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;AAaH,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;IACtB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,iBAAiB,2CAyGtG"}

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,53 @@
+/**
+ * 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;
+    /**
+     * Recursively collect ALL screen names from the navigation state tree.
+     * This handles tabs, drawers, and nested stacks.
+     */
+    private getRouteNames;
+    private collectRouteNames;
+    /**
+     * Recursively find the deepest active screen name.
+     * For tabs: follows active tab → active screen inside that tab.
+     */
+    private getCurrentScreenName;
+    private getDeepestScreenName;
+    /** Maps a tool call to a user-friendly status label for the loading overlay. */
+    private getToolStatusLabel;
+    private buildToolsForProvider;
+    private getWalkConfig;
+    private getInstructions;
+    private observations;
+    private lastScreenName;
+    private handleObservations;
+    private assembleUserPrompt;
+    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;AAOH,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EAEX,eAAe,EAEf,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAMjB,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;IAkK5B,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAK9C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMpC;;;OAGG;IACH,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,iBAAiB;IAczB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,oBAAoB;IAW5B,gFAAgF;IAChF,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,qBAAqB;IA8B7B,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,cAAc,CAAc;IAEpC,OAAO,CAAC,kBAAkB;IAsB1B,OAAO,CAAC,kBAAkB;IAuDpB,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAuL5D,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,31 @@
+/**
+ * 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>[];
+}
+/**
+ * Check if a node has ANY event handler prop (on* function).
+ * Mirrors RNTL's getEventHandlerFromProps pattern.
+ */
+export declare function hasAnyEventHandler(props: any): boolean;
+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;AAsDD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAQtD;AAsND,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,CA4F3E"}

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/systemPrompt.d.ts

@@ -0,0 +1,9 @@
+/**
+ * System prompt for the AI agent — adapted from page-agent reference.
+ *
+ * Separated into its own file for maintainability.
+ * The prompt uses XML-style tags (matching page-agent's structure)
+ * to give the LLM clear, structured instructions.
+ */
+export declare function buildSystemPrompt(language: string): string;
+//# sourceMappingURL=systemPrompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"systemPrompt.d.ts","sourceRoot":"","sources":["../../../../src/core/systemPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAyJ1D"}

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

@@ -0,0 +1,176 @@
+/**
+ * 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;
+        onValueChange?: (value: boolean) => void;
+        value?: string | boolean;
+        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: AgentReasoning;
+    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;
+    /**
+     * Called with a human-readable status string at each step.
+     * Use this to show dynamic loading text (e.g., "Tapping 'Add'...").
+     */
+    onStatusUpdate?: (status: string) => void;
+    /**
+     * Callback for when agent needs user input (ask_user tool).
+     * Mirrors page-agent: the agent loop blocks until the user responds.
+     * If not set, ask_user tool will break the loop (legacy behavior).
+     * @example onAskUser: (q) => new Promise(resolve => showPrompt(q, resolve))
+     */
+    onAskUser?: (question: string) => Promise<string>;
+    /**
+     * Expo Router instance (from useRouter()).
+     * When provided, the navigate tool uses router.push('/path') instead of navRef.navigate().
+     */
+    router?: {
+        push: (href: string) => void;
+        replace: (href: string) => void;
+        back: () => void;
+    };
+    /**
+     * Current pathname from Expo Router (from usePathname()).
+     * Used to determine the current screen when using Expo Router.
+     */
+    pathname?: string;
+    /**
+     * 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;
+}
+/** Structured reasoning returned per step via the agent_step tool. */
+export interface AgentReasoning {
+    /** Assessment of whether the previous action succeeded or failed. */
+    previousGoalEval: string;
+    /** What to remember for future steps (progress, items found, etc). */
+    memory: string;
+    /** The immediate next goal and why. */
+    plan: string;
+}
+/** Result from the AI provider's generateContent call. */
+export interface ProviderResult {
+    /** Extracted action tool call (action_name + params). */
+    toolCalls: Array<{
+        name: string;
+        args: Record<string, any>;
+    }>;
+    /** Structured reasoning from MacroTool (evaluation, memory, next_goal). */
+    reasoning: AgentReasoning;
+    /** Raw text response (if any). */
+    text?: string;
+}
+export interface AIProvider {
+    generateContent(systemPrompt: string, userMessage: string, tools: ToolDefinition[], history: AgentStep[]): Promise<ProviderResult>;
+}
+//# 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,43 @@
+/**
+ * GeminiProvider — Gemini API integration with structured action pattern.
+ *
+ * Uses a single forced function call (`agent_step`) that bundles
+ * structured reasoning (evaluation, memory, plan) alongside the action.
+ * This replaces free-form text + separate tool calls for stability.
+ */
+import type { AIProvider, ToolDefinition, AgentStep, ProviderResult } 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<ProviderResult>;
+    /**
+     * Builds a single `agent_step` function declaration that combines:
+     * - Structured reasoning fields (previous_goal_eval, memory, plan)
+     * - action_name (enum of all available tool names)
+     * - All tool parameter fields as flat top-level properties
+     *
+     * Flat schema avoids Gemini's "deeply nested schema" rejection in ANY mode.
+     */
+    private buildAgentStepDeclaration;
+    private mapParamType;
+    /**
+     * Builds Gemini conversation contents.
+     *
+     * Each step is a STATELESS single-turn request (matching page-agent's approach):
+     * - System prompt has general instructions
+     * - User message contains full context: task, history, screen state
+     * - Model responds with agent_step function call
+     *
+     * History is embedded as text in assembleUserPrompt (via <agent_history>),
+     * NOT as functionCall/functionResponse pairs. This avoids Gemini's
+     * conversation format requirements and thought_signature complexity.
+     */
+    private buildContents;
+    /**
+     * Parses the Gemini response expecting a single agent_step function call.
+     * Extracts structured reasoning + action, and determines which tool to execute.
+     */
+    private parseAgentStepResponse;
+}
+//# 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;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,cAAc,EAAkB,MAAM,eAAe,CAAC;AAsB3G,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;gBAEV,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,cAAc,CAAC;IA2D1B;;;;;;;OAOG;IACH,OAAO,CAAC,yBAAyB;IA0DjC,OAAO,CAAC,YAAY;IAYpB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,aAAa;IASrB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;CA2E/B"}

package/lib/typescript/src/utils/logger.d.ts

@@ -0,0 +1,7 @@
+export declare const logger: {
+    info: (context: string, ...args: any[]) => void;
+    warn: (context: string, ...args: any[]) => void;
+    error: (context: string, ...args: any[]) => void;
+    debug: (context: string, ...args: any[]) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/lib/typescript/src/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../src/utils/logger.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,MAAM;oBACD,MAAM,WAAW,GAAG,EAAE;oBAGtB,MAAM,WAAW,GAAG,EAAE;qBAGrB,MAAM,WAAW,GAAG,EAAE;qBAGtB,MAAM,WAAW,GAAG,EAAE;CAKxC,CAAC"}

package/package.json

@@ -1,22 +1,145 @@
 {
   "name": "react-native-agentic-ai",
-  "version": "0.0.2",
-  "description": "The AI Agent Runtime for React Native — give Gemini (or any LLM) the ability to see, understand, and control your app screens",
-  "main": "src/index.ts",
+  "version": "0.2.0",
+  "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",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/__mocks__",
+    "!**/.*",
+    "!mcp-server"
+  ],
+  "scripts": {
+    "example": "yarn workspace @mobileai/react-native-example",
+    "clean": "del-cli lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "publish:dual": "bash scripts/publish-dual.sh",
+    "publish:dual:dry": "bash scripts/publish-dual.sh --dry-run"
+  },
   "keywords": [
     "react-native",
+    "expo",
     "ai",
+    "llm",
     "agent",
+    "autonomous-agent",
     "gemini",
-    "llm",
-    "automation",
-    "screen-control",
-    "function-calling"
+    "openai",
+    "artificial-intelligence",
+    "mobile-ai",
+    "ui-automation",
+    "react native ai agent"
   ],
-  "author": "Mohamed Salah",
-  "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mohamedsalah/react-native-ai-agent"
-  }
-}
+    "url": "git+https://github.com/mohamed2m2018/mobileai-react-native.git"
+  },
+  "author": "Mohamed Salah <mohamedsalah@example.com> (https://example.com)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/mohamed2m2018/mobileai-react-native/issues"
+  },
+  "homepage": "https://github.com/mohamed2m2018/mobileai-react-native#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native/babel-preset": "0.83.0",
+    "@react-native/eslint-config": "0.83.0",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.1.12",
+    "@types/react-native": "^0.72.8",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "prettier": "^2.8.8",
+    "react": "19.2.0",
+    "react-native": "0.83.2",
+    "react-native-builder-bob": "^0.40.18",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "create-react-native-library": {
+    "type": "library",
+    "languages": "js",
+    "tools": [
+      "eslint",
+      "jest"
+    ],
+    "version": "0.57.2"
+  },
+  "dependencies": {}
+}