catalyst-core 0.2.0-beta.3 → 0.3.0-beta.2

package/dist/native/androidProject/app/src/main/java/io/yourname/androidproject/utils/FrameworkServerUtils.kt

@@ -7,15 +7,21 @@ import io.ktor.http.*
 import io.ktor.server.application.*
 import io.ktor.server.engine.*
 import io.ktor.server.netty.*
+import io.ktor.server.request.*
 import io.ktor.server.response.*
 import io.ktor.server.routing.*
+import io.ktor.http.ContentType
+import io.ktor.server.response.respondTextWriter
+import io.ktor.server.sse.*
 import kotlinx.coroutines.*
+import kotlinx.coroutines.flow.Flow
+import org.json.JSONObject
 import java.io.File
 import java.io.IOException
 import java.net.InetSocketAddress
 import java.nio.channels.ServerSocketChannel
 import java.security.SecureRandom
-import java.util.*
+import java.util.UUID
 import java.util.concurrent.ConcurrentHashMap
 
 /**
@@ -36,6 +42,7 @@ object FrameworkServerUtils {
     private const val FRAMEWORK_PORT_RANGE_START = 3000
     private const val FRAMEWORK_PORT_RANGE_END = 3099
     private const val SESSION_TIMEOUT_MS = 30 * 60 * 1000L // 30 minutes
+    private const val AI_GENERATE_TIMEOUT_MS = 120 * 1000L // 2 minutes
     
     // Server state
     private var server: EmbeddedServer<NettyApplicationEngine, NettyApplicationEngine.Configuration>? = null
@@ -49,7 +56,14 @@ object FrameworkServerUtils {
     // File management
     private val servedFiles = ConcurrentHashMap<String, ServedFile>()
     private var cacheDirectory: File? = null
-    
+
+    // Native AI — supplier set by NativeBridge before POST /ai/stream is called
+    // Returns (conversationId, tokenFlow) so the route can emit conversationId as an SSE event
+    private var nativeAiSupplier: (suspend (prompt: String, genConfig: JSONObject, conversationId: String?) -> Pair<String, Flow<String>>)? = null
+
+    // System prompt injected into every native AI request (built from attachmentComponents at initAI time)
+    private var nativeSystemPrompt: String = ""
+
     // Coroutine scope for server operations
     private val serverScope = CoroutineScope(Dispatchers.IO + SupervisorJob())
     
@@ -60,7 +74,7 @@ object FrameworkServerUtils {
         val fileId: String,
         val createdAt: Long = System.currentTimeMillis()
     )
-    
+
     /**
      * Initialize and start the framework server
      * @param context Android context for file operations
@@ -223,7 +237,21 @@ object FrameworkServerUtils {
      * Get current session ID
      */
     fun getSessionId(): String = sessionId
-    
+
+    /**
+     * Register the native AI supplier. Called by NativeBridge once LiteRT-LM is ready.
+     * The supplier receives the prompt, gen-config, and optional incomingConversationId,
+     * and returns (activeConversationId, tokenFlow) so stateful sessions can be chained.
+     */
+    fun setNativeAiSupplier(supplier: suspend (prompt: String, genConfig: JSONObject, conversationId: String?) -> Pair<String, Flow<String>>) {
+        nativeAiSupplier = supplier
+    }
+
+    fun setNativeSystemPrompt(systemPrompt: String) {
+        nativeSystemPrompt = systemPrompt
+        Log.d(TAG, "System prompt set (${systemPrompt.length} chars)")
+    }
+
     // Private implementation methods
     
     private fun initializeCacheDirectory(context: Context) {
@@ -291,7 +319,145 @@ object FrameworkServerUtils {
     
     private fun startKtorServer() {
         server = embeddedServer(Netty, port = serverPort) {
+            install(SSE)
             routing {
+                // Native AI streaming endpoint — POST body: { "prompt": "...", "genConfig": {...} }
+                // Writes SSE manually over chunked response (Ktor SSE plugin only supports GET).
+                post("/framework-$sessionId/ai/stream") {
+                    call.response.header(HttpHeaders.AccessControlAllowOrigin, allowedOrigin)
+                    call.response.header(HttpHeaders.AccessControlAllowHeaders, "*")
+                    call.response.header(HttpHeaders.ContentType, "text/event-stream")
+                    call.response.header(HttpHeaders.CacheControl, "no-cache")
+                    call.response.header("X-Accel-Buffering", "no")
+
+                    val body = try {
+                        JSONObject(call.receiveText())
+                    } catch (e: Exception) {
+                        JSONObject()
+                    }
+                    val userPrompt = body.optString("prompt", "")
+                    val genConfig = body.optJSONObject("genConfig") ?: JSONObject()
+                    val incomingConvId = body.optString("conversationId", "").takeIf { it.isNotBlank() }
+                    if (nativeSystemPrompt.isNotBlank()) Log.d(TAG, "Injecting system prompt (${nativeSystemPrompt.length} chars)")
+                    val prompt = if (nativeSystemPrompt.isNotBlank()) "$nativeSystemPrompt\n\n$userPrompt" else userPrompt
+
+                    call.respondTextWriter(contentType = ContentType.Text.EventStream) {
+                        val supplier = nativeAiSupplier
+                        if (supplier == null) {
+                            write("data: {\"error\":\"Native AI not initialised — call initAI() first\"}\n\n")
+                            flush()
+                        } else if (prompt.isBlank()) {
+                            write("data: {\"error\":\"prompt is empty\"}\n\n")
+                            flush()
+                        } else {
+                            try {
+                                val (activeConvId, tokenFlow) = supplier(prompt, genConfig, incomingConvId)
+                                write("data: {\"conversationId\":${JSONObject.quote(activeConvId)}}\n\n")
+                                flush()
+                                tokenFlow.collect { token ->
+                                    write("data: {\"token\":${JSONObject.quote(token)}}\n\n")
+                                    flush()
+                                }
+                                write("data: {\"done\":true}\n\n")
+                                flush()
+                            } catch (e: java.io.IOException) {
+                                // Client disconnected — channel closed, nothing to write
+                                Log.d(TAG, "Native AI stream: client disconnected (${e.message})")
+                            } catch (e: Exception) {
+                                Log.e(TAG, "Native AI stream error", e)
+                                try {
+                                    write("data: {\"error\":${JSONObject.quote(e.message ?: "stream error")}}\n\n")
+                                    flush()
+                                } catch (_: java.io.IOException) {
+                                    // Channel already closed, ignore
+                                }
+                            }
+                        }
+                    }
+                }
+
+                // OPTIONS preflight for ai/stream
+                options("/framework-$sessionId/ai/stream") {
+                    call.response.header(HttpHeaders.AccessControlAllowOrigin, allowedOrigin)
+                    call.response.header(HttpHeaders.AccessControlAllowMethods, "POST, OPTIONS")
+                    call.response.header(HttpHeaders.AccessControlAllowHeaders, "*")
+                    call.response.header(HttpHeaders.AccessControlMaxAge, "86400")
+                    call.respond(HttpStatusCode.OK)
+                }
+
+                // Native AI non-streaming endpoint — POST body: { "prompt": "...", "genConfig": {...} }
+                // Drains nativeAiSupplier's tokenFlow fully, then returns a single JSON response.
+                post("/framework-$sessionId/ai/generate") {
+                    call.response.header(HttpHeaders.AccessControlAllowOrigin, allowedOrigin)
+                    call.response.header(HttpHeaders.AccessControlAllowHeaders, "*")
+
+                    val body = try {
+                        JSONObject(call.receiveText())
+                    } catch (e: Exception) {
+                        JSONObject()
+                    }
+                    val userPrompt = body.optString("prompt", "")
+                    val genConfig = body.optJSONObject("genConfig") ?: JSONObject()
+                    val incomingConvId = body.optString("conversationId", "").takeIf { it.isNotBlank() }
+                    if (nativeSystemPrompt.isNotBlank()) Log.d(TAG, "Injecting system prompt (${nativeSystemPrompt.length} chars)")
+                    val prompt = if (nativeSystemPrompt.isNotBlank()) "$nativeSystemPrompt\n\n$userPrompt" else userPrompt
+
+                    val supplier = nativeAiSupplier
+                    if (supplier == null) {
+                        call.respondText(
+                            JSONObject().put("error", "Native AI not initialised — call initAI() first").toString(),
+                            ContentType.Application.Json,
+                            HttpStatusCode.ServiceUnavailable
+                        )
+                        return@post
+                    }
+                    if (prompt.isBlank()) {
+                        call.respondText(
+                            JSONObject().put("error", "prompt is empty").toString(),
+                            ContentType.Application.Json,
+                            HttpStatusCode.BadRequest
+                        )
+                        return@post
+                    }
+
+                    try {
+                        val (activeConvId, tokenFlow) = supplier(prompt, genConfig, incomingConvId)
+                        val output = StringBuilder()
+                        var tokenCount = 0
+                        withTimeout(AI_GENERATE_TIMEOUT_MS) {
+                            tokenFlow.collect { token -> output.append(token); tokenCount++ }
+                        }
+                        val responseJson = JSONObject()
+                            .put("output", output.toString())
+                            .put("conversationId", activeConvId)
+                            .put("tokenCount", tokenCount)
+                        call.respondText(responseJson.toString(), ContentType.Application.Json, HttpStatusCode.OK)
+                    } catch (e: TimeoutCancellationException) {
+                        Log.e(TAG, "Native AI generate timed out after ${AI_GENERATE_TIMEOUT_MS}ms", e)
+                        call.respondText(
+                            JSONObject().put("error", "generate timed out after ${AI_GENERATE_TIMEOUT_MS / 1000}s").toString(),
+                            ContentType.Application.Json,
+                            HttpStatusCode.GatewayTimeout
+                        )
+                    } catch (e: Exception) {
+                        Log.e(TAG, "Native AI generate error", e)
+                        call.respondText(
+                            JSONObject().put("error", (e.message ?: "generate error")).toString(),
+                            ContentType.Application.Json,
+                            HttpStatusCode.InternalServerError
+                        )
+                    }
+                }
+
+                // OPTIONS preflight for ai/generate
+                options("/framework-$sessionId/ai/generate") {
+                    call.response.header(HttpHeaders.AccessControlAllowOrigin, allowedOrigin)
+                    call.response.header(HttpHeaders.AccessControlAllowMethods, "POST, OPTIONS")
+                    call.response.header(HttpHeaders.AccessControlAllowHeaders, "*")
+                    call.response.header(HttpHeaders.AccessControlMaxAge, "86400")
+                    call.respond(HttpStatusCode.OK)
+                }
+
                 get("/framework-$sessionId/file-{fileId}") {
                     val fileId = call.parameters["fileId"]
                     
@@ -385,22 +551,16 @@ object FrameworkServerUtils {
         val expiredFiles = servedFiles.filter { (_, servedFile) ->
             currentTime - servedFile.createdAt > SESSION_TIMEOUT_MS
         }
-        
         if (expiredFiles.isNotEmpty()) {
             Log.d(TAG, "Cleaning up ${expiredFiles.size} expired files")
-            
-            expiredFiles.forEach { (fileId, _) ->
-                removeServedFile(fileId)
-            }
+            expiredFiles.forEach { (fileId, _) -> removeServedFile(fileId) }
         }
+
     }
     
     private fun cleanupAllFiles() {
         Log.d(TAG, "Cleaning up all served files (${servedFiles.size} files)")
-        
-        servedFiles.keys.toList().forEach { fileId ->
-            removeServedFile(fileId)
-        }
+        servedFiles.keys.toList().forEach { fileId -> removeServedFile(fileId) }
         
         // Clean cache directory
         cacheDirectory?.listFiles()?.forEach { file ->

package/dist/native/androidProject/settings.gradle.kts

@@ -33,3 +33,13 @@ dependencyResolutionManagement {
 
 rootProject.name = "Catalyst Application"
 include(":app")
+
+// @catalyst/cloud-ai — include when the package is installed.
+// The npm package ships an /android library module for native AI; wire it here so Gradle picks it up.
+// After running: npm install @catalyst/cloud-ai && npm run sync-packages -- --packages cloud-ai
+// Also set ai.enabled=true in your app config to enable useLegacyPackaging for GPU dlopen().
+val cloudAiDir = File(rootDir, "../node_modules/@catalyst/cloud-ai/android")
+if (cloudAiDir.exists()) {
+    include(":catalyst-cloud-ai")
+    project(":catalyst-cloud-ai").projectDir = cloudAiDir
+}

package/dist/native/androidSetup.js

@@ -1,9 +1,301 @@
-"use strict";var _fs=_interopRequireDefault(require("fs"));var _path=_interopRequireDefault(require("path"));var _child_process=require("child_process");var _utils=require("./utils.js");var _TerminalProgress=_interopRequireDefault(require("./TerminalProgress.js"));var _setupServer=require("./setupServer.js");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}const catalystCorePath=_path.default.dirname(require.resolve("catalyst-core/package.json"));const pwd=_path.default.join(catalystCorePath,"dist/native");const configPath=`${process.env.PWD}/config/config.json`;const steps={java:"Check Java Environment",config:"Initialize Configuration",androidTools:"Validate Android Tools",emulator:"Configure Android Emulator",properties:"Update Local Properties",saveConfig:"Save Configuration",setupServer:"Setup Server"};const progressPaddingConfig={titlePaddingTop:2,titlePaddingBottom:1,stepPaddingLeft:4,stepSpacing:1,errorPaddingLeft:6,bottomMargin:2};const progress=new _TerminalProgress.default(steps,"Catalyst Universal Android Setup",progressPaddingConfig);async function checkJavaInstallation(){try{(0,_utils.runCommand)("java -version");(0,_utils.runCommand)("javac -version");progress.log("Java is installed and configured","success");return true;}catch(error){progress.log("Java installation not found or not properly configured","error");return false;}}async function installJava(){progress.log("Installing Java (Zulu JDK 17)...");try{try{(0,_utils.runCommand)("brew --version");}catch(error){throw new Error("Homebrew is required but not installed. Please install Homebrew first.");}const javaHome="/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home";// Try installing Java
-try{await(0,_utils.runCommand)("brew install --cask zulu@17");}catch(error){if(error.message.includes("already installed")){progress.log("Attempting to reinstall Java...","info");try{await(0,_utils.runCommand)("brew reinstall --cask zulu@17");}catch(reinstallError){throw new Error(`Failed to reinstall Java: ${reinstallError.message}. Please run 'brew reinstall --cask zulu@17' manually.`);}}else{throw error;}}// Verify Java installation
-if(!_fs.default.existsSync(javaHome)){throw new Error(`Java installation not found at ${javaHome}. Please verify the installation manually.`);}// Set up environment variables
-const homeDir=process.env.HOME;const shellProfile=`${homeDir}/.zshrc`;const exportCommand=`\n# Java Configuration\nexport JAVA_HOME=${javaHome}\nexport PATH=$JAVA_HOME/bin:$PATH\n`;try{_fs.default.appendFileSync(shellProfile,exportCommand);}catch(error){throw new Error(`Failed to update ${shellProfile}: ${error.message}. Please add the following lines manually:\n${exportCommand}`);}// Set for current process
-process.env.JAVA_HOME=javaHome;process.env.PATH=`${javaHome}/bin:${process.env.PATH}`;// Verify Java configuration
-try{const javaVersion=(0,_utils.runCommand)("java -version");progress.log("Java installed and configured successfully","success");progress.log(`Java Version: ${javaVersion}`,"info");progress.log(`IMPORTANT: Please run the following commands to complete setup:`,"warning");progress.log(`1. source ${shellProfile}`,"info");progress.log(`2. echo $JAVA_HOME`,"info");return true;}catch(error){throw new Error(`Java installation verified but environment not configured. Please run:\n1. source ${shellProfile}\n2. echo $JAVA_HOME`);}}catch(error){progress.log(error.message,"error");progress.log("Manual Setup Instructions:","info");progress.log("1. Run: brew reinstall --cask zulu@17","info");progress.log("2. Add to ~/.zshrc:","info");progress.log("   export JAVA_HOME=/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home","info");progress.log("   export PATH=$JAVA_HOME/bin:$PATH","info");progress.log("3. Run: source ~/.zshrc","info");throw error;}}async function validateJavaEnvironment(){progress.start("java");const hasJava=await checkJavaInstallation();if(!hasJava){progress.log("Java installation required. Starting installation process...");const javaInstalled=await installJava();if(!javaInstalled){progress.fail("java","Failed to set up Java environment");throw new Error("Failed to set up Java environment");}}progress.complete("java");}async function initializeConfig(){const configFile=_fs.default.readFileSync(configPath,"utf8");const config=JSON.parse(configFile);const{WEBVIEW_CONFIG}=config;if(!WEBVIEW_CONFIG||Object.keys(WEBVIEW_CONFIG).length===0){progress.log("WebView Config missing in "+configPath,"error");process.exit(1);}if(!WEBVIEW_CONFIG.android){WEBVIEW_CONFIG.android={};}return{WEBVIEW_CONFIG};}async function saveConfig(newConfig){try{const existingConfigFile=_fs.default.readFileSync(configPath,"utf8");const existingConfig=JSON.parse(existingConfigFile);const updatedConfig={...existingConfig,WEBVIEW_CONFIG:{...existingConfig.WEBVIEW_CONFIG,android:newConfig.WEBVIEW_CONFIG.android}};_fs.default.writeFileSync(configPath,JSON.stringify(updatedConfig,null,2));progress.log("Configuration saved successfully","success");}catch(error){progress.log("Failed to save configuration: "+error.message,"error");process.exit(1);}}function validateAndroidTools(androidConfig){const ANDROID_SDK=androidConfig.sdkPath;const EMULATOR_PATH=`${ANDROID_SDK}/emulator/emulator`;const ADB_PATH=`${ANDROID_SDK}/platform-tools/adb`;if(!ANDROID_SDK){throw new Error("Android SDK path is not configured");}if(!_fs.default.existsSync(ANDROID_SDK)){throw new Error(`Android SDK path does not exist: ${ANDROID_SDK}`);}if(!_fs.default.existsSync(ADB_PATH)){throw new Error(`ADB not found at: ${ADB_PATH}`);}try{(0,_utils.runCommand)(`${ADB_PATH} version`);progress.log("ADB is valid","success");}catch(error){throw new Error(`ADB is not working properly: ${error.message}`);}if(!_fs.default.existsSync(EMULATOR_PATH)){throw new Error(`Emulator not found at: ${EMULATOR_PATH}`);}try{(0,_utils.runCommand)(`${EMULATOR_PATH} -version`);progress.log("Emulator is valid","success");}catch(error){throw new Error(`Emulator is not working properly: ${error.message}`);}try{const avdOutput=(0,_utils.runCommand)(`${EMULATOR_PATH} -list-avds`);if(!avdOutput.includes(androidConfig.emulatorName)){throw new Error(`Specified emulator "${androidConfig.emulatorName}" not found in available AVDs`);}progress.log(`Emulator "${androidConfig.emulatorName}" exists`,"success");}catch(error){throw new Error(`Error checking emulator AVD: ${error.message}`);}progress.log("Android tools validation completed successfully!","success");return{EMULATOR_PATH,ADB_PATH};}async function checkEmulator(ADB_PATH){try{const devices=(0,_utils.runCommand)(`${ADB_PATH} devices`);return devices.includes("emulator");}catch(error){progress.log(`Error checking emulator: ${error}`,"error");return false;}}async function startEmulator(EMULATOR_PATH,androidConfig){progress.log(`Starting emulator: ${androidConfig.emulatorName}...`);// eslint-disable-next-line security/detect-child-process
-// nosemgrep: javascript.lang.security.detect-child-process.detect-child-process - EMULATOR_PATH is derived from SDK configuration and emulatorName is local native setup config.
-(0,_child_process.exec)(`${EMULATOR_PATH} -avd ${androidConfig.emulatorName} -read-only > /dev/null &`,error=>{if(error){progress.log(`Error starting emulator: ${error}`,"error");}});}async function updateLocalProperties(sdkPath){progress.start("properties");try{(0,_utils.runCommand)(`cd ${pwd}/androidProject && ./gradlew updateSdkPath -PsdkPath="${sdkPath}"`);progress.log("Updated local.properties successfully","success");progress.complete("properties");}catch(error){progress.fail("properties",`Failed to update local.properties: ${error.message}`);throw error;}}async function setupAndroidEnvironment(){try{await validateJavaEnvironment();progress.start("config");await initializeConfig();const config=await(0,_utils.validateAndCompleteConfig)("android",configPath);progress.complete("config");progress.start("androidTools");const{EMULATOR_PATH,ADB_PATH}=validateAndroidTools(config.android);progress.complete("androidTools");progress.start("emulator");const emulatorRunning=await checkEmulator(ADB_PATH);if(!emulatorRunning){progress.log("No emulator running, attempting to start one...");await startEmulator(EMULATOR_PATH,config.android);}else{progress.log("Emulator already running, proceeding with installation...","success");}progress.complete("emulator");if(config.android?.sdkPath){await updateLocalProperties(config.android.sdkPath);}progress.start("saveConfig");await saveConfig({WEBVIEW_CONFIG:config});progress.complete("saveConfig");progress.start("setupServer");await(0,_setupServer.setupServer)(configPath);progress.complete("setupServer");progress.printTreeContent("Configuration Explanation",["WEBVIEW_CONFIG: Main configuration object for the WebView setup",{text:"port: Port number for the WebView server",indent:1,prefix:"├─ ",color:"gray"},{text:"android: Android-specific configuration",indent:1,prefix:"└─ ",color:"gray"},{text:"buildType: Build type (debug/release)",indent:2,prefix:"├─ ",color:"gray"},{text:"sdkPath: Android SDK path",indent:2,prefix:"├─ ",color:"gray"},{text:"emulatorName: Selected Android emulator name",indent:2,prefix:"└─ ",color:"gray"}]);progress.printTreeContent("Final Configuration",[JSON.stringify(config,null,2)]);process.exit(0);}catch(error){if(progress.currentStep){progress.fail(progress.currentStep.id,error.message);}process.exit(1);}}// Execute the main setup
+"use strict";
+
+var _fs = _interopRequireDefault(require("fs"));
+var _path = _interopRequireDefault(require("path"));
+var _child_process = require("child_process");
+var _utils = require("./utils.js");
+var _TerminalProgress = _interopRequireDefault(require("./TerminalProgress.js"));
+var _setupServer = require("./setupServer.js");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const catalystCorePath = _path.default.dirname(require.resolve("catalyst-core/package.json"));
+const pwd = _path.default.join(catalystCorePath, "dist/native");
+const configPath = `${process.env.PWD}/config/config.json`;
+const steps = {
+  java: "Check Java Environment",
+  config: "Initialize Configuration",
+  androidTools: "Validate Android Tools",
+  emulator: "Configure Android Emulator",
+  properties: "Update Local Properties",
+  saveConfig: "Save Configuration",
+  setupServer: "Setup Server"
+};
+const progressPaddingConfig = {
+  titlePaddingTop: 2,
+  titlePaddingBottom: 1,
+  stepPaddingLeft: 4,
+  stepSpacing: 1,
+  errorPaddingLeft: 6,
+  bottomMargin: 2
+};
+const progress = new _TerminalProgress.default(steps, "Catalyst Universal Android Setup", progressPaddingConfig);
+async function checkJavaInstallation() {
+  try {
+    (0, _utils.runCommand)("java -version");
+    (0, _utils.runCommand)("javac -version");
+    progress.log("Java is installed and configured", "success");
+    return true;
+  } catch (error) {
+    progress.log("Java installation not found or not properly configured", "error");
+    return false;
+  }
+}
+async function installJava() {
+  progress.log("Installing Java (Zulu JDK 17)...");
+  try {
+    try {
+      (0, _utils.runCommand)("brew --version");
+    } catch (error) {
+      throw new Error("Homebrew is required but not installed. Please install Homebrew first.");
+    }
+    const javaHome = "/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home";
+
+    // Try installing Java
+    try {
+      await (0, _utils.runCommand)("brew install --cask zulu@17");
+    } catch (error) {
+      if (error.message.includes("already installed")) {
+        progress.log("Attempting to reinstall Java...", "info");
+        try {
+          await (0, _utils.runCommand)("brew reinstall --cask zulu@17");
+        } catch (reinstallError) {
+          throw new Error(`Failed to reinstall Java: ${reinstallError.message}. Please run 'brew reinstall --cask zulu@17' manually.`);
+        }
+      } else {
+        throw error;
+      }
+    }
+
+    // Verify Java installation
+    if (!_fs.default.existsSync(javaHome)) {
+      throw new Error(`Java installation not found at ${javaHome}. Please verify the installation manually.`);
+    }
+
+    // Set up environment variables
+    const homeDir = process.env.HOME;
+    const shellProfile = `${homeDir}/.zshrc`;
+    const exportCommand = `\n# Java Configuration\nexport JAVA_HOME=${javaHome}\nexport PATH=$JAVA_HOME/bin:$PATH\n`;
+    try {
+      _fs.default.appendFileSync(shellProfile, exportCommand);
+    } catch (error) {
+      throw new Error(`Failed to update ${shellProfile}: ${error.message}. Please add the following lines manually:\n${exportCommand}`);
+    }
+
+    // Set for current process
+    process.env.JAVA_HOME = javaHome;
+    process.env.PATH = `${javaHome}/bin:${process.env.PATH}`;
+
+    // Verify Java configuration
+    try {
+      const javaVersion = (0, _utils.runCommand)("java -version");
+      progress.log("Java installed and configured successfully", "success");
+      progress.log(`Java Version: ${javaVersion}`, "info");
+      progress.log(`IMPORTANT: Please run the following commands to complete setup:`, "warning");
+      progress.log(`1. source ${shellProfile}`, "info");
+      progress.log(`2. echo $JAVA_HOME`, "info");
+      return true;
+    } catch (error) {
+      throw new Error(`Java installation verified but environment not configured. Please run:\n1. source ${shellProfile}\n2. echo $JAVA_HOME`);
+    }
+  } catch (error) {
+    progress.log(error.message, "error");
+    progress.log("Manual Setup Instructions:", "info");
+    progress.log("1. Run: brew reinstall --cask zulu@17", "info");
+    progress.log("2. Add to ~/.zshrc:", "info");
+    progress.log("   export JAVA_HOME=/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home", "info");
+    progress.log("   export PATH=$JAVA_HOME/bin:$PATH", "info");
+    progress.log("3. Run: source ~/.zshrc", "info");
+    throw error;
+  }
+}
+async function validateJavaEnvironment() {
+  progress.start("java");
+  const hasJava = await checkJavaInstallation();
+  if (!hasJava) {
+    progress.log("Java installation required. Starting installation process...");
+    const javaInstalled = await installJava();
+    if (!javaInstalled) {
+      progress.fail("java", "Failed to set up Java environment");
+      throw new Error("Failed to set up Java environment");
+    }
+  }
+  progress.complete("java");
+}
+async function initializeConfig() {
+  const configFile = _fs.default.readFileSync(configPath, "utf8");
+  const config = JSON.parse(configFile);
+  const {
+    WEBVIEW_CONFIG
+  } = config;
+  if (!WEBVIEW_CONFIG || Object.keys(WEBVIEW_CONFIG).length === 0) {
+    progress.log("WebView Config missing in " + configPath, "error");
+    process.exit(1);
+  }
+  if (!WEBVIEW_CONFIG.android) {
+    WEBVIEW_CONFIG.android = {};
+  }
+  return {
+    WEBVIEW_CONFIG
+  };
+}
+async function saveConfig(newConfig) {
+  try {
+    const existingConfigFile = _fs.default.readFileSync(configPath, "utf8");
+    const existingConfig = JSON.parse(existingConfigFile);
+    const updatedConfig = {
+      ...existingConfig,
+      WEBVIEW_CONFIG: {
+        ...existingConfig.WEBVIEW_CONFIG,
+        android: newConfig.WEBVIEW_CONFIG.android
+      }
+    };
+    _fs.default.writeFileSync(configPath, JSON.stringify(updatedConfig, null, 2));
+    progress.log("Configuration saved successfully", "success");
+  } catch (error) {
+    progress.log("Failed to save configuration: " + error.message, "error");
+    process.exit(1);
+  }
+}
+function validateAndroidTools(androidConfig) {
+  const ANDROID_SDK = androidConfig.sdkPath;
+  const EMULATOR_PATH = `${ANDROID_SDK}/emulator/emulator`;
+  const ADB_PATH = `${ANDROID_SDK}/platform-tools/adb`;
+  if (!ANDROID_SDK) {
+    throw new Error("Android SDK path is not configured");
+  }
+  if (!_fs.default.existsSync(ANDROID_SDK)) {
+    throw new Error(`Android SDK path does not exist: ${ANDROID_SDK}`);
+  }
+  if (!_fs.default.existsSync(ADB_PATH)) {
+    throw new Error(`ADB not found at: ${ADB_PATH}`);
+  }
+  try {
+    (0, _utils.runCommand)(`${ADB_PATH} version`);
+    progress.log("ADB is valid", "success");
+  } catch (error) {
+    throw new Error(`ADB is not working properly: ${error.message}`);
+  }
+  if (!_fs.default.existsSync(EMULATOR_PATH)) {
+    throw new Error(`Emulator not found at: ${EMULATOR_PATH}`);
+  }
+  try {
+    (0, _utils.runCommand)(`${EMULATOR_PATH} -version`);
+    progress.log("Emulator is valid", "success");
+  } catch (error) {
+    throw new Error(`Emulator is not working properly: ${error.message}`);
+  }
+  try {
+    const avdOutput = (0, _utils.runCommand)(`${EMULATOR_PATH} -list-avds`);
+    if (!avdOutput.includes(androidConfig.emulatorName)) {
+      throw new Error(`Specified emulator "${androidConfig.emulatorName}" not found in available AVDs`);
+    }
+    progress.log(`Emulator "${androidConfig.emulatorName}" exists`, "success");
+  } catch (error) {
+    throw new Error(`Error checking emulator AVD: ${error.message}`);
+  }
+  progress.log("Android tools validation completed successfully!", "success");
+  return {
+    EMULATOR_PATH,
+    ADB_PATH
+  };
+}
+async function checkEmulator(ADB_PATH) {
+  try {
+    const devices = (0, _utils.runCommand)(`${ADB_PATH} devices`);
+    return devices.includes("emulator");
+  } catch (error) {
+    progress.log(`Error checking emulator: ${error}`, "error");
+    return false;
+  }
+}
+async function startEmulator(EMULATOR_PATH, androidConfig) {
+  progress.log(`Starting emulator: ${androidConfig.emulatorName}...`);
+  // nosemgrep: javascript.lang.security.detect-child-process.detect-child-process - EMULATOR_PATH is derived from SDK configuration and emulatorName is local native setup config.
+  // eslint-disable-next-line security/detect-child-process
+  (0, _child_process.exec)(`${EMULATOR_PATH} -avd ${androidConfig.emulatorName} -read-only > /dev/null &`, error => {
+    if (error) {
+      progress.log(`Error starting emulator: ${error}`, "error");
+    }
+  });
+}
+async function updateLocalProperties(sdkPath) {
+  progress.start("properties");
+  try {
+    (0, _utils.runCommand)(`cd ${pwd}/androidProject && ./gradlew updateSdkPath -PsdkPath="${sdkPath}"`);
+    progress.log("Updated local.properties successfully", "success");
+    progress.complete("properties");
+  } catch (error) {
+    progress.fail("properties", `Failed to update local.properties: ${error.message}`);
+    throw error;
+  }
+}
+async function setupAndroidEnvironment() {
+  try {
+    await validateJavaEnvironment();
+    progress.start("config");
+    await initializeConfig();
+    const config = await (0, _utils.validateAndCompleteConfig)("android", configPath);
+    progress.complete("config");
+    progress.start("androidTools");
+    const {
+      EMULATOR_PATH,
+      ADB_PATH
+    } = validateAndroidTools(config.android);
+    progress.complete("androidTools");
+    progress.start("emulator");
+    const emulatorRunning = await checkEmulator(ADB_PATH);
+    if (!emulatorRunning) {
+      progress.log("No emulator running, attempting to start one...");
+      await startEmulator(EMULATOR_PATH, config.android);
+    } else {
+      progress.log("Emulator already running, proceeding with installation...", "success");
+    }
+    progress.complete("emulator");
+    if (config.android?.sdkPath) {
+      await updateLocalProperties(config.android.sdkPath);
+    }
+    progress.start("saveConfig");
+    await saveConfig({
+      WEBVIEW_CONFIG: config
+    });
+    progress.complete("saveConfig");
+    progress.start("setupServer");
+    await (0, _setupServer.setupServer)(configPath);
+    progress.complete("setupServer");
+    progress.printTreeContent("Configuration Explanation", ["WEBVIEW_CONFIG: Main configuration object for the WebView setup", {
+      text: "port: Port number for the WebView server",
+      indent: 1,
+      prefix: "├─ ",
+      color: "gray"
+    }, {
+      text: "android: Android-specific configuration",
+      indent: 1,
+      prefix: "└─ ",
+      color: "gray"
+    }, {
+      text: "buildType: Build type (debug/release)",
+      indent: 2,
+      prefix: "├─ ",
+      color: "gray"
+    }, {
+      text: "sdkPath: Android SDK path",
+      indent: 2,
+      prefix: "├─ ",
+      color: "gray"
+    }, {
+      text: "emulatorName: Selected Android emulator name",
+      indent: 2,
+      prefix: "└─ ",
+      color: "gray"
+    }]);
+    progress.printTreeContent("Final Configuration", [JSON.stringify(config, null, 2)]);
+    process.exit(0);
+  } catch (error) {
+    if (progress.currentStep) {
+      progress.fail(progress.currentStep.id, error.message);
+    }
+    process.exit(1);
+  }
+}
+
+// Execute the main setup
 setupAndroidEnvironment();