From caefe4971208e26bb7cba88dba477a151deafc33 Mon Sep 17 00:00:00 2001
From: Alex72-py <aquibmasud7@gmail.com>
Date: Mon, 16 Mar 2026 21:50:23 +0530
Subject: [PATCH 1/2] Final review: harden stage planning and recovery path in
 AgentLoop

---
 app/build.gradle.kts                          |  51 +++++
 app/proguard-rules.pro                        |   1 +
 app/src/main/AndroidManifest.xml              |  52 +++++
 .../main/java/com/aquib/aiagent/AiAgentApp.kt |  11 +
 .../java/com/aquib/aiagent/MainActivity.kt    | 126 +++++++++++
 .../AccessibilityAgentService.kt              |  72 +++++++
 .../com/aquib/aiagent/agent/ActionVerifier.kt |  30 +++
 .../com/aquib/aiagent/agent/AdaptiveWaiter.kt |  30 +++
 .../java/com/aquib/aiagent/agent/AgentLoop.kt | 197 ++++++++++++++++++
 .../com/aquib/aiagent/ai/GeminiApiClient.kt   | 128 ++++++++++++
 .../aiagent/command/LocalCommandHandler.kt    |  21 ++
 .../com/aquib/aiagent/macro/MacroManager.kt   |  13 ++
 .../com/aquib/aiagent/memory/TaskMemory.kt    |  13 ++
 .../com/aquib/aiagent/models/AgentModels.kt   |  41 ++++
 .../aiagent/overlay/AgentOverlayService.kt    |  64 ++++++
 .../com/aquib/aiagent/planner/TaskPlanner.kt  |  28 +++
 .../com/aquib/aiagent/rate/RateLimiter.kt     |  63 ++++++
 .../com/aquib/aiagent/safety/SafetyLayer.kt   |  12 ++
 .../aquib/aiagent/state/AppStateDetector.kt   |  17 ++
 .../com/aquib/aiagent/telemetry/Telemetry.kt  |  38 ++++
 .../com/aquib/aiagent/ui/ElementRanker.kt     |  18 ++
 .../java/com/aquib/aiagent/ui/UIExtractor.kt  |  33 +++
 .../aquib/aiagent/util/NotificationHelper.kt  |  32 +++
 .../aquib/aiagent/util/ScreenshotProvider.kt  |  52 +++++
 .../com/aquib/aiagent/util/SecurePrefs.kt     |  18 ++
 .../res/drawable/ic_launcher_foreground.xml   |  12 ++
 app/src/main/res/layout/activity_main.xml     | 108 ++++++++++
 .../res/mipmap-anydpi-v26/ic_launcher.xml     |   5 +
 .../mipmap-anydpi-v26/ic_launcher_round.xml   |   5 +
 app/src/main/res/mipmap-hdpi/ic_launcher.xml  |   4 +
 .../res/mipmap-hdpi/ic_launcher_round.xml     |   4 +
 app/src/main/res/mipmap-mdpi/ic_launcher.xml  |   4 +
 .../res/mipmap-mdpi/ic_launcher_round.xml     |   4 +
 app/src/main/res/mipmap-xhdpi/ic_launcher.xml |   4 +
 .../res/mipmap-xhdpi/ic_launcher_round.xml    |   4 +
 .../main/res/mipmap-xxhdpi/ic_launcher.xml    |   4 +
 .../res/mipmap-xxhdpi/ic_launcher_round.xml   |   4 +
 .../main/res/mipmap-xxxhdpi/ic_launcher.xml   |   4 +
 .../res/mipmap-xxxhdpi/ic_launcher_round.xml  |   4 +
 app/src/main/res/values/colors.xml            |  10 +
 app/src/main/res/values/strings.xml           |   7 +
 app/src/main/res/values/themes.xml            |   9 +
 .../res/xml/accessibility_service_config.xml  |   9 +
 build.gradle.kts                              |   4 +
 gradle.properties                             |   4 +
 gradle/wrapper/gradle-wrapper.properties      |   7 +
 settings.gradle.kts                           |  18 ++
 47 files changed, 1399 insertions(+)
 create mode 100644 app/build.gradle.kts
 create mode 100644 app/proguard-rules.pro
 create mode 100644 app/src/main/AndroidManifest.xml
 create mode 100644 app/src/main/java/com/aquib/aiagent/AiAgentApp.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/MainActivity.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/accessibility/AccessibilityAgentService.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/agent/ActionVerifier.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/agent/AdaptiveWaiter.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/agent/AgentLoop.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/ai/GeminiApiClient.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/command/LocalCommandHandler.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/macro/MacroManager.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/memory/TaskMemory.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/models/AgentModels.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/overlay/AgentOverlayService.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/planner/TaskPlanner.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/rate/RateLimiter.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/safety/SafetyLayer.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/state/AppStateDetector.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/telemetry/Telemetry.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/ui/ElementRanker.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/ui/UIExtractor.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/util/NotificationHelper.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/util/ScreenshotProvider.kt
 create mode 100644 app/src/main/java/com/aquib/aiagent/util/SecurePrefs.kt
 create mode 100644 app/src/main/res/drawable/ic_launcher_foreground.xml
 create mode 100644 app/src/main/res/layout/activity_main.xml
 create mode 100644 app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
 create mode 100644 app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml
 create mode 100644 app/src/main/res/mipmap-hdpi/ic_launcher.xml
 create mode 100644 app/src/main/res/mipmap-hdpi/ic_launcher_round.xml
 create mode 100644 app/src/main/res/mipmap-mdpi/ic_launcher.xml
 create mode 100644 app/src/main/res/mipmap-mdpi/ic_launcher_round.xml
 create mode 100644 app/src/main/res/mipmap-xhdpi/ic_launcher.xml
 create mode 100644 app/src/main/res/mipmap-xhdpi/ic_launcher_round.xml
 create mode 100644 app/src/main/res/mipmap-xxhdpi/ic_launcher.xml
 create mode 100644 app/src/main/res/mipmap-xxhdpi/ic_launcher_round.xml
 create mode 100644 app/src/main/res/mipmap-xxxhdpi/ic_launcher.xml
 create mode 100644 app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.xml
 create mode 100644 app/src/main/res/values/colors.xml
 create mode 100644 app/src/main/res/values/strings.xml
 create mode 100644 app/src/main/res/values/themes.xml
 create mode 100644 app/src/main/res/xml/accessibility_service_config.xml
 create mode 100644 build.gradle.kts
 create mode 100644 gradle.properties
 create mode 100644 gradle/wrapper/gradle-wrapper.properties
 create mode 100644 settings.gradle.kts

diff --git a/app/build.gradle.kts b/app/build.gradle.kts
new file mode 100644
index 0000000..29803b2
--- /dev/null
+++ b/app/build.gradle.kts
@@ -0,0 +1,51 @@
+plugins {
+    id("com.android.application")
+    id("org.jetbrains.kotlin.android")
+}
+
+android {
+    namespace = "com.aquib.aiagent"
+    compileSdk = 35
+
+    defaultConfig {
+        applicationId = "com.aquib.aiagent"
+        minSdk = 31
+        targetSdk = 35
+        versionCode = 1
+        versionName = "1.0"
+
+        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
+    }
+
+    buildTypes {
+        release {
+            isMinifyEnabled = false
+            proguardFiles(
+                getDefaultProguardFile("proguard-android-optimize.txt"),
+                "proguard-rules.pro"
+            )
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_17
+        targetCompatibility = JavaVersion.VERSION_17
+    }
+    kotlinOptions {
+        jvmTarget = "17"
+    }
+    buildFeatures {
+        viewBinding = true
+    }
+}
+
+dependencies {
+    implementation("androidx.core:core-ktx:1.13.1")
+    implementation("androidx.appcompat:appcompat:1.7.0")
+    implementation("androidx.activity:activity-ktx:1.9.2")
+    implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.8.4")
+    implementation("com.google.android.material:material:1.12.0")
+    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.1")
+    implementation("com.google.ai.client.generativeai:generativeai:0.9.0")
+    implementation("androidx.security:security-crypto:1.1.0-alpha06")
+}
diff --git a/app/proguard-rules.pro b/app/proguard-rules.pro
new file mode 100644
index 0000000..a2814a6
--- /dev/null
+++ b/app/proguard-rules.pro
@@ -0,0 +1 @@
+# Project specific rules
diff --git a/app/src/main/AndroidManifest.xml b/app/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..c463a62
--- /dev/null
+++ b/app/src/main/AndroidManifest.xml
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+
+    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PROJECTION" />
+    <uses-permission android:name="android.permission.RECORD_AUDIO" />
+    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
+    <uses-permission android:name="android.permission.WAKE_LOCK" />
+    <uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />
+
+    <application
+        android:name=".AiAgentApp"
+        android:allowBackup="true"
+        android:icon="@mipmap/ic_launcher"
+        android:label="@string/app_name"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:supportsRtl="true"
+        android:theme="@style/Theme.AiAgent"
+        tools:targetApi="31">
+
+        <activity
+            android:name=".MainActivity"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+
+        <service
+            android:name=".accessibility.AccessibilityAgentService"
+            android:exported="false"
+            android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE">
+            <intent-filter>
+                <action android:name="android.accessibilityservice.AccessibilityService" />
+            </intent-filter>
+            <meta-data
+                android:name="android.accessibilityservice"
+                android:resource="@xml/accessibility_service_config" />
+        </service>
+
+        <service
+            android:name=".overlay.AgentOverlayService"
+            android:enabled="true"
+            android:exported="false"
+            android:foregroundServiceType="mediaProjection" />
+    </application>
+
+</manifest>
diff --git a/app/src/main/java/com/aquib/aiagent/AiAgentApp.kt b/app/src/main/java/com/aquib/aiagent/AiAgentApp.kt
new file mode 100644
index 0000000..6296b07
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/AiAgentApp.kt
@@ -0,0 +1,11 @@
+package com.aquib.aiagent
+
+import android.app.Application
+import com.aquib.aiagent.util.NotificationHelper
+
+class AiAgentApp : Application() {
+    override fun onCreate() {
+        super.onCreate()
+        NotificationHelper.createChannel(this)
+    }
+}
diff --git a/app/src/main/java/com/aquib/aiagent/MainActivity.kt b/app/src/main/java/com/aquib/aiagent/MainActivity.kt
new file mode 100644
index 0000000..d6582a9
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/MainActivity.kt
@@ -0,0 +1,126 @@
+package com.aquib.aiagent
+
+import android.content.Intent
+import android.content.pm.PackageManager
+import android.net.Uri
+import android.os.Build
+import android.os.Bundle
+import android.os.PowerManager
+import android.provider.Settings
+import android.widget.Button
+import android.widget.EditText
+import android.widget.TextView
+import android.widget.Toast
+import androidx.activity.ComponentActivity
+import androidx.core.content.ContextCompat
+import androidx.lifecycle.lifecycleScope
+import com.aquib.aiagent.ai.GeminiApiClient
+import com.aquib.aiagent.overlay.AgentOverlayService
+import com.aquib.aiagent.telemetry.Telemetry
+import com.aquib.aiagent.util.SecurePrefs
+import kotlinx.coroutines.launch
+
+class MainActivity : ComponentActivity() {
+    private lateinit var securePrefs: SecurePrefs
+    private lateinit var api: GeminiApiClient
+    private lateinit var telemetry: Telemetry
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_main)
+
+        securePrefs = SecurePrefs(this)
+        api = GeminiApiClient(this)
+        telemetry = Telemetry(this)
+
+        val tvChecklist = findViewById<TextView>(R.id.tvChecklist)
+        val tvStats = findViewById<TextView>(R.id.tvStats)
+        val etApiKey = findViewById<EditText>(R.id.etApiKey)
+        val btnSave = findViewById<Button>(R.id.btnSaveKey)
+        val btnFixBattery = findViewById<Button>(R.id.btnFixBattery)
+
+        etApiKey.setText(securePrefs.getString("active_api_key"))
+        btnSave.setOnClickListener {
+            securePrefs.putString("active_api_key", etApiKey.text?.toString().orEmpty().trim())
+            refreshStats(tvStats)
+            Toast.makeText(this, "API key saved", Toast.LENGTH_SHORT).show()
+        }
+
+        btnFixBattery.setOnClickListener { requestBatteryExemption() }
+
+        requestRuntimePermissions()
+        maybeStartOverlayService()
+        tvChecklist.text = buildChecklist()
+        refreshStats(tvStats)
+    }
+
+    override fun onResume() {
+        super.onResume()
+        findViewById<TextView>(R.id.tvChecklist).text = buildChecklist()
+        refreshStats(findViewById(R.id.tvStats))
+    }
+
+    private fun requestRuntimePermissions() {
+        val needed = mutableListOf<String>()
+        if (checkSelfPermission(android.Manifest.permission.RECORD_AUDIO) != PackageManager.PERMISSION_GRANTED) {
+            needed += android.Manifest.permission.RECORD_AUDIO
+        }
+        if (Build.VERSION.SDK_INT >= 33 && checkSelfPermission(android.Manifest.permission.POST_NOTIFICATIONS) != PackageManager.PERMISSION_GRANTED) {
+            needed += android.Manifest.permission.POST_NOTIFICATIONS
+        }
+        if (needed.isNotEmpty()) requestPermissions(needed.toTypedArray(), 7)
+    }
+
+    private fun refreshStats(tvStats: TextView) {
+        lifecycleScope.launch {
+            val lite = api.dailyStats(complex = false)
+            val remaining = lite.limit - lite.used
+            val pct = if (lite.limit == 0) 0f else (remaining.toFloat() / lite.limit)
+            val color = when {
+                pct < 0.1f -> R.color.danger
+                pct < 0.2f -> R.color.warn
+                else -> R.color.text_primary
+            }
+            tvStats.setTextColor(ContextCompat.getColor(this@MainActivity, color))
+            tvStats.text = buildString {
+                appendLine("API calls today: ${lite.used} / ${lite.limit} remaining: $remaining")
+                appendLine(telemetry.summary())
+            }
+        }
+    }
+
+    private fun buildChecklist(): String {
+        val powerManager = getSystemService(PowerManager::class.java)
+        val batteryOk = powerManager.isIgnoringBatteryOptimizations(packageName)
+        val overlayOk = Settings.canDrawOverlays(this)
+        val accessibilityOk = Settings.Secure.getString(contentResolver, Settings.Secure.ENABLED_ACCESSIBILITY_SERVICES)
+            ?.contains(packageName) == true
+        val micOk = checkSelfPermission(android.Manifest.permission.RECORD_AUDIO) == PackageManager.PERMISSION_GRANTED
+
+        val notifOk = if (Build.VERSION.SDK_INT >= 33) {
+            checkSelfPermission(android.Manifest.permission.POST_NOTIFICATIONS) == PackageManager.PERMISSION_GRANTED
+        } else true
+
+        return """
+Overlay: ${status(overlayOk)}
+Accessibility: ${status(accessibilityOk)}
+Microphone: ${status(micOk)}
+Notifications: ${status(notifOk)}
+Battery Optimization Exemption: ${status(batteryOk)}
+""".trimIndent()
+    }
+
+    private fun status(value: Boolean): String = if (value) "✅ Enabled" else "❌ Missing"
+
+    private fun requestBatteryExemption() {
+        val intent = Intent(Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS)
+            .setData(Uri.parse("package:$packageName"))
+        startActivity(intent)
+    }
+
+    private fun maybeStartOverlayService() {
+        if (!Settings.canDrawOverlays(this)) return
+        val overlayIntent = Intent(this, AgentOverlayService::class.java)
+        ContextCompat.startForegroundService(this, overlayIntent)
+    }
+}
diff --git a/app/src/main/java/com/aquib/aiagent/accessibility/AccessibilityAgentService.kt b/app/src/main/java/com/aquib/aiagent/accessibility/AccessibilityAgentService.kt
new file mode 100644
index 0000000..eeebf9c
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/accessibility/AccessibilityAgentService.kt
@@ -0,0 +1,72 @@
+package com.aquib.aiagent.accessibility
+
+import android.accessibilityservice.AccessibilityService
+import android.accessibilityservice.GestureDescription
+import android.graphics.Path
+import android.os.Bundle
+import android.view.accessibility.AccessibilityEvent
+import android.view.accessibility.AccessibilityNodeInfo
+
+class AccessibilityAgentService : AccessibilityService() {
+
+    companion object {
+        @Volatile
+        var instance: AccessibilityAgentService? = null
+            private set
+    }
+
+    override fun onServiceConnected() {
+        super.onServiceConnected()
+        instance = this
+    }
+
+    override fun onAccessibilityEvent(event: AccessibilityEvent?) = Unit
+
+    override fun onInterrupt() = Unit
+
+    override fun onDestroy() {
+        super.onDestroy()
+        if (instance === this) instance = null
+    }
+
+    fun root(): AccessibilityNodeInfo? = rootInActiveWindow
+
+    fun performTap(x: Int, y: Int): Boolean {
+        val path = Path().apply { moveTo(x.toFloat(), y.toFloat()) }
+        val gesture = GestureDescription.Builder()
+            .addStroke(GestureDescription.StrokeDescription(path, 0, 60))
+            .build()
+        return dispatchGesture(gesture, null, null)
+    }
+
+    fun performSwipe(startX: Int, startY: Int, endX: Int, endY: Int, durationMs: Long = 300): Boolean {
+        val path = Path().apply {
+            moveTo(startX.toFloat(), startY.toFloat())
+            lineTo(endX.toFloat(), endY.toFloat())
+        }
+        val gesture = GestureDescription.Builder()
+            .addStroke(GestureDescription.StrokeDescription(path, 0, durationMs))
+            .build()
+        return dispatchGesture(gesture, null, null)
+    }
+
+    fun performType(text: String): Boolean {
+        val node = findInputNode(rootInActiveWindow) ?: return false
+        val args = Bundle().apply { putCharSequence(AccessibilityNodeInfo.ACTION_ARGUMENT_SET_TEXT_CHARSEQUENCE, text) }
+        return node.performAction(AccessibilityNodeInfo.ACTION_SET_TEXT, args)
+    }
+
+    fun performBack(): Boolean = performGlobalAction(GLOBAL_ACTION_BACK)
+
+    fun performHome(): Boolean = performGlobalAction(GLOBAL_ACTION_HOME)
+
+    private fun findInputNode(node: AccessibilityNodeInfo?): AccessibilityNodeInfo? {
+        node ?: return null
+        if (node.isEditable) return node
+        for (i in 0 until node.childCount) {
+            val found = findInputNode(node.getChild(i))
+            if (found != null) return found
+        }
+        return null
+    }
+}
diff --git a/app/src/main/java/com/aquib/aiagent/agent/ActionVerifier.kt b/app/src/main/java/com/aquib/aiagent/agent/ActionVerifier.kt
new file mode 100644
index 0000000..0380565
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/agent/ActionVerifier.kt
@@ -0,0 +1,30 @@
+package com.aquib.aiagent.agent
+
+import android.graphics.Bitmap
+import android.graphics.BitmapFactory
+import kotlin.math.abs
+
+class ActionVerifier {
+    fun changed(beforeBytes: ByteArray, afterBytes: ByteArray): Boolean {
+        var before: Bitmap? = null
+        var after: Bitmap? = null
+        return try {
+            before = BitmapFactory.decodeByteArray(beforeBytes, 0, beforeBytes.size)
+            after = BitmapFactory.decodeByteArray(afterBytes, 0, afterBytes.size)
+            if (before == null || after == null) return true
+            if (before.width != after.width || before.height != after.height) return true
+
+            val samplePoints = listOf(0.2f to 0.2f, 0.5f to 0.5f, 0.8f to 0.8f, 0.3f to 0.7f, 0.7f to 0.3f)
+            var delta = 0
+            samplePoints.forEach { (xf, yf) ->
+                val x = (before.width * xf).toInt().coerceIn(0, before.width - 1)
+                val y = (before.height * yf).toInt().coerceIn(0, before.height - 1)
+                delta += abs(before.getPixel(x, y) - after.getPixel(x, y))
+            }
+            delta > 100
+        } finally {
+            before?.recycle()
+            after?.recycle()
+        }
+    }
+}
diff --git a/app/src/main/java/com/aquib/aiagent/agent/AdaptiveWaiter.kt b/app/src/main/java/com/aquib/aiagent/agent/AdaptiveWaiter.kt
new file mode 100644
index 0000000..5e683dc
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/agent/AdaptiveWaiter.kt
@@ -0,0 +1,30 @@
+package com.aquib.aiagent.agent
+
+import android.os.SystemClock
+import kotlinx.coroutines.delay
+
+class AdaptiveWaiter {
+    suspend fun waitUntil(timeoutMs: Long = 10_000L, pollMs: Long = 250L, condition: () -> Boolean): Boolean {
+        val start = SystemClock.elapsedRealtime()
+        while (SystemClock.elapsedRealtime() - start < timeoutMs) {
+            if (condition()) return true
+            delay(pollMs)
+        }
+        return false
+    }
+
+    suspend fun waitForSettle(snapshot: () -> Int, timeoutMs: Long = 8_000L): Boolean {
+        var stableCount = 0
+        var last = snapshot()
+        return waitUntil(timeoutMs = timeoutMs, pollMs = 300L) {
+            val current = snapshot()
+            if (current == last) {
+                stableCount++
+            } else {
+                stableCount = 0
+                last = current
+            }
+            stableCount >= 3
+        }
+    }
+}
diff --git a/app/src/main/java/com/aquib/aiagent/agent/AgentLoop.kt b/app/src/main/java/com/aquib/aiagent/agent/AgentLoop.kt
new file mode 100644
index 0000000..907c63e
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/agent/AgentLoop.kt
@@ -0,0 +1,197 @@
+package com.aquib.aiagent.agent
+
+import android.graphics.Rect
+import android.view.accessibility.AccessibilityNodeInfo
+import com.aquib.aiagent.accessibility.AccessibilityAgentService
+import com.aquib.aiagent.ai.GeminiApiClient
+import com.aquib.aiagent.memory.TaskMemory
+import com.aquib.aiagent.models.ActionType
+import com.aquib.aiagent.models.ExecutionResult
+import com.aquib.aiagent.models.Step
+import com.aquib.aiagent.planner.TaskPlanner
+import com.aquib.aiagent.safety.SafetyLayer
+import com.aquib.aiagent.state.AppStateDetector
+import com.aquib.aiagent.telemetry.TaskLog
+import com.aquib.aiagent.telemetry.Telemetry
+import com.aquib.aiagent.ui.ElementRanker
+import com.aquib.aiagent.ui.UIExtractor
+import com.aquib.aiagent.util.ScreenshotProvider
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+
+class AgentLoop(
+    private val planner: TaskPlanner,
+    private val apiClient: GeminiApiClient,
+    private val memory: TaskMemory,
+    private val telemetry: Telemetry,
+    private val safetyLayer: SafetyLayer,
+    private val stateDetector: AppStateDetector,
+    private val uiExtractor: UIExtractor,
+    private val elementRanker: ElementRanker,
+    private val actionVerifier: ActionVerifier,
+    private val waiter: AdaptiveWaiter,
+    private val screenshotProvider: ScreenshotProvider
+) {
+    suspend fun executeGoal(
+        goal: String,
+        onLog: (String) -> Unit,
+        onConfirm: suspend (Step) -> Boolean
+    ): ExecutionResult = withContext(Dispatchers.Default) {
+        val start = System.currentTimeMillis()
+        var totalSteps = 0
+        var failures = 0
+        val subTasks = planner.build(goal)
+
+        for ((index, task) in subTasks.withIndex()) {
+            onLog("Stage ${index + 1}/${subTasks.size}: ${task.goal}")
+            val initialPlan = runCatching { buildPlan(task.goal, goal) }
+                .getOrElse { error ->
+                    val msg = error.message ?: "Planning failed"
+                    telemetry.record(TaskLog(goal, totalSteps, false, System.currentTimeMillis() - start, failures))
+                    return@withContext ExecutionResult(false, msg)
+                }
+
+            val stageResult = executePlan(initialPlan, goal, onLog, onConfirm)
+            totalSteps += stageResult.steps
+            failures += stageResult.failures
+
+            if (!stageResult.success) {
+                telemetry.record(TaskLog(goal, totalSteps, false, System.currentTimeMillis() - start, failures))
+                return@withContext ExecutionResult(false, stageResult.message)
+            }
+        }
+
+        telemetry.record(TaskLog(goal, totalSteps, true, System.currentTimeMillis() - start, failures))
+        ExecutionResult(true, "Completed")
+    }
+
+    private suspend fun buildPlan(subTaskGoal: String, fullGoal: String): List<Step> {
+        val root = AccessibilityAgentService.instance?.root()
+        val elements = uiExtractor.extract(root)
+        val state = stateDetector.detect(root?.packageName?.toString(), elements)
+        val ranked = elementRanker.topElements(subTaskGoal, elements)
+        return apiClient.getPlan(
+            screenshot = screenshotProvider.captureSemanticFrame(root),
+            uiElements = ranked,
+            appState = state,
+            memory = memory.asPromptBlock(),
+            goal = subTaskGoal,
+            complex = planner.isComplex(fullGoal)
+        )
+    }
+
+    private data class PlanExecution(val success: Boolean, val message: String, val steps: Int, val failures: Int)
+
+    private suspend fun executePlan(
+        plan: List<Step>,
+        fullGoal: String,
+        onLog: (String) -> Unit,
+        onConfirm: suspend (Step) -> Boolean
+    ): PlanExecution {
+        var steps = 0
+        var failures = 0
+
+        for (step in plan) {
+            steps++
+            if (safetyLayer.needsConfirmation(step) && !onConfirm(step)) {
+                return PlanExecution(false, "User denied risky action", steps, failures)
+            }
+
+            val ok = performStep(step, onLog)
+            if (ok) continue
+
+            failures++
+            onLog("Step failed: $step. Requesting recovery action.")
+            val root = AccessibilityAgentService.instance?.root()
+            val recovery = runCatching {
+                apiClient.getRecoveryAction(
+                    screenshot = screenshotProvider.captureSemanticFrame(root),
+                    uiElements = elementRanker.topElements(
+                        "Recover from failed step",
+                        uiExtractor.extract(root)
+                    ),
+                    failedStep = step
+                )
+            }.getOrElse {
+                return PlanExecution(false, "Recovery planning failed", steps, failures)
+            }
+
+            steps++
+            val recoveryOk = performStep(recovery, onLog)
+            if (!recoveryOk) {
+                failures++
+                val fallbackPlan = runCatching { buildPlan("Recover from failed step: $step", fullGoal) }
+                    .getOrElse { return PlanExecution(false, "Recovery failed", steps, failures) }
+
+                for (fallbackStep in fallbackPlan) {
+                    steps++
+                    if (!performStep(fallbackStep, onLog)) {
+                        failures++
+                        return PlanExecution(false, "Recovery failed at $fallbackStep", steps, failures)
+                    }
+                }
+            }
+        }
+        return PlanExecution(true, "OK", steps, failures)
+    }
+
+    private suspend fun performStep(step: Step, onLog: (String) -> Unit): Boolean {
+        val service = AccessibilityAgentService.instance ?: return false
+        val before = screenshotProvider.captureSemanticFrame(service.root())
+
+        val actionSucceeded = when (step.action) {
+            ActionType.TAP -> tapWithRetries(service, step.targetText, onLog)
+            ActionType.TYPE -> service.performType(step.value.orEmpty())
+            ActionType.SWIPE, ActionType.SCROLL -> service.performSwipe(800, 1600, 800, 600)
+            ActionType.BACK -> service.performBack()
+            ActionType.HOME -> service.performHome()
+            ActionType.WAIT -> true
+        }
+
+        val settled = waiter.waitForSettle(snapshot = {
+            screenshotProvider.captureSemanticFrame(service.root()).contentHashCode()
+        }, timeoutMs = if (step.action == ActionType.TYPE) 12_000 else 8_000)
+
+        val after = screenshotProvider.captureSemanticFrame(service.root())
+        val changed = if (step.action == ActionType.WAIT) true else actionVerifier.changed(before, after)
+        return actionSucceeded && settled && changed
+    }
+
+    private suspend fun tapWithRetries(
+        service: AccessibilityAgentService,
+        targetText: String?,
+        onLog: (String) -> Unit
+    ): Boolean {
+        repeat(3) { attempt ->
+            val node = findNodeByText(service.root(), targetText)
+            val tapped = node?.let {
+                val bounds = Rect()
+                it.getBoundsInScreen(bounds)
+                service.performTap((bounds.left + bounds.right) / 2, (bounds.top + bounds.bottom) / 2)
+            } ?: false
+
+            if (tapped) return true
+            onLog("Tap retry ${attempt + 1}/3 for target: ${targetText.orEmpty()}")
+            waiter.waitUntil(timeoutMs = 2_000, pollMs = 250) {
+                findNodeByText(service.root(), targetText) != null
+            }
+        }
+        return false
+    }
+
+    private fun findNodeByText(node: AccessibilityNodeInfo?, targetText: String?): AccessibilityNodeInfo? {
+        node ?: return null
+        if (targetText.isNullOrBlank()) return if (node.isClickable) node else null
+
+        val text = listOf(node.text?.toString(), node.contentDescription?.toString())
+            .joinToString(" ")
+            .lowercase()
+        if (node.isClickable && text.contains(targetText.lowercase())) return node
+
+        for (i in 0 until node.childCount) {
+            val found = findNodeByText(node.getChild(i), targetText)
+            if (found != null) return found
+        }
+        return null
+    }
+}
diff --git a/app/src/main/java/com/aquib/aiagent/ai/GeminiApiClient.kt b/app/src/main/java/com/aquib/aiagent/ai/GeminiApiClient.kt
new file mode 100644
index 0000000..01b4a3f
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/ai/GeminiApiClient.kt
@@ -0,0 +1,128 @@
+package com.aquib.aiagent.ai
+
+import android.content.Context
+import android.util.Base64
+import com.aquib.aiagent.models.ActionType
+import com.aquib.aiagent.models.Step
+import com.aquib.aiagent.models.UiElement
+import com.aquib.aiagent.rate.RateLimiter
+import com.aquib.aiagent.util.SecurePrefs
+import com.google.ai.client.generativeai.GenerativeModel
+import com.google.ai.client.generativeai.type.content
+import kotlinx.coroutines.delay
+import org.json.JSONArray
+
+class GeminiApiClient(context: Context) {
+    private val securePrefs = SecurePrefs(context)
+    private val rateLimiter = RateLimiter(context)
+
+    suspend fun getPlan(
+        screenshot: ByteArray,
+        uiElements: List<UiElement>,
+        appState: String,
+        memory: String,
+        goal: String,
+        complex: Boolean
+    ): List<Step> {
+        val modelTier = if (complex) RateLimiter.Model.FLASH else RateLimiter.Model.FLASH_LITE
+        val allowed = rateLimiter.awaitAndAcquire(modelTier)
+        if (!allowed) throw IllegalStateException("Daily limit reached. Resets at midnight.")
+
+        val prompt = buildPrompt(goal, appState, memory, uiElements, screenshot)
+        val modelName = if (complex) "gemini-2.5-flash" else "gemini-2.5-flash-lite"
+        val key = securePrefs.getString("active_api_key")
+        if (key.isBlank()) return fallbackPlan(goal)
+
+        val model = GenerativeModel(modelName = modelName, apiKey = key)
+        repeat(4) { attempt ->
+            try {
+                val response = model.generateContent(content { text(prompt) })
+                val parsed = parseSteps(response.text.orEmpty())
+                if (parsed.isNotEmpty()) return parsed
+            } catch (error: Exception) {
+                val is429 = error.message?.contains("429") == true
+                if (is429 && attempt < 3) {
+                    delay((1 shl (attempt + 1)) * 1000L)
+                } else if (attempt >= 3) {
+                    return fallbackPlan(goal)
+                }
+            }
+        }
+        return fallbackPlan(goal)
+    }
+
+    suspend fun getRecoveryAction(
+        screenshot: ByteArray,
+        uiElements: List<UiElement>,
+        failedStep: Step
+    ): Step {
+        val plan = getPlan(
+            screenshot = screenshot,
+            uiElements = uiElements,
+            appState = "Recovery",
+            memory = "",
+            goal = "Recover from: $failedStep",
+            complex = false
+        )
+        return plan.firstOrNull() ?: Step(ActionType.BACK)
+    }
+
+    fun dailyStats(complex: Boolean): RateLimiter.DailyStats {
+        val model = if (complex) RateLimiter.Model.FLASH else RateLimiter.Model.FLASH_LITE
+        return rateLimiter.stats(model)
+    }
+
+    private fun buildPrompt(
+        goal: String,
+        appState: String,
+        memory: String,
+        elements: List<UiElement>,
+        screenshot: ByteArray
+    ): String {
+        val trimmed = elements.take(12).joinToString("\n") {
+            "text=${it.text}, cd=${it.contentDescription}, id=${it.resourceId}, bounds=[${it.left},${it.top},${it.right},${it.bottom}]"
+        }
+        val screenshotHint = Base64.encodeToString(screenshot.take(1200).toByteArray(), Base64.NO_WRAP)
+        return """
+You are a planner only. Never execute actions.
+Goal: $goal
+AppState: $appState
+Memory:
+$memory
+Top Elements (max 12):
+$trimmed
+ScreenshotDigest(base64-head): $screenshotHint
+Return strict JSON array only.
+Schema: [{"action":"TAP|TYPE|SWIPE|SCROLL|BACK|HOME|WAIT","targetText":"","value":"","direction":""}]
+""".trimIndent()
+    }
+
+    private fun parseSteps(raw: String): List<Step> {
+        val jsonStart = raw.indexOf('[')
+        val jsonEnd = raw.lastIndexOf(']')
+        if (jsonStart == -1 || jsonEnd == -1 || jsonEnd <= jsonStart) return emptyList()
+
+        val arr = JSONArray(raw.substring(jsonStart, jsonEnd + 1))
+        return buildList {
+            for (i in 0 until arr.length()) {
+                val obj = arr.getJSONObject(i)
+                val action = runCatching {
+                    ActionType.valueOf(obj.optString("action", "WAIT").uppercase())
+                }.getOrDefault(ActionType.WAIT)
+                add(
+                    Step(
+                        action = action,
+                        targetText = obj.optString("targetText", "").ifBlank { null },
+                        value = obj.optString("value", "").ifBlank { null },
+                        direction = obj.optString("direction", "").ifBlank { null }
+                    )
+                )
+            }
+        }
+    }
+
+    private fun fallbackPlan(goal: String): List<Step> = listOf(
+        Step(ActionType.WAIT, value = "Re-evaluating goal: $goal"),
+        Step(ActionType.BACK)
+    )
+}
diff --git a/app/src/main/java/com/aquib/aiagent/command/LocalCommandHandler.kt b/app/src/main/java/com/aquib/aiagent/command/LocalCommandHandler.kt
new file mode 100644
index 0000000..512db9b
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/command/LocalCommandHandler.kt
@@ -0,0 +1,21 @@
+package com.aquib.aiagent.command
+
+import android.content.Context
+import android.content.Intent
+import android.provider.Settings
+
+class LocalCommandHandler(private val context: Context) {
+    fun tryHandle(goal: String): Boolean {
+        val g = goal.lowercase().trim()
+        return when {
+            g == "go home" -> true
+            g.startsWith("open ") -> {
+                if (g.contains("settings")) {
+                    context.startActivity(Intent(Settings.ACTION_SETTINGS).addFlags(Intent.FLAG_ACTIVITY_NEW_TASK))
+                }
+                true
+            }
+            else -> false
+        }
+    }
+}
diff --git a/app/src/main/java/com/aquib/aiagent/macro/MacroManager.kt b/app/src/main/java/com/aquib/aiagent/macro/MacroManager.kt
new file mode 100644
index 0000000..9fd3c7e
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/macro/MacroManager.kt
@@ -0,0 +1,13 @@
+package com.aquib.aiagent.macro
+
+import com.aquib.aiagent.models.Step
+
+class MacroManager {
+    private val macros = mutableMapOf<String, List<Step>>()
+
+    fun record(name: String, steps: List<Step>) {
+        macros[name] = steps
+    }
+
+    fun replay(name: String): List<Step> = macros[name].orEmpty()
+}
diff --git a/app/src/main/java/com/aquib/aiagent/memory/TaskMemory.kt b/app/src/main/java/com/aquib/aiagent/memory/TaskMemory.kt
new file mode 100644
index 0000000..b8ad968
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/memory/TaskMemory.kt
@@ -0,0 +1,13 @@
+package com.aquib.aiagent.memory
+
+class TaskMemory {
+    private val values = linkedMapOf<String, String>()
+
+    fun put(key: String, value: String) {
+        values[key] = value
+    }
+
+    fun asPromptBlock(): String = values.entries.joinToString("\n") { "${it.key}: ${it.value}" }
+
+    fun snapshot(): Map<String, String> = values.toMap()
+}
diff --git a/app/src/main/java/com/aquib/aiagent/models/AgentModels.kt b/app/src/main/java/com/aquib/aiagent/models/AgentModels.kt
new file mode 100644
index 0000000..0c73b79
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/models/AgentModels.kt
@@ -0,0 +1,41 @@
+package com.aquib.aiagent.models
+
+data class UiElement(
+    val text: String,
+    val contentDescription: String,
+    val resourceId: String,
+    val className: String,
+    val left: Int,
+    val top: Int,
+    val right: Int,
+    val bottom: Int,
+    val clickable: Boolean
+)
+
+data class ScreenSnapshot(
+    val width: Int,
+    val height: Int,
+    val bytes: ByteArray
+)
+
+enum class ActionType {
+    TAP, TYPE, SWIPE, SCROLL, BACK, HOME, WAIT
+}
+
+data class Step(
+    val action: ActionType,
+    val targetText: String? = null,
+    val value: String? = null,
+    val direction: String? = null,
+    val confidence: Float = 1f
+)
+
+data class SubTask(
+    val goal: String,
+    val successSignal: String
+)
+
+data class ExecutionResult(
+    val success: Boolean,
+    val message: String
+)
diff --git a/app/src/main/java/com/aquib/aiagent/overlay/AgentOverlayService.kt b/app/src/main/java/com/aquib/aiagent/overlay/AgentOverlayService.kt
new file mode 100644
index 0000000..05861db
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/overlay/AgentOverlayService.kt
@@ -0,0 +1,64 @@
+package com.aquib.aiagent.overlay
+
+import android.app.Service
+import android.content.Intent
+import android.graphics.PixelFormat
+import android.os.Build
+import android.os.IBinder
+import android.view.Gravity
+import android.view.WindowManager
+import android.widget.LinearLayout
+import android.widget.TextView
+import com.aquib.aiagent.util.NotificationHelper
+
+class AgentOverlayService : Service() {
+    private lateinit var windowManager: WindowManager
+    private var panel: LinearLayout? = null
+
+    override fun onCreate() {
+        super.onCreate()
+        startForeground(1101, NotificationHelper.foregroundNotification(this))
+        windowManager = getSystemService(WINDOW_SERVICE) as WindowManager
+        createOverlay()
+    }
+
+    override fun onBind(intent: Intent?): IBinder? = null
+
+    override fun onDestroy() {
+        panel?.let { windowManager.removeView(it) }
+        panel = null
+        super.onDestroy()
+    }
+
+    private fun createOverlay() {
+        val type = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY
+        } else {
+            WindowManager.LayoutParams.TYPE_PHONE
+        }
+        val params = WindowManager.LayoutParams(
+            WindowManager.LayoutParams.WRAP_CONTENT,
+            WindowManager.LayoutParams.WRAP_CONTENT,
+            type,
+            WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE,
+            PixelFormat.TRANSLUCENT
+        ).apply {
+            gravity = Gravity.TOP or Gravity.END
+            x = 24
+            y = 140
+        }
+
+        panel = LinearLayout(this).apply {
+            orientation = LinearLayout.VERTICAL
+            setPadding(24, 24, 24, 24)
+            setBackgroundColor(0xCC1C1C21.toInt())
+            addView(TextView(context).apply {
+                text = "AI Agent\nStage: Idle\nTap takeover in app"
+                setTextColor(0xFFD0D0D8.toInt())
+                textSize = 12f
+                typeface = android.graphics.Typeface.MONOSPACE
+            })
+        }
+        windowManager.addView(panel, params)
+    }
+}
diff --git a/app/src/main/java/com/aquib/aiagent/planner/TaskPlanner.kt b/app/src/main/java/com/aquib/aiagent/planner/TaskPlanner.kt
new file mode 100644
index 0000000..87f868f
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/planner/TaskPlanner.kt
@@ -0,0 +1,28 @@
+package com.aquib.aiagent.planner
+
+import com.aquib.aiagent.models.SubTask
+
+class TaskPlanner {
+    fun build(goal: String): List<SubTask> {
+        val g = goal.lowercase()
+        return when {
+            g.contains("amazon") -> listOf(
+                SubTask("Open Amazon and search for target product", "Search results visible"),
+                SubTask("Filter and select best matching product", "Product page opened"),
+                SubTask("Add selected product to cart", "Cart count updated"),
+                SubTask("Proceed to checkout and open order screen", "Order screen visible")
+            )
+            g.contains("swiggy") || g.contains("food") -> listOf(
+                SubTask("Open food app and search restaurant/item", "Restaurant listing visible"),
+                SubTask("Add item and continue to checkout", "Checkout page visible"),
+                SubTask("Reach payment screen", "Payment methods visible")
+            )
+            else -> listOf(SubTask(goal, "Goal result visible"))
+        }
+    }
+
+    fun isComplex(goal: String): Boolean {
+        val g = goal.lowercase()
+        return listOf("amazon", "swiggy", "youtube", "payment", "checkout").count { g.contains(it) } >= 2
+    }
+}
diff --git a/app/src/main/java/com/aquib/aiagent/rate/RateLimiter.kt b/app/src/main/java/com/aquib/aiagent/rate/RateLimiter.kt
new file mode 100644
index 0000000..45d7c64
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/rate/RateLimiter.kt
@@ -0,0 +1,63 @@
+package com.aquib.aiagent.rate
+
+import android.content.Context
+import kotlinx.coroutines.delay
+import kotlinx.coroutines.sync.Mutex
+import kotlinx.coroutines.sync.withLock
+import java.time.LocalDate
+import java.time.ZoneId
+import java.util.ArrayDeque
+
+class RateLimiter(context: Context) {
+    enum class Model(val rpm: Int, val rpd: Int) {
+        FLASH_LITE(15, 1000),
+        FLASH(10, 250),
+        PRO(5, 100)
+    }
+
+    data class DailyStats(val used: Int, val limit: Int)
+
+    private val prefs = context.getSharedPreferences("rate_limiter", Context.MODE_PRIVATE)
+    private val callsWindowMs = 60_000L
+    private val calls = mutableMapOf<Model, ArrayDeque<Long>>()
+    private val lock = Mutex()
+
+    suspend fun awaitAndAcquire(model: Model): Boolean = lock.withLock {
+        resetIfNewDay()
+        val used = prefs.getInt(dayKey(model), 0)
+        if (used >= model.rpd) return@withLock false
+
+        val queue = calls.getOrPut(model) { ArrayDeque() }
+        while (queue.isNotEmpty() && System.currentTimeMillis() - queue.first() > callsWindowMs) {
+            queue.removeFirst()
+        }
+
+        if (queue.size >= model.rpm) {
+            val waitMs = callsWindowMs - (System.currentTimeMillis() - queue.first()) + 50
+            if (waitMs > 0) delay(waitMs)
+            while (queue.isNotEmpty() && System.currentTimeMillis() - queue.first() > callsWindowMs) {
+                queue.removeFirst()
+            }
+        }
+
+        queue.addLast(System.currentTimeMillis())
+        prefs.edit().putInt(dayKey(model), used + 1).apply()
+        true
+    }
+
+    fun stats(model: Model): DailyStats {
+        resetIfNewDay()
+        return DailyStats(prefs.getInt(dayKey(model), 0), model.rpd)
+    }
+
+    private fun resetIfNewDay() {
+        val today = LocalDate.now(ZoneId.systemDefault()).toString()
+        val stored = prefs.getString("date", "")
+        if (stored != today) {
+            prefs.edit().clear().putString("date", today).apply()
+            calls.clear()
+        }
+    }
+
+    private fun dayKey(model: Model): String = "${model.name}_day_count"
+}
diff --git a/app/src/main/java/com/aquib/aiagent/safety/SafetyLayer.kt b/app/src/main/java/com/aquib/aiagent/safety/SafetyLayer.kt
new file mode 100644
index 0000000..e76f2ae
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/safety/SafetyLayer.kt
@@ -0,0 +1,12 @@
+package com.aquib.aiagent.safety
+
+import com.aquib.aiagent.models.Step
+
+class SafetyLayer {
+    private val riskyTerms = listOf("pay", "payment", "delete", "factory reset", "send money")
+
+    fun needsConfirmation(step: Step): Boolean {
+        val payload = "${step.targetText.orEmpty()} ${step.value.orEmpty()}".lowercase()
+        return riskyTerms.any { payload.contains(it) }
+    }
+}
diff --git a/app/src/main/java/com/aquib/aiagent/state/AppStateDetector.kt b/app/src/main/java/com/aquib/aiagent/state/AppStateDetector.kt
new file mode 100644
index 0000000..5ef5ede
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/state/AppStateDetector.kt
@@ -0,0 +1,17 @@
+package com.aquib.aiagent.state
+
+import com.aquib.aiagent.models.UiElement
+
+class AppStateDetector {
+    fun detect(packageName: String?, elements: List<UiElement>): String {
+        val app = packageName?.substringAfterLast('.')?.replaceFirstChar { it.uppercase() } ?: "Unknown"
+        val labels = elements.asSequence().map { it.text.lowercase() }.toList()
+        val screen = when {
+            labels.any { it.contains("cart") } -> "Cart"
+            labels.any { it.contains("payment") || it.contains("upi") || it.contains("cash on delivery") } -> "Payment Screen"
+            labels.any { it.contains("search") } -> "Search"
+            else -> "General"
+        }
+        return "$app › $screen"
+    }
+}
diff --git a/app/src/main/java/com/aquib/aiagent/telemetry/Telemetry.kt b/app/src/main/java/com/aquib/aiagent/telemetry/Telemetry.kt
new file mode 100644
index 0000000..d37146e
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/telemetry/Telemetry.kt
@@ -0,0 +1,38 @@
+package com.aquib.aiagent.telemetry
+
+import android.content.Context
+
+data class TaskLog(
+    val goal: String,
+    val steps: Int,
+    val success: Boolean,
+    val durationMs: Long,
+    val failures: Int
+)
+
+class Telemetry(context: Context) {
+    private val prefs = context.getSharedPreferences("telemetry", Context.MODE_PRIVATE)
+
+    fun record(log: TaskLog) {
+        val total = prefs.getInt("total", 0) + 1
+        val success = prefs.getInt("success", 0) + if (log.success) 1 else 0
+        val steps = prefs.getInt("steps", 0) + log.steps
+        prefs.edit()
+            .putInt("total", total)
+            .putInt("success", success)
+            .putInt("steps", steps)
+            .putString("last_failure", if (log.success) "" else log.goal)
+            .apply()
+    }
+
+    fun summary(): String {
+        val total = prefs.getInt("total", 0)
+        val success = prefs.getInt("success", 0)
+        val steps = prefs.getInt("steps", 0)
+        val rate = if (total == 0) 0 else (success * 100 / total)
+        val avg = if (total == 0) 0 else (steps / total)
+        return "Tasks: $total\nSuccess Rate: $rate%\nAvg Steps: $avg\nRecent Failure: ${prefs.getString("last_failure", "None")}".trim()
+    }
+
+    fun failurePatternHint(): String = prefs.getString("last_failure", "") ?: ""
+}
diff --git a/app/src/main/java/com/aquib/aiagent/ui/ElementRanker.kt b/app/src/main/java/com/aquib/aiagent/ui/ElementRanker.kt
new file mode 100644
index 0000000..551b821
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/ui/ElementRanker.kt
@@ -0,0 +1,18 @@
+package com.aquib.aiagent.ui
+
+import com.aquib.aiagent.models.UiElement
+
+class ElementRanker {
+    fun topElements(goal: String, elements: List<UiElement>, limit: Int = 12): List<UiElement> {
+        val terms = goal.lowercase().split(" ").filter { it.isNotBlank() }
+        return elements
+            .sortedByDescending { element ->
+                var score = 0
+                val hay = "${element.text} ${element.contentDescription} ${element.resourceId}".lowercase()
+                terms.forEach { if (hay.contains(it)) score += 3 }
+                if (element.clickable) score += 1
+                score
+            }
+            .take(limit)
+    }
+}
diff --git a/app/src/main/java/com/aquib/aiagent/ui/UIExtractor.kt b/app/src/main/java/com/aquib/aiagent/ui/UIExtractor.kt
new file mode 100644
index 0000000..274837d
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/ui/UIExtractor.kt
@@ -0,0 +1,33 @@
+package com.aquib.aiagent.ui
+
+import android.graphics.Rect
+import android.view.accessibility.AccessibilityNodeInfo
+import com.aquib.aiagent.models.UiElement
+
+class UIExtractor {
+    fun extract(root: AccessibilityNodeInfo?): List<UiElement> {
+        if (root == null) return emptyList()
+        val list = mutableListOf<UiElement>()
+        walk(root, list)
+        return list
+    }
+
+    private fun walk(node: AccessibilityNodeInfo, out: MutableList<UiElement>) {
+        val bounds = Rect()
+        node.getBoundsInScreen(bounds)
+        out += UiElement(
+            text = node.text?.toString().orEmpty(),
+            contentDescription = node.contentDescription?.toString().orEmpty(),
+            resourceId = node.viewIdResourceName.orEmpty(),
+            className = node.className?.toString().orEmpty(),
+            left = bounds.left,
+            top = bounds.top,
+            right = bounds.right,
+            bottom = bounds.bottom,
+            clickable = node.isClickable
+        )
+        for (i in 0 until node.childCount) {
+            node.getChild(i)?.let { walk(it, out) }
+        }
+    }
+}
diff --git a/app/src/main/java/com/aquib/aiagent/util/NotificationHelper.kt b/app/src/main/java/com/aquib/aiagent/util/NotificationHelper.kt
new file mode 100644
index 0000000..d811560
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/util/NotificationHelper.kt
@@ -0,0 +1,32 @@
+package com.aquib.aiagent.util
+
+import android.app.Notification
+import android.app.NotificationChannel
+import android.app.NotificationManager
+import android.content.Context
+import android.os.Build
+import androidx.core.app.NotificationCompat
+import com.aquib.aiagent.R
+
+object NotificationHelper {
+    const val CHANNEL_ID = "ai_agent_foreground"
+
+    fun createChannel(context: Context) {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            val manager = context.getSystemService(NotificationManager::class.java)
+            val channel = NotificationChannel(
+                CHANNEL_ID,
+                context.getString(R.string.notification_channel_name),
+                NotificationManager.IMPORTANCE_LOW
+            )
+            manager.createNotificationChannel(channel)
+        }
+    }
+
+    fun foregroundNotification(context: Context): Notification = NotificationCompat.Builder(context, CHANNEL_ID)
+        .setContentTitle(context.getString(R.string.app_name))
+        .setContentText(context.getString(R.string.notification_text))
+        .setSmallIcon(android.R.drawable.stat_notify_sync)
+        .setOngoing(true)
+        .build()
+}
diff --git a/app/src/main/java/com/aquib/aiagent/util/ScreenshotProvider.kt b/app/src/main/java/com/aquib/aiagent/util/ScreenshotProvider.kt
new file mode 100644
index 0000000..a281683
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/util/ScreenshotProvider.kt
@@ -0,0 +1,52 @@
+package com.aquib.aiagent.util
+
+import android.graphics.Bitmap
+import android.graphics.Canvas
+import android.graphics.Color
+import android.graphics.Paint
+import android.view.accessibility.AccessibilityNodeInfo
+import java.io.ByteArrayOutputStream
+
+class ScreenshotProvider {
+    private val paint = Paint(Paint.ANTI_ALIAS_FLAG).apply {
+        textSize = 14f
+        color = Color.WHITE
+    }
+
+    fun captureSemanticFrame(root: AccessibilityNodeInfo?): ByteArray {
+        var bitmap: Bitmap? = null
+        var stream: ByteArrayOutputStream? = null
+        return try {
+            val lines = mutableListOf<String>()
+            collect(root, lines)
+            val normalized = if (lines.isEmpty()) listOf("EMPTY_TREE") else lines.take(30)
+
+            bitmap = Bitmap.createBitmap(720, 1280, Bitmap.Config.ARGB_8888)
+            val canvas = Canvas(bitmap)
+            canvas.drawColor(0xFF202026.toInt())
+            normalized.forEachIndexed { index, line ->
+                canvas.drawText(line.take(90), 20f, 40f + index * 32f, paint)
+            }
+
+            stream = ByteArrayOutputStream()
+            bitmap.compress(Bitmap.CompressFormat.PNG, 90, stream)
+            stream.toByteArray()
+        } finally {
+            bitmap?.recycle()
+            stream?.close()
+        }
+    }
+
+    private fun collect(node: AccessibilityNodeInfo?, out: MutableList<String>) {
+        node ?: return
+        val text = node.text?.toString().orEmpty().trim()
+        val desc = node.contentDescription?.toString().orEmpty().trim()
+        val id = node.viewIdResourceName.orEmpty()
+        if (text.isNotBlank() || desc.isNotBlank() || id.isNotBlank()) {
+            out += "$text|$desc|$id|click=${node.isClickable}"
+        }
+        for (i in 0 until node.childCount) {
+            collect(node.getChild(i), out)
+        }
+    }
+}
diff --git a/app/src/main/java/com/aquib/aiagent/util/SecurePrefs.kt b/app/src/main/java/com/aquib/aiagent/util/SecurePrefs.kt
new file mode 100644
index 0000000..4f32df7
--- /dev/null
+++ b/app/src/main/java/com/aquib/aiagent/util/SecurePrefs.kt
@@ -0,0 +1,18 @@
+package com.aquib.aiagent.util
+
+import android.content.Context
+import androidx.security.crypto.EncryptedSharedPreferences
+import androidx.security.crypto.MasterKey
+
+class SecurePrefs(context: Context) {
+    private val prefs = EncryptedSharedPreferences.create(
+        context,
+        "ai_agent_secure",
+        MasterKey.Builder(context).setKeyScheme(MasterKey.KeyScheme.AES256_GCM).build(),
+        EncryptedSharedPreferences.PrefKeyEncryptionScheme.AES256_SIV,
+        EncryptedSharedPreferences.PrefValueEncryptionScheme.AES256_GCM
+    )
+
+    fun putString(key: String, value: String) = prefs.edit().putString(key, value).apply()
+    fun getString(key: String, def: String = ""): String = prefs.getString(key, def) ?: def
+}
diff --git a/app/src/main/res/drawable/ic_launcher_foreground.xml b/app/src/main/res/drawable/ic_launcher_foreground.xml
new file mode 100644
index 0000000..5803c2c
--- /dev/null
+++ b/app/src/main/res/drawable/ic_launcher_foreground.xml
@@ -0,0 +1,12 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path
+        android:fillColor="@color/accent"
+        android:pathData="M54,12a42,42 0,1 0,0 84a42,42 0,1 0,0 -84z" />
+    <path
+        android:fillColor="@color/bg"
+        android:pathData="M34,54h40v8h-40zM50,34h8v40h-8z" />
+</vector>
diff --git a/app/src/main/res/layout/activity_main.xml b/app/src/main/res/layout/activity_main.xml
new file mode 100644
index 0000000..1be663d
--- /dev/null
+++ b/app/src/main/res/layout/activity_main.xml
@@ -0,0 +1,108 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.core.widget.NestedScrollView xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:background="@color/bg"
+    android:padding="16dp">
+
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:orientation="vertical">
+
+        <com.google.android.material.card.MaterialCardView
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            app:cardBackgroundColor="@color/surface"
+            app:cardCornerRadius="14dp">
+
+            <LinearLayout
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:orientation="vertical"
+                android:padding="16dp">
+
+                <TextView
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:text="Setup Checklist"
+                    android:textColor="@color/text_primary"
+                    android:textSize="20sp"
+                    android:textStyle="bold" />
+
+                <TextView
+                    android:id="@+id/tvChecklist"
+                    android:layout_width="match_parent"
+                    android:layout_height="wrap_content"
+                    android:layout_marginTop="8dp"
+                    android:lineSpacingExtra="4dp"
+                    android:textColor="@color/text_dim" />
+
+                <com.google.android.material.button.MaterialButton
+                    android:id="@+id/btnFixBattery"
+                    style="@style/Widget.Material3.Button.TonalButton"
+                    android:layout_width="match_parent"
+                    android:layout_height="wrap_content"
+                    android:layout_marginTop="12dp"
+                    android:text="Fix Battery Optimization" />
+            </LinearLayout>
+        </com.google.android.material.card.MaterialCardView>
+
+        <com.google.android.material.card.MaterialCardView
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:layout_marginTop="12dp"
+            app:cardBackgroundColor="@color/surface"
+            app:cardCornerRadius="14dp">
+
+            <LinearLayout
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:orientation="vertical"
+                android:padding="16dp">
+
+                <TextView
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:text="API Key Manager"
+                    android:textColor="@color/text_primary"
+                    android:textStyle="bold" />
+
+                <com.google.android.material.textfield.TextInputLayout
+                    android:layout_width="match_parent"
+                    android:layout_height="wrap_content"
+                    android:layout_marginTop="8dp">
+
+                    <com.google.android.material.textfield.TextInputEditText
+                        android:id="@+id/etApiKey"
+                        android:layout_width="match_parent"
+                        android:layout_height="wrap_content"
+                        android:hint="Gemini API Key" />
+                </com.google.android.material.textfield.TextInputLayout>
+
+                <com.google.android.material.button.MaterialButton
+                    android:id="@+id/btnSaveKey"
+                    android:layout_width="match_parent"
+                    android:layout_height="wrap_content"
+                    android:text="Save Key" />
+            </LinearLayout>
+        </com.google.android.material.card.MaterialCardView>
+
+        <com.google.android.material.card.MaterialCardView
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:layout_marginTop="12dp"
+            app:cardBackgroundColor="@color/surface"
+            app:cardCornerRadius="14dp">
+
+            <TextView
+                android:id="@+id/tvStats"
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:padding="16dp"
+                android:textColor="@color/text_primary"
+                android:typeface="monospace" />
+        </com.google.android.material.card.MaterialCardView>
+    </LinearLayout>
+</androidx.core.widget.NestedScrollView>
diff --git a/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml b/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
new file mode 100644
index 0000000..1bbf556
--- /dev/null
+++ b/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@color/surface" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>
diff --git a/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml b/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml
new file mode 100644
index 0000000..1bbf556
--- /dev/null
+++ b/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@color/surface" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>
diff --git a/app/src/main/res/mipmap-hdpi/ic_launcher.xml b/app/src/main/res/mipmap-hdpi/ic_launcher.xml
new file mode 100644
index 0000000..099ef52
--- /dev/null
+++ b/app/src/main/res/mipmap-hdpi/ic_launcher.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
+    android:gravity="center"
+    android:src="@drawable/ic_launcher_foreground" />
diff --git a/app/src/main/res/mipmap-hdpi/ic_launcher_round.xml b/app/src/main/res/mipmap-hdpi/ic_launcher_round.xml
new file mode 100644
index 0000000..099ef52
--- /dev/null
+++ b/app/src/main/res/mipmap-hdpi/ic_launcher_round.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
+    android:gravity="center"
+    android:src="@drawable/ic_launcher_foreground" />
diff --git a/app/src/main/res/mipmap-mdpi/ic_launcher.xml b/app/src/main/res/mipmap-mdpi/ic_launcher.xml
new file mode 100644
index 0000000..099ef52
--- /dev/null
+++ b/app/src/main/res/mipmap-mdpi/ic_launcher.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
+    android:gravity="center"
+    android:src="@drawable/ic_launcher_foreground" />
diff --git a/app/src/main/res/mipmap-mdpi/ic_launcher_round.xml b/app/src/main/res/mipmap-mdpi/ic_launcher_round.xml
new file mode 100644
index 0000000..099ef52
--- /dev/null
+++ b/app/src/main/res/mipmap-mdpi/ic_launcher_round.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
+    android:gravity="center"
+    android:src="@drawable/ic_launcher_foreground" />
diff --git a/app/src/main/res/mipmap-xhdpi/ic_launcher.xml b/app/src/main/res/mipmap-xhdpi/ic_launcher.xml
new file mode 100644
index 0000000..099ef52
--- /dev/null
+++ b/app/src/main/res/mipmap-xhdpi/ic_launcher.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
+    android:gravity="center"
+    android:src="@drawable/ic_launcher_foreground" />
diff --git a/app/src/main/res/mipmap-xhdpi/ic_launcher_round.xml b/app/src/main/res/mipmap-xhdpi/ic_launcher_round.xml
new file mode 100644
index 0000000..099ef52
--- /dev/null
+++ b/app/src/main/res/mipmap-xhdpi/ic_launcher_round.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
+    android:gravity="center"
+    android:src="@drawable/ic_launcher_foreground" />
diff --git a/app/src/main/res/mipmap-xxhdpi/ic_launcher.xml b/app/src/main/res/mipmap-xxhdpi/ic_launcher.xml
new file mode 100644
index 0000000..099ef52
--- /dev/null
+++ b/app/src/main/res/mipmap-xxhdpi/ic_launcher.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
+    android:gravity="center"
+    android:src="@drawable/ic_launcher_foreground" />
diff --git a/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.xml b/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.xml
new file mode 100644
index 0000000..099ef52
--- /dev/null
+++ b/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
+    android:gravity="center"
+    android:src="@drawable/ic_launcher_foreground" />
diff --git a/app/src/main/res/mipmap-xxxhdpi/ic_launcher.xml b/app/src/main/res/mipmap-xxxhdpi/ic_launcher.xml
new file mode 100644
index 0000000..099ef52
--- /dev/null
+++ b/app/src/main/res/mipmap-xxxhdpi/ic_launcher.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
+    android:gravity="center"
+    android:src="@drawable/ic_launcher_foreground" />
diff --git a/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.xml b/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.xml
new file mode 100644
index 0000000..099ef52
--- /dev/null
+++ b/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
+    android:gravity="center"
+    android:src="@drawable/ic_launcher_foreground" />
diff --git a/app/src/main/res/values/colors.xml b/app/src/main/res/values/colors.xml
new file mode 100644
index 0000000..b308f27
--- /dev/null
+++ b/app/src/main/res/values/colors.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="bg">#111114</color>
+    <color name="surface">#1C1C21</color>
+    <color name="accent">#4DD9E8</color>
+    <color name="text_primary">#D0D0D8</color>
+    <color name="text_dim">#666680</color>
+    <color name="warn">#F7C948</color>
+    <color name="danger">#F97066</color>
+</resources>
diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
new file mode 100644
index 0000000..57a8b6e
--- /dev/null
+++ b/app/src/main/res/values/strings.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="app_name">AI Agent</string>
+    <string name="accessibility_service_desc">Executes local UI actions for AI Agent automation.</string>
+    <string name="notification_channel_name">AI Agent Service</string>
+    <string name="notification_text">AI Agent is running in foreground mode.</string>
+</resources>
diff --git a/app/src/main/res/values/themes.xml b/app/src/main/res/values/themes.xml
new file mode 100644
index 0000000..edd9e20
--- /dev/null
+++ b/app/src/main/res/values/themes.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="Theme.AiAgent" parent="Theme.Material3.Dark.NoActionBar">
+        <item name="android:windowBackground">@color/bg</item>
+        <item name="colorPrimary">@color/accent</item>
+        <item name="colorSecondary">@color/accent</item>
+        <item name="android:textColor">@color/text_primary</item>
+    </style>
+</resources>
diff --git a/app/src/main/res/xml/accessibility_service_config.xml b/app/src/main/res/xml/accessibility_service_config.xml
new file mode 100644
index 0000000..18e457c
--- /dev/null
+++ b/app/src/main/res/xml/accessibility_service_config.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
+    android:accessibilityEventTypes="typeAllMask"
+    android:accessibilityFeedbackType="feedbackGeneric"
+    android:accessibilityFlags="flagReportViewIds|flagRetrieveInteractiveWindows"
+    android:canPerformGestures="true"
+    android:canRetrieveWindowContent="true"
+    android:description="@string/accessibility_service_desc"
+    android:notificationTimeout="100" />
diff --git a/build.gradle.kts b/build.gradle.kts
new file mode 100644
index 0000000..864d71a
--- /dev/null
+++ b/build.gradle.kts
@@ -0,0 +1,4 @@
+plugins {
+    id("com.android.application") version "9.1.0" apply false
+    id("org.jetbrains.kotlin.android") version "2.0.0" apply false
+}
diff --git a/gradle.properties b/gradle.properties
new file mode 100644
index 0000000..a311f80
--- /dev/null
+++ b/gradle.properties
@@ -0,0 +1,4 @@
+org.gradle.jvmargs=-Xmx4g -Dfile.encoding=UTF-8
+android.useAndroidX=true
+android.nonTransitiveRClass=true
+kotlin.code.style=official
diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
new file mode 100644
index 0000000..e2847c8
--- /dev/null
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -0,0 +1,7 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.11.1-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
diff --git a/settings.gradle.kts b/settings.gradle.kts
new file mode 100644
index 0000000..20ccaa8
--- /dev/null
+++ b/settings.gradle.kts
@@ -0,0 +1,18 @@
+pluginManagement {
+    repositories {
+        google()
+        mavenCentral()
+        gradlePluginPortal()
+    }
+}
+
+dependencyResolutionManagement {
+    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
+    repositories {
+        google()
+        mavenCentral()
+    }
+}
+
+rootProject.name = "AI Agent"
+include(":app")

From f26c1ef2e10df43c9a4037df8ea97e243a8f41cf Mon Sep 17 00:00:00 2001
From: Alex72-py <aquibmasud7@gmail.com>
Date: Mon, 16 Mar 2026 21:58:58 +0530
Subject: [PATCH 2/2] Resolve merge follow-up in Gemini client and validate
 conflict-free files

---
 app/src/main/java/com/aquib/aiagent/ai/GeminiApiClient.kt | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/app/src/main/java/com/aquib/aiagent/ai/GeminiApiClient.kt b/app/src/main/java/com/aquib/aiagent/ai/GeminiApiClient.kt
index 01b4a3f..a7d445e 100644
--- a/app/src/main/java/com/aquib/aiagent/ai/GeminiApiClient.kt
+++ b/app/src/main/java/com/aquib/aiagent/ai/GeminiApiClient.kt
@@ -82,7 +82,8 @@ class GeminiApiClient(context: Context) {
         val trimmed = elements.take(12).joinToString("\n") {
             "text=${it.text}, cd=${it.contentDescription}, id=${it.resourceId}, bounds=[${it.left},${it.top},${it.right},${it.bottom}]"
         }
-        val screenshotHint = Base64.encodeToString(screenshot.take(1200).toByteArray(), Base64.NO_WRAP)
+        val head = screenshot.copyOfRange(0, minOf(screenshot.size, 1200))
+        val screenshotHint = Base64.encodeToString(head, Base64.NO_WRAP)
         return """
 You are a planner only. Never execute actions.
 Goal: $goal