[pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

Author: pre-commit-ci[bot]

EdgeCraftRAG/docs/Advanced_Setup.md

@@ -96,7 +96,7 @@ Before started, please prepare models into MODEL_PATH and prepare docker images
 
 ```bash
 export MODEL_PATH="${PWD}/models" # Your model path
-export LLM_MODEL="Qwen/Qwen3-30B-A3B" 
+export LLM_MODEL="Qwen/Qwen3-30B-A3B"
 ip_address=$(hostname -I | awk '{print $1}')
 # Use `ip a` to check your active ip
 export HOST_IP=$ip_address # Your host ip
@@ -119,7 +119,7 @@ chown 1000:1000 ${MODEL_PATH} ${DOC_PATH} ${TMPFILE_PATH}
 chown 1000:1000 -R $HOME/.cache
 ```
 
-###  Deploy the Service on Arc B60 Using Docker Compose
+### Deploy the Service on Arc B60 Using Docker Compose
 
 ```bash
 # vLLM envs

EdgeCraftRAG/docs/Agentic_RAG_Guide.md

@@ -3,20 +3,25 @@
 This guide explains how to enable, configure, and use Agent capabilities within EdgeCraftRAG (EC-RAG). It covers the creation and management of different agent types to enhance retrieval and generation workflows.(Currently, EC-RAG Agent is an experimental option.)
 
 ## Overview
+
 EC-RAG introduces autonomous agents that can perform complex reasoning, planning to answer queries more effectively than standard RAG pipelines.
 
 EC-RAG currently supports two types of agents:
+
 - **Simple Agent**: A lightweight agent designed for straightforward tasks and direct query answering.
 - **Deep Search Agent**: An advanced agent capable of multi-step planning, deep research, and reasoning.
 
 ## Creating an Agent
 
 ### Prerequisites
+
 To use agents in EC-RAG, please ensure the following prerequisites are met:
-1. Ensure the standard EC-RAG services are running and the UI is accessible. 
+
+1. Ensure the standard EC-RAG services are running and the UI is accessible.
 2. Agents require vLLM serving, please ensure pipelines utilizing vLLM serving are available.
 
 ### Creating a Simple Agent
+
 To create a Simple Agent, you need to switch to `Agents` tab in the `Settings` page and click `Create Agent` button.
 ![alt text](../assets/img/agent_tab.png)
 
@@ -27,32 +32,36 @@ After selecting `Simple`, pipeline selection and Agent configuration will be ava
 ![alt text](../assets/img/agent_config_simple.png)
 
 ### Creating a Deep Search Agent
+
 To create a Deep Search Agent, switch to `Agents` tab and click `Create Agent` button. In `Create Agent` window, set `Agent Type` as `Deep Search`.
 ![alt text](../assets/img/agent_create_deep-search.png)
 
 Similarly, please select the pipeline with vLLM serving (generator type `FreeChat`) in `Pipeline Name`. In `Agent Configs` session, 5 parameters coudl be customized: `Retrieve Top K`, `Rerank Top K`, `Mece Retrival`, `Max Retrivals` and `Max Plan Steps`. If `Mece Retrival` is enabled, agent will not retrieve chunks already retrieved in each step.
 ![alt text](../assets/img/agent_config_deep-search.png)
 
 ## Using Agents in RAG Pipelines
+
 When agents were created successfully, they will be listed under `Agents` tab.
 ![alt text](../assets/img/agent_tab_with_agents.png)
 
 Then we can switch to `Chat` page to use the agents we created. They will be listed under `Agents` section of `Chat` page.
 ![alt text](../assets/img/agent_chat.png)
 
 ### Simple Agent
+
 Select the Simple agent we created, `Think` function will be locked in dialog window as `Think` is mandatory for agents. While Simple agent is working, it will decide if more information is needed, and generate new query if so.
 ![alt text](../assets/img/agent_simple_working.png)
 
 ### DeepSearch Agent
+
 Select DeepSearch agent from the `Agents` section. If we're going to switch between different agents, previous will be close.
 ![alt text](../assets/img/agent_switching.png)
 
-Agent could also be deactived by single-click on the activated agent.
+Agent could also be deactivated by single-click on the activated agent.
 ![alt text](../assets/img/agent_deactivate.png)
 
 While DeepSearch agent is working, it will make plans on its own and execute the plan step by step.
 ![alt text](../assets/img/agent_deepsearch_plan.png)
 
 When all planned steps completed, DeepSearch agent will generate the final answer.
-![alt text](../assets/img/agent_deepsearch_answer.png)
+![alt text](../assets/img/agent_deepsearch_answer.png)

EdgeCraftRAG/docs/Agentic_RAG_Guide_Zh.md

@@ -1,54 +1,63 @@
 # EC-RAG智能体指南
+
 目前，EC-RAG智能体将作为试用版功能开放体验。
 本指南将为您介绍如何在 EdgeCraftRAG (EC-RAG) 中启用、配置和使用智能体（Agent）功能，涵盖不同类型智能体的创建和管理。
 
-
 ## 概述
+
 EC-RAG现已支持创建智能体，这些智能体能够执行复杂的推理、规划，从而能够比未使用智能体的RAG更准确地为您提供回答。
 EC-RAG目前支持两种类型的智能体：
+
 - **Simple Agent**: 不包含规划、research的简单轻量级Agent；
 - **Deep Search Agent**: 能够进行多步规划、deep research和深度推理的更高级版本Agent。
 
 ## Retrieval
 
 ### 前提条件
+
 要在EC-RAG中使用智能体，您需要确保满足以下前提条件：
+
 1. 确保EC-RAG完整服务正在运行，并且UI可以访问；
 2. Agent需要vLLM的大模型作为后端服务，请确保EC-RAG中以vLLM作为后端的pipeline处于可用状态。
 
 ### 创建Simple Agent智能体
-当您需要创建Simple Agent时，需要在`配置`页面切换到`智能体`选项卡，点击`创建智能体`按钮。 
+
+当您需要创建Simple Agent时，需要在`配置`页面切换到`智能体`选项卡，点击`创建智能体`按钮。
 ![alt text](../assets/img/agent_tab_zh.png)
 
 然后在`创建智能体`窗口中，将`智能体类型`设置为`simple`。
 ![alt text](../assets/img/agent_create_simple_zh.png)
 
-选择`simple`后，窗口内将出现`pipeline名称`和`智能体配置`两个可选项。请您选择带有 vLLM 服务且生成器类型为`FreeChat`的pipeline，并在`智能体配置`中，根据您的需要指定`Max Retrievals`。 
+选择`simple`后，窗口内将出现`pipeline名称`和`智能体配置`两个可选项。请您选择带有 vLLM 服务且生成器类型为`FreeChat`的pipeline，并在`智能体配置`中，根据您的需要指定`Max Retrievals`。
 ![alt text](../assets/img/agent_config_simple_zh.png)
 
 ### 创建Deep Search Agent智能体
-当您需要创建深度搜索代理时，同样，请切换到`智能体`选项卡，并点击`创建智能体`按钮。在`创建智能体`窗口中，将`智能体类型`设置为`Deep Search`。 
+
+当您需要创建深度搜索代理时，同样，请切换到`智能体`选项卡，并点击`创建智能体`按钮。在`创建智能体`窗口中，将`智能体类型`设置为`Deep Search`。
 ![alt text](../assets/img/agent_create_deep-search_zh.png)
 
 在`pipeline名称`和`智能体配置`两个可选项出现后，请选择带有 vLLM 服务且生成器类型为`FreeChat`的pipeline。对于Deep Search智能体，在`智能体配置`部分，可以自定义 5 个参数：`Retrieve Top K`、`Rerank Top K`、`Mece Retrieval`、`Max Retrievals`和`Max Plan Steps`。如果您启用了`Mece Retrieval`，智能体在每次行进retrieve时，将不会重复拿取之前的chunck。
 ![alt text](../assets/img/agent_config_deep-search_zh.png)
 
 ## 在RAG中使用智能体
+
 当您成功创建智能体后，它们将在`智能体`选项卡下列出。
 ![alt text](../assets/img/agent_tab_with_agents_zh.png)
 
 此时，您可以切换到`对话`页面，来使用刚才创建的智能体。它们将在`对话`页面的`智能体`部分列出。
 ![alt text](../assets/img/agent_chat.png)
 
 ### 使用Simple Agent智能体
+
 `思考`功能对于智能体来说是必须的，所以您会注意到，当您选择创建的Simple Agent后，对话框中的`思考`选项会被锁定。当Simple Agent正常工作时，它会判断回答是否足够、是否需要更多信息。
 ![alt text](../assets/img/agent_simple_working_zh.png)
 
 ### 使用Deep Research智能体
-从`智能体`部分选择您创建的DeepResearch智能体。您会注意到，如果您在不同智能体之间切换，之前的智能体将自动变为未激活状态。 
+
+从`智能体`部分选择您创建的DeepResearch智能体。您会注意到，如果您在不同智能体之间切换，之前的智能体将自动变为未激活状态。
 ![alt text](../assets/img/agent_switching_zh.png)
 
-您也可以通过单击已激活的智能体来停用它。 
+您也可以通过单击已激活的智能体来停用它。
 ![alt text](../assets/img/agent_deactivate_zh.png)
 
 当Deep Research智能体正常工作时，它会自主进行回答规划并按需求逐步执行，并最终生成答案。

EdgeCraftRAG/edgecraftrag/components/model.py

@@ -48,13 +48,15 @@ def ser_model(self):
 
 class OpenAIEmbeddingModel(BaseModelComponent, OpenAIEmbedding):
     def __init__(self, model_id, api_base, **kwargs):
-        api_base = api_base+"/v1" if api_base and not api_base.endswith("/v1") else api_base
+        api_base = api_base + "/v1" if api_base and not api_base.endswith("/v1") else api_base
         super().__init__(
             model_id=model_id,
             api_base=api_base,
             **kwargs,
         )
-        OpenAIEmbedding.__init__(self, model_id_or_path=model_id, model_name=model_id, api_base=api_base, api_key="unused")
+        OpenAIEmbedding.__init__(
+            self, model_id_or_path=model_id, model_name=model_id, api_base=api_base, api_key="unused"
+        )
         self.comp_type = CompType.MODEL
         self.comp_subtype = ModelType.VLLM_EMBEDDING
         self.model_id = model_id

EdgeCraftRAG/edgecraftrag/utils.py

@@ -45,7 +45,7 @@ def get_prompt_template(model_path, prompt_content=None, template_path=None, ena
     if prompt_content is not None:
         template = prompt_content
     elif template_path is not None:
-       # Safely load the template only if it is inside /templates (or other safe root)
+        # Safely load the template only if it is inside /templates (or other safe root)
         safe_root = "/templates"
         normalized_path = os.path.normpath(os.path.join(safe_root, template_path))
         if not normalized_path.startswith(safe_root):

EdgeCraftRAG/ui/vue/components.d.ts

@@ -1,8 +1,11 @@
+// Copyright (C) 2025 Intel Corporation
+// SPDX-License-Identifier: Apache-2.0
+
 /* eslint-disable */
 // @ts-nocheck
 // Generated by unplugin-vue-components
 // Read more: https://github.com/vuejs/core/pull/3399
-export {}
+export {};
 
 /* prettier-ignore */
 declare module 'vue' {

EdgeCraftRAG/ui/vue/src/auto-imports.d.ts

@@ -1,3 +1,6 @@
+// Copyright (C) 2025 Intel Corporation
+// SPDX-License-Identifier: Apache-2.0
+
 /* eslint-disable */
 /* prettier-ignore */
 // @ts-nocheck
@@ -6,83 +9,98 @@
 // biome-ignore lint: disable
 export {}
 declare global {
-  const EffectScope: typeof import('vue')['EffectScope']
-  const acceptHMRUpdate: typeof import('pinia')['acceptHMRUpdate']
-  const computed: typeof import('vue')['computed']
-  const createApp: typeof import('vue')['createApp']
-  const createPinia: typeof import('pinia')['createPinia']
-  const customRef: typeof import('vue')['customRef']
-  const defineAsyncComponent: typeof import('vue')['defineAsyncComponent']
-  const defineComponent: typeof import('vue')['defineComponent']
-  const defineStore: typeof import('pinia')['defineStore']
-  const effectScope: typeof import('vue')['effectScope']
-  const getActivePinia: typeof import('pinia')['getActivePinia']
-  const getCurrentInstance: typeof import('vue')['getCurrentInstance']
-  const getCurrentScope: typeof import('vue')['getCurrentScope']
-  const h: typeof import('vue')['h']
-  const inject: typeof import('vue')['inject']
-  const isProxy: typeof import('vue')['isProxy']
-  const isReactive: typeof import('vue')['isReactive']
-  const isReadonly: typeof import('vue')['isReadonly']
-  const isRef: typeof import('vue')['isRef']
-  const mapActions: typeof import('pinia')['mapActions']
-  const mapGetters: typeof import('pinia')['mapGetters']
-  const mapState: typeof import('pinia')['mapState']
-  const mapStores: typeof import('pinia')['mapStores']
-  const mapWritableState: typeof import('pinia')['mapWritableState']
-  const markRaw: typeof import('vue')['markRaw']
-  const nextTick: typeof import('vue')['nextTick']
-  const onActivated: typeof import('vue')['onActivated']
-  const onBeforeMount: typeof import('vue')['onBeforeMount']
-  const onBeforeRouteLeave: typeof import('vue-router')['onBeforeRouteLeave']
-  const onBeforeRouteUpdate: typeof import('vue-router')['onBeforeRouteUpdate']
-  const onBeforeUnmount: typeof import('vue')['onBeforeUnmount']
-  const onBeforeUpdate: typeof import('vue')['onBeforeUpdate']
-  const onDeactivated: typeof import('vue')['onDeactivated']
-  const onErrorCaptured: typeof import('vue')['onErrorCaptured']
-  const onMounted: typeof import('vue')['onMounted']
-  const onRenderTracked: typeof import('vue')['onRenderTracked']
-  const onRenderTriggered: typeof import('vue')['onRenderTriggered']
-  const onScopeDispose: typeof import('vue')['onScopeDispose']
-  const onServerPrefetch: typeof import('vue')['onServerPrefetch']
-  const onUnmounted: typeof import('vue')['onUnmounted']
-  const onUpdated: typeof import('vue')['onUpdated']
-  const onWatcherCleanup: typeof import('vue')['onWatcherCleanup']
-  const provide: typeof import('vue')['provide']
-  const reactive: typeof import('vue')['reactive']
-  const readonly: typeof import('vue')['readonly']
-  const ref: typeof import('vue')['ref']
-  const resolveComponent: typeof import('vue')['resolveComponent']
-  const setActivePinia: typeof import('pinia')['setActivePinia']
-  const setMapStoreSuffix: typeof import('pinia')['setMapStoreSuffix']
-  const shallowReactive: typeof import('vue')['shallowReactive']
-  const shallowReadonly: typeof import('vue')['shallowReadonly']
-  const shallowRef: typeof import('vue')['shallowRef']
-  const storeToRefs: typeof import('pinia')['storeToRefs']
-  const toRaw: typeof import('vue')['toRaw']
-  const toRef: typeof import('vue')['toRef']
-  const toRefs: typeof import('vue')['toRefs']
-  const toValue: typeof import('vue')['toValue']
-  const triggerRef: typeof import('vue')['triggerRef']
-  const unref: typeof import('vue')['unref']
-  const useAttrs: typeof import('vue')['useAttrs']
-  const useCssModule: typeof import('vue')['useCssModule']
-  const useCssVars: typeof import('vue')['useCssVars']
-  const useId: typeof import('vue')['useId']
-  const useLink: typeof import('vue-router')['useLink']
-  const useModel: typeof import('vue')['useModel']
-  const useRoute: typeof import('vue-router')['useRoute']
-  const useRouter: typeof import('vue-router')['useRouter']
-  const useSlots: typeof import('vue')['useSlots']
-  const useTemplateRef: typeof import('vue')['useTemplateRef']
-  const watch: typeof import('vue')['watch']
-  const watchEffect: typeof import('vue')['watchEffect']
-  const watchPostEffect: typeof import('vue')['watchPostEffect']
-  const watchSyncEffect: typeof import('vue')['watchSyncEffect']
+  const EffectScope: (typeof import("vue"))["EffectScope"];
+  const acceptHMRUpdate: (typeof import("pinia"))["acceptHMRUpdate"];
+  const computed: (typeof import("vue"))["computed"];
+  const createApp: (typeof import("vue"))["createApp"];
+  const createPinia: (typeof import("pinia"))["createPinia"];
+  const customRef: (typeof import("vue"))["customRef"];
+  const defineAsyncComponent: (typeof import("vue"))["defineAsyncComponent"];
+  const defineComponent: (typeof import("vue"))["defineComponent"];
+  const defineStore: (typeof import("pinia"))["defineStore"];
+  const effectScope: (typeof import("vue"))["effectScope"];
+  const getActivePinia: (typeof import("pinia"))["getActivePinia"];
+  const getCurrentInstance: (typeof import("vue"))["getCurrentInstance"];
+  const getCurrentScope: (typeof import("vue"))["getCurrentScope"];
+  const h: (typeof import("vue"))["h"];
+  const inject: (typeof import("vue"))["inject"];
+  const isProxy: (typeof import("vue"))["isProxy"];
+  const isReactive: (typeof import("vue"))["isReactive"];
+  const isReadonly: (typeof import("vue"))["isReadonly"];
+  const isRef: (typeof import("vue"))["isRef"];
+  const mapActions: (typeof import("pinia"))["mapActions"];
+  const mapGetters: (typeof import("pinia"))["mapGetters"];
+  const mapState: (typeof import("pinia"))["mapState"];
+  const mapStores: (typeof import("pinia"))["mapStores"];
+  const mapWritableState: (typeof import("pinia"))["mapWritableState"];
+  const markRaw: (typeof import("vue"))["markRaw"];
+  const nextTick: (typeof import("vue"))["nextTick"];
+  const onActivated: (typeof import("vue"))["onActivated"];
+  const onBeforeMount: (typeof import("vue"))["onBeforeMount"];
+  const onBeforeRouteLeave: (typeof import("vue-router"))["onBeforeRouteLeave"];
+  const onBeforeRouteUpdate: (typeof import("vue-router"))["onBeforeRouteUpdate"];
+  const onBeforeUnmount: (typeof import("vue"))["onBeforeUnmount"];
+  const onBeforeUpdate: (typeof import("vue"))["onBeforeUpdate"];
+  const onDeactivated: (typeof import("vue"))["onDeactivated"];
+  const onErrorCaptured: (typeof import("vue"))["onErrorCaptured"];
+  const onMounted: (typeof import("vue"))["onMounted"];
+  const onRenderTracked: (typeof import("vue"))["onRenderTracked"];
+  const onRenderTriggered: (typeof import("vue"))["onRenderTriggered"];
+  const onScopeDispose: (typeof import("vue"))["onScopeDispose"];
+  const onServerPrefetch: (typeof import("vue"))["onServerPrefetch"];
+  const onUnmounted: (typeof import("vue"))["onUnmounted"];
+  const onUpdated: (typeof import("vue"))["onUpdated"];
+  const onWatcherCleanup: (typeof import("vue"))["onWatcherCleanup"];
+  const provide: (typeof import("vue"))["provide"];
+  const reactive: (typeof import("vue"))["reactive"];
+  const readonly: (typeof import("vue"))["readonly"];
+  const ref: (typeof import("vue"))["ref"];
+  const resolveComponent: (typeof import("vue"))["resolveComponent"];
+  const setActivePinia: (typeof import("pinia"))["setActivePinia"];
+  const setMapStoreSuffix: (typeof import("pinia"))["setMapStoreSuffix"];
+  const shallowReactive: (typeof import("vue"))["shallowReactive"];
+  const shallowReadonly: (typeof import("vue"))["shallowReadonly"];
+  const shallowRef: (typeof import("vue"))["shallowRef"];
+  const storeToRefs: (typeof import("pinia"))["storeToRefs"];
+  const toRaw: (typeof import("vue"))["toRaw"];
+  const toRef: (typeof import("vue"))["toRef"];
+  const toRefs: (typeof import("vue"))["toRefs"];
+  const toValue: (typeof import("vue"))["toValue"];
+  const triggerRef: (typeof import("vue"))["triggerRef"];
+  const unref: (typeof import("vue"))["unref"];
+  const useAttrs: (typeof import("vue"))["useAttrs"];
+  const useCssModule: (typeof import("vue"))["useCssModule"];
+  const useCssVars: (typeof import("vue"))["useCssVars"];
+  const useId: (typeof import("vue"))["useId"];
+  const useLink: (typeof import("vue-router"))["useLink"];
+  const useModel: (typeof import("vue"))["useModel"];
+  const useRoute: (typeof import("vue-router"))["useRoute"];
+  const useRouter: (typeof import("vue-router"))["useRouter"];
+  const useSlots: (typeof import("vue"))["useSlots"];
+  const useTemplateRef: (typeof import("vue"))["useTemplateRef"];
+  const watch: (typeof import("vue"))["watch"];
+  const watchEffect: (typeof import("vue"))["watchEffect"];
+  const watchPostEffect: (typeof import("vue"))["watchPostEffect"];
+  const watchSyncEffect: (typeof import("vue"))["watchSyncEffect"];
 }
 // for type re-export
 declare global {
   // @ts-ignore
-  export type { Component, ComponentPublicInstance, ComputedRef, DirectiveBinding, ExtractDefaultPropTypes, ExtractPropTypes, ExtractPublicPropTypes, InjectionKey, PropType, Ref, MaybeRef, MaybeRefOrGetter, VNode, WritableComputedRef } from 'vue'
-  import('vue')
+  export type {
+    Component,
+    ComponentPublicInstance,
+    ComputedRef,
+    DirectiveBinding,
+    ExtractDefaultPropTypes,
+    ExtractPropTypes,
+    ExtractPublicPropTypes,
+    InjectionKey,
+    PropType,
+    Ref,
+    MaybeRef,
+    MaybeRefOrGetter,
+    VNode,
+    WritableComputedRef,
+  } from "vue";
+  import("vue");
 }