@lobehub/lobehub 2.0.0-next.137 → 2.0.0-next.139

package/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 # Changelog
 
+## [Version 2.0.0-next.139](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.138...v2.0.0-next.139)
+
+<sup>Released on **2025-12-01**</sup>
+
+#### 💄 Styles
+
+- **misc**: Update i18n.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### Styles
+
+- **misc**: Update i18n, closes [#10519](https://github.com/lobehub/lobe-chat/issues/10519) ([bd9a38c](https://github.com/lobehub/lobe-chat/commit/bd9a38c))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
+## [Version 2.0.0-next.138](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.137...v2.0.0-next.138)
+
+<sup>Released on **2025-11-30**</sup>
+
+#### 🐛 Bug Fixes
+
+- **conversation-flow**: Support optimistic update for activeBranchIndex.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's fixed
+
+- **conversation-flow**: Support optimistic update for activeBranchIndex, closes [#10517](https://github.com/lobehub/lobe-chat/issues/10517) ([9b5b234](https://github.com/lobehub/lobe-chat/commit/9b5b234))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ## [Version 2.0.0-next.137](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.136...v2.0.0-next.137)
 
 <sup>Released on **2025-11-30**</sup>

package/CLAUDE.md

@@ -55,6 +55,44 @@ see @.cursor/rules/typescript.mdc
 - **Dev**: Translate `locales/zh-CN/namespace.json` and `locales/en-US/namespace.json` locales file only for dev preview
 - DON'T run `pnpm i18n`, let CI auto handle it
 
+## Linear Issue Management
+
+When working with Linear issues:
+
+1. **Retrieve issue details** before starting work using `mcp__linear-server__get_issue`
+2. **Check for sub-issues**: If the issue has sub-issues, retrieve and review ALL sub-issues using `mcp__linear-server__list_issues` with `parentId` filter before starting work
+3. **Update issue status** when completing tasks using `mcp__linear-server__update_issue`
+4. **MUST add completion comment** using `mcp__linear-server__create_comment`
+
+### Completion Comment (REQUIRED)
+
+**Every time you complete an issue, you MUST add a comment summarizing the work done.** This is critical for:
+
+- Team visibility and knowledge sharing
+- Code review context
+- Future reference and debugging
+
+### IMPORTANT: Per-Issue Completion Rule
+
+**When working on multiple issues (e.g., parent issue with sub-issues), you MUST update status and add comment for EACH issue IMMEDIATELY after completing it.** Do NOT wait until all issues are done to update them in batch.
+
+**Workflow for EACH individual issue:**
+
+1. Complete the implementation for this specific issue
+2. Run type check: `bun run type-check`
+3. Run related tests if applicable
+4. **IMMEDIATELY** update issue status to "Done": `mcp__linear-server__update_issue`
+5. **IMMEDIATELY** add completion comment: `mcp__linear-server__create_comment`
+6. Only then move on to the next issue
+
+**❌ Wrong approach:**
+
+- Complete Issue A → Complete Issue B → Complete Issue C → Update all statuses → Add all comments
+
+**✅ Correct approach:**
+
+- Complete Issue A → Update A status → Add A comment → Complete Issue B → Update B status → Add B comment → ...
+
 ## Rules Index
 
 Some useful project rules are listed in @.cursor/rules/rules-index.mdc

package/changelog/v1.json

@@ -1,4 +1,18 @@
 [
+  {
+    "children": {
+      "improvements": [
+        "Update i18n."
+      ]
+    },
+    "date": "2025-12-01",
+    "version": "2.0.0-next.139"
+  },
+  {
+    "children": {},
+    "date": "2025-11-30",
+    "version": "2.0.0-next.138"
+  },
   {
     "children": {
       "fixes": [

package/locales/ar/modelProvider.json

@@ -190,6 +190,7 @@
   },
   "list": {
     "title": {
+      "custom": "لم يتم تفعيل مزود الخدمة المخصص",
       "disabled": "مزود الخدمة غير مفعل",
       "enabled": "مزود الخدمة مفعل"
     }
@@ -198,6 +199,7 @@
     "addCustomProvider": "إضافة مزود خدمة مخصص",
     "all": "الكل",
     "list": {
+      "custom": "المزود المخصص غير مفعل",
       "disabled": "غير مفعل",
       "disabledActions": {
         "sort": "طريقة الترتيب",

package/locales/bg-BG/modelProvider.json

@@ -190,6 +190,7 @@
   },
   "list": {
     "title": {
+      "custom": "Персонализираният доставчик на услуги не е активиран",
       "disabled": "Неактивен доставчик",
       "enabled": "Активен доставчик"
     }
@@ -198,6 +199,7 @@
     "addCustomProvider": "Добавяне на персонализиран доставчик",
     "all": "Всички",
     "list": {
+      "custom": "Персонализираният не е активиран",
       "disabled": "Неактивиран",
       "disabledActions": {
         "sort": "Сортиране",

package/locales/de-DE/modelProvider.json

@@ -190,6 +190,7 @@
   },
   "list": {
     "title": {
+      "custom": "Benutzerdefinierter Anbieter nicht aktiviert",
       "disabled": "Dienstanbieter nicht aktiviert",
       "enabled": "Dienstanbieter aktiviert"
     }
@@ -198,6 +199,7 @@
     "addCustomProvider": "Benutzerdefinierten Anbieter hinzufügen",
     "all": "Alle",
     "list": {
+      "custom": "Benutzerdefiniert nicht aktiviert",
       "disabled": "Nicht aktiviert",
       "disabledActions": {
         "sort": "Sortieroptionen",

package/locales/en-US/modelProvider.json

@@ -190,6 +190,7 @@
   },
   "list": {
     "title": {
+      "custom": "Custom provider not enabled",
       "disabled": "Disabled",
       "enabled": "Enabled"
     }
@@ -198,6 +199,7 @@
     "addCustomProvider": "Add Custom Provider",
     "all": "All",
     "list": {
+      "custom": "Custom not enabled",
       "disabled": "Disabled",
       "disabledActions": {
         "sort": "Sort By",

package/locales/es-ES/modelProvider.json

@@ -190,6 +190,7 @@
   },
   "list": {
     "title": {
+      "custom": "Proveedor personalizado no habilitado",
       "disabled": "Proveedor no habilitado",
       "enabled": "Proveedor habilitado"
     }
@@ -198,6 +199,7 @@
     "addCustomProvider": "Agregar proveedor personalizado",
     "all": "Todo",
     "list": {
+      "custom": "Personalización no habilitada",
       "disabled": "No habilitado",
       "disabledActions": {
         "sort": "Ordenar por",

package/locales/fa-IR/modelProvider.json

@@ -190,6 +190,7 @@
   },
   "list": {
     "title": {
+      "custom": "ارائه‌دهنده سفارشی فعال نشده است",
       "disabled": "سرویس‌دهنده غیرفعال",
       "enabled": "سرویس‌دهنده فعال"
     }
@@ -198,6 +199,7 @@
     "addCustomProvider": "اضافه کردن ارائه‌دهنده سفارشی",
     "all": "همه",
     "list": {
+      "custom": "سفارشی‌سازی فعال نشده است",
       "disabled": "غیرفعال",
       "disabledActions": {
         "sort": "نحوه مرتب‌سازی",

package/locales/fr-FR/modelProvider.json

@@ -190,6 +190,7 @@
   },
   "list": {
     "title": {
+      "custom": "Fournisseur personnalisé non activé",
       "disabled": "Fournisseur non activé",
       "enabled": "Fournisseur activé"
     }
@@ -198,6 +199,7 @@
     "addCustomProvider": "Ajouter un fournisseur personnalisé",
     "all": "Tout",
     "list": {
+      "custom": "Personnalisation non activée",
       "disabled": "Non activé",
       "disabledActions": {
         "sort": "Méthode de tri",

package/locales/it-IT/modelProvider.json

@@ -190,6 +190,7 @@
   },
   "list": {
     "title": {
+      "custom": "Fornitore personalizzato non abilitato",
       "disabled": "Fornitore non attivato",
       "enabled": "Fornitore attivato"
     }
@@ -198,6 +199,7 @@
     "addCustomProvider": "Aggiungi fornitore personalizzato",
     "all": "Tutti",
     "list": {
+      "custom": "Personalizzazione non abilitata",
       "disabled": "Non attivato",
       "disabledActions": {
         "sort": "Ordina per",

package/locales/ja-JP/modelProvider.json

@@ -190,6 +190,7 @@
   },
   "list": {
     "title": {
+      "custom": "カスタムプロバイダーは有効化されていません",
       "disabled": "サービスプロバイダーは無効です",
       "enabled": "サービスプロバイダーは有効です"
     }
@@ -198,6 +199,7 @@
     "addCustomProvider": "カスタムサービスプロバイダーを追加",
     "all": "すべて",
     "list": {
+      "custom": "カスタムは無効です",
       "disabled": "未使用",
       "disabledActions": {
         "sort": "並び替え方法",

package/locales/ko-KR/modelProvider.json

@@ -190,6 +190,7 @@
   },
   "list": {
     "title": {
+      "custom": "사용자 지정 서비스 제공자가 활성화되지 않았습니다",
       "disabled": "비활성화된 서비스 제공자",
       "enabled": "활성화된 서비스 제공자"
     }
@@ -198,6 +199,7 @@
     "addCustomProvider": "사용자 지정 서비스 제공자 추가",
     "all": "전체",
     "list": {
+      "custom": "사용자 지정이 활성화되지 않았습니다",
       "disabled": "비활성화됨",
       "disabledActions": {
         "sort": "정렬 방식",

package/locales/nl-NL/modelProvider.json

@@ -190,6 +190,7 @@
   },
   "list": {
     "title": {
+      "custom": "Aangepaste provider niet ingeschakeld",
       "disabled": "Dienstverlener niet ingeschakeld",
       "enabled": "Dienstverlener ingeschakeld"
     }
@@ -198,6 +199,7 @@
     "addCustomProvider": "Voeg aangepaste provider toe",
     "all": "Alles",
     "list": {
+      "custom": "Aangepaste provider niet ingeschakeld",
       "disabled": "Niet ingeschakeld",
       "disabledActions": {
         "sort": "Sorteervolgorde",

package/locales/pl-PL/modelProvider.json

@@ -190,6 +190,7 @@
   },
   "list": {
     "title": {
+      "custom": "Niestandardowy dostawca nie został włączony",
       "disabled": "Usługa nieaktywna",
       "enabled": "Usługa aktywna"
     }
@@ -198,6 +199,7 @@
     "addCustomProvider": "Dodaj niestandardowego dostawcę",
     "all": "Wszystko",
     "list": {
+      "custom": "Niestandardowy nie został włączony",
       "disabled": "Nieaktywny",
       "disabledActions": {
         "sort": "Sposób sortowania",

package/locales/pt-BR/modelProvider.json

@@ -190,6 +190,7 @@
   },
   "list": {
     "title": {
+      "custom": "Serviço personalizado não ativado",
       "disabled": "Fornecedor não habilitado",
       "enabled": "Fornecedor habilitado"
     }
@@ -198,6 +199,7 @@
     "addCustomProvider": "Adicionar Provedor Personalizado",
     "all": "Todos",
     "list": {
+      "custom": "Personalização não ativada",
       "disabled": "Desativado",
       "disabledActions": {
         "sort": "Ordenar por",

package/locales/ru-RU/modelProvider.json

@@ -190,6 +190,7 @@
   },
   "list": {
     "title": {
+      "custom": "Пользовательский поставщик не активирован",
       "disabled": "Поставщик не активирован",
       "enabled": "Поставщик активирован"
     }
@@ -198,6 +199,7 @@
     "addCustomProvider": "Добавить пользовательского провайдера",
     "all": "Все",
     "list": {
+      "custom": "Пользовательский не активирован",
       "disabled": "Не активирован",
       "disabledActions": {
         "sort": "Сортировка",

package/locales/tr-TR/modelProvider.json

@@ -190,6 +190,7 @@
   },
   "list": {
     "title": {
+      "custom": "Özel hizmet sağlayıcısı etkin değil",
       "disabled": "Hizmet sağlayıcı devre dışı",
       "enabled": "Hizmet sağlayıcı etkin"
     }
@@ -198,6 +199,7 @@
     "addCustomProvider": "Özel Hizmet Sağlayıcı Ekle",
     "all": "Tümü",
     "list": {
+      "custom": "Özel ayar etkin değil",
       "disabled": "Devre Dışı",
       "disabledActions": {
         "sort": "Sıralama Yöntemi",

package/locales/vi-VN/modelProvider.json

@@ -190,6 +190,7 @@
   },
   "list": {
     "title": {
+      "custom": "Chưa kích hoạt nhà cung cấp tùy chỉnh",
       "disabled": "Nhà cung cấp chưa được kích hoạt",
       "enabled": "Nhà cung cấp đã được kích hoạt"
     }
@@ -198,6 +199,7 @@
     "addCustomProvider": "Thêm nhà cung cấp tùy chỉnh",
     "all": "Tất cả",
     "list": {
+      "custom": "Tùy chỉnh chưa được kích hoạt",
       "disabled": "Chưa kích hoạt",
       "disabledActions": {
         "sort": "Cách sắp xếp",

package/locales/zh-CN/modelProvider.json

@@ -190,6 +190,7 @@
   },
   "list": {
     "title": {
+      "custom": "未启用自定义服务商",
       "disabled": "未启用服务商",
       "enabled": "已启用服务商"
     }
@@ -198,6 +199,7 @@
     "addCustomProvider": "添加自定义服务商",
     "all": "全部",
     "list": {
+      "custom": "自定义未启用",
       "disabled": "未启用",
       "disabledActions": {
         "sort": "排序方式",

package/locales/zh-TW/modelProvider.json

@@ -190,6 +190,7 @@
   },
   "list": {
     "title": {
+      "custom": "未啟用自訂服務商",
       "disabled": "未啟用服務商",
       "enabled": "已啟用服務商"
     }
@@ -198,6 +199,7 @@
     "addCustomProvider": "添加自定義服務商",
     "all": "全部",
     "list": {
+      "custom": "自訂未啟用",
       "disabled": "未啟用",
       "disabledActions": {
         "sort": "排序方式",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/lobehub",
-  "version": "2.0.0-next.137",
+  "version": "2.0.0-next.139",
   "description": "LobeHub - an open-source,comprehensive AI Agent framework that supports speech synthesis, multimodal, and extensible Function Call plugin system. Supports one-click free deployment of your private ChatGPT/LLM web application.",
   "keywords": [
     "framework",

package/packages/conversation-flow/src/transformation/BranchResolver.ts

@@ -11,16 +11,21 @@ import type { IdNode, Message } from '../types';
 export class BranchResolver {
   /**
    * Get active branch ID from IdNode structure (used in contextTree building)
+   * Returns undefined for optimistic updates when the branch hasn't been created yet
    */
-  getActiveBranchId(message: Message, idNode: IdNode): string {
+  getActiveBranchId(message: Message, idNode: IdNode): string | undefined {
     // Priority 1: Try to get from metadata.activeBranchIndex (index-based)
     const activeBranchIndex = (message.metadata as any)?.activeBranchIndex;
-    if (
-      typeof activeBranchIndex === 'number' &&
-      activeBranchIndex >= 0 &&
-      activeBranchIndex < idNode.children.length
-    ) {
-      return idNode.children[activeBranchIndex].id;
+    if (typeof activeBranchIndex === 'number' && activeBranchIndex >= 0) {
+      // If index is within bounds, return the branch at that index
+      if (activeBranchIndex < idNode.children.length) {
+        return idNode.children[activeBranchIndex].id;
+      }
+      // Optimistic update: index === children.length means branch is being created
+      if (activeBranchIndex === idNode.children.length) {
+        return undefined;
+      }
+      // Invalid index (> children.length), ignore and continue to other strategies
     }
 
     // Priority 2: Infer from which branch has children
@@ -36,20 +41,25 @@ export class BranchResolver {
 
   /**
    * Get active branch ID from flat list (used in flatList building)
+   * Returns undefined for optimistic updates when the branch hasn't been created yet
    */
   getActiveBranchIdFromMetadata(
     message: Message,
     childIds: string[],
     childrenMap: Map<string | null, string[]>,
-  ): string {
+  ): string | undefined {
     // Priority 1: Try to get from metadata.activeBranchIndex (index-based)
     const activeBranchIndex = (message.metadata as any)?.activeBranchIndex;
-    if (
-      typeof activeBranchIndex === 'number' &&
-      activeBranchIndex >= 0 &&
-      activeBranchIndex < childIds.length
-    ) {
-      return childIds[activeBranchIndex];
+    if (typeof activeBranchIndex === 'number' && activeBranchIndex >= 0) {
+      // If index is within bounds, return the branch at that index
+      if (activeBranchIndex < childIds.length) {
+        return childIds[activeBranchIndex];
+      }
+      // Optimistic update: index === childIds.length means branch is being created
+      if (activeBranchIndex === childIds.length) {
+        return undefined;
+      }
+      // Invalid index (> childIds.length), ignore and continue to other strategies
     }
 
     // Priority 2: Infer from which child has descendants

package/packages/conversation-flow/src/transformation/ContextTreeBuilder.ts

@@ -185,7 +185,12 @@ export class ContextTreeBuilder {
    */
   private createBranchNode(message: Message, idNode: IdNode): BranchNode {
     const activeBranchId = this.branchResolver.getActiveBranchId(message, idNode);
-    const activeBranchIndex = idNode.children.findIndex((child) => child.id === activeBranchId);
+
+    // For optimistic update (activeBranchId is undefined), use children.length as the index
+    // This indicates the branch is being created but doesn't exist yet
+    const activeBranchIndex = activeBranchId
+      ? idNode.children.findIndex((child) => child.id === activeBranchId)
+      : idNode.children.length;
 
     // Each branch is a tree starting from that child
     const branches = idNode.children.map((child) => {

package/packages/conversation-flow/src/transformation/FlatListBuilder.ts

@@ -165,6 +165,15 @@ export class FlatListBuilder {
           childMessages,
           this.childrenMap,
         );
+
+        // Optimistic update: activeBranchId is undefined when branch is being created
+        // In this case, just add user message without branch info and continue
+        if (!activeBranchId) {
+          flatList.push(message);
+          processedIds.add(message.id);
+          continue;
+        }
+
         const activeBranchIndex = childMessages.indexOf(activeBranchId);
         const userWithBranches = this.createUserMessageWithBranches(
           message,
@@ -248,6 +257,12 @@ export class FlatListBuilder {
         flatList.push(message);
         processedIds.add(message.id);
 
+        // Optimistic update: activeBranchId is undefined when branch is being created
+        // In this case, just add assistant message and continue (no active branch yet)
+        if (!activeBranchId) {
+          continue;
+        }
+
         // Continue with active branch and process its message
         const activeBranchMsg = this.messageMap.get(activeBranchId);
         if (activeBranchMsg) {

package/packages/conversation-flow/src/transformation/__tests__/BranchResolver.test.ts

@@ -71,13 +71,13 @@ describe('BranchResolver', () => {
       expect(resolver.getActiveBranchId(message, idNode)).toBe('msg-2');
     });
 
-    it('should ignore invalid activeBranchIndex', () => {
+    it('should return undefined for optimistic update (activeBranchIndex === children.length)', () => {
       const message: Message = {
         content: 'test',
         createdAt: 0,
         id: 'msg-1',
         meta: {},
-        metadata: { activeBranchIndex: 5 }, // out of bounds
+        metadata: { activeBranchIndex: 2 }, // index = children.length (optimistic update)
         role: 'user',
         updatedAt: 0,
       };
@@ -90,7 +90,31 @@ describe('BranchResolver', () => {
         id: 'msg-1',
       };
 
-      // Should default to first branch
+      // When activeBranchIndex === children.length, it's an optimistic update
+      // The branch hasn't been created yet, so return undefined
+      expect(resolver.getActiveBranchId(message, idNode)).toBeUndefined();
+    });
+
+    it('should ignore activeBranchIndex when it exceeds optimistic update range', () => {
+      const message: Message = {
+        content: 'test',
+        createdAt: 0,
+        id: 'msg-1',
+        meta: {},
+        metadata: { activeBranchIndex: 5 }, // > children.length (invalid)
+        role: 'user',
+        updatedAt: 0,
+      };
+
+      const idNode: IdNode = {
+        children: [
+          { children: [], id: 'msg-2' },
+          { children: [], id: 'msg-3' },
+        ],
+        id: 'msg-1',
+      };
+
+      // activeBranchIndex > children.length should be ignored, fallback to default
       expect(resolver.getActiveBranchId(message, idNode)).toBe('msg-2');
     });
   });
@@ -147,5 +171,44 @@ describe('BranchResolver', () => {
 
       expect(resolver.getActiveBranchIdFromMetadata(message, childIds, childrenMap)).toBe('msg-2');
     });
+
+    it('should return undefined for optimistic update (activeBranchIndex === childIds.length)', () => {
+      const message: Message = {
+        content: 'test',
+        createdAt: 0,
+        id: 'msg-1',
+        meta: {},
+        metadata: { activeBranchIndex: 2 }, // index = childIds.length (optimistic update)
+        role: 'user',
+        updatedAt: 0,
+      };
+
+      const childIds = ['msg-2', 'msg-3'];
+      const childrenMap = new Map<string | null, string[]>();
+
+      // When activeBranchIndex === childIds.length, it's an optimistic update
+      // The branch hasn't been created yet, so return undefined
+      expect(
+        resolver.getActiveBranchIdFromMetadata(message, childIds, childrenMap),
+      ).toBeUndefined();
+    });
+
+    it('should ignore activeBranchIndex when it exceeds optimistic update range', () => {
+      const message: Message = {
+        content: 'test',
+        createdAt: 0,
+        id: 'msg-1',
+        meta: {},
+        metadata: { activeBranchIndex: 5 }, // > childIds.length (invalid)
+        role: 'user',
+        updatedAt: 0,
+      };
+
+      const childIds = ['msg-2', 'msg-3'];
+      const childrenMap = new Map<string | null, string[]>();
+
+      // activeBranchIndex > childIds.length should be ignored, fallback to default
+      expect(resolver.getActiveBranchIdFromMetadata(message, childIds, childrenMap)).toBe('msg-2');
+    });
   });
 });