neoagent 3.2.1-beta.9 → 3.3.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neoagent",
-  "version": "3.2.1-beta.9",
+  "version": "3.3.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/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
+d5e0ef3e2dca2bb1ce478b598336b800

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: "862590908" /* Flutter's service worker is deprecated and will be removed in a future Flutter release. */
   }
 });