@lobehub/lobehub 2.0.0-next.337 → 2.0.0-next.339

package/packages/const/src/klavis.ts

@@ -2,12 +2,22 @@ import { IconType, SiCaldotcom, SiGithub } from '@icons-pack/react-simple-icons'
 import { Klavis } from 'klavis';
 
 export interface KlavisServerType {
+  /**
+   * Author/Developer of the integration
+   */
+  author: string;
+  /**
+   * Author's website URL
+   */
+  authorUrl?: string;
+  description: string;
   icon: string | IconType;
   /**
    * Identifier used for storage in database (e.g., 'google-calendar')
    * Format: lowercase, spaces replaced with hyphens
    */
   identifier: string;
+  introduction: string;
   label: string;
   /**
    * Server name used to call Klavis API (e.g., 'Google Calendar')
@@ -17,141 +27,275 @@ export interface KlavisServerType {
 
 export const KLAVIS_SERVER_TYPES: KlavisServerType[] = [
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description: 'Gmail is a free email service provided by Google',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/gmail.svg',
     identifier: 'gmail',
+    introduction:
+      'Bring the power of Gmail directly into your AI assistant. Read, compose, and send emails, search your inbox, manage labels, and organize your communications—all through natural conversation.',
     label: 'Gmail',
     serverName: Klavis.McpServerName.Gmail,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description: 'Google Calendar is a time-management and scheduling calendar service',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/googlecalendar.svg',
     identifier: 'google-calendar',
+    introduction:
+      'Integrate Google Calendar to view, create, and manage your events seamlessly. Schedule meetings, set reminders, check availability, and coordinate your time—all through natural language commands.',
     label: 'Google Calendar',
     serverName: Klavis.McpServerName.GoogleCalendar,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description: 'Notion is a collaborative productivity and note-taking application',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/notion.svg',
     identifier: 'notion',
+    introduction:
+      'Connect to Notion to access and manage your workspace. Create pages, search content, update databases, and organize your knowledge base—all through natural conversation with your AI assistant.',
     label: 'Notion',
     serverName: Klavis.McpServerName.Notion,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description:
+      'Airtable is a cloud-based database and spreadsheet platform that combines the flexibility of a spreadsheet with the power of a database, enabling teams to organize, track, and collaborate on projects with customizable views and powerful automation features',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/airtable.svg',
     identifier: 'airtable',
+    introduction:
+      'Integrate with Airtable to manage your databases and workflows. Query records, create entries, update data, and automate operations with customizable views and powerful tracking features.',
     label: 'Airtable',
     serverName: Klavis.McpServerName.Airtable,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description:
+      'Google Sheets is a web-based spreadsheet application that allows users to create, edit, and collaborate on spreadsheets online',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/googlesheets.svg',
     identifier: 'google-sheets',
+    introduction:
+      'Connect to Google Sheets to read, write, and analyze spreadsheet data. Perform calculations, generate reports, create charts, and manage tabular data collaboratively with AI assistance.',
     label: 'Google Sheets',
     serverName: Klavis.McpServerName.GoogleSheets,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description:
+      'Google Docs is a word processor included as part of the free, web-based Google Docs Editors suite',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/googledocs.svg',
     identifier: 'google-docs',
+    introduction:
+      'Integrate with Google Docs to create, edit, and manage documents. Write content, format text, collaborate in real-time, and access your documents through natural conversation.',
     label: 'Google Docs',
     serverName: Klavis.McpServerName.GoogleDocs,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description: 'Enhanced GitHub MCP Server',
     icon: SiGithub,
     identifier: 'github',
+    introduction:
+      'Connect to GitHub to manage repositories, issues, pull requests, and code. Search code, review changes, create branches, and collaborate on software development projects through conversational AI.',
     label: 'GitHub',
     serverName: Klavis.McpServerName.Github,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description: 'Supabase official MCP Server',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/supabase.svg',
     identifier: 'supabase',
+    introduction:
+      'Integrate with Supabase to manage your database and backend services. Query data, manage authentication, handle storage, and interact with your application backend through natural conversation.',
     label: 'Supabase',
     serverName: Klavis.McpServerName.Supabase,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description: 'Google Drive is a cloud storage service',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/googledrive.svg',
     identifier: 'google-drive',
+    introduction:
+      'Connect to Google Drive to access, organize, and manage your files. Search documents, upload files, share content, and navigate your cloud storage efficiently through AI assistance.',
     label: 'Google Drive',
     serverName: Klavis.McpServerName.GoogleDrive,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description:
+      'Slack is a messaging app for business that connects people to the information they need',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/slack.svg',
     identifier: 'slack',
+    introduction:
+      'Integrate with Slack to send messages, search conversations, and manage channels. Connect with your team, automate communication workflows, and access workspace information through natural language.',
     label: 'Slack',
     serverName: Klavis.McpServerName.Slack,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description: 'Confluence is a team workspace where knowledge and collaboration meet',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/confluence.svg',
     identifier: 'confluence',
+    introduction:
+      'Connect to Confluence to access and manage team documentation. Search pages, create content, organize spaces, and build your knowledge base through conversational AI assistance.',
     label: 'Confluence',
     serverName: Klavis.McpServerName.Confluence,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description: 'Jira is a project management and issue tracking tool developed by Atlassian',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/jira.svg',
     identifier: 'jira',
+    introduction:
+      'Integrate with Jira to manage issues, track progress, and organize sprints. Create tickets, update statuses, query project data, and streamline your development workflow through natural conversation.',
     label: 'Jira',
     serverName: Klavis.McpServerName.Jira,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description:
+      'ClickUp is a comprehensive project management and productivity platform that helps teams organize tasks, manage projects, and collaborate effectively with customizable workflows and powerful tracking features',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/clickup.svg',
     identifier: 'clickup',
+    introduction:
+      'Connect to ClickUp to manage tasks, track projects, and organize your work. Create tasks, update statuses, manage custom workflows, and collaborate with your team through natural language commands.',
     label: 'ClickUp',
     serverName: Klavis.McpServerName.Clickup,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description:
+      'Complete file management solution for Dropbox cloud storage. Upload, download, organize files and folders, manage sharing and collaboration, handle file versions, create file requests, and perform batch operations on your Dropbox files and folders',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/dropbox.svg',
     identifier: 'dropbox',
+    introduction:
+      'Integrate with Dropbox to access and manage your files. Upload, download, share files, manage folders, handle file versions, and organize your cloud storage through conversational AI.',
     label: 'Dropbox',
     serverName: Klavis.McpServerName.Dropbox,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description: 'Figma is a collaborative interface design tool for web and mobile applications.',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/figma.svg',
     identifier: 'figma',
+    introduction:
+      'Connect to Figma to access design files and collaborate on projects. View designs, export assets, browse components, and manage your design workflow through natural conversation.',
     label: 'Figma',
     serverName: Klavis.McpServerName.Figma,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description:
+      'HubSpot is a developer and marketer of software products for inbound marketing, sales, and customer service',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/hubspot.svg',
     identifier: 'hubspot',
+    introduction:
+      'Integrate with HubSpot to manage contacts, deals, and marketing campaigns. Access CRM data, track pipelines, automate workflows, and streamline your sales and marketing operations.',
     label: 'HubSpot',
     serverName: Klavis.McpServerName.Hubspot,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description:
+      'OneDrive is a file hosting service and synchronization service operated by Microsoft',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/onedrive.svg',
     identifier: 'onedrive',
+    introduction:
+      'Connect to OneDrive to access and manage your Microsoft cloud files. Upload, download, share files, organize folders, and collaborate on documents through AI-powered assistance.',
     label: 'OneDrive',
     serverName: Klavis.McpServerName.Onedrive,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description:
+      'Outlook Mail is a web-based suite of webmail, contacts, tasks, and calendaring services from Microsoft.',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/outlook.svg',
     identifier: 'outlook-mail',
+    introduction:
+      'Integrate with Outlook Mail to read, send, and manage your Microsoft emails. Search messages, compose emails, manage folders, and organize your inbox through natural conversation.',
     label: 'Outlook Mail',
     serverName: Klavis.McpServerName.OutlookMail,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description:
+      "Salesforce is the world's leading customer relationship management (CRM) platform that helps businesses connect with customers, partners, and potential customers",
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/salesforce.svg',
     identifier: 'salesforce',
+    introduction:
+      'Connect to Salesforce to manage customer relationships and sales data. Query records, update opportunities, track leads, and automate your CRM workflows through natural language commands.',
     label: 'Salesforce',
     serverName: Klavis.McpServerName.Salesforce,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description:
+      'WhatsApp Business API integration that enables sending text messages, media, and managing conversations with customers. Perfect for customer support, marketing campaigns, and automated messaging workflows through the official WhatsApp Business platform.',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/whatsapp.svg',
     identifier: 'whatsapp',
+    introduction:
+      'Integrate with WhatsApp Business to send messages, manage conversations, and engage with customers. Automate messaging workflows and handle communications through conversational AI.',
     label: 'WhatsApp',
     serverName: Klavis.McpServerName.Whatsapp,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description:
+      'YouTube is a video-sharing platform where users can upload, share, and discover content. Access video information, transcripts, and metadata programmatically.',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/youtube.svg',
     identifier: 'youtube',
+    introduction:
+      'Connect to YouTube to search videos, access transcripts, and retrieve video information. Analyze content, extract metadata, and discover videos through natural conversation.',
     label: 'YouTube',
     serverName: Klavis.McpServerName.Youtube,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description: 'Zendesk is a customer service software company',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/zendesk.svg',
     identifier: 'zendesk',
+    introduction:
+      'Integrate with Zendesk to manage support tickets and customer interactions. Create, update, and track support requests, access customer data, and streamline your support operations.',
     label: 'Zendesk',
     serverName: Klavis.McpServerName.Zendesk,
   },
   {
+    author: 'Klavis',
+    authorUrl: 'https://klavis.io',
+    description:
+      'Cal.com is an open-source scheduling platform that helps you schedule meetings without the back-and-forth emails. Manage event types, bookings, availability, and integrate with calendars for seamless appointment scheduling',
     icon: SiCaldotcom,
     identifier: 'cal-com',
+    introduction:
+      'Connect to Cal.com to manage your scheduling and appointments. View availability, book meetings, manage event types, and automate your calendar through natural conversation.',
     label: 'Cal.com',
     serverName: Klavis.McpServerName.CalCom,
   },
 ];
+
+/**
+ * Get server config by identifier
+ */
+export const getKlavisServerByServerIdentifier = (identifier: string) =>
+  KLAVIS_SERVER_TYPES.find((s) => s.identifier === identifier);

package/packages/const/src/lobehubSkill.ts

@@ -1,10 +1,22 @@
 import { type IconType, SiLinear, SiX } from '@icons-pack/react-simple-icons';
 
 export interface LobehubSkillProviderType {
+  /**
+   * Author/Developer of the integration
+   */
+  author: string;
+  /**
+   * Author's website URL
+   */
+  authorUrl?: string;
   /**
    * Whether this provider is visible by default in the UI
    */
   defaultVisible?: boolean;
+  /**
+   * Short description of the skill
+   */
+  description: string;
   /**
    * Icon - can be a URL string or a React icon component
    */
@@ -13,6 +25,10 @@ export interface LobehubSkillProviderType {
    * Provider ID (matches Market API, e.g., 'linear', 'microsoft')
    */
   id: string;
+  /**
+   * Detailed introduction of the skill
+   */
+  introduction: string;
   /**
    * Display label for the provider
    */
@@ -29,21 +45,39 @@ export interface LobehubSkillProviderType {
  */
 export const LOBEHUB_SKILL_PROVIDERS: LobehubSkillProviderType[] = [
   {
+    author: 'LobeHub',
+    authorUrl: 'https://lobehub.com',
     defaultVisible: true,
+    description:
+      'Linear is a modern issue tracking and project management tool designed for high-performance teams to build better software faster',
     icon: SiLinear,
     id: 'linear',
+    introduction:
+      'Bring the power of Linear directly into your AI assistant. Create and update issues, manage sprints, track project progress, and streamline your development workflow—all through natural conversation.',
     label: 'Linear',
   },
   {
+    author: 'LobeHub',
+    authorUrl: 'https://lobehub.com',
     defaultVisible: true,
+    description:
+      'Outlook Calendar is an integrated scheduling tool within Microsoft Outlook that enables users to create appointments, organize meetings with others, and manage their time and events effectively.',
     icon: 'https://hub-apac-1.lobeobjects.space/assets/logos/outlook.svg',
     id: 'microsoft',
+    introduction:
+      'Integrate with Outlook Calendar to view, create, and manage your events seamlessly. Schedule meetings, check availability, set reminders, and coordinate your time—all through natural language commands.',
     label: 'Outlook Calendar',
   },
   {
+    author: 'LobeHub',
+    authorUrl: 'https://lobehub.com',
     defaultVisible: true,
+    description:
+      'X (Twitter) is a social media platform for sharing real-time updates, news, and engaging with your audience through posts, replies, and direct messages.',
     icon: SiX,
     id: 'twitter',
+    introduction:
+      'Connect to X (Twitter) to post tweets, manage your timeline, and engage with your audience. Create content, schedule posts, monitor mentions, and build your social media presence through conversational AI.',
     label: 'X (Twitter)',
   },
 ];

package/packages/const/src/recommendedSkill.ts

@@ -0,0 +1,17 @@
+export enum RecommendedSkillType {
+  Klavis = 'klavis',
+  Lobehub = 'lobehub',
+}
+
+export interface RecommendedSkillItem {
+  id: string;
+  type: RecommendedSkillType;
+}
+
+export const RECOMMENDED_SKILLS: RecommendedSkillItem[] = [
+  { id: 'gmail', type: RecommendedSkillType.Klavis },
+  { id: 'notion', type: RecommendedSkillType.Klavis },
+  { id: 'google-drive', type: RecommendedSkillType.Klavis },
+  { id: 'google-calendar', type: RecommendedSkillType.Klavis },
+  { id: 'slack', type: RecommendedSkillType.Klavis },
+];

package/packages/model-runtime/src/core/contextBuilders/anthropic.test.ts

@@ -125,6 +125,44 @@ describe('anthropicHelpers', () => {
 
       await expect(buildAnthropicBlock(content)).rejects.toThrow('Invalid image URL: invalid-url');
     });
+
+    it('should return undefined for unsupported SVG image (base64)', async () => {
+      vi.mocked(parseDataUri).mockReturnValueOnce({
+        mimeType: 'image/svg+xml',
+        base64: 'PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjwvc3ZnPg==',
+        type: 'base64',
+      });
+
+      const content = {
+        type: 'image_url',
+        image_url: {
+          url: 'data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjwvc3ZnPg==',
+        },
+      } as const;
+
+      const result = await buildAnthropicBlock(content);
+      expect(result).toBeUndefined();
+    });
+
+    it('should return undefined for unsupported SVG image (URL)', async () => {
+      vi.mocked(parseDataUri).mockReturnValueOnce({
+        mimeType: null,
+        base64: null,
+        type: 'url',
+      });
+      vi.mocked(imageUrlToBase64).mockResolvedValueOnce({
+        base64: 'PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjwvc3ZnPg==',
+        mimeType: 'image/svg+xml',
+      });
+
+      const content = {
+        type: 'image_url',
+        image_url: { url: 'https://example.com/image.svg' },
+      } as const;
+
+      const result = await buildAnthropicBlock(content);
+      expect(result).toBeUndefined();
+    });
   });
 
   describe('buildAnthropicMessage', () => {

package/packages/model-runtime/src/core/contextBuilders/anthropic.ts

@@ -5,6 +5,19 @@ import OpenAI from 'openai';
 import { OpenAIChatMessage, UserMessageContentPart } from '../../types';
 import { parseDataUri } from '../../utils/uriParser';
 
+const ANTHROPIC_SUPPORTED_IMAGE_TYPES = new Set([
+  'image/jpeg',
+  'image/jpg',
+  'image/png',
+  'image/gif',
+  'image/webp',
+]);
+
+const isImageTypeSupported = (mimeType: string | null): boolean => {
+  if (!mimeType) return true;
+  return ANTHROPIC_SUPPORTED_IMAGE_TYPES.has(mimeType.toLowerCase());
+};
+
 export const buildAnthropicBlock = async (
   content: UserMessageContentPart,
 ): Promise<Anthropic.ContentBlock | Anthropic.ImageBlockParam | undefined> => {
@@ -23,7 +36,9 @@ export const buildAnthropicBlock = async (
     case 'image_url': {
       const { mimeType, base64, type } = parseDataUri(content.image_url.url);
 
-      if (type === 'base64')
+      if (type === 'base64') {
+        if (!isImageTypeSupported(mimeType)) return undefined;
+
         return {
           source: {
             data: base64 as string,
@@ -32,9 +47,13 @@ export const buildAnthropicBlock = async (
           },
           type: 'image',
         };
+      }
 
       if (type === 'url') {
         const { base64, mimeType } = await imageUrlToBase64(content.image_url.url);
+
+        if (!isImageTypeSupported(mimeType)) return undefined;
+
         return {
           source: {
             data: base64 as string,

package/packages/model-runtime/src/core/contextBuilders/google.test.ts

@@ -149,6 +149,48 @@ describe('google contextBuilders', () => {
         thoughtSignature: GEMINI_MAGIC_THOUGHT_SIGNATURE,
       });
     });
+
+    it('should return undefined for unsupported SVG image (base64)', async () => {
+      const svgBase64 =
+        'data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjwvc3ZnPg==';
+
+      vi.mocked(parseDataUri).mockReturnValueOnce({
+        base64: 'PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjwvc3ZnPg==',
+        mimeType: 'image/svg+xml',
+        type: 'base64',
+      });
+
+      const content: UserMessageContentPart = {
+        image_url: { url: svgBase64 },
+        type: 'image_url',
+      };
+
+      const result = await buildGooglePart(content);
+      expect(result).toBeUndefined();
+    });
+
+    it('should return undefined for unsupported SVG image (URL)', async () => {
+      const svgUrl = 'https://example.com/image.svg';
+
+      vi.mocked(parseDataUri).mockReturnValueOnce({
+        base64: null,
+        mimeType: null,
+        type: 'url',
+      });
+
+      vi.spyOn(imageToBase64Module, 'imageUrlToBase64').mockResolvedValueOnce({
+        base64: 'PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjwvc3ZnPg==',
+        mimeType: 'image/svg+xml',
+      });
+
+      const content: UserMessageContentPart = {
+        image_url: { url: svgUrl },
+        type: 'image_url',
+      };
+
+      const result = await buildGooglePart(content);
+      expect(result).toBeUndefined();
+    });
   });
 
   describe('buildGoogleMessage', () => {

package/packages/model-runtime/src/core/contextBuilders/google.ts

@@ -11,6 +11,19 @@ import { ChatCompletionTool, OpenAIChatMessage, UserMessageContentPart } from '.
 import { safeParseJSON } from '../../utils/safeParseJSON';
 import { parseDataUri } from '../../utils/uriParser';
 
+const GOOGLE_SUPPORTED_IMAGE_TYPES = new Set([
+  'image/jpeg',
+  'image/jpg',
+  'image/png',
+  'image/gif',
+  'image/webp',
+]);
+
+const isImageTypeSupported = (mimeType: string | null): boolean => {
+  if (!mimeType) return true;
+  return GOOGLE_SUPPORTED_IMAGE_TYPES.has(mimeType.toLowerCase());
+};
+
 /**
  * Magic thoughtSignature
  * @see https://ai.google.dev/gemini-api/docs/thought-signatures#model-behavior:~:text=context_engineering_is_the_way_to_go
@@ -43,6 +56,8 @@ export const buildGooglePart = async (
           throw new TypeError("Image URL doesn't contain base64 data");
         }
 
+        if (!isImageTypeSupported(mimeType)) return undefined;
+
         return {
           inlineData: { data: base64, mimeType: mimeType || 'image/png' },
           thoughtSignature: GEMINI_MAGIC_THOUGHT_SIGNATURE,
@@ -52,6 +67,8 @@ export const buildGooglePart = async (
       if (type === 'url') {
         const { base64, mimeType } = await imageUrlToBase64(content.image_url.url);
 
+        if (!isImageTypeSupported(mimeType)) return undefined;
+
         return {
           inlineData: { data: base64, mimeType },
           thoughtSignature: GEMINI_MAGIC_THOUGHT_SIGNATURE,

package/packages/model-runtime/src/providers/google/index.ts

@@ -242,7 +242,7 @@ export class LobeGoogleAI implements LobeRuntimeAI {
     } catch (e) {
       const err = e as Error;
 
-      // 移除之前的静默处理，统一抛出错误
+      // Remove previous silent handling, throw error uniformly
       if (isAbortError(err)) {
         log('Request was cancelled');
         throw AgentRuntimeError.chat({
@@ -307,10 +307,10 @@ export class LobeGoogleAI implements LobeRuntimeAI {
         try {
           for await (const chunk of originalStream) {
             if (signal.aborted) {
-              // 如果有数据已经输出，优雅地关闭流而不是抛出错误
+              // If data has already been output, close the stream gracefully instead of throwing an error
               if (hasData) {
                 log('Stream cancelled gracefully, preserving existing output');
-                // 显式注入取消错误，避免走 SSE 兜底 unexpected_end
+                // Explicitly inject cancellation error to avoid SSE fallback unexpected_end
                 controller.enqueue({
                   [LOBE_ERROR_KEY]: {
                     body: { name: 'Stream cancelled', provider, reason: 'aborted' },
@@ -322,7 +322,7 @@ export class LobeGoogleAI implements LobeRuntimeAI {
                 controller.close();
                 return;
               } else {
-                // 如果还没有数据输出，直接关闭流，由下游 SSE 在 flush 阶段补发错误事件
+                // If no data has been output yet, close the stream directly and let downstream SSE emit error event during flush phase
                 log('Stream cancelled before any output');
                 controller.close();
                 return;
@@ -335,12 +335,12 @@ export class LobeGoogleAI implements LobeRuntimeAI {
         } catch (error) {
           const err = error as Error;
 
-          // 统一处理所有错误，包括 abort 错误
+          // Handle all errors uniformly, including abort errors
           if (isAbortError(err) || signal.aborted) {
-            // 如果有数据已经输出，优雅地关闭流
+            // If data has already been output, close the stream gracefully
             if (hasData) {
               log('Stream reading cancelled gracefully, preserving existing output');
-              // 显式注入取消错误，避免走 SSE 兜底 unexpected_end
+              // Explicitly inject cancellation error to avoid SSE fallback unexpected_end
               controller.enqueue({
                 [LOBE_ERROR_KEY]: {
                   body: { name: 'Stream cancelled', provider, reason: 'aborted' },
@@ -353,7 +353,7 @@ export class LobeGoogleAI implements LobeRuntimeAI {
               return;
             } else {
               log('Stream reading cancelled before any output');
-              // 注入一个带详细错误信息的错误标记，交由下游 google-ai transformer 输出 error 事件
+              // Inject an error marker with detailed error information to be handled by downstream google-ai transformer to output error event
               controller.enqueue({
                 [LOBE_ERROR_KEY]: {
                   body: {
@@ -371,14 +371,14 @@ export class LobeGoogleAI implements LobeRuntimeAI {
               return;
             }
           } else {
-            // 处理其他流解析错误
+            // Handle other stream parsing errors
             log('Stream parsing error: %O', err);
-            // 尝试解析 Google 错误并提取 code/message/status
+            // Try to parse Google error and extract code/message/status
             const { error: parsedError, errorType } = parseGoogleErrorMessage(
               err?.message || String(err),
             );
 
-            // 注入一个带详细错误信息的错误标记，交由下游 google-ai transformer 输出 error 事件
+            // Inject an error marker with detailed error information to be handled by downstream google-ai transformer to output error event
             controller.enqueue({
               [LOBE_ERROR_KEY]: {
                 body: { ...parsedError, provider },
@@ -453,12 +453,12 @@ export class LobeGoogleAI implements LobeRuntimeAI {
     const hasUrlContext = payload?.urlContext;
     const hasFunctionTools = tools && tools.length > 0;
 
-    // 如果已经有 tool_calls，优先处理 function declarations
+    // If tool_calls already exist, prioritize handling function declarations
     if (hasToolCalls && hasFunctionTools) {
       return buildGoogleTools(tools);
     }
 
-    // 构建并返回搜索相关工具（搜索工具不能与 FunctionCall 同时使用）
+    // Build and return search-related tools (search tools cannot be used with FunctionCall simultaneously)
     if (hasUrlContext && hasSearch) {
       return [{ urlContext: {} }, { googleSearch: {} }];
     }
@@ -469,7 +469,7 @@ export class LobeGoogleAI implements LobeRuntimeAI {
       return [{ googleSearch: {} }];
     }
 
-    // 最后考虑 function declarations
+    // Finally consider function declarations
     return buildGoogleTools(tools);
   }
 }