chore(frontend): update .dockerignore and .gitignore to correct lib directory entry; add new utility and file handling modules

.dockerignore

@@ -60,7 +60,7 @@ dist/
 downloads/
 eggs/
 .eggs/
-lib/
+# lib/
 lib64/
 parts/
 sdist/

.gitignore

@@ -11,7 +11,7 @@ dist/
 downloads/
 eggs/
 .eggs/
-lib/
+# lib/
 lib64/
 parts/
 sdist/

frontend/lib/env.ts

@@ -0,0 +1,15 @@
+import { env } from 'next-runtime-env';
+
+export const getEnv = (key: string, defaultValue?: string): string => {
+  try {
+    const value = env(key);
+    return value || defaultValue || '';
+  } catch (error) {
+    console.error(`Error getting environment variable ${key}:`, error);
+    return defaultValue || '';
+  }
+};
+
+export const getApiUrl = (): string => {
+  return getEnv('NEXT_PUBLIC_API_URL', 'https://api-evoai.evoapicloud.com');
+}; 

frontend/lib/file-utils.ts

@@ -0,0 +1,110 @@
+/*
+┌──────────────────────────────────────────────────────────────────────────────┐
+│ @author: Davidson Gomes                                                      │
+│ @file: /lib/file-utils.ts                                                    │
+│ Developed by: Davidson Gomes                                                 │
+│ Creation date: August 24, 2025                                               │
+│ Contact: contato@evolution-api.com                                           │
+├──────────────────────────────────────────────────────────────────────────────┤
+│ @copyright © Evolution API 2025. All rights reserved.                        │
+│ Licensed under the Apache License, Version 2.0                               │
+│                                                                              │
+│ You may not use this file except in compliance with the License.             │
+│ You may obtain a copy of the License at                                      │
+│                                                                              │
+│    http://www.apache.org/licenses/LICENSE-2.0                                │
+│                                                                              │
+│ Unless required by applicable law or agreed to in writing, software          │
+│ distributed under the License is distributed on an "AS IS" BASIS,            │
+│ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.     │
+│ See the License for the specific language governing permissions and          │
+│ limitations under the License.                                               │
+├──────────────────────────────────────────────────────────────────────────────┤
+│ @important                                                                   │
+│ For any future changes to the code in this file, it is recommended to        │
+│ include, together with the modification, the information of the developer    │
+│ who changed it and the date of modification.                                 │
+└──────────────────────────────────────────────────────────────────────────────┘
+*/
+
+export interface FileData {
+  filename: string;
+  content_type: string;
+  data: string;
+  size: number;
+  preview_url?: string;
+}
+
+export function fileToBase64(file: File): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.readAsDataURL(file);
+    reader.onload = () => {
+      const base64 = reader.result as string;
+      const base64Data = base64.split(',')[1];
+      resolve(base64Data);
+    };
+    reader.onerror = error => reject(error);
+  });
+}
+
+export async function fileToFileData(file: File): Promise<FileData> {
+  const base64Data = await fileToBase64(file);
+  const previewUrl = URL.createObjectURL(file);
+  
+  return {
+    filename: file.name,
+    content_type: file.type,
+    data: base64Data,
+    size: file.size,
+    preview_url: previewUrl
+  };
+}
+
+export function formatFileSize(bytes: number): string {
+  if (bytes === 0) {
+    return '0 Bytes';
+  }
+  
+  const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];
+  const i = Math.floor(Math.log(bytes) / Math.log(1024));
+  
+  return parseFloat((bytes / Math.pow(1024, i)).toFixed(2)) + ' ' + sizes[i];
+}
+
+export function isImageFile(mimeType: string): boolean {
+  return mimeType.startsWith('image/');
+}
+
+export function isPdfFile(mimeType: string): boolean {
+  return mimeType === 'application/pdf';
+}
+
+export function getFileIcon(mimeType: string): string {
+  if (isImageFile(mimeType)) {
+    return 'image';
+  }
+  if (isPdfFile(mimeType)) {
+    return 'file-text';
+  }
+  if (mimeType.includes('word')) {
+    return 'file-text';
+  }
+  if (mimeType.includes('excel') || mimeType.includes('spreadsheet')) {
+    return 'file-spreadsheet';
+  }
+  if (mimeType.includes('presentation') || mimeType.includes('powerpoint')) {
+    return 'file-presentation';
+  }
+  if (mimeType.includes('text/')) {
+    return 'file-text';
+  }
+  if (mimeType.includes('audio/')) {
+    return 'file-audio';
+  }
+  if (mimeType.includes('video/')) {
+    return 'file-video';
+  }
+  
+  return 'file';
+} 

frontend/lib/utils.ts

@@ -0,0 +1,235 @@
+/*
+┌──────────────────────────────────────────────────────────────────────────────┐
+│ @author: Davidson Gomes                                                      │
+│ @file: /lib/utils.ts                                                         │
+│ Developed by: Davidson Gomes                                                 │
+│ Creation date: May 13, 2025                                                  │
+│ Contact: contato@evolution-api.com                                           │
+├──────────────────────────────────────────────────────────────────────────────┤
+│ @copyright © Evolution API 2025. All rights reserved.                        │
+│ Licensed under the Apache License, Version 2.0                               │
+│                                                                              │
+│ You may not use this file except in compliance with the License.             │
+│ You may obtain a copy of the License at                                      │
+│                                                                              │
+│    http://www.apache.org/licenses/LICENSE-2.0                                │
+│                                                                              │
+│ Unless required by applicable law or agreed to in writing, software          │
+│ distributed under the License is distributed on an "AS IS" BASIS,            │
+│ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.     │
+│ See the License for the specific language governing permissions and          │
+│ limitations under the License.                                               │
+├──────────────────────────────────────────────────────────────────────────────┤
+│ @important                                                                   │
+│ For any future changes to the code in this file, it is recommended to        │
+│ include, together with the modification, the information of the developer    │
+│ who changed it and the date of modification.                                 │
+└──────────────────────────────────────────────────────────────────────────────┘
+*/
+import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}
+
+export function getAccessTokenFromCookie() {
+  if (typeof document === "undefined") return "";
+  const match = document.cookie.match(/(?:^|; )access_token=([^;]*)/);
+  return match ? decodeURIComponent(match[1]) : "";
+}
+
+/**
+ * Obtém um parâmetro específico da URL atual
+ */
+export function getQueryParam(param: string): string | null {
+  if (typeof window === "undefined") return null;
+  const urlParams = new URLSearchParams(window.location.search);
+  return urlParams.get(param);
+}
+
+/**
+ * Sanitizes the agent name by removing accents,
+ * replacing spaces with underscores and removing special characters
+ */
+export function sanitizeAgentName(name: string): string {
+  // Remove accents (normalize to basic form without combined characters)
+  const withoutAccents = name.normalize("NFD").replace(/[\u0300-\u036f]/g, "");
+
+  // Replace spaces with underscores and remove special characters
+  return withoutAccents
+    .replace(/\s+/g, "_") // Spaces to underscores
+    .replace(/[^a-zA-Z0-9_]/g, ""); // Remove everything that is not alphanumeric or underscore
+}
+
+/**
+ * Escapes braces in instruction prompts to avoid interpretation errors
+ * as context variables in Python. Uses a more robust approach to ensure
+ * Python doesn't interpret any brace patterns as variables.
+ */
+export function escapePromptBraces(text: string): string {
+  if (!text) return text;
+  
+  // replace { per [ and } per ]
+  return text.replace(/\{/g, "[").replace(/\}/g, "]");
+}
+
+/**
+ * Exports any data as a JSON file for download
+ * @param data The data to export
+ * @param filename The name of the file to download (without .json extension)
+ * @param pretty Whether to pretty-print the JSON (default: true)
+ * @param allAgents Optional array of all agents to resolve references
+ * @returns boolean indicating success
+ */
+export function exportAsJson(
+  data: any, 
+  filename: string, 
+  pretty: boolean = true,
+  allAgents?: any[]
+): boolean {
+  try {
+    // Create a copy of the data
+    let exportData = JSON.parse(JSON.stringify(data));
+    
+    // If we have all agents available, use them to resolve references
+    const agentsMap = new Map();
+    if (allAgents && Array.isArray(allAgents)) {
+      allAgents.forEach(agent => {
+        if (agent && agent.id) {
+          agentsMap.set(agent.id, { ...agent });
+        }
+      });
+    } else if (exportData.agents && Array.isArray(exportData.agents)) {
+      // If we're exporting a collection, build a map from that
+      exportData.agents.forEach((agent: any) => {
+        if (agent && agent.id) {
+          agentsMap.set(agent.id, { ...agent });
+        }
+      });
+    }
+    
+    // Process each agent to replace IDs with full objects and remove sensitive fields
+    const processAgent = (agent: any, depth = 0) => {
+      if (!agent || depth > 2) return agent; // Limit recursion depth to avoid circular references
+      
+      // Process agent_tools - replace IDs with full agent objects
+      if (agent.config && agent.config.agent_tools && Array.isArray(agent.config.agent_tools)) {
+        agent.config.agent_tools = agent.config.agent_tools.map((toolId: string) => {
+          if (typeof toolId === 'string' && agentsMap.has(toolId)) {
+            // Create a simplified version of the agent
+            const toolAgent = { ...agentsMap.get(toolId) };
+            return processAgent(toolAgent, depth + 1);
+          }
+          return toolId;
+        });
+      }
+      
+      // Process sub_agents - replace IDs with full agent objects
+      if (agent.config && agent.config.sub_agents && Array.isArray(agent.config.sub_agents)) {
+        agent.config.sub_agents = agent.config.sub_agents.map((agentId: string) => {
+          if (typeof agentId === 'string' && agentsMap.has(agentId)) {
+            // Create a simplified version of the agent
+            const subAgent = { ...agentsMap.get(agentId) };
+            return processAgent(subAgent, depth + 1);
+          }
+          return agentId;
+        });
+      }
+      
+      // Process task agents - extract tasks and create full agent objects
+      if (agent.type === 'task' && agent.config?.tasks && Array.isArray(agent.config.tasks)) {
+        agent.config.tasks = agent.config.tasks.map((task: any) => {
+          if (task.agent_id && agentsMap.has(task.agent_id)) {
+            // Add the corresponding agent to the task
+            task.agent = processAgent({...agentsMap.get(task.agent_id)}, depth + 1);
+          }
+          return task;
+        });
+      }
+      
+      // Process workflow nodes - recursively process any agent objects in agent-nodes
+      if (agent.type === 'workflow' && agent.config?.workflow?.nodes && Array.isArray(agent.config.workflow.nodes)) {
+        agent.config.workflow.nodes = agent.config.workflow.nodes.map((node: any) => {
+          if (node.type === 'agent-node' && node.data?.agent) {
+            // Process the embedded agent object
+            node.data.agent = processAgent(node.data.agent, depth + 1);
+            
+            // If this is a task agent, also process its tasks
+            if (node.data.agent.type === 'task' && node.data.agent.config?.tasks && Array.isArray(node.data.agent.config.tasks)) {
+              node.data.agent.config.tasks = node.data.agent.config.tasks.map((task: any) => {
+                if (task.agent_id && agentsMap.has(task.agent_id)) {
+                  task.agent = processAgent({...agentsMap.get(task.agent_id)}, depth + 1);
+                }
+                return task;
+              });
+            }
+          }
+          return node;
+        });
+      }
+      
+      // Remove sensitive fields
+      const fieldsToRemove = [
+        'api_key_id',
+        'agent_card_url',
+        'folder_id',
+        'client_id',
+        'created_at',
+        'updated_at'
+      ];
+      
+      // Remove top-level fields
+      fieldsToRemove.forEach(field => {
+        if (agent[field] !== undefined) {
+          delete agent[field];
+        }
+      });
+      
+      // Remove nested fields
+      if (agent.config && agent.config.api_key !== undefined) {
+        delete agent.config.api_key;
+      }
+      
+      return agent;
+    };
+    
+    // Apply processing for single agent or array of agents
+    if (exportData.agents && Array.isArray(exportData.agents)) {
+      // For collections of agents
+      exportData.agents = exportData.agents.map((agent: any) => processAgent(agent));
+    } else if (exportData.id && (exportData.type || exportData.name)) {
+      // For a single agent
+      exportData = processAgent(exportData);
+    }
+    
+    // Create JSON string
+    const jsonString = pretty ? JSON.stringify(exportData, null, 2) : JSON.stringify(exportData);
+    
+    // Create a Blob with the content
+    const blob = new Blob([jsonString], { type: "application/json" });
+    
+    // Create URL for the blob
+    const url = URL.createObjectURL(blob);
+    
+    // Create a temporary <a> element for download
+    const link = document.createElement("a");
+    link.href = url;
+    link.download = filename.endsWith(".json") ? filename : `${filename}.json`;
+    
+    // Append to document, click, and remove
+    document.body.appendChild(link);
+    link.click();
+    
+    // Clean up
+    setTimeout(() => {
+      document.body.removeChild(link);
+      URL.revokeObjectURL(url);
+    }, 100);
+    
+    return true;
+  } catch (error) {
+    console.error("Error exporting JSON:", error);
+    return false;
+  }
+}