neoagent 3.2.1-beta.9 → 3.3.1-beta.0

package/flutter_app/lib/main_settings.dart

@@ -106,6 +106,18 @@ const _workspaceSettingsSection = _SettingsSection('workspace', <String>[
   'routing',
 ]);
 
+const _behaviorSettingsSection = _SettingsSection('behavior', <String>[
+  'behavior',
+  'persona',
+  'social intelligence',
+  'turn taking',
+  'groups',
+  'memory',
+  'norms',
+  'theory of mind',
+  'delivery',
+]);
+
 const _modelsSettingsSection = _SettingsSection('models', <String>[
   'models',
   'providers',
@@ -173,6 +185,7 @@ const _securitySettingsSection = _SettingsSection('security', <String>[
 
 const List<_SettingsSection> _settingsSearchSections = <_SettingsSection>[
   _overviewSettingsSection,
+  _behaviorSettingsSection,
   _workspaceSettingsSection,
   _socialReachSettingsSection,
   _modelsSettingsSection,
@@ -200,6 +213,17 @@ class _SettingsPanelState extends State<SettingsPanel> {
   final Map<String, bool> _providerEnabled = <String, bool>{};
   final Map<String, TextEditingController> _providerBaseUrlControllers =
       <String, TextEditingController>{};
+  late final TextEditingController _behaviorNotesController;
+  late bool _behaviorEnabled;
+  late String _behaviorParticipationMode;
+  late double _behaviorMinimumNeedScore;
+  late double _behaviorBatchWindowMs;
+  late String _behaviorDecisionModelId;
+  late String _behaviorDeliveryStyle;
+  late bool _behaviorTheoryOfMindEnabled;
+  late bool _behaviorSocialMemoryEnabled;
+  late bool _behaviorNormsEnabled;
+  late bool _behaviorObservabilityEnabled;
 
   bool _hasUnsavedChanges = false;
 
@@ -218,12 +242,14 @@ class _SettingsPanelState extends State<SettingsPanel> {
   void initState() {
     super.initState();
     _searchController = TextEditingController();
+    _behaviorNotesController = TextEditingController();
     _hydrate();
   }
 
   @override
   void dispose() {
     _searchController.dispose();
+    _behaviorNotesController.dispose();
     for (final controller in _providerBaseUrlControllers.values) {
       controller.dispose();
     }
@@ -234,6 +260,10 @@ class _SettingsPanelState extends State<SettingsPanel> {
   void didUpdateWidget(covariant SettingsPanel oldWidget) {
     super.didUpdateWidget(oldWidget);
     if (oldWidget.controller.settings != widget.controller.settings ||
+        oldWidget.controller.behaviorConfig !=
+            widget.controller.behaviorConfig ||
+        oldWidget.controller.memoryOverview !=
+            widget.controller.memoryOverview ||
         oldWidget.controller.aiProviders != widget.controller.aiProviders ||
         oldWidget.controller.supportedModels !=
             widget.controller.supportedModels) {
@@ -270,6 +300,45 @@ class _SettingsPanelState extends State<SettingsPanel> {
     _voiceLiveProvider = controller.voiceLiveProvider;
     _voiceLiveModel = controller.voiceLiveModel;
     _voiceLiveVoice = controller.voiceLiveVoice;
+    final behavior = controller.behaviorConfig;
+    final modules = behavior['modules'] is Map
+        ? Map<String, dynamic>.from(behavior['modules'] as Map)
+        : const <String, dynamic>{};
+    bool moduleEnabled(String id) {
+      final module = modules[id];
+      return module is! Map || module['enabled'] != false;
+    }
+
+    _behaviorEnabled = behavior['enabled'] != false;
+    _behaviorParticipationMode =
+        <String>{
+          'automatic',
+          'mention_only',
+          'always',
+        }.contains(behavior['participationMode']?.toString())
+        ? behavior['participationMode'].toString()
+        : 'automatic';
+    _behaviorMinimumNeedScore =
+        ((behavior['minimumNeedScore'] as num?)?.toDouble() ?? 0.72)
+            .clamp(0.0, 1.0)
+            .toDouble();
+    _behaviorBatchWindowMs =
+        ((behavior['batchWindowMs'] as num?)?.toDouble() ?? 900)
+            .clamp(0.0, 5000.0)
+            .toDouble();
+    _behaviorDecisionModelId =
+        behavior['decisionModelId']?.toString().trim() ?? '';
+    _behaviorDeliveryStyle = behavior['deliveryStyle'] == 'single'
+        ? 'single'
+        : 'natural_bubbles';
+    _behaviorTheoryOfMindEnabled = moduleEnabled('theory_of_mind');
+    _behaviorSocialMemoryEnabled = moduleEnabled('social_memory');
+    _behaviorNormsEnabled = moduleEnabled('norms');
+    _behaviorObservabilityEnabled = moduleEnabled('social_observability');
+    final behaviorNotes = controller.memoryOverview.assistantBehaviorNotes;
+    if (_behaviorNotesController.text != behaviorNotes) {
+      _behaviorNotesController.text = behaviorNotes;
+    }
     if (!_voiceLiveModelsByProvider.containsKey(_voiceLiveProvider)) {
       _voiceLiveProvider = 'openai';
     }
@@ -401,6 +470,13 @@ class _SettingsPanelState extends State<SettingsPanel> {
             _buildSettingsOverview(controller, availableModels.length),
             const SizedBox(height: 16),
           ],
+          if (_matchesSettingsSection(
+            searchQuery,
+            _behaviorSettingsSection,
+          )) ...<Widget>[
+            _buildBehaviorSection(controller, routingModels),
+            const SizedBox(height: 16),
+          ],
           if (_matchesSettingsSection(
             searchQuery,
             _workspaceSettingsSection,
@@ -522,6 +598,42 @@ class _SettingsPanelState extends State<SettingsPanel> {
       voiceLiveVoice: _voiceLiveVoice,
       aiProviderConfigs: _buildProviderPayload(),
     );
+    if (controller.errorMessage != null) return;
+    final existingModules = controller.behaviorConfig['modules'] is Map
+        ? Map<String, dynamic>.from(controller.behaviorConfig['modules'] as Map)
+        : <String, dynamic>{};
+    existingModules.addAll(<String, dynamic>{
+      'theory_of_mind': <String, dynamic>{
+        'enabled': _behaviorTheoryOfMindEnabled,
+      },
+      'social_memory': <String, dynamic>{
+        'enabled': _behaviorSocialMemoryEnabled,
+      },
+      'norms': <String, dynamic>{'enabled': _behaviorNormsEnabled},
+      'social_observability': <String, dynamic>{
+        'enabled': _behaviorObservabilityEnabled,
+      },
+    });
+    await controller.saveBehaviorConfig(<String, dynamic>{
+      ...controller.behaviorConfig,
+      'enabled': _behaviorEnabled,
+      'participationMode': _behaviorParticipationMode,
+      'minimumNeedScore': _behaviorMinimumNeedScore,
+      'batchWindowMs': _behaviorBatchWindowMs.round(),
+      'decisionModelId': _behaviorDecisionModelId.isEmpty
+          ? null
+          : _behaviorDecisionModelId,
+      'deliveryStyle': _behaviorDeliveryStyle,
+      'modules': existingModules,
+    });
+    if (controller.errorMessage != null) return;
+    if (_behaviorNotesController.text !=
+        controller.memoryOverview.assistantBehaviorNotes) {
+      await controller.updateAssistantBehaviorNotes(
+        _behaviorNotesController.text,
+      );
+      if (controller.errorMessage != null) return;
+    }
     if (mounted) setState(() => _hasUnsavedChanges = false);
   }
 
@@ -627,6 +739,232 @@ class _SettingsPanelState extends State<SettingsPanel> {
     );
   }
 
+  Widget _buildBehaviorSection(
+    NeoAgentController controller,
+    List<ModelMeta> routingModels,
+  ) {
+    final modelIds = <String>{
+      if (_behaviorDecisionModelId.isNotEmpty) _behaviorDecisionModelId,
+      ...routingModels.map((model) => model.id),
+    }.toList();
+    return Card(
+      child: Padding(
+        padding: const EdgeInsets.all(20),
+        child: Column(
+          crossAxisAlignment: CrossAxisAlignment.start,
+          children: <Widget>[
+            const _SectionTitle('Behavior Modules'),
+            const SizedBox(height: 10),
+            Text(
+              'One runtime controls persona, group turn-taking, room memory, norms, Theory of Mind, and delivery.',
+              style: TextStyle(color: _textSecondary, height: 1.45),
+            ),
+            const SizedBox(height: 12),
+            SwitchListTile.adaptive(
+              contentPadding: EdgeInsets.zero,
+              title: const Text('Enable behavior modules'),
+              subtitle: const Text(
+                'Direct messages remain responsive. Allowlisted groups use the participation mode below.',
+              ),
+              value: _behaviorEnabled,
+              onChanged: (value) => setState(() {
+                _behaviorEnabled = value;
+                _hasUnsavedChanges = true;
+              }),
+            ),
+            const SizedBox(height: 8),
+            DropdownButtonFormField<String>(
+              initialValue: _behaviorParticipationMode,
+              decoration: const InputDecoration(
+                labelText: 'Default group participation',
+                helperText:
+                    'Automatic reads the room and normally holds back. Mention-only makes no decision call until directly addressed.',
+              ),
+              items: const <DropdownMenuItem<String>>[
+                DropdownMenuItem(
+                  value: 'automatic',
+                  child: Text('Automatic, reserved'),
+                ),
+                DropdownMenuItem(
+                  value: 'mention_only',
+                  child: Text('Mention or reply only'),
+                ),
+                DropdownMenuItem(value: 'always', child: Text('Always engage')),
+              ],
+              onChanged: !_behaviorEnabled
+                  ? null
+                  : (value) {
+                      if (value == null) return;
+                      setState(() {
+                        _behaviorParticipationMode = value;
+                        _hasUnsavedChanges = true;
+                      });
+                    },
+            ),
+            const SizedBox(height: 18),
+            Text(
+              'Minimum contribution value: ${_behaviorMinimumNeedScore.toStringAsFixed(2)}',
+              style: TextStyle(
+                color: _textPrimary,
+                fontWeight: FontWeight.w600,
+              ),
+            ),
+            Slider(
+              value: _behaviorMinimumNeedScore,
+              min: 0,
+              max: 1,
+              divisions: 20,
+              label: _behaviorMinimumNeedScore.toStringAsFixed(2),
+              onChanged: !_behaviorEnabled
+                  ? null
+                  : (value) => setState(() {
+                      _behaviorMinimumNeedScore = value;
+                      _hasUnsavedChanges = true;
+                    }),
+            ),
+            Text(
+              'Higher values make NeoAgent more selective in groups.',
+              style: TextStyle(color: _textSecondary, fontSize: 12),
+            ),
+            const SizedBox(height: 14),
+            Text(
+              'Room batch window: ${_behaviorBatchWindowMs.round()} ms',
+              style: TextStyle(
+                color: _textPrimary,
+                fontWeight: FontWeight.w600,
+              ),
+            ),
+            Slider(
+              value: _behaviorBatchWindowMs,
+              min: 0,
+              max: 5000,
+              divisions: 20,
+              label: '${_behaviorBatchWindowMs.round()} ms',
+              onChanged: !_behaviorEnabled
+                  ? null
+                  : (value) => setState(() {
+                      _behaviorBatchWindowMs = value;
+                      _hasUnsavedChanges = true;
+                    }),
+            ),
+            const SizedBox(height: 12),
+            DropdownButtonFormField<String>(
+              initialValue: _behaviorDecisionModelId,
+              decoration: const InputDecoration(
+                labelText: 'Turn-taking model',
+                helperText:
+                    'Automatic selects a fast model through the normal model catalog.',
+              ),
+              items: <DropdownMenuItem<String>>[
+                const DropdownMenuItem(
+                  value: '',
+                  child: Text('Automatic (fast)'),
+                ),
+                ...modelIds.map(
+                  (id) => DropdownMenuItem(value: id, child: Text(id)),
+                ),
+              ],
+              onChanged: !_behaviorEnabled
+                  ? null
+                  : (value) {
+                      if (value == null) return;
+                      setState(() {
+                        _behaviorDecisionModelId = value;
+                        _hasUnsavedChanges = true;
+                      });
+                    },
+            ),
+            const SizedBox(height: 12),
+            DropdownButtonFormField<String>(
+              initialValue: _behaviorDeliveryStyle,
+              decoration: const InputDecoration(
+                labelText: 'Messaging delivery',
+              ),
+              items: const <DropdownMenuItem<String>>[
+                DropdownMenuItem(
+                  value: 'natural_bubbles',
+                  child: Text('Natural bubbles'),
+                ),
+                DropdownMenuItem(
+                  value: 'single',
+                  child: Text('Single message'),
+                ),
+              ],
+              onChanged: !_behaviorEnabled
+                  ? null
+                  : (value) {
+                      if (value == null) return;
+                      setState(() {
+                        _behaviorDeliveryStyle = value;
+                        _hasUnsavedChanges = true;
+                      });
+                    },
+            ),
+            const SizedBox(height: 10),
+            SwitchListTile.adaptive(
+              contentPadding: EdgeInsets.zero,
+              title: const Text('Theory of Mind refinement'),
+              value: _behaviorTheoryOfMindEnabled,
+              onChanged: !_behaviorEnabled
+                  ? null
+                  : (value) => setState(() {
+                      _behaviorTheoryOfMindEnabled = value;
+                      _hasUnsavedChanges = true;
+                    }),
+            ),
+            SwitchListTile.adaptive(
+              contentPadding: EdgeInsets.zero,
+              title: const Text('Channel-scoped social memory'),
+              value: _behaviorSocialMemoryEnabled,
+              onChanged: !_behaviorEnabled
+                  ? null
+                  : (value) => setState(() {
+                      _behaviorSocialMemoryEnabled = value;
+                      _hasUnsavedChanges = true;
+                    }),
+            ),
+            SwitchListTile.adaptive(
+              contentPadding: EdgeInsets.zero,
+              title: const Text('Learn room norms'),
+              value: _behaviorNormsEnabled,
+              onChanged: !_behaviorEnabled
+                  ? null
+                  : (value) => setState(() {
+                      _behaviorNormsEnabled = value;
+                      _hasUnsavedChanges = true;
+                    }),
+            ),
+            SwitchListTile.adaptive(
+              contentPadding: EdgeInsets.zero,
+              title: const Text('Social observability'),
+              value: _behaviorObservabilityEnabled,
+              onChanged: !_behaviorEnabled
+                  ? null
+                  : (value) => setState(() {
+                      _behaviorObservabilityEnabled = value;
+                      _hasUnsavedChanges = true;
+                    }),
+            ),
+            const SizedBox(height: 12),
+            TextField(
+              controller: _behaviorNotesController,
+              minLines: 4,
+              maxLines: 10,
+              onChanged: (_) => setState(() {
+                _hasUnsavedChanges = true;
+              }),
+              decoration: const InputDecoration(
+                labelText: 'Persona behavior notes',
+                helperText:
+                    'Durable instructions for voice and interaction style. Safety and execution rules still take priority.',
+              ),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+
   Widget _buildWorkspaceSection(NeoAgentController controller) {
     return Card(
       child: Padding(

package/flutter_app/lib/src/backend_client.dart

@@ -514,6 +514,25 @@ class BackendClient {
     return putMap(baseUrl, '/api/settings', _withAgentId(payload, agentId));
   }
 
+  Future<Map<String, dynamic>> fetchBehaviorConfig(
+    String baseUrl, {
+    String? agentId,
+  }) async {
+    return getMap(baseUrl, _withAgentQuery('/api/behavior', agentId));
+  }
+
+  Future<Map<String, dynamic>> saveBehaviorConfig(
+    String baseUrl,
+    Map<String, dynamic> config, {
+    String? agentId,
+  }) async {
+    return putMap(
+      baseUrl,
+      '/api/behavior',
+      _withAgentId(<String, dynamic>{'config': config}, agentId),
+    );
+  }
+
   Future<Map<String, dynamic>> fetchTokenUsageSummary(
     String baseUrl, {
     String? agentId,

package/flutter_app/lib/src/local_runtime_paths.dart

@@ -0,0 +1,60 @@
+class LocalRuntimePaths {
+  LocalRuntimePaths._({
+    required this.homeDirectory,
+    required this.runtimeHome,
+    required this.dataDirectory,
+    required this.envFile,
+    required this.separator,
+  });
+
+  factory LocalRuntimePaths.fromEnvironment(
+    Map<String, String> environment, {
+    required bool isWindows,
+  }) {
+    final separator = isWindows ? r'\' : '/';
+    final homeKey = isWindows ? 'USERPROFILE' : 'HOME';
+    final homeDirectory = (environment[homeKey] ?? '').trim();
+    if (homeDirectory.isEmpty) {
+      throw StateError('$homeKey is required to locate NeoAgent runtime data.');
+    }
+
+    final configuredRuntimeHome = (environment['NEOAGENT_HOME'] ?? '').trim();
+    final runtimeHome = configuredRuntimeHome.isNotEmpty
+        ? configuredRuntimeHome
+        : _join(homeDirectory, '.neoagent', separator);
+    final configuredDataDirectory = (environment['NEOAGENT_DATA_DIR'] ?? '')
+        .trim();
+    final dataDirectory = configuredDataDirectory.isNotEmpty
+        ? configuredDataDirectory
+        : _join(runtimeHome, 'data', separator);
+    final configuredEnvFile = (environment['NEOAGENT_ENV_FILE'] ?? '').trim();
+    final envFile = configuredEnvFile.isNotEmpty
+        ? configuredEnvFile
+        : _join(runtimeHome, '.env', separator);
+
+    return LocalRuntimePaths._(
+      homeDirectory: homeDirectory,
+      runtimeHome: runtimeHome,
+      dataDirectory: dataDirectory,
+      envFile: envFile,
+      separator: separator,
+    );
+  }
+
+  final String homeDirectory;
+  final String runtimeHome;
+  final String dataDirectory;
+  final String envFile;
+  final String separator;
+
+  String get logDirectory => _join(dataDirectory, 'logs', separator);
+  String get logFile => _join(logDirectory, 'neoagent.log', separator);
+  String get pidFile => _join(dataDirectory, 'neoagent.pid', separator);
+
+  static String _join(String parent, String child, String separator) {
+    if (parent.endsWith('/') || parent.endsWith(r'\')) {
+      return '$parent$child';
+    }
+    return '$parent$separator$child';
+  }
+}

package/lib/manager.js

@@ -575,6 +575,8 @@ function defaultEnvLines(current = {}) {
     `NEOAGENT_VM_MEMORY_MB=${current.NEOAGENT_VM_MEMORY_MB || '4096'}`,
     `NEOAGENT_VM_CPUS=${current.NEOAGENT_VM_CPUS || '2'}`,
     `NEOAGENT_VM_GUEST_TOKEN=${current.NEOAGENT_VM_GUEST_TOKEN || randomSecret()}`,
+    `ADMIN_USERNAME=${current.ADMIN_USERNAME || 'admin'}`,
+    `ADMIN_PASSWORD=${current.ADMIN_PASSWORD || randomSecret()}`,
     current.XAI_BASE_URL ? `XAI_BASE_URL=${current.XAI_BASE_URL}` : 'XAI_BASE_URL=https://api.x.ai/v1',
     current.OLLAMA_URL ? `OLLAMA_URL=${current.OLLAMA_URL}` : 'OLLAMA_URL=http://localhost:11434',
     current.DEEPGRAM_BASE_URL ? `DEEPGRAM_BASE_URL=${current.DEEPGRAM_BASE_URL}` : 'DEEPGRAM_BASE_URL=https://api.deepgram.com',
@@ -586,8 +588,13 @@ function defaultEnvLines(current = {}) {
 function writeDefaultEnvFile() {
   ensureRuntimeDirs();
   const current = Object.fromEntries(parseEnv(readEnvFileRaw()).entries());
-  fs.writeFileSync(ENV_FILE, `${defaultEnvLines(current).join('\n')}\n`, { mode: 0o600 });
-  logOk(`Wrote default config to ${ENV_FILE}`);
+  for (const line of defaultEnvLines(current)) {
+    const separatorIndex = line.indexOf('=');
+    const key = line.slice(0, separatorIndex);
+    if (String(current[key] || '').trim()) continue;
+    upsertEnvValue(key, line.slice(separatorIndex + 1));
+  }
+  logOk(`Ensured default config at ${ENV_FILE}`);
   rememberInstallAction('Add provider keys with `neoagent setup`, `neoagent env set KEY VALUE`, or the login commands when you are ready.');
 }
 
@@ -1560,6 +1567,7 @@ async function cmdInstall() {
       writeDefaultEnvFile();
     }
   } else {
+    writeDefaultEnvFile();
     logOk(`Using config ${ENV_FILE}`);
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neoagent",
-  "version": "3.2.1-beta.9",
+  "version": "3.3.1-beta.0",
   "description": "Self-hosted AI agent for long-running tasks, automation, messaging, device control, and local memory",
   "license": "AGPL-3.0-only",
   "main": "server/index.js",

package/runtime/paths.js

@@ -17,6 +17,15 @@ const PID_FILE = path.join(DATA_DIR, 'neoagent.pid');
 const LEGACY_ENV_FILE = path.join(APP_DIR, '.env');
 const LEGACY_DATA_DIR = path.join(APP_DIR, 'data');
 const LEGACY_AGENT_DATA_DIR = path.join(APP_DIR, 'agent-data');
+const LEGACY_DESKTOP_RUNTIME_DIR = path.join(HOME_DIR, '.neoagent', 'runtime');
+const LEGACY_DESKTOP_ENV_FILE = path.join(LEGACY_DESKTOP_RUNTIME_DIR, '.env');
+const PERSISTENT_IDENTITY_ENV_KEYS = new Set([
+  'SESSION_SECRET',
+  'NEOAGENT_ENCRYPTION_KEY',
+  'NEOAGENT_VM_GUEST_TOKEN',
+  'ADMIN_USERNAME',
+  'ADMIN_PASSWORD',
+]);
 const DEFAULT_VM_BASE_IMAGE_URLS = Object.freeze({
   arm64: 'https://cloud-images.ubuntu.com/releases/24.04/release/ubuntu-24.04-server-cloudimg-arm64.img',
   x64: 'https://cloud-images.ubuntu.com/releases/24.04/release/ubuntu-24.04-server-cloudimg-amd64.img',
@@ -47,6 +56,39 @@ function copyDirMerge(src, dest) {
   return true;
 }
 
+function migrationBackupPath(sourcePath) {
+  const basePath = `${sourcePath}.migrated`;
+  if (!fs.existsSync(basePath)) return basePath;
+  return `${basePath}.${Date.now()}`;
+}
+
+function migrateLegacyDesktopEnv({
+  legacyEnvFile = LEGACY_DESKTOP_ENV_FILE,
+  envFile = ENV_FILE,
+  logger = () => {},
+} = {}) {
+  if (path.resolve(legacyEnvFile) === path.resolve(envFile)) return false;
+  if (!fs.existsSync(legacyEnvFile)) return false;
+
+  const legacyValues = parseEnv(readEnvFileRaw(legacyEnvFile));
+  if (legacyValues.size === 0) return false;
+
+  const currentValues = parseEnv(readEnvFileRaw(envFile));
+  for (const [key, value] of legacyValues.entries()) {
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) continue;
+    const currentValue = String(currentValues.get(key) || '').trim();
+    if (PERSISTENT_IDENTITY_ENV_KEYS.has(key) && currentValue) continue;
+    upsertEnvValue(envFile, key, value);
+  }
+
+  const backupPath = migrationBackupPath(legacyEnvFile);
+  fs.renameSync(legacyEnvFile, backupPath);
+  logger(
+    `migrated desktop config ${legacyEnvFile} -> ${envFile} (backup: ${backupPath})`,
+  );
+  return true;
+}
+
 function migrateLegacyRuntime(logger = () => {}) {
   ensureRuntimeDirs();
   let changed = false;
@@ -89,6 +131,15 @@ function migrateLegacyRuntime(logger = () => {}) {
     log(`migrated ${LEGACY_ENV_FILE} -> ${ENV_FILE}`);
     changed = true;
   }
+  try {
+    if (migrateLegacyDesktopEnv({ logger: log })) {
+      changed = true;
+    }
+  } catch (error) {
+    logError(
+      `failed to migrate desktop runtime config ${LEGACY_DESKTOP_ENV_FILE} -> ${ENV_FILE}: ${error.message}`,
+    );
+  }
   if (copyDirMerge(LEGACY_DATA_DIR, DATA_DIR)) {
     log(`migrated ${LEGACY_DATA_DIR} -> ${DATA_DIR}`);
     changed = true;
@@ -248,6 +299,22 @@ function ensureSecureRuntimeEnv({ envFile = ENV_FILE, env = process.env, logger
   }
   env.SESSION_SECRET = sessionSecret;
 
+  let adminUsername = String(env.ADMIN_USERNAME || parsed.get('ADMIN_USERNAME') || '').trim();
+  if (!adminUsername) {
+    adminUsername = 'admin';
+    upsertEnvValue(envFile, 'ADMIN_USERNAME', adminUsername);
+    changes.push('ADMIN_USERNAME');
+  }
+  env.ADMIN_USERNAME = adminUsername;
+
+  let adminPassword = String(env.ADMIN_PASSWORD || parsed.get('ADMIN_PASSWORD') || '').trim();
+  if (!adminPassword) {
+    adminPassword = generateSecret(16);
+    upsertEnvValue(envFile, 'ADMIN_PASSWORD', adminPassword);
+    changes.push('ADMIN_PASSWORD');
+  }
+  env.ADMIN_PASSWORD = adminPassword;
+
   let guestToken = String(env.NEOAGENT_VM_GUEST_TOKEN || parsed.get('NEOAGENT_VM_GUEST_TOKEN') || '').trim();
   if (!isValidVmGuestToken(guestToken)) {
     guestToken = generateSecret(32);
@@ -285,10 +352,13 @@ module.exports = {
   LEGACY_ENV_FILE,
   LEGACY_DATA_DIR,
   LEGACY_AGENT_DATA_DIR,
+  LEGACY_DESKTOP_RUNTIME_DIR,
+  LEGACY_DESKTOP_ENV_FILE,
   DEFAULT_VM_BASE_IMAGE_URLS,
   ensureRuntimeDirs,
   ensureSecureRuntimeEnv,
   getDefaultVmBaseImageUrl,
+  migrateLegacyDesktopEnv,
   migrateLegacyRuntime,
   removeEnvValue,
   upsertEnvValue,

package/server/db/database.js

@@ -1311,8 +1311,8 @@ function getMainAgentId(userId) {
        id, user_id, slug, display_name, description, responsibilities, instructions,
        is_default, can_delegate, can_be_delegated_to, delegate_targets_json
      )
-     VALUES (?, ?, 'main', 'Main', 'Default personal assistant and fallback agent.',
-       'Handle general requests and delegate to specialist agents only when there is a clear match.',
+     VALUES (?, ?, 'main', 'Main', 'Default personal AI contact and fallback agent.',
+       'Handle general requests like a proactive favorite contact and delegate to specialist agents only when there is a clear match.',
        '', 1, 1, 0, '[]'
      )`
   ).run(id, userId);

package/server/http/routes.js

@@ -11,6 +11,7 @@ const routeRegistry = [
   { basePath: null, modulePath: '../routes/auth' },
   { basePath: '/api/account', modulePath: '../routes/account' },
   { basePath: '/api/settings', modulePath: '../routes/settings' },
+  { basePath: '/api/behavior', modulePath: '../routes/behavior' },
   { basePath: '/api/agent-profiles', modulePath: '../routes/agent_profiles' },
   { basePath: '/api/agents', modulePath: '../routes/agents' },
   { basePath: '/api/messaging', modulePath: '../routes/messaging' },

package/server/public/.last_build_id

@@ -1 +1 @@
-1a325740c55a320441979a83b65c758d
+0ad3e52b5fbb378630b99ccbf102fadc

package/server/public/flutter_bootstrap.js

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