vibesurf 0.1.26__py3-none-any.whl → 0.1.27__py3-none-any.whl

vibe_surf/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.1.26'
-__version_tuple__ = version_tuple = (0, 1, 26)
+__version__ = version = '0.1.27'
+__version_tuple__ = version_tuple = (0, 1, 27)
 
 __commit_id__ = commit_id = None

vibe_surf/agents/vibe_surf_agent.py

@@ -479,17 +479,16 @@ async def _vibesurf_agent_node_impl(state: VibeSurfState) -> VibeSurfState:
                     llm=vibesurf_agent.llm,
                     file_system=vibesurf_agent.file_system,
                 )
-                if action_name in ["skill_search", "skill_crawl", "skill_summary", "skill_finance"]:
+                if action_name.startswith("skill_"):
                     state.current_step = "END"
                     # Format final response
-                    final_response = f"{result.extracted_content}"
-                    await log_agent_activity(state, agent_name, "result", final_response)
+                    final_response = f"{result.extracted_content}" or f"{result.error}"
                     state.final_response = final_response
                     logger.debug(final_response)
                     state.is_complete = True
-                    return state
+                else:
+                    state.current_step = "vibesurf_agent"
 
-                state.current_step = "vibesurf_agent"
                 if result.extracted_content:
                     vibesurf_agent.message_history.append(
                         UserMessage(content=f'Action result:\n{result.extracted_content}'))

vibe_surf/browser/agent_browser_session.py

@@ -384,6 +384,32 @@ class AgentBrowserSession(BrowserSession):
                 )
             ]
 
+    def model_post_init(self, __context) -> None:
+        """Register event handlers after model initialization."""
+        # Check if handlers are already registered to prevent duplicates
+
+        from browser_use.browser.watchdog_base import BaseWatchdog
+
+        start_handlers = self.event_bus.handlers.get('BrowserStartEvent', [])
+        start_handler_names = [getattr(h, '__name__', str(h)) for h in start_handlers]
+
+        if any('on_BrowserStartEvent' in name for name in start_handler_names):
+            raise RuntimeError(
+                '[BrowserSession] Duplicate handler registration attempted! '
+                'on_BrowserStartEvent is already registered. '
+                'This likely means BrowserSession was initialized multiple times with the same EventBus.'
+            )
+
+        BaseWatchdog.attach_handler_to_session(self, BrowserStartEvent, self.on_BrowserStartEvent)
+        BaseWatchdog.attach_handler_to_session(self, BrowserStopEvent, self.on_BrowserStopEvent)
+        BaseWatchdog.attach_handler_to_session(self, NavigateToUrlEvent, self.on_NavigateToUrlEvent)
+        BaseWatchdog.attach_handler_to_session(self, SwitchTabEvent, self.on_SwitchTabEvent)
+        BaseWatchdog.attach_handler_to_session(self, TabCreatedEvent, self.on_TabCreatedEvent)
+        BaseWatchdog.attach_handler_to_session(self, TabClosedEvent, self.on_TabClosedEvent)
+        BaseWatchdog.attach_handler_to_session(self, AgentFocusChangedEvent, self.on_AgentFocusChangedEvent)
+        # BaseWatchdog.attach_handler_to_session(self, FileDownloadedEvent, self.on_FileDownloadedEvent)
+        BaseWatchdog.attach_handler_to_session(self, CloseTabEvent, self.on_CloseTabEvent)
+
     async def attach_all_watchdogs(self) -> None:
         """Initialize and attach all watchdogs EXCEPT AboutBlankWatchdog to disable DVD animation."""
         # Prevent duplicate watchdog attachment

vibe_surf/tools/browser_use_tools.py

@@ -6,6 +6,9 @@ import enum
 import base64
 import mimetypes
 import datetime
+import aiohttp
+import re
+import urllib.parse
 from pathvalidate import sanitize_filename
 from typing import Optional, Type, Callable, Dict, Any, Union, Awaitable, TypeVar
 from pydantic import BaseModel
@@ -40,7 +43,7 @@ from browser_use.browser.views import BrowserError
 from browser_use.mcp.client import MCPClient
 
 from vibe_surf.browser.agent_browser_session import AgentBrowserSession
-from vibe_surf.tools.views import HoverAction, ExtractionAction, FileExtractionAction
+from vibe_surf.tools.views import HoverAction, ExtractionAction, FileExtractionAction, DownloadMediaAction
 from vibe_surf.tools.mcp_client import CustomMCPClient
 from vibe_surf.tools.file_system import CustomFileSystem
 from vibe_surf.logger import get_logger
@@ -501,3 +504,167 @@ class BrowserUseTools(Tools, VibeSurfTools):
                 error_msg = f'❌ Failed to take screenshot: {str(e)}'
                 logger.error(error_msg)
                 return ActionResult(error=error_msg)
+
+        @self.registry.action(
+            'Download media from URL and save to filesystem downloads folder',
+            param_model=DownloadMediaAction
+        )
+        async def download_media(params: DownloadMediaAction, file_system: FileSystem):
+            """Download media from URL with automatic file format detection"""
+            try:
+                # Get file system directory path (Path type)
+                fs_dir = file_system.get_dir()
+                
+                # Create downloads directory if it doesn't exist
+                downloads_dir = fs_dir / "downloads"
+                downloads_dir.mkdir(exist_ok=True)
+                
+                # Download the file and detect format
+                async with aiohttp.ClientSession() as session:
+                    async with session.get(params.url) as response:
+                        if response.status != 200:
+                            raise Exception(f"HTTP {response.status}: Failed to download from {params.url}")
+                        
+                        # Get content
+                        content = await response.read()
+                        
+                        # Detect file format and extension
+                        file_extension = await self._detect_file_format(params.url, response.headers, content)
+                        
+                        # Generate filename
+                        if params.filename:
+                            # Use provided filename, add extension if missing
+                            filename = params.filename
+                            if not filename.endswith(file_extension):
+                                filename = f"{filename}{file_extension}"
+                        else:
+                            # Generate filename from URL or timestamp
+                            url_path = urllib.parse.urlparse(params.url).path
+                            url_filename = os.path.basename(url_path)
+                            
+                            if url_filename and not url_filename.startswith('.'):
+                                # Use URL filename, ensure correct extension
+                                filename = url_filename
+                                if not filename.endswith(file_extension):
+                                    base_name = os.path.splitext(filename)[0]
+                                    filename = f"{base_name}{file_extension}"
+                            else:
+                                # Generate timestamp-based filename
+                                timestamp = datetime.datetime.now().strftime("%Y%m%d_%H%M%S")
+                                filename = f"media_{timestamp}{file_extension}"
+                        
+                        # Sanitize filename
+                        filename = sanitize_filename(filename)
+                        filepath = downloads_dir / filename
+                        
+                        # Save file
+                        with open(filepath, "wb") as f:
+                            f.write(content)
+                        
+                        # Calculate file size for display
+                        file_size = len(content)
+                        size_str = self._format_file_size(file_size)
+                        
+                        msg = f'📥 Downloaded media to: {str(filepath.relative_to(fs_dir))} ({size_str})'
+                        logger.info(msg)
+                        return ActionResult(
+                            extracted_content=msg,
+                            include_in_memory=True,
+                            long_term_memory=f'Downloaded media from {params.url} to {str(filepath.relative_to(fs_dir))}',
+                        )
+                        
+            except Exception as e:
+                error_msg = f'❌ Failed to download media: {str(e)}'
+                logger.error(error_msg)
+                return ActionResult(error=error_msg)
+
+        async def _detect_file_format(self, url: str, headers: dict, content: bytes) -> str:
+            """Detect file format from URL, headers, and content"""
+            
+            # Try Content-Type header first
+            content_type = headers.get('content-type', '').lower()
+            if content_type:
+                # Common image formats
+                if 'image/jpeg' in content_type or 'image/jpg' in content_type:
+                    return '.jpg'
+                elif 'image/png' in content_type:
+                    return '.png'
+                elif 'image/gif' in content_type:
+                    return '.gif'
+                elif 'image/webp' in content_type:
+                    return '.webp'
+                elif 'image/svg' in content_type:
+                    return '.svg'
+                elif 'image/bmp' in content_type:
+                    return '.bmp'
+                elif 'image/tiff' in content_type:
+                    return '.tiff'
+                # Video formats
+                elif 'video/mp4' in content_type:
+                    return '.mp4'
+                elif 'video/webm' in content_type:
+                    return '.webm'
+                elif 'video/avi' in content_type:
+                    return '.avi'
+                elif 'video/mov' in content_type or 'video/quicktime' in content_type:
+                    return '.mov'
+                # Audio formats
+                elif 'audio/mpeg' in content_type or 'audio/mp3' in content_type:
+                    return '.mp3'
+                elif 'audio/wav' in content_type:
+                    return '.wav'
+                elif 'audio/ogg' in content_type:
+                    return '.ogg'
+                elif 'audio/webm' in content_type:
+                    return '.webm'
+            
+            # Try magic number detection
+            if len(content) >= 8:
+                # JPEG
+                if content.startswith(b'\xff\xd8\xff'):
+                    return '.jpg'
+                # PNG
+                elif content.startswith(b'\x89PNG\r\n\x1a\n'):
+                    return '.png'
+                # GIF
+                elif content.startswith(b'GIF87a') or content.startswith(b'GIF89a'):
+                    return '.gif'
+                # WebP
+                elif content[8:12] == b'WEBP':
+                    return '.webp'
+                # BMP
+                elif content.startswith(b'BM'):
+                    return '.bmp'
+                # TIFF
+                elif content.startswith(b'II*\x00') or content.startswith(b'MM\x00*'):
+                    return '.tiff'
+                # MP4
+                elif b'ftyp' in content[4:12]:
+                    return '.mp4'
+                # PDF
+                elif content.startswith(b'%PDF'):
+                    return '.pdf'
+            
+            # Try URL path extension
+            url_path = urllib.parse.urlparse(url).path
+            if url_path:
+                ext = os.path.splitext(url_path)[1].lower()
+                if ext in ['.jpg', '.jpeg', '.png', '.gif', '.webp', '.svg', '.bmp', '.tiff',
+                          '.mp4', '.webm', '.avi', '.mov', '.wmv', '.flv',
+                          '.mp3', '.wav', '.ogg', '.aac', '.flac',
+                          '.pdf', '.doc', '.docx', '.txt']:
+                    return ext
+            
+            # Default fallback
+            return '.bin'
+
+        def _format_file_size(self, size_bytes: int) -> str:
+            """Format file size in human readable format"""
+            if size_bytes == 0:
+                return "0 B"
+            size_names = ["B", "KB", "MB", "GB", "TB"]
+            i = 0
+            while size_bytes >= 1024.0 and i < len(size_names) - 1:
+                size_bytes /= 1024.0
+                i += 1
+            return f"{size_bytes:.1f} {size_names[i]}"

vibe_surf/tools/vibesurf_tools.py

@@ -31,7 +31,8 @@ from browser_use.tools.views import NoParamsAction
 from vibe_surf.browser.agent_browser_session import AgentBrowserSession
 from vibe_surf.tools.views import HoverAction, ExtractionAction, FileExtractionAction, BrowserUseAgentExecution, \
     ReportWriterTask, TodoGenerateAction, TodoModifyAction, VibeSurfDoneAction, SkillSearchAction, SkillCrawlAction, \
-    SkillSummaryAction, SkillTakeScreenshotAction, SkillDeepResearchAction, SkillCodeAction, SkillFinanceAction
+    SkillSummaryAction, SkillTakeScreenshotAction, SkillDeepResearchAction, SkillCodeAction, SkillFinanceAction, \
+    SkillXhsAction, SkillDouyinAction, SkillYoutubeAction, SkillWeiboAction
 from vibe_surf.tools.finance_tools import FinanceDataRetriever, FinanceMarkdownFormatter, FinanceMethod
 from vibe_surf.tools.mcp_client import CustomMCPClient
 from vibe_surf.tools.file_system import CustomFileSystem
@@ -516,7 +517,7 @@ Format: [index1, index2, index3, ...]
                 with open(filepath, "wb") as f:
                     f.write(base64.b64decode(screenshot))
 
-                msg = f'📸 Screenshot saved to path: {str(filepath.relative_to(fs_dir))}'
+                msg = f'📸 Screenshot saved to path: [{filename}]({str(filepath.relative_to(fs_dir))})'
                 logger.info(msg)
                 return ActionResult(
                     extracted_content=msg,
@@ -942,7 +943,428 @@ Please generate alternative JavaScript code that avoids this system error:"""
             except Exception as e:
                 error_msg = f'❌ Failed to retrieve financial data for {params.symbol}: {str(e)}'
                 logger.error(error_msg)
-                return ActionResult(error=error_msg)
+                return ActionResult(error=error_msg, extracted_content=error_msg)
+
+
+        @self.registry.action(
+            'Skill: Xiaohongshu API - Access Xiaohongshu (Little Red Book) platform data including search, content details, comments, user profiles, and recommendations. Methods: search_content_by_keyword, fetch_content_details, fetch_all_content_comments, get_user_profile, fetch_all_user_content, get_home_recommendations.',
+            param_model=SkillXhsAction,
+        )
+        async def skill_xhs(
+                params: SkillXhsAction,
+                browser_manager: BrowserManager,
+                file_system: CustomFileSystem
+        ):
+            """
+            Skill: Xiaohongshu API integration
+            
+            Available methods:
+            - search_content_by_keyword: Search content by keyword with sorting options
+            - fetch_content_details: Get detailed information about specific content
+            - fetch_all_content_comments: Get all comments for specific content
+            - get_user_profile: Get user profile information
+            - fetch_all_user_content: Get all content posted by a user
+            - get_home_recommendations: Get homepage recommended content
+            """
+            try:
+                from vibe_surf.tools.website_api.xhs.client import XiaoHongShuApiClient
+                
+                # Initialize client
+                xhs_client = XiaoHongShuApiClient(browser_session=browser_manager.main_browser_session)
+                await xhs_client.setup()
+                
+                # Parse params JSON string
+                import json
+                from json_repair import repair_json
+                try:
+                    method_params = json.loads(params.params)
+                except json.JSONDecodeError:
+                    method_params = json.loads(repair_json(params.params))
+                
+                # Execute the requested method
+                result = None
+                if params.method == "search_content_by_keyword":
+                    result = await xhs_client.search_content_by_keyword(**method_params)
+                elif params.method == "fetch_content_details":
+                    result = await xhs_client.fetch_content_details(**method_params)
+                elif params.method == "fetch_all_content_comments":
+                    result = await xhs_client.fetch_all_content_comments(**method_params)
+                elif params.method == "get_user_profile":
+                    result = await xhs_client.get_user_profile(**method_params)
+                elif params.method == "fetch_all_user_content":
+                    result = await xhs_client.fetch_all_user_content(**method_params)
+                elif params.method == "get_home_recommendations":
+                    result = await xhs_client.get_home_recommendations()
+                else:
+                    return ActionResult(error=f"Unknown method: {params.method}")
+                
+                # Save result to file
+                timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+                filename = f"xhs_{params.method}_{timestamp}.json"
+                filepath = file_system.get_dir() / "data" / filename
+                filepath.parent.mkdir(exist_ok=True)
+                
+                with open(filepath, "w", encoding="utf-8") as f:
+                    json.dump(result, f, ensure_ascii=False, indent=2)
+                
+                # Format result as markdown
+                if isinstance(result, list):
+                    display_count = min(5, len(result))
+                    md_content = f"## Xiaohongshu {params.method.replace('_', ' ').title()}\n\n"
+                    md_content += f"Showing {display_count} of {len(result)} results:\n\n"
+                    for i, item in enumerate(result[:display_count]):
+                        md_content += f"### Result {i+1}\n"
+                        for key, value in item.items():
+                            if not value:
+                                continue
+                            if isinstance(value, str) and len(value) > 200:
+                                md_content += f"- **{key}**: {value[:200]}...\n"
+                            else:
+                                md_content += f"- **{key}**: {value}\n"
+                        md_content += "\n"
+                else:
+                    md_content = f"## Xiaohongshu {params.method.replace('_', ' ').title()}\n\n"
+                    for key, value in result.items():
+                        if isinstance(value, str) and len(value) > 200:
+                            md_content += f"- **{key}**: {value[:200]}...\n"
+                        else:
+                            md_content += f"- **{key}**: {value}\n"
+                    md_content += "\n"
+                
+                # Add file path to markdown
+                relative_path = str(filepath.relative_to(file_system.get_dir()))
+                md_content += f"\n> 📁 Full data saved to: [{filename}]({relative_path})\n"
+                md_content += f"> 💡 Click the link above to view all results.\n"
+                
+                logger.info(f'📕 Xiaohongshu data retrieved with method: {params.method}')
+                
+                # Close client
+                await xhs_client.close()
+                
+                return ActionResult(
+                    extracted_content=md_content
+                )
+                
+            except Exception as e:
+                error_msg = f'❌ Failed to retrieve Xiaohongshu data: {str(e)}'
+                logger.error(error_msg)
+                return ActionResult(error=error_msg, extracted_content=error_msg)
+
+
+        @self.registry.action(
+            'Skill: Weibo API - Access Weibo platform data including search, post details, comments, user profiles, hot posts, and trending lists. Methods: search_posts_by_keyword, get_post_detail, get_all_post_comments, get_user_info, get_all_user_posts, get_hot_posts（推荐榜）, get_trending_posts(热搜榜）.',
+            param_model=SkillWeiboAction,
+        )
+        async def skill_weibo(
+                params: SkillWeiboAction,
+                browser_manager: BrowserManager,
+                file_system: CustomFileSystem
+        ):
+            """
+            Skill: Weibo API integration
+            
+            Available methods:
+            - search_posts_by_keyword: Search posts by keyword with sorting options
+            - get_post_detail: Get detailed information about specific post
+            - get_all_post_comments: Get all comments for specific post
+            - get_user_info: Get user profile information
+            - get_all_user_posts: Get all posts by a user
+            - get_hot_posts: Get hot posts
+            - get_trending_list: Get trending list
+            """
+            try:
+                from vibe_surf.tools.website_api.weibo.client import WeiboApiClient
+                
+                # Initialize client
+                wb_client = WeiboApiClient(browser_session=browser_manager.main_browser_session)
+                await wb_client.setup()
+                
+                # Parse params JSON string
+                import json
+                from json_repair import repair_json
+                try:
+                    method_params = json.loads(params.params)
+                except json.JSONDecodeError:
+                    method_params = json.loads(repair_json(params.params))
+                
+                # Execute the requested method
+                result = None
+                if params.method == "search_posts_by_keyword":
+                    result = await wb_client.search_posts_by_keyword(**method_params)
+                elif params.method == "get_post_detail":
+                    result = await wb_client.get_post_detail(**method_params)
+                elif params.method == "get_all_post_comments":
+                    result = await wb_client.get_all_post_comments(**method_params)
+                elif params.method == "get_user_info":
+                    result = await wb_client.get_user_info(**method_params)
+                elif params.method == "get_all_user_posts":
+                    result = await wb_client.get_all_user_posts(**method_params)
+                elif params.method == "get_hot_posts":
+                    result = await wb_client.get_hot_posts()
+                elif params.method == "get_trending_posts":
+                    result = await wb_client.get_trending_posts()
+                else:
+                    return ActionResult(error=f"Unknown method: {params.method}")
+                
+                # Save result to file
+                timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+                filename = f"weibo_{params.method}_{timestamp}.json"
+                filepath = file_system.get_dir() / "data" / filename
+                filepath.parent.mkdir(exist_ok=True)
+                
+                with open(filepath, "w", encoding="utf-8") as f:
+                    json.dump(result, f, ensure_ascii=False, indent=2)
+                # Format result as markdown
+                if isinstance(result, list):
+                    display_count = min(5, len(result))
+                    md_content = f"## Weibo {params.method.replace('_', ' ').title()}\n\n"
+                    md_content += f"Showing {display_count} of {len(result)} results:\n\n"
+                    for i, item in enumerate(result[:display_count]):
+                        md_content += f"### Result {i+1}\n"
+                        for key, value in item.items():
+                            if not value:
+                                continue
+                            if isinstance(value, str) and len(value) > 200:
+                                md_content += f"- **{key}**: {value[:200]}...\n"
+                            else:
+                                md_content += f"- **{key}**: {value}\n"
+                        md_content += "\n"
+                else:
+                    md_content = f"## Weibo {params.method.replace('_', ' ').title()}\n\n"
+                    for key, value in result.items():
+                        if isinstance(value, str) and len(value) > 200:
+                            md_content += f"- **{key}**: {value[:200]}...\n"
+                        else:
+                            md_content += f"- **{key}**: {value}\n"
+                    md_content += "\n"
+                
+                # Add file path to markdown
+                relative_path = str(filepath.relative_to(file_system.get_dir()))
+                md_content += f"\n> 📁 Full data saved to: [{filename}]({relative_path})\n"
+                md_content += f"> 💡 Click the link above to view all results.\n"
+                
+                logger.info(f'🐦 Weibo data retrieved with method: {params.method}')
+                
+                # Close client
+                await wb_client.close()
+                
+                return ActionResult(
+                    extracted_content=md_content
+                )
+                
+            except Exception as e:
+                import traceback
+                traceback.print_exc()
+                error_msg = f'❌ Failed to retrieve Weibo data: {str(e)}. \nMost likely you are not login, please go to: [Weibo login page](https://passport.weibo.com/sso/signin?entry=miniblog&source=miniblog) and login.'
+                logger.error(error_msg)
+                return ActionResult(error=error_msg, extracted_content=error_msg)
+
+
+        @self.registry.action(
+            'Skill: Douyin API - Access Douyin platform data including search, video details, comments, user profiles, and videos. Methods: search_content_by_keyword, fetch_video_details, fetch_all_video_comments, fetch_user_info, fetch_all_user_videos.',
+            param_model=SkillDouyinAction,
+        )
+        async def skill_douyin(
+                params: SkillDouyinAction,
+                browser_manager: BrowserManager,
+                file_system: CustomFileSystem
+        ):
+            """
+            Skill: Douyin API integration
+            
+            Available methods:
+            - search_content_by_keyword: Search content by keyword with filtering options
+            - fetch_video_details: Get detailed information about specific video
+            - fetch_all_video_comments: Get all comments for specific video
+            - fetch_user_info: Get user profile information
+            - fetch_all_user_videos: Get all videos by a user
+            """
+            try:
+                from vibe_surf.tools.website_api.douyin.client import DouyinApiClient
+                
+                # Initialize client
+                dy_client = DouyinApiClient(browser_session=browser_manager.main_browser_session)
+                await dy_client.setup()
+                
+                # Parse params JSON string
+                import json
+                from json_repair import repair_json
+                try:
+                    method_params = json.loads(params.params)
+                except json.JSONDecodeError:
+                    method_params = json.loads(repair_json(params.params))
+                
+                # Execute the requested method
+                result = None
+                if params.method == "search_content_by_keyword":
+                    result = await dy_client.search_content_by_keyword(**method_params)
+                elif params.method == "fetch_video_details":
+                    result = await dy_client.fetch_video_details(**method_params)
+                elif params.method == "fetch_all_video_comments":
+                    result = await dy_client.fetch_all_video_comments(**method_params)
+                elif params.method == "fetch_user_info":
+                    result = await dy_client.fetch_user_info(**method_params)
+                elif params.method == "fetch_all_user_videos":
+                    result = await dy_client.fetch_all_user_videos(**method_params)
+                else:
+                    return ActionResult(error=f"Unknown method: {params.method}")
+                
+                # Save result to file
+                timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+                filename = f"douyin_{params.method}_{timestamp}.json"
+                filepath = file_system.get_dir() / "data" / filename
+                filepath.parent.mkdir(exist_ok=True)
+                
+                with open(filepath, "w", encoding="utf-8") as f:
+                    json.dump(result, f, ensure_ascii=False, indent=2)
+                
+                # Format result as markdown
+                if isinstance(result, list):
+                    display_count = min(5, len(result))
+                    md_content = f"## Douyin {params.method.replace('_', ' ').title()}\n\n"
+                    md_content += f"Showing {display_count} of {len(result)} results:\n\n"
+                    for i, item in enumerate(result[:display_count]):
+                        md_content += f"### Result {i+1}\n"
+                        for key, value in item.items():
+                            if not value:
+                                continue
+                            if isinstance(value, str) and len(value) > 200:
+                                md_content += f"- **{key}**: {value[:200]}...\n"
+                            else:
+                                md_content += f"- **{key}**: {value}\n"
+                        md_content += "\n"
+                else:
+                    md_content = f"## Douyin {params.method.replace('_', ' ').title()}\n\n"
+                    for key, value in result.items():
+                        if isinstance(value, str) and len(value) > 200:
+                            md_content += f"- **{key}**: {value[:200]}...\n"
+                        else:
+                            md_content += f"- **{key}**: {value}\n"
+                    md_content += "\n"
+                
+                # Add file path to markdown
+                relative_path = str(filepath.relative_to(file_system.get_dir()))
+                md_content += f"\n> 📁 Full data saved to: [{filename}]({relative_path})\n"
+                md_content += f"> 💡 Click the link above to view all results.\n"
+                
+                logger.info(f'🎵 Douyin data retrieved with method: {params.method}')
+                
+                # Close client
+                await dy_client.close()
+                
+                return ActionResult(
+                    extracted_content=md_content
+                )
+                
+            except Exception as e:
+                error_msg = f'❌ Failed to retrieve Douyin data: {str(e)}'
+                logger.error(error_msg)
+                return ActionResult(error=error_msg, extracted_content=error_msg)
+
+
+        @self.registry.action(
+            'Skill: YouTube API - Access YouTube platform data including search, video details, comments, channel info, and trending videos. Methods: search_videos, get_video_details, get_video_comments, get_channel_info, get_channel_videos, get_trending_videos.',
+            param_model=SkillYoutubeAction,
+        )
+        async def skill_youtube(
+                params: SkillYoutubeAction,
+                browser_manager: BrowserManager,
+                file_system: CustomFileSystem
+        ):
+            """
+            Skill: YouTube API integration
+            
+            Available methods:
+            - search_videos: Search videos by keyword
+            - get_video_details: Get detailed information about specific video
+            - get_video_comments: Get comments for specific video
+            - get_channel_info: Get channel information
+            - get_channel_videos: Get videos from specific channel
+            - get_trending_videos: Get trending videos
+            """
+            try:
+                from vibe_surf.tools.website_api.youtube.client import YouTubeApiClient
+                
+                # Initialize client
+                yt_client = YouTubeApiClient(browser_session=browser_manager.main_browser_session)
+                await yt_client.setup()
+                
+                # Parse params JSON string
+                import json
+                from json_repair import repair_json
+                try:
+                    method_params = json.loads(params.params)
+                except json.JSONDecodeError:
+                    method_params = json.loads(repair_json(params.params))
+                
+                # Execute the requested method
+                result = None
+                if params.method == "search_videos":
+                    result = await yt_client.search_videos(**method_params)
+                elif params.method == "get_video_details":
+                    result = await yt_client.get_video_details(**method_params)
+                elif params.method == "get_video_comments":
+                    result = await yt_client.get_video_comments(**method_params)
+                elif params.method == "get_channel_info":
+                    result = await yt_client.get_channel_info(**method_params)
+                elif params.method == "get_channel_videos":
+                    result = await yt_client.get_channel_videos(**method_params)
+                elif params.method == "get_trending_videos":
+                    result = await yt_client.get_trending_videos()
+                else:
+                    return ActionResult(error=f"Unknown method: {params.method}")
+                
+                # Save result to file
+                timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+                filename = f"youtube_{params.method}_{timestamp}.json"
+                filepath = file_system.get_dir() / "data" / filename
+                filepath.parent.mkdir(exist_ok=True)
+                
+                with open(filepath, "w", encoding="utf-8") as f:
+                    json.dump(result, f, ensure_ascii=False, indent=2)
+                
+                # Format result as markdown
+                if isinstance(result, list):
+                    display_count = min(5, len(result))
+                    md_content = f"## YouTube {params.method.replace('_', ' ').title()}\n\n"
+                    md_content += f"Showing {display_count} of {len(result)} results:\n\n"
+                    for i, item in enumerate(result[:display_count]):
+                        md_content += f"### Result {i+1}\n"
+                        for key, value in item.items():
+                            if not value:
+                                continue
+                            if isinstance(value, str) and len(value) > 200:
+                                md_content += f"- **{key}**: {value[:200]}...\n"
+                            else:
+                                md_content += f"- **{key}**: {value}\n"
+                        md_content += "\n"
+                else:
+                    md_content = f"## YouTube {params.method.replace('_', ' ').title()}\n\n"
+                    for key, value in result.items():
+                        if isinstance(value, str) and len(value) > 200:
+                            md_content += f"- **{key}**: {value[:200]}...\n"
+                        else:
+                            md_content += f"- **{key}**: {value}\n"
+                    md_content += "\n"
+                
+                # Add file path to markdown
+                relative_path = str(filepath.relative_to(file_system.get_dir()))
+                md_content += f"\n> 📁 Full data saved to: [{filename}]({relative_path})\n"
+                md_content += f"> 💡 Click the link above to view all results.\n"
+                
+                logger.info(f'🎬 YouTube data retrieved with method: {params.method}')
+                
+                # Close client
+                await yt_client.close()
+                
+                return ActionResult(
+                    extracted_content=md_content
+                )
+                
+            except Exception as e:
+                error_msg = f'❌ Failed to retrieve YouTube data: {str(e)}'
+                logger.error(error_msg)
+                return ActionResult(error=error_msg, extracted_content=error_msg)
 
 
     async def _extract_google_results_rule_based(self, browser_session):

vibe_surf/tools/views.py

@@ -211,3 +211,78 @@ class SkillFinanceAction(BaseModel):
         ge=1,
         le=20,
     )
+
+
+class DownloadMediaAction(BaseModel):
+    """Parameters for downloading media from URL"""
+    url: str = Field(
+        description='URL of the media to download',
+    )
+    filename: str | None = Field(
+        default=None,
+        description='Optional custom filename. If not provided, will auto-detect from URL or Content-Disposition header',
+    )
+ 
+
+class SkillXhsAction(BaseModel):
+    """Parameters for skill_xhs action - Xiaohongshu API skill"""
+    method: str = Field(
+        description='''Xiaohongshu API method name. Available methods:
+        - search_content_by_keyword: Search content by keyword, params required: {"keyword": "search keyword", "page": 1, "page_size": 20}
+        - fetch_content_details: Get content details, params required: {"content_id": "content ID", "xsec_token": "security token"}
+        - fetch_all_content_comments: Get all comments for content, params required: {"content_id": "content ID", "xsec_token": "security token", "max_comments": 100}
+        - get_user_profile: Get user profile, params required: {"user_id": "user ID"}
+        - fetch_all_user_content: Get all content by user, params required: {"user_id": "user ID", "max_content": 100}
+        - get_home_recommendations: Get home page recommendations, params: {}'''
+    )
+    params: str = Field(
+        description='JSON string of method parameters, provide corresponding parameters according to the method parameter. Example: {"keyword": "food"}'
+    )
+
+
+class SkillWeiboAction(BaseModel):
+    """Parameters for skill_weibo action - Weibo API skill"""
+    method: str = Field(
+        description='''Weibo API method name. Available methods:
+        - search_posts_by_keyword: Search posts by keyword, params required: {"keyword": "search keyword", "page": 1}
+        - get_post_detail: Get post details, params required: {"mid": "post ID"}
+        - get_all_post_comments: Get all comments for post, params required: {"mid": "post ID", "max_comments": 100}
+        - get_user_info: Get user information, params required: {"user_id": "user ID"}
+        - get_all_user_posts: Get all posts by user, params required: {"user_id": "user ID", "max_posts": 100}
+        - get_hot_posts: Get hot posts(推荐榜）, params: {}
+        - get_trending_posts: Get trending posts(热搜榜）, params: {}'''
+    )
+    params: str = Field(
+        description='JSON string of method parameters, provide corresponding parameters according to the method parameter. Example: {"keyword": "AI trending"}'
+    )
+
+
+class SkillDouyinAction(BaseModel):
+    """Parameters for skill_douyin action - Douyin API skill"""
+    method: str = Field(
+        description='''Douyin API method name. Available methods:
+        - search_content_by_keyword: Search videos by keyword, params required: {"keyword": "search keyword", "offset": 0}
+        - fetch_video_details: Get video details, params required: {"aweme_id": "video ID"}
+        - fetch_all_video_comments: Get all comments for video, params required: {"aweme_id": "video ID", "max_comments": 100}
+        - fetch_user_info: Get user information, params required: {"sec_user_id": "user security ID"}
+        - fetch_all_user_videos: Get all videos by user, params required: {"sec_user_id": "user security ID", "max_videos": 100}'''
+    )
+    params: str = Field(
+        description='JSON string of method parameters, provide corresponding parameters according to the method parameter. Example: {"keyword": "music"}'
+    )
+
+
+class SkillYoutubeAction(BaseModel):
+    """Parameters for skill_youtube action - YouTube API skill"""
+    method: str = Field(
+        description='''YouTube API method name. Available methods:
+        - search_videos: Search videos, params required: {"query": "search keyword", "max_results": 20}
+        - get_video_details: Get video details, params required: {"video_id": "video ID"}
+        - get_video_comments: Get video comments, params required: {"video_id": "video ID", "max_comments": 200}
+        - get_channel_info: Get channel information, params required: {"channel_id": "channel ID"}
+        - get_channel_videos: Get channel videos, params required: {"channel_id": "channel ID", "max_videos": 20}
+        - get_trending_videos: Get trending videos, params: {}'''
+    )
+    params: str = Field(
+        description='JSON string of method parameters, provide corresponding parameters according to the method parameter. Example: {"query": "tech tutorial", "max_results": 30}'
+    )

{vibesurf-0.1.26.dist-info → vibesurf-0.1.27.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vibesurf
-Version: 0.1.26
+Version: 0.1.27
 Summary: VibeSurf: A powerful browser assistant for vibe surfing
 Author: Shao Warm
 License: Apache-2.0
@@ -44,16 +44,19 @@ Requires-Dist: markdownify>=1.2.0
 Requires-Dist: pathvalidate>=3.3.1
 Requires-Dist: dashscope>=1.24.5
 Requires-Dist: yfinance>=0.2.66
+Requires-Dist: pyexecjs>=1.5.1
 Dynamic: license-file
 
 # VibeSurf: A powerful browser assistant for vibe surfing
-[![Discord](https://img.shields.io/discord/1303749220842340412?color=7289DA&label=Discord&logo=discord&logoColor=white)](https://discord.gg/TXNnP9gJ)
+[![Discord](https://img.shields.io/discord/1303749220842340412?color=7289DA&label=Discord&logo=discord&logoColor=white)](https://discord.gg/EZ2YnUXP)
 [![WarmShao](https://img.shields.io/twitter/follow/warmshao?style=social)](https://x.com/warmshao)
 
 VibeSurf is an open-source AI agentic browser that revolutionizes browser automation and research.
 
 If you're as excited about open-source AI browsing as I am, give it a star! ⭐
 
+[中文](README_zh.md) | [English](README.md)
+
 ## ✨ Key Features
 
 - 🧠 **Advanced AI Automation**: Beyond browser automation, VibeSurf performs deep research, intelligent crawling, content summarization, and more to exploration.
@@ -90,11 +93,29 @@ uv pip install vibesurf -U
 uv run vibesurf
 ```
 
-## 🗺️ Roadmap
+## 👩‍💻 For Contributors
+
+Want to contribute to VibeSurf? Here are two ways to set up your development environment:
+
+### Method 1: Direct Server Run
+Run the backend server directly using uvicorn:
+```bash
+uvicorn vibe_surf.backend.main:app --host 127.0.0.1 --port 9335
+```
+
+### Method 2: Editable Installation
+Install the package in editable mode and run using the CLI:
+```bash
+uv pip install -e .
+uv run vibesurf
+```
+
+Choose the method that works best for your development workflow!
+## �️ Roadmap
 
 We're building VibeSurf to be your ultimate AI browser companion. Here's what's coming next:
 
-- [ ] **Smart Skills System**: Add `/search` for quick information search and `/crawl` for automatic website data extraction
+- [x] **Smart Skills System**: Add `/search` for quick information search and `/crawl` for automatic website data extraction
 - [ ] **Powerful Coding Agent**: Build a comprehensive coding assistant for data processing and analysis directly in your browser
 - [ ] **Third-Party Integrations**: Connect with n8n workflows and other tools to combine browsing with automation
 - [ ] **Custom Workflow Templates**: Create reusable templates for auto-login, data collection, and complex browser automation
@@ -113,7 +134,7 @@ We're building VibeSurf to be your ultimate AI browser companion. Here's what's
 
 ## 📝 License
 
-Licensed under the [Apache License 2.0](LICENSE).
+This repository is licensed under the [VibeSurf Open Source License](./LICENSE), based on Apache 2.0 with additional conditions.
 
 ## 👏 Acknowledgments
 

{vibesurf-0.1.26.dist-info → vibesurf-0.1.27.dist-info}/RECORD

@@ -1,12 +1,12 @@
 vibe_surf/__init__.py,sha256=WtduuMFGauMD_9dpk4fnRnLTAP6ka9Lfu0feAFNzLfo,339
-vibe_surf/_version.py,sha256=Y9o7KiJWiG6n9XbSpMICgNgajFRbL4an-gN1BQc-jwM,706
+vibe_surf/_version.py,sha256=o2dyLbB_Uhc2yY2R7iheES_lRnDBGV9Hc4iNgiJ_XTo,706
 vibe_surf/cli.py,sha256=KAmUBsXfS-NkMp3ITxzNXwtFeKVmXJUDZiWqLcIC0BI,16690
 vibe_surf/common.py,sha256=_WWMxen5wFwzUjEShn3yDVC1OBFUiJ6Vccadi6tuG6w,1215
 vibe_surf/logger.py,sha256=k53MFA96QX6t9OfcOf1Zws8PP0OOqjVJfhUD3Do9lKw,3043
 vibe_surf/agents/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 vibe_surf/agents/browser_use_agent.py,sha256=jeUYV7yk6vyycw6liju_597GdjB3CW_B2wEhn2F0ekk,45957
 vibe_surf/agents/report_writer_agent.py,sha256=pCF2k6VLyO-sSviGBqqIyVD3SLqaZtSqiW3kvNfPY1I,20967
-vibe_surf/agents/vibe_surf_agent.py,sha256=sTUO4xAiznr7RRzdrRYzXENos9XovicZw8ow2UuJsyI,74286
+vibe_surf/agents/vibe_surf_agent.py,sha256=cOQvZJrE4WBnirgN_PW-GfVSnPKI5G5FwW2AA5bTqew,74162
 vibe_surf/agents/views.py,sha256=yHjNJloa-aofVTGyuRy08tBYP_Y3XLqt1DUWOUmHRng,4825
 vibe_surf/agents/prompts/__init__.py,sha256=l4ieA0D8kLJthyNN85FKLNe4ExBa3stY3l-aImLDRD0,36
 vibe_surf/agents/prompts/report_writer_prompt.py,sha256=sZE8MUT1CDLmRzbnbEQzAvTwJjpITgh2Q8g1_eXmkzE,4454
@@ -39,7 +39,7 @@ vibe_surf/backend/utils/encryption.py,sha256=CjLNh_n0Luhfa-6BB-icfzkiiDqj5b4Gu6M
 vibe_surf/backend/utils/llm_factory.py,sha256=XIJYc9Lh_L2vbwlAe96PrjptlzJtLOjCGNdHEx6fThk,9047
 vibe_surf/browser/__init__.py,sha256=_UToO2fZfSCrfjOcxhn4Qq7ZLbYeyPuUUEmqIva-Yv8,325
 vibe_surf/browser/agen_browser_profile.py,sha256=J06hCBJSJ-zAFVM9yDFz8UpmiLuFyWke1EMekpU45eo,5871
-vibe_surf/browser/agent_browser_session.py,sha256=xV0nHo_TCb7b7QYhIee4cLzH-1rqJswYwH7GEwyQmqc,33980
+vibe_surf/browser/agent_browser_session.py,sha256=9bCQkPNEy88-04gB9njBrbuoFBhIYF_SxueZfFe5RCM,35662
 vibe_surf/browser/browser_manager.py,sha256=PFJ9flmqR2uokuRZ3PDh_Dy6_6qcQ6kH_eRc1yT6Iq8,11257
 vibe_surf/browser/utils.py,sha256=bBtpMiyz2ixWOr31GbJwZ8pVYcnxztKjTJJO92z1BDY,35742
 vibe_surf/browser/watchdogs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -87,18 +87,18 @@ vibe_surf/chrome_extension/styles/variables.css,sha256=enjyhsa0PeU3b-3uiXa-VkV-1
 vibe_surf/llm/__init__.py,sha256=_vDVPo6STf343p1SgMQrF5023hicAx0g83pK2Gbk4Ek,601
 vibe_surf/llm/openai_compatible.py,sha256=i0a5OLaL6QIlacVyctOG09vKr3KOi8T8Izp1v7xkD5I,16112
 vibe_surf/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-vibe_surf/tools/browser_use_tools.py,sha256=tacxKUJL6uOt04f52_iIw1cs-FT-mBgIPmAsIc4Hww0,23730
+vibe_surf/tools/browser_use_tools.py,sha256=ALJOoPiwG3HSR_UZZpi_1f8cQngcAEKiap8ojIgdQlo,31586
 vibe_surf/tools/file_system.py,sha256=Tw_6J5QjCahQ3fd26CXziF1zPvRxhYM0889oK4bDhlU,19304
 vibe_surf/tools/finance_tools.py,sha256=E8rmblp57e_cp0tFbdZ7BY3_upNlk4Whk0bYc_SFCJE,27284
 vibe_surf/tools/mcp_client.py,sha256=OeCoTgyx4MoY7JxXndK6pGHIoyFOhf5r7XCbx25y1Ec,2446
 vibe_surf/tools/report_writer_tools.py,sha256=2CyTTXOahTKZo7XwyWDDhJ--1mRA0uTtUWxu_DACAY0,776
 vibe_surf/tools/vibesurf_registry.py,sha256=Z-8d9BrJl3RFMEK0Tw1Q5xNHX2kZGsnIGCTBZ3RM-pw,2159
-vibe_surf/tools/vibesurf_tools.py,sha256=O8y1noWyY8y-j8I7vF4oOaVDybINNXiNXWNwGJJ5xsM,91500
-vibe_surf/tools/views.py,sha256=AEAPzML-lqWJ7dBMjXTl7o-rk4hp5PGaPRqLyilJUl8,7789
+vibe_surf/tools/vibesurf_tools.py,sha256=UY93Yft_Ni6D8k94t0afZ4x_EAbh1PGsWZ4RPr12So8,113828
+vibe_surf/tools/views.py,sha256=1b0y9Zl1GWmDFXUiZXntsWU-8U3xrOqXdpRld5efxgI,12257
 vibe_surf/tools/voice_asr.py,sha256=AJG0yq_Jq-j8ulDlbPhVFfK1jch9_ASesis73iki9II,4702
-vibesurf-0.1.26.dist-info/licenses/LICENSE,sha256=czn6QYya0-jhLnStD9JqnMS-hwP5wRByipkrGTvoXLI,11355
-vibesurf-0.1.26.dist-info/METADATA,sha256=8Bdh3-15Hl0KbmB0ghk9KNQiveDnVGnhzZ-4Dv0MVjc,5190
-vibesurf-0.1.26.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-vibesurf-0.1.26.dist-info/entry_points.txt,sha256=UxqpvMocL-PR33S6vLF2OmXn-kVzM-DneMeZeHcPMM8,48
-vibesurf-0.1.26.dist-info/top_level.txt,sha256=VPZGHqSb6EEqcJ4ZX6bHIuWfon5f6HXl3c7BYpbRqnY,10
-vibesurf-0.1.26.dist-info/RECORD,,
+vibesurf-0.1.27.dist-info/licenses/LICENSE,sha256=vRmTjOYvD8RLiSGYYmFHnveYNswtO1uvSk1sd-Eu7sg,2037
+vibesurf-0.1.27.dist-info/METADATA,sha256=JAb_jozN1kp1YVRowpkkoX0xx1eWm_3bo-GLST2bjPo,5836
+vibesurf-0.1.27.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+vibesurf-0.1.27.dist-info/entry_points.txt,sha256=UxqpvMocL-PR33S6vLF2OmXn-kVzM-DneMeZeHcPMM8,48
+vibesurf-0.1.27.dist-info/top_level.txt,sha256=VPZGHqSb6EEqcJ4ZX6bHIuWfon5f6HXl3c7BYpbRqnY,10
+vibesurf-0.1.27.dist-info/RECORD,,

vibesurf-0.1.27.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+# Open Source License
+
+VibeSurf is licensed under a modified version of the Apache License 2.0, with the following additional conditions:
+
+1. VibeSurf may be utilized commercially, including as a backend service for other applications or as an application development platform for enterprises. Should the conditions below be met, a commercial license must be obtained from the producer:
+
+a. Multi-tenant service: Unless explicitly authorized by VibeSurf in writing, you may not use the VibeSurf source code to operate a multi-tenant environment.
+    - Tenant Definition: Within the context of VibeSurf, one tenant corresponds to one workspace. The workspace provides a separated area for each tenant's data and configurations.
+
+b. LOGO and copyright information: In the process of using VibeSurf's frontend, you may not remove or modify the LOGO or copyright information in the VibeSurf console or applications. This restriction is inapplicable to uses of VibeSurf that do not involve its frontend.
+    - Frontend Definition: For the purposes of this license, the "frontend" of VibeSurf includes all components located in the `vibe_surf/chrome_extension/` directory when running VibeSurf from the raw source code, or the corresponding frontend container/image when running VibeSurf with Docker or other containerization.
+
+2. As a contributor, you should agree that:
+
+a. The producer can adjust the open-source agreement to be more strict or relaxed as deemed necessary.
+b. Your contributed code may be used for commercial purposes, including but not limited to its cloud business operations.
+
+Apart from the specific conditions mentioned above, all other rights and restrictions follow the Apache License 2.0. Detailed information about the Apache License 2.0 can be found at http://www.apache.org/licenses/LICENSE-2.0.
+
+The interactive design of this product is protected by appearance patent.
+
+© 2025 VibeSurf Authors. This repository is licensed under the VibeSurf Open Source License, based on Apache 2.0 with additional conditions.

vibesurf-0.1.26.dist-info/licenses/LICENSE

@@ -1,201 +0,0 @@
-                                Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.