core functionalities of dashbot

doc/user_guide/README.md

@@ -3,6 +3,7 @@
 - [History of Requests](https://github.com/foss42/apidash/blob/main/doc/user_guide/his_user_guide.md)
 - [Environment Variables Manager](https://github.com/foss42/apidash/blob/main/doc/user_guide/env_user_guide.md)
 - [How to Disable SSL for Requests](https://github.com/foss42/apidash/blob/main/doc/user_guide/disable_ssl.md)
+- [Dashbot User Guide](https://github.com/foss42/apidash/blob/main/doc/user_guide/dashbot_user_guide.md)
 - Import Request for cURL (Contributions Welcome!)
 - [How to Run Generated Code for a Programming Language](https://github.com/foss42/apidash/blob/main/doc/user_guide/instructions_to_run_generated_code.md) (Contributions Welcome!)
 - [API Dash on Mobile](https://github.com/foss42/apidash/blob/main/doc/user_guide/req_user_guide.md)

lib/consts.dart

@@ -450,6 +450,7 @@ const kLabelDownload = "Download";
 const kLabelSaving = "Saving";
 const kLabelSaved = "Saved";
 const kLabelCode = "Code";
+const kLabelDashBot = "DashBot";
 const kLabelDuplicate = "Duplicate";
 const kLabelSelect = "Select";
 const kLabelContinue = "Continue";

lib/dashbot/constants.dart

@@ -0,0 +1,56 @@
+/// Role of a chat message author.
+enum MessageRole { user, system }
+
+enum ChatMessageType {
+  explainResponse,
+  debugError,
+  generateTest,
+  generateDoc,
+  generateCode,
+  importCurl,
+  importOpenApi,
+  general
+}
+
+enum ChatActionType {
+  updateField('update_field'),
+  addHeader('add_header'),
+  updateHeader('update_header'),
+  deleteHeader('delete_header'),
+  updateBody('update_body'),
+  updateUrl('update_url'),
+  updateMethod('update_method'),
+  showLanguages('show_languages'),
+  applyCurl('apply_curl'),
+  applyOpenApi('apply_openapi'),
+  downloadDoc('download_doc'),
+  other('other'),
+  noAction('no_action'),
+  uploadAsset('upload_asset');
+
+  const ChatActionType(this.text);
+  final String text;
+}
+
+enum ChatActionTarget {
+  httpRequestModel,
+  codegen,
+  test,
+  code,
+  attachment,
+  documentation,
+}
+
+ChatActionType chatActionTypeFromString(String s) {
+  return ChatActionType.values.firstWhere(
+    (type) => type.text == s,
+    orElse: () => ChatActionType.other,
+  );
+}
+
+ChatActionTarget chatActionTargetFromString(String s) {
+  return ChatActionTarget.values.firstWhere(
+    (target) => target.name == s,
+    orElse: () => ChatActionTarget.httpRequestModel,
+  );
+}

lib/dashbot/dashbot.dart

@@ -1 +1,4 @@
-export 'widgets/dashbot_widget.dart';
+export 'dashbot_dashboard.dart';
+export 'dashbot_tab.dart';
+export 'providers/providers.dart';
+export 'utils/utils.dart';

lib/dashbot/dashbot_dashboard.dart

@@ -0,0 +1,220 @@
+import 'package:apidash_core/apidash_core.dart';
+import 'package:apidash_design_system/apidash_design_system.dart';
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:apidash/providers/providers.dart';
+import 'package:apidash/screens/common_widgets/ai/ai.dart';
+import 'providers/providers.dart';
+import 'routes/routes.dart';
+import 'utils/utils.dart';
+
+class DashbotWindow extends ConsumerWidget {
+  final VoidCallback onClose;
+
+  const DashbotWindow({super.key, required this.onClose});
+
+  static final GlobalKey<NavigatorState> _dashbotNavigatorKey =
+      GlobalKey<NavigatorState>();
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final windowState = ref.watch(dashbotWindowNotifierProvider);
+    final windowNotifier = ref.read(dashbotWindowNotifierProvider.notifier);
+    final settings = ref.watch(settingsProvider);
+    final activeRoute = ref.watch(dashbotActiveRouteProvider);
+
+    // Close the overlay when the window is not popped anymore
+    ref.listen(
+      dashbotWindowNotifierProvider.select((s) => s.isPopped),
+      (prev, next) {
+        if (prev == true && next == false) {
+          onClose();
+        }
+      },
+    );
+
+    void navigateTo(String route) {
+      final nav = _dashbotNavigatorKey.currentState;
+      if (nav == null) return;
+      Route? top;
+      nav.popUntil((r) {
+        top = r;
+        return true;
+      });
+      if (top?.settings.name == route) return;
+      if (route == DashbotRoutes.dashbotDefault) {
+        nav.popUntil((r) => r.isFirst);
+      } else {
+        nav.pushNamed(route);
+      }
+    }
+
+    ref.listen<String>(dashbotActiveRouteProvider, (prev, next) {
+      if (prev == next || next.isEmpty) return;
+      navigateTo(next);
+    });
+
+    return Stack(
+      children: [
+        if (!windowState.isHidden)
+          Positioned(
+            right: windowState.right,
+            bottom: windowState.bottom,
+            child: Material(
+              elevation: 8,
+              borderRadius: BorderRadius.circular(8),
+              child: Container(
+                width: windowState.width,
+                height: windowState.height,
+                decoration: BoxDecoration(
+                  color: Theme.of(context).colorScheme.surfaceContainerLow,
+                  borderRadius: BorderRadius.circular(8),
+                ),
+                child: Stack(
+                  children: [
+                    Column(
+                      children: [
+                        // This is to update position
+                        GestureDetector(
+                          onPanUpdate: (details) {
+                            windowNotifier.updatePosition(
+                              details.delta.dx,
+                              details.delta.dy,
+                              MediaQuery.of(context).size,
+                            );
+                          },
+                          child: Container(
+                            height: 50,
+                            decoration: BoxDecoration(
+                              color: Theme.of(context)
+                                  .colorScheme
+                                  .primaryContainer,
+                              borderRadius: const BorderRadius.vertical(
+                                top: Radius.circular(10),
+                              ),
+                            ),
+                            child: Row(
+                              mainAxisAlignment: MainAxisAlignment.spaceBetween,
+                              children: [
+                                Row(
+                                  children: [
+                                    kHSpacer20,
+                                    DashbotIcons.getDashbotIcon1(width: 38),
+                                    kHSpacer12,
+                                    Text(
+                                      'DashBot',
+                                      style: TextStyle(
+                                        fontSize: 16,
+                                        fontWeight: FontWeight.bold,
+                                        color: Theme.of(context)
+                                            .colorScheme
+                                            .surface,
+                                      ),
+                                    ),
+                                    kHSpacer4,
+                                    AIModelSelectorButton(
+                                      aiRequestModel: AIRequestModel.fromJson(
+                                          settings.defaultAIModel ?? {}),
+                                      useRootNavigator: true,
+                                      onDialogOpen: () => ref
+                                          .read(dashbotWindowNotifierProvider
+                                              .notifier)
+                                          .hide(),
+                                      onDialogClose: () => ref
+                                          .read(dashbotWindowNotifierProvider
+                                              .notifier)
+                                          .show(),
+                                      onModelUpdated: (d) {
+                                        ref
+                                            .read(settingsProvider.notifier)
+                                            .update(
+                                                defaultAIModel: d.copyWith(
+                                                    modelConfigs: [],
+                                                    stream: null,
+                                                    systemPrompt: '',
+                                                    userPrompt: '').toJson());
+                                      },
+                                    ),
+                                  ],
+                                ),
+                                Spacer(),
+                                IconButton(
+                                  icon: Icon(
+                                    Icons.open_in_new,
+                                    color:
+                                        Theme.of(context).colorScheme.onPrimary,
+                                  ),
+                                  onPressed: () {
+                                    ref
+                                        .read(dashbotWindowNotifierProvider
+                                            .notifier)
+                                        .togglePopped();
+                                  },
+                                ),
+                                IconButton(
+                                  icon: Icon(
+                                    Icons.close,
+                                    color:
+                                        Theme.of(context).colorScheme.onPrimary,
+                                  ),
+                                  onPressed: onClose,
+                                ),
+                              ],
+                            ),
+                          ),
+                        ),
+                        Expanded(
+                          child: Navigator(
+                            key: _dashbotNavigatorKey,
+                            initialRoute: activeRoute,
+                            onGenerateRoute: generateRoute,
+                          ),
+                        ),
+                      ],
+                    ),
+                    // This is to update size
+                    Positioned(
+                      left: 0,
+                      top: 0,
+                      child: GestureDetector(
+                        onPanUpdate: (details) {
+                          windowNotifier.updateSize(
+                            details.delta.dx,
+                            details.delta.dy,
+                            MediaQuery.of(context).size,
+                          );
+                        },
+                        child: MouseRegion(
+                          cursor: SystemMouseCursors.resizeUpLeft,
+                          child: Container(
+                            padding: EdgeInsets.only(top: 6, left: 1),
+                            width: 20,
+                            height: 20,
+                            decoration: BoxDecoration(
+                              borderRadius: const BorderRadius.only(
+                                topLeft: Radius.circular(8),
+                              ),
+                              color: Theme.of(context)
+                                  .colorScheme
+                                  .primaryContainer
+                                  .withValues(alpha: 0.7),
+                            ),
+                            child: Icon(
+                              Icons.drag_indicator_rounded,
+                              size: 16,
+                              color:
+                                  Theme.of(context).colorScheme.surfaceBright,
+                            ),
+                          ),
+                        ),
+                      ),
+                    ),
+                  ],
+                ),
+              ),
+            ),
+          ),
+      ],
+    );
+  }
+}