dependencies {
    implementation("ai.revrag:embed-android:1.0.6")
}

<!-- Auto-added by the SDK via manifest merger -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

// MyApplication.kt
import android.app.Application
import ai.revrag.embed.android.EmbedSDK

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        EmbedSDK.initialize(
            context = this,
            apiKey  = "YOUR_REVRAG_API_KEY"
        ) { result ->
            if (result.success) Log.d("Revrag", "SDK ready")
            else                Log.e("Revrag", "Init failed: ${result.error}")
        }
    }
}

<application
    android:name=".MyApplication"
    ... >

import ai.revrag.embed.android.EmbedSDK
import ai.revrag.embed.core.events.EventKeys

EmbedSDK.event(
    EventKeys.USER_DATA,
    mapOf(
        "app_user_id" to "user_123",       // required
        "name"        to "Jane Doe",        // optional
        "email"       to "jane@email.com"   // optional
    )
)

// MainActivity.kt
import ai.revrag.embed.android.EmbedProvider
import androidx.activity.ComponentActivity

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        EmbedProvider.attach(
            activity   = this,
            appUserId  = "user_123",
            appVersion = BuildConfig.VERSION_NAME
        ) {
            // Your existing root composable — no changes needed
            MyAppTheme {
                AppNavigation()
            }
        }
    }
}

setContent {
    MyAppTheme {
        Box(modifier = Modifier.fillMaxSize()) {
            YourMainScreen()

            EmbedProviderComposable(
                currentScreen = "HomeScreen",
                appUserId     = "user_123",
                appVersion    = BuildConfig.VERSION_NAME
            )
        }
    }
}

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        EmbedProvider.attach(
            activity   = this,
            appUserId  = "user_123",
            appVersion = BuildConfig.VERSION_NAME
        ) {
            val navController = rememberNavController()

            NavHost(navController = navController, startDestination = "home") {
                composable("home")         { HomeScreen() }
                composable("search")       { SearchScreen() }
                composable("product/{id}") { ProductScreen() }
                composable("cart")         { CartScreen() }
                composable("checkout")     { CheckoutScreen() }
                composable("profile")      { ProfileScreen() }
            }
        }
    }
}

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        EmbedProvider.attach(
            activity   = this,
            appUserId  = "user_123",
            appVersion = BuildConfig.VERSION_NAME
        ) {
            val homeNavController    = rememberNavController()
            val exploreNavController = rememberNavController()
            val profileNavController = rememberNavController()

            var selectedTab by remember { mutableStateOf(0) }

            Scaffold(
                bottomBar = {
                    BottomNavBar(
                        selected = selectedTab,
                        onSelect = { selectedTab = it }
                    )
                }
            ) { padding ->
                Box(Modifier.padding(padding)) {
                    when (selectedTab) {
                        0 -> TabNavHost(navController = homeNavController,    startRoute = "home")
                        1 -> TabNavHost(navController = exploreNavController, startRoute = "explore")
                        2 -> TabNavHost(navController = profileNavController, startRoute = "profile")
                    }
                }
            }
        }
    }
}

// Call this whenever the screen changes
EmbedSDK.event(
    EventKeys.SCREEN_STATE,
    mapOf("screen" to "ProductDetail", "action" to "enter")
)

class ProductFragment : Fragment() {
    override fun onResume() {
        super.onResume()
        EmbedSDK.event(EventKeys.SCREEN_STATE, mapOf("screen" to "ProductDetail"))
    }
}

@Composable
fun CheckoutScreen() {
    LaunchedEffect(Unit) {
        EmbedSDK.event(EventKeys.SCREEN_STATE, mapOf("screen" to "Checkout"))
    }
    // your content
}

NavHost(navController = rootNavController, startDestination = "main") {

    // Tab container
    composable("main") {
        MainTabsScreen()
    }

    // Checkout flow — nested graph
    navigation(startDestination = "cart", route = "checkout_flow") {
        composable("cart")         { CartScreen() }
        composable("payment")      { PaymentScreen() }
        composable("confirmation") { ConfirmationScreen() }
    }

    // Settings — separate stack
    composable("settings") { SettingsScreen() }
}

EmbedProvider.attach(
    activity         = this,
    appUserId        = "user_123",
    appVersion       = BuildConfig.VERSION_NAME,
    visibilityConfig = EmbedButtonVisibilityConfig(
        allowedScreens  = listOf("home", "product", "cart"),
        excludedScreens = listOf("login", "splash", "onboarding")
    )
) { /* content */ }

visibilityConfig = EmbedButtonVisibilityConfig(
    groups = listOf(
        EmbedButtonGroupConfig(
            id          = "checkout-flow",
            screens     = listOf("cart", "payment", "confirmation"),
            continuity  = EmbedButtonContinuity.CONTINUOUS,
            delayMs     = 500L,
            delayPolicy = EmbedButtonDelayPolicy.ONCE_PER_GROUP_ENTRY
        )
    )
)

1. Screen is in excludedScreens               →  always HIDDEN  (strongest rule)
2. allowedScreens and groups are both empty   →  always VISIBLE
3. Screen is in allowedScreens or any group   →  VISIBLE
4. Otherwise                                  →  HIDDEN

// User identity (required before first call)
EmbedSDK.event(EventKeys.USER_DATA, mapOf("app_user_id" to "user_123"))

// Custom analytics event
EmbedSDK.event(EventKeys.ANALYTICS_DATA, mapOf("event_name" to "checkout_started"))

// Manual screen state
EmbedSDK.event(EventKeys.SCREEN_STATE, mapOf("screen" to "CheckoutScreen", "action" to "enter"))

// Register in onCreate or onStart
val onConnected: AgentEventCallback = { _ ->
    // e.g. pause background music
    Log.d("Revrag", "Agent call started")
}
val onDisconnected: AgentEventCallback = { payload ->
    val duration = (payload["metadata"] as? Map<*, *>)?.get("callDuration") as? Int ?: 0
    Log.d("Revrag", "Call lasted ${duration}s")
}

EmbedSDK.onAgent(AgentEvent.AGENT_CONNECTED,    onConnected)
EmbedSDK.onAgent(AgentEvent.AGENT_DISCONNECTED, onDisconnected)

// Always de-register in onDestroy
override fun onDestroy() {
    super.onDestroy()
    EmbedSDK.offAgent(AgentEvent.AGENT_CONNECTED,    onConnected)
    EmbedSDK.offAgent(AgentEvent.AGENT_DISCONNECTED, onDisconnected)
}

// Track a custom event
EmbedSDK.trackEvent("product_viewed", mapOf("product_id" to "SKU-123"))

// Track a form interaction
EmbedSDK.trackFormEvent(
    formId    = "checkout_form",
    eventType = "submit",
    formData  = mapOf("step" to "payment")
)

// Track a rage-click
EmbedSDK.trackRageClick(
    elementId   = "btn_add_to_cart",
    coordinates = Pair(x, y),
    clickCount  = 5,
    elementType = "Button"
)

// Check microphone permission status
EmbedSDK.checkPermissions(context) { granted ->
    if (!granted) showMicEducationDialog()
}

fun onUserLogout() {
    EmbedSDK.clearStorageCache()
}

EmbedSDK.initialize(context, apiKey = "YOUR_KEY") { result ->
    Log.d("Revrag", "success=${result.success} error=${result.error}")
}

lifecycleScope.launch {
    EmbedSDK.isInitializedFlow.collect { ready ->
        Log.d("Revrag", "SDK ready: $ready")
    }
}

"Home" ≠ "home"  — they must match exactly

# Clear cache and retry
./gradlew --refresh-dependencies

repositories {
    google()
    mavenCentral()   // ← must be present
}

// ❌ Wrong — nested inside a sized Box
Box(modifier = Modifier.size(200.dp)) {
    EmbedProviderComposable(...)
}

// ✅ Correct — use EmbedProvider.attach() which handles root placement automatically
EmbedProvider.attach(activity = this, appUserId = "user_123") {
    YourContent()
}

EmbedSDK.checkPermissions(context) { granted ->
    if (!granted) {
        startActivity(
            Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS).apply {
                data = Uri.fromParts("package", packageName, null)
            }
        )
    }
}

fun onUserLogout() {
    EmbedSDK.clearStorageCache()
}