Agent App Development

Overview

Agent App is a mini-program framework built into the AssistMe mobile app. It works similarly to WeChat Mini Programs or iOS App Clips — lightweight applications that run inside a host app without requiring a separate install from the App Store.

Developers can build Agent Apps using any tech stack and publish them to the AssistMe App Store for all users to discover and install.

Two Loading Strategies

Agent Apps support two loading strategies:

Strategy	How it works	Use case
Static	The app component is bundled directly into the host app at build time via `registerMicroApp()`. Rendered as a native React Native component.	Built-in apps (Note, Time, Health, etc.) that ship with the host app
Dynamic	The app is built as a web bundle (`index.html`), uploaded to any accessible URL, downloaded at runtime, and rendered in a WebView. Developers can build the app in any repository with any tech stack.	Third-party apps or apps updated independently without an App Store release

Architecture

┌─────────────────────────────────────────────┐
│              App Store UI                    │
│         (discover, install, rate)            │
├─────────────────────────────────────────────┤
│           Developer Portal                   │
│      (register, configure, publish)          │
├─────────────────────────────────────────────┤
│          Agent App Runtime                   │
│  ┌─────────────┐  ┌──────────────────────┐  │
│  │   Static     │  │     Dynamic          │  │
│  │  (Native     │  │   (WebView +         │  │
│  │  Component)  │  │   JS Bundle)         │  │
│  └──────┬───────┘  └──────────┬───────────┘  │
│         │    Bridge API       │              │
│         └────────┬────────────┘              │
├──────────────────┴──────────────────────────┤
│          @assistme/agent-app-sdk             │
├─────────────────────────────────────────────┤
│         Supabase Edge Functions              │
│   (register, publish, review, list)          │
├─────────────────────────────────────────────┤
│          Supabase Database                   │
│  (apps, app_versions, user_installed_apps,   │
│   app_ratings, app_reviews)                  │
└─────────────────────────────────────────────┘

Agent Configuration

Every Agent App includes an AI agent configuration:

System Prompt — Defines the agent's persona and behavior
Model — AI model to use (Claude Sonnet 4.6, Haiku 4.5, or Opus 4.6)
Temperature — Controls response creativity (0 = deterministic, 1 = creative)
Max Tokens — Maximum response length (1–32,768)
Tools — Capabilities the agent can use (web search, code execution, image generation, etc.)
Welcome Message — First message shown when the user opens the app
Suggested Prompts — Quick-start buttons displayed to the user (up to 4)
Memory — Whether the agent remembers context across sessions

App Lifecycle

draft → in_review → published → (suspended / archived)

Draft — Developer registers the app; it's only visible to the developer
In Review — Developer publishes a version; the app enters the review queue
Published — A reviewer approves the version; the app is available to all users
Suspended/Archived — The app is temporarily or permanently removed

Tech Stack

Host App: React Native + Expo (expo-router, NativeWind)
SDK: @assistme/agent-app-sdk (TypeScript)
Backend: Supabase (PostgreSQL + Edge Functions + Storage)
State Management: React Query (@tanstack/react-query)
Dynamic Rendering: react-native-webview
Auth: Supabase Auth (tokens injected into Agent Apps via Bridge)

Next Steps

Architecture — Deep dive into the system architecture
Creating an Agent App — Register your first app
Developing — Build and test your app
Example Apps — Reference implementations and templates
Publishing — Submit your app for review
SDK Reference — Full API reference for @assistme/agent-app-sdk
Bridge API — Communication between your app and the host
CLI Tools — Internal build and publish scripts