@lobehub/lobehub 2.0.0-next.266 → 2.0.0-next.268

package/src/locales/default/metadata.ts

@@ -3,7 +3,7 @@ export default {
   'changelog.title': 'Changelog',
   'chat.description':
     '{{appName}} brings you the best UI experience for ChatGPT, Claude, Gemini, and OLLaMA.',
-  'chat.title': '{{appName}} · For Collaborative Agents',
+  'chat.title': '{{appName}} · Where Agents Collaborate',
   'discover.assistants.description':
     'Content, Q&A, images, video, voice, workflows—browse and add Agents from the Community.',
   'discover.assistants.title': 'Agent Community',
@@ -30,5 +30,5 @@ export default {
   'plugins.title': 'Skill Community',
   'welcome.description':
     '{{appName}} brings you the best UI experience for ChatGPT, Claude, Gemini, and OLLaMA.',
-  'welcome.title': 'Welcome to {{appName}} · For Collaborative Agents',
+  'welcome.title': 'Welcome to {{appName}} · Where Agents Collaborate',
 };

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

@@ -9,27 +9,27 @@ const log = debug('lobe-server:agent-runtime:coordinator');
 
 export interface AgentRuntimeCoordinatorOptions {
   /**
-   * 自定义状态管理器实现
-   * 默认根据 Redis 可用性自动选择实现
+   * Custom state manager implementation
+   * Defaults to automatic selection based on Redis availability
    */
   stateManager?: IAgentStateManager;
   /**
-   * 自定义流式事件管理器实现
-   * 默认根据 Redis 可用性自动选择实现
+   * Custom stream event manager implementation
+   * Defaults to automatic selection based on Redis availability
    */
   streamEventManager?: IStreamEventManager;
 }
 
 /**
  * Agent Runtime Coordinator
- * 协调 AgentStateManager 和 StreamEventManager 的操作
- * 负责在状态变更时发送相应的事件
+ * Coordinates operations between AgentStateManager and StreamEventManager
+ * Responsible for sending corresponding events when state changes occur
  *
- * 默认行为：
- * - Redis 可用时使用 Redis 实现
- * - Redis 不可用时自动回退到内存实现（本地开发模式）
+ * Default behavior:
+ * - Uses Redis implementation when Redis is available
+ * - Automatically falls back to in-memory implementation when Redis is unavailable (local development mode)
  *
- * 支持依赖注入，可以传入自定义实现
+ * Supports dependency injection, allowing custom implementations to be passed in
  */
 export class AgentRuntimeCoordinator {
   private stateManager: IAgentStateManager;
@@ -41,7 +41,7 @@ export class AgentRuntimeCoordinator {
   }
 
   /**
-   * 创建新的 Agent 操作并发送初始化事件
+   * Create a new Agent operation and send initialization event
    */
   async createAgentOperation(
     operationId: string,
@@ -52,14 +52,14 @@ export class AgentRuntimeCoordinator {
     },
   ): Promise<void> {
     try {
-      // 创建操作元数据
+      // Create operation metadata
       await this.stateManager.createOperationMetadata(operationId, data);
 
-      // 获取创建的元数据
+      // Get the created metadata
       const metadata = await this.stateManager.getOperationMetadata(operationId);
 
       if (metadata) {
-        // 发送 agent runtime init 事件
+        // Send agent runtime init event
         await this.streamEventManager.publishAgentRuntimeInit(operationId, metadata);
         log('[%s] Agent operation created and initialized', operationId);
       }
@@ -70,16 +70,16 @@ export class AgentRuntimeCoordinator {
   }
 
   /**
-   * 保存 Agent 状态并处理相应事件
+   * Save Agent state and handle corresponding events
    */
   async saveAgentState(operationId: string, state: AgentState): Promise<void> {
     try {
       const previousState = await this.stateManager.loadAgentState(operationId);
 
-      // 保存状态
+      // Save state
       await this.stateManager.saveAgentState(operationId, state);
 
-      // 如果状态变为 done，发送 agent runtime end 事件
+      // If status changes to done, send agent runtime end event
       if (state.status === 'done' && previousState?.status !== 'done') {
         await this.streamEventManager.publishAgentRuntimeEnd(operationId, state.stepCount, state);
         log('[%s] Agent runtime completed', operationId);
@@ -91,18 +91,18 @@ export class AgentRuntimeCoordinator {
   }
 
   /**
-   * 保存步骤结果并处理相应事件
+   * Save step result and handle corresponding events
    */
   async saveStepResult(operationId: string, stepResult: StepResult): Promise<void> {
     try {
-      // 获取之前的状态用于检测状态变化
+      // Get previous state for detecting state changes
       const previousState = await this.stateManager.loadAgentState(operationId);
 
-      // 保存步骤结果
+      // Save step result
       await this.stateManager.saveStepResult(operationId, stepResult);
 
-      // 如果状态变为 done，发送 agent_runtime_end 事件
-      // 这确保 agent_runtime_end 在所有步骤事件之后发送
+      // If status changes to done, send agent_runtime_end event
+      // This ensures agent_runtime_end is sent after all step events
       if (stepResult.newState.status === 'done' && previousState?.status !== 'done') {
         await this.streamEventManager.publishAgentRuntimeEnd(
           operationId,
@@ -118,28 +118,28 @@ export class AgentRuntimeCoordinator {
   }
 
   /**
-   * 获取 Agent 状态
+   * Get Agent state
    */
   async loadAgentState(operationId: string): Promise<AgentState | null> {
     return this.stateManager.loadAgentState(operationId);
   }
 
   /**
-   * 获取操作元数据
+   * Get operation metadata
    */
   async getOperationMetadata(operationId: string): Promise<AgentOperationMetadata | null> {
     return this.stateManager.getOperationMetadata(operationId);
   }
 
   /**
-   * 获取执行历史
+   * Get execution history
    */
   async getExecutionHistory(operationId: string, limit?: number): Promise<any[]> {
     return this.stateManager.getExecutionHistory(operationId, limit);
   }
 
   /**
-   * 删除 Agent 操作
+   * Delete Agent operation
    */
   async deleteAgentOperation(operationId: string): Promise<void> {
     try {
@@ -155,14 +155,14 @@ export class AgentRuntimeCoordinator {
   }
 
   /**
-   * 获取活跃操作
+   * Get active operations
    */
   async getActiveOperations(): Promise<string[]> {
     return this.stateManager.getActiveOperations();
   }
 
   /**
-   * 获取统计信息
+   * Get statistics
    */
   async getStats(): Promise<{
     activeOperations: number;
@@ -174,14 +174,14 @@ export class AgentRuntimeCoordinator {
   }
 
   /**
-   * 清理过期操作
+   * Clean up expired operations
    */
   async cleanupExpiredOperations(): Promise<number> {
     return this.stateManager.cleanupExpiredOperations();
   }
 
   /**
-   * 关闭连接
+   * Close connections
    */
   async disconnect(): Promise<void> {
     await Promise.all([this.stateManager.disconnect(), this.streamEventManager.disconnect()]);

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

@@ -42,7 +42,7 @@ export class AgentStateManager {
   }
 
   /**
-   * 保存 Agent 状态
+   * Save Agent state
    */
   async saveAgentState(operationId: string, state: AgentState): Promise<void> {
     const stateKey = `${this.STATE_PREFIX}:${operationId}`;
@@ -51,7 +51,7 @@ export class AgentStateManager {
       const serializedState = JSON.stringify(state);
       await this.redis.setex(stateKey, this.DEFAULT_TTL, serializedState);
 
-      // 更新元数据
+      // Update metadata
       await this.updateOperationMetadata(operationId, {
         lastActiveAt: new Date().toISOString(),
         status: state.status,
@@ -59,7 +59,7 @@ export class AgentStateManager {
         totalSteps: state.stepCount,
       });
 
-      // 状态变更事件通过 saveStepResult 中的 events 数组记录
+      // State change events are recorded through the events array in saveStepResult
 
       log('[%s] Saved state for step %d', operationId, state.stepCount);
     } catch (error) {
@@ -69,7 +69,7 @@ export class AgentStateManager {
   }
 
   /**
-   * 加载 Agent 状态
+   * Load Agent state
    */
   async loadAgentState(operationId: string): Promise<AgentState | null> {
     const stateKey = `${this.STATE_PREFIX}:${operationId}`;
@@ -92,17 +92,17 @@ export class AgentStateManager {
   }
 
   /**
-   * 保存步骤执行结果
+   * Save step execution result
    */
   async saveStepResult(operationId: string, stepResult: StepResult): Promise<void> {
     const pipeline = this.redis.multi();
 
     try {
-      // 保存最新状态
+      // Save latest state
       const stateKey = `${this.STATE_PREFIX}:${operationId}`;
       pipeline.setex(stateKey, this.DEFAULT_TTL, JSON.stringify(stepResult.newState));
 
-      // 保存步骤历史
+      // Save step history
       const stepsKey = `${this.STEPS_PREFIX}:${operationId}`;
       const stepData = {
         context: stepResult.nextContext,
@@ -114,19 +114,19 @@ export class AgentStateManager {
       };
 
       pipeline.lpush(stepsKey, JSON.stringify(stepData));
-      pipeline.ltrim(stepsKey, 0, 199); // 保留最近 200 步
+      pipeline.ltrim(stepsKey, 0, 199); // Keep most recent 200 steps
       pipeline.expire(stepsKey, this.DEFAULT_TTL);
 
-      // 保存步骤的事件序列到 agent_runtime_events
+      // Save step event sequence to agent_runtime_events
       if (stepResult.events && stepResult.events.length > 0) {
         const eventsKey = `${this.EVENTS_PREFIX}:${operationId}`;
 
         pipeline.lpush(eventsKey, JSON.stringify(stepResult.events));
-        pipeline.ltrim(eventsKey, 0, 199); // 保留最近 200 步的事件
+        pipeline.ltrim(eventsKey, 0, 199); // Keep events from most recent 200 steps
         pipeline.expire(eventsKey, this.DEFAULT_TTL);
       }
 
-      // 更新操作元数据
+      // Update operation metadata
       const metaKey = `${this.METADATA_PREFIX}:${operationId}`;
       const metadata: Partial<AgentOperationMetadata> = {
         lastActiveAt: new Date().toISOString(),
@@ -152,14 +152,14 @@ export class AgentStateManager {
   }
 
   /**
-   * 获取执行历史
+   * Get execution history
    */
   async getExecutionHistory(operationId: string, limit: number = 50): Promise<any[]> {
     const stepsKey = `${this.STEPS_PREFIX}:${operationId}`;
 
     try {
       const history = await this.redis.lrange(stepsKey, 0, limit - 1);
-      return history.map((item) => JSON.parse(item)).reverse(); // 最早的在前面
+      return history.map((item) => JSON.parse(item)).reverse(); // Earliest first
     } catch (error) {
       console.error('Failed to get execution history:', error);
       return [];
@@ -167,7 +167,7 @@ export class AgentStateManager {
   }
 
   /**
-   * 获取操作元数据
+   * Get operation metadata
    */
   async getOperationMetadata(operationId: string): Promise<AgentOperationMetadata | null> {
     const metaKey = `${this.METADATA_PREFIX}:${operationId}`;
@@ -198,7 +198,7 @@ export class AgentStateManager {
   }
 
   /**
-   * 创建新的操作元数据
+   * Create new operation metadata
    */
   async createOperationMetadata(
     operationId: string,
@@ -222,7 +222,7 @@ export class AgentStateManager {
         userId: data.userId,
       };
 
-      // 序列化复杂对象
+      // Serialize complex objects
       const redisData: Record<string, string> = {
         createdAt: metadata.createdAt,
         lastActiveAt: metadata.lastActiveAt,
@@ -247,7 +247,7 @@ export class AgentStateManager {
   }
 
   /**
-   * 更新操作元数据
+   * Update operation metadata
    */
   private async updateOperationMetadata(
     operationId: string,
@@ -278,7 +278,7 @@ export class AgentStateManager {
   }
 
   /**
-   * 删除 Agent 操作的所有数据
+   * Delete all data for Agent operation
    */
   async deleteAgentOperation(operationId: string): Promise<void> {
     const keys = [
@@ -298,7 +298,7 @@ export class AgentStateManager {
   }
 
   /**
-   * 获取所有活跃操作
+   * Get all active operations
    */
   async getActiveOperations(): Promise<string[]> {
     try {
@@ -312,7 +312,7 @@ export class AgentStateManager {
   }
 
   /**
-   * 清理过期的操作数据
+   * Clean up expired operation data
    */
   async cleanupExpiredOperations(): Promise<number> {
     try {
@@ -327,7 +327,7 @@ export class AgentStateManager {
           const now = Date.now();
           const hoursSinceActive = (now - lastActiveTime) / (1000 * 60 * 60);
 
-          // 清理超过 2 小时未活跃的操作
+          // Clean up operations inactive for more than 2 hours
           if (hoursSinceActive > 2) {
             await this.deleteAgentOperation(operationId);
             cleanedCount++;
@@ -344,7 +344,7 @@ export class AgentStateManager {
   }
 
   /**
-   * 获取统计信息
+   * Get statistics
    */
   async getStats(): Promise<{
     activeOperations: number;
@@ -397,7 +397,7 @@ export class AgentStateManager {
   }
 
   /**
-   * 关闭 Redis 连接
+   * Close Redis connection
    */
   async disconnect(): Promise<void> {
     await this.redis.quit();

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

@@ -8,7 +8,7 @@ const log = debug('lobe-server:agent-runtime:in-memory-state-manager');
 
 /**
  * In-Memory Agent State Manager
- * 内存实现，用于测试和本地开发环境
+ * In-memory implementation for testing and local development environments
  */
 export class InMemoryAgentStateManager implements IAgentStateManager {
   private states: Map<string, AgentState> = new Map();
@@ -17,10 +17,10 @@ export class InMemoryAgentStateManager implements IAgentStateManager {
   private events: Map<string, any[][]> = new Map();
 
   async saveAgentState(operationId: string, state: AgentState): Promise<void> {
-    // 深拷贝以避免引用问题
+    // Deep clone to avoid reference issues
     this.states.set(operationId, structuredClone(state));
 
-    // 更新元数据
+    // Update metadata
     const existingMeta = this.metadata.get(operationId);
     if (existingMeta) {
       existingMeta.lastActiveAt = new Date().toISOString();
@@ -39,15 +39,15 @@ export class InMemoryAgentStateManager implements IAgentStateManager {
     }
 
     log('[%s] Loaded state (step %d)', operationId, state.stepCount);
-    // 返回深拷贝以避免外部修改影响内部状态
+    // Return deep clone to prevent external modifications from affecting internal state
     return structuredClone(state);
   }
 
   async saveStepResult(operationId: string, stepResult: StepResult): Promise<void> {
-    // 保存最新状态
+    // Save latest state
     this.states.set(operationId, structuredClone(stepResult.newState));
 
-    // 保存步骤历史
+    // Save step history
     let stepHistory = this.steps.get(operationId);
     if (!stepHistory) {
       stepHistory = [];
@@ -63,14 +63,14 @@ export class InMemoryAgentStateManager implements IAgentStateManager {
       timestamp: Date.now(),
     };
 
-    // 在开头插入（最新的在前面）
+    // Insert at beginning (newest first)
     stepHistory.unshift(stepData);
-    // 保留最近 200 步
+    // Keep most recent 200 steps
     if (stepHistory.length > 200) {
       stepHistory.length = 200;
     }
 
-    // 保存步骤的事件序列
+    // Save step event sequence
     if (stepResult.events && stepResult.events.length > 0) {
       let eventHistory = this.events.get(operationId);
       if (!eventHistory) {
@@ -83,7 +83,7 @@ export class InMemoryAgentStateManager implements IAgentStateManager {
       }
     }
 
-    // 更新操作元数据
+    // Update operation metadata
     const existingMeta = this.metadata.get(operationId);
     if (existingMeta) {
       existingMeta.lastActiveAt = new Date().toISOString();
@@ -106,7 +106,7 @@ export class InMemoryAgentStateManager implements IAgentStateManager {
       return [];
     }
 
-    // 返回反转后的数组（最早的在前面）
+    // Return reversed array (earliest first)
     return history.slice(0, limit).reverse();
   }
 
@@ -161,7 +161,7 @@ export class InMemoryAgentStateManager implements IAgentStateManager {
         const now = Date.now();
         const hoursSinceActive = (now - lastActiveTime) / (1000 * 60 * 60);
 
-        // 清理超过 1 小时未活跃的操作
+        // Clean up operations inactive for more than 1 hour
         if (hoursSinceActive > 1) {
           await this.deleteAgentOperation(operationId);
           cleanedCount++;
@@ -214,12 +214,12 @@ export class InMemoryAgentStateManager implements IAgentStateManager {
   }
 
   async disconnect(): Promise<void> {
-    // 内存实现无需断开连接
+    // In-memory implementation doesn't need to disconnect
     log('InMemoryAgentStateManager disconnected');
   }
 
   /**
-   * 清空所有数据（用于测试）
+   * Clear all data (for testing)
    */
   clear(): void {
     this.states.clear();
@@ -230,7 +230,7 @@ export class InMemoryAgentStateManager implements IAgentStateManager {
   }
 
   /**
-   * 获取事件历史（用于测试验证）
+   * Get event history (for test verification)
    */
   getEventHistory(operationId: string): any[][] {
     return this.events.get(operationId) ?? [];
@@ -238,6 +238,6 @@ export class InMemoryAgentStateManager implements IAgentStateManager {
 }
 
 /**
- * 单例实例，用于测试和本地开发环境
+ * Singleton instance for testing and local development environments
  */
 export const inMemoryAgentStateManager = new InMemoryAgentStateManager();

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

@@ -9,7 +9,7 @@ type EventCallback = (events: StreamEvent[]) => void;
 
 /**
  * In-Memory Stream Event Manager
- * 内存实现，用于测试和本地开发环境
+ * In-memory implementation for testing and local development environments
  */
 export class InMemoryStreamEventManager implements IStreamEventManager {
   private streams: Map<string, StreamEvent[]> = new Map();
@@ -34,7 +34,7 @@ export class InMemoryStreamEventManager implements IStreamEventManager {
       timestamp: Date.now(),
     };
 
-    // 获取或创建 stream
+    // Get or create stream
     let stream = this.streams.get(operationId);
     if (!stream) {
       stream = [];
@@ -43,14 +43,14 @@ export class InMemoryStreamEventManager implements IStreamEventManager {
 
     stream.push(eventData);
 
-    // 限制流长度，防止内存溢出
+    // Limit stream length to prevent memory overflow
     if (stream.length > 1000) {
       stream.shift();
     }
 
     log('Published event %s for operation %s:%d', eventData.type, operationId, eventData.stepIndex);
 
-    // 通知订阅者
+    // Notify subscribers
     const callbacks = this.subscribers.get(operationId);
     if (callbacks) {
       for (const callback of callbacks) {
@@ -111,7 +111,7 @@ export class InMemoryStreamEventManager implements IStreamEventManager {
       return [];
     }
 
-    // 返回最近的 count 条事件（倒序）
+    // Return most recent count events (in reverse order)
     return stream.slice(-count).reverse();
   }
 
@@ -126,12 +126,12 @@ export class InMemoryStreamEventManager implements IStreamEventManager {
   }
 
   async disconnect(): Promise<void> {
-    // 内存实现无需断开连接
+    // In-memory implementation doesn't need to disconnect
     log('InMemoryStreamEventManager disconnected');
   }
 
   /**
-   * 订阅流式事件（用于测试）
+   * Subscribe to stream events (for testing)
    */
   subscribe(operationId: string, callback: EventCallback): () => void {
     let callbacks = this.subscribers.get(operationId);
@@ -141,7 +141,7 @@ export class InMemoryStreamEventManager implements IStreamEventManager {
     }
     callbacks.push(callback);
 
-    // 返回取消订阅函数
+    // Return unsubscribe function
     return () => {
       const cbs = this.subscribers.get(operationId);
       if (cbs) {
@@ -154,7 +154,7 @@ export class InMemoryStreamEventManager implements IStreamEventManager {
   }
 
   /**
-   * 清空所有数据（用于测试）
+   * Clear all data (for testing)
    */
   clear(): void {
     this.streams.clear();
@@ -164,14 +164,14 @@ export class InMemoryStreamEventManager implements IStreamEventManager {
   }
 
   /**
-   * 获取所有事件（用于测试验证）
+   * Get all events (for test verification)
    */
   getAllEvents(operationId: string): StreamEvent[] {
     return this.streams.get(operationId) ?? [];
   }
 
   /**
-   * 等待特定类型的事件（用于测试）
+   * Wait for a specific event type (for testing)
    */
   waitForEvent(
     operationId: string,
@@ -196,7 +196,7 @@ export class InMemoryStreamEventManager implements IStreamEventManager {
         }
       });
 
-      // 检查已有事件
+      // Check existing events
       const existingEvents = this.streams.get(operationId) ?? [];
       for (const event of existingEvents) {
         if (event.type === eventType) {
@@ -211,6 +211,6 @@ export class InMemoryStreamEventManager implements IStreamEventManager {
 }
 
 /**
- * 单例实例，用于测试和本地开发环境
+ * Singleton instance for testing and local development environments
  */
 export const inMemoryStreamEventManager = new InMemoryStreamEventManager();

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

@@ -43,8 +43,8 @@ export const createRuntimeExecutors = (
   ctx: RuntimeExecutorContext,
 ): Partial<Record<AgentInstruction['type'], InstructionExecutor>> => ({
   /**
-   * 创建流式 LLM 执行器
-   * 集成 Agent Runtime 和流式事件发布
+   * Create streaming LLM executor
+   * Integrates Agent Runtime and stream event publishing
    */
   call_llm: async (instruction, state) => {
     const { payload } = instruction as Extract<AgentInstruction, { type: 'call_llm' }>;