neoagent 2.3.1-beta.71 → 2.3.1-beta.73

package/docs/configuration.md

@@ -134,6 +134,8 @@ Runtime profile and backend selection are stored in user settings, not normally
 
 Production policy can require the VM backend. In that case, set a strong `NEOAGENT_VM_GUEST_TOKEN` of at least 32 characters and avoid placeholder values.
 
+The VM backend requires QEMU on the host machine. It runs an x86_64 Ubuntu guest so the Android emulator can run in the same isolated runtime as the browser. On macOS, install QEMU with `brew install qemu`. On Ubuntu or Debian, install `qemu-system` and `qemu-utils` from apt before starting NeoAgent.
+
 The app exposes two browser backend choices: VM and Chrome extension. VM uses the local isolated runtime. Chrome extension uses the paired extension connection on the remote machine instead of the server-local browser. To install only the extension on a remote machine, open NeoAgent, download `/api/browser-extension/download`, unzip it, load the folder through `chrome://extensions` with Developer mode enabled, then pair after logging in to NeoAgent. Unpacked Chrome extensions cannot replace themselves automatically; use the extension popup's update check to compare against the server bundle, then download and reload the latest ZIP when needed.
 
 ## Secrets Guidance

package/docs/getting-started.md

@@ -5,10 +5,27 @@ NeoAgent installs as a Node CLI and runs a self-hosted server with a bundled Flu
 ## Requirements
 
 - Node.js 20 or newer.
+- QEMU for VM-backed browser and Android runs.
 - A reachable server URL if you want OAuth callbacks, mobile access, or messaging webhooks.
 - At least one hosted AI provider API key, unless you only use local Ollama.
 - Android Studio or a Flutter Android toolchain if you build the Android client yourself.
 
+### QEMU Installation
+
+NeoAgent uses a per-user x86_64 VM for browser and Android execution. Install QEMU before starting the service:
+
+```bash
+# macOS
+brew install qemu
+
+# Ubuntu / Debian
+sudo apt-get update
+sudo apt-get install -y qemu-system qemu-utils
+```
+
+The first VM boot also downloads the Ubuntu base image and seeds the guest runtime automatically.
+That guest bootstrap installs the browser and Android runtime dependencies it needs, including Java and the emulator support packages.
+
 ## Install
 
 ```bash

package/flutter_app/lib/main_account_settings.dart

@@ -167,6 +167,7 @@ class AccountSettingsPanel extends StatefulWidget {
 
 class _AccountSettingsPanelState extends State<AccountSettingsPanel> {
   late AccountSettingsTab _selectedTab;
+  late final TextEditingController _displayNameController;
   late final TextEditingController _emailController;
   late final TextEditingController _emailPasswordController;
   late final TextEditingController _setupPasswordController;
@@ -178,6 +179,8 @@ class _AccountSettingsPanelState extends State<AccountSettingsPanel> {
   late final TextEditingController _confirmNewPasswordController;
   Map<String, dynamic>? _pendingSetup;
   List<String> _recoveryCodes = const <String>[];
+  String? _displayNameSuccessMessage;
+  String? _displayNameInlineError;
   String? _emailSuccessMessage;
   String? _emailInlineError;
   String? _passwordSuccessMessage;
@@ -187,6 +190,9 @@ class _AccountSettingsPanelState extends State<AccountSettingsPanel> {
   void initState() {
     super.initState();
     _selectedTab = widget.initialTab ?? AccountSettingsTab.account;
+    _displayNameController = TextEditingController(
+      text: widget.controller.user?['display_name']?.toString() ?? '',
+    );
     _emailController = TextEditingController(
       text: widget.controller.user?['email']?.toString() ?? '',
     );
@@ -208,6 +214,11 @@ class _AccountSettingsPanelState extends State<AccountSettingsPanel> {
         oldWidget.initialTab != widget.initialTab) {
       _selectedTab = widget.initialTab!;
     }
+    final displayName =
+        widget.controller.user?['display_name']?.toString() ?? '';
+    if (_displayNameController.text.isEmpty && displayName.isNotEmpty) {
+      _displayNameController.text = displayName;
+    }
     final email = widget.controller.user?['email']?.toString() ?? '';
     if (_emailController.text.isEmpty && email.isNotEmpty) {
       _emailController.text = email;
@@ -216,6 +227,7 @@ class _AccountSettingsPanelState extends State<AccountSettingsPanel> {
 
   @override
   void dispose() {
+    _displayNameController.dispose();
     _emailController.dispose();
     _emailPasswordController.dispose();
     _setupPasswordController.dispose();
@@ -409,6 +421,56 @@ class _AccountSettingsPanelState extends State<AccountSettingsPanel> {
         const SizedBox(height: 12),
         _MetaPill(label: username, icon: Icons.person_outline),
         const SizedBox(height: 18),
+        TextField(
+          controller: _displayNameController,
+          decoration: const InputDecoration(
+            labelText: 'Display name',
+            helperText: 'Shown in the sidebar. Leave blank to use your username.',
+          ),
+        ),
+        if (_displayNameInlineError != null) ...<Widget>[
+          const SizedBox(height: 10),
+          _InlineError(message: _displayNameInlineError!),
+        ],
+        if (_displayNameSuccessMessage != null) ...<Widget>[
+          const SizedBox(height: 10),
+          _InlineSuccess(message: _displayNameSuccessMessage!),
+        ],
+        const SizedBox(height: 14),
+        FilledButton.icon(
+          onPressed: controller.isSavingAccountSettings
+              ? null
+              : () async {
+                  setState(() {
+                    _displayNameInlineError = null;
+                    _displayNameSuccessMessage = null;
+                  });
+                  final trimmed = _displayNameController.text.trim();
+                  if (trimmed.length > 64) {
+                    setState(() {
+                      _displayNameInlineError =
+                          'Display name must be 64 characters or fewer.';
+                    });
+                    return;
+                  }
+                  final saved = await controller.updateAccountDisplayName(
+                    displayName: trimmed,
+                  );
+                  if (saved && mounted) {
+                    setState(() {
+                      _displayNameSuccessMessage = 'Display name saved.';
+                    });
+                  }
+                },
+          icon: controller.isSavingAccountSettings
+              ? const SizedBox.square(
+                  dimension: 16,
+                  child: CircularProgressIndicator(strokeWidth: 2),
+                )
+              : Icon(Icons.save_outlined),
+          label: Text('Save name'),
+        ),
+        const SizedBox(height: 22),
         Text('Current email: $currentEmail'),
         const SizedBox(height: 16),
         TextField(

package/flutter_app/lib/main_controller.dart

@@ -4510,7 +4510,7 @@ class NeoAgentController extends ChangeNotifier {
     notifyListeners();
 
     final payload = <String, dynamic>{
-      'headless_browser': headlessBrowser,
+      'headless_browser': true,
       'browser_backend': browserBackend,
       'smarter_model_selector': smarterSelector,
       'enabled_models': enabledModels,
@@ -4645,6 +4645,29 @@ class NeoAgentController extends ChangeNotifier {
     }
   }
 
+  Future<bool> updateAccountDisplayName({
+    required String displayName,
+  }) async {
+    isSavingAccountSettings = true;
+    errorMessage = null;
+    notifyListeners();
+    try {
+      _applyAccountResponse(
+        await _backendClient.updateAccountDisplayName(
+          baseUrl: backendUrl,
+          displayName: displayName,
+        ),
+      );
+      return true;
+    } catch (error) {
+      errorMessage = _friendlyErrorMessage(error);
+      return false;
+    } finally {
+      isSavingAccountSettings = false;
+      notifyListeners();
+    }
+  }
+
   Future<void> linkAccountProvider(String provider) async {
     isSavingAccountSettings = true;
     errorMessage = null;
@@ -5957,9 +5980,7 @@ class NeoAgentController extends ChangeNotifier {
         details.length <= 800;
   }
 
-  bool get headlessBrowser =>
-      settings['headless_browser'] != false &&
-      settings['headless_browser'] != 'false';
+  bool get headlessBrowser => true;
 
   String get browserBackend =>
       settings['browser_backend']?.toString().trim().toLowerCase() ?? 'vm';
@@ -6099,8 +6120,11 @@ class NeoAgentController extends ChangeNotifier {
 
   DateTime? get liveVoiceCaptureStartedAt => _liveVoiceCaptureStartedAt;
 
-  String get accountLabel =>
-      user?['username']?.toString() ?? username.ifEmpty('NeoAgent User');
+  String get accountLabel {
+    final displayName = user?['display_name']?.toString().trim() ?? '';
+    if (displayName.isNotEmpty) return displayName;
+    return user?['username']?.toString() ?? username.ifEmpty('NeoAgent User');
+  }
 
   String get modelIndicator {
     if (defaultChatModel != 'auto') {

package/flutter_app/lib/main_settings.dart

@@ -456,7 +456,7 @@ class _SettingsPanelState extends State<SettingsPanel> {
       onPressed: controller.isSavingSettings
           ? null
           : () => controller.saveSettings(
-              headlessBrowser: _headlessBrowser,
+              headlessBrowser: true,
               browserBackend: _browserBackend == 'extension'
                   ? 'extension'
                   : 'vm',
@@ -593,14 +593,7 @@ class _SettingsPanelState extends State<SettingsPanel> {
               ),
             ),
             const SizedBox(height: 12),
-            _SettingToggle(
-              title: 'Run browser headless',
-              subtitle:
-                  'Keep browser automation off-screen when visible windows are not needed.',
-              value: _headlessBrowser,
-              onChanged: (value) => setState(() => _headlessBrowser = value),
-            ),
-            const SizedBox(height: 12),
+
             DropdownButtonFormField<String>(
               initialValue: _browserBackend,
               decoration: const InputDecoration(

package/flutter_app/lib/src/backend_client.dart

@@ -10,7 +10,7 @@ class BackendClient {
   BackendClient({AppHttpClient? httpClient})
     : _httpClient = httpClient ?? createAppHttpClient();
 
-  static const Duration _requestTimeout = Duration(seconds: 20);
+  static const Duration _requestTimeout = Duration(seconds: 60);
 
   final AppHttpClient _httpClient;
 
@@ -246,6 +246,15 @@ class BackendClient {
     });
   }
 
+  Future<Map<String, dynamic>> updateAccountDisplayName({
+    required String baseUrl,
+    required String displayName,
+  }) async {
+    return putMap(baseUrl, '/api/account/display-name', <String, dynamic>{
+      'displayName': displayName,
+    });
+  }
+
   Future<Map<String, dynamic>> beginTwoFactorSetup({
     required String baseUrl,
     required String currentPassword,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neoagent",
-  "version": "2.3.1-beta.71",
+  "version": "2.3.1-beta.73",
   "description": "Proactive personal AI agent with no limits",
   "license": "MIT",
   "main": "server/index.js",

package/runtime/paths.js

@@ -135,7 +135,7 @@ function generateSecret(bytes = 32) {
   return crypto.randomBytes(bytes).toString('hex');
 }
 
-function getDefaultVmBaseImageUrl(arch = process.arch) {
+function getDefaultVmBaseImageUrl(arch = 'x64') {
   return arch === 'arm64' ? DEFAULT_VM_BASE_IMAGE_URLS.arm64 : DEFAULT_VM_BASE_IMAGE_URLS.x64;
 }
 
@@ -173,8 +173,9 @@ function ensureSecureRuntimeEnv({ envFile = ENV_FILE, env = process.env, logger
   }
 
   let vmBaseImageUrl = String(env.NEOAGENT_VM_BASE_IMAGE_URL || parsed.get('NEOAGENT_VM_BASE_IMAGE_URL') || '').trim();
-  if (!vmBaseImageUrl) {
-    vmBaseImageUrl = getDefaultVmBaseImageUrl();
+  const preferredVmBaseImageUrl = getDefaultVmBaseImageUrl();
+  if (!vmBaseImageUrl || /arm64|aarch64/i.test(vmBaseImageUrl)) {
+    vmBaseImageUrl = preferredVmBaseImageUrl;
     env.NEOAGENT_VM_BASE_IMAGE_URL = vmBaseImageUrl;
     upsertEnvValue(envFile, 'NEOAGENT_VM_BASE_IMAGE_URL', vmBaseImageUrl);
     changes.push('NEOAGENT_VM_BASE_IMAGE_URL');

package/server/db/database.js

@@ -1589,6 +1589,19 @@ function migrateUsersOnboarding() {
 }
 migrateUsersOnboarding();
 
+function migrateUsersDisplayName() {
+  try {
+    const columns = db.pragma('table_info(users)');
+    const hasDisplayNameCol = columns.some((c) => c.name === 'display_name');
+    if (!hasDisplayNameCol) {
+      db.exec('ALTER TABLE users ADD COLUMN display_name TEXT');
+    }
+  } catch (err) {
+    console.warn('Could not add display_name column:', err.message);
+  }
+}
+migrateUsersDisplayName();
+
 try {
   db.exec(`
     INSERT OR REPLACE INTO conversation_history_fts(rowid, content, role, user_id, agent_id, agent_run_id)

package/server/guest-agent.package.json

@@ -0,0 +1,16 @@
+{
+  "name": "neoagent-guest-agent",
+  "private": true,
+  "version": "1.0.0",
+  "description": "Minimal guest runtime for NeoAgent VM browser, CLI, and Android services (uses puppeteer-core with playwright-chromium browser binaries)",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "express": "^4.21.2",
+    "node-pty": "^1.0.0",
+    "playwright-chromium": "^1.59.1",
+    "proper-lockfile": "^4.1.2",
+    "puppeteer-core": "^24.40.0"
+  }
+}

package/server/guest_agent.js

@@ -10,7 +10,19 @@ const { AndroidController } = require('./services/android/controller');
 const { RUNTIME_HOME } = require('../runtime/paths');
 
 const PORT = Number(process.env.NEOAGENT_GUEST_AGENT_PORT || 8421);
-const AUTH_TOKEN = String(process.env.NEOAGENT_VM_GUEST_TOKEN || '').trim();
+function resolveGuestToken() {
+  const raw = String(process.env.NEOAGENT_VM_GUEST_TOKEN || '').trim();
+  if (raw) return raw;
+  const b64 = String(process.env.NEOAGENT_VM_GUEST_TOKEN_B64 || '').trim();
+  if (!b64) return '';
+  try {
+    return Buffer.from(b64, 'base64').toString('utf8').trim();
+  } catch {
+    return '';
+  }
+}
+
+const AUTH_TOKEN = resolveGuestToken();
 const FILE_ROOT = path.join(RUNTIME_HOME, 'guest-agent-files');
 const MAX_APK_STREAM_BYTES = Number(process.env.NEOAGENT_GUEST_MAX_APK_STREAM_BYTES || 512 * 1024 * 1024);
 

package/server/index.js

@@ -210,8 +210,17 @@ function closeHttpServer(server, sockets, timeoutMs = 5000) {
   });
 }
 
+function normalizeShutdownExitCode(value) {
+  const code = Number(value);
+  if (Number.isFinite(code)) {
+    return code;
+  }
+  return 1;
+}
+
 async function shutdown(exitCode = 0) {
-  shutdownExitCode = Math.max(shutdownExitCode, exitCode);
+  const normalizedExitCode = normalizeShutdownExitCode(exitCode);
+  shutdownExitCode = Math.max(shutdownExitCode, normalizedExitCode);
   if (shuttingDown) return;
   shuttingDown = true;
 
@@ -224,7 +233,7 @@ async function shutdown(exitCode = 0) {
   ]);
 
   db.close();
-  process.exit(shutdownExitCode);
+  process.exit(normalizeShutdownExitCode(shutdownExitCode));
 }
 
 httpServer.listen(PORT, () => {

package/server/public/.last_build_id

@@ -1 +1 @@
-e75c29bba45480b61dc03138f9b32797
+af7040916c02919dd1df9c5d1b46d6a6

package/server/public/flutter_bootstrap.js

@@ -37,6 +37,6 @@ _flutter.buildConfig = {"engineRevision":"42d3d75a56efe1a2e9902f52dc8006099c45d9
 
 _flutter.loader.load({
   serviceWorkerSettings: {
-    serviceWorkerVersion: "4246583462" /* Flutter's service worker is deprecated and will be removed in a future Flutter release. */
+    serviceWorkerVersion: "2814524395" /* Flutter's service worker is deprecated and will be removed in a future Flutter release. */
   }
 });