neoagent 2.4.1-beta.28 → 2.4.1-beta.29

package/flutter_app/lib/main_controller.dart

@@ -93,6 +93,8 @@ class NeoAgentController extends ChangeNotifier {
   bool isSavingReleaseChannel = false;
   bool isSyncingHealth = false;
   bool isRunningDeviceAction = false;
+  bool isLoadingWorkspaceFiles = false;
+  bool isSavingWorkspaceFile = false;
   bool isPreparingQrLogin = false;
   bool isApprovingQrLogin = false;
   bool isCheckingAppUpdate = false;
@@ -190,6 +192,10 @@ class NeoAgentController extends ChangeNotifier {
   String? androidLastResult;
   String? desktopLastResult;
   String? androidUiDumpPath;
+  String workspaceCurrentPath = '';
+  String? workspaceSelectedFilePath;
+  String workspaceEditorContent = '';
+  List<Map<String, dynamic>> workspaceEntries = const <Map<String, dynamic>>[];
   final Map<String, RunDetailSnapshot> _runDetailsCache =
       <String, RunDetailSnapshot>{};
   String? _selectedWidgetId;
@@ -3488,6 +3494,102 @@ class NeoAgentController extends ChangeNotifier {
     );
   }
 
+  String workspaceDownloadUrl(String path) {
+    return '${_socketOrigin()}/${_backendClient.workspaceDownloadPath(path).replaceFirst(RegExp(r'^/'), '')}';
+  }
+
+  Future<void> refreshWorkspaceFiles({String? path}) async {
+    if (!isAuthenticated || isLoadingWorkspaceFiles) {
+      return;
+    }
+    isLoadingWorkspaceFiles = true;
+    errorMessage = null;
+    notifyListeners();
+    try {
+      final response = await _backendClient.fetchWorkspaceDirectory(
+        backendUrl,
+        path: path ?? workspaceCurrentPath,
+      );
+      workspaceCurrentPath = response['path']?.toString() ?? '';
+      workspaceEntries = _jsonMapList(
+        response['entries'],
+        fallbackToMapValues: true,
+      );
+    } catch (error) {
+      errorMessage = _friendlyErrorMessage(error);
+    } finally {
+      isLoadingWorkspaceFiles = false;
+      notifyListeners();
+    }
+  }
+
+  Future<void> openWorkspaceDirectory(String path) async {
+    workspaceSelectedFilePath = null;
+    workspaceEditorContent = '';
+    await refreshWorkspaceFiles(path: path);
+  }
+
+  Future<void> openWorkspaceFile(String path) async {
+    if (isLoadingWorkspaceFiles) {
+      return;
+    }
+    isLoadingWorkspaceFiles = true;
+    errorMessage = null;
+    notifyListeners();
+    try {
+      final response = await _backendClient.fetchWorkspaceFile(
+        backendUrl,
+        path: path,
+      );
+      workspaceSelectedFilePath = response['path']?.toString() ?? path;
+      workspaceEditorContent = response['content']?.toString() ?? '';
+    } catch (error) {
+      errorMessage = _friendlyErrorMessage(error);
+    } finally {
+      isLoadingWorkspaceFiles = false;
+      notifyListeners();
+    }
+  }
+
+  Future<void> saveWorkspaceFile(String content) async {
+    final path = workspaceSelectedFilePath?.trim() ?? '';
+    if (path.isEmpty || isSavingWorkspaceFile) {
+      return;
+    }
+    isSavingWorkspaceFile = true;
+    errorMessage = null;
+    notifyListeners();
+    try {
+      await _backendClient.saveWorkspaceFile(
+        backendUrl,
+        path: path,
+        content: content,
+      );
+      workspaceEditorContent = content;
+      await refreshWorkspaceFiles(path: workspaceCurrentPath);
+    } catch (error) {
+      errorMessage = _friendlyErrorMessage(error);
+    } finally {
+      isSavingWorkspaceFile = false;
+      notifyListeners();
+    }
+  }
+
+  Future<void> downloadWorkspaceFile(String path) async {
+    final normalized = path.trim();
+    if (normalized.isEmpty) {
+      return;
+    }
+    final result = await _oauthLauncher.openExternal(
+      url: workspaceDownloadUrl(normalized),
+      label: 'neoagent_workspace_file_download',
+    );
+    if (!result.launched) {
+      errorMessage = result.error ?? 'Could not open workspace file download.';
+      notifyListeners();
+    }
+  }
+
   Uri resolveRuntimeAsset(String path) {
     final separator = path.contains('?') ? '&' : '?';
     return _backendClient.resolveAssetUri(

package/flutter_app/lib/main_devices.dart

@@ -28,6 +28,7 @@ class _DevicesPanelState extends State<DevicesPanel> {
   late final TextEditingController _androidLaunchController;
   late final TextEditingController _desktopLaunchController;
   late final TextEditingController _textEntryController;
+  late final TextEditingController _workspaceEditorController;
   Timer? _surfaceFrameTimer;
   _DeviceSurface _surface = _DeviceSurface.browser;
   _DeviceSurface? _runningSurface;
@@ -41,6 +42,7 @@ class _DevicesPanelState extends State<DevicesPanel> {
     );
     _desktopLaunchController = TextEditingController();
     _textEntryController = TextEditingController();
+    _workspaceEditorController = TextEditingController();
     WidgetsBinding.instance.addPostFrameCallback((_) {
       if (!mounted) {
         return;
@@ -59,6 +61,7 @@ class _DevicesPanelState extends State<DevicesPanel> {
       _androidLaunchController,
       _desktopLaunchController,
       _textEntryController,
+      _workspaceEditorController,
     ]) {
       controller.dispose();
     }
@@ -68,6 +71,7 @@ class _DevicesPanelState extends State<DevicesPanel> {
 
   bool get _isBrowser => _surface == _DeviceSurface.browser;
   bool get _isDesktop => _surface == _DeviceSurface.desktop;
+  bool get _isFiles => _surface == _DeviceSurface.files;
 
   bool get _isCurrentSurfaceBusy =>
       widget.controller.isRunningDeviceAction &&
@@ -182,6 +186,13 @@ class _DevicesPanelState extends State<DevicesPanel> {
       return;
     }
 
+    if (_isFiles) {
+      if (controller.workspaceEntries.isEmpty) {
+        await controller.refreshWorkspaceFiles();
+      }
+      return;
+    }
+
     if (_androidOnline && (controller.androidScreenshotPath ?? '').isEmpty) {
       await controller.screenshotAndroidRuntime();
     }
@@ -203,6 +214,9 @@ class _DevicesPanelState extends State<DevicesPanel> {
       await widget.controller.refreshDesktopFrameRuntime();
       return;
     }
+    if (_isFiles) {
+      return;
+    }
     if (_androidStarting) {
       await widget.controller.refreshDevices();
       if (_androidOnline &&
@@ -260,6 +274,11 @@ class _DevicesPanelState extends State<DevicesPanel> {
       return;
     }
 
+    if (_isFiles) {
+      await controller.refreshWorkspaceFiles();
+      return;
+    }
+
     if (!_androidOnline) {
       await controller.startAndroidRuntime();
       await widget.controller.refreshDevices();
@@ -301,6 +320,9 @@ class _DevicesPanelState extends State<DevicesPanel> {
       }
       return;
     }
+    if (_isFiles) {
+      return;
+    }
     if (!_androidOnline) {
       return;
     }
@@ -316,6 +338,8 @@ class _DevicesPanelState extends State<DevicesPanel> {
       await widget.controller.typeBrowserTextRuntime(text, pressEnter: true);
     } else if (_isDesktop) {
       await widget.controller.typeDesktopRuntime(text, pressEnter: true);
+    } else if (_isFiles) {
+      return;
     } else {
       await widget.controller.typeAndroidRuntime(<String, dynamic>{
         'text': text,
@@ -515,6 +539,18 @@ class _DevicesPanelState extends State<DevicesPanel> {
                       browserExtensionActive: usingExtension,
                       browserFallbackLabel: browserFallbackLabel,
                     ),
+                    if (_isFiles) ...<Widget>[
+                      const SizedBox(height: 14),
+                      _WorkspaceExplorer(
+                        controller: controller,
+                        editorController: _workspaceEditorController,
+                      ),
+                      const SizedBox(height: 14),
+                      _SurfaceSwitcher(
+                        surface: _surface,
+                        onSelect: _selectSurface,
+                      ),
+                    ] else ...<Widget>[
                     if (_isBrowser && prefersExtension) ...<Widget>[
                       const SizedBox(height: 14),
                       if (_browserExtensionDevices.isNotEmpty) ...<Widget>[
@@ -742,6 +778,7 @@ class _DevicesPanelState extends State<DevicesPanel> {
                       surface: _surface,
                       onSelect: _selectSurface,
                     ),
+                    ],
                   ],
                 ),
               ),
@@ -753,13 +790,14 @@ class _DevicesPanelState extends State<DevicesPanel> {
   }
 }
 
-enum _DeviceSurface { browser, android, desktop }
+enum _DeviceSurface { browser, android, desktop, files }
 
 extension _DeviceSurfaceX on _DeviceSurface {
   String get label => switch (this) {
     _DeviceSurface.browser => 'Browser',
     _DeviceSurface.android => 'Phone',
     _DeviceSurface.desktop => 'Desktop',
+    _DeviceSurface.files => 'Files',
   };
 
   String get helper => switch (this) {
@@ -767,12 +805,14 @@ extension _DeviceSurfaceX on _DeviceSurface {
     _DeviceSurface.android => 'Tap to touch. Drag to swipe.',
     _DeviceSurface.desktop =>
       'Tap to click. Drag to drag windows or selections.',
+    _DeviceSurface.files => 'Browse files created by the agent.',
   };
 
   IconData get icon => switch (this) {
     _DeviceSurface.browser => Icons.language_outlined,
     _DeviceSurface.android => Icons.smartphone_outlined,
     _DeviceSurface.desktop => Icons.computer_outlined,
+    _DeviceSurface.files => Icons.folder_outlined,
   };
 }
 
@@ -848,6 +888,7 @@ class _DeviceSurfaceHeader extends StatelessWidget {
             selectedDesktop?['label']?.toString().trim().isNotEmpty == true
                 ? selectedDesktop!['label'].toString()
                 : 'Desktop Companion',
+          _DeviceSurface.files => 'File Explorer',
         };
         final subtitle = switch (surface) {
           _DeviceSurface.browser =>
@@ -889,6 +930,8 @@ class _DeviceSurfaceHeader extends StatelessWidget {
                       ? 'One desktop companion is online. Open the surface to fetch the latest frame.'
                       : 'No desktop companion is online. Enable Companion Mode on a signed-in desktop app.'
                 : '${selectedDesktop['platform'] ?? 'desktop'} · ${selectedDesktop['hostname'] ?? 'unknown host'}',
+          _DeviceSurface.files =>
+            'Secure per-user workspace inside the isolated VM.',
         };
         final statusLabel = surface == _DeviceSurface.browser
             ? browserExtensionPreferred && selectedExtension == null
@@ -906,6 +949,8 @@ class _DeviceSurfaceHeader extends StatelessWidget {
                         : (selectedDesktop['online'] == true
                               ? 'Live'
                               : 'Offline'))
+            : surface == _DeviceSurface.files
+            ? 'Isolated'
             : (androidOnline
                   ? 'Live'
                   : androidStarting
@@ -917,6 +962,8 @@ class _DeviceSurfaceHeader extends StatelessWidget {
             ? (selectedDesktop?['paused'] == true
                   ? _warning
                   : (selectedDesktop?['online'] == true ? _success : _warning))
+            : surface == _DeviceSurface.files
+            ? _success
             : (androidOnline
                   ? _success
                   : (androidStarting ? _accent : _warning));
@@ -1023,16 +1070,19 @@ class _DeviceLaunchBar extends StatelessWidget {
       _DeviceSurface.android => _packageOrUrlHint,
       _DeviceSurface.desktop =>
         'Launch an app on the selected desktop (optional)',
+      _DeviceSurface.files => 'Workspace path',
     };
     final buttonLabel = switch (surface) {
       _DeviceSurface.browser => 'Open',
       _DeviceSurface.android => starting ? 'Starting...' : 'Launch',
       _DeviceSurface.desktop => 'Refresh',
+      _DeviceSurface.files => 'Refresh',
     };
     final sleepLabel = switch (surface) {
       _DeviceSurface.browser => 'Sleep Browser',
       _DeviceSurface.android => 'Sleep Phone',
       _DeviceSurface.desktop => 'Pause Desktop',
+      _DeviceSurface.files => 'Close',
     };
     final narrow = MediaQuery.sizeOf(context).width < 720;
 
@@ -1046,6 +1096,8 @@ class _DeviceLaunchBar extends StatelessWidget {
               ? Icons.travel_explore
               : surface == _DeviceSurface.desktop
               ? Icons.apps_outlined
+              : surface == _DeviceSurface.files
+              ? Icons.folder_outlined
               : Icons.open_in_new,
         ),
       ),
@@ -1058,6 +1110,8 @@ class _DeviceLaunchBar extends StatelessWidget {
             ? Icons.arrow_forward
             : surface == _DeviceSurface.desktop
             ? Icons.desktop_windows_outlined
+            : surface == _DeviceSurface.files
+            ? Icons.refresh_rounded
             : Icons.play_arrow,
       ),
       label: Text(buttonLabel),
@@ -1115,6 +1169,7 @@ class _DeviceTypeDock extends StatelessWidget {
       _DeviceSurface.browser => 'Type into the currently focused field',
       _DeviceSurface.android => 'Type into the current phone field',
       _DeviceSurface.desktop => 'Type into the focused desktop field',
+      _DeviceSurface.files => 'Edit the selected file',
     };
     final narrow = MediaQuery.sizeOf(context).width < 720;
 
@@ -1188,6 +1243,9 @@ class _DeviceQuickActions extends StatelessWidget {
       _DeviceSurface.android => const <MapEntry<String, IconData>>[
         MapEntry<String, IconData>('surface_refresh', Icons.refresh_rounded),
       ],
+      _DeviceSurface.files => const <MapEntry<String, IconData>>[
+        MapEntry<String, IconData>('surface_refresh', Icons.refresh_rounded),
+      ],
     };
 
     return Wrap(
@@ -1570,6 +1628,8 @@ class _InteractiveSurfacePreviewState
       case _DeviceSurface.desktop:
         await widget.controller.screenshotDesktopRuntime();
         break;
+      case _DeviceSurface.files:
+        break;
     }
   }
 
@@ -1678,6 +1738,7 @@ class _InteractiveSurfacePreviewState
       _DeviceSurface.browser => 16 / 10,
       _DeviceSurface.android => 10 / 16,
       _DeviceSurface.desktop => 16 / 10,
+      _DeviceSurface.files => 16 / 10,
     };
 
     return Container(
@@ -1943,6 +2004,7 @@ class _EmptySurfaceState extends StatelessWidget {
         connectRequired
             ? 'Select Desktop'
             : (busy ? 'Refreshing Desktop...' : 'Refresh Desktop'),
+      _DeviceSurface.files => busy ? 'Loading Files...' : 'Refresh Files',
     };
     final message = switch ((surface, busy, isLoadingPreview)) {
       (_DeviceSurface.browser, true, _) =>
@@ -1957,6 +2019,8 @@ class _EmptySurfaceState extends StatelessWidget {
         'Waking the phone and downloading the first preview. This can take a little while.',
       (_DeviceSurface.android, false, true) =>
         'Downloading the latest phone preview...',
+      (_DeviceSurface.files, true, _) => 'Loading workspace files...',
+      (_DeviceSurface.files, false, true) => 'Loading workspace files...',
       _ =>
         surface == _DeviceSurface.browser
             ? connectRequired
@@ -2195,6 +2259,246 @@ class _ExtensionStatusBar extends StatelessWidget {
   }
 }
 
+class _WorkspaceExplorer extends StatefulWidget {
+  const _WorkspaceExplorer({
+    required this.controller,
+    required this.editorController,
+  });
+
+  final NeoAgentController controller;
+  final TextEditingController editorController;
+
+  @override
+  State<_WorkspaceExplorer> createState() => _WorkspaceExplorerState();
+}
+
+class _WorkspaceExplorerState extends State<_WorkspaceExplorer> {
+  String? _syncedPath;
+
+  @override
+  void initState() {
+    super.initState();
+    WidgetsBinding.instance.addPostFrameCallback((_) {
+      if (!mounted || widget.controller.workspaceEntries.isNotEmpty) {
+        return;
+      }
+      unawaited(widget.controller.refreshWorkspaceFiles());
+    });
+  }
+
+  @override
+  void didUpdateWidget(covariant _WorkspaceExplorer oldWidget) {
+    super.didUpdateWidget(oldWidget);
+    final selectedPath = widget.controller.workspaceSelectedFilePath;
+    if (selectedPath != _syncedPath) {
+      _syncedPath = selectedPath;
+      widget.editorController.text = widget.controller.workspaceEditorContent;
+    }
+  }
+
+  Future<void> _openEntry(Map<String, dynamic> entry) async {
+    final path = entry['path']?.toString() ?? '';
+    if (path.isEmpty && entry['name']?.toString() != '') {
+      return;
+    }
+    if (entry['type']?.toString() == 'directory') {
+      await widget.controller.openWorkspaceDirectory(path);
+      return;
+    }
+    await widget.controller.openWorkspaceFile(path);
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final controller = widget.controller;
+    final entries = controller.workspaceEntries;
+    final currentPath = controller.workspaceCurrentPath;
+    final selectedPath = controller.workspaceSelectedFilePath;
+    final busy =
+        controller.isLoadingWorkspaceFiles || controller.isSavingWorkspaceFile;
+    final canGoUp = currentPath.trim().isNotEmpty;
+    final parentPath = currentPath.contains('/')
+        ? currentPath.substring(0, currentPath.lastIndexOf('/'))
+        : '';
+
+    return Container(
+      width: double.infinity,
+      padding: const EdgeInsets.all(14),
+      decoration: BoxDecoration(
+        color: _bgSecondary,
+        borderRadius: BorderRadius.circular(18),
+        border: Border.all(color: _borderLight),
+      ),
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: <Widget>[
+          Row(
+            children: <Widget>[
+              Expanded(
+                child: Text(
+                  currentPath.isEmpty ? '/' : '/$currentPath',
+                  maxLines: 1,
+                  overflow: TextOverflow.ellipsis,
+                  style: TextStyle(
+                    color: _textPrimary,
+                    fontWeight: FontWeight.w700,
+                  ),
+                ),
+              ),
+              IconButton.filledTonal(
+                tooltip: 'Parent folder',
+                onPressed: busy || !canGoUp
+                    ? null
+                    : () => controller.openWorkspaceDirectory(parentPath),
+                icon: const Icon(Icons.arrow_upward_rounded),
+              ),
+              const SizedBox(width: 8),
+              IconButton.filledTonal(
+                tooltip: 'Refresh',
+                onPressed: busy ? null : controller.refreshWorkspaceFiles,
+                icon: const Icon(Icons.refresh_rounded),
+              ),
+            ],
+          ),
+          const SizedBox(height: 12),
+          Container(
+            constraints: const BoxConstraints(maxHeight: 260),
+            decoration: BoxDecoration(
+              color: _bgCard,
+              borderRadius: BorderRadius.circular(14),
+              border: Border.all(color: _borderLight),
+            ),
+            child: entries.isEmpty
+                ? Center(
+                    child: Padding(
+                      padding: const EdgeInsets.all(24),
+                      child: Text(
+                        controller.isLoadingWorkspaceFiles
+                            ? 'Loading files...'
+                            : 'No files in this folder.',
+                        style: TextStyle(color: _textSecondary),
+                      ),
+                    ),
+                  )
+                : ListView.separated(
+                    shrinkWrap: true,
+                    itemCount: entries.length,
+                    separatorBuilder: (_, __) => Divider(
+                      height: 1,
+                      color: _borderLight,
+                    ),
+                    itemBuilder: (context, index) {
+                      final entry = entries[index];
+                      final type = entry['type']?.toString() ?? 'file';
+                      final path = entry['path']?.toString() ?? '';
+                      final selected = selectedPath == path;
+                      return ListTile(
+                        dense: true,
+                        selected: selected,
+                        leading: Icon(
+                          type == 'directory'
+                              ? Icons.folder_outlined
+                              : Icons.insert_drive_file_outlined,
+                          color: type == 'directory' ? _accent : _textSecondary,
+                        ),
+                        title: Text(
+                          entry['name']?.toString() ?? path,
+                          maxLines: 1,
+                          overflow: TextOverflow.ellipsis,
+                        ),
+                        subtitle: type == 'file'
+                            ? Text(_formatWorkspaceBytes(entry['size']))
+                            : null,
+                        trailing: type == 'file'
+                            ? IconButton(
+                                tooltip: 'Download',
+                                onPressed: busy || path.isEmpty
+                                    ? null
+                                    : () => controller.downloadWorkspaceFile(
+                                        path,
+                                      ),
+                                icon: const Icon(Icons.download_outlined),
+                              )
+                            : const Icon(Icons.chevron_right_rounded),
+                        onTap: busy ? null : () => _openEntry(entry),
+                      );
+                    },
+                  ),
+          ),
+          const SizedBox(height: 14),
+          Row(
+            children: <Widget>[
+              Expanded(
+                child: Text(
+                  selectedPath ?? 'No file selected',
+                  maxLines: 1,
+                  overflow: TextOverflow.ellipsis,
+                  style: TextStyle(
+                    color: selectedPath == null ? _textSecondary : _textPrimary,
+                    fontWeight: FontWeight.w700,
+                  ),
+                ),
+              ),
+              OutlinedButton.icon(
+                onPressed: busy || selectedPath == null
+                    ? null
+                    : () => controller.downloadWorkspaceFile(selectedPath),
+                icon: const Icon(Icons.download_outlined, size: 18),
+                label: const Text('Download'),
+              ),
+              const SizedBox(width: 8),
+              FilledButton.icon(
+                onPressed: busy || selectedPath == null
+                    ? null
+                    : () => controller.saveWorkspaceFile(
+                        widget.editorController.text,
+                      ),
+                icon: controller.isSavingWorkspaceFile
+                    ? const SizedBox(
+                        width: 16,
+                        height: 16,
+                        child: CircularProgressIndicator(strokeWidth: 2),
+                      )
+                    : const Icon(Icons.save_outlined, size: 18),
+                label: const Text('Save'),
+              ),
+            ],
+          ),
+          const SizedBox(height: 10),
+          TextField(
+            controller: widget.editorController,
+            enabled: selectedPath != null && !controller.isSavingWorkspaceFile,
+            minLines: 12,
+            maxLines: 18,
+            style: const TextStyle(
+              fontFamily: 'monospace',
+              fontSize: 13,
+              height: 1.35,
+            ),
+            decoration: InputDecoration(
+              hintText: selectedPath == null
+                  ? 'Select a file to view or edit it.'
+                  : 'File contents',
+              alignLabelWithHint: true,
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+}
+
+String _formatWorkspaceBytes(Object? value) {
+  final bytes = value is num ? value.toDouble() : double.tryParse('$value') ?? 0;
+  if (bytes >= 1024 * 1024) {
+    return '${(bytes / (1024 * 1024)).toStringAsFixed(1)} MB';
+  }
+  if (bytes >= 1024) {
+    return '${(bytes / 1024).toStringAsFixed(1)} KB';
+  }
+  return '${bytes.round()} B';
+}
+
 class _ResultBlock extends StatelessWidget {
   const _ResultBlock({required this.label, required this.value});