@loomic/react-native

React Native integration layer for the Loomic agentic runtime. Connects the runtime to your component tree and provides hooks for subscribing to agent-driven state.

What it does

• AgenticAppProvider — initializes the runtime and provides it via React context
• AgenticScreen — renders the dynamic screen descriptor emitted by the agent; you register your own components and the agent mounts/unmounts/updates them
• useRuntime() — access the runtime instance from any component
• useScreenState() — subscribe to live screen state updates
• useRuntimeEvent() — listen to specific run-loop events
• useGoals() / useNarrative() / useJournal() — subscribe to agent memory and reasoning state

Note: This package ships source (.tsx) rather than compiled output. It is consumed directly by Metro, the React Native bundler. No build step needed.

Install

npm install @loomic/react-native @loomic/runtime @loomic/types

Minimal setup

import { AgenticAppProvider, AgenticScreen } from '@loomic/react-native';
import { runtime } from './runtime'; // your createAgenticRuntime() instance

export default function App() {
  return (
    <AgenticAppProvider runtime={runtime}>
      <AgenticScreen components={{ HeroCard, ActionButton }} />
    </AgenticAppProvider>
  );
}