lollipopkit
diff --git a/‎.github/workflows/analysis.yml‎
Lines changed: 0 additions & 1 deletion b/‎.github/workflows/analysis.yml‎
Lines changed: 0 additions & 1 deletion
diff --git a/‎lib/app.dart‎
Lines changed: 9 additions & 2 deletions b/‎lib/app.dart‎
Lines changed: 9 additions & 2 deletions
diff --git a/‎lib/data/model/ai/ask_ai_models.dart‎
Lines changed: 74 additions & 0 deletions b/‎lib/data/model/ai/ask_ai_models.dart‎
Lines changed: 74 additions & 0 deletions
@@ -32,7 +32,6 @@ jobs:
           path: |
             ${{ env.PUB_CACHE }}
             ~/.pub-cache
-            .dart_tool/package_config.json
           key: ${{ runner.os }}-pub-${{ hashFiles('**/pubspec.lock') }}-${{ hashFiles('**/pubspec.yaml') }}
           restore-keys: |
             ${{ runner.os }}-pub-${{ hashFiles('**/pubspec.lock') }}-
 
@@ -11,9 +11,16 @@ import 'package:server_box/view/page/home.dart';
 
 part 'intro.dart';
 
-class MyApp extends StatelessWidget {
+class MyApp extends StatefulWidget {
   const MyApp({super.key});
 
+  @override
+  State<MyApp> createState() => _MyAppState();
+}
+
+class _MyAppState extends State<MyApp> {
+  late final Future<List<IntroPageBuilder>> _introFuture = _IntroPage.builders;
+
   @override
   Widget build(BuildContext context) {
     _setup(context);
@@ -91,7 +98,7 @@ class MyApp extends StatelessWidget {
       theme: light.fixWindowsFont,
       darkTheme: (tMode < 3 ? dark : dark.toAmoled).fixWindowsFont,
       home: FutureBuilder<List<IntroPageBuilder>>(
-        future: _IntroPage.builders,
+        future: _introFuture,
         builder: (context, snapshot) {
           context.setLibL10n();
           final appL10n = AppLocalizations.of(context);
 
@@ -0,0 +1,74 @@
+import 'package:meta/meta.dart';
+
+/// Chat message exchanged with the Ask AI service.
+enum AskAiMessageRole { user, assistant }
+
+@immutable
+class AskAiMessage {
+  const AskAiMessage({
+    required this.role,
+    required this.content,
+  });
+
+  final AskAiMessageRole role;
+  final String content;
+
+  String get apiRole {
+    switch (role) {
+      case AskAiMessageRole.user:
+        return 'user';
+      case AskAiMessageRole.assistant:
+        return 'assistant';
+    }
+  }
+}
+
+/// Recommended command returned by the AI tool call.
+@immutable
+class AskAiCommand {
+  const AskAiCommand({
+    required this.command,
+    this.description = '',
+    this.toolName,
+  });
+
+  final String command;
+  final String description;
+  final String? toolName;
+}
+
+@immutable
+sealed class AskAiEvent {
+  const AskAiEvent();
+}
+
+/// Incremental text delta emitted while streaming the AI response.
+class AskAiContentDelta extends AskAiEvent {
+  const AskAiContentDelta(this.delta);
+  final String delta;
+}
+
+/// Emits when a tool call returns a runnable command suggestion.
+class AskAiToolSuggestion extends AskAiEvent {
+  const AskAiToolSuggestion(this.command);
+  final AskAiCommand command;
+}
+
+/// Signals that the stream finished successfully.
+class AskAiCompleted extends AskAiEvent {
+  const AskAiCompleted({
+    required this.fullText,
+    required this.commands,
+  });
+
+  final String fullText;
+  final List<AskAiCommand> commands;
+}
+
+/// Signals that the stream terminated with an error before completion.
+class AskAiStreamError extends AskAiEvent {
+  const AskAiStreamError(this.error, this.stackTrace);
+
+  final Object error;
+  final StackTrace? stackTrace;
+}