neoagent 2.3.1-beta.11 → 2.3.1-beta.110

package/flutter_app/DESIGN_SYSTEM.md

@@ -0,0 +1,166 @@
+# NeoAgent Design System
+
+Reference for UI/UX conventions across the Flutter workspace. When adding new screens or widgets, use the tokens and patterns documented here rather than raw values.
+
+---
+
+## Tokens
+
+### Spacing — `AppSpacing` (main_spacing.dart)
+
+| Token | Value | Use |
+|-------|-------|-----|
+| `AppSpacing.xs` | 8px | Tight internal gaps, icon-to-label |
+| `AppSpacing.sm` | 12px | Component internal padding |
+| `AppSpacing.md` | 16px | Standard padding, list item spacing |
+| `AppSpacing.lg` | 24px | Section gaps |
+| `AppSpacing.xl` | 32px | Screen-level margins |
+
+Page-level horizontal padding is handled by `_pagePadding(context)` (20–40px responsive). Do not hardcode page margins.
+
+### Border Radius — `AppRadius` (main_spacing.dart)
+
+| Token | Value | Use |
+|-------|-------|-----|
+| `AppRadius.tag` | 8px | Code blocks, chips, inline badges |
+| `AppRadius.card` | 14px | Secondary cards, list items, blockquotes |
+| `AppRadius.input` | 18px | Buttons, text fields (matches theme) |
+| `AppRadius.panel` | 28px | Major glass surfaces, primary cards (matches theme) |
+| `AppRadius.pill` | 999px | Avatars, full-pill badges, status indicators |
+
+### Typography — `main_theme.dart`
+
+| Function | Size | Weight | Use |
+|----------|------|--------|-----|
+| `_displayTitleStyle(size)` | 28px default | w700 | Section headers, page titles |
+| `_heroTitleStyle(size)` | 24px default | w800 | Stats, empty-state headlines, splash copy |
+| `_sectionEyebrowStyle()` | 12px | w700 | Category labels above sections |
+| Theme `titleMedium` | 18px | w600 | App bar titles, panel headers |
+| Theme `bodyMedium` | — | — | Body text (always prefer theme over `TextStyle()`) |
+
+**Rules:**
+- Minimum font size: **12px**. Never go below this for legibility.
+- Use `Theme.of(context).textTheme.bodyMedium?.copyWith(color: ...)` instead of bare `TextStyle(color: ...)` to guarantee font-family inheritance.
+- Defined weights: **w600** (sub-labels), **w700** (standard bold), **w800** (hero/display). Do not use w400, w500, or w900.
+
+---
+
+## Color System
+
+Colors are defined in `src/theme/palette.dart` and accessed via theme-aware getters in `main_theme.dart`.
+
+### Background layers (darkest → lightest prominence)
+
+```
+_bgPrimary → _bgSecondary → _bgTertiary → _bgCard
+```
+
+### Text hierarchy
+
+```
+_textPrimary (readable body) → _textSecondary (supporting) → _textMuted (subtle, disabled)
+```
+
+### Accents
+
+- `_accent` — gold/brown, primary interactive elements
+- `_accentHover` — lighter gold, hover/focus states
+- `_accentAlt` — teal, secondary highlights, assistant avatar glow
+- `_accentMuted` — low-saturation accent for backgrounds
+
+### Semantic status colors
+
+| Color | Meaning | Never use for |
+|-------|---------|---------------|
+| `_success` | Completed, connected, healthy | General decoration |
+| `_warning` | In-progress, caution | Errors |
+| `_danger` | Error, destructive action, disconnected | Warnings |
+| `_info` | Informational, neutral status | Alerts requiring action |
+
+### Hardcoded color rules
+
+- **Do not** use `Color(0x...)` or `Colors.X` literals in widget trees. Use palette getters.
+- **Exception 1:** `Color(0xFF4285F4)` — Google Sign-In brand blue, required by Google branding guidelines.
+- **Exception 2:** `_qrPanel*` constants in `main_app_shell.dart` — intentional deep-space atmosphere for the QR login panel, defined as named constants at file scope.
+- `Colors.transparent` and `Colors.white/black` with `.withValues(alpha:)` for glass overlays are acceptable when no semantic color applies.
+
+---
+
+## Component Patterns
+
+### Glass surface
+
+Use `_GlassSurface` from `main_shared.dart`. Do not duplicate the backdrop-blur + fill + border pattern inline.
+
+Parameters: `child`, `borderRadius` (default `AppRadius.panel`), `padding`.
+
+### Inline status messages
+
+- Errors → `_InlineError(message: '...')` from `main_shared.dart`
+- Success → `_InlineSuccess(message: '...')` from `main_shared.dart`
+
+Do not inline `Container(color: _danger...)` patterns — use these shared widgets so error styling stays consistent.
+
+### Empty states
+
+Pattern: eyebrow label → icon → headline (`_heroTitleStyle`) → helper text (`_textSecondary`).
+
+### Dialogs
+
+- Confirm/cancel: **Cancel** (outlined, left) + **primary action** (filled, right)
+- Destructive: **Cancel** (left) + **Delete** (filled with `_danger` background, right)
+- Avoid "OK" — always use a specific verb (Save, Connect, Remove, etc.)
+
+### Buttons
+
+- **Primary action:** `FilledButton`
+- **Secondary/cancel:** `OutlinedButton`
+- **Tertiary/nav links:** `TextButton`
+- **Icon-only actions:** `IconButton` — always include `tooltip:` with a descriptive label
+
+---
+
+## Accessibility
+
+- Every `IconButton` must have `tooltip: 'Descriptive action'`.
+- Prefer `InkWell` over `GestureDetector` for tappable surfaces — `InkWell` inherits Material semantics. If you must use `GestureDetector`, wrap it with `Semantics(button: true, label: '...')`.
+- Minimum touch target: 44×44px (Material guideline). Use `minimumSize` on `ButtonStyle` or `IconButton.styleFrom` if needed.
+- Do not rely on color alone to convey state — pair color with an icon or label.
+
+---
+
+## Animation
+
+| Animation | Duration | Curve |
+|-----------|----------|-------|
+| Page entrance (slide + fade) | 700ms | `Curves.easeOutCubic` |
+| Button / container hover | 180ms | `Curves.easeOutCubic` |
+| Ambient background orbs | 24 000ms | `Curves.easeInOut` (looping) |
+| Opacity fades | 140–180ms | default |
+
+---
+
+## Responsive layout
+
+| Breakpoint | Value | Layout change |
+|------------|-------|---------------|
+| `AppBreakpoints.mobile` | 480px | Sidebar becomes modal, single-column |
+| `AppBreakpoints.tablet` | 960px | Two-column layouts activate |
+| Desktop implicit | 1280px+ | Full sidebar + main panel |
+
+Use `_pagePadding(context)` for horizontal screen padding. Do not hardcode `EdgeInsets.symmetric(horizontal: 20)` — the helper already handles responsive scaling.
+
+---
+
+## File conventions
+
+| What | Where |
+|------|-------|
+| Color palette | `lib/src/theme/palette.dart` |
+| Theme builder + text styles | `lib/main_theme.dart` |
+| Spacing + radius tokens | `lib/main_spacing.dart` |
+| Shared widgets | `lib/main_shared.dart` |
+| Navigation enums + labels | `lib/main_navigation.dart` |
+| App state | `lib/main_controller.dart` |
+
+**Do not** define new reusable widgets in feature files (`main_chat.dart`, `main_operations.dart`, etc.) — add them to `main_shared.dart` so they are available across the app.

package/flutter_app/README.md

@@ -0,0 +1,21 @@
+# neoagent_flutter
+
+A new Flutter project.
+
+## Getting Started
+
+This project is a starting point for a Flutter application.
+
+A few resources to get you started if this is your first Flutter project:
+
+- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
+- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook)
+
+For help getting started with Flutter development, view the
+[online documentation](https://docs.flutter.dev/), which offers tutorials,
+samples, guidance on mobile development, and a full API reference.
+
+## Desktop audio capture note
+
+Desktop recording currently depends on `desktop_audio_capture` and is pinned to
+`0.0.2` to avoid unexpected API shifts from automatic minor updates.

package/flutter_app/analysis_options.yaml

@@ -0,0 +1,32 @@
+# This file configures the analyzer, which statically analyzes Dart code to
+# check for errors, warnings, and lints.
+#
+# The issues identified by the analyzer are surfaced in the UI of Dart-enabled
+# IDEs (https://dart.dev/tools#ides-and-editors). The analyzer can also be
+# invoked from the command line by running `flutter analyze`.
+
+# The following line activates a set of recommended lints for Flutter apps,
+# packages, and plugins designed to encourage good coding practices.
+include: package:flutter_lints/flutter.yaml
+
+analyzer:
+  exclude:
+    - third_party/**
+
+linter:
+  # The lint rules applied to this project can be customized in the
+  # section below to disable rules from the `package:flutter_lints/flutter.yaml`
+  # included above or to enable additional rules. A list of all available lints
+  # and their documentation is published at https://dart.dev/lints.
+  #
+  # Instead of disabling a lint rule for the entire project in the
+  # section below, it can also be suppressed for a single line of code
+  # or a specific dart file by using the `// ignore: name_of_lint` and
+  # `// ignore_for_file: name_of_lint` syntax on the line or in the file
+  # producing the lint.
+  rules:
+    # avoid_print: false  # Uncomment to disable the `avoid_print` rule
+    # prefer_single_quotes: true  # Uncomment to enable the `prefer_single_quotes` rule
+
+# Additional information about this file can be found at
+# https://dart.dev/guides/language/analysis-options

package/flutter_app/android/app/build.gradle.kts

@@ -0,0 +1,111 @@
+import java.util.Properties
+
+plugins {
+    id("com.android.application")
+    id("kotlin-android")
+    // The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins.
+    id("dev.flutter.flutter-gradle-plugin")
+}
+
+val envReleaseKeystorePath = System.getenv("ANDROID_KEYSTORE_PATH")?.trim().orEmpty()
+val envReleaseKeystorePassword = System.getenv("ANDROID_KEYSTORE_PASSWORD")?.trim().orEmpty()
+val envReleaseKeyAlias = System.getenv("ANDROID_KEY_ALIAS")?.trim().orEmpty()
+val envReleaseKeyPassword = System.getenv("ANDROID_KEY_PASSWORD")?.trim().orEmpty()
+val keyPropertiesFile = rootProject.file("key.properties")
+val keyProperties = Properties()
+if (keyPropertiesFile.exists()) {
+    keyPropertiesFile.inputStream().use(keyProperties::load)
+}
+val repoReleaseKeystorePath = keyProperties.getProperty("storeFile", "").trim()
+val repoReleaseKeystorePassword = keyProperties.getProperty("storePassword", "").trim()
+val repoReleaseKeyAlias = keyProperties.getProperty("keyAlias", "").trim()
+val repoReleaseKeyPassword = keyProperties.getProperty("keyPassword", "").trim()
+val hasEnvReleaseSigning =
+    envReleaseKeystorePath.isNotEmpty() &&
+        envReleaseKeystorePassword.isNotEmpty() &&
+        envReleaseKeyAlias.isNotEmpty() &&
+        envReleaseKeyPassword.isNotEmpty()
+val hasRepoReleaseSigning =
+    repoReleaseKeystorePath.isNotEmpty() &&
+        repoReleaseKeystorePassword.isNotEmpty() &&
+        repoReleaseKeyAlias.isNotEmpty() &&
+        repoReleaseKeyPassword.isNotEmpty()
+val launcherBuild =
+    System.getenv("NEOAGENT_ANDROID_LAUNCHER_MODE")
+        ?.trim()
+        ?.lowercase() in setOf("1", "true", "yes", "on")
+val applicationIdValue =
+    if (launcherBuild) "com.neoagent.flutter_app.launcher" else "com.neoagent.flutter_app"
+val applicationLabelValue = if (launcherBuild) "NeoAgent Launcher" else "NeoAgent"
+val androidAppModeValue = if (launcherBuild) "launcher" else "standard"
+val launcherHomeEnabledValue = launcherBuild.toString()
+
+android {
+    namespace = "com.neoagent.flutter_app"
+    compileSdk = flutter.compileSdkVersion
+    ndkVersion = flutter.ndkVersion
+
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_11
+        targetCompatibility = JavaVersion.VERSION_11
+    }
+
+    kotlinOptions {
+        jvmTarget = JavaVersion.VERSION_11.toString()
+    }
+
+    defaultConfig {
+        applicationId = applicationIdValue
+        minSdk = 26
+        targetSdk = flutter.targetSdkVersion
+        versionCode = flutter.versionCode
+        versionName = flutter.versionName
+        manifestPlaceholders["neoagentAppLabel"] = applicationLabelValue
+        manifestPlaceholders["neoagentAppMode"] = androidAppModeValue
+        manifestPlaceholders["neoagentLauncherHomeEnabled"] =
+            launcherHomeEnabledValue
+    }
+
+    signingConfigs {
+        if (hasEnvReleaseSigning) {
+            create("release") {
+                storeFile = file(envReleaseKeystorePath)
+                storePassword = envReleaseKeystorePassword
+                keyAlias = envReleaseKeyAlias
+                keyPassword = envReleaseKeyPassword
+            }
+        } else if (hasRepoReleaseSigning) {
+            create("release") {
+                storeFile = rootProject.file(repoReleaseKeystorePath)
+                storePassword = repoReleaseKeystorePassword
+                keyAlias = repoReleaseKeyAlias
+                keyPassword = repoReleaseKeyPassword
+            }
+        }
+    }
+
+    buildTypes {
+        release {
+            signingConfig =
+                if (hasEnvReleaseSigning || hasRepoReleaseSigning) {
+                    signingConfigs.getByName("release")
+                } else {
+                    signingConfigs.getByName("debug")
+                }
+        }
+    }
+}
+
+dependencies {
+    implementation("androidx.activity:activity-ktx:1.10.1")
+    implementation("androidx.car.app:app:1.7.0")
+    implementation("androidx.car.app:app-projected:1.7.0")
+    implementation("androidx.health.connect:connect-client:1.1.0")
+    implementation("androidx.security:security-crypto:1.1.0")
+    implementation("androidx.work:work-runtime-ktx:2.10.1")
+    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.9.0")
+}
+
+flutter {
+    source = "../.."
+}

package/flutter_app/android/app/src/debug/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- The INTERNET permission is required for development. Specifically,
+         the Flutter tool needs it to communicate with the running application
+         to allow setting breakpoints, to provide hot reload, etc.
+    -->
+    <uses-permission android:name="android.permission.INTERNET"/>
+</manifest>

package/flutter_app/android/app/src/main/AndroidManifest.xml

@@ -0,0 +1,185 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.MANAGE_OWN_CALLS" />
+    <uses-permission android:name="android.permission.CAMERA" />
+    <uses-permission android:name="android.permission.RECORD_AUDIO" />
+    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MICROPHONE" />
+    <uses-permission android:name="android.permission.health.READ_STEPS" />
+    <uses-permission android:name="android.permission.health.READ_HEART_RATE" />
+    <uses-permission android:name="android.permission.health.READ_SLEEP" />
+    <uses-permission android:name="android.permission.health.READ_EXERCISE" />
+    <uses-permission android:name="android.permission.health.READ_WEIGHT" />
+    <uses-permission android:name="android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND" />
+    <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
+    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
+    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
+    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
+
+    <queries>
+        <package android:name="com.google.android.apps.healthdata" />
+        <intent>
+            <action android:name="android.intent.action.PROCESS_TEXT"/>
+            <data android:mimeType="text/plain"/>
+        </intent>
+    </queries>
+
+    <application
+        android:label="${neoagentAppLabel}"
+        android:name="${applicationName}"
+        android:icon="@mipmap/ic_launcher"
+        android:usesCleartextTraffic="true">
+        <meta-data
+            android:name="com.google.android.gms.car.application"
+            android:resource="@xml/automotive_app_desc" />
+        <activity
+            android:name=".MainActivity"
+            android:exported="true"
+            android:launchMode="singleTop"
+            android:taskAffinity=""
+            android:theme="@style/LaunchTheme"
+            android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
+            android:hardwareAccelerated="true"
+            android:windowSoftInputMode="adjustResize">
+            <!-- Specifies an Android theme to apply to this Activity as soon as
+                 the Android process has started. This theme is visible to the user
+                 while the Flutter UI initializes. After that, this theme continues
+                 to determine the Window background behind the Flutter UI. -->
+            <meta-data
+              android:name="io.flutter.embedding.android.NormalTheme"
+              android:resource="@style/NormalTheme"
+              />
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN"/>
+                <category android:name="android.intent.category.LAUNCHER"/>
+            </intent-filter>
+            <intent-filter>
+                <action android:name="android.intent.action.SEND" />
+                <category android:name="android.intent.category.DEFAULT" />
+                <data android:mimeType="text/*" />
+                <data android:mimeType="video/*" />
+                <data android:mimeType="image/*" />
+                <data android:mimeType="audio/*" />
+                <data android:mimeType="application/*" />
+            </intent-filter>
+            <intent-filter>
+                <action android:name="android.intent.action.SEND_MULTIPLE" />
+                <category android:name="android.intent.category.DEFAULT" />
+                <data android:mimeType="*/*" />
+            </intent-filter>
+        </activity>
+        <provider
+            android:name="androidx.core.content.FileProvider"
+            android:authorities="${applicationId}.fileprovider"
+            android:exported="false"
+            android:grantUriPermissions="true">
+            <meta-data
+                android:name="android.support.FILE_PROVIDER_PATHS"
+                android:resource="@xml/file_paths" />
+        </provider>
+        <activity-alias
+            android:name=".LauncherHomeAlias"
+            android:enabled="${neoagentLauncherHomeEnabled}"
+            android:exported="true"
+            android:label="${neoagentAppLabel}"
+            android:targetActivity=".MainActivity">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.HOME" />
+                <category android:name="android.intent.category.DEFAULT" />
+            </intent-filter>
+        </activity-alias>
+        <activity
+            android:name=".health.PermissionsRationaleActivity"
+            android:exported="false" />
+        <activity
+            android:name=".widgets.WidgetConfigActivity"
+            android:exported="true"
+            android:theme="@style/LaunchTheme" />
+        <activity-alias
+            android:name=".ViewPermissionUsageActivity"
+            android:exported="true"
+            android:permission="android.permission.START_VIEW_PERMISSION_USAGE"
+            android:targetActivity=".health.PermissionsRationaleActivity">
+            <intent-filter>
+                <action android:name="android.intent.action.VIEW_PERMISSION_USAGE" />
+                <category android:name="android.intent.category.HEALTH_PERMISSIONS" />
+            </intent-filter>
+        </activity-alias>
+        <service
+            android:name="androidx.work.impl.foreground.SystemForegroundService"
+            android:foregroundServiceType="dataSync"
+            tools:node="merge" />
+        <service
+            android:name=".telecom.NeoAgentConnectionService"
+            android:exported="true"
+            android:permission="android.permission.BIND_TELECOM_CONNECTION_SERVICE">
+            <intent-filter>
+                <action android:name="android.telecom.ConnectionService" />
+            </intent-filter>
+        </service>
+        
+        <service
+            android:name=".auto.NeoAgentCarAppService"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="androidx.car.app.CarAppService" />
+                <category android:name="androidx.car.app.category.IOT" />
+            </intent-filter>
+            <meta-data
+                android:name="androidx.car.app.minCarApiLevel"
+                android:value="1" />
+        </service>
+        <service
+            android:name=".recording.RecordingForegroundService"
+            android:exported="false"
+            android:foregroundServiceType="microphone|connectedDevice" />
+        <receiver
+            android:name=".recording.RecordingBootReceiver"
+            android:enabled="true"
+            android:exported="false">
+            <intent-filter>
+                <action android:name="android.intent.action.BOOT_COMPLETED" />
+            </intent-filter>
+        </receiver>
+        <receiver
+            android:name=".widgets.AiHomeWidgetProvider"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
+            </intent-filter>
+            <meta-data
+                android:name="android.appwidget.provider"
+                android:resource="@xml/neoagent_ai_widget_info" />
+        </receiver>
+        <receiver
+            android:name=".widgets.VoiceLaunchWidgetProvider"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
+            </intent-filter>
+            <meta-data
+                android:name="android.appwidget.provider"
+                android:resource="@xml/neoagent_voice_widget_info" />
+        </receiver>
+        <meta-data
+            android:name="com.neoagent.APP_MODE"
+            android:value="${neoagentAppMode}" />
+        <meta-data
+            android:name="flutterEmbedding"
+            android:value="2" />
+            
+        <!-- Notification Listener Service for Interception -->
+        <service android:name="notification.listener.service.NotificationListener"
+                 android:label="NeoAgent Notifications"
+                 android:permission="android.permission.BIND_NOTIFICATION_LISTENER_SERVICE"
+                 android:exported="true">
+            <intent-filter>
+                <action android:name="android.service.notification.NotificationListenerService" />
+            </intent-filter>
+        </service>
+    </application>
+</manifest>