@lobehub/lobehub 2.0.0-next.273 → 2.0.0-next.274

package/src/hooks/useBidirectionalQuerySync.ts

@@ -0,0 +1,112 @@
+'use client';
+
+import { useEffect, useRef } from 'react';
+
+import { parseAsString, useQueryState } from '@/hooks/useQueryParam';
+
+interface UseBidirectionalQuerySyncOptions {
+  /**
+   * Default value when query is not present
+   */
+  defaultValue: string;
+}
+
+/**
+ * Hook for bidirectional sync between URL query parameter and store state.
+ * Prevents infinite loops by tracking the source of changes.
+ *
+ * @param queryKey - The URL query parameter key
+ * @param storeValue - Current value from the store
+ * @param setStoreValue - Function to update store value (setState or action)
+ * @param options - Configuration with required defaultValue
+ *
+ * @example
+ * ```tsx
+ * // In a component
+ * const activeTabId = useGroupProfileStore((s) => s.activeTabId);
+ *
+ * useBidirectionalQuerySync('tab', activeTabId, (value) => {
+ *   useGroupProfileStore.setState({ activeTabId: value });
+ * }, { defaultValue: 'group' });
+ * ```
+ */
+export const useBidirectionalQuerySync = (
+  queryKey: string,
+  storeValue: string,
+  setStoreValue: (value: string) => void,
+  options: UseBidirectionalQuerySyncOptions,
+) => {
+  const { defaultValue } = options;
+
+  const [queryValue, setQueryValue] = useQueryState(
+    queryKey,
+    parseAsString.withDefault(defaultValue),
+  );
+
+  // Track if the change came from URL to prevent sync loops
+  const isUrlChangeRef = useRef(false);
+
+  // Sync URL → Store (when URL changes)
+  useEffect(() => {
+    if (queryValue !== storeValue) {
+      isUrlChangeRef.current = true;
+      setStoreValue(queryValue);
+    }
+  }, [queryValue, setStoreValue]);
+
+  // Sync Store → URL (when store changes, but not from URL)
+  useEffect(() => {
+    if (isUrlChangeRef.current) {
+      isUrlChangeRef.current = false;
+      return;
+    }
+    if (storeValue !== queryValue) {
+      setQueryValue(storeValue);
+    }
+  }, [storeValue, queryValue, setQueryValue]);
+};
+
+/**
+ * Hook for bidirectional sync with optional/undefined store values.
+ * Useful when the store value can be undefined (like activeTopicId).
+ *
+ * @example
+ * ```tsx
+ * const activeTopicId = useChatStore((s) => s.activeTopicId);
+ *
+ * useBidirectionalQuerySyncOptional('bt', activeTopicId, (value) => {
+ *   useChatStore.setState({ activeTopicId: value });
+ * });
+ * ```
+ */
+export const useBidirectionalQuerySyncOptional = (
+  queryKey: string,
+  storeValue: string | undefined,
+  setStoreValue: (value: string | undefined) => void,
+) => {
+  const [queryValue, setQueryValue] = useQueryState(queryKey);
+
+  // Track if the change came from URL to prevent sync loops
+  const isUrlChangeRef = useRef(false);
+
+  // Sync URL → Store (when URL changes)
+  useEffect(() => {
+    const urlValue = queryValue ?? undefined;
+    if (urlValue !== storeValue) {
+      isUrlChangeRef.current = true;
+      setStoreValue(urlValue);
+    }
+  }, [queryValue, setStoreValue]);
+
+  // Sync Store → URL (when store changes, but not from URL)
+  useEffect(() => {
+    if (isUrlChangeRef.current) {
+      isUrlChangeRef.current = false;
+      return;
+    }
+    const urlValue = queryValue ?? undefined;
+    if (storeValue !== urlValue) {
+      setQueryValue(storeValue ?? null);
+    }
+  }, [storeValue, queryValue, setQueryValue]);
+};

package/src/locales/default/chat.ts

@@ -87,11 +87,21 @@ export default {
   'group.desc': 'Move a task forward with multiple Agents in one shared space.',
   'group.memberTooltip': 'There are {{count}} members in the group',
   'group.orchestratorThinking': 'Orchestrator is thinking...',
+  'group.profile.contentPlaceholder':
+    'Set the group objectives/work modes here. This information will be shared with all group members.',
+  'group.profile.external': 'External',
+  'group.profile.externalAgentWarning':
+    'This is an external agent. Changes made here will directly modify the original agent configuration.',
+  'group.profile.groupSettings': 'Group Settings',
+  'group.profile.supervisor': 'Supervisor',
+  'group.profile.supervisorPlaceholder':
+    'The supervisor coordinates different agents. Setting supervisor information here enables more precise workflow coordination.',
   'group.removeMember': 'Remove Member',
   'group.title': 'Group',
   'groupDescription': 'Group description',
   'groupSidebar.agentProfile.chat': 'Chat',
   'groupSidebar.agentProfile.model': 'Model',
+  'groupSidebar.agentProfile.settings': 'Settings',
   'groupSidebar.members.addMember': 'Add Member',
   'groupSidebar.members.enableOrchestrator': 'Enable Orchestrator',
   'groupSidebar.members.memberSettings': 'Member Settings',

package/src/locales/default/plugin.ts

@@ -5,6 +5,7 @@ export default {
   'builtins.lobe-agent-builder.apiName.getConfig': 'Get config',
   'builtins.lobe-agent-builder.apiName.getMeta': 'Get metadata',
   'builtins.lobe-agent-builder.apiName.getPrompt': 'Get system prompt',
+  'builtins.lobe-agent-builder.apiName.installPlugin': 'Install Skill',
   'builtins.lobe-agent-builder.apiName.searchMarketTools': 'Search Skill market',
   'builtins.lobe-agent-builder.apiName.searchOfficialTools': 'Search official Skills',
   'builtins.lobe-agent-builder.apiName.setModel': 'Set model',
@@ -15,6 +16,12 @@ export default {
   'builtins.lobe-agent-builder.apiName.updateConfig': 'Update config',
   'builtins.lobe-agent-builder.apiName.updateMeta': 'Update metadata',
   'builtins.lobe-agent-builder.apiName.updatePrompt': 'Update system prompt',
+  'builtins.lobe-agent-builder.inspector.chars': ' chars',
+  'builtins.lobe-agent-builder.inspector.disablePlugin': 'Disable',
+  'builtins.lobe-agent-builder.inspector.enablePlugin': 'Enable',
+  'builtins.lobe-agent-builder.inspector.modelsCount': '{{count}} models',
+  'builtins.lobe-agent-builder.inspector.noResults': 'No results',
+  'builtins.lobe-agent-builder.inspector.togglePlugin': 'Toggle',
   'builtins.lobe-agent-builder.title': 'Agent Builder Expert',
   'builtins.lobe-cloud-sandbox.apiName.editLocalFile': 'Edit file',
   'builtins.lobe-cloud-sandbox.apiName.executeCode': 'Execute code',
@@ -31,13 +38,27 @@ export default {
   'builtins.lobe-cloud-sandbox.apiName.searchLocalFiles': 'Search files',
   'builtins.lobe-cloud-sandbox.apiName.writeLocalFile': 'Write file',
   'builtins.lobe-cloud-sandbox.title': 'Cloud Sandbox',
+  'builtins.lobe-group-agent-builder.apiName.batchCreateAgents': 'Batch create agents',
+  'builtins.lobe-group-agent-builder.apiName.createAgent': 'Create agent',
   'builtins.lobe-group-agent-builder.apiName.getAvailableModels': 'Get available models',
   'builtins.lobe-group-agent-builder.apiName.installPlugin': 'Install Skill',
   'builtins.lobe-group-agent-builder.apiName.inviteAgent': 'Invite member',
   'builtins.lobe-group-agent-builder.apiName.removeAgent': 'Remove member',
+  'builtins.lobe-group-agent-builder.apiName.searchAgent': 'Search agents',
   'builtins.lobe-group-agent-builder.apiName.searchMarketTools': 'Search Skill market',
   'builtins.lobe-group-agent-builder.apiName.updateAgentConfig': 'Update agent config',
-  'builtins.lobe-group-agent-builder.apiName.updatePrompt': 'Update system prompt',
+  'builtins.lobe-group-agent-builder.apiName.updateAgentPrompt': 'Update agent prompt',
+  'builtins.lobe-group-agent-builder.apiName.updateGroup': 'Update group',
+  'builtins.lobe-group-agent-builder.apiName.updateGroupPrompt': 'Update group prompt',
+  'builtins.lobe-group-agent-builder.apiName.updateSupervisorPrompt': 'Update supervisor prompt',
+  'builtins.lobe-group-agent-builder.inspector.agents': 'agents',
+  'builtins.lobe-group-agent-builder.inspector.avatar': 'Avatar',
+  'builtins.lobe-group-agent-builder.inspector.backgroundColor': 'Background color',
+  'builtins.lobe-group-agent-builder.inspector.description': 'Description',
+  'builtins.lobe-group-agent-builder.inspector.noResults': 'No results',
+  'builtins.lobe-group-agent-builder.inspector.openingMessage': 'Opening message',
+  'builtins.lobe-group-agent-builder.inspector.openingQuestions': 'Opening questions',
+  'builtins.lobe-group-agent-builder.inspector.title': 'Title',
   'builtins.lobe-group-agent-builder.title': 'Group Builder Expert',
   'builtins.lobe-group-management.apiName.broadcast': 'All speak',
   'builtins.lobe-group-management.apiName.createAgent': 'Add group member',

package/src/server/modules/AgentRuntime/RuntimeExecutors.ts

@@ -60,7 +60,7 @@ export const createRuntimeExecutors = (
       throw new Error('Model and provider are required for call_llm instruction');
     }
 
-    // 类型断言确保 payload 的正确性
+    // Type assertion to ensure payload correctness
     const operationLogId = `${operationId}:${stepIndex}`;
 
     const stagePrefix = `[${operationLogId}][call_llm]`;
@@ -94,7 +94,7 @@ export const createRuntimeExecutors = (
       log(`${stagePrefix} Created new assistant message: %s`, assistantMessageItem.id);
     }
 
-    // 发布流式开始事件
+    // Publish stream start event
     await streamManager.publishStreamEvent(operationId, {
       data: {
         assistantMessage: assistantMessageItem,
@@ -121,10 +121,10 @@ export const createRuntimeExecutors = (
       let hasContentImages = false;
       let hasReasoningImages = false;
 
-      // 初始化 ModelRuntime (从数据库读取用户的 keyVaults)
+      // Initialize ModelRuntime (read user's keyVaults from database)
       const modelRuntime = await initModelRuntimeFromDB(ctx.serverDB, ctx.userId!, provider);
 
-      // 构造 ChatStreamPayload
+      // Construct ChatStreamPayload
       const chatPayload = {
         messages: llmPayload.messages,
         model,
@@ -138,7 +138,7 @@ export const createRuntimeExecutors = (
         llmPayload.tools?.length ?? 0,
       );
 
-      // Buffer：累积 text 和 reasoning，每 50ms 发送一次
+      // Buffer: accumulate text and reasoning, send every 50ms
       const BUFFER_INTERVAL = 50;
       let textBuffer = '';
       let reasoningBuffer = '';
@@ -154,7 +154,7 @@ export const createRuntimeExecutors = (
         if (!!delta) {
           log(`[${operationLogId}] flushTextBuffer:`, delta);
 
-          // 构建标准 Agent Runtime 事件
+          // Build standard Agent Runtime event
           events.push({
             chunk: { text: delta, type: 'text' },
             type: 'llm_stream',
@@ -203,11 +203,11 @@ export const createRuntimeExecutors = (
         }
       };
 
-      // 调用 model-runtime chat
+      // Call model-runtime chat
       const response = await modelRuntime.chat(chatPayload, {
         callback: {
           onCompletion: async (data) => {
-            // 捕获 usage (可能包含 cost，也可能不包含)
+            // Capture usage (may or may not include cost)
             if (data.usage) {
               currentStepUsage = data.usage;
             }
@@ -232,7 +232,7 @@ export const createRuntimeExecutors = (
 
             textBuffer += text;
 
-            // 如果没有定时器，创建一个
+            // If no timer exists, create one
             if (!textBufferTimer) {
               textBufferTimer = setTimeout(async () => {
                 await flushTextBuffer();
@@ -249,10 +249,10 @@ export const createRuntimeExecutors = (
             );
             thinkingContent += reasoning;
 
-            // Buffer reasoning 内容
+            // Buffer reasoning content
             reasoningBuffer += reasoning;
 
-            // 如果没有定时器，创建一个
+            // If no timer exists, create one
             if (!reasoningBufferTimer) {
               reasoningBufferTimer = setTimeout(async () => {
                 await flushReasoningBuffer();
@@ -266,7 +266,7 @@ export const createRuntimeExecutors = (
             toolsCalling = payload;
             tool_calls = raw;
 
-            // 如果有 textBuffer,先推一次
+            // If textBuffer exists, flush it first
             if (!!textBuffer) {
               await flushTextBuffer();
             }
@@ -280,13 +280,13 @@ export const createRuntimeExecutors = (
         user: ctx.userId,
       });
 
-      // 消费流确保所有回调执行完成
+      // Consume stream to ensure all callbacks complete execution
       await consumeStreamUntilDone(response);
 
       await flushTextBuffer();
       await flushReasoningBuffer();
 
-      // 清理定时器并 flush 剩余 buffer
+      // Clean up timers and flush remaining buffers
       if (textBufferTimer) {
         clearTimeout(textBufferTimer);
         textBufferTimer = null;
@@ -309,18 +309,18 @@ export const createRuntimeExecutors = (
         log(`[${operationLogId}][toolsCalling] `, toolsCalling);
       }
 
-      // 日志输出 usage
+      // Log usage information
       if (currentStepUsage) {
         log(`[${operationLogId}][usage] %O`, currentStepUsage);
       }
 
-      // 添加一个完整的 llm_stream 事件（包含所有流式块）
+      // Add a complete llm_stream event (including all streaming chunks)
       events.push({
         result: { content, reasoning: thinkingContent, tool_calls, usage: currentStepUsage },
         type: 'llm_result',
       });
 
-      // 发布流式结束事件
+      // Publish stream end event
       await streamManager.publishStreamEvent(operationId, {
         data: {
           finalContent: content,
@@ -336,7 +336,7 @@ export const createRuntimeExecutors = (
 
       log('[%s:%d] call_llm completed', operationId, stepIndex);
 
-      // ===== 1. 先保存原始 usage 到 message.metadata =====
+      // ===== 1. First save original usage to message.metadata =====
       // Determine final content - use serialized parts if has images, otherwise plain text
       const finalContent = hasContentImages ? serializePartsForStorage(contentParts) : content;
 
@@ -377,7 +377,7 @@ export const createRuntimeExecutors = (
         console.error('[call_llm] Failed to update message:', error);
       }
 
-      // ===== 2. 然后累加到 AgentState =====
+      // ===== 2. Then accumulate to AgentState =====
       let newState = structuredClone(state);
 
       newState.messages.push({
@@ -387,7 +387,7 @@ export const createRuntimeExecutors = (
       });
 
       if (currentStepUsage) {
-        // 使用 UsageCounter 统一累加 usage 和 cost
+        // Use UsageCounter to uniformly accumulate usage and cost
         const { usage, cost } = UsageCounter.accumulateLLM({
           cost: newState.cost,
           model: llmPayload.model,
@@ -423,7 +423,7 @@ export const createRuntimeExecutors = (
         },
       };
     } catch (error) {
-      // 发布错误事件
+      // Publish error event
       await streamManager.publishStreamEvent(operationId, {
         data: {
           error: (error as Error).message,
@@ -441,7 +441,7 @@ export const createRuntimeExecutors = (
     }
   },
   /**
-   * 工具执行
+   * Tool execution
    */
   call_tool: async (instruction, state) => {
     const { payload } = instruction as Extract<AgentInstruction, { type: 'call_tool' }>;
@@ -451,7 +451,7 @@ export const createRuntimeExecutors = (
     const operationLogId = `${operationId}:${stepIndex}`;
     log(`[${operationLogId}] payload: %O`, payload);
 
-    // 发布工具执行开始事件
+    // Publish tool execution start event
     await streamManager.publishStreamEvent(operationId, {
       data: payload,
       stepIndex,
@@ -477,7 +477,7 @@ export const createRuntimeExecutors = (
         executionResult,
       );
 
-      // 发布工具执行结果事件
+      // Publish tool execution result event
       await streamManager.publishStreamEvent(operationId, {
         data: {
           executionTime,
@@ -490,7 +490,7 @@ export const createRuntimeExecutors = (
         type: 'tool_end',
       });
 
-      // 最终更新数据库
+      // Finally update database
       let toolMessageId: string | undefined;
       try {
         const toolMessage = await ctx.messageModel.create({
@@ -520,10 +520,10 @@ export const createRuntimeExecutors = (
 
       events.push({ id: chatToolPayload.id, result: executionResult, type: 'tool_result' });
 
-      // 获取工具单价
+      // Get tool unit price
       const toolCost = TOOL_PRICING[toolName] || 0;
 
-      // 使用 UsageCounter 统一累加 tool usage
+      // Use UsageCounter to uniformly accumulate tool usage
       const { usage, cost } = UsageCounter.accumulateTool({
         cost: newState.cost,
         executionTime,
@@ -536,10 +536,10 @@ export const createRuntimeExecutors = (
       newState.usage = usage;
       if (cost) newState.cost = cost;
 
-      // 查找当前工具的统计信息
+      // Find current tool statistics
       const currentToolStats = usage.tools.byTool.find((t) => t.name === toolName);
 
-      // 日志输出 usage
+      // Log usage information
       log(
         `[${operationLogId}][tool usage] %s: calls=%d, time=%dms, success=%s, cost=$%s`,
         toolName,
@@ -581,7 +581,7 @@ export const createRuntimeExecutors = (
         },
       };
     } catch (error) {
-      // 发布工具执行错误事件
+      // Publish tool execution error event
       await streamManager.publishStreamEvent(operationId, {
         data: {
           error: (error as Error).message,
@@ -603,12 +603,12 @@ export const createRuntimeExecutors = (
 
       return {
         events,
-        newState: state, // 状态不变
+        newState: state, // State unchanged
       };
     }
   },
   /**
-   * 完成 runtime 运行
+   * Complete runtime execution
    */
   finish: async (instruction, state) => {
     const { reason, reasonDetail } = instruction as Extract<AgentInstruction, { type: 'finish' }>;
@@ -616,7 +616,7 @@ export const createRuntimeExecutors = (
 
     log('[%s:%d] Finishing execution: (%s)', operationId, stepIndex, reason);
 
-    // 发布执行完成事件
+    // Publish execution complete event
     await streamManager.publishStreamEvent(operationId, {
       data: {
         finalState: { ...state, status: 'done' },
@@ -645,7 +645,7 @@ export const createRuntimeExecutors = (
   },
 
   /**
-   * 人工审批
+   * Human approval
    */
   request_human_approve: async (instruction, state) => {
     const { pendingToolsCalling } = instruction as Extract<
@@ -656,7 +656,7 @@ export const createRuntimeExecutors = (
 
     log('[%s:%d] Requesting human approval for %O', operationId, stepIndex, pendingToolsCalling);
 
-    // 发布人工审批请求事件
+    // Publish human approval request event
     await streamManager.publishStreamEvent(operationId, {
       data: {
         pendingToolsCalling,
@@ -672,9 +672,9 @@ export const createRuntimeExecutors = (
     newState.status = 'waiting_for_human';
     newState.pendingToolsCalling = pendingToolsCalling;
 
-    // 通过流式系统通知前端显示审批 UI
+    // Notify frontend to display approval UI through streaming system
     await streamManager.publishStreamChunk(operationId, stepIndex, {
-      // 使用 operationId 作为 messageId
+      // Use operationId as messageId
       chunkType: 'tools_calling',
       toolsCalling: pendingToolsCalling as any,
     });
@@ -698,13 +698,13 @@ export const createRuntimeExecutors = (
     return {
       events,
       newState,
-      // 不提供 nextContext，因为需要等待人工干预
+      // Do not provide nextContext as it requires waiting for human intervention
     };
   },
 
   /**
-   * 解决被取消的工具调用
-   * 为取消的工具调用创建带有 'aborted' 干预状态的工具消息
+   * Resolve aborted tool calls
+   * Create tool messages with 'aborted' intervention status for canceled tool calls
    */
   resolve_aborted_tools: async (instruction, state) => {
     const { payload } = instruction as Extract<AgentInstruction, { type: 'resolve_aborted_tools' }>;
@@ -714,7 +714,7 @@ export const createRuntimeExecutors = (
 
     log('[%s:%d] Resolving %d aborted tools', operationId, stepIndex, toolsCalling.length);
 
-    // 发布工具取消事件
+    // Publish tool cancellation event
     await streamManager.publishStreamEvent(operationId, {
       data: {
         parentMessageId,
@@ -727,7 +727,7 @@ export const createRuntimeExecutors = (
 
     const newState = structuredClone(state);
 
-    // 为每个取消的工具调用创建 tool message
+    // Create tool message for each canceled tool call
     for (const toolPayload of toolsCalling) {
       const toolName = `${toolPayload.identifier}/${toolPayload.apiName}`;
       log('[%s:%d] Creating aborted tool message for %s', operationId, stepIndex, toolName);
@@ -753,7 +753,7 @@ export const createRuntimeExecutors = (
           toolName,
         );
 
-        // 更新 state messages
+        // Update state messages
         newState.messages.push({
           content: 'Tool execution was aborted by user.',
           role: 'tool',
@@ -770,11 +770,11 @@ export const createRuntimeExecutors = (
 
     log('[%s:%d] All aborted tool messages created', operationId, stepIndex);
 
-    // 标记状态为完成
+    // Mark status as complete
     newState.lastModified = new Date().toISOString();
     newState.status = 'done';
 
-    // 发布完成事件
+    // Publish completion event
     await streamManager.publishStreamEvent(operationId, {
       data: {
         finalState: newState,

package/src/server/modules/KeyVaultsEncrypt/index.ts

@@ -21,7 +21,7 @@ export class KeyVaultsGateKeeper {
 If you don't have it, please run \`openssl rand -base64 32\` to create one.
 `);
 
-    const rawKey = Buffer.from(KEY_VAULTS_SECRET, 'base64'); // 确保密钥是32字节（256位）
+    const rawKey = Buffer.from(KEY_VAULTS_SECRET, 'base64'); // Ensure key is 32 bytes (256 bits)
     const aesKey = await crypto.subtle.importKey(
       'raw',
       rawKey,
@@ -36,7 +36,7 @@ If you don't have it, please run \`openssl rand -base64 32\` to create one.
    * encrypt user private data
    */
   encrypt = async (keyVault: string): Promise<string> => {
-    const iv = crypto.getRandomValues(new Uint8Array(12)); // 对于GCM，推荐使用12字节的IV
+    const iv = crypto.getRandomValues(new Uint8Array(12)); // For GCM, 12-byte IV is recommended
     const encodedKeyVault = new TextEncoder().encode(keyVault);
 
     const encryptedData = await crypto.subtle.encrypt(
@@ -49,13 +49,13 @@ If you don't have it, please run \`openssl rand -base64 32\` to create one.
     );
 
     const buffer = Buffer.from(encryptedData);
-    const authTag = buffer.slice(-16); // 认证标签在加密数据的最后16字节
-    const encrypted = buffer.slice(0, -16); // 剩下的是加密数据
+    const authTag = buffer.slice(-16); // Authentication tag is in the last 16 bytes of encrypted data
+    const encrypted = buffer.slice(0, -16); // The rest is encrypted data
 
     return `${Buffer.from(iv).toString('hex')}:${authTag.toString('hex')}:${encrypted.toString('hex')}`;
   };
 
-  // 假设密钥和加密数据是从外部获取的
+  // Assuming key and encrypted data are obtained from external sources
   decrypt = async (encryptedData: string): Promise<DecryptionResult> => {
     const parts = encryptedData.split(':');
     if (parts.length !== 3) {
@@ -66,7 +66,7 @@ If you don't have it, please run \`openssl rand -base64 32\` to create one.
     const authTag = Buffer.from(parts[1], 'hex');
     const encrypted = Buffer.from(parts[2], 'hex');
 
-    // 合并加密数据和认证标签
+    // Combine encrypted data and authentication tag
     const combined = Buffer.concat([encrypted, authTag]);
 
     try {

package/src/server/modules/S3/index.ts

@@ -153,7 +153,7 @@ export class S3 {
     });
   }
 
-  // 添加一个新方法用于上传二进制内容
+  // Add a new method for uploading binary content
   public async uploadBuffer(path: string, buffer: Buffer, contentType?: string) {
     const command = new PutObjectCommand({
       ACL: this.setAcl ? 'public-read' : undefined,

package/src/server/routers/lambda/agent.ts

@@ -3,6 +3,7 @@ import { type KnowledgeItem, KnowledgeType } from '@lobechat/types';
 import { z } from 'zod';
 
 import { AgentModel } from '@/database/models/agent';
+import { ChatGroupModel } from '@/database/models/chatGroup';
 import { FileModel } from '@/database/models/file';
 import { KnowledgeBaseModel } from '@/database/models/knowledgeBase';
 import { SessionModel } from '@/database/models/session';
@@ -20,6 +21,7 @@ const agentProcedure = authedProcedure.use(serverDatabase).use(async (opts) => {
     ctx: {
       agentModel: new AgentModel(ctx.serverDB, ctx.userId),
       agentService: new AgentService(ctx.serverDB, ctx.userId),
+      chatGroupModel: new ChatGroupModel(ctx.serverDB, ctx.userId),
       fileModel: new FileModel(ctx.serverDB, ctx.userId),
       knowledgeBaseModel: new KnowledgeBaseModel(ctx.serverDB, ctx.userId),
       sessionModel: new SessionModel(ctx.serverDB, ctx.userId),
@@ -108,6 +110,28 @@ export const agentRouter = router({
       );
     }),
 
+  /**
+   * Create an agent without session.
+   * Used for Group Agent Builder to create agents for groups.
+   * Returns only the agent ID.
+   */
+  createAgentOnly: agentProcedure
+    .input(
+      z.object({
+        config: z.object({}).passthrough().optional(),
+        groupId: z.string(),
+      }),
+    )
+    .mutation(async ({ input, ctx }) => {
+      // Create the agent entity only (no session)
+      const agent = await ctx.agentModel.create(input.config ?? {});
+
+      // Add the agent to the group
+      await ctx.chatGroupModel.addAgentToGroup(input.groupId, agent.id);
+
+      return { agentId: agent.id };
+    }),
+
   deleteAgentFile: agentProcedure
     .input(
       z.object({

package/src/server/routers/lambda/agentGroup.ts

@@ -37,6 +37,45 @@ export const agentGroupRouter = router({
       return ctx.chatGroupModel.addAgentsToGroup(input.groupId, input.agentIds);
     }),
 
+  /**
+   * Batch create virtual agents and add them to an existing group.
+   * This is more efficient than calling createAgentOnly multiple times.
+   */
+  batchCreateAgentsInGroup: agentGroupProcedure
+    .input(
+      z.object({
+        agents: z.array(
+          insertAgentSchema
+            .omit({
+              chatConfig: true,
+              openingMessage: true,
+              openingQuestions: true,
+              tts: true,
+              userId: true,
+            })
+            .partial(),
+        ),
+        groupId: z.string(),
+      }),
+    )
+    .mutation(async ({ input, ctx }) => {
+      // Batch create virtual agents
+      const agentConfigs = input.agents.map((agent) => ({
+        ...agent,
+        plugins: agent.plugins as string[] | undefined,
+        tags: agent.tags as string[] | undefined,
+        virtual: true,
+      }));
+
+      const createdAgents = await ctx.agentModel.batchCreate(agentConfigs);
+      const agentIds = createdAgents.map((agent) => agent.id);
+
+      // Add all agents to the group
+      await ctx.chatGroupModel.addAgentsToGroup(input.groupId, agentIds);
+
+      return { agentIds, agents: createdAgents };
+    }),
+
   /**
    * Check agents before removal to identify virtual agents that will be permanently deleted.
    * This allows the frontend to show a confirmation dialog.