neoagent 3.0.1-beta.30 → 3.0.1-beta.32

package/docs/automation.md

@@ -85,6 +85,26 @@ Open **Runs** to inspect the trigger, tool calls, approvals, output, and error
 for each execution. Delivery requires a configured messaging destination; a
 completed run can still have a delivery error.
 
+## Loop budgets
+
+Scheduled and event-triggered tasks run autonomously under a per-task loop
+budget. By default, a task can run 24 times or spend 250k model tokens per day.
+At the cap, or when paused, the task is skipped before a model call.
+
+Advanced task configs can override the defaults:
+
+```json
+{
+  "loopBudget": {
+    "maxRunsPerDay": 12,
+    "maxTokensPerDay": 150000,
+    "paused": false
+  }
+}
+```
+
+Set `loopBudget.paused` or `loopPaused` to `true` as a per-task kill switch.
+
 ## Safety
 
 - Start with read-only integration accounts.

package/flutter_app/lib/main_controller.dart

@@ -6076,6 +6076,7 @@ class NeoAgentController extends ChangeNotifier {
     required String triggerType,
     required Map<String, dynamic> triggerConfig,
     required String prompt,
+    Map<String, dynamic>? taskConfig,
     String? model,
     bool enabled = true,
     String? agentId,
@@ -6087,6 +6088,7 @@ class NeoAgentController extends ChangeNotifier {
       triggerType: triggerType,
       triggerConfig: triggerConfig,
       prompt: prompt,
+      taskConfig: taskConfig,
       model: model,
       enabled: enabled,
       agentId: agentId ?? _scopedAgentId,

package/flutter_app/lib/main_models.dart

@@ -3237,6 +3237,8 @@ class TaskItem {
     required this.triggerType,
     required this.triggerSummary,
     required this.triggerConfig,
+    required this.taskConfig,
+    required this.loopBudget,
     required this.nextRun,
     required this.prompt,
     required this.model,
@@ -3268,6 +3270,11 @@ class TaskItem {
           : const <String, dynamic>{}),
     };
     final triggerSummary = json['triggerSummary']?.toString() ?? '';
+    final loopBudgetJson = json['loopBudget'] is Map
+        ? Map<String, dynamic>.from(json['loopBudget'] as Map)
+        : (taskConfig['loopBudget'] is Map
+              ? Map<String, dynamic>.from(taskConfig['loopBudget'] as Map)
+              : const <String, dynamic>{});
     return TaskItem(
       id: _asInt(json['id']),
       agentId: json['agentId']?.toString() ?? json['agent_id']?.toString(),
@@ -3277,6 +3284,8 @@ class TaskItem {
           ? 'Task trigger'
           : triggerSummary,
       triggerConfig: triggerConfig,
+      taskConfig: taskConfig,
+      loopBudget: TaskLoopBudget.fromJson(loopBudgetJson),
       nextRun: _parseOptionalTimestamp(json['nextRun']?.toString()),
       prompt:
           json['prompt']?.toString().ifEmpty(
@@ -3312,6 +3321,8 @@ class TaskItem {
   final String triggerType;
   final String triggerSummary;
   final Map<String, dynamic> triggerConfig;
+  final Map<String, dynamic> taskConfig;
+  final TaskLoopBudget loopBudget;
   final DateTime? nextRun;
   final String prompt;
   final String model;
@@ -3335,6 +3346,47 @@ class TaskItem {
   bool get isWidgetRefresh => taskType == 'widget_refresh';
 }
 
+class TaskLoopBudget {
+  const TaskLoopBudget({
+    required this.enabled,
+    required this.paused,
+    required this.maxRunsPerDay,
+    required this.maxTokensPerDay,
+  });
+
+  factory TaskLoopBudget.fromJson(Map<String, dynamic> json) {
+    final maxRuns = _asInt(json['maxRunsPerDay'] ?? json['max_runs_per_day']);
+    final maxTokens = _asInt(
+      json['maxTokensPerDay'] ?? json['max_tokens_per_day'],
+    );
+    final enabled = json['enabled'] == false || json['enabled'] == 'false'
+        ? false
+        : true;
+    return TaskLoopBudget(
+      enabled: enabled,
+      paused:
+          json['paused'] == true ||
+          json['pause'] == true ||
+          json['paused'] == 'true' ||
+          json['pause'] == 'true',
+      maxRunsPerDay: maxRuns > 0 ? maxRuns : 24,
+      maxTokensPerDay: maxTokens > 0 ? maxTokens : 250000,
+    );
+  }
+
+  final bool enabled;
+  final bool paused;
+  final int maxRunsPerDay;
+  final int maxTokensPerDay;
+
+  Map<String, dynamic> toJson() => <String, dynamic>{
+    'enabled': enabled,
+    'paused': paused,
+    'maxRunsPerDay': maxRunsPerDay,
+    'maxTokensPerDay': maxTokensPerDay,
+  };
+}
+
 class WidgetSnapshotItem {
   const WidgetSnapshotItem({
     required this.id,

package/flutter_app/lib/main_operations.dart

@@ -5296,6 +5296,24 @@ class _TasksPanelState extends State<TasksPanel> {
     }
   }
 
+  String _compactBudgetNumber(int value) {
+    if (value >= 1000000) {
+      final millions = value / 1000000;
+      return '${millions.toStringAsFixed(millions >= 10 ? 0 : 1)}M';
+    }
+    if (value >= 1000) {
+      final thousands = value / 1000;
+      return '${thousands.toStringAsFixed(thousands >= 10 ? 0 : 1)}k';
+    }
+    return '$value';
+  }
+
+  String _taskBudgetLabel(TaskItem task) {
+    final budget = task.loopBudget;
+    return 'Budget: ${budget.maxRunsPerDay} runs/day · '
+        '${_compactBudgetNumber(budget.maxTokensPerDay)} tokens/day';
+  }
+
   Future<void> _showLastRun(TaskItem task) async {
     final runId = task.lastRunId.trim();
     if (runId.isEmpty) return;
@@ -5512,6 +5530,10 @@ class _TasksPanelState extends State<TasksPanel> {
                     label: task.enabled ? 'Active' : 'Paused',
                     color: task.enabled ? _success : _textSecondary,
                   ),
+                  if (task.loopBudget.paused) ...<Widget>[
+                    const SizedBox(width: 8),
+                    _StatusPill(label: 'Loop paused', color: _warning),
+                  ],
                   if (task.hasLastRunStatus) ...<Widget>[
                     const SizedBox(width: 8),
                     _StatusPill(
@@ -5542,6 +5564,11 @@ class _TasksPanelState extends State<TasksPanel> {
                 style: TextStyle(color: _textSecondary),
               ),
               const SizedBox(height: 8),
+              Text(
+                _taskBudgetLabel(task),
+                style: TextStyle(color: _textSecondary),
+              ),
+              const SizedBox(height: 8),
               Text(task.prompt, style: TextStyle(color: _textPrimary)),
               if (task.lastRunLabel.isNotEmpty) ...<Widget>[
                 const SizedBox(height: 8),
@@ -5631,6 +5658,10 @@ class _TasksPanelState extends State<TasksPanel> {
                     label: task.enabled ? 'Active' : 'Paused',
                     color: task.enabled ? _success : _textSecondary,
                   ),
+                  if (task.loopBudget.paused) ...<Widget>[
+                    const SizedBox(width: 8),
+                    _StatusPill(label: 'Loop paused', color: _warning),
+                  ],
                   if (task.hasLastRunStatus) ...<Widget>[
                     const SizedBox(width: 8),
                     _StatusPill(
@@ -5660,6 +5691,11 @@ class _TasksPanelState extends State<TasksPanel> {
                   style: TextStyle(color: _textSecondary),
                 ),
                 const SizedBox(height: 8),
+                Text(
+                  _taskBudgetLabel(task),
+                  style: TextStyle(color: _textSecondary),
+                ),
+                const SizedBox(height: 8),
                 Text(
                   linkedWidget.prompt,
                   style: TextStyle(color: _textPrimary),
@@ -5841,7 +5877,15 @@ class _TasksPanelState extends State<TasksPanel> {
       text: task?.triggerConfig['sender']?.toString() ?? '',
     );
     final promptController = TextEditingController(text: task?.prompt ?? '');
+    final loopBudget = task?.loopBudget ?? TaskLoopBudget.fromJson(const {});
+    final maxRunsController = TextEditingController(
+      text: loopBudget.maxRunsPerDay.toString(),
+    );
+    final maxTokensController = TextEditingController(
+      text: loopBudget.maxTokensPerDay.toString(),
+    );
     var enabled = task?.enabled ?? true;
+    var loopPaused = loopBudget.paused;
     var unreadOnly = task?.triggerConfig['unreadOnly'] == true;
     var ignoreGroups = task?.triggerConfig['ignoreGroups'] == true;
     var selectedModel = _ensureModelValue(
@@ -6144,6 +6188,88 @@ class _TasksPanelState extends State<TasksPanel> {
                           () => selectedModel = value ?? 'auto',
                         ),
                       ),
+                      const SizedBox(height: 12),
+                      Container(
+                        width: double.infinity,
+                        padding: const EdgeInsets.all(14),
+                        decoration: BoxDecoration(
+                          border: Border.all(
+                            color: _border.withValues(alpha: 0.8),
+                          ),
+                          borderRadius: BorderRadius.circular(12),
+                        ),
+                        child: Column(
+                          crossAxisAlignment: CrossAxisAlignment.start,
+                          children: <Widget>[
+                            Row(
+                              children: <Widget>[
+                                Icon(
+                                  Icons.speed_outlined,
+                                  size: 18,
+                                  color: _textSecondary,
+                                ),
+                                const SizedBox(width: 8),
+                                Text(
+                                  'Loop budget',
+                                  style: TextStyle(
+                                    fontWeight: FontWeight.w700,
+                                    color: _textPrimary,
+                                  ),
+                                ),
+                              ],
+                            ),
+                            const SizedBox(height: 12),
+                            LayoutBuilder(
+                              builder: (context, constraints) {
+                                final stacked = constraints.maxWidth < 520;
+                                final fields = <Widget>[
+                                  TextField(
+                                    controller: maxRunsController,
+                                    keyboardType: TextInputType.number,
+                                    decoration: const InputDecoration(
+                                      labelText: 'Max runs per day',
+                                    ),
+                                  ),
+                                  TextField(
+                                    controller: maxTokensController,
+                                    keyboardType: TextInputType.number,
+                                    decoration: const InputDecoration(
+                                      labelText: 'Max tokens per day',
+                                    ),
+                                  ),
+                                ];
+                                if (stacked) {
+                                  return Column(
+                                    children: <Widget>[
+                                      fields[0],
+                                      const SizedBox(height: 12),
+                                      fields[1],
+                                    ],
+                                  );
+                                }
+                                return Row(
+                                  children: <Widget>[
+                                    Expanded(child: fields[0]),
+                                    const SizedBox(width: 12),
+                                    Expanded(child: fields[1]),
+                                  ],
+                                );
+                              },
+                            ),
+                            const SizedBox(height: 8),
+                            SwitchListTile(
+                              value: loopPaused,
+                              contentPadding: EdgeInsets.zero,
+                              title: const Text('Pause loop budget'),
+                              subtitle: const Text(
+                                'Skip this task before it calls the model.',
+                              ),
+                              onChanged: (value) =>
+                                  setLocalState(() => loopPaused = value),
+                            ),
+                          ],
+                        ),
+                      ),
                       if (controller.agentProfiles.isNotEmpty) ...<Widget>[
                         const SizedBox(height: 12),
                         DropdownButtonFormField<String>(
@@ -6264,12 +6390,40 @@ class _TasksPanelState extends State<TasksPanel> {
                         triggerConfig['ignoreGroups'] = ignoreGroups;
                       }
                     }
+                    final maxRuns = int.tryParse(maxRunsController.text.trim());
+                    final maxTokens = int.tryParse(
+                      maxTokensController.text.trim(),
+                    );
+                    if (maxRuns == null ||
+                        maxRuns <= 0 ||
+                        maxTokens == null ||
+                        maxTokens <= 0) {
+                      ScaffoldMessenger.of(context).showSnackBar(
+                        const SnackBar(
+                          content: Text(
+                            'Loop budget values must be positive numbers.',
+                          ),
+                          backgroundColor: Colors.red,
+                        ),
+                      );
+                      return;
+                    }
+                    final taskConfig = <String, dynamic>{
+                      ...?task?.taskConfig,
+                      'loopBudget': <String, dynamic>{
+                        'enabled': true,
+                        'paused': loopPaused,
+                        'maxRunsPerDay': maxRuns,
+                        'maxTokensPerDay': maxTokens,
+                      },
+                    };
                     await controller.saveTask(
                       id: task?.id,
                       name: nameController.text.trim(),
                       triggerType: selectedTriggerType,
                       triggerConfig: triggerConfig,
                       prompt: promptController.text.trim(),
+                      taskConfig: taskConfig,
                       model: selectedModel == 'auto' ? null : selectedModel,
                       enabled: enabled,
                       agentId: selectedAgentId,