From 28b825b5f7ab440ed3e111ba59eabdc139076c37 Mon Sep 17 00:00:00 2001
From: Lucas Oliveira <lucas.edu.oli@hotmail.com>
Date: Thu, 12 Mar 2026 11:36:33 -0300
Subject: [PATCH 01/13] updated env example to contain flow ids

---
 frontend/.env.test.example | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/frontend/.env.test.example b/frontend/.env.test.example
index f53600840..aaeb9a02d 100644
--- a/frontend/.env.test.example
+++ b/frontend/.env.test.example
@@ -2,6 +2,12 @@
 DISABLE_INGEST_WITH_LANGFLOW=false
 INGEST_SAMPLE_DATA=true
 
+# Langflow Configuration
+LANGFLOW_CHAT_FLOW_ID='1098eea1-6649-4e1d-aed1-b77249fb8dd0'
+LANGFLOW_INGEST_FLOW_ID='5488df7c-b93f-4f87-a446-b67028bc0813'
+LANGFLOW_URL_INGEST_FLOW_ID='72c3d17c-2dac-4a73-b48a-6518473d7830'
+NUDGES_FLOW_ID='ebc01d31-1976-46ce-a385-b0240327226c'
+
 # Auth
 OPENSEARCH_PASSWORD=
 

From ddeb8cba15bbd1aae0d31a6d149d46b3fa5e2f00 Mon Sep 17 00:00:00 2001
From: Lucas Oliveira <lucas.edu.oli@hotmail.com>
Date: Thu, 12 Mar 2026 11:36:50 -0300
Subject: [PATCH 02/13] added data test ids into onboarding components

---
 frontend/app/chat/_components/chat-input.tsx  |  2 +
 frontend/app/chat/_components/nudges.tsx      |  1 +
 .../_components/selected-knowledge-filter.tsx |  1 +
 .../app/chat/_components/user-message.tsx     |  1 +
 .../app/onboarding/_components/advanced.tsx   |  6 ++-
 .../_components/anthropic-onboarding.tsx      |  1 +
 .../onboarding/_components/ibm-onboarding.tsx |  1 +
 .../onboarding/_components/model-selector.tsx | 43 ++++++++++++-------
 .../_components/ollama-onboarding.tsx         |  2 +
 .../_components/onboarding-card.tsx           | 11 ++++-
 .../_components/onboarding-upload.tsx         |  1 +
 .../_components/openai-onboarding.tsx         |  1 +
 .../onboarding/_components/progress-bar.tsx   |  2 +
 frontend/components/label-input.tsx           |  2 +-
 frontend/components/navigation.tsx            |  2 +
 15 files changed, 57 insertions(+), 20 deletions(-)

diff --git a/frontend/app/chat/_components/chat-input.tsx b/frontend/app/chat/_components/chat-input.tsx
index a52678186..4ca46a1c8 100644
--- a/frontend/app/chat/_components/chat-input.tsx
+++ b/frontend/app/chat/_components/chat-input.tsx
@@ -446,6 +446,7 @@ export const ChatInput = forwardRef<ChatInputHandle, ChatInputProps>(
                     autoComplete="off"
                     minRows={1}
                     placeholder="Ask a question..."
+                    data-testid="chat-input"
                     disabled={loading}
                     className={`w-full text-sm bg-transparent focus-visible:outline-none resize-none`}
                     rows={1}
@@ -499,6 +500,7 @@ export const ChatInput = forwardRef<ChatInputHandle, ChatInputProps>(
                     size="iconSm"
                     disabled={(!input.trim() && !uploadedFile) || loading}
                     className="!rounded-md h-8 w-8 p-0"
+                    data-testid="send-button"
                   >
                     {loading ? (
                       <Loader2 className="h-4 w-4 animate-spin" />
diff --git a/frontend/app/chat/_components/nudges.tsx b/frontend/app/chat/_components/nudges.tsx
index 3528e47db..5651edbdc 100644
--- a/frontend/app/chat/_components/nudges.tsx
+++ b/frontend/app/chat/_components/nudges.tsx
@@ -29,6 +29,7 @@ export default function Nudges({
                   {nudges.map((suggestion: string, index: number) => (
                     <button
                       key={index}
+                      data-testid={`suggestion-${index}`}
                       onClick={() => handleSuggestionClick(suggestion)}
                       className={cn(
                         onboarding
diff --git a/frontend/app/chat/_components/selected-knowledge-filter.tsx b/frontend/app/chat/_components/selected-knowledge-filter.tsx
index c2365cbe0..751d299a8 100644
--- a/frontend/app/chat/_components/selected-knowledge-filter.tsx
+++ b/frontend/app/chat/_components/selected-knowledge-filter.tsx
@@ -19,6 +19,7 @@ export const SelectedKnowledgeFilter = ({
       className={`inline-flex items-center p-1 rounded-sm text-xs font-medium transition-colors ${
         filterAccentClasses[parsedFilterData?.color || "zinc"]
       }`}
+      data-testid={`selected-knowledge-filter`}
     >
       {selectedFilter.name}
       <button
diff --git a/frontend/app/chat/_components/user-message.tsx b/frontend/app/chat/_components/user-message.tsx
index f8c1c87eb..f4e218679 100644
--- a/frontend/app/chat/_components/user-message.tsx
+++ b/frontend/app/chat/_components/user-message.tsx
@@ -65,6 +65,7 @@ export function UserMessage({
             "text-foreground text-sm py-1.5 whitespace-pre-wrap break-words overflow-wrap-anywhere transition-colors duration-300",
             isCompleted ? "text-placeholder-foreground" : "text-foreground",
           )}
+          data-testid="user-message"
         >
           {content}
         </p>
diff --git a/frontend/app/onboarding/_components/advanced.tsx b/frontend/app/onboarding/_components/advanced.tsx
index 39bab81e5..b6ce2fe11 100644
--- a/frontend/app/onboarding/_components/advanced.tsx
+++ b/frontend/app/onboarding/_components/advanced.tsx
@@ -36,7 +36,9 @@ export function AdvancedOnboarding({
   return (
     <Accordion type="single" collapsible>
       <AccordionItem value="item-1">
-        <AccordionTrigger>Advanced settings</AccordionTrigger>
+        <AccordionTrigger data-testid="advanced-settings-button">
+          Advanced settings
+        </AccordionTrigger>
         <AccordionContent className="space-y-6">
           {hasEmbeddingModels && (
             <LabelWrapper
@@ -47,6 +49,7 @@ export function AdvancedOnboarding({
             >
               <ModelSelector
                 options={embeddingModels}
+                data-testid="embedding-model-selector"
                 icon={icon}
                 value={embeddingModel}
                 onValueChange={setEmbeddingModel}
@@ -62,6 +65,7 @@ export function AdvancedOnboarding({
             >
               <ModelSelector
                 options={languageModels}
+                data-testid="language-model-selector"
                 icon={icon}
                 value={languageModel}
                 onValueChange={setLanguageModel}
diff --git a/frontend/app/onboarding/_components/anthropic-onboarding.tsx b/frontend/app/onboarding/_components/anthropic-onboarding.tsx
index 6d917c134..30af56752 100644
--- a/frontend/app/onboarding/_components/anthropic-onboarding.tsx
+++ b/frontend/app/onboarding/_components/anthropic-onboarding.tsx
@@ -93,6 +93,7 @@ export function AnthropicOnboarding({
               <div>
                 <Switch
                   checked={getFromEnv}
+                  data-testid="get-from-env-switch"
                   onCheckedChange={handleGetFromEnvChange}
                   disabled={!hasEnvApiKey}
                 />
diff --git a/frontend/app/onboarding/_components/ibm-onboarding.tsx b/frontend/app/onboarding/_components/ibm-onboarding.tsx
index 2c81f9c9a..cd28e4070 100644
--- a/frontend/app/onboarding/_components/ibm-onboarding.tsx
+++ b/frontend/app/onboarding/_components/ibm-onboarding.tsx
@@ -200,6 +200,7 @@ export function IBMOnboarding({
               <div>
                 <Switch
                   checked={getFromEnv}
+                  data-testid="get-from-env-switch"
                   onCheckedChange={handleGetFromEnvChange}
                   disabled={!hasEnvApiKey || alreadyConfigured}
                 />
diff --git a/frontend/app/onboarding/_components/model-selector.tsx b/frontend/app/onboarding/_components/model-selector.tsx
index 498bcca69..f3c9e8781 100644
--- a/frontend/app/onboarding/_components/model-selector.tsx
+++ b/frontend/app/onboarding/_components/model-selector.tsx
@@ -1,7 +1,7 @@
 import { CheckIcon, ChevronsUpDownIcon } from "lucide-react";
 import { useEffect, useState } from "react";
 import { Badge } from "@/components/ui/badge";
-import { Button } from "@/components/ui/button";
+import { Button, type ButtonProps } from "@/components/ui/button";
 import {
   Command,
   CommandEmpty,
@@ -30,6 +30,20 @@ export type GroupedModelOption = {
   icon?: React.ReactNode;
 };
 
+export interface ModelSelectorProps extends ButtonProps {
+  options?: ModelOption[];
+  groupedOptions?: GroupedModelOption[];
+  value: string;
+  icon?: React.ReactNode;
+  placeholder?: string;
+  searchPlaceholder?: string;
+  noOptionsPlaceholder?: string;
+  custom?: boolean;
+  onValueChange: (value: string, provider?: string) => void;
+  hasError?: boolean;
+  defaultOpen?: boolean;
+}
+
 export function ModelSelector({
   options,
   groupedOptions,
@@ -42,19 +56,11 @@ export function ModelSelector({
   custom = false,
   hasError = false,
   defaultOpen = false,
-}: {
-  options?: ModelOption[];
-  groupedOptions?: GroupedModelOption[];
-  value: string;
-  icon?: React.ReactNode;
-  placeholder?: string;
-  searchPlaceholder?: string;
-  noOptionsPlaceholder?: string;
-  custom?: boolean;
-  onValueChange: (value: string, provider?: string) => void;
-  hasError?: boolean;
-  defaultOpen?: boolean;
-}) {
+  className,
+  disabled,
+  variant = "outline",
+  ...props
+}: ModelSelectorProps) {
   const [open, setOpen] = useState(defaultOpen);
   const [searchValue, setSearchValue] = useState("");
 
@@ -90,14 +96,16 @@ export function ModelSelector({
     <Popover open={open} onOpenChange={setOpen} modal={false}>
       <PopoverTrigger asChild>
         <Button
-          variant="outline"
+          variant={variant}
           role="combobox"
-          disabled={allOptions.length === 0}
+          disabled={disabled || allOptions.length === 0}
           aria-expanded={open}
           className={cn(
             "w-full gap-2 justify-between font-normal text-sm",
             hasError && "!border-destructive",
+            className,
           )}
+          {...props}
         >
           {value ? (
             <div className="flex items-center gap-2">
@@ -161,6 +169,7 @@ export function ModelSelector({
                       <CommandItem
                         key={option.value}
                         value={option.value}
+                        data-testid={`model-option-${option.value}`}
                         onSelect={(currentValue) => {
                           if (currentValue !== value) {
                             onValueChange(currentValue, option.provider);
@@ -190,6 +199,7 @@ export function ModelSelector({
                   <CommandItem
                     key={option.value}
                     value={option.value}
+                    data-testid={`model-option-${option.value}`}
                     onSelect={(currentValue) => {
                       if (currentValue !== value) {
                         onValueChange(currentValue, option.provider);
@@ -215,6 +225,7 @@ export function ModelSelector({
                   ) && (
                     <CommandItem
                       value={searchValue}
+                      data-testid={`model-custom-option-${searchValue}`}
                       onSelect={(currentValue) => {
                         if (currentValue !== value) {
                           onValueChange(currentValue);
diff --git a/frontend/app/onboarding/_components/ollama-onboarding.tsx b/frontend/app/onboarding/_components/ollama-onboarding.tsx
index b9de3225e..d2f55f472 100644
--- a/frontend/app/onboarding/_components/ollama-onboarding.tsx
+++ b/frontend/app/onboarding/_components/ollama-onboarding.tsx
@@ -140,6 +140,7 @@ export function OllamaOnboarding({
         >
           <ModelSelector
             options={embeddingModels}
+            data-testid="embedding-model-selector"
             icon={<OllamaLogo className="w-4 h-4" />}
             noOptionsPlaceholder={
               isLoadingModels
@@ -160,6 +161,7 @@ export function OllamaOnboarding({
         >
           <ModelSelector
             options={languageModels}
+            data-testid="language-model-selector"
             icon={<OllamaLogo className="w-4 h-4" />}
             noOptionsPlaceholder={
               isLoadingModels
diff --git a/frontend/app/onboarding/_components/onboarding-card.tsx b/frontend/app/onboarding/_components/onboarding-card.tsx
index 182f318f7..3df951afb 100644
--- a/frontend/app/onboarding/_components/onboarding-card.tsx
+++ b/frontend/app/onboarding/_components/onboarding-card.tsx
@@ -332,10 +332,12 @@ const OnboardingCard = ({
       return;
     }
 
-    const hasSuccessfulTasks = relevantTasks.length > 0 &&
+    const hasSuccessfulTasks =
+      relevantTasks.length > 0 &&
       (!activeTasks || (activeTasks.successful_files ?? 0) > 0);
 
-    const hasIngestionDisabledOrDone = !onboardingTaskId && currentStep === totalSteps - 1;
+    const hasIngestionDisabledOrDone =
+      !onboardingTaskId && currentStep === totalSteps - 1;
 
     // If at least one processed file, no failures, and we've started onboarding, complete it
     if (
@@ -470,6 +472,7 @@ const OnboardingCard = ({
                   {!isEmbedding && (
                     <TabsTrigger
                       value="anthropic"
+                      data-testid={`anthropic-llm-tab`}
                       className={cn(
                         error &&
                           modelProvider === "anthropic" &&
@@ -508,6 +511,7 @@ const OnboardingCard = ({
                         modelProvider === "openai" &&
                         "data-[state=active]:border-destructive",
                     )}
+                    data-testid={`openai-${isEmbedding ? "embedding" : "llm"}-tab`}
                   >
                     <TabTrigger
                       selected={modelProvider === "openai"}
@@ -533,6 +537,7 @@ const OnboardingCard = ({
                   </TabsTrigger>
                   <TabsTrigger
                     value="watsonx"
+                    data-testid={`watsonx-${isEmbedding ? "embedding" : "llm"}-tab`}
                     className={cn(
                       error &&
                         modelProvider === "watsonx" &&
@@ -565,6 +570,7 @@ const OnboardingCard = ({
                   </TabsTrigger>
                   <TabsTrigger
                     value="ollama"
+                    data-testid={`ollama-${isEmbedding ? "embedding" : "llm"}-tab`}
                     className={cn(
                       error &&
                         modelProvider === "ollama" &&
@@ -659,6 +665,7 @@ const OnboardingCard = ({
                   <div>
                     <Button
                       size="sm"
+                      data-testid="onboarding-complete-button"
                       onClick={handleComplete}
                       disabled={!isComplete || isLoadingModels}
                       loading={onboardingMutation.isPending}
diff --git a/frontend/app/onboarding/_components/onboarding-upload.tsx b/frontend/app/onboarding/_components/onboarding-upload.tsx
index 8b70381fa..812dc1be1 100644
--- a/frontend/app/onboarding/_components/onboarding-upload.tsx
+++ b/frontend/app/onboarding/_components/onboarding-upload.tsx
@@ -243,6 +243,7 @@ const OnboardingUpload = ({ onComplete }: OnboardingUploadProps) => {
           <Button
             size="sm"
             variant="outline"
+            data-testid="upload-button"
             onClick={handleUploadClick}
             disabled={isUploading}
           >
diff --git a/frontend/app/onboarding/_components/openai-onboarding.tsx b/frontend/app/onboarding/_components/openai-onboarding.tsx
index be3996901..abe71936f 100644
--- a/frontend/app/onboarding/_components/openai-onboarding.tsx
+++ b/frontend/app/onboarding/_components/openai-onboarding.tsx
@@ -103,6 +103,7 @@ export function OpenAIOnboarding({
                 <div>
                   <Switch
                     checked={getFromEnv}
+                    data-testid="get-from-env-switch"
                     onCheckedChange={handleGetFromEnvChange}
                     disabled={!hasEnvApiKey}
                   />
diff --git a/frontend/app/onboarding/_components/progress-bar.tsx b/frontend/app/onboarding/_components/progress-bar.tsx
index 618483ab3..8457d731d 100644
--- a/frontend/app/onboarding/_components/progress-bar.tsx
+++ b/frontend/app/onboarding/_components/progress-bar.tsx
@@ -21,6 +21,7 @@ export function ProgressBar({
         <div className="w-48 h-1 bg-background dark:bg-muted rounded-full overflow-hidden">
           <div
             className="h-full transition-all duration-300 ease-in-out"
+            data-testid={`progress-bar-${currentStep}`}
             style={{
               width: `${progressPercentage}%`,
               background: "linear-gradient(to right, #773EFF, #22A7AF)",
@@ -35,6 +36,7 @@ export function ProgressBar({
         {currentStep > 1 && onSkip && (
           <Button
             variant="link"
+            data-testid="skip-overview-button"
             size="sm"
             onClick={onSkip}
             className="flex items-center gap-2 text-mmd !text-placeholder-foreground hover:!text-foreground hover:!no-underline"
diff --git a/frontend/components/label-input.tsx b/frontend/components/label-input.tsx
index 67eedb100..b1304b4e6 100644
--- a/frontend/components/label-input.tsx
+++ b/frontend/components/label-input.tsx
@@ -21,7 +21,7 @@ export function LabelInput({
       required={required}
       disabled={props.disabled}
     >
-      <Input id={id} {...props} />
+      <Input id={id} data-testid={id} {...props} />
     </LabelWrapper>
   );
 }
diff --git a/frontend/components/navigation.tsx b/frontend/components/navigation.tsx
index f25b7cfc0..4898cf689 100644
--- a/frontend/components/navigation.tsx
+++ b/frontend/components/navigation.tsx
@@ -363,6 +363,7 @@ export function Navigation({
               <button
                 type="button"
                 className="p-1 hover:bg-accent rounded"
+                data-testid="new-conversation-button"
                 onClick={handleNewConversation}
                 title="Start new conversation"
                 disabled={loading}
@@ -460,6 +461,7 @@ export function Navigation({
                       {conversations.map((conversation) => (
                         <button
                           key={conversation.response_id}
+                          data-testid={`conversation-button-${conversation.title}`}
                           type="button"
                           className={`w-full px-3 h-11 rounded-lg group relative text-left ${
                             loading || isConversationsLoading

From e3d2dfc20eb9f562dd7bbc2be2e168b1b20053e8 Mon Sep 17 00:00:00 2001
From: Lucas Oliveira <lucas.edu.oli@hotmail.com>
Date: Thu, 12 Mar 2026 11:37:00 -0300
Subject: [PATCH 03/13] added required asset

---
 frontend/tests/assets/test-document.txt | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 frontend/tests/assets/test-document.txt

diff --git a/frontend/tests/assets/test-document.txt b/frontend/tests/assets/test-document.txt
new file mode 100644
index 000000000..b40992e69
--- /dev/null
+++ b/frontend/tests/assets/test-document.txt
@@ -0,0 +1,15 @@
+OpenRAG Project Overview
+
+OpenRAG is a platform designed to simplify the creation of agentic RAG systems.
+It integrates seamlessly with various LLM providers and vector databases to provide a robust knowledge base for AI agents.
+
+Key features include:
+- Intelligent Document Ingestion: Support for multiple file formats including PDF, TXT, and Markdown.
+- Vector Storage: Optimized retrieval using state-of-the-art vector similarity search.
+- Agentic Workflows: Complex orchestration of tasks using advanced AI reasoning.
+- Extensible Architecture: Easily add new components and integrations.
+
+Keywords: AgenticRAG, VectorDB, Embedding, LLM-Orchestration, SemanticSearch.
+
+This document serves as a verification asset for automated testing procedures.
+ID: OPENRAG-GENERIC-ASSET-001

From 15a2ce2db6babed0186ae103f4ec0e4d6b33f496 Mon Sep 17 00:00:00 2001
From: Lucas Oliveira <lucas.edu.oli@hotmail.com>
Date: Thu, 12 Mar 2026 11:37:12 -0300
Subject: [PATCH 04/13] updated package lock

---
 frontend/package-lock.json | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/frontend/package-lock.json b/frontend/package-lock.json
index 84b980daf..3da4e2013 100644
--- a/frontend/package-lock.json
+++ b/frontend/package-lock.json
@@ -1497,6 +1497,7 @@
       "integrity": "sha512-6TyEnHgd6SArQO8UO2OMTxshln3QMWBtPGrOCgs3wVEmQmwyuNtB10IZMfmYDE0riwNR1cu4q+pPcxMVtaG3TA==",
       "devOptional": true,
       "license": "Apache-2.0",
+      "peer": true,
       "dependencies": {
         "playwright": "1.57.0"
       },
@@ -2776,6 +2777,7 @@
       "integrity": "sha512-yCAeZl7a0DxgNVteXFHt9+uyFbqXGy/ShC4BlcHkoE0AfGXYv/BUiplV72DjMYXHDBXFjhvr6DD1NiRVfB4j8g==",
       "dev": true,
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "undici-types": "~6.21.0"
       }
@@ -2791,6 +2793,7 @@
       "resolved": "https://registry.npmjs.org/@types/react/-/react-19.1.12.tgz",
       "integrity": "sha512-cMoR+FoAf/Jyq6+Df2/Z41jISvGZZ2eTlnsaJRptmZ76Caldwy1odD4xTr/gNV9VLj0AWgg/nmkevIyUfIIq5w==",
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "csstype": "^3.0.2"
       }
@@ -2801,6 +2804,7 @@
       "integrity": "sha512-qXRuZaOsAdXKFyOhRBg6Lqqc0yay13vN7KrIg4L7N4aaHN68ma9OK3NE1BoDFgFOTfM7zg+3/8+2n8rLUH3OKQ==",
       "devOptional": true,
       "license": "MIT",
+      "peer": true,
       "peerDependencies": {
         "@types/react": "^19.0.0"
       }
@@ -2865,6 +2869,7 @@
       "integrity": "sha512-klQbnPAAiGYFyI02+znpBRLyjL4/BrBd0nyWkdC0s/6xFLkXYQ8OoRrSkqacS1ddVxf/LDyODIKbQ5TgKAf/Fg==",
       "dev": true,
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "@typescript-eslint/scope-manager": "8.56.1",
         "@typescript-eslint/types": "8.56.1",
@@ -3489,6 +3494,7 @@
       "integrity": "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw==",
       "dev": true,
       "license": "MIT",
+      "peer": true,
       "bin": {
         "acorn": "bin/acorn"
       },
@@ -3976,6 +3982,7 @@
         }
       ],
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "caniuse-lite": "^1.0.30001737",
         "electron-to-chromium": "^1.5.211",
@@ -4857,6 +4864,7 @@
       "integrity": "sha512-VmQ+sifHUbI/IcSopBCF/HO3YiHQx/AVd3UVyYL6weuwW+HvON9VYn5l6Zl1WZzPWXPNZrSQpxwkkZ/VuvJZzg==",
       "dev": true,
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "@eslint-community/eslint-utils": "^4.8.0",
         "@eslint-community/regexpp": "^4.12.1",
@@ -5030,6 +5038,7 @@
       "integrity": "sha512-whOE1HFo/qJDyX4SnXzP4N6zOWn79WhnCUY/iDR0mPfQZO8wcYE4JClzI2oZrhBnnMUCBCHZhO6VQyoBU95mZA==",
       "dev": true,
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "@rtsao/scc": "^1.1.0",
         "array-includes": "^3.1.9",
@@ -6825,6 +6834,7 @@
       "resolved": "https://registry.npmjs.org/jiti/-/jiti-1.21.7.tgz",
       "integrity": "sha512-/imKNG4EbWNrVjoNC/1H5/9GFy+tqjGBHCaSsN+P2RnPqjsLmv6UD3Ej+Kj8nBWaRAwyk7kK5ZUc+OEatnTR3A==",
       "license": "MIT",
+      "peer": true,
       "bin": {
         "jiti": "bin/jiti.js"
       }
@@ -9055,6 +9065,7 @@
         }
       ],
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "nanoid": "^3.3.11",
         "picocolors": "^1.1.1",
@@ -9231,6 +9242,7 @@
       "resolved": "https://registry.npmjs.org/react/-/react-19.1.1.tgz",
       "integrity": "sha512-w8nqGImo45dmMIfljjMwOGtbmC/mk4CMYhWIicdSflH91J9TyCyczcPFXJzrZ/ZXcgGRFeP6BU0BEJTw6tZdfQ==",
       "license": "MIT",
+      "peer": true,
       "engines": {
         "node": ">=0.10.0"
       }
@@ -9240,6 +9252,7 @@
       "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.1.1.tgz",
       "integrity": "sha512-Dlq/5LAZgF0Gaz6yiqZCf6VCcZs1ghAJyrsu84Q/GT0gV+mCxbfmKNoGRKBYMJ8IEdGPqu49YWXD02GCknEDkw==",
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "scheduler": "^0.26.0"
       },
@@ -10488,6 +10501,7 @@
       "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-3.4.17.tgz",
       "integrity": "sha512-w33E2aCvSDP0tW9RZuNXadXlkHXqFzSkQew/aIa2i/Sj8fThxwovwlXHSPXTbAHwEIhBFXAedUhP2tueAKP8Og==",
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "@alloc/quick-lru": "^5.2.0",
         "arg": "^5.0.2",
@@ -10667,6 +10681,7 @@
       "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
       "dev": true,
       "license": "MIT",
+      "peer": true,
       "engines": {
         "node": ">=12"
       },
@@ -10840,6 +10855,7 @@
       "integrity": "sha512-CWBzXQrc/qOkhidw1OzBTQuYRbfyxDXJMVJ1XNwUHGROVmuaeiEm3OslpZ1RV96d7SKKjZKrSJu3+t/xlw3R9A==",
       "dev": true,
       "license": "Apache-2.0",
+      "peer": true,
       "bin": {
         "tsc": "bin/tsc",
         "tsserver": "bin/tsserver"

From 7c7a522d0d56a1ce4c694ba50bff37fc450b14b1 Mon Sep 17 00:00:00 2001
From: Lucas Oliveira <lucas.edu.oli@hotmail.com>
Date: Thu, 12 Mar 2026 11:37:21 -0300
Subject: [PATCH 05/13] added onboarding test

---
 frontend/tests/core/onboarding.spec.ts | 183 ++++++++++++++++++++++++-
 1 file changed, 178 insertions(+), 5 deletions(-)

diff --git a/frontend/tests/core/onboarding.spec.ts b/frontend/tests/core/onboarding.spec.ts
index 28e663a7b..0f04168bb 100644
--- a/frontend/tests/core/onboarding.spec.ts
+++ b/frontend/tests/core/onboarding.spec.ts
@@ -1,14 +1,187 @@
 import { expect, test } from "@playwright/test";
+import path from "path";
+
+test("can configure OpenAI provider", async ({ page }) => {
+  const apiKey = process.env.OPENAI_API_KEY;
+
+  if (!apiKey) {
+    throw new Error("OPENAI_API_KEY is not set");
+  }
 
-test("has onboarding content", async ({ page }) => {
   // Go to the base URL (frontend)
   await page.goto("/");
 
-  // Expect a title "to contain" a substring.
-  await expect(page).toHaveTitle(/OpenRAG/);
+  try {
+    // Expect the onboarding content to be visible using the test id.
+    await expect(page.getByTestId("onboarding-content")).toBeVisible({
+      timeout: 15000,
+    });
+  } catch (error) {
+    console.log("Refreshing page...");
+    await page.reload();
+    await expect(page.getByTestId("onboarding-content")).toBeVisible({
+      timeout: 15000,
+    });
+  }
+
+  await expect(
+    page.getByText("Let's get started by setting up your LLM provider."),
+  ).toBeVisible();
+
+  await expect(page.getByTestId("openai-llm-tab")).toBeVisible();
+  await expect(page.getByTestId("anthropic-llm-tab")).toBeVisible();
+  await expect(page.getByTestId("watsonx-llm-tab")).toBeVisible();
+  await expect(page.getByTestId("ollama-llm-tab")).toBeVisible();
+
+  // LLM configuration
+
+  await page.getByTestId("openai-llm-tab").click();
+
+  await expect(page.getByTestId("openai-llm-tab")).toHaveAttribute(
+    "aria-selected",
+    "true",
+  );
+
+  await expect(page.getByTestId("get-from-env-switch")).toBeVisible();
+
+  await expect(page.getByTestId("get-from-env-switch")).toBeChecked();
+
+  await page.getByTestId("get-from-env-switch").click();
+
+  await expect(page.getByTestId("get-from-env-switch")).not.toBeChecked();
+
+  await page.getByTestId("api-key").fill(apiKey);
+
+  await page.getByTestId("advanced-settings-button").click();
+
+  await expect(page.getByTestId("language-model-selector")).toBeEnabled();
+
+  await page.getByTestId("language-model-selector").click();
+
+  const modelOptionsCount = await page.getByTestId(/^model-option-/).count();
+  expect(modelOptionsCount).toBeGreaterThan(0);
+
+  await page
+    .getByTestId(/^model-option-/)
+    .first()
+    .click();
+
+  await page.getByTestId("onboarding-complete-button").click();
+
+  await expect(page.getByText("Thinking")).toBeVisible();
+
+  await expect(page.getByText("Done")).toBeVisible({ timeout: 60000 });
+
+  // Embeddings configuration
+
+  await expect(
+    page.getByText("Now, let's set up your embedding provider."),
+  ).toBeVisible();
+
+  await expect(page.getByTestId("openai-embedding-tab")).toBeVisible();
+  await expect(page.getByTestId("anthropic-embedding-tab")).not.toBeVisible();
+  await expect(page.getByTestId("watsonx-embedding-tab")).toBeVisible();
+  await expect(page.getByTestId("ollama-embedding-tab")).toBeVisible();
+
+  await page.getByTestId("openai-embedding-tab").click();
+
+  await expect(page.getByTestId("openai-embedding-tab")).toHaveAttribute(
+    "aria-selected",
+    "true",
+  );
+
+  await expect(
+    page.getByText(
+      "Existing OpenAI key detected. You can reuse it or enter a new one.",
+    ),
+  ).toBeVisible();
+
+  await page.getByTestId("advanced-settings-button").click();
+
+  await expect(page.getByTestId("embedding-model-selector")).toBeEnabled();
+
+  await page.getByTestId("embedding-model-selector").click();
 
-  // Expect the onboarding content to be visible using the test id.
-  await expect(page.getByTestId("onboarding-content")).toBeVisible({
+  const embeddingModelOptionsCount = await page
+    .getByTestId(/^model-option-/)
+    .count();
+  expect(embeddingModelOptionsCount).toBeGreaterThan(0);
+
+  await page
+    .getByTestId(/^model-option-/)
+    .first()
+    .click();
+
+  await page.getByTestId("onboarding-complete-button").click();
+
+  await expect(page.getByText("Thinking")).toBeVisible();
+
+  await expect(page.getByText("Done")).toBeVisible({ timeout: 120000 });
+
+  // What is OpenRAG
+
+  await expect(
+    page.getByText("Excellent, let's move on to learning the basics."),
+  ).toBeVisible();
+
+  await expect(page.getByTestId("suggestion-0")).toBeVisible();
+
+  await expect(page.getByTestId("suggestion-0")).toHaveText("What is OpenRAG?");
+
+  await page.getByTestId("suggestion-0").click();
+
+  await expect(page.getByTestId("user-message").first()).toHaveText(
+    "What is OpenRAG?",
+  );
+
+  await expect(page.getByText("Thinking")).toBeVisible();
+
+  await expect(page.getByText("OpenRAG is an open-source package")).toBeVisible(
+    { timeout: 60000 },
+  );
+
+  // Add your document
+
+  await expect(page.getByText("Lastly, let's add your data.")).toBeVisible();
+
+  await expect(page.getByTestId("upload-button")).toBeVisible();
+
+  const fileChooserPromise = page.waitForEvent("filechooser");
+  await page.getByTestId("upload-button").click();
+  const fileChooser = await fileChooserPromise;
+  await fileChooser.setFiles(
+    path.join(__dirname, "../assets", "test-document.txt"),
+  );
+
+  await expect(page.getByText("Done")).toBeVisible({ timeout: 60000 });
+
+  await expect(page.getByTestId("onboarding-content")).toBeHidden();
+
+  // Chat page
+
+  await expect(page.getByText("How can I assist?")).toBeVisible({
     timeout: 30000,
   });
+
+  await expect(
+    page.getByTestId("conversation-button-What is OpenRAG?"),
+  ).toBeVisible();
+
+  await expect(page.getByTestId(/^suggestion-/)).toHaveCount(3);
+
+  await expect(page.getByTestId("selected-knowledge-filter")).toContainText(
+    "test-document",
+  );
+
+  await page
+    .getByTestId("chat-input")
+    .fill("What is the ID of verification of the document?");
+
+  await page.getByTestId("send-button").click();
+
+  await expect(page.getByText("Thinking")).toBeVisible();
+
+  await expect(page.getByText("OPENRAG-GENERIC-ASSET-001")).toBeVisible({
+    timeout: 60000,
+  });
 });

From 046cad8bbb13b51d5a2f9f07e7980a2b9bacd36b Mon Sep 17 00:00:00 2001
From: Lucas Oliveira <lucas.edu.oli@hotmail.com>
Date: Thu, 12 Mar 2026 12:17:26 -0300
Subject: [PATCH 06/13] componentized onboarding

---
 frontend/tests/core/onboarding.spec.ts | 160 +------------------------
 frontend/tests/utils/onboarding.ts     | 153 +++++++++++++++++++++++
 2 files changed, 158 insertions(+), 155 deletions(-)
 create mode 100644 frontend/tests/utils/onboarding.ts

diff --git a/frontend/tests/core/onboarding.spec.ts b/frontend/tests/core/onboarding.spec.ts
index 0f04168bb..b02602831 100644
--- a/frontend/tests/core/onboarding.spec.ts
+++ b/frontend/tests/core/onboarding.spec.ts
@@ -1,161 +1,11 @@
 import { expect, test } from "@playwright/test";
-import path from "path";
+import { completeOnboarding } from "../utils/onboarding";
 
 test("can configure OpenAI provider", async ({ page }) => {
-  const apiKey = process.env.OPENAI_API_KEY;
-
-  if (!apiKey) {
-    throw new Error("OPENAI_API_KEY is not set");
-  }
-
-  // Go to the base URL (frontend)
-  await page.goto("/");
-
-  try {
-    // Expect the onboarding content to be visible using the test id.
-    await expect(page.getByTestId("onboarding-content")).toBeVisible({
-      timeout: 15000,
-    });
-  } catch (error) {
-    console.log("Refreshing page...");
-    await page.reload();
-    await expect(page.getByTestId("onboarding-content")).toBeVisible({
-      timeout: 15000,
-    });
-  }
-
-  await expect(
-    page.getByText("Let's get started by setting up your LLM provider."),
-  ).toBeVisible();
-
-  await expect(page.getByTestId("openai-llm-tab")).toBeVisible();
-  await expect(page.getByTestId("anthropic-llm-tab")).toBeVisible();
-  await expect(page.getByTestId("watsonx-llm-tab")).toBeVisible();
-  await expect(page.getByTestId("ollama-llm-tab")).toBeVisible();
-
-  // LLM configuration
-
-  await page.getByTestId("openai-llm-tab").click();
-
-  await expect(page.getByTestId("openai-llm-tab")).toHaveAttribute(
-    "aria-selected",
-    "true",
-  );
-
-  await expect(page.getByTestId("get-from-env-switch")).toBeVisible();
-
-  await expect(page.getByTestId("get-from-env-switch")).toBeChecked();
-
-  await page.getByTestId("get-from-env-switch").click();
-
-  await expect(page.getByTestId("get-from-env-switch")).not.toBeChecked();
-
-  await page.getByTestId("api-key").fill(apiKey);
-
-  await page.getByTestId("advanced-settings-button").click();
-
-  await expect(page.getByTestId("language-model-selector")).toBeEnabled();
-
-  await page.getByTestId("language-model-selector").click();
-
-  const modelOptionsCount = await page.getByTestId(/^model-option-/).count();
-  expect(modelOptionsCount).toBeGreaterThan(0);
-
-  await page
-    .getByTestId(/^model-option-/)
-    .first()
-    .click();
-
-  await page.getByTestId("onboarding-complete-button").click();
-
-  await expect(page.getByText("Thinking")).toBeVisible();
-
-  await expect(page.getByText("Done")).toBeVisible({ timeout: 60000 });
-
-  // Embeddings configuration
-
-  await expect(
-    page.getByText("Now, let's set up your embedding provider."),
-  ).toBeVisible();
-
-  await expect(page.getByTestId("openai-embedding-tab")).toBeVisible();
-  await expect(page.getByTestId("anthropic-embedding-tab")).not.toBeVisible();
-  await expect(page.getByTestId("watsonx-embedding-tab")).toBeVisible();
-  await expect(page.getByTestId("ollama-embedding-tab")).toBeVisible();
-
-  await page.getByTestId("openai-embedding-tab").click();
-
-  await expect(page.getByTestId("openai-embedding-tab")).toHaveAttribute(
-    "aria-selected",
-    "true",
-  );
-
-  await expect(
-    page.getByText(
-      "Existing OpenAI key detected. You can reuse it or enter a new one.",
-    ),
-  ).toBeVisible();
-
-  await page.getByTestId("advanced-settings-button").click();
-
-  await expect(page.getByTestId("embedding-model-selector")).toBeEnabled();
-
-  await page.getByTestId("embedding-model-selector").click();
-
-  const embeddingModelOptionsCount = await page
-    .getByTestId(/^model-option-/)
-    .count();
-  expect(embeddingModelOptionsCount).toBeGreaterThan(0);
-
-  await page
-    .getByTestId(/^model-option-/)
-    .first()
-    .click();
-
-  await page.getByTestId("onboarding-complete-button").click();
-
-  await expect(page.getByText("Thinking")).toBeVisible();
-
-  await expect(page.getByText("Done")).toBeVisible({ timeout: 120000 });
-
-  // What is OpenRAG
-
-  await expect(
-    page.getByText("Excellent, let's move on to learning the basics."),
-  ).toBeVisible();
-
-  await expect(page.getByTestId("suggestion-0")).toBeVisible();
-
-  await expect(page.getByTestId("suggestion-0")).toHaveText("What is OpenRAG?");
-
-  await page.getByTestId("suggestion-0").click();
-
-  await expect(page.getByTestId("user-message").first()).toHaveText(
-    "What is OpenRAG?",
-  );
-
-  await expect(page.getByText("Thinking")).toBeVisible();
-
-  await expect(page.getByText("OpenRAG is an open-source package")).toBeVisible(
-    { timeout: 60000 },
-  );
-
-  // Add your document
-
-  await expect(page.getByText("Lastly, let's add your data.")).toBeVisible();
-
-  await expect(page.getByTestId("upload-button")).toBeVisible();
-
-  const fileChooserPromise = page.waitForEvent("filechooser");
-  await page.getByTestId("upload-button").click();
-  const fileChooser = await fileChooserPromise;
-  await fileChooser.setFiles(
-    path.join(__dirname, "../assets", "test-document.txt"),
-  );
-
-  await expect(page.getByText("Done")).toBeVisible({ timeout: 60000 });
-
-  await expect(page.getByTestId("onboarding-content")).toBeHidden();
+  await completeOnboarding(page, {
+    llmProvider: "openai",
+    embeddingProvider: "openai",
+  });
 
   // Chat page
 
diff --git a/frontend/tests/utils/onboarding.ts b/frontend/tests/utils/onboarding.ts
new file mode 100644
index 000000000..fdd89d92d
--- /dev/null
+++ b/frontend/tests/utils/onboarding.ts
@@ -0,0 +1,153 @@
+import { expect, type Page } from "@playwright/test";
+import path from "path";
+
+export type LLMProvider = "openai" | "anthropic" | "watsonx" | "ollama";
+export type EmbeddingProvider = "openai" | "watsonx" | "ollama";
+
+export async function completeOnboarding(
+  page: Page,
+  {
+    llmProvider,
+    embeddingProvider,
+  }: {
+    llmProvider: LLMProvider;
+    embeddingProvider: EmbeddingProvider;
+  },
+) {
+  // Fast path checks for environment variables
+  const checkCredentials = (provider: string) => {
+    if (provider === "ollama") return;
+    const envVarName = `${provider.toUpperCase()}_API_KEY`;
+    if (!process.env[envVarName]) {
+      throw new Error(`${envVarName} is not set`);
+    }
+    if (provider === "watsonx" && !process.env.WATSONX_PROJECT_ID) {
+      throw new Error("WATSONX_PROJECT_ID is not set");
+    }
+  };
+
+  checkCredentials(llmProvider);
+  if ((embeddingProvider as string) === "anthropic") {
+    throw new Error("Anthropic is not a valid embedding provider");
+  }
+  checkCredentials(embeddingProvider);
+
+  // Go to the base URL (frontend)
+  await page.goto("/");
+
+  try {
+    // Expect the onboarding content to be visible using the test id.
+    await expect(page.getByTestId("onboarding-content")).toBeVisible({
+      timeout: 15000,
+    });
+  } catch (error) {
+    console.log("Refreshing page...");
+    await page.reload();
+    await expect(page.getByTestId("onboarding-content")).toBeVisible({
+      timeout: 15000,
+    });
+  }
+
+  const setupProvider = async (provider: string, isEmbedding: boolean) => {
+    const tabId = `${provider}-${isEmbedding ? "embedding" : "llm"}-tab`;
+    await page.getByTestId(tabId).click();
+
+    if (provider !== "ollama") {
+      const getFromEnvSwitch = page.getByTestId("get-from-env-switch");
+
+      // Check if switch is visible and toggle off to enter explicit key if needed
+      if (await getFromEnvSwitch.isVisible()) {
+        if (await getFromEnvSwitch.isChecked()) {
+          await getFromEnvSwitch.click();
+        }
+        await expect(getFromEnvSwitch).not.toBeChecked();
+      }
+
+      const apiKeyField = page.getByTestId("api-key");
+      // For embedding, the key might be automatically populated if it's the same provider
+      // but let's ensure it's filled.
+      if ((await apiKeyField.isVisible()) && (await apiKeyField.isEnabled())) {
+        const apiKey = process.env[`${provider.toUpperCase()}_API_KEY`];
+        await apiKeyField.fill(apiKey!);
+      }
+
+      if (provider === "watsonx") {
+        const projectIdField = page.getByTestId("project-id");
+        if (
+          (await projectIdField.isVisible()) &&
+          (await projectIdField.isEnabled())
+        ) {
+          const projectId = process.env.WATSONX_PROJECT_ID;
+          await projectIdField.fill(projectId!);
+        }
+      }
+    }
+
+    // Model selection
+    // Some providers might have models loaded immediately, some might take time
+    const advancedBtn = page.getByTestId("advanced-settings-button");
+    if (await advancedBtn.isVisible()) {
+      await advancedBtn.click();
+    }
+
+    const modelSelectorId = isEmbedding
+      ? "embedding-model-selector"
+      : "language-model-selector";
+    const selector = page.getByTestId(modelSelectorId);
+
+    // Wait for the selector to be enabled (models loaded)
+    await expect(selector).toBeEnabled({ timeout: 30000 });
+    await selector.click();
+
+    // Select the first available model
+    await expect(page.getByTestId(/^model-option-/).first()).toBeVisible();
+    await page
+      .getByTestId(/^model-option-/)
+      .first()
+      .click();
+
+    // Complete this step
+    await page.getByTestId("onboarding-complete-button").click();
+
+    await expect(page.getByText("Thinking")).toBeVisible();
+    await expect(page.getByText("Done")).toBeVisible({
+      timeout: isEmbedding ? 120000 : 60000,
+    });
+  };
+
+  // 1. LLM configuration
+  await setupProvider(llmProvider, false);
+
+  // 2. Embeddings configuration
+  await setupProvider(embeddingProvider, true);
+
+  // 3. What is OpenRAG (Tutorial)
+  await expect(
+    page.getByText("Excellent, let's move on to learning the basics."),
+  ).toBeVisible();
+
+  await expect(page.getByTestId("suggestion-0")).toBeVisible();
+  await page.getByTestId("suggestion-0").click();
+
+  await expect(page.getByTestId("user-message").first()).toHaveText(
+    "What is OpenRAG?",
+  );
+  await expect(page.getByText("Thinking")).toBeVisible();
+  await expect(page.getByText("OpenRAG is an open-source package")).toBeVisible(
+    { timeout: 60000 },
+  );
+
+  // 4. Add your document
+  await expect(page.getByText("Lastly, let's add your data.")).toBeVisible();
+  await expect(page.getByTestId("upload-button")).toBeVisible();
+
+  const fileChooserPromise = page.waitForEvent("filechooser");
+  await page.getByTestId("upload-button").click();
+  const fileChooser = await fileChooserPromise;
+  await fileChooser.setFiles(
+    path.join(__dirname, "../assets", "test-document.txt"),
+  );
+
+  await expect(page.getByText("Done")).toBeVisible({ timeout: 60000 });
+  await expect(page.getByTestId("onboarding-content")).toBeHidden();
+}

From d7fee10886781844ce0e853491a35c176d9712f4 Mon Sep 17 00:00:00 2001
From: Lucas Oliveira <lucas.edu.oli@hotmail.com>
Date: Thu, 12 Mar 2026 12:20:57 -0300
Subject: [PATCH 07/13] updated e2e test to get from secrets

---
 .github/workflows/test-e2e.yml | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/.github/workflows/test-e2e.yml b/.github/workflows/test-e2e.yml
index f73f89bb7..9302f9259 100644
--- a/.github/workflows/test-e2e.yml
+++ b/.github/workflows/test-e2e.yml
@@ -29,6 +29,16 @@ jobs:
       LANGFLOW_AUTO_LOGIN: "True"
       LANGFLOW_NEW_USER_IS_ACTIVE: "True"
       LANGFLOW_ENABLE_SUPERUSER_CLI: "True"
+      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+      ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+      WATSONX_API_KEY: ${{ secrets.WATSONX_API_KEY }}
+      WATSONX_ENDPOINT: ${{ secrets.WATSONX_ENDPOINT }}
+      WATSONX_PROJECT_ID: ${{ secrets.WATSONX_PROJECT_ID }}
+      OLLAMA_ENDPOINT: ${{ secrets.OLLAMA_ENDPOINT }}
+      GOOGLE_OAUTH_CLIENT_ID: ${{ secrets.GOOGLE_OAUTH_CLIENT_ID }}
+      GOOGLE_OAUTH_CLIENT_SECRET: ${{ secrets.GOOGLE_OAUTH_CLIENT_SECRET }}
+      AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
+      AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
 
     steps:
       - name: Cleanup Docker cache

From 7d283009e28ae7aa06273007ea6f4b02dba33f01 Mon Sep 17 00:00:00 2001
From: Lucas Oliveira <lucas.edu.oli@hotmail.com>
Date: Thu, 12 Mar 2026 12:26:33 -0300
Subject: [PATCH 08/13] fixed onboarding

---
 frontend/tests/utils/onboarding.ts | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/frontend/tests/utils/onboarding.ts b/frontend/tests/utils/onboarding.ts
index fdd89d92d..c86881126 100644
--- a/frontend/tests/utils/onboarding.ts
+++ b/frontend/tests/utils/onboarding.ts
@@ -133,9 +133,9 @@ export async function completeOnboarding(
     "What is OpenRAG?",
   );
   await expect(page.getByText("Thinking")).toBeVisible();
-  await expect(page.getByText("OpenRAG is an open-source package")).toBeVisible(
-    { timeout: 60000 },
-  );
+  await expect(page.getByText("is an open-source package")).toBeVisible({
+    timeout: 60000,
+  });
 
   // 4. Add your document
   await expect(page.getByText("Lastly, let's add your data.")).toBeVisible();

From 6232172d59d15177b336ca07b8701408a998dd70 Mon Sep 17 00:00:00 2001
From: Lucas Oliveira <lucas.edu.oli@hotmail.com>
Date: Fri, 13 Mar 2026 17:37:37 -0300
Subject: [PATCH 09/13] Fix for e2e tests not working on CI

---
 Makefile             |  8 +++++---
 scripts/setup-e2e.sh | 10 ++++++++++
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/Makefile b/Makefile
index ac37c4a9a..ab14d3f65 100644
--- a/Makefile
+++ b/Makefile
@@ -527,12 +527,14 @@ factory-reset: ## Complete reset (stop, remove volumes, clear data, remove image
 	fi; \
 	if [ -d "config" ]; then \
 		echo "Removing config..."; \
+		$(CONTAINER_RUNTIME) run --rm -v "$$(pwd)/config:/data" alpine sh -c "rm -rf /data/*" 2>/dev/null || true; \
 		rm -rf config; \
 		echo "$(PURPLE)config removed$(NC)"; \
 	fi; \
-	if [ -f "keys/private_key.pem" ] || [ -f "keys/public_key.pem" ]; then \
-		echo "Removing JWT keys..."; \
-		rm -f keys/private_key.pem keys/public_key.pem; \
+	if [ -d "keys" ]; then \
+		echo "Removing keys..."; \
+		$(CONTAINER_RUNTIME) run --rm -v "$$(pwd)/keys:/data" alpine sh -c "rm -rf /data/*" 2>/dev/null || true; \
+		rm -rf keys; \
 		echo "$(PURPLE)JWT keys removed$(NC)"; \
 	fi; \
 	echo "$(YELLOW)Removing OpenRAG images...$(NC)"; \
diff --git a/scripts/setup-e2e.sh b/scripts/setup-e2e.sh
index 92e182588..3f92725fb 100755
--- a/scripts/setup-e2e.sh
+++ b/scripts/setup-e2e.sh
@@ -49,10 +49,20 @@ echo "Starting E2E Setup using $E2E_ENV..."
 echo "Cleaning up..."
 make factory-reset FORCE=true ENV_FILE=$E2E_ENV
 
+# Ensure directories exist before starting containers so they are owned by the current user
+mkdir -p config data keys opensearch-data openrag-documents
+
 # Start infrastructure using make (this will use the new .env)
 echo "Starting infrastructure..."
 make dev-local-cpu ENV_FILE=$E2E_ENV
 
+# On Linux/CI, Docker volumes are root-owned. Fix them so the host runner can write to them.
+if [ "$CI" = "true" ] && [[ "$OSTYPE" != "darwin"* ]]; then
+    echo "Fixing volume permissions for CI..."
+    ${CONTAINER_RUNTIME} run --rm -v "$(pwd):/work" alpine sh -c "chown -R $(id -u):$(id -g) /work/config /work/data /work/keys /work/opensearch-data /work/openrag-documents || true"
+    chmod -R 777 config data keys opensearch-data openrag-documents 2>/dev/null || true
+fi
+
 echo "Waiting for OpenSearch..."
 TIMEOUT=300
 ELAPSED=0

From 4a947c94257d81830331f37dcb77a095cec3ee28 Mon Sep 17 00:00:00 2001
From: Lucas Oliveira <lucas.edu.oli@hotmail.com>
Date: Fri, 13 Mar 2026 19:45:11 -0300
Subject: [PATCH 10/13] make script not generate opensearch password

---
 .github/workflows/test-e2e.yml |  2 ++
 scripts/setup-e2e.sh           | 27 +++++++++++++++------------
 2 files changed, 17 insertions(+), 12 deletions(-)

diff --git a/.github/workflows/test-e2e.yml b/.github/workflows/test-e2e.yml
index 9302f9259..a25a75b5f 100644
--- a/.github/workflows/test-e2e.yml
+++ b/.github/workflows/test-e2e.yml
@@ -39,6 +39,7 @@ jobs:
       GOOGLE_OAUTH_CLIENT_SECRET: ${{ secrets.GOOGLE_OAUTH_CLIENT_SECRET }}
       AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
       AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+      OPENSEARCH_PASSWORD: ${{ vars.OPENSEARCH_PASSWORD || secrets.OPENSEARCH_PASSWORD || 'OpenRag#2025!' }}
 
     steps:
       - name: Cleanup Docker cache
@@ -161,6 +162,7 @@ jobs:
           OPENSEARCH_HOST: localhost
           OPENSEARCH_PORT: "9200"
           OPENSEARCH_USERNAME: admin
+          OPENSEARCH_PASSWORD: ${{ env.OPENSEARCH_PASSWORD }}
           GOOGLE_OAUTH_CLIENT_ID: ""
           GOOGLE_OAUTH_CLIENT_SECRET: ""
         run: npx playwright test
diff --git a/scripts/setup-e2e.sh b/scripts/setup-e2e.sh
index 3f92725fb..0d83f6ee8 100755
--- a/scripts/setup-e2e.sh
+++ b/scripts/setup-e2e.sh
@@ -13,28 +13,31 @@ if [ ! -f "$E2E_ENV" ]; then
     cp "$E2E_ENV_EXAMPLE" "$E2E_ENV"
 fi
 
-# Auto-generate a strong OpenSearch password if not already set in the env file.
+# Auto-generate a strong OpenSearch password if not already set in the env file or environment.
 # OpenSearch requires: uppercase, lowercase, digit, special char, min 8 chars.
 CURRENT_PASSWORD=$(grep -E '^OPENSEARCH_PASSWORD=' "$E2E_ENV" | cut -d'=' -f2-)
-if [ -z "$CURRENT_PASSWORD" ]; then
+if [ -n "$OPENSEARCH_PASSWORD" ]; then
+    echo "Using OpenSearch password from environment."
+    GENERATED_PASSWORD="$OPENSEARCH_PASSWORD"
+elif [ -z "$CURRENT_PASSWORD" ]; then
     # Generate a random base (alphanumeric) and append required character classes
     RANDOM_BASE=$(LC_ALL=C tr -dc 'A-Za-z0-9' < /dev/urandom | head -c 12)
     GENERATED_PASSWORD="${RANDOM_BASE}Aa1@"
     echo "Auto-generated OpenSearch password for E2E tests."
-
-    # Write the password into the env file
-    if [[ "$OSTYPE" == "darwin"* ]]; then
-        sed -i '' "s|^OPENSEARCH_PASSWORD=.*|OPENSEARCH_PASSWORD=${GENERATED_PASSWORD}|" "$E2E_ENV"
-    else
-        sed -i "s|^OPENSEARCH_PASSWORD=.*|OPENSEARCH_PASSWORD=${GENERATED_PASSWORD}|" "$E2E_ENV"
-    fi
-
-    export OPENSEARCH_PASSWORD="$GENERATED_PASSWORD"
 else
     echo "Using existing OpenSearch password from $E2E_ENV."
-    export OPENSEARCH_PASSWORD="$CURRENT_PASSWORD"
+    GENERATED_PASSWORD="$CURRENT_PASSWORD"
 fi
 
+# Write the password into the env file
+if [[ "$OSTYPE" == "darwin"* ]]; then
+    sed -i '' "s|^OPENSEARCH_PASSWORD=.*|OPENSEARCH_PASSWORD=${GENERATED_PASSWORD}|" "$E2E_ENV"
+else
+    sed -i "s|^OPENSEARCH_PASSWORD=.*|OPENSEARCH_PASSWORD=${GENERATED_PASSWORD}|" "$E2E_ENV"
+fi
+
+export OPENSEARCH_PASSWORD="$GENERATED_PASSWORD"
+
 # Detect container runtime
 if command -v docker >/dev/null 2>&1; then
     CONTAINER_RUNTIME="docker"

From 9b949c546ddc7fe0ffa08a9cafd9e42957ead939 Mon Sep 17 00:00:00 2001
From: Lucas Oliveira <lucas.edu.oli@hotmail.com>
Date: Fri, 13 Mar 2026 20:19:44 -0300
Subject: [PATCH 11/13] add logs

---
 scripts/setup-e2e.sh | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/scripts/setup-e2e.sh b/scripts/setup-e2e.sh
index 0d83f6ee8..ea0002d29 100755
--- a/scripts/setup-e2e.sh
+++ b/scripts/setup-e2e.sh
@@ -15,7 +15,7 @@ fi
 
 # Auto-generate a strong OpenSearch password if not already set in the env file or environment.
 # OpenSearch requires: uppercase, lowercase, digit, special char, min 8 chars.
-CURRENT_PASSWORD=$(grep -E '^OPENSEARCH_PASSWORD=' "$E2E_ENV" | cut -d'=' -f2-)
+CURRENT_PASSWORD=$(grep -E '^OPENSEARCH_PASSWORD=' "$E2E_ENV" | cut -d'=' -f2- | sed -e "s/^'//" -e "s/'$//" -e 's/^"//' -e 's/"$//')
 if [ -n "$OPENSEARCH_PASSWORD" ]; then
     echo "Using OpenSearch password from environment."
     GENERATED_PASSWORD="$OPENSEARCH_PASSWORD"
@@ -29,11 +29,11 @@ else
     GENERATED_PASSWORD="$CURRENT_PASSWORD"
 fi
 
-# Write the password into the env file
+# Write the password into the env file, wrapping in single quotes to prevent issues with characters like '#'
 if [[ "$OSTYPE" == "darwin"* ]]; then
-    sed -i '' "s|^OPENSEARCH_PASSWORD=.*|OPENSEARCH_PASSWORD=${GENERATED_PASSWORD}|" "$E2E_ENV"
+    sed -i '' "s|^OPENSEARCH_PASSWORD=.*|OPENSEARCH_PASSWORD='${GENERATED_PASSWORD}'|" "$E2E_ENV"
 else
-    sed -i "s|^OPENSEARCH_PASSWORD=.*|OPENSEARCH_PASSWORD=${GENERATED_PASSWORD}|" "$E2E_ENV"
+    sed -i "s|^OPENSEARCH_PASSWORD=.*|OPENSEARCH_PASSWORD='${GENERATED_PASSWORD}'|" "$E2E_ENV"
 fi
 
 export OPENSEARCH_PASSWORD="$GENERATED_PASSWORD"
@@ -74,6 +74,7 @@ until curl -s -k https://localhost:9200 >/dev/null; do
     ELAPSED=$((ELAPSED + 5))
     if [ $ELAPSED -ge $TIMEOUT ]; then
         echo "ERROR: OpenSearch did not become ready within ${TIMEOUT}s"
+        ${CONTAINER_RUNTIME:-docker} logs os 2>&1 | tail -n 100
         exit 1
     fi
     echo "Waiting for OpenSearch... (${ELAPSED}s/${TIMEOUT}s)"

From 27ec7c68a6bb378c39e924b5eea8e67699e751ef Mon Sep 17 00:00:00 2001
From: Lucas Oliveira <lucas.edu.oli@hotmail.com>
Date: Fri, 13 Mar 2026 20:55:47 -0300
Subject: [PATCH 12/13] fix for # in password and added make docling

---
 scripts/setup-e2e.sh | 21 +++++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/scripts/setup-e2e.sh b/scripts/setup-e2e.sh
index ea0002d29..3d18935fe 100755
--- a/scripts/setup-e2e.sh
+++ b/scripts/setup-e2e.sh
@@ -29,11 +29,21 @@ else
     GENERATED_PASSWORD="$CURRENT_PASSWORD"
 fi
 
-# Write the password into the env file, wrapping in single quotes to prevent issues with characters like '#'
-if [[ "$OSTYPE" == "darwin"* ]]; then
-    sed -i '' "s|^OPENSEARCH_PASSWORD=.*|OPENSEARCH_PASSWORD='${GENERATED_PASSWORD}'|" "$E2E_ENV"
+# Make's `include` treats `#` as comments. If the password contains `#`, remove it from the file
+# and rely entirely on the exported environment variable below.
+if [[ "$GENERATED_PASSWORD" == *"#"* ]]; then
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+        sed -i '' '/^OPENSEARCH_PASSWORD=/d' "$E2E_ENV"
+    else
+        sed -i '/^OPENSEARCH_PASSWORD=/d' "$E2E_ENV"
+    fi
 else
-    sed -i "s|^OPENSEARCH_PASSWORD=.*|OPENSEARCH_PASSWORD='${GENERATED_PASSWORD}'|" "$E2E_ENV"
+    # Write the password into the env file (no quotes needed if no #)
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+        sed -i '' "s|^OPENSEARCH_PASSWORD=.*|OPENSEARCH_PASSWORD=${GENERATED_PASSWORD}|" "$E2E_ENV"
+    else
+        sed -i "s|^OPENSEARCH_PASSWORD=.*|OPENSEARCH_PASSWORD=${GENERATED_PASSWORD}|" "$E2E_ENV"
+    fi
 fi
 
 export OPENSEARCH_PASSWORD="$GENERATED_PASSWORD"
@@ -59,6 +69,9 @@ mkdir -p config data keys opensearch-data openrag-documents
 echo "Starting infrastructure..."
 make dev-local-cpu ENV_FILE=$E2E_ENV
 
+echo "Starting docling..."
+make docling
+
 # On Linux/CI, Docker volumes are root-owned. Fix them so the host runner can write to them.
 if [ "$CI" = "true" ] && [[ "$OSTYPE" != "darwin"* ]]; then
     echo "Fixing volume permissions for CI..."

From 48d6655ef5012fe474887153e3d3383954a3f3df Mon Sep 17 00:00:00 2001
From: Lucas Oliveira <lucas.edu.oli@hotmail.com>
Date: Fri, 13 Mar 2026 21:25:29 -0300
Subject: [PATCH 13/13] direct host docker internal to host gateway

---
 docker-compose.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docker-compose.yml b/docker-compose.yml
index 0aef3a172..5751b2d72 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -124,6 +124,8 @@ services:
       context: .
       dockerfile: Dockerfile.langflow
     container_name: langflow
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
     ports:
       - "${LANGFLOW_PORT:-7860}:7860"
     environment: