neoagent 3.0.1-beta.8 → 3.1.0

package/flutter_app/lib/src/backend_client.dart

@@ -213,7 +213,11 @@ class BackendClient {
   }
 
   Future<Map<String, dynamic>> completeOnboarding(String baseUrl) async {
-    return postMap(baseUrl, '/api/auth/onboarding/complete', const <String, dynamic>{});
+    return postMap(
+      baseUrl,
+      '/api/auth/onboarding/complete',
+      const <String, dynamic>{},
+    );
   }
 
   Future<Map<String, dynamic>> fetchAgentProfiles(String baseUrl) async {
@@ -228,6 +232,23 @@ class BackendClient {
     return getMap(baseUrl, '/api/account/usage');
   }
 
+  /// GDPR data portability — returns a structured export of the signed-in
+  /// user's own data (credential fields are redacted server-side).
+  Future<Map<String, dynamic>> exportMyData(String baseUrl) async {
+    return getMap(baseUrl, '/api/account/export');
+  }
+
+  /// GDPR right to erasure — permanently deletes the signed-in user's account
+  /// and all associated data. [confirmUsername] must equal the account username.
+  Future<Map<String, dynamic>> deleteMyAccount({
+    required String baseUrl,
+    required String confirmUsername,
+  }) async {
+    return postMap(baseUrl, '/api/account/delete', <String, dynamic>{
+      'confirmUsername': confirmUsername,
+    });
+  }
+
   Future<Map<String, dynamic>> updateAccountEmail({
     required String baseUrl,
     required String email,
@@ -342,6 +363,59 @@ class BackendClient {
     return deleteMap(baseUrl, '/api/account/sessions/$sessionId');
   }
 
+  // ── Billing ──────────────────────────────────────────────────────────────
+
+  Future<Map<String, dynamic>> getBillingPlans(String baseUrl) async {
+    return getMap(baseUrl, '/api/billing/plans', allowUnauthorized: true);
+  }
+
+  Future<Map<String, dynamic>> getBillingInfo(String baseUrl) async {
+    return getMap(baseUrl, '/api/billing/');
+  }
+
+  Future<Map<String, dynamic>> getBillingInvoices(String baseUrl) async {
+    return getMap(baseUrl, '/api/billing/invoices');
+  }
+
+  Future<Map<String, dynamic>> createCheckoutSession({
+    required String baseUrl,
+    required String planId,
+    required String successUrl,
+    required String cancelUrl,
+  }) async {
+    return postMap(baseUrl, '/api/billing/checkout', <String, dynamic>{
+      'planId': planId,
+      'successUrl': successUrl,
+      'cancelUrl': cancelUrl,
+    });
+  }
+
+  Future<Map<String, dynamic>> createPortalSession({
+    required String baseUrl,
+    required String returnUrl,
+  }) async {
+    return postMap(baseUrl, '/api/billing/portal', <String, dynamic>{
+      'returnUrl': returnUrl,
+    });
+  }
+
+  Future<Map<String, dynamic>> cancelBillingSubscription(String baseUrl) async {
+    return postMap(baseUrl, '/api/billing/cancel', const <String, dynamic>{});
+  }
+
+  Future<Map<String, dynamic>> startBillingTrial({
+    required String baseUrl,
+    required String planId,
+    String? deviceFingerprint,
+  }) async {
+    return postMap(baseUrl, '/api/billing/trial', <String, dynamic>{
+      'planId': planId,
+      if (deviceFingerprint != null) 'deviceFingerprint': deviceFingerprint,
+    });
+  }
+
+  // ── Agent profiles ────────────────────────────────────────────────────────
+
   Future<Map<String, dynamic>> createAgentProfile(
     String baseUrl,
     Map<String, dynamic> payload,
@@ -371,10 +445,23 @@ class BackendClient {
   Future<Map<String, dynamic>> fetchChatHistory(
     String baseUrl, {
     String? agentId,
+    int limit = 40,
+    String? beforeCreatedAt,
+    String? beforeSource,
+    String? beforeId,
   }) async {
+    final params = <String>[
+      'limit=$limit',
+      if (beforeCreatedAt != null && beforeCreatedAt.trim().isNotEmpty)
+        'beforeCreatedAt=${Uri.encodeQueryComponent(beforeCreatedAt.trim())}',
+      if (beforeSource != null && beforeSource.trim().isNotEmpty)
+        'beforeSource=${Uri.encodeQueryComponent(beforeSource.trim())}',
+      if (beforeId != null && beforeId.trim().isNotEmpty)
+        'beforeId=${Uri.encodeQueryComponent(beforeId.trim())}',
+    ];
     return getMap(
       baseUrl,
-      _withAgentQuery('/api/agents/chat-history?limit=120', agentId),
+      _withAgentQuery('/api/agents/chat-history?${params.join('&')}', agentId),
     );
   }
 
@@ -461,6 +548,32 @@ class BackendClient {
     return getMap(baseUrl, _withAgentQuery('/api/agents?limit=20', agentId));
   }
 
+  Future<Map<String, dynamic>> fetchTimeline(
+    String baseUrl, {
+    Iterable<String>? sources,
+    String? agentId,
+    int limit = 50,
+    String? beforeOccurredAt,
+    int? beforeId,
+  }) async {
+    final query = <String>[
+      'limit=${limit.clamp(1, 200)}',
+      if (agentId?.trim().isNotEmpty == true)
+        'agentId=${Uri.encodeQueryComponent(agentId!.trim())}',
+      if (beforeOccurredAt?.trim().isNotEmpty == true)
+        'beforeOccurredAt=${Uri.encodeQueryComponent(beforeOccurredAt!.trim())}',
+      if (beforeId != null && beforeId > 0) 'beforeId=$beforeId',
+    ];
+    for (final source in (sources ?? const <String>[])) {
+      final normalized = source.trim().toLowerCase();
+      if (normalized.isEmpty) {
+        continue;
+      }
+      query.add('source=${Uri.encodeQueryComponent(normalized)}');
+    }
+    return getMap(baseUrl, '/api/timeline?${query.join('&')}');
+  }
+
   Future<Map<String, dynamic>> fetchRunSteps(
     String baseUrl,
     String runId,
@@ -506,9 +619,11 @@ class BackendClient {
     String baseUrl, {
     required String tokenId,
   }) async {
-    return postMap(baseUrl, '/api/browser-extension/select-token', <String, dynamic>{
-      'tokenId': tokenId,
-    });
+    return postMap(
+      baseUrl,
+      '/api/browser-extension/select-token',
+      <String, dynamic>{'tokenId': tokenId},
+    );
   }
 
   Future<Map<String, dynamic>> launchBrowser(
@@ -1204,7 +1319,10 @@ class BackendClient {
     String? agentId,
   }) async {
     final response = await _httpClient.delete(
-      _resolveUri(baseUrl, _withAgentQuery('/api/integrations/$providerId/config', agentId)),
+      _resolveUri(
+        baseUrl,
+        _withAgentQuery('/api/integrations/$providerId/config', agentId),
+      ),
       headers: const <String, String>{'Accept': 'application/json'},
     );
     _throwIfError(response);
@@ -1549,6 +1667,7 @@ class BackendClient {
     required String triggerType,
     required Map<String, dynamic> triggerConfig,
     required String prompt,
+    Map<String, dynamic>? taskConfig,
     String? model,
     bool enabled = true,
     String? agentId,
@@ -1557,6 +1676,7 @@ class BackendClient {
       'name': name,
       'triggerType': triggerType,
       'triggerConfig': triggerConfig,
+      if (taskConfig != null) 'taskConfig': taskConfig,
       'prompt': prompt,
       'model': model,
       'enabled': enabled,
@@ -1710,10 +1830,11 @@ class BackendClient {
     required String audioBase64,
     String mimeType = 'audio/pcm;rate=16000;channels=1',
   }) {
-    return postMap(baseUrl, '/api/voice-assistant/transcribe', <String, dynamic>{
-      'audioBase64': audioBase64,
-      'mimeType': mimeType,
-    });
+    return postMap(
+      baseUrl,
+      '/api/voice-assistant/transcribe',
+      <String, dynamic>{'audioBase64': audioBase64, 'mimeType': mimeType},
+    );
   }
 
   Future<Map<String, dynamic>> runVoiceAssistantTurn(
@@ -2029,8 +2150,13 @@ class BackendClient {
     return getMap(baseUrl, '/api/security/mode');
   }
 
-  Future<Map<String, dynamic>> saveSecurityMode(String baseUrl, String mode) async {
-    return putMap(baseUrl, '/api/security/mode', <String, dynamic>{'mode': mode});
+  Future<Map<String, dynamic>> saveSecurityMode(
+    String baseUrl,
+    String mode,
+  ) async {
+    return putMap(baseUrl, '/api/security/mode', <String, dynamic>{
+      'mode': mode,
+    });
   }
 
   Future<Map<String, dynamic>> saveSecurityPolicy(
@@ -2053,13 +2179,17 @@ class BackendClient {
     String? toolName,
     Map<String, dynamic>? toolArgs,
   }) async {
-    return postMap(baseUrl, '/api/security/approvals/$approvalId', <String, dynamic>{
-      'decision': decision,
-      'scope': scope,
-      if (runId != null) 'runId': runId,
-      if (toolName != null) 'toolName': toolName,
-      if (toolArgs != null) 'toolArgs': toolArgs,
-    });
+    return postMap(
+      baseUrl,
+      '/api/security/approvals/$approvalId',
+      <String, dynamic>{
+        'decision': decision,
+        'scope': scope,
+        if (runId != null) 'runId': runId,
+        if (toolName != null) 'toolName': toolName,
+        if (toolArgs != null) 'toolArgs': toolArgs,
+      },
+    );
   }
 }
 

package/flutter_app/lib/src/desktop_companion_actions.dart

@@ -86,6 +86,12 @@ class DesktopCompanionActions {
       'metadata': <String, Object?>{
         'captureSupported': _screenCapture.isSupported,
       },
+      if (platformStatus['sessionLocked'] != null)
+        'sessionLocked': platformStatus['sessionLocked'],
+      if (platformStatus['idleSeconds'] != null)
+        'idleSeconds': platformStatus['idleSeconds'],
+      if (platformStatus['userIdle'] != null)
+        'userIdle': platformStatus['userIdle'],
     };
   }
 
@@ -178,6 +184,12 @@ class DesktopCompanionActions {
         'frontmostApp': platformStatus['frontmostApp'],
       if (platformStatus['frontmostWindowTitle'] != null)
         'frontmostWindowTitle': platformStatus['frontmostWindowTitle'],
+      if (platformStatus['sessionLocked'] != null)
+        'sessionLocked': platformStatus['sessionLocked'],
+      if (platformStatus['idleSeconds'] != null)
+        'idleSeconds': platformStatus['idleSeconds'],
+      if (platformStatus['userIdle'] != null)
+        'userIdle': platformStatus['userIdle'],
     };
   }
 
@@ -206,10 +218,10 @@ class DesktopCompanionActions {
     if (_looksLikeJpeg(raw)) return raw;
     // Run the pure-Dart PNG decode + JPEG encode in a background isolate so the
     // main isolate's event loop stays responsive for incoming commands.
-    return compute(
-      _compressJpegInIsolate,
-      (bytes: raw, quality: quality.clamp(30, 95)),
-    );
+    return compute(_compressJpegInIsolate, (
+      bytes: raw,
+      quality: quality.clamp(30, 95),
+    ));
   }
 
   Future<Map<String, Object?>> observe({
@@ -265,19 +277,9 @@ class DesktopCompanionActions {
   }) async {
     await _assertInputSupported('mouseMove');
     if (_usesNativeDesktopBridge) {
-      await _nativeBridge.mouseMove(
-        x: x,
-        y: y,
-        displayId: displayId,
-      );
+      await _nativeBridge.mouseMove(x: x, y: y, displayId: displayId);
     } else if (defaultTargetPlatform == TargetPlatform.linux) {
-      await _run(
-        _ShellCommand('xdotool', <String>[
-          'mousemove',
-          '$x',
-          '$y',
-        ]),
-      );
+      await _run(_ShellCommand('xdotool', <String>['mousemove', '$x', '$y']));
     } else {
       throw Exception('mouseMove is not supported on this platform.');
     }
@@ -464,9 +466,15 @@ class DesktopCompanionActions {
     int? timeoutMs,
     String? stdinInput,
   }) async {
-    final shell = Platform.isWindows ? 'cmd.exe' : (Platform.environment['SHELL'] ?? '/bin/sh');
-    final args = Platform.isWindows ? <String>['/c', command] : <String>['-lc', command];
-    final workingDir = cwd?.trim().isNotEmpty == true ? cwd : Platform.environment['HOME'];
+    final shell = Platform.isWindows
+        ? 'cmd.exe'
+        : (Platform.environment['SHELL'] ?? '/bin/sh');
+    final args = Platform.isWindows
+        ? <String>['/c', command]
+        : <String>['-lc', command];
+    final workingDir = cwd?.trim().isNotEmpty == true
+        ? cwd
+        : Platform.environment['HOME'];
     final startedAt = DateTime.now();
 
     final process = await Process.start(
@@ -495,7 +503,9 @@ class DesktopCompanionActions {
     });
 
     final effectiveTimeout = Duration(
-      milliseconds: (timeoutMs != null && timeoutMs > 0) ? timeoutMs : 15 * 60 * 1000,
+      milliseconds: (timeoutMs != null && timeoutMs > 0)
+          ? timeoutMs
+          : 15 * 60 * 1000,
     );
 
     bool timedOut = false;
@@ -513,7 +523,9 @@ class DesktopCompanionActions {
 
     String trimOutput(StringBuffer buf) {
       final s = buf.toString().trim();
-      return s.length > maxChars ? '${s.substring(0, maxChars)}\n...[truncated, ${s.length} total chars]' : s;
+      return s.length > maxChars
+          ? '${s.substring(0, maxChars)}\n...[truncated, ${s.length} total chars]'
+          : s;
     }
 
     return <String, Object?>{
@@ -607,9 +619,108 @@ class DesktopCompanionActions {
     if (_usesNativeDesktopBridge) {
       return await _nativeBridge.getStatus();
     }
+    if (defaultTargetPlatform == TargetPlatform.linux) {
+      return _linuxPlatformStatus();
+    }
     return const <String, Object?>{};
   }
 
+  Future<Map<String, Object?>> _linuxPlatformStatus() async {
+    try {
+      final sessionState = await _linuxSessionState();
+      final windowIdResult = await Process.run('xdotool', <String>[
+        'getactivewindow',
+      ]);
+      if (windowIdResult.exitCode != 0) {
+        return sessionState;
+      }
+      final windowId = windowIdResult.stdout?.toString().trim() ?? '';
+      if (windowId.isEmpty) {
+        return sessionState;
+      }
+      final titleResult = await Process.run('xdotool', <String>[
+        'getwindowname',
+        windowId,
+      ]);
+      final classResult = await Process.run('xprop', <String>[
+        '-id',
+        windowId,
+        'WM_CLASS',
+      ]);
+      final windowTitle = titleResult.exitCode == 0
+          ? titleResult.stdout?.toString().trim() ?? ''
+          : '';
+      final appName = _parseLinuxWmClass(classResult.stdout?.toString() ?? '');
+      return <String, Object?>{
+        ...sessionState,
+        if (appName.isNotEmpty) 'frontmostApp': appName,
+        if (windowTitle.isNotEmpty) 'frontmostWindowTitle': windowTitle,
+      };
+    } catch (_) {
+      return const <String, Object?>{};
+    }
+  }
+
+  String _parseLinuxWmClass(String raw) {
+    final match = RegExp(r'"([^"]+)"\s*,\s*"([^"]+)"').firstMatch(raw);
+    if (match == null) {
+      return '';
+    }
+    final app = match.group(2)?.trim() ?? '';
+    if (app.isNotEmpty) {
+      return app;
+    }
+    return match.group(1)?.trim() ?? '';
+  }
+
+  Future<Map<String, Object?>> _linuxSessionState() async {
+    final state = <String, Object?>{};
+    final sessionId = Platform.environment['XDG_SESSION_ID']?.trim() ?? '';
+    if (sessionId.isNotEmpty) {
+      try {
+        final result = await Process.run('loginctl', <String>[
+          'show-session',
+          sessionId,
+          '-p',
+          'LockedHint',
+          '-p',
+          'IdleHint',
+        ]);
+        if (result.exitCode == 0) {
+          final lines = result.stdout
+              ?.toString()
+              .split(RegExp(r'\r?\n'))
+              .map((line) => line.trim())
+              .where((line) => line.isNotEmpty)
+              .toList(growable: false) ??
+              const <String>[];
+          for (final line in lines) {
+            if (line.startsWith('LockedHint=')) {
+              state['sessionLocked'] =
+                  line.substring('LockedHint='.length).trim() == 'yes';
+            } else if (line.startsWith('IdleHint=')) {
+              state['userIdle'] =
+                  line.substring('IdleHint='.length).trim() == 'yes';
+            }
+          }
+        }
+      } catch (_) {}
+    }
+    try {
+      final result = await Process.run('xprintidle', const <String>[]);
+      if (result.exitCode == 0) {
+        final idleMs = num.tryParse(result.stdout?.toString().trim() ?? '');
+        if (idleMs != null) {
+          final idleSeconds = idleMs / 1000;
+          state['idleSeconds'] = idleSeconds;
+          state['userIdle'] =
+              (state['userIdle'] == true) || idleSeconds >= 300;
+        }
+      }
+    } catch (_) {}
+    return state;
+  }
+
   bool get _usesNativeDesktopBridge =>
       defaultTargetPlatform == TargetPlatform.macOS ||
       defaultTargetPlatform == TargetPlatform.windows;

package/flutter_app/lib/src/desktop_companion_io.dart

@@ -7,6 +7,8 @@ import 'package:flutter/foundation.dart';
 import 'package:shared_preferences/shared_preferences.dart';
 
 import 'desktop_companion_actions.dart';
+import 'desktop_ocr_bridge.dart';
+import 'desktop_passive_history.dart';
 import 'desktop_screen_capture.dart';
 
 const String desktopCompanionEnabledPrefsKey = 'desktop.companion.enabled';
@@ -20,9 +22,16 @@ const String desktopCompanionActiveDisplayPrefsKey =
 
 class DesktopCompanionManager extends ChangeNotifier {
   DesktopCompanionManager({required DesktopScreenCapture screenCapture})
-    : _actions = DesktopCompanionActions(screenCapture: screenCapture);
+    : _actions = DesktopCompanionActions(screenCapture: screenCapture),
+      _passiveHistory = DesktopPassiveHistoryManager(
+        actions: DesktopCompanionActions(screenCapture: screenCapture),
+        ocrBridge: createDesktopOcrBridge(),
+      ) {
+    _passiveHistory.addListener(_handlePassiveHistoryChanged);
+  }
 
   final DesktopCompanionActions _actions;
+  final DesktopPassiveHistoryManager _passiveHistory;
   WebSocket? _socket;
   Timer? _reconnectTimer;
   Timer? _connectionWatchdogTimer;
@@ -54,6 +63,7 @@ class DesktopCompanionManager extends ChangeNotifier {
   Map<String, Object?> _status = const <String, Object?>{};
 
   bool get enabled => _enabled;
+  bool get passiveHistoryEnabled => _passiveHistory.enabled;
   bool get paused => _paused;
   bool get connecting => _connecting;
   bool get connected => _connected;
@@ -61,6 +71,8 @@ class DesktopCompanionManager extends ChangeNotifier {
   String get label => _label;
   String get deviceId => _deviceId;
   String get activationId => _activationId;
+  String? get passiveHistoryLastUploadedAt => _passiveHistory.lastUploadedAt;
+  String? get passiveHistoryLastError => _passiveHistory.lastError;
   Map<String, Object?> get status => _status;
 
   Future<void> bootstrap(SharedPreferences prefs) async {
@@ -81,6 +93,7 @@ class DesktopCompanionManager extends ChangeNotifier {
         'primary';
     await prefs.setString(desktopCompanionDeviceIdPrefsKey, _deviceId);
     await prefs.setString(desktopCompanionActivationIdPrefsKey, _activationId);
+    await _passiveHistory.bootstrap(prefs);
   }
 
   Future<void> updateSession({
@@ -91,6 +104,7 @@ class DesktopCompanionManager extends ChangeNotifier {
     _backendUrl = backendUrl.trim();
     _sessionCookie = sessionCookie.trim();
     _authenticated = authenticated;
+    _syncPassiveHistoryRuntimeState();
     if (!_authenticated || !_enabled || _sessionCookie.isEmpty) {
       await disconnect();
       return;
@@ -115,6 +129,7 @@ class DesktopCompanionManager extends ChangeNotifier {
       await disconnect();
       return;
     }
+    _syncPassiveHistoryRuntimeState();
     await _ensureConnected();
   }
 
@@ -123,6 +138,7 @@ class DesktopCompanionManager extends ChangeNotifier {
     _label = normalized;
     await prefs.setString(desktopCompanionLabelPrefsKey, normalized);
     notifyListeners();
+    _syncPassiveHistoryRuntimeState();
     if (_connected) {
       _status = {..._status, 'label': normalized};
       await _sendEvent('statusChanged', <String, Object?>{'label': normalized});
@@ -132,11 +148,24 @@ class DesktopCompanionManager extends ChangeNotifier {
   Future<void> setPaused(bool value, SharedPreferences prefs) async {
     _paused = value;
     notifyListeners();
+    _syncPassiveHistoryRuntimeState();
     if (_connected) {
       await _sendEvent('statusChanged', <String, Object?>{'paused': value});
     }
   }
 
+  Future<void> setPassiveHistoryEnabled(
+    bool value,
+    SharedPreferences prefs,
+  ) async {
+    await _passiveHistory.setEnabled(value, prefs);
+    _syncPassiveHistoryRuntimeState();
+    _mergePassiveHistoryStatus();
+    if (_connected) {
+      await _sendEvent('statusChanged', _passiveHistory.statusPayload());
+    }
+  }
+
   Future<void> disconnect() async {
     _reconnectTimer?.cancel();
     _reconnectTimer = null;
@@ -152,6 +181,7 @@ class DesktopCompanionManager extends ChangeNotifier {
         await socket.close();
       } catch (_) {}
     }
+    _syncPassiveHistoryRuntimeState();
     notifyListeners();
   }
 
@@ -180,7 +210,9 @@ class DesktopCompanionManager extends ChangeNotifier {
       'hostname': _localHostname(),
       'companionEnabled': _enabled,
       'paused': _paused,
+      ..._passiveHistory.statusPayload(),
     };
+    _syncPassiveHistoryRuntimeState();
     notifyListeners();
     if (_connected) {
       await _sendEvent('statusChanged', <String, Object?>{
@@ -188,6 +220,7 @@ class DesktopCompanionManager extends ChangeNotifier {
         'capabilities': _status['capabilities'],
         'displays': _status['displays'],
         'activeDisplayId': _status['activeDisplayId'],
+        ..._passiveHistory.statusPayload(),
       });
     }
     return _status;
@@ -247,6 +280,7 @@ class DesktopCompanionManager extends ChangeNotifier {
         paused: _paused,
         activeDisplayId: _activeDisplayId,
       );
+      hello.addAll(_passiveHistory.statusPayload());
       socket.add(
         jsonEncode(<String, Object?>{'type': 'hello', 'device': hello}),
       );
@@ -281,6 +315,8 @@ class DesktopCompanionManager extends ChangeNotifier {
         _status = device is Map
             ? device.map((key, value) => MapEntry(key.toString(), value))
             : const <String, Object?>{};
+        _mergePassiveHistoryStatus();
+        _syncPassiveHistoryRuntimeState();
         _activeDisplayId =
             _status['activeDisplayId']?.toString() ?? _activeDisplayId;
         notifyListeners();
@@ -467,6 +503,7 @@ class DesktopCompanionManager extends ChangeNotifier {
     _socket = null;
     _connecting = false;
     _connected = false;
+    _syncPassiveHistoryRuntimeState();
     notifyListeners();
     _scheduleReconnect();
   }
@@ -481,6 +518,8 @@ class DesktopCompanionManager extends ChangeNotifier {
     _connecting = false;
     _connected = false;
     _enabled = false;
+    _passiveHistory.removeListener(_handlePassiveHistoryChanged);
+    _passiveHistory.dispose();
     final socket = _socket;
     _socket = null;
     if (socket != null) {
@@ -527,6 +566,31 @@ class DesktopCompanionManager extends ChangeNotifier {
     );
   }
 
+  void _syncPassiveHistoryRuntimeState() {
+    _passiveHistory.updateRuntimeState(
+      backendUrl: _backendUrl,
+      sessionCookie: _sessionCookie,
+      authenticated: _authenticated,
+      connected: _connected,
+      paused: _paused,
+      deviceId: _deviceId,
+      activationId: _activationId,
+      label: _label,
+    );
+  }
+
+  void _mergePassiveHistoryStatus() {
+    _status = <String, Object?>{..._status, ..._passiveHistory.statusPayload()};
+  }
+
+  void _handlePassiveHistoryChanged() {
+    _mergePassiveHistoryStatus();
+    if (_connected) {
+      unawaited(_sendEvent('statusChanged', _passiveHistory.statusPayload()));
+    }
+    notifyListeners();
+  }
+
   Future<Map<String, Object?>> _startStreaming(
     Map<String, Object?> payload,
   ) async {

package/flutter_app/lib/src/desktop_companion_stub.dart

@@ -9,11 +9,14 @@ const String desktopCompanionDeviceIdPrefsKey = 'desktop.companion.deviceId';
 const String desktopCompanionActivationIdPrefsKey =
     'desktop.companion.activationId';
 const String desktopCompanionPausedPrefsKey = 'desktop.companion.paused';
+const String desktopPassiveHistoryEnabledPrefsKey =
+    'desktop.passiveHistory.enabled';
 
 class DesktopCompanionManager extends ChangeNotifier {
   DesktopCompanionManager({required DesktopScreenCapture screenCapture});
 
   bool get enabled => false;
+  bool get passiveHistoryEnabled => false;
   bool get paused => false;
   bool get connecting => false;
   bool get connected => false;
@@ -21,6 +24,8 @@ class DesktopCompanionManager extends ChangeNotifier {
   String get label => 'Desktop';
   String get deviceId => '';
   String get activationId => '';
+  String? get passiveHistoryLastUploadedAt => null;
+  String? get passiveHistoryLastError => null;
   Map<String, Object?> get status => const <String, Object?>{};
 
   Future<void> bootstrap(SharedPreferences prefs) async {}
@@ -43,6 +48,13 @@ class DesktopCompanionManager extends ChangeNotifier {
     throw UnsupportedError('Desktop companion is not available here.');
   }
 
+  Future<void> setPassiveHistoryEnabled(
+    bool value,
+    SharedPreferences prefs,
+  ) async {
+    throw UnsupportedError('Desktop companion is not available here.');
+  }
+
   Future<void> disconnect() async {}
 
   Future<void> rotateIdentity(SharedPreferences prefs) async {

package/flutter_app/lib/src/desktop_ocr_bridge.dart

@@ -0,0 +1,2 @@
+export 'desktop_ocr_bridge_stub.dart'
+    if (dart.library.io) 'desktop_ocr_bridge_io.dart';